@tiangong-lca/foundry 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +532 -0
- package/docs/architecture.md +450 -0
- package/docs/foundry-task-contracts.md +147 -0
- package/docs/import-profiles/bafu/constraints.md +343 -0
- package/docs/import-profiles/bafu/leaf-process-classification-authoring.md +153 -0
- package/docs/import-profiles/bafu/profile.md +183 -0
- package/docs/import-profiles/uslci/constraints.md +29 -0
- package/docs/import-profiles/uslci/profile.md +43 -0
- package/docs/import-profiles/worldsteel/constraints.md +77 -0
- package/docs/import-profiles/worldsteel/import-coverage.md +93 -0
- package/docs/import-profiles/worldsteel/import-plan.md +375 -0
- package/docs/import-profiles/worldsteel/profile.md +78 -0
- package/docs/package-distribution-contract.md +287 -0
- package/docs/public-runtime-contract.md +218 -0
- package/docs/runtime-context-contract.md +138 -0
- package/docs/safety-policy.md +164 -0
- package/docs/task-authorization-contract.md +131 -0
- package/docs/uslci-import-runbook.md +336 -0
- package/docs/workspace-migration-contract.md +127 -0
- package/package-dist/assets/foundry-package-descriptor.json +1661 -0
- package/package-dist/scripts/foundry-facade.d.ts +78 -0
- package/package-dist/scripts/foundry-facade.js +1317 -0
- package/package-dist/scripts/foundry-runtime.d.ts +180 -0
- package/package-dist/scripts/foundry-runtime.js +190 -0
- package/package-dist/scripts/lib/batch-orchestration/scope-attempt-ledger.d.ts +27 -0
- package/package-dist/scripts/lib/batch-orchestration/scope-attempt-ledger.js +85 -0
- package/package-dist/scripts/lib/batch-orchestration/scope-resume-contract.d.ts +38 -0
- package/package-dist/scripts/lib/batch-orchestration/scope-resume-contract.js +90 -0
- package/package-dist/scripts/lib/bundle-row-types.d.ts +44 -0
- package/package-dist/scripts/lib/bundle-row-types.js +46 -0
- package/package-dist/scripts/lib/bundle-sample-utils.d.ts +183 -0
- package/package-dist/scripts/lib/bundle-sample-utils.js +526 -0
- package/package-dist/scripts/lib/bundle-source-context.d.ts +31 -0
- package/package-dist/scripts/lib/bundle-source-context.js +142 -0
- package/package-dist/scripts/lib/canonical-description.d.ts +12 -0
- package/package-dist/scripts/lib/canonical-description.js +72 -0
- package/package-dist/scripts/lib/canonical-support-rewrites.d.ts +127 -0
- package/package-dist/scripts/lib/canonical-support-rewrites.js +527 -0
- package/package-dist/scripts/lib/decision-owners/classification.d.ts +245 -0
- package/package-dist/scripts/lib/decision-owners/classification.js +754 -0
- package/package-dist/scripts/lib/decision-owners/identity-preflight.d.ts +333 -0
- package/package-dist/scripts/lib/decision-owners/identity-preflight.js +1353 -0
- package/package-dist/scripts/lib/decision-owners/identity-task.d.ts +130 -0
- package/package-dist/scripts/lib/decision-owners/identity-task.js +494 -0
- package/package-dist/scripts/lib/decision-owners/identity.d.ts +74 -0
- package/package-dist/scripts/lib/decision-owners/identity.js +443 -0
- package/package-dist/scripts/lib/decision-owners/location.d.ts +239 -0
- package/package-dist/scripts/lib/decision-owners/location.js +704 -0
- package/package-dist/scripts/lib/decision-task-utils.d.ts +484 -0
- package/package-dist/scripts/lib/decision-task-utils.js +735 -0
- package/package-dist/scripts/lib/finalize-owners/cli-wrappers.d.ts +52 -0
- package/package-dist/scripts/lib/finalize-owners/cli-wrappers.js +146 -0
- package/package-dist/scripts/lib/finalize-owners/commit-handoff.d.ts +79 -0
- package/package-dist/scripts/lib/finalize-owners/commit-handoff.js +515 -0
- package/package-dist/scripts/lib/finalize-owners/post-authoring.d.ts +234 -0
- package/package-dist/scripts/lib/finalize-owners/post-authoring.js +1720 -0
- package/package-dist/scripts/lib/finalize-owners/post-write-closeout.d.ts +140 -0
- package/package-dist/scripts/lib/finalize-owners/post-write-closeout.js +656 -0
- package/package-dist/scripts/lib/foundry-args.d.ts +7 -0
- package/package-dist/scripts/lib/foundry-args.js +38 -0
- package/package-dist/scripts/lib/foundry-authentication-environment.d.ts +17 -0
- package/package-dist/scripts/lib/foundry-authentication-environment.js +55 -0
- package/package-dist/scripts/lib/foundry-authorization-input.d.ts +31 -0
- package/package-dist/scripts/lib/foundry-authorization-input.js +151 -0
- package/package-dist/scripts/lib/foundry-command-metadata.d.ts +32 -0
- package/package-dist/scripts/lib/foundry-command-metadata.js +1012 -0
- package/package-dist/scripts/lib/foundry-command-registry.d.ts +34 -0
- package/package-dist/scripts/lib/foundry-command-registry.js +241 -0
- package/package-dist/scripts/lib/foundry-command-spec.d.ts +1 -0
- package/package-dist/scripts/lib/foundry-command-spec.js +1 -0
- package/package-dist/scripts/lib/foundry-decision-owners.d.ts +17 -0
- package/package-dist/scripts/lib/foundry-decision-owners.js +68 -0
- package/package-dist/scripts/lib/foundry-decision-routing.d.ts +3 -0
- package/package-dist/scripts/lib/foundry-decision-routing.js +38 -0
- package/package-dist/scripts/lib/foundry-execution-admission.d.ts +33 -0
- package/package-dist/scripts/lib/foundry-execution-admission.js +225 -0
- package/package-dist/scripts/lib/foundry-execution-attempt.d.ts +11 -0
- package/package-dist/scripts/lib/foundry-execution-attempt.js +33 -0
- package/package-dist/scripts/lib/foundry-execution-context-format.d.ts +18 -0
- package/package-dist/scripts/lib/foundry-execution-context-format.js +83 -0
- package/package-dist/scripts/lib/foundry-facade-store.d.ts +25 -0
- package/package-dist/scripts/lib/foundry-facade-store.js +449 -0
- package/package-dist/scripts/lib/foundry-finalize-owners.d.ts +21 -0
- package/package-dist/scripts/lib/foundry-finalize-owners.js +203 -0
- package/package-dist/scripts/lib/foundry-identity-owners.d.ts +13 -0
- package/package-dist/scripts/lib/foundry-identity-owners.js +58 -0
- package/package-dist/scripts/lib/foundry-managed-host.d.ts +7 -0
- package/package-dist/scripts/lib/foundry-managed-host.js +173 -0
- package/package-dist/scripts/lib/foundry-migration-adoption-plan.d.ts +39 -0
- package/package-dist/scripts/lib/foundry-migration-adoption-plan.js +467 -0
- package/package-dist/scripts/lib/foundry-migration-adoption.d.ts +31 -0
- package/package-dist/scripts/lib/foundry-migration-adoption.js +187 -0
- package/package-dist/scripts/lib/foundry-migration-authority.d.ts +42 -0
- package/package-dist/scripts/lib/foundry-migration-authority.js +280 -0
- package/package-dist/scripts/lib/foundry-migration-inventory.d.ts +31 -0
- package/package-dist/scripts/lib/foundry-migration-inventory.js +148 -0
- package/package-dist/scripts/lib/foundry-migration-plan.d.ts +48 -0
- package/package-dist/scripts/lib/foundry-migration-plan.js +234 -0
- package/package-dist/scripts/lib/foundry-migration-replay.d.ts +3 -0
- package/package-dist/scripts/lib/foundry-migration-replay.js +134 -0
- package/package-dist/scripts/lib/foundry-migration-stage.d.ts +15 -0
- package/package-dist/scripts/lib/foundry-migration-stage.js +152 -0
- package/package-dist/scripts/lib/foundry-migration-transfer-io.d.ts +13 -0
- package/package-dist/scripts/lib/foundry-migration-transfer-io.js +226 -0
- package/package-dist/scripts/lib/foundry-migration-transfer.d.ts +36 -0
- package/package-dist/scripts/lib/foundry-migration-transfer.js +350 -0
- package/package-dist/scripts/lib/foundry-operation-result.d.ts +71 -0
- package/package-dist/scripts/lib/foundry-operation-result.js +264 -0
- package/package-dist/scripts/lib/foundry-owner-execution-store.d.ts +319 -0
- package/package-dist/scripts/lib/foundry-owner-execution-store.js +293 -0
- package/package-dist/scripts/lib/foundry-owner-readback.d.ts +22 -0
- package/package-dist/scripts/lib/foundry-owner-readback.js +189 -0
- package/package-dist/scripts/lib/foundry-owner-trace-acceptance.d.ts +15 -0
- package/package-dist/scripts/lib/foundry-owner-trace-acceptance.js +68 -0
- package/package-dist/scripts/lib/foundry-package-contract.d.ts +56 -0
- package/package-dist/scripts/lib/foundry-package-contract.js +392 -0
- package/package-dist/scripts/lib/foundry-private-path.d.ts +2 -0
- package/package-dist/scripts/lib/foundry-private-path.js +20 -0
- package/package-dist/scripts/lib/foundry-runtime-cache.d.ts +3 -0
- package/package-dist/scripts/lib/foundry-runtime-cache.js +25 -0
- package/package-dist/scripts/lib/foundry-runtime-command-policy.d.ts +20 -0
- package/package-dist/scripts/lib/foundry-runtime-command-policy.js +173 -0
- package/package-dist/scripts/lib/foundry-runtime-context-types.d.ts +59 -0
- package/package-dist/scripts/lib/foundry-runtime-context-types.js +1 -0
- package/package-dist/scripts/lib/foundry-runtime-context.d.ts +27 -0
- package/package-dist/scripts/lib/foundry-runtime-context.js +668 -0
- package/package-dist/scripts/lib/foundry-runtime-environment.d.ts +9 -0
- package/package-dist/scripts/lib/foundry-runtime-environment.js +90 -0
- package/package-dist/scripts/lib/foundry-runtime-error.d.ts +4 -0
- package/package-dist/scripts/lib/foundry-runtime-error.js +8 -0
- package/package-dist/scripts/lib/foundry-runtime-identity.d.ts +18 -0
- package/package-dist/scripts/lib/foundry-runtime-identity.js +127 -0
- package/package-dist/scripts/lib/foundry-runtime-paths.d.ts +16 -0
- package/package-dist/scripts/lib/foundry-runtime-paths.js +159 -0
- package/package-dist/scripts/lib/foundry-runtime-qualification.d.ts +66 -0
- package/package-dist/scripts/lib/foundry-runtime-qualification.js +223 -0
- package/package-dist/scripts/lib/foundry-runtime-selection-record.d.ts +16 -0
- package/package-dist/scripts/lib/foundry-runtime-selection-record.js +32 -0
- package/package-dist/scripts/lib/foundry-runtime-selection.d.ts +14 -0
- package/package-dist/scripts/lib/foundry-runtime-selection.js +123 -0
- package/package-dist/scripts/lib/foundry-runtime-utils.d.ts +178 -0
- package/package-dist/scripts/lib/foundry-runtime-utils.js +603 -0
- package/package-dist/scripts/lib/foundry-semantic-input.d.ts +30 -0
- package/package-dist/scripts/lib/foundry-semantic-input.js +132 -0
- package/package-dist/scripts/lib/foundry-task-authorization.d.ts +68 -0
- package/package-dist/scripts/lib/foundry-task-authorization.js +350 -0
- package/package-dist/scripts/lib/foundry-task-io.d.ts +18 -0
- package/package-dist/scripts/lib/foundry-task-io.js +92 -0
- package/package-dist/scripts/lib/foundry-task-registration.d.ts +6 -0
- package/package-dist/scripts/lib/foundry-task-registration.js +384 -0
- package/package-dist/scripts/lib/foundry-task-start-spec.d.ts +34 -0
- package/package-dist/scripts/lib/foundry-task-start-spec.js +161 -0
- package/package-dist/scripts/lib/foundry-task-store.d.ts +18 -0
- package/package-dist/scripts/lib/foundry-task-store.js +466 -0
- package/package-dist/scripts/lib/foundry-task-types.d.ts +99 -0
- package/package-dist/scripts/lib/foundry-task-types.js +1 -0
- package/package-dist/scripts/lib/foundry-workflow-approval-continuation.d.ts +6 -0
- package/package-dist/scripts/lib/foundry-workflow-approval-continuation.js +136 -0
- package/package-dist/scripts/lib/foundry-workflow-assessment.d.ts +3 -0
- package/package-dist/scripts/lib/foundry-workflow-assessment.js +231 -0
- package/package-dist/scripts/lib/foundry-workflow-authorization.d.ts +22 -0
- package/package-dist/scripts/lib/foundry-workflow-authorization.js +174 -0
- package/package-dist/scripts/lib/foundry-workflow-context.d.ts +3 -0
- package/package-dist/scripts/lib/foundry-workflow-context.js +99 -0
- package/package-dist/scripts/lib/foundry-workflow-decisions.d.ts +18 -0
- package/package-dist/scripts/lib/foundry-workflow-decisions.js +123 -0
- package/package-dist/scripts/lib/foundry-workflow-execution.d.ts +8 -0
- package/package-dist/scripts/lib/foundry-workflow-execution.js +248 -0
- package/package-dist/scripts/lib/foundry-workflow-finalize.d.ts +13 -0
- package/package-dist/scripts/lib/foundry-workflow-finalize.js +264 -0
- package/package-dist/scripts/lib/foundry-workflow-identity-apply.d.ts +14 -0
- package/package-dist/scripts/lib/foundry-workflow-identity-apply.js +159 -0
- package/package-dist/scripts/lib/foundry-workflow-identity.d.ts +6 -0
- package/package-dist/scripts/lib/foundry-workflow-identity.js +153 -0
- package/package-dist/scripts/lib/foundry-workflow-import.d.ts +4 -0
- package/package-dist/scripts/lib/foundry-workflow-import.js +70 -0
- package/package-dist/scripts/lib/foundry-workflow-io.d.ts +11 -0
- package/package-dist/scripts/lib/foundry-workflow-io.js +77 -0
- package/package-dist/scripts/lib/foundry-workflow-reference-verify.d.ts +41 -0
- package/package-dist/scripts/lib/foundry-workflow-reference-verify.js +266 -0
- package/package-dist/scripts/lib/foundry-workflow-rows.d.ts +2 -0
- package/package-dist/scripts/lib/foundry-workflow-rows.js +47 -0
- package/package-dist/scripts/lib/foundry-workflow-semantic.d.ts +5 -0
- package/package-dist/scripts/lib/foundry-workflow-semantic.js +367 -0
- package/package-dist/scripts/lib/foundry-workflow-state.d.ts +37 -0
- package/package-dist/scripts/lib/foundry-workflow-state.js +158 -0
- package/package-dist/scripts/lib/full-context-proof.d.ts +51 -0
- package/package-dist/scripts/lib/full-context-proof.js +932 -0
- package/package-dist/scripts/lib/identity-preflight-artifacts.d.ts +184 -0
- package/package-dist/scripts/lib/identity-preflight-artifacts.js +573 -0
- package/package-dist/scripts/lib/identity-preflight-proof.d.ts +117 -0
- package/package-dist/scripts/lib/identity-preflight-proof.js +341 -0
- package/package-dist/scripts/lib/identity-reference-rewrite-utils.d.ts +147 -0
- package/package-dist/scripts/lib/identity-reference-rewrite-utils.js +817 -0
- package/package-dist/scripts/lib/import-curation/authoring-packages.d.ts +28 -0
- package/package-dist/scripts/lib/import-curation/authoring-packages.js +92 -0
- package/package-dist/scripts/lib/import-curation/curation-cleanup.d.ts +32 -0
- package/package-dist/scripts/lib/import-curation/curation-cleanup.js +203 -0
- package/package-dist/scripts/lib/import-curation/curation-gate.d.ts +47 -0
- package/package-dist/scripts/lib/import-curation/curation-gate.js +528 -0
- package/package-dist/scripts/lib/import-curation/internal/artifact-inputs.d.ts +24 -0
- package/package-dist/scripts/lib/import-curation/internal/artifact-inputs.js +152 -0
- package/package-dist/scripts/lib/import-curation/internal/authoring-patch-workflow.d.ts +3 -0
- package/package-dist/scripts/lib/import-curation/internal/authoring-patch-workflow.js +3 -0
- package/package-dist/scripts/lib/import-curation/internal/authoring-task-workflow.d.ts +1 -0
- package/package-dist/scripts/lib/import-curation/internal/authoring-task-workflow.js +1 -0
- package/package-dist/scripts/lib/import-curation/internal/context-inputs.d.ts +56 -0
- package/package-dist/scripts/lib/import-curation/internal/context-inputs.js +206 -0
- package/package-dist/scripts/lib/import-curation/internal/curation-gate-workflow.d.ts +14 -0
- package/package-dist/scripts/lib/import-curation/internal/curation-gate-workflow.js +14 -0
- package/package-dist/scripts/lib/import-curation/internal/dataset-payload.d.ts +70 -0
- package/package-dist/scripts/lib/import-curation/internal/dataset-payload.js +141 -0
- package/package-dist/scripts/lib/import-curation/internal/dataset-types.d.ts +25 -0
- package/package-dist/scripts/lib/import-curation/internal/dataset-types.js +45 -0
- package/package-dist/scripts/lib/import-curation/internal/full-context-proof.d.ts +129 -0
- package/package-dist/scripts/lib/import-curation/internal/full-context-proof.js +552 -0
- package/package-dist/scripts/lib/import-curation/internal/hash-utils.d.ts +2 -0
- package/package-dist/scripts/lib/import-curation/internal/hash-utils.js +10 -0
- package/package-dist/scripts/lib/import-curation/internal/mutation-manifest-workflow.d.ts +15 -0
- package/package-dist/scripts/lib/import-curation/internal/mutation-manifest-workflow.js +15 -0
- package/package-dist/scripts/lib/import-curation/internal/prewrite-cleanup.d.ts +31 -0
- package/package-dist/scripts/lib/import-curation/internal/prewrite-cleanup.js +467 -0
- package/package-dist/scripts/lib/import-curation/internal/profiles-config.d.ts +47 -0
- package/package-dist/scripts/lib/import-curation/internal/profiles-config.js +88 -0
- package/package-dist/scripts/lib/import-curation/internal/runtime-io.d.ts +23 -0
- package/package-dist/scripts/lib/import-curation/internal/runtime-io.js +132 -0
- package/package-dist/scripts/lib/import-curation/internal/trace-summary.d.ts +53 -0
- package/package-dist/scripts/lib/import-curation/internal/trace-summary.js +114 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-authoring-tasks.d.ts +141 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-authoring-tasks.js +854 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-decision-apply-context.d.ts +20 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-decision-apply-context.js +46 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-decision-full-context.d.ts +110 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-decision-full-context.js +782 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-dry-run-context.d.ts +24 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-dry-run-context.js +191 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-evidence-scope.d.ts +80 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-evidence-scope.js +359 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-identity-decision-context.d.ts +146 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-identity-decision-context.js +381 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-identity-preflight.d.ts +223 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-identity-preflight.js +1079 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-patch-collect.d.ts +41 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-patch-collect.js +412 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-patch-evidence-context.d.ts +117 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-patch-evidence-context.js +278 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-patch-evidence.d.ts +59 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-patch-evidence.js +593 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-queue-context.d.ts +58 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-queue-context.js +263 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-reference-closure.d.ts +177 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-reference-closure.js +812 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-row-transform-context.d.ts +159 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-row-transform-context.js +466 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-semantic-actions.d.ts +152 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-semantic-actions.js +1377 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-source-reference-context.d.ts +38 -0
- package/package-dist/scripts/lib/import-curation/internal/workflow-source-reference-context.js +116 -0
- package/package-dist/scripts/lib/import-curation/mutation-manifest.d.ts +51 -0
- package/package-dist/scripts/lib/import-curation/mutation-manifest.js +542 -0
- package/package-dist/scripts/lib/import-curation/patch-collect.d.ts +18 -0
- package/package-dist/scripts/lib/import-curation/patch-collect.js +172 -0
- package/package-dist/scripts/lib/import-curation/profiles.d.ts +1 -0
- package/package-dist/scripts/lib/import-curation/profiles.js +1 -0
- package/package-dist/scripts/lib/import-curation/trace-summary.d.ts +1 -0
- package/package-dist/scripts/lib/import-curation/trace-summary.js +1 -0
- package/package-dist/scripts/lib/oauth-session-reference.d.ts +1 -0
- package/package-dist/scripts/lib/oauth-session-reference.js +20 -0
- package/package-dist/scripts/lib/post-authoring-finalize-utils.d.ts +95 -0
- package/package-dist/scripts/lib/post-authoring-finalize-utils.js +548 -0
- package/package-dist/scripts/lib/post-write-root-proof.d.ts +44 -0
- package/package-dist/scripts/lib/post-write-root-proof.js +169 -0
- package/package-dist/scripts/lib/reference-description-text.d.ts +2 -0
- package/package-dist/scripts/lib/reference-description-text.js +12 -0
- package/package-dist/scripts/lib/remote-verification-accepted-diff.d.ts +42 -0
- package/package-dist/scripts/lib/remote-verification-accepted-diff.js +424 -0
- package/package-dist/scripts/lib/same-identity-commit-recovery.d.ts +8 -0
- package/package-dist/scripts/lib/same-identity-commit-recovery.js +52 -0
- package/package-dist/scripts/lib/source-semantics.d.ts +255 -0
- package/package-dist/scripts/lib/source-semantics.js +888 -0
- package/package-dist/scripts/lib/stage-contract.d.ts +36 -0
- package/package-dist/scripts/lib/stage-contract.js +25 -0
- package/package-dist/scripts/lib/task-authorization.d.ts +84 -0
- package/package-dist/scripts/lib/task-authorization.js +210 -0
- package/package-dist/scripts/lib/tidas-adapter.d.ts +113 -0
- package/package-dist/scripts/lib/tidas-adapter.js +525 -0
- package/package-dist/scripts/lib/tidas-language-utils.d.ts +8 -0
- package/package-dist/scripts/lib/tidas-language-utils.js +206 -0
- package/package-dist/scripts/lib/tidas-row-utils.d.ts +70 -0
- package/package-dist/scripts/lib/tidas-row-utils.js +225 -0
- package/package-dist/scripts/lib/trace-coverage.d.ts +53 -0
- package/package-dist/scripts/lib/trace-coverage.js +178 -0
- package/package-dist/scripts/package-entry.d.ts +2 -0
- package/package-dist/scripts/package-entry.js +4 -0
- package/package-dist/scripts/public-api.d.ts +80 -0
- package/package-dist/scripts/public-api.js +28 -0
- package/package-dist/scripts/runtime-entry.d.ts +23 -0
- package/package-dist/scripts/runtime-entry.js +424 -0
- package/package.json +93 -0
- package/specs/canonical-support/flow-properties-unit-groups.json +2692 -0
- package/specs/import-profiles.json +118 -0
- package/specs/prewrite-content-policy.json +105 -0
- package/specs/schemas/authorization-derivation.schema.json +34 -0
- package/specs/schemas/execution-context.schema.json +68 -0
- package/specs/schemas/foundry-authorization-input.schema.json +120 -0
- package/specs/schemas/foundry-facade-request-index.schema.json +78 -0
- package/specs/schemas/foundry-managed-runtime.schema.json +122 -0
- package/specs/schemas/foundry-migration-activation.schema.json +213 -0
- package/specs/schemas/foundry-migration-adoption-plan.schema.json +548 -0
- package/specs/schemas/foundry-migration-transfer-receipt.schema.json +93 -0
- package/specs/schemas/foundry-operation-result.schema.json +147 -0
- package/specs/schemas/foundry-package-descriptor.schema.json +134 -0
- package/specs/schemas/foundry-runtime-selection.schema.json +59 -0
- package/specs/schemas/foundry-semantic-input.schema.json +36 -0
- package/specs/schemas/foundry-task-start.schema.json +123 -0
- package/specs/schemas/foundry-workspace-migration-pending.schema.json +17 -0
- package/specs/schemas/foundry-workspace-migration-plan.schema.json +59 -0
- package/specs/schemas/foundry-workspace-migration-transfer-plan.schema.json +357 -0
- package/specs/schemas/foundry-workspace-v2.schema.json +70 -0
- package/specs/schemas/runtime-qualification.schema.json +63 -0
- package/specs/schemas/task-authorization.schema.json +154 -0
- package/specs/schemas/tidas-runtime-expectation.schema.json +54 -0
|
@@ -0,0 +1,528 @@
|
|
|
1
|
+
import fs from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import * as curationGateWorkflow from "./internal/curation-gate-workflow.js";
|
|
4
|
+
const { authoringQueueRowsForIdentity, buildIdentityPreflightAuthoringContext, buildQueueAuthoringContext, classificationQueueActionItem, classificationQueueRowStillNeedsAuthoring, collectBundledSchemaContextFiles, collectContextDirFiles, collectExplicitContextFiles, collectProfileSemanticActionItems, contextFileDetails, datasetIdentity, datasetTypeFromOptions, datasetTypePlural, ensureArray, entityIdFromFinding, fileExists, fullContextAiCompletionRequirement, fullContextGateItems, identityDecisionApplyContextDecisionsForIdentity, identityDecisionApplyReportOptionValues, identityKey, identityPreflightAuthoringActionItems, identityPreflightGateItems, jsonLines, locationQueueActionItem, locationQueueRowStillNeedsAuthoring, mapRowsByIdentity, nowIso, profileFor, qaFindingCode, qaFindingCurationAction, readAuthoringQueueContext, readCanonicalSupportRewriteContext, readClassificationDecisionApplyContext, readCleanupTransformContext, readContextFiles, readCurationQueueContext, readIdentityDecisionApplyContexts, readIdentityPreflightContext, readIdentityReferenceRewriteContext, readJson, readJsonArtifactsIfOption, readJsonIfOption, readQaFindings, readRows, readSourceContactRewriteContext, readText, readUnresolvedExchangeExternalizationContext, repoRelativePath, resolveRepoPath, sanitizeFileName, schemaIssueCurationAction, sha256Text, unresolvedExchangeExternalizationRowsForIdentity, writeJson, writeText, } = curationGateWorkflow;
|
|
5
|
+
function asJsonRecord(value) {
|
|
6
|
+
return value;
|
|
7
|
+
}
|
|
8
|
+
export function runDatasetCurationGate({ repoRoot, options = {}, routeAction, requireIdentityPreflight = false, } = {}) {
|
|
9
|
+
const datasetType = datasetTypeFromOptions(options);
|
|
10
|
+
if (options.help) {
|
|
11
|
+
return {
|
|
12
|
+
schema_version: 2,
|
|
13
|
+
status: "help",
|
|
14
|
+
command: "dataset-curation-gate",
|
|
15
|
+
usage: [
|
|
16
|
+
"node scripts/foundry.ts dataset-curation-gate --type process --rows-file <rows.jsonl> --schema-report <dataset-validate-report.json> --qa-report <qa-report.json> --queue-dir <curation-queue-dir> --classification-queue <classification-authoring-queue.jsonl> --location-queue <location-authoring-queue.jsonl>",
|
|
17
|
+
"node scripts/foundry.ts dataset-curation-gate --type process --rows-file ./rows/processes.jsonl --schema-report ./schema/report.json --qa-report ./qa/report.json --schema-file ./context/schema.json --yaml-file ./context/methodology.yaml --queue-dir ./curation-queue --classification-queue ./classification-authoring-queue.jsonl --location-queue ./location-authoring-queue.jsonl --identity-preflight-index ./identity-preflight-requests/identity-preflight-requests.jsonl",
|
|
18
|
+
],
|
|
19
|
+
context: {
|
|
20
|
+
queue_dir: "optional but required by the Foundry import workflow after queue build",
|
|
21
|
+
classification_queue: "optional JSONL from dataset-bundle-sample-rows; attached to authoring packages and converted into classification action items",
|
|
22
|
+
location_queue: "optional JSONL from dataset-bundle-sample-rows; attached to authoring packages and converted into location-code action items",
|
|
23
|
+
identity_preflight_index: "optional JSONL from dataset-bundle-sample-rows; attached to authoring packages with read-only hybrid-search request/result evidence for process and flow reuse decisions",
|
|
24
|
+
require_identity_preflight: "explicit hard-gate flag for profiles that require identity-preflight result artifacts for current entities and process dependencies",
|
|
25
|
+
ai_authoring_package: "includes source row, schema/QA blockers, contract/profile context, queue task, closure, dependency rows, and support rows when --queue-dir is provided",
|
|
26
|
+
},
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
const root = repoRoot;
|
|
30
|
+
const rowsFile = resolveRepoPath(root, options.rowsFile || options.input);
|
|
31
|
+
const schemaReportPath = resolveRepoPath(root, options.schemaReport);
|
|
32
|
+
const qaReportPath = resolveRepoPath(root, options.qaReport);
|
|
33
|
+
const defaultOut = `.foundry/workspaces/${datasetType}-dataset-curation-gate`;
|
|
34
|
+
const outDir = resolveRepoPath(root, options.outDir || defaultOut);
|
|
35
|
+
const profileId = String(options.profile || "generic")
|
|
36
|
+
.trim()
|
|
37
|
+
.toLowerCase();
|
|
38
|
+
const profile = profileFor(root, profileId, options);
|
|
39
|
+
if (!rowsFile || !fileExists(rowsFile)) {
|
|
40
|
+
throw new Error("--rows-file is required and must point to a JSON/JSONL dataset row file.");
|
|
41
|
+
}
|
|
42
|
+
if (!schemaReportPath || !fileExists(schemaReportPath)) {
|
|
43
|
+
throw new Error("--schema-report is required and must point to dataset-tidas-validate compatibility report JSON.");
|
|
44
|
+
}
|
|
45
|
+
if (!qaReportPath || !fileExists(qaReportPath)) {
|
|
46
|
+
throw new Error("--qa-report is required and must point to a QA report JSON.");
|
|
47
|
+
}
|
|
48
|
+
const rows = readRows(rowsFile);
|
|
49
|
+
const schemaReport = readJson(schemaReportPath);
|
|
50
|
+
const qaReport = readJson(qaReportPath);
|
|
51
|
+
const qaFindings = readQaFindings(root, qaReport, qaReportPath, datasetType);
|
|
52
|
+
const profileContext = readContextFiles(root, profile.docs.map((filePath) => [
|
|
53
|
+
"profile",
|
|
54
|
+
filePath,
|
|
55
|
+
]));
|
|
56
|
+
const contractContext = readContextFiles(root, [
|
|
57
|
+
...collectExplicitContextFiles(options),
|
|
58
|
+
...collectContextDirFiles(root, options.contextDir),
|
|
59
|
+
...collectBundledSchemaContextFiles(root),
|
|
60
|
+
]);
|
|
61
|
+
const fullContextRequirement = fullContextAiCompletionRequirement(profile, datasetType, root);
|
|
62
|
+
const fullContextItems = fullContextGateItems({
|
|
63
|
+
contractContext,
|
|
64
|
+
requirement: fullContextRequirement,
|
|
65
|
+
});
|
|
66
|
+
const queueContext = readCurationQueueContext(root, options);
|
|
67
|
+
const requireQueueContext = options.requireQueueContext === true ||
|
|
68
|
+
options.requireQueueContext === "true" ||
|
|
69
|
+
options.requireCurationQueueContext === true ||
|
|
70
|
+
options.requireCurationQueueContext === "true";
|
|
71
|
+
const classificationQueueContext = readAuthoringQueueContext(root, options.classificationQueue ?? options.classificationQueueFile, "classification");
|
|
72
|
+
const locationQueueContext = readAuthoringQueueContext(root, options.locationQueue ?? options.locationQueueFile, "location");
|
|
73
|
+
const identityPreflightContext = readIdentityPreflightContext(root, options, rowsFile);
|
|
74
|
+
const classificationDecisionApplyArtifact = readJsonIfOption(root, options.classificationDecisionApplyReport ?? options.classificationDecisionsApplyReport);
|
|
75
|
+
const classificationDecisionApplyContext = classificationDecisionApplyArtifact
|
|
76
|
+
? readClassificationDecisionApplyContext(root, classificationDecisionApplyArtifact)
|
|
77
|
+
: null;
|
|
78
|
+
const identityDecisionApplyArtifacts = readJsonArtifactsIfOption(root, identityDecisionApplyReportOptionValues(options));
|
|
79
|
+
const identityDecisionApplyArtifact = identityDecisionApplyArtifacts[0] ?? null;
|
|
80
|
+
const identityDecisionApplyContext = readIdentityDecisionApplyContexts(root, identityDecisionApplyArtifacts);
|
|
81
|
+
const unresolvedExchangeExternalizationArtifact = readJsonIfOption(root, options.unresolvedExchangeExternalizationReport);
|
|
82
|
+
const unresolvedExchangeExternalizationContext = readUnresolvedExchangeExternalizationContext(root, unresolvedExchangeExternalizationArtifact);
|
|
83
|
+
const sourceContactRewriteArtifact = readJsonIfOption(root, options.sourceContactRewriteReport ?? options.sourceContactRewritesReport);
|
|
84
|
+
const sourceContactRewriteContext = readSourceContactRewriteContext(root, sourceContactRewriteArtifact);
|
|
85
|
+
const canonicalSupportRewriteArtifact = readJsonIfOption(root, options.canonicalSupportRewriteReport ?? options.canonicalSupportRewritesReport);
|
|
86
|
+
const canonicalSupportRewriteContext = readCanonicalSupportRewriteContext(root, canonicalSupportRewriteArtifact);
|
|
87
|
+
const cleanupArtifact = readJsonIfOption(root, options.cleanupReport);
|
|
88
|
+
const cleanupContext = readCleanupTransformContext(root, cleanupArtifact);
|
|
89
|
+
const writeRows = mapRowsByIdentity(rows, datasetType);
|
|
90
|
+
const identityReferenceRewriteContext = readIdentityReferenceRewriteContext({
|
|
91
|
+
repoRoot: root,
|
|
92
|
+
rowsFile,
|
|
93
|
+
options,
|
|
94
|
+
writeRows,
|
|
95
|
+
});
|
|
96
|
+
const waivedQaCodes = new Set((profile.waivedQaCodesByType?.[datasetType] ?? []));
|
|
97
|
+
const schemaRowsById = new Map(ensureArray(schemaReport.rows).map((value) => {
|
|
98
|
+
const row = asJsonRecord(value);
|
|
99
|
+
return [String(row.id ?? row.dataset_id ?? ""), row];
|
|
100
|
+
}));
|
|
101
|
+
const qaFindingsById = new Map();
|
|
102
|
+
for (const finding of qaFindings) {
|
|
103
|
+
const id = entityIdFromFinding(finding, datasetType);
|
|
104
|
+
if (!id)
|
|
105
|
+
continue;
|
|
106
|
+
if (!qaFindingsById.has(id))
|
|
107
|
+
qaFindingsById.set(id, []);
|
|
108
|
+
qaFindingsById.get(id).push(finding);
|
|
109
|
+
}
|
|
110
|
+
const packageDir = path.join(outDir, "ai-authoring-packages");
|
|
111
|
+
const entityReports = rows.map((row, index) => {
|
|
112
|
+
const identity = datasetIdentity(row, index, datasetType);
|
|
113
|
+
const curationQueueContext = buildQueueAuthoringContext(root, queueContext, datasetType, identity);
|
|
114
|
+
const identityPreflightAuthoringContext = buildIdentityPreflightAuthoringContext({
|
|
115
|
+
context: identityPreflightContext,
|
|
116
|
+
datasetType,
|
|
117
|
+
identity,
|
|
118
|
+
curationQueueContext,
|
|
119
|
+
repoRoot: root,
|
|
120
|
+
classificationDecisionApplyContext: classificationDecisionApplyContext,
|
|
121
|
+
identityDecisionApplyContext,
|
|
122
|
+
identityReferenceRewriteContext: identityReferenceRewriteContext,
|
|
123
|
+
unresolvedExchangeExternalizationContext: unresolvedExchangeExternalizationContext,
|
|
124
|
+
sourceContactRewriteContext: sourceContactRewriteContext,
|
|
125
|
+
canonicalSupportRewriteContext: canonicalSupportRewriteContext,
|
|
126
|
+
cleanupContext: cleanupContext,
|
|
127
|
+
});
|
|
128
|
+
const unresolvedExchangeExternalizationRows = unresolvedExchangeExternalizationRowsForIdentity(unresolvedExchangeExternalizationContext, identity);
|
|
129
|
+
const identityReferenceRewrites = identityReferenceRewriteContext.byIdentity.get(identityKey(identity)) ?? [];
|
|
130
|
+
const identityDecisionApplyRows = identityDecisionApplyContextDecisionsForIdentity({
|
|
131
|
+
context: identityDecisionApplyContext,
|
|
132
|
+
datasetType,
|
|
133
|
+
id: identity.id,
|
|
134
|
+
version: identity.version,
|
|
135
|
+
});
|
|
136
|
+
const identityPreflightGateItemsForEntity = identityPreflightGateItems({
|
|
137
|
+
required: (Boolean(fullContextRequirement) || requireIdentityPreflight) &&
|
|
138
|
+
["flow", "process"].includes(datasetType),
|
|
139
|
+
context: identityPreflightContext,
|
|
140
|
+
authoringContext: identityPreflightAuthoringContext,
|
|
141
|
+
datasetType,
|
|
142
|
+
identity,
|
|
143
|
+
curationQueueContext,
|
|
144
|
+
profile: profile,
|
|
145
|
+
});
|
|
146
|
+
const identityPreflightActionItems = identityPreflightAuthoringActionItems({
|
|
147
|
+
required: (Boolean(fullContextRequirement) || requireIdentityPreflight) &&
|
|
148
|
+
["flow", "process"].includes(datasetType),
|
|
149
|
+
authoringContext: identityPreflightAuthoringContext,
|
|
150
|
+
datasetType,
|
|
151
|
+
identity,
|
|
152
|
+
identityDecisionApplyContext,
|
|
153
|
+
});
|
|
154
|
+
const classificationAuthoringRows = authoringQueueRowsForIdentity(classificationQueueContext, identity);
|
|
155
|
+
const locationAuthoringRows = authoringQueueRowsForIdentity(locationQueueContext, identity);
|
|
156
|
+
const unresolvedClassificationAuthoringRows = classificationAuthoringRows.filter((row) => classificationQueueRowStillNeedsAuthoring({
|
|
157
|
+
repoRoot: root,
|
|
158
|
+
datasetType,
|
|
159
|
+
payload: identity.payload,
|
|
160
|
+
row,
|
|
161
|
+
}));
|
|
162
|
+
const unresolvedLocationAuthoringRows = locationAuthoringRows.filter((row) => locationQueueRowStillNeedsAuthoring({
|
|
163
|
+
repoRoot: root,
|
|
164
|
+
payload: identity.payload,
|
|
165
|
+
row,
|
|
166
|
+
}));
|
|
167
|
+
const schemaRow = schemaRowsById.get(identity.id) ?? null;
|
|
168
|
+
const schemaIssues = ensureArray(schemaRow?.issues);
|
|
169
|
+
const entityQaFindings = qaFindingsById.get(identity.id) ?? [];
|
|
170
|
+
const waivedFindings = entityQaFindings.filter((finding) => waivedQaCodes.has(qaFindingCode(finding)));
|
|
171
|
+
const actionableQaFindings = entityQaFindings.filter((finding) => !waivedQaCodes.has(qaFindingCode(finding)));
|
|
172
|
+
const schemaActionItems = schemaIssues.map((issue) => schemaIssueCurationAction(issue));
|
|
173
|
+
const qaActionItems = actionableQaFindings.map((finding) => qaFindingCurationAction(finding, datasetType));
|
|
174
|
+
const semanticActionItems = collectProfileSemanticActionItems({
|
|
175
|
+
profile: profile,
|
|
176
|
+
datasetType,
|
|
177
|
+
payload: identity.payload,
|
|
178
|
+
hasClassificationQueueContext: unresolvedClassificationAuthoringRows.length > 0,
|
|
179
|
+
});
|
|
180
|
+
const classificationQueueActionItems = unresolvedClassificationAuthoringRows.map(classificationQueueActionItem);
|
|
181
|
+
const locationQueueActionItems = unresolvedLocationAuthoringRows.map(locationQueueActionItem);
|
|
182
|
+
const actionItems = [
|
|
183
|
+
...schemaActionItems.filter((item) => item.ai_required),
|
|
184
|
+
...qaActionItems,
|
|
185
|
+
...identityPreflightActionItems,
|
|
186
|
+
...classificationQueueActionItems,
|
|
187
|
+
...locationQueueActionItems,
|
|
188
|
+
...semanticActionItems,
|
|
189
|
+
].map((item) => routeAction ? routeAction(asJsonRecord(item), datasetType, identity.payload) : item);
|
|
190
|
+
const queueGateItems = [];
|
|
191
|
+
if (requireQueueContext && !queueContext) {
|
|
192
|
+
queueGateItems.push({
|
|
193
|
+
source: "curation_queue",
|
|
194
|
+
code: "curation_queue_context_required",
|
|
195
|
+
path: null,
|
|
196
|
+
message: "Full-context prewrite authoring requires curation queue and dependency closure context.",
|
|
197
|
+
action_kind: "queue_rebuild",
|
|
198
|
+
required_owner: "foundry_deterministic_queue_build",
|
|
199
|
+
ai_required: false,
|
|
200
|
+
instruction: "Run dataset-curation-queue-build for the exact rows and pass --queue-dir before AI authoring or remote write planning.",
|
|
201
|
+
});
|
|
202
|
+
}
|
|
203
|
+
else {
|
|
204
|
+
if (curationQueueContext?.status === "missing_task") {
|
|
205
|
+
queueGateItems.push({
|
|
206
|
+
source: "curation_queue",
|
|
207
|
+
code: "curation_queue_task_missing",
|
|
208
|
+
path: null,
|
|
209
|
+
message: "No matching curation queue task was found for this entity.",
|
|
210
|
+
action_kind: "queue_rebuild",
|
|
211
|
+
required_owner: "foundry_deterministic_queue_build",
|
|
212
|
+
ai_required: false,
|
|
213
|
+
instruction: "Rebuild the curation queue with this entity included before AI authoring or remote write planning.",
|
|
214
|
+
});
|
|
215
|
+
}
|
|
216
|
+
if (curationQueueContext?.queue_status && curationQueueContext.queue_status !== "ready") {
|
|
217
|
+
queueGateItems.push({
|
|
218
|
+
source: "curation_queue",
|
|
219
|
+
code: "curation_queue_not_ready",
|
|
220
|
+
path: null,
|
|
221
|
+
message: "The curation queue manifest is not ready, so dependency closure cannot be trusted for AI authoring or remote write planning.",
|
|
222
|
+
action_kind: "queue_rebuild",
|
|
223
|
+
required_owner: "foundry_deterministic_queue_build",
|
|
224
|
+
ai_required: false,
|
|
225
|
+
instruction: "Resolve curation queue blockers, rebuild the queue, and rerun the curation gate before AI authoring or remote write planning.",
|
|
226
|
+
evidence: {
|
|
227
|
+
queue_status: curationQueueContext.queue_status,
|
|
228
|
+
queue_counts: curationQueueContext.queue_counts ?? null,
|
|
229
|
+
queue_blockers: curationQueueContext.queue_blockers ?? [],
|
|
230
|
+
},
|
|
231
|
+
});
|
|
232
|
+
}
|
|
233
|
+
const queueClosure = curationQueueContext?.closure;
|
|
234
|
+
const queueDependencies = queueClosure?.dependencies;
|
|
235
|
+
const unresolvedQueueRefs = ensureArray(queueDependencies?.unresolved_refs);
|
|
236
|
+
if (unresolvedQueueRefs.length > 0) {
|
|
237
|
+
queueGateItems.push({
|
|
238
|
+
source: "curation_queue",
|
|
239
|
+
code: "curation_queue_dependency_refs_unresolved",
|
|
240
|
+
path: null,
|
|
241
|
+
message: "The curation queue closure still has unresolved dependency references for this entity.",
|
|
242
|
+
action_kind: "queue_rebuild",
|
|
243
|
+
required_owner: "foundry_deterministic_queue_build",
|
|
244
|
+
ai_required: false,
|
|
245
|
+
instruction: "Provide local dependency rows or declared external references, rebuild the queue, and rerun the curation gate before AI authoring or remote write planning.",
|
|
246
|
+
evidence: {
|
|
247
|
+
unresolved_refs: unresolvedQueueRefs,
|
|
248
|
+
},
|
|
249
|
+
});
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
const deterministicCleanupItems = [
|
|
253
|
+
...schemaActionItems.filter((item) => !item.ai_required),
|
|
254
|
+
...queueGateItems,
|
|
255
|
+
...fullContextItems,
|
|
256
|
+
...identityPreflightGateItemsForEntity,
|
|
257
|
+
];
|
|
258
|
+
const blockingItemCount = actionItems.length + deterministicCleanupItems.length;
|
|
259
|
+
const status = actionItems.length > 0
|
|
260
|
+
? "needs_foundry_ai_authoring"
|
|
261
|
+
: deterministicCleanupItems.length > 0
|
|
262
|
+
? "needs_foundry_deterministic_cleanup"
|
|
263
|
+
: waivedFindings.length > 0
|
|
264
|
+
? "ready_with_profile_waivers"
|
|
265
|
+
: "ready";
|
|
266
|
+
const packagePath = path.join(packageDir, `${datasetType}-${sanitizeFileName(identity.id)}.authoring-package.json`);
|
|
267
|
+
const packagePayload = {
|
|
268
|
+
schema_version: 2,
|
|
269
|
+
generated_at_utc: nowIso(),
|
|
270
|
+
profile: profile.id,
|
|
271
|
+
dataset_type: datasetType,
|
|
272
|
+
entity_id: identity.id,
|
|
273
|
+
version: identity.version,
|
|
274
|
+
authoring_package: repoRelativePath(root, packagePath),
|
|
275
|
+
source_rows_file: repoRelativePath(root, rowsFile),
|
|
276
|
+
profile_context_files: profileContext.files,
|
|
277
|
+
contract_context_files: contractContext.files,
|
|
278
|
+
full_context_ai_completion: fullContextRequirement
|
|
279
|
+
? {
|
|
280
|
+
required: true,
|
|
281
|
+
proof: fullContextRequirement.proof,
|
|
282
|
+
required_context_kinds: fullContextRequirement.requiredContextKinds,
|
|
283
|
+
required_context_file_patterns: fullContextRequirement.requiredContextFilePatterns,
|
|
284
|
+
context_file_details: contextFileDetails(contractContext.files),
|
|
285
|
+
}
|
|
286
|
+
: {
|
|
287
|
+
required: false,
|
|
288
|
+
},
|
|
289
|
+
missing_context_files: [...profileContext.missing, ...contractContext.missing],
|
|
290
|
+
schema_issues: schemaIssues,
|
|
291
|
+
qa_findings: entityQaFindings,
|
|
292
|
+
waived_findings: waivedFindings.map((finding) => ({
|
|
293
|
+
...finding,
|
|
294
|
+
waiver_basis: profile.waiverReasons?.[qaFindingCode(finding)] ?? null,
|
|
295
|
+
})),
|
|
296
|
+
action_items: actionItems,
|
|
297
|
+
deterministic_cleanup_items: deterministicCleanupItems,
|
|
298
|
+
curation_queue_context: curationQueueContext,
|
|
299
|
+
identity_preflight_context: identityPreflightAuthoringContext,
|
|
300
|
+
unresolved_exchange_externalization_context: unresolvedExchangeExternalizationContext
|
|
301
|
+
? {
|
|
302
|
+
status: unresolvedExchangeExternalizationContext.status,
|
|
303
|
+
report_file: unresolvedExchangeExternalizationContext.reportPathRelative,
|
|
304
|
+
input_rows_file: unresolvedExchangeExternalizationContext.inputRowsFileRelative,
|
|
305
|
+
output_rows_file: unresolvedExchangeExternalizationContext.outputRowsFileRelative,
|
|
306
|
+
traces_file: unresolvedExchangeExternalizationContext.tracesFileRelative,
|
|
307
|
+
rows: unresolvedExchangeExternalizationRows,
|
|
308
|
+
policy: "Completed entries prove Foundry moved unresolved elementary-flow process exchanges into common:other traces before schema validation and remote write planning; they do not create new elementary flows.",
|
|
309
|
+
}
|
|
310
|
+
: {
|
|
311
|
+
status: "not_provided",
|
|
312
|
+
},
|
|
313
|
+
identity_reference_rewrite_context: {
|
|
314
|
+
status: identityReferenceRewriteContext.sourceFile && identityReferenceRewrites.length > 0
|
|
315
|
+
? "attached"
|
|
316
|
+
: identityReferenceRewriteContext.sourceFile
|
|
317
|
+
? "no_rows_for_entity"
|
|
318
|
+
: "not_provided",
|
|
319
|
+
source_file: identityReferenceRewriteContext.sourceFile
|
|
320
|
+
? repoRelativePath(root, identityReferenceRewriteContext.sourceFile)
|
|
321
|
+
: null,
|
|
322
|
+
rows: identityReferenceRewrites,
|
|
323
|
+
policy: "These rows prove deterministic process reference rewrites to existing database flow identities selected by CLI identity-preflight before validation and write planning.",
|
|
324
|
+
},
|
|
325
|
+
identity_decision_apply_context: {
|
|
326
|
+
status: identityDecisionApplyContext ? identityDecisionApplyContext.status : "not_provided",
|
|
327
|
+
report_file: identityDecisionApplyArtifact
|
|
328
|
+
? repoRelativePath(root, identityDecisionApplyArtifact.path)
|
|
329
|
+
: null,
|
|
330
|
+
decisions: identityDecisionApplyRows,
|
|
331
|
+
policy: "These rows prove AI-authored identity decisions were deterministically applied before write planning. Completed decisions can close identity_preflight_manual_review action items; mutation manifest still verifies full-context evidence before remote write.",
|
|
332
|
+
},
|
|
333
|
+
classification_authoring_context: {
|
|
334
|
+
queue_file: classificationQueueContext
|
|
335
|
+
? repoRelativePath(root, classificationQueueContext.path)
|
|
336
|
+
: null,
|
|
337
|
+
rows: classificationAuthoringRows,
|
|
338
|
+
},
|
|
339
|
+
location_authoring_context: {
|
|
340
|
+
queue_file: locationQueueContext ? repoRelativePath(root, locationQueueContext.path) : null,
|
|
341
|
+
rows: locationAuthoringRows,
|
|
342
|
+
},
|
|
343
|
+
source_row: row,
|
|
344
|
+
entity_payload: identity.payload,
|
|
345
|
+
output_contract: {
|
|
346
|
+
artifact: `${datasetType}-build-plan.json or structured patch set`,
|
|
347
|
+
apply_owner: "tiangong-lca-cli dataset patch apply for structured patches, or type-specific build-plan materialize when a build plan is produced",
|
|
348
|
+
apply_report: "dataset-patch-apply-report.json is required when AI output is a structured patch set",
|
|
349
|
+
patch_contract: "Structured patch sets must include authoring_package, row_index or dataset_id/version, operation evidence or basis, and closes_action_items for the package action_items they resolve.",
|
|
350
|
+
recommended_apply: options.includeExecutionCommands === false
|
|
351
|
+
? null
|
|
352
|
+
: "node scripts/foundry.ts dataset-patch-apply --input <rows.jsonl> --patch <ai-patches.json> --out <patched.jsonl> --out-dir <apply-dir> --authoring-package-dir <ai-authoring-packages-dir> --require-authoring-package --require-action-item-closure",
|
|
353
|
+
cleanup_owner: "Foundry removes or externalizes import-only trace metadata before remote write",
|
|
354
|
+
final_gate_owner: "Foundry profile-aware curation gate",
|
|
355
|
+
},
|
|
356
|
+
};
|
|
357
|
+
if (datasetType === "process") {
|
|
358
|
+
packagePayload.process_id = identity.id;
|
|
359
|
+
packagePayload.process_payload = identity.payload;
|
|
360
|
+
packagePayload.process_qa_findings = entityQaFindings;
|
|
361
|
+
}
|
|
362
|
+
writeJson(packagePath, packagePayload);
|
|
363
|
+
const authoringPackageText = readText(packagePath);
|
|
364
|
+
const authoringPackageContextDetails = contextFileDetails(packagePayload.contract_context_files);
|
|
365
|
+
return {
|
|
366
|
+
dataset_type: datasetType,
|
|
367
|
+
entity_id: identity.id,
|
|
368
|
+
...(datasetType === "process" ? { process_id: identity.id } : {}),
|
|
369
|
+
version: identity.version,
|
|
370
|
+
schema_status: schemaRow?.status ?? "not_found",
|
|
371
|
+
schema_issue_count: schemaIssues.length,
|
|
372
|
+
qa_finding_count: entityQaFindings.length,
|
|
373
|
+
...(datasetType === "process" ? { process_qa_finding_count: entityQaFindings.length } : {}),
|
|
374
|
+
waived_finding_count: waivedFindings.length,
|
|
375
|
+
action_item_count: actionItems.length,
|
|
376
|
+
identity_action_item_count: identityPreflightActionItems.length,
|
|
377
|
+
identity_decision_apply_count: identityDecisionApplyRows.length,
|
|
378
|
+
semantic_action_item_count: semanticActionItems.length,
|
|
379
|
+
classification_queue_action_item_count: classificationQueueActionItems.length,
|
|
380
|
+
location_queue_action_item_count: locationQueueActionItems.length,
|
|
381
|
+
deterministic_cleanup_count: deterministicCleanupItems.length,
|
|
382
|
+
blocking_item_count: blockingItemCount,
|
|
383
|
+
authoring_package: repoRelativePath(root, packagePath),
|
|
384
|
+
authoring_package_sha256: sha256Text(authoringPackageText),
|
|
385
|
+
authoring_package_context_file_details: authoringPackageContextDetails,
|
|
386
|
+
status,
|
|
387
|
+
};
|
|
388
|
+
});
|
|
389
|
+
const actionItemCount = entityReports.reduce((total, item) => total + item.action_item_count, 0);
|
|
390
|
+
const semanticActionItemCount = entityReports.reduce((total, item) => total + item.semantic_action_item_count, 0);
|
|
391
|
+
const identityActionItemCount = entityReports.reduce((total, item) => total + item.identity_action_item_count, 0);
|
|
392
|
+
const classificationQueueActionItemCount = entityReports.reduce((total, item) => total + item.classification_queue_action_item_count, 0);
|
|
393
|
+
const locationQueueActionItemCount = entityReports.reduce((total, item) => total + item.location_queue_action_item_count, 0);
|
|
394
|
+
const deterministicCleanupCount = entityReports.reduce((total, item) => total + item.deterministic_cleanup_count, 0);
|
|
395
|
+
const blockingItemCount = actionItemCount + deterministicCleanupCount;
|
|
396
|
+
const waiverCount = entityReports.reduce((total, item) => total + item.waived_finding_count, 0);
|
|
397
|
+
const report = {
|
|
398
|
+
schema_version: 2,
|
|
399
|
+
generated_at_utc: nowIso(),
|
|
400
|
+
status: actionItemCount > 0
|
|
401
|
+
? "blocked_needs_foundry_ai_authoring"
|
|
402
|
+
: deterministicCleanupCount > 0
|
|
403
|
+
? "blocked_needs_foundry_deterministic_cleanup"
|
|
404
|
+
: waiverCount > 0
|
|
405
|
+
? "ready_with_profile_waivers"
|
|
406
|
+
: "ready",
|
|
407
|
+
profile: profile.id,
|
|
408
|
+
dataset_type: datasetType,
|
|
409
|
+
rows_file: repoRelativePath(root, rowsFile),
|
|
410
|
+
schema_report: repoRelativePath(root, schemaReportPath),
|
|
411
|
+
qa_report: repoRelativePath(root, qaReportPath),
|
|
412
|
+
policy: {
|
|
413
|
+
cli_qa_role: "deterministic_qa_report_only",
|
|
414
|
+
foundry_role: "profile policy, AI authoring package, deterministic cleanup, waiver, final prewrite decision",
|
|
415
|
+
waived_qa_codes: [...waivedQaCodes],
|
|
416
|
+
required_multilang_english_before_write: true,
|
|
417
|
+
preserve_source_language_variants: true,
|
|
418
|
+
},
|
|
419
|
+
context: {
|
|
420
|
+
profile_files: profileContext.files.map((file) => file.path),
|
|
421
|
+
contract_context_files: contractContext.files.map((file) => file.path),
|
|
422
|
+
contract_context_file_details: contextFileDetails(contractContext.files),
|
|
423
|
+
full_context_ai_completion: fullContextRequirement
|
|
424
|
+
? {
|
|
425
|
+
required: true,
|
|
426
|
+
proof: fullContextRequirement.proof,
|
|
427
|
+
required_context_kinds: fullContextRequirement.requiredContextKinds,
|
|
428
|
+
required_context_file_patterns: fullContextRequirement.requiredContextFilePatterns,
|
|
429
|
+
}
|
|
430
|
+
: {
|
|
431
|
+
required: false,
|
|
432
|
+
},
|
|
433
|
+
curation_queue: queueContext
|
|
434
|
+
? {
|
|
435
|
+
queue_dir: repoRelativePath(root, queueContext.queueDir),
|
|
436
|
+
manifest_file: repoRelativePath(root, queueContext.manifestPath),
|
|
437
|
+
status: queueContext.manifest.status ?? null,
|
|
438
|
+
counts: queueContext.manifest.counts ?? null,
|
|
439
|
+
}
|
|
440
|
+
: null,
|
|
441
|
+
require_queue_context: requireQueueContext,
|
|
442
|
+
classification_queue: classificationQueueContext
|
|
443
|
+
? {
|
|
444
|
+
queue_file: repoRelativePath(root, classificationQueueContext.path),
|
|
445
|
+
rows: classificationQueueContext.rows.length,
|
|
446
|
+
}
|
|
447
|
+
: null,
|
|
448
|
+
location_queue: locationQueueContext
|
|
449
|
+
? {
|
|
450
|
+
queue_file: repoRelativePath(root, locationQueueContext.path),
|
|
451
|
+
rows: locationQueueContext.rows.length,
|
|
452
|
+
}
|
|
453
|
+
: null,
|
|
454
|
+
unresolved_exchange_externalization: unresolvedExchangeExternalizationContext
|
|
455
|
+
? {
|
|
456
|
+
status: unresolvedExchangeExternalizationContext.status,
|
|
457
|
+
report_file: unresolvedExchangeExternalizationContext.reportPathRelative,
|
|
458
|
+
input_rows_file: unresolvedExchangeExternalizationContext.inputRowsFileRelative,
|
|
459
|
+
output_rows_file: unresolvedExchangeExternalizationContext.outputRowsFileRelative,
|
|
460
|
+
traces_file: unresolvedExchangeExternalizationContext.tracesFileRelative,
|
|
461
|
+
externalized_exchanges: unresolvedExchangeExternalizationContext.externalizedExchanges,
|
|
462
|
+
affected_rows: unresolvedExchangeExternalizationContext.affectedRows,
|
|
463
|
+
}
|
|
464
|
+
: null,
|
|
465
|
+
identity_preflight: identityPreflightContext
|
|
466
|
+
? {
|
|
467
|
+
index_file: repoRelativePath(root, identityPreflightContext.indexPath),
|
|
468
|
+
rows: identityPreflightContext.rows.length,
|
|
469
|
+
completed: identityPreflightContext.completed,
|
|
470
|
+
pending: identityPreflightContext.pending,
|
|
471
|
+
}
|
|
472
|
+
: null,
|
|
473
|
+
identity_reference_rewrites: identityReferenceRewriteContext.sourceFile
|
|
474
|
+
? {
|
|
475
|
+
source_file: repoRelativePath(root, identityReferenceRewriteContext.sourceFile),
|
|
476
|
+
rows: identityReferenceRewriteContext.sourceRows.length,
|
|
477
|
+
scoped_rows: identityReferenceRewriteContext.scopedRows.length,
|
|
478
|
+
}
|
|
479
|
+
: null,
|
|
480
|
+
identity_decision_apply: identityDecisionApplyContext
|
|
481
|
+
? {
|
|
482
|
+
report_file: repoRelativePath(root, identityDecisionApplyArtifact.path),
|
|
483
|
+
status: identityDecisionApplyContext.status,
|
|
484
|
+
decisions: identityDecisionApplyContext.decisions.length,
|
|
485
|
+
authoring_package_proofs: identityDecisionApplyContext.authoringPackageProofs.length,
|
|
486
|
+
}
|
|
487
|
+
: null,
|
|
488
|
+
missing_context_files: [...profileContext.missing, ...contractContext.missing],
|
|
489
|
+
},
|
|
490
|
+
counts: {
|
|
491
|
+
entities: entityReports.length,
|
|
492
|
+
[datasetTypePlural[datasetType]]: entityReports.length,
|
|
493
|
+
action_items: actionItemCount,
|
|
494
|
+
identity_action_items: identityActionItemCount,
|
|
495
|
+
semantic_action_items: semanticActionItemCount,
|
|
496
|
+
classification_queue_action_items: classificationQueueActionItemCount,
|
|
497
|
+
location_queue_action_items: locationQueueActionItemCount,
|
|
498
|
+
deterministic_cleanup_items: deterministicCleanupCount,
|
|
499
|
+
blocking_items: blockingItemCount,
|
|
500
|
+
waivers: waiverCount,
|
|
501
|
+
identity_preflight_rows: identityPreflightContext?.rows.length ?? 0,
|
|
502
|
+
identity_preflight_completed: identityPreflightContext?.completed ?? 0,
|
|
503
|
+
identity_preflight_pending: identityPreflightContext?.pending ?? 0,
|
|
504
|
+
identity_reference_rewrites: identityReferenceRewriteContext.scopedRows.length,
|
|
505
|
+
identity_decisions: identityDecisionApplyContext?.decisions.length ?? 0,
|
|
506
|
+
},
|
|
507
|
+
entities: entityReports,
|
|
508
|
+
};
|
|
509
|
+
if (datasetType === "process") {
|
|
510
|
+
report.processes = entityReports;
|
|
511
|
+
}
|
|
512
|
+
fs.mkdirSync(outDir, { recursive: true });
|
|
513
|
+
const reportFileName = "dataset-curation-gate-report.json";
|
|
514
|
+
const entitiesFileName = `${datasetType}-curation-gate-entities.jsonl`;
|
|
515
|
+
const reportPath = path.join(outDir, reportFileName);
|
|
516
|
+
const jsonlPath = path.join(outDir, entitiesFileName);
|
|
517
|
+
writeJson(reportPath, report);
|
|
518
|
+
writeText(jsonlPath, jsonLines(entityReports));
|
|
519
|
+
return {
|
|
520
|
+
...report,
|
|
521
|
+
files: {
|
|
522
|
+
report: repoRelativePath(root, reportPath),
|
|
523
|
+
entities: repoRelativePath(root, jsonlPath),
|
|
524
|
+
...(datasetType === "process" ? { processes: repoRelativePath(root, jsonlPath) } : {}),
|
|
525
|
+
authoring_packages_dir: repoRelativePath(root, packageDir),
|
|
526
|
+
},
|
|
527
|
+
};
|
|
528
|
+
}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
type JsonRecord = Record<string, unknown>;
|
|
2
|
+
export type QaFinding = JsonRecord;
|
|
3
|
+
export type QaCurationAction = {
|
|
4
|
+
source: string;
|
|
5
|
+
code: string;
|
|
6
|
+
path: string | null;
|
|
7
|
+
message: unknown;
|
|
8
|
+
evidence: unknown;
|
|
9
|
+
instruction: string | null;
|
|
10
|
+
action_kind: "ai_authoring";
|
|
11
|
+
required_owner: "foundry_ai_authoring";
|
|
12
|
+
ai_required: true;
|
|
13
|
+
};
|
|
14
|
+
export declare function idFromArtifactFile(fileName: unknown): string;
|
|
15
|
+
export declare function entityIdFromFinding(finding: unknown, datasetType: string): string;
|
|
16
|
+
export declare function readJsonLinesIfExists(filePath: string | null | undefined): unknown[];
|
|
17
|
+
export declare function resolveArtifactPath(repoRoot: string, filePath: string | null | undefined, baseDir: string): string | null;
|
|
18
|
+
export declare function qaFindingCode(finding: QaFinding | null | undefined): string;
|
|
19
|
+
export declare const qaFindingPathDefaults: Record<string, Record<string, string>>;
|
|
20
|
+
export declare function qaFindingPath(finding: QaFinding | null | undefined, datasetType: string): string | null;
|
|
21
|
+
export declare function qaFindingInstruction(finding: QaFinding | null | undefined, datasetType: string): string | null;
|
|
22
|
+
export declare function qaFindingCurationAction(finding: QaFinding, datasetType: string): QaCurationAction;
|
|
23
|
+
export declare function readQaFindings(repoRoot: string, qaReport: unknown, qaReportPath: string, datasetType: string): QaFinding[];
|
|
24
|
+
export {};
|