Scope#
WS06-009 integrates first-class 3D provenance records into ISIS 3D package
contracts so downstream systems can trace:
- Source imagery used for reconstruction/control/reference.
- Canonical control inputs (ControlNet, IPAdapter, InstantID/manual).
- Post-process pipeline history with timestamped operations and parameter digests.
Research Alignment#
Implementation aligns with existing ISIS provenance systems and contracts:
- Output-registry provenance conventions in
apps/isis/output-registry/src/services/output.service.ts. - Existing control contract normalization in
apps/isis/generation-api/src/workflows/executor.ts. - Prior WS06 contract propagation approach for generation-api/output-registry/client 3D package schemas and types.
Implemented Deliverables#
- Added reusable 3D provenance utilities in
@isis/3d-generation:
buildThreeDProvenanceRecordvalidateThreeDProvenanceRecord- Strongly typed source-image/control-input/post-process records.
- Integrated provenance generation into 3D workflow execution output:
threeDPackage.metadata.provenanceis now emitted for 3D jobs.- Source images aggregate from direct input, parameterized references, and control sources.
- Control inputs are emitted from canonicalized control requests.
- Post-process history records reconstruction, quality, and packaging stages.
- Propagated 3D provenance contract through:
- Generation API schemas and types.
- Output-registry schemas and types.
- ISIS client SDK types.
- Added/extended tests to validate:
- Provenance utility behavior.
- Schema acceptance of provenance in 3D package metadata.
- Executor output includes populated 3D provenance records.
Verification Commands#
bash
pnpm --filter @isis/3d-generation exec vitest run src/processing/three-d-provenance.spec.ts src/processing/dcc-export-bundles.spec.ts src/processing/engine-export-bundles.spec.ts src/processing/mesh-quality-validator.spec.ts src/processing/pbr-texture-validator.spec.ts src/processing/uv-texel-quality-validator.spec.ts src/processing/lod-pipeline-validator.spec.ts src/processing/rig-readiness-validator.spec.ts
pnpm --filter @isis/generation-api exec vitest run src/schemas/job.schema.spec.ts src/workflows/executor.spec.ts
pnpm --filter @isis/output-registry exec vitest run src/schemas/output.schema.spec.ts
pnpm --filter @isis/3d-generation exec tsc -p tsconfig.json --noEmit
pnpm --filter @isis/workflows exec vitest run src/workflows.spec.ts
pnpm --filter @isis/workflows exec tsc -p tsconfig.json --noEmit
pnpm --filter @isis/generation-api exec tsc -p tsconfig.json --noEmit
pnpm --filter @isis/output-registry exec tsc -p tsconfig.json --noEmit
node scripts/isis/validate-v2-compliance-gate.mjs