@dommaker/harness 1.6.0 → 1.8.0
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/CHANGELOG.md +52 -0
- package/bin/harness.js +17 -1
- package/dist/agents/index.d.ts +6 -2
- package/dist/agents/index.d.ts.map +1 -1
- package/dist/agents/index.js +6 -16
- package/dist/agents/index.js.map +1 -1
- package/dist/cli/commands/__tests__/gate-decision.d.ts +18 -0
- package/dist/cli/commands/__tests__/gate-decision.d.ts.map +1 -0
- package/dist/cli/commands/__tests__/gate-decision.js +26 -0
- package/dist/cli/commands/__tests__/gate-decision.js.map +1 -0
- package/dist/cli/commands/acceptance.d.ts.map +1 -1
- package/dist/cli/commands/acceptance.js +17 -28
- package/dist/cli/commands/acceptance.js.map +1 -1
- package/dist/cli/commands/check.d.ts +11 -3
- package/dist/cli/commands/check.d.ts.map +1 -1
- package/dist/cli/commands/check.js +26 -11
- package/dist/cli/commands/check.js.map +1 -1
- package/dist/cli/commands/command.d.ts +0 -1
- package/dist/cli/commands/command.d.ts.map +1 -1
- package/dist/cli/commands/command.js +8 -6
- package/dist/cli/commands/command.js.map +1 -1
- package/dist/cli/commands/constraints-retire.d.ts.map +1 -1
- package/dist/cli/commands/constraints-retire.js +36 -57
- package/dist/cli/commands/constraints-retire.js.map +1 -1
- package/dist/cli/commands/contract.d.ts.map +1 -1
- package/dist/cli/commands/contract.js +36 -42
- package/dist/cli/commands/contract.js.map +1 -1
- package/dist/cli/commands/definitions.d.ts +2 -0
- package/dist/cli/commands/definitions.d.ts.map +1 -1
- package/dist/cli/commands/definitions.js +11 -6
- package/dist/cli/commands/definitions.js.map +1 -1
- package/dist/cli/commands/failure.d.ts.map +1 -1
- package/dist/cli/commands/failure.js +16 -2
- package/dist/cli/commands/failure.js.map +1 -1
- package/dist/cli/commands/init.d.ts +14 -8
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +172 -364
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/commands/knowledge-view.d.ts +90 -0
- package/dist/cli/commands/knowledge-view.d.ts.map +1 -0
- package/dist/cli/commands/knowledge-view.js +198 -0
- package/dist/cli/commands/knowledge-view.js.map +1 -0
- package/dist/cli/commands/knowledge.d.ts +137 -52
- package/dist/cli/commands/knowledge.d.ts.map +1 -1
- package/dist/cli/commands/knowledge.js +534 -400
- package/dist/cli/commands/knowledge.js.map +1 -1
- package/dist/cli/commands/passes-gate.d.ts +4 -1
- package/dist/cli/commands/passes-gate.d.ts.map +1 -1
- package/dist/cli/commands/passes-gate.js +11 -2
- package/dist/cli/commands/passes-gate.js.map +1 -1
- package/dist/cli/commands/performance.d.ts.map +1 -1
- package/dist/cli/commands/performance.js +19 -31
- package/dist/cli/commands/performance.js.map +1 -1
- package/dist/cli/commands/report.d.ts.map +1 -1
- package/dist/cli/commands/report.js +2 -1
- package/dist/cli/commands/report.js.map +1 -1
- package/dist/cli/commands/review.d.ts.map +1 -1
- package/dist/cli/commands/review.js +13 -25
- package/dist/cli/commands/review.js.map +1 -1
- package/dist/cli/commands/scaffold-templates.d.ts +73 -0
- package/dist/cli/commands/scaffold-templates.d.ts.map +1 -0
- package/dist/cli/commands/scaffold-templates.js +424 -0
- package/dist/cli/commands/scaffold-templates.js.map +1 -0
- package/dist/cli/commands/scaffold.d.ts +105 -0
- package/dist/cli/commands/scaffold.d.ts.map +1 -0
- package/dist/cli/commands/scaffold.js +263 -0
- package/dist/cli/commands/scaffold.js.map +1 -0
- package/dist/cli/commands/security.d.ts.map +1 -1
- package/dist/cli/commands/security.js +22 -24
- package/dist/cli/commands/security.js.map +1 -1
- package/dist/cli/commands/spec-baseline-check.d.ts +43 -0
- package/dist/cli/commands/spec-baseline-check.d.ts.map +1 -1
- package/dist/cli/commands/spec-baseline-check.js +109 -34
- package/dist/cli/commands/spec-baseline-check.js.map +1 -1
- package/dist/cli/commands/sync-docs/context-syncer.d.ts +21 -2
- package/dist/cli/commands/sync-docs/context-syncer.d.ts.map +1 -1
- package/dist/cli/commands/sync-docs/context-syncer.js +112 -28
- package/dist/cli/commands/sync-docs/context-syncer.js.map +1 -1
- package/dist/cli/commands/sync-docs/index.d.ts +1 -1
- package/dist/cli/commands/sync-docs/index.d.ts.map +1 -1
- package/dist/cli/commands/sync-docs/index.js +86 -27
- package/dist/cli/commands/sync-docs/index.js.map +1 -1
- package/dist/cli/commands/sync-docs/project-reader.d.ts +24 -1
- package/dist/cli/commands/sync-docs/project-reader.d.ts.map +1 -1
- package/dist/cli/commands/sync-docs/project-reader.js +33 -7
- package/dist/cli/commands/sync-docs/project-reader.js.map +1 -1
- package/dist/cli/commands/validate.d.ts +0 -16
- package/dist/cli/commands/validate.d.ts.map +1 -1
- package/dist/cli/commands/validate.js +2 -97
- package/dist/cli/commands/validate.js.map +1 -1
- package/dist/cli/gate-command.d.ts +37 -0
- package/dist/cli/gate-command.d.ts.map +1 -0
- package/dist/cli/gate-command.js +64 -0
- package/dist/cli/gate-command.js.map +1 -0
- package/dist/completion-checkers/index.d.ts +1 -1
- package/dist/completion-checkers/index.d.ts.map +1 -1
- package/dist/completion-checkers/index.js +0 -15
- package/dist/completion-checkers/index.js.map +1 -1
- package/dist/context/knowledge-injector.d.ts +4 -2
- package/dist/context/knowledge-injector.d.ts.map +1 -1
- package/dist/context/knowledge-injector.js +13 -6
- package/dist/context/knowledge-injector.js.map +1 -1
- package/dist/core/constraints/agent-prompt-renderer.js +2 -2
- package/dist/core/constraints/agent-prompt-renderer.js.map +1 -1
- package/dist/core/constraints/capabilities-reconcile.d.ts +20 -0
- package/dist/core/constraints/capabilities-reconcile.d.ts.map +1 -1
- package/dist/core/constraints/capabilities-reconcile.js +26 -4
- package/dist/core/constraints/capabilities-reconcile.js.map +1 -1
- package/dist/core/constraints/check-cache.d.ts +1 -1
- package/dist/core/constraints/check-cache.js +1 -1
- package/dist/core/constraints/checker.d.ts +8 -3
- package/dist/core/constraints/checker.d.ts.map +1 -1
- package/dist/core/constraints/checker.js +30 -19
- package/dist/core/constraints/checker.js.map +1 -1
- package/dist/core/constraints/checkers/capability-sync.d.ts +3 -1
- package/dist/core/constraints/checkers/capability-sync.d.ts.map +1 -1
- package/dist/core/constraints/checkers/capability-sync.js +17 -24
- package/dist/core/constraints/checkers/capability-sync.js.map +1 -1
- package/dist/core/constraints/checkers/context-doc-sync.d.ts +1 -1
- package/dist/core/constraints/checkers/context-doc-sync.d.ts.map +1 -1
- package/dist/core/constraints/checkers/context-doc-sync.js +9 -6
- package/dist/core/constraints/checkers/context-doc-sync.js.map +1 -1
- package/dist/core/constraints/checkers/docs-freshness.d.ts.map +1 -1
- package/dist/core/constraints/checkers/docs-freshness.js +24 -30
- package/dist/core/constraints/checkers/docs-freshness.js.map +1 -1
- package/dist/core/constraints/checkers/governance-presence.d.ts.map +1 -1
- package/dist/core/constraints/checkers/governance-presence.js +10 -4
- package/dist/core/constraints/checkers/governance-presence.js.map +1 -1
- package/dist/core/constraints/checkers/types.d.ts +10 -6
- package/dist/core/constraints/checkers/types.d.ts.map +1 -1
- package/dist/core/constraints/checkers/types.js +7 -3
- package/dist/core/constraints/checkers/types.js.map +1 -1
- package/dist/core/constraints/context-builder.d.ts +11 -10
- package/dist/core/constraints/context-builder.d.ts.map +1 -1
- package/dist/core/constraints/context-builder.js +31 -27
- package/dist/core/constraints/context-builder.js.map +1 -1
- package/dist/core/constraints/context-reconcile.d.ts +75 -0
- package/dist/core/constraints/context-reconcile.d.ts.map +1 -0
- package/dist/core/constraints/context-reconcile.js +161 -0
- package/dist/core/constraints/context-reconcile.js.map +1 -0
- package/dist/core/constraints/doc-freshness/runner.d.ts +7 -0
- package/dist/core/constraints/doc-freshness/runner.d.ts.map +1 -1
- package/dist/core/constraints/doc-freshness/runner.js +8 -3
- package/dist/core/constraints/doc-freshness/runner.js.map +1 -1
- package/dist/core/constraints/git-evidence.js +1 -1
- package/dist/core/constraints/git-evidence.js.map +1 -1
- package/dist/core/constraints/injection-drift.d.ts +7 -2
- package/dist/core/constraints/injection-drift.d.ts.map +1 -1
- package/dist/core/constraints/injection-drift.js +13 -7
- package/dist/core/constraints/injection-drift.js.map +1 -1
- package/dist/core/constraints/run-env.d.ts +92 -0
- package/dist/core/constraints/run-env.d.ts.map +1 -0
- package/dist/core/constraints/run-env.js +175 -0
- package/dist/core/constraints/run-env.js.map +1 -0
- package/dist/core/constraints/triggers.d.ts +22 -0
- package/dist/core/constraints/triggers.d.ts.map +1 -0
- package/dist/core/constraints/triggers.js +31 -0
- package/dist/core/constraints/triggers.js.map +1 -0
- package/dist/core/effective-constraints.d.ts +13 -4
- package/dist/core/effective-constraints.d.ts.map +1 -1
- package/dist/core/effective-constraints.js +16 -6
- package/dist/core/effective-constraints.js.map +1 -1
- package/dist/core/effective-set.d.ts +8 -15
- package/dist/core/effective-set.d.ts.map +1 -1
- package/dist/core/effective-set.js +7 -12
- package/dist/core/effective-set.js.map +1 -1
- package/dist/core/index.d.ts +2 -1
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js.map +1 -1
- package/dist/core/project-config-loader.d.ts +39 -17
- package/dist/core/project-config-loader.d.ts.map +1 -1
- package/dist/core/project-config-loader.js +51 -122
- package/dist/core/project-config-loader.js.map +1 -1
- package/dist/core/validators/check-handlers/http.d.ts +2 -2
- package/dist/core/validators/check-handlers/http.d.ts.map +1 -1
- package/dist/core/validators/check-handlers/http.js +12 -7
- package/dist/core/validators/check-handlers/http.js.map +1 -1
- package/dist/core/validators/index.d.ts +1 -1
- package/dist/core/validators/index.d.ts.map +1 -1
- package/dist/core/validators/passes-gate.d.ts.map +1 -1
- package/dist/core/validators/passes-gate.js +2 -2
- package/dist/core/validators/passes-gate.js.map +1 -1
- package/dist/failure/classifier.d.ts +1 -1
- package/dist/failure/classifier.d.ts.map +1 -1
- package/dist/failure/classifier.js +8 -8
- package/dist/failure/classifier.js.map +1 -1
- package/dist/failure/index.d.ts +2 -1
- package/dist/failure/index.d.ts.map +1 -1
- package/dist/failure/index.js +9 -17
- package/dist/failure/index.js.map +1 -1
- package/dist/failure/recorder.d.ts +1 -1
- package/dist/failure/recorder.d.ts.map +1 -1
- package/dist/gates/checker-gate.d.ts +2 -1
- package/dist/gates/checker-gate.d.ts.map +1 -1
- package/dist/gates/checker-gate.js +3 -2
- package/dist/gates/checker-gate.js.map +1 -1
- package/dist/gates/command.d.ts +10 -4
- package/dist/gates/command.d.ts.map +1 -1
- package/dist/gates/command.js +36 -62
- package/dist/gates/command.js.map +1 -1
- package/dist/gates/contract.d.ts.map +1 -1
- package/dist/gates/contract.js +0 -4
- package/dist/gates/contract.js.map +1 -1
- package/dist/gates/definitions.d.ts +2 -1
- package/dist/gates/definitions.d.ts.map +1 -1
- package/dist/gates/definitions.js +6 -5
- package/dist/gates/definitions.js.map +1 -1
- package/dist/gates/index.d.ts +0 -4
- package/dist/gates/index.d.ts.map +1 -1
- package/dist/gates/index.js +1 -6
- package/dist/gates/index.js.map +1 -1
- package/dist/gates/performance.d.ts.map +1 -1
- package/dist/gates/performance.js +0 -4
- package/dist/gates/performance.js.map +1 -1
- package/dist/gates/runner.d.ts +1 -1
- package/dist/gates/runner.js +1 -1
- package/dist/gates/security.d.ts +1 -1
- package/dist/gates/security.d.ts.map +1 -1
- package/dist/gates/security.js +5 -6
- package/dist/gates/security.js.map +1 -1
- package/dist/gates/types.d.ts +14 -17
- package/dist/gates/types.d.ts.map +1 -1
- package/dist/gates/types.js.map +1 -1
- package/dist/hooks/bootstrap.d.ts +6 -4
- package/dist/hooks/bootstrap.d.ts.map +1 -1
- package/dist/hooks/bootstrap.js +25 -13
- package/dist/hooks/bootstrap.js.map +1 -1
- package/dist/hooks/config.d.ts +6 -2
- package/dist/hooks/config.d.ts.map +1 -1
- package/dist/hooks/config.js +5 -1
- package/dist/hooks/config.js.map +1 -1
- package/dist/hooks/index.d.ts +1 -1
- package/dist/hooks/index.d.ts.map +1 -1
- package/dist/hooks/index.js +0 -15
- package/dist/hooks/index.js.map +1 -1
- package/dist/hooks/pipeline.d.ts.map +1 -1
- package/dist/hooks/pipeline.js +2 -4
- package/dist/hooks/pipeline.js.map +1 -1
- package/dist/hooks/registry.d.ts +11 -8
- package/dist/hooks/registry.d.ts.map +1 -1
- package/dist/hooks/registry.js +22 -7
- package/dist/hooks/registry.js.map +1 -1
- package/dist/hooks/types.d.ts +23 -7
- package/dist/hooks/types.d.ts.map +1 -1
- package/dist/index.d.ts +4 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -4
- package/dist/index.js.map +1 -1
- package/dist/knowledge/audit-scoring.d.ts +87 -0
- package/dist/knowledge/audit-scoring.d.ts.map +1 -0
- package/dist/knowledge/audit-scoring.js +470 -0
- package/dist/knowledge/audit-scoring.js.map +1 -0
- package/dist/knowledge/audit.d.ts +11 -59
- package/dist/knowledge/audit.d.ts.map +1 -1
- package/dist/knowledge/audit.js +47 -522
- package/dist/knowledge/audit.js.map +1 -1
- package/dist/knowledge/import.d.ts.map +1 -1
- package/dist/knowledge/import.js +2 -0
- package/dist/knowledge/import.js.map +1 -1
- package/dist/knowledge/index-generator.d.ts.map +1 -1
- package/dist/knowledge/index-generator.js +4 -5
- package/dist/knowledge/index-generator.js.map +1 -1
- package/dist/knowledge/index.d.ts +3 -2
- package/dist/knowledge/index.d.ts.map +1 -1
- package/dist/knowledge/index.js +3 -16
- package/dist/knowledge/index.js.map +1 -1
- package/dist/knowledge/ingest.js +1 -1
- package/dist/knowledge/ingest.js.map +1 -1
- package/dist/knowledge/lifecycle.d.ts.map +1 -1
- package/dist/knowledge/lifecycle.js +4 -2
- package/dist/knowledge/lifecycle.js.map +1 -1
- package/dist/knowledge/migration.d.ts +3 -0
- package/dist/knowledge/migration.d.ts.map +1 -1
- package/dist/knowledge/migration.js +8 -2
- package/dist/knowledge/migration.js.map +1 -1
- package/dist/knowledge/query.d.ts +6 -0
- package/dist/knowledge/query.d.ts.map +1 -1
- package/dist/knowledge/query.js +8 -2
- package/dist/knowledge/query.js.map +1 -1
- package/dist/knowledge/reference-tracker.d.ts.map +1 -1
- package/dist/knowledge/reference-tracker.js +4 -6
- package/dist/knowledge/reference-tracker.js.map +1 -1
- package/dist/knowledge/store.d.ts +22 -16
- package/dist/knowledge/store.d.ts.map +1 -1
- package/dist/knowledge/store.js +53 -12
- package/dist/knowledge/store.js.map +1 -1
- package/dist/knowledge/tree-walker.d.ts +19 -0
- package/dist/knowledge/tree-walker.d.ts.map +1 -0
- package/dist/knowledge/tree-walker.js +30 -0
- package/dist/knowledge/tree-walker.js.map +1 -0
- package/dist/knowledge/types.d.ts +16 -0
- package/dist/knowledge/types.d.ts.map +1 -1
- package/dist/monitoring/traces.d.ts +5 -3
- package/dist/monitoring/traces.d.ts.map +1 -1
- package/dist/monitoring/traces.js +19 -5
- package/dist/monitoring/traces.js.map +1 -1
- package/dist/test-setup/jsonl-fake-fs.d.ts +30 -0
- package/dist/test-setup/jsonl-fake-fs.d.ts.map +1 -0
- package/dist/test-setup/jsonl-fake-fs.js +49 -0
- package/dist/test-setup/jsonl-fake-fs.js.map +1 -0
- package/dist/tools/index.d.ts +4 -1
- package/dist/tools/index.d.ts.map +1 -1
- package/dist/tools/index.js +7 -15
- package/dist/tools/index.js.map +1 -1
- package/dist/types/checkpoint.d.ts +5 -0
- package/dist/types/checkpoint.d.ts.map +1 -1
- package/dist/types/passes-gate.d.ts +0 -13
- package/dist/types/passes-gate.d.ts.map +1 -1
- package/dist/types/project-config.d.ts +18 -0
- package/dist/types/project-config.d.ts.map +1 -1
- package/dist/types/trace.d.ts +13 -4
- package/dist/types/trace.d.ts.map +1 -1
- package/dist/types/trace.js +4 -3
- package/dist/types/trace.js.map +1 -1
- package/dist/utils/exec.d.ts +4 -27
- package/dist/utils/exec.d.ts.map +1 -1
- package/dist/utils/exec.js +4 -94
- package/dist/utils/exec.js.map +1 -1
- package/dist/utils/jsonl.d.ts +17 -7
- package/dist/utils/jsonl.d.ts.map +1 -1
- package/dist/utils/jsonl.js +144 -17
- package/dist/utils/jsonl.js.map +1 -1
- package/dist/utils/numeric-flag.d.ts +44 -0
- package/dist/utils/numeric-flag.d.ts.map +1 -0
- package/dist/utils/numeric-flag.js +62 -0
- package/dist/utils/numeric-flag.js.map +1 -0
- package/package.json +1 -1
- package/src/CONTEXT.md +5 -2
- package/src/__tests__/acceptance-gate.test.ts +7 -4
- package/src/__tests__/checker-extra.test.ts +3 -2
- package/src/__tests__/checker.test.ts +4 -3
- package/src/__tests__/checkpoint.test.ts +26 -9
- package/src/__tests__/context-files-resolution.test.ts +29 -15
- package/src/__tests__/contract-gate.test.ts +19 -40
- package/src/__tests__/error-classifier.test.ts +1 -1
- package/src/__tests__/exec.test.ts +45 -107
- package/src/__tests__/failure-recorder.test.ts +7 -5
- package/src/__tests__/hooks-pipeline.test.ts +34 -47
- package/src/__tests__/layering.test.ts +217 -25
- package/src/__tests__/passes-gate.test.ts +9 -4
- package/src/__tests__/performance-gate.test.ts +3 -15
- package/src/__tests__/project-config-loader-extra.test.ts +31 -57
- package/src/__tests__/project-config-loader.test.ts +6 -3
- package/src/__tests__/public-exports.test.ts +27 -6
- package/src/__tests__/public-type-surface.test.ts +360 -0
- package/src/__tests__/public-value-surface.test.ts +182 -0
- package/src/__tests__/review-gate.test.ts +4 -6
- package/src/__tests__/security-gate.test.ts +5 -20
- package/src/__tests__/skip-semantics.test.ts +5 -3
- package/src/__tests__/spec-validator.test.ts +3 -2
- package/src/__tests__/sub-barrels-explicit.test.ts +87 -0
- package/src/__tests__/test-fixture-hygiene.test.ts +53 -0
- package/src/__tests__/trace-analyzer-extra.test.ts +5 -3
- package/src/__tests__/trace-analyzer.test.ts +5 -3
- package/src/__tests__/trace-collector.test.ts +5 -3
- package/src/agents/index.ts +13 -2
- package/src/cli/__tests__/gate-command.test.ts +162 -0
- package/src/cli/commands/CONTEXT.md +29 -5
- package/src/cli/commands/__tests__/acceptance.test.ts +24 -25
- package/src/cli/commands/__tests__/bin-exit-mapping.test.ts +15 -0
- package/src/cli/commands/__tests__/check-drift.test.ts +42 -1
- package/src/cli/commands/__tests__/check-read-count.test.ts +167 -0
- package/src/cli/commands/__tests__/check-skip-output.test.ts +4 -1
- package/src/cli/commands/__tests__/check.test.ts +43 -36
- package/src/cli/commands/__tests__/command-gate-dead-options.test.ts +60 -0
- package/src/cli/commands/__tests__/command.test.ts +33 -17
- package/src/cli/commands/__tests__/constraints-retire.test.ts +52 -0
- package/src/cli/commands/__tests__/context-syncer.test.ts +141 -0
- package/src/cli/commands/__tests__/contract.test.ts +20 -20
- package/src/cli/commands/__tests__/failure.test.ts +5 -4
- package/src/cli/commands/__tests__/gate-decision.ts +30 -0
- package/src/cli/commands/__tests__/init-dead-options.test.ts +50 -0
- package/src/cli/commands/__tests__/init-governance-io.test.ts +139 -0
- package/src/cli/commands/__tests__/init-injection.test.ts +3 -3
- package/src/cli/commands/__tests__/init-ondisk.test.ts +867 -0
- package/src/cli/commands/__tests__/init.test.ts +82 -6
- package/src/cli/commands/__tests__/knowledge-audit-threshold.test.ts +146 -0
- package/src/cli/commands/__tests__/knowledge-flywheel-consistency.test.ts +1 -1
- package/src/cli/commands/__tests__/knowledge-tone-mapping.test.ts +244 -0
- package/src/cli/commands/__tests__/knowledge-view.test.ts +839 -0
- package/src/cli/commands/__tests__/knowledge.test.ts +33 -15
- package/src/cli/commands/__tests__/numeric-flag-assembly.test.ts +368 -0
- package/src/cli/commands/__tests__/passes-gate-dead-options.test.ts +89 -1
- package/src/cli/commands/__tests__/performance.test.ts +19 -21
- package/src/cli/commands/__tests__/posteval-plan.test.ts +5 -3
- package/src/cli/commands/__tests__/pre-push-hook.test.ts +181 -0
- package/src/cli/commands/__tests__/project-path-anchoring.test.ts +95 -2
- package/src/cli/commands/__tests__/project-path-convention.test.ts +103 -25
- package/src/cli/commands/__tests__/registry.test.ts +2 -0
- package/src/cli/commands/__tests__/report.test.ts +23 -1
- package/src/cli/commands/__tests__/review.test.ts +10 -17
- package/src/cli/commands/__tests__/scaffold.test.ts +505 -0
- package/src/cli/commands/__tests__/security-default-scan.test.ts +75 -0
- package/src/cli/commands/__tests__/security.test.ts +21 -24
- package/src/cli/commands/__tests__/spec-baseline-check.test.ts +3 -2
- package/src/cli/commands/__tests__/spec-baseline-index-cap.test.ts +131 -0
- package/src/cli/commands/__tests__/spec-baseline-read-count.test.ts +325 -0
- package/src/cli/commands/__tests__/sync-docs-agents.test.ts +19 -4
- package/src/cli/commands/__tests__/sync-docs-context-drift.test.ts +232 -0
- package/src/cli/commands/__tests__/sync-docs-module-order.test.ts +111 -0
- package/src/cli/commands/__tests__/sync-docs-read-count.test.ts +192 -0
- package/src/cli/commands/__tests__/sync-docs.test.ts +3 -2
- package/src/cli/commands/__tests__/validate.test.ts +1 -48
- package/src/cli/commands/acceptance.ts +24 -29
- package/src/cli/commands/check.ts +40 -17
- package/src/cli/commands/command.ts +9 -8
- package/src/cli/commands/constraints-retire.ts +57 -70
- package/src/cli/commands/contract.ts +44 -47
- package/src/cli/commands/definitions.ts +12 -6
- package/src/cli/commands/failure.ts +16 -3
- package/src/cli/commands/init.ts +242 -389
- package/src/cli/commands/knowledge-view.ts +224 -0
- package/src/cli/commands/knowledge.ts +643 -448
- package/src/cli/commands/passes-gate.ts +12 -3
- package/src/cli/commands/performance.ts +31 -38
- package/src/cli/commands/report.ts +3 -2
- package/src/cli/commands/review.ts +22 -28
- package/src/cli/commands/scaffold-templates.ts +406 -0
- package/src/cli/commands/scaffold.ts +302 -0
- package/src/cli/commands/security.ts +27 -23
- package/src/cli/commands/spec-baseline-check.ts +158 -33
- package/src/cli/commands/sync-docs/__tests__/context-export-surface.test.ts +102 -0
- package/src/cli/commands/sync-docs/__tests__/module-descriptions.test.ts +196 -0
- package/src/cli/commands/sync-docs/context-syncer.ts +137 -31
- package/src/cli/commands/sync-docs/index.ts +103 -28
- package/src/cli/commands/sync-docs/project-reader.ts +51 -7
- package/src/cli/commands/validate.ts +1 -104
- package/src/cli/gate-command.ts +87 -0
- package/src/completion-checkers/index.ts +10 -1
- package/src/context/CONTEXT.md +2 -1
- package/src/context/__tests__/knowledge-injector.test.ts +27 -0
- package/src/context/__tests__/session-manager.test.ts +19 -12
- package/src/context/knowledge-injector.ts +14 -7
- package/src/core/CONTEXT.md +10 -7
- package/src/core/__tests__/effective-set.test.ts +36 -60
- package/src/core/constraints/__tests__/context-reconcile.test.ts +246 -0
- package/src/core/constraints/__tests__/run-env.test.ts +377 -0
- package/src/core/constraints/__tests__/triggers.test.ts +70 -0
- package/src/core/constraints/agent-prompt-renderer.ts +1 -1
- package/src/core/constraints/capabilities-reconcile.ts +28 -4
- package/src/core/constraints/check-cache.ts +1 -1
- package/src/core/constraints/checker.ts +30 -14
- package/src/core/constraints/checkers/__tests__/context-doc-sync.test.ts +8 -3
- package/src/core/constraints/checkers/__tests__/governance-presence.test.ts +16 -7
- package/src/core/constraints/checkers/__tests__/no-hardcoded-credentials.test.ts +2 -1
- package/src/core/constraints/checkers/capability-sync.ts +27 -28
- package/src/core/constraints/checkers/context-doc-sync.ts +9 -7
- package/src/core/constraints/checkers/docs-freshness.ts +28 -33
- package/src/core/constraints/checkers/governance-presence.ts +10 -6
- package/src/core/constraints/checkers/types.ts +14 -8
- package/src/core/constraints/context-builder.ts +35 -26
- package/src/core/constraints/context-reconcile.ts +200 -0
- package/src/core/constraints/doc-freshness/__tests__/runner.test.ts +25 -0
- package/src/core/constraints/doc-freshness/runner.ts +18 -4
- package/src/core/constraints/git-evidence.ts +1 -1
- package/src/core/constraints/injection-drift.ts +19 -8
- package/src/core/constraints/run-env.ts +207 -0
- package/src/core/constraints/triggers.ts +33 -0
- package/src/core/effective-constraints.ts +17 -6
- package/src/core/effective-set.ts +8 -24
- package/src/core/index.ts +2 -1
- package/src/core/project-config-loader.ts +54 -102
- package/src/core/validators/__tests__/http-retry-sleep.test.ts +231 -0
- package/src/core/validators/check-handlers/http.ts +18 -7
- package/src/core/validators/index.ts +0 -1
- package/src/core/validators/passes-gate.ts +2 -3
- package/src/failure/CONTEXT.md +2 -1
- package/src/failure/classifier.ts +2 -2
- package/src/failure/index.ts +14 -2
- package/src/failure/recorder.ts +1 -1
- package/src/gates/CONTEXT.md +13 -7
- package/src/gates/__tests__/checker-gate.test.ts +1 -1
- package/src/gates/__tests__/command-single-predicate.test.ts +135 -0
- package/src/gates/__tests__/command.test.ts +8 -15
- package/src/gates/__tests__/contract.test.ts +5 -5
- package/src/gates/__tests__/gate-interface.test.ts +0 -17
- package/src/gates/__tests__/performance.test.ts +0 -13
- package/src/gates/__tests__/review.test.ts +0 -1
- package/src/gates/__tests__/runner.test.ts +1 -1
- package/src/gates/__tests__/security-default-scan.test.ts +97 -0
- package/src/gates/__tests__/security.test.ts +0 -13
- package/src/gates/checker-gate.ts +3 -2
- package/src/gates/command.ts +51 -74
- package/src/gates/contract.ts +0 -5
- package/src/gates/definitions.ts +6 -5
- package/src/gates/index.ts +0 -5
- package/src/gates/performance.ts +1 -6
- package/src/gates/runner.ts +1 -1
- package/src/gates/security.ts +9 -11
- package/src/gates/types.ts +20 -23
- package/src/hooks/CONTEXT.md +10 -9
- package/src/hooks/__tests__/bootstrap.test.ts +29 -6
- package/src/hooks/__tests__/pipeline.test.ts +28 -17
- package/src/hooks/__tests__/registry.test.ts +51 -3
- package/src/hooks/bootstrap.ts +35 -15
- package/src/hooks/config.ts +6 -2
- package/src/hooks/index.ts +10 -1
- package/src/hooks/pipeline.ts +4 -6
- package/src/hooks/registry.ts +31 -12
- package/src/hooks/types.ts +24 -7
- package/src/index.ts +1 -3
- package/src/knowledge/CONTEXT.md +14 -7
- package/src/knowledge/__tests__/audit-labels.test.ts +8 -5
- package/src/knowledge/__tests__/audit-scoring.test.ts +230 -0
- package/src/knowledge/__tests__/audit-write-count.test.ts +131 -0
- package/src/knowledge/__tests__/audit.test.ts +291 -208
- package/src/knowledge/__tests__/doctor.test.ts +3 -2
- package/src/knowledge/__tests__/ingest.test.ts +3 -2
- package/src/knowledge/__tests__/lifecycle.test.ts +57 -2
- package/src/knowledge/__tests__/migration.test.ts +35 -6
- package/src/knowledge/__tests__/query.test.ts +3 -2
- package/src/knowledge/__tests__/reference-tracker.test.ts +23 -2
- package/src/knowledge/__tests__/store.test.ts +149 -4
- package/src/knowledge/__tests__/tree-walker.test.ts +132 -0
- package/src/knowledge/audit-scoring.ts +589 -0
- package/src/knowledge/audit.ts +55 -599
- package/src/knowledge/import.ts +2 -0
- package/src/knowledge/index-generator.ts +4 -6
- package/src/knowledge/index.ts +27 -2
- package/src/knowledge/ingest.ts +1 -1
- package/src/knowledge/lifecycle.ts +5 -2
- package/src/knowledge/migration.ts +8 -2
- package/src/knowledge/query.ts +8 -1
- package/src/knowledge/reference-tracker.ts +5 -7
- package/src/knowledge/store.ts +75 -16
- package/src/knowledge/tree-walker.ts +29 -0
- package/src/knowledge/types.ts +19 -0
- package/src/monitoring/CONTEXT.md +5 -2
- package/src/monitoring/__tests__/context-tracker.test.ts +16 -8
- package/src/monitoring/__tests__/trace-file-anchoring.test.ts +80 -0
- package/src/monitoring/traces.ts +19 -5
- package/src/release/CONTEXT.md +1 -1
- package/src/release/__tests__/integrity.test.ts +21 -12
- package/src/test-setup/__tests__/jsonl-fake-fs.test.ts +98 -0
- package/src/test-setup/jsonl-fake-fs.ts +59 -0
- package/src/tools/index.ts +5 -1
- package/src/types/checkpoint.ts +6 -0
- package/src/types/passes-gate.ts +0 -17
- package/src/types/project-config.ts +21 -0
- package/src/types/trace.ts +14 -4
- package/src/utils/__tests__/file-walk.test.ts +3 -2
- package/src/utils/__tests__/jsonl-bounded-read.test.ts +106 -0
- package/src/utils/__tests__/jsonl-skip-disposition.test.ts +10 -6
- package/src/utils/__tests__/jsonl.test.ts +61 -14
- package/src/utils/__tests__/numeric-flag.test.ts +80 -0
- package/src/utils/__tests__/package-version.test.ts +2 -2
- package/src/utils/exec.ts +4 -64
- package/src/utils/jsonl.ts +159 -20
- package/src/utils/numeric-flag.ts +64 -0
- package/dist/failure/types.d.ts +0 -9
- package/dist/failure/types.d.ts.map +0 -1
- package/dist/failure/types.js +0 -25
- package/dist/failure/types.js.map +0 -1
- package/dist/gates/effective-gates.d.ts +0 -30
- package/dist/gates/effective-gates.d.ts.map +0 -1
- package/dist/gates/effective-gates.js +0 -81
- package/dist/gates/effective-gates.js.map +0 -1
- package/src/failure/types.ts +0 -9
- package/src/gates/__tests__/effective-gates.test.ts +0 -77
- package/src/gates/effective-gates.ts +0 -99
package/dist/knowledge/audit.js
CHANGED
|
@@ -2,573 +2,112 @@
|
|
|
2
2
|
/**
|
|
3
3
|
* 知识库质量审计引擎
|
|
4
4
|
*
|
|
5
|
-
* 纯代码检测,零 token
|
|
6
|
-
*
|
|
5
|
+
* 纯代码检测,零 token 成本。打分判定(D1–D7 规则表、维度分、健康分)是纯模块
|
|
6
|
+
* `audit-scoring.ts`,本文件只做存储侧装配:取条目、取环境数据、落地修复动作。
|
|
7
7
|
*
|
|
8
8
|
* 两种模式:
|
|
9
|
-
* - validate(entry): 单条入库检查(ingest gate
|
|
10
|
-
* - run(autoFix): 全量扫描(日兜底 /
|
|
9
|
+
* - validate(entry): 单条入库检查(ingest gate),不读盘
|
|
10
|
+
* - run(autoFix): 全量扫描(日兜底 / 手动),修复走 store.applyAll 单次索引重写
|
|
11
11
|
*/
|
|
12
|
-
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
|
|
13
|
-
if (k2 === undefined) k2 = k;
|
|
14
|
-
var desc = Object.getOwnPropertyDescriptor(m, k);
|
|
15
|
-
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
|
|
16
|
-
desc = { enumerable: true, get: function() { return m[k]; } };
|
|
17
|
-
}
|
|
18
|
-
Object.defineProperty(o, k2, desc);
|
|
19
|
-
}) : (function(o, m, k, k2) {
|
|
20
|
-
if (k2 === undefined) k2 = k;
|
|
21
|
-
o[k2] = m[k];
|
|
22
|
-
}));
|
|
23
|
-
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
|
|
24
|
-
Object.defineProperty(o, "default", { enumerable: true, value: v });
|
|
25
|
-
}) : function(o, v) {
|
|
26
|
-
o["default"] = v;
|
|
27
|
-
});
|
|
28
|
-
var __importStar = (this && this.__importStar) || (function () {
|
|
29
|
-
var ownKeys = function(o) {
|
|
30
|
-
ownKeys = Object.getOwnPropertyNames || function (o) {
|
|
31
|
-
var ar = [];
|
|
32
|
-
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
|
|
33
|
-
return ar;
|
|
34
|
-
};
|
|
35
|
-
return ownKeys(o);
|
|
36
|
-
};
|
|
37
|
-
return function (mod) {
|
|
38
|
-
if (mod && mod.__esModule) return mod;
|
|
39
|
-
var result = {};
|
|
40
|
-
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
|
|
41
|
-
__setModuleDefault(result, mod);
|
|
42
|
-
return result;
|
|
43
|
-
};
|
|
44
|
-
})();
|
|
45
12
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
46
|
-
exports.KnowledgeAudit =
|
|
47
|
-
const
|
|
48
|
-
|
|
49
|
-
const
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
const
|
|
53
|
-
const
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
const DAILY_AUDIT_PATTERN = /^\[Auditor\] Daily audit/;
|
|
59
|
-
const EVENT_NOISE_PATTERNS = [
|
|
60
|
-
/^\[Monitor\]\s/,
|
|
61
|
-
/^KnowledgeSync cycle:/,
|
|
62
|
-
/^\[Triage Fix\]\s/,
|
|
63
|
-
/^\[Session Feature\]\s/,
|
|
64
|
-
];
|
|
65
|
-
const REQUIRED_FRONTMATTER = ['id', 'type', 'title', 'maturity'];
|
|
66
|
-
const perEntryRules = [
|
|
67
|
-
// D1: 结构完整性
|
|
68
|
-
{
|
|
69
|
-
name: 'frontmatter-missing',
|
|
70
|
-
label: 'frontmatter 缺失',
|
|
71
|
-
severity: 'high',
|
|
72
|
-
action: 'reject',
|
|
73
|
-
scope: 'all',
|
|
74
|
-
detect: (entry) => {
|
|
75
|
-
const missing = REQUIRED_FRONTMATTER.filter(f => {
|
|
76
|
-
const val = entry[f];
|
|
77
|
-
return val === undefined || val === null || val === '';
|
|
78
|
-
});
|
|
79
|
-
if (missing.length > 0) {
|
|
80
|
-
return `缺少必填字段: ${missing.join(', ')}`;
|
|
81
|
-
}
|
|
82
|
-
return null;
|
|
83
|
-
},
|
|
84
|
-
},
|
|
85
|
-
// D2: 内容质量
|
|
86
|
-
{
|
|
87
|
-
name: 'test-data-pollution',
|
|
88
|
-
label: '测试数据污染',
|
|
89
|
-
severity: 'critical',
|
|
90
|
-
action: 'archive',
|
|
91
|
-
scope: 'active',
|
|
92
|
-
detect: (entry) => {
|
|
93
|
-
// Match test ID patterns
|
|
94
|
-
if (/^(test-|inj-test)/.test(entry.id)) {
|
|
95
|
-
return `测试 ID: "${entry.id}"`;
|
|
96
|
-
}
|
|
97
|
-
const hasTestTag = (entry.tags ?? []).some(t => TEST_TAG_PATTERNS.some(p => p.test(t)));
|
|
98
|
-
if (hasTestTag) {
|
|
99
|
-
return `测试标签: ${(entry.tags ?? []).filter(t => TEST_TAG_PATTERNS.some(p => p.test(t))).join(', ')}`;
|
|
100
|
-
}
|
|
101
|
-
if (/^(Test Entry|Test pattern|Test incident|Empty Test)$/i.test(entry.title.trim())) {
|
|
102
|
-
return `测试标题: "${entry.title}"`;
|
|
103
|
-
}
|
|
104
|
-
return null;
|
|
105
|
-
},
|
|
106
|
-
},
|
|
107
|
-
{
|
|
108
|
-
name: 'daily-audit-noise',
|
|
109
|
-
label: '每日审计噪音',
|
|
110
|
-
severity: 'high',
|
|
111
|
-
action: 'archive',
|
|
112
|
-
scope: 'active',
|
|
113
|
-
detect: (entry) => {
|
|
114
|
-
if (DAILY_AUDIT_PATTERN.test(entry.title)) {
|
|
115
|
-
return `每日审计摘要: "${entry.title}"`;
|
|
116
|
-
}
|
|
117
|
-
return null;
|
|
118
|
-
},
|
|
119
|
-
},
|
|
120
|
-
{
|
|
121
|
-
name: 'event-noise',
|
|
122
|
-
label: '运维事件噪音',
|
|
123
|
-
severity: 'critical',
|
|
124
|
-
action: 'archive',
|
|
125
|
-
scope: 'active',
|
|
126
|
-
detect: (entry) => {
|
|
127
|
-
for (const pattern of EVENT_NOISE_PATTERNS) {
|
|
128
|
-
if (pattern.test(entry.title)) {
|
|
129
|
-
return `运维事件标题: "${entry.title}"`;
|
|
130
|
-
}
|
|
131
|
-
}
|
|
132
|
-
return null;
|
|
133
|
-
},
|
|
134
|
-
},
|
|
135
|
-
{
|
|
136
|
-
name: 'zero-content-proven',
|
|
137
|
-
label: '零内容 proven',
|
|
138
|
-
severity: 'critical',
|
|
139
|
-
action: 'demote',
|
|
140
|
-
scope: 'all',
|
|
141
|
-
detect: (entry) => {
|
|
142
|
-
if (entry.maturity === 'proven' && entry.content.trim().length < ZERO_CONTENT_THRESHOLD) {
|
|
143
|
-
return `proven 条目内容仅 ${entry.content.trim().length} 字符`;
|
|
144
|
-
}
|
|
145
|
-
return null;
|
|
146
|
-
},
|
|
147
|
-
},
|
|
148
|
-
{
|
|
149
|
-
name: 'maturity-inflation',
|
|
150
|
-
label: '成熟度虚高',
|
|
151
|
-
severity: 'high',
|
|
152
|
-
action: 'demote',
|
|
153
|
-
scope: 'all',
|
|
154
|
-
detect: (entry) => {
|
|
155
|
-
if (entry.maturity === 'verified' && entry.content.trim().length < ZERO_CONTENT_THRESHOLD) {
|
|
156
|
-
return `verified 条目内容仅 ${entry.content.trim().length} 字符`;
|
|
157
|
-
}
|
|
158
|
-
return null;
|
|
159
|
-
},
|
|
160
|
-
},
|
|
161
|
-
{
|
|
162
|
-
name: 'short-content',
|
|
163
|
-
label: '短内容',
|
|
164
|
-
severity: 'medium',
|
|
165
|
-
action: 'flag',
|
|
166
|
-
scope: 'active',
|
|
167
|
-
detect: (entry, ctx) => {
|
|
168
|
-
const len = entry.content.trim().length;
|
|
169
|
-
if (len < ctx.shortContentThreshold && len >= ZERO_CONTENT_THRESHOLD) {
|
|
170
|
-
return `内容 ${len} 字符 (阈值 ${ctx.shortContentThreshold})`;
|
|
171
|
-
}
|
|
172
|
-
return null;
|
|
173
|
-
},
|
|
174
|
-
},
|
|
175
|
-
// D3: 去重有效性
|
|
176
|
-
{
|
|
177
|
-
name: 'title-duplicate',
|
|
178
|
-
label: '标题重复',
|
|
179
|
-
severity: 'medium',
|
|
180
|
-
action: 'flag',
|
|
181
|
-
scope: 'active',
|
|
182
|
-
detect: (entry, ctx) => {
|
|
183
|
-
if (!ctx.allEntries)
|
|
184
|
-
return null;
|
|
185
|
-
if (!entry.title)
|
|
186
|
-
return null;
|
|
187
|
-
const dupes = ctx.allEntries.filter(e => e.id !== entry.id &&
|
|
188
|
-
e.maturity !== 'archived' &&
|
|
189
|
-
e.type === entry.type &&
|
|
190
|
-
e.title?.toLowerCase().trim() === entry.title.toLowerCase().trim());
|
|
191
|
-
if (dupes.length > 0) {
|
|
192
|
-
return `与 ${dupes.map(e => e.id).join(', ')} 标题重复`;
|
|
193
|
-
}
|
|
194
|
-
return null;
|
|
195
|
-
},
|
|
196
|
-
},
|
|
197
|
-
{
|
|
198
|
-
name: 'source-refs-bloat',
|
|
199
|
-
label: 'sourceReferences 膨胀',
|
|
200
|
-
severity: 'low',
|
|
201
|
-
action: 'trim',
|
|
202
|
-
scope: 'all',
|
|
203
|
-
detect: (entry) => {
|
|
204
|
-
if ((entry.sourceReferences?.length || 0) > MAX_SOURCE_REFS) {
|
|
205
|
-
return `sourceReferences ${entry.sourceReferences.length} 条 (上限 ${MAX_SOURCE_REFS})`;
|
|
206
|
-
}
|
|
207
|
-
return null;
|
|
208
|
-
},
|
|
209
|
-
},
|
|
210
|
-
{
|
|
211
|
-
name: 'fragment-cluster',
|
|
212
|
-
label: '碎片集群',
|
|
213
|
-
severity: 'medium',
|
|
214
|
-
action: 'flag',
|
|
215
|
-
scope: 'active',
|
|
216
|
-
detect: (entry, ctx) => {
|
|
217
|
-
if (!ctx.allEntries || entry.content.trim().length >= 100)
|
|
218
|
-
return null;
|
|
219
|
-
if (!entry.tags?.length)
|
|
220
|
-
return null;
|
|
221
|
-
// Find peers: same type, short body, shared tags ≥2
|
|
222
|
-
const entryTags = new Set(entry.tags);
|
|
223
|
-
const peers = ctx.allEntries.filter(e => e.id !== entry.id &&
|
|
224
|
-
e.maturity !== 'archived' &&
|
|
225
|
-
e.type === entry.type &&
|
|
226
|
-
e.content.trim().length < 100 &&
|
|
227
|
-
e.tags?.filter(t => entryTags.has(t)).length >= 2);
|
|
228
|
-
if (peers.length >= 2) {
|
|
229
|
-
return `碎片集群:与 ${peers.map(e => e.id).join(', ')} 同 type+tags 且 body 均 <100 字符,建议合并`;
|
|
230
|
-
}
|
|
231
|
-
return null;
|
|
232
|
-
},
|
|
233
|
-
},
|
|
234
|
-
// D4: 成熟度健康
|
|
235
|
-
{
|
|
236
|
-
name: 'promotion-blocked',
|
|
237
|
-
label: 'promotion 受阻',
|
|
238
|
-
severity: 'medium',
|
|
239
|
-
action: 'flag',
|
|
240
|
-
scope: 'all',
|
|
241
|
-
detect: (entry, ctx) => {
|
|
242
|
-
if (entry.maturity !== 'draft')
|
|
243
|
-
return null;
|
|
244
|
-
const created = new Date(entry.created);
|
|
245
|
-
const daysSinceCreated = (Date.now() - created.getTime()) / (1000 * 60 * 60 * 24);
|
|
246
|
-
if (daysSinceCreated > ctx.promotionBlockDays && !entry.lastReferenced) {
|
|
247
|
-
return `draft 已 ${Math.floor(daysSinceCreated)} 天未被引用`;
|
|
248
|
-
}
|
|
249
|
-
return null;
|
|
250
|
-
},
|
|
251
|
-
},
|
|
252
|
-
{
|
|
253
|
-
name: 'orphan-draft',
|
|
254
|
-
label: '孤儿 draft',
|
|
255
|
-
severity: 'low',
|
|
256
|
-
action: 'flag',
|
|
257
|
-
scope: 'all',
|
|
258
|
-
detect: (entry) => {
|
|
259
|
-
if (entry.maturity !== 'draft')
|
|
260
|
-
return null;
|
|
261
|
-
if (entry.contributors.length === 0 && entry.projects.length === 0 && (0, flywheel_metrics_1.genuineRefs)(entry.referencedBy).length === 0) {
|
|
262
|
-
return `draft 无贡献者/项目/引用`;
|
|
263
|
-
}
|
|
264
|
-
return null;
|
|
265
|
-
},
|
|
266
|
-
},
|
|
267
|
-
// D5: 新鲜度
|
|
268
|
-
{
|
|
269
|
-
name: 'stale-entry',
|
|
270
|
-
label: '过期条目',
|
|
271
|
-
severity: 'medium',
|
|
272
|
-
action: 'flag',
|
|
273
|
-
scope: 'active',
|
|
274
|
-
detect: (entry, ctx) => {
|
|
275
|
-
const lastRef = entry.lastReferenced || entry.created;
|
|
276
|
-
if (!lastRef)
|
|
277
|
-
return null;
|
|
278
|
-
const daysSinceRef = (Date.now() - new Date(lastRef).getTime()) / (1000 * 60 * 60 * 24);
|
|
279
|
-
if (daysSinceRef > ctx.staleDays) {
|
|
280
|
-
return `超过 ${Math.floor(daysSinceRef)} 天未引用 (阈值 ${ctx.staleDays})`;
|
|
281
|
-
}
|
|
282
|
-
return null;
|
|
283
|
-
},
|
|
284
|
-
},
|
|
285
|
-
// D2b: 领域相关性 — 检测已废弃领域的残留条目
|
|
286
|
-
{
|
|
287
|
-
name: 'deprecated-domain',
|
|
288
|
-
label: '废弃领域残留',
|
|
289
|
-
severity: 'high',
|
|
290
|
-
action: 'archive',
|
|
291
|
-
scope: 'active',
|
|
292
|
-
detect: (entry) => {
|
|
293
|
-
const tags = (entry.tags ?? []).map(t => t.toLowerCase());
|
|
294
|
-
// Tag-level: "pipeline" tag is deprecated (Studio Pipeline superseded by Agent Network)
|
|
295
|
-
if (tags.includes('pipeline')) {
|
|
296
|
-
return `标签 "pipeline" 属于已废弃领域(已被 Agent Network 取代)`;
|
|
297
|
-
}
|
|
298
|
-
// Title-level: strong domain-specific terms
|
|
299
|
-
const title = entry.title || '';
|
|
300
|
-
if (/pipeline|管线|GoalExecution|DeployAgent|Integration step/i.test(title)) {
|
|
301
|
-
return `标题引用已废弃领域: "${title}"`;
|
|
302
|
-
}
|
|
303
|
-
return null;
|
|
304
|
-
},
|
|
305
|
-
},
|
|
306
|
-
];
|
|
307
|
-
/** 规则 label 正本表(#109,ADR-0002 定义即注册):派生自 perEntryRules,与规则键集编译期闭环,CLI 展示层直接消费 */
|
|
308
|
-
exports.AUDIT_RULE_LABELS = Object.fromEntries(perEntryRules.map(r => [r.name, r.label]));
|
|
309
|
-
// ── Audit Engine ──────────────────────────────────────────
|
|
310
|
-
/** 按 scope 决定是否评估:active 规则对 archived 条目不判定(人口过滤唯一落点) */
|
|
311
|
-
function ruleDetail(rule, entry, ctx) {
|
|
312
|
-
if (rule.scope === 'active' && entry.maturity === 'archived')
|
|
313
|
-
return null;
|
|
314
|
-
return rule.detect(entry, ctx);
|
|
13
|
+
exports.KnowledgeAudit = void 0;
|
|
14
|
+
const audit_scoring_1 = require("./audit-scoring");
|
|
15
|
+
/** 数值槽清单(harness#163):显式传入的脏值(NaN/±Infinity/负数)构造期抛 TypeError,不放行到打分层静默关判定 */
|
|
16
|
+
const NUMERIC_OPTION_SLOTS = ['shortContentThreshold', 'staleDays', 'promotionBlockDays'];
|
|
17
|
+
/** 守卫在 `resolveThresholds` 上游(构造期):`??` 语义不动,两处不重复兜;未传/显式 undefined 跳过,显式 0 合法 */
|
|
18
|
+
function assertValidThresholds(options) {
|
|
19
|
+
for (const slot of NUMERIC_OPTION_SLOTS) {
|
|
20
|
+
const value = options[slot];
|
|
21
|
+
if (value !== undefined && (!Number.isFinite(value) || value < 0)) {
|
|
22
|
+
throw new TypeError(`KnowledgeAudit: ${slot} 需为非负有限数,实参 ${value}`);
|
|
23
|
+
}
|
|
24
|
+
}
|
|
315
25
|
}
|
|
316
26
|
class KnowledgeAudit {
|
|
317
27
|
store;
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
this.store =
|
|
323
|
-
this.
|
|
324
|
-
this.staleDays = options?.staleDays ?? DEFAULT_STALE_DAYS;
|
|
325
|
-
this.promotionBlockDays = options?.promotionBlockDays ?? DEFAULT_PROMOTION_BLOCK_DAYS;
|
|
28
|
+
options;
|
|
29
|
+
constructor(store, options) {
|
|
30
|
+
if (options)
|
|
31
|
+
assertValidThresholds(options);
|
|
32
|
+
this.store = store;
|
|
33
|
+
this.options = options ?? {};
|
|
326
34
|
}
|
|
327
35
|
/**
|
|
328
36
|
* 单条入库检查(ingest gate 模式)
|
|
329
37
|
*/
|
|
330
38
|
validate(entry) {
|
|
331
|
-
|
|
332
|
-
shortContentThreshold: this.shortContentThreshold,
|
|
333
|
-
staleDays: this.staleDays,
|
|
334
|
-
promotionBlockDays: this.promotionBlockDays,
|
|
335
|
-
};
|
|
336
|
-
return this.scanEntries([entry], ctx);
|
|
39
|
+
return (0, audit_scoring_1.scanEntries)([entry], this.options);
|
|
337
40
|
}
|
|
338
41
|
/**
|
|
339
42
|
* 全量扫描(日兜底 / 手动模式)
|
|
340
43
|
*/
|
|
341
44
|
run(options) {
|
|
342
45
|
const entries = this.store.list({ excludeArchived: false }).filter(e => e.title && e.type && e.content != null);
|
|
343
|
-
const ctx = {
|
|
344
|
-
shortContentThreshold: this.shortContentThreshold,
|
|
345
|
-
staleDays: this.staleDays,
|
|
346
|
-
promotionBlockDays: this.promotionBlockDays,
|
|
347
|
-
allEntries: entries,
|
|
348
|
-
};
|
|
349
46
|
// Per-entry issues
|
|
350
|
-
const allIssues =
|
|
351
|
-
//
|
|
352
|
-
const
|
|
353
|
-
for (const rule of perEntryRules)
|
|
354
|
-
summary[rule.name] = 0;
|
|
355
|
-
for (const issue of allIssues)
|
|
356
|
-
summary[issue.rule]++;
|
|
357
|
-
// Dimension metrics
|
|
358
|
-
const dimensions = this.computeDimensions(entries, allIssues);
|
|
47
|
+
const allIssues = (0, audit_scoring_1.scanEntries)(entries, this.options, entries);
|
|
48
|
+
// Dimension metrics(环境数据由 store 供给,打分本体零 IO)
|
|
49
|
+
const dimensions = (0, audit_scoring_1.computeDimensions)(entries, allIssues, this.readEnv());
|
|
359
50
|
// Health score (before)
|
|
360
|
-
const healthBefore =
|
|
51
|
+
const healthBefore = (0, audit_scoring_1.calculateHealthScore)(entries, allIssues);
|
|
361
52
|
// Auto-fix
|
|
362
53
|
let autoFixed = 0;
|
|
363
54
|
if (options?.autoFix) {
|
|
364
55
|
autoFixed = this.applyFixes(allIssues);
|
|
365
56
|
}
|
|
366
|
-
// Health score (after)
|
|
57
|
+
// Health score (after)——重扫沿用修复前的人口作跨条目规则对照(现状口径,#134 不动判定)
|
|
367
58
|
const entriesAfter = options?.autoFix ? this.store.list({ excludeArchived: false }) : entries;
|
|
368
|
-
const issuesAfter = options?.autoFix ?
|
|
369
|
-
const healthAfter =
|
|
59
|
+
const issuesAfter = options?.autoFix ? (0, audit_scoring_1.scanEntries)(entriesAfter, this.options, entries) : allIssues;
|
|
60
|
+
const healthAfter = (0, audit_scoring_1.calculateHealthScore)(entriesAfter, issuesAfter);
|
|
370
61
|
return {
|
|
371
62
|
timestamp: new Date().toISOString(),
|
|
372
63
|
totalEntries: entries.length,
|
|
373
64
|
issues: allIssues,
|
|
374
|
-
summary,
|
|
65
|
+
summary: (0, audit_scoring_1.summarizeIssues)(allIssues),
|
|
375
66
|
dimensions,
|
|
376
67
|
autoFixed,
|
|
377
68
|
healthScore: { before: healthBefore, after: healthAfter },
|
|
378
69
|
};
|
|
379
70
|
}
|
|
380
|
-
// ──
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
const now = Date.now();
|
|
384
|
-
// D1: 结构完整性
|
|
385
|
-
const d1Issues = issues.filter(i => i.rule === 'frontmatter-missing');
|
|
386
|
-
const d1Score = entries.length === 0 ? 100 : Math.max(0, 100 - (d1Issues.length / entries.length) * 100);
|
|
387
|
-
// D2: 内容质量
|
|
388
|
-
const d2Rules = ['test-data-pollution', 'daily-audit-noise', 'event-noise', 'zero-content-proven', 'short-content', 'maturity-inflation', 'deprecated-domain'];
|
|
389
|
-
const d2Issues = issues.filter(i => d2Rules.includes(i.rule));
|
|
390
|
-
const d2Score = active.length === 0 ? 100 : Math.max(0, 100 - (d2Issues.length / active.length) * 100);
|
|
391
|
-
// D3: 去重有效性
|
|
392
|
-
const d3Rules = ['title-duplicate', 'source-refs-bloat', 'fragment-cluster'];
|
|
393
|
-
const d3Issues = issues.filter(i => d3Rules.includes(i.rule));
|
|
394
|
-
const d3Score = active.length === 0 ? 100 : Math.max(0, 100 - (d3Issues.length / active.length) * 100);
|
|
395
|
-
// D4: 成熟度健康
|
|
396
|
-
const d4Rules = ['promotion-blocked', 'orphan-draft'];
|
|
397
|
-
const d4Issues = issues.filter(i => d4Rules.includes(i.rule));
|
|
398
|
-
const byMaturity = {};
|
|
399
|
-
for (const e of entries)
|
|
400
|
-
byMaturity[e.maturity] = (byMaturity[e.maturity] || 0) + 1;
|
|
401
|
-
const draftRatio = entries.length > 0 ? (byMaturity['draft'] || 0) / entries.length : 0;
|
|
402
|
-
const provenRatio = entries.length > 0 ? (byMaturity['proven'] || 0) / entries.length : 0;
|
|
403
|
-
// Penalize: draft >50% or proven <2% or proven >20% (test inflation)
|
|
404
|
-
let d4Penalty = d4Issues.length * 2;
|
|
405
|
-
if (draftRatio > 0.5)
|
|
406
|
-
d4Penalty += 10;
|
|
407
|
-
if (provenRatio < 0.02 && entries.length > 20)
|
|
408
|
-
d4Penalty += 5;
|
|
409
|
-
if (provenRatio > 0.2)
|
|
410
|
-
d4Penalty += 5; // likely test inflation
|
|
411
|
-
const d4Score = entries.length === 0 ? 100 : Math.max(0, 100 - (d4Penalty / entries.length) * 100);
|
|
412
|
-
// D5: 新鲜度
|
|
413
|
-
const d5Issues = issues.filter(i => i.rule === 'stale-entry');
|
|
414
|
-
const ages = active.map(e => {
|
|
415
|
-
const lastRef = e.lastReferenced || e.created;
|
|
416
|
-
return lastRef ? (now - new Date(lastRef).getTime()) / (1000 * 60 * 60 * 24) : 999;
|
|
417
|
-
});
|
|
418
|
-
const avgAge = ages.length > 0 ? ages.reduce((a, b) => a + b, 0) / ages.length : 0;
|
|
419
|
-
const staleRatio = active.length > 0 ? d5Issues.length / active.length : 0;
|
|
420
|
-
const d5Score = active.length === 0 ? 100 : Math.max(0, 100 - (staleRatio * 100));
|
|
421
|
-
// D6: 飞轮验证 —— 指标计算唯一实现在 flywheel-metrics,此处只做 fs 读取与报告层映射
|
|
422
|
-
let dailyConsumptionEvents = 0;
|
|
423
|
-
try {
|
|
424
|
-
const statsPath = path.join(this.store.getBaseDir(), '.consumption-stats.json');
|
|
425
|
-
if (fs.existsSync(statsPath)) {
|
|
426
|
-
const stats = JSON.parse(fs.readFileSync(statsPath, 'utf-8'));
|
|
427
|
-
dailyConsumptionEvents = stats.dailyEvents || 0;
|
|
428
|
-
}
|
|
429
|
-
}
|
|
430
|
-
catch { /* best-effort */ }
|
|
431
|
-
const metrics = (0, flywheel_metrics_1.evaluateFlywheel)({ entries: active, dailyConsumptionEvents });
|
|
432
|
-
// Score: refCoverage * 50 + avgRefs * 20 + consumptionHitRate * 30
|
|
433
|
-
const d6Score = Math.min(100, Math.round(metrics.refCoverage * 50 +
|
|
434
|
-
Math.min(metrics.avgRefs / 5, 1) * 20 +
|
|
435
|
-
metrics.consumptionHitRate * 30));
|
|
436
|
-
return {
|
|
437
|
-
structure: {
|
|
438
|
-
score: Math.round(d1Score),
|
|
439
|
-
issues: d1Issues.length,
|
|
440
|
-
details: { invalidEntries: d1Issues.length },
|
|
441
|
-
},
|
|
442
|
-
content: {
|
|
443
|
-
score: Math.round(d2Score),
|
|
444
|
-
issues: d2Issues.length,
|
|
445
|
-
details: {
|
|
446
|
-
testData: issues.filter(i => i.rule === 'test-data-pollution').length,
|
|
447
|
-
dailyAudit: issues.filter(i => i.rule === 'daily-audit-noise').length,
|
|
448
|
-
zeroContent: issues.filter(i => i.rule === 'zero-content-proven').length,
|
|
449
|
-
shortContent: issues.filter(i => i.rule === 'short-content').length,
|
|
450
|
-
maturityInflation: issues.filter(i => i.rule === 'maturity-inflation').length,
|
|
451
|
-
},
|
|
452
|
-
},
|
|
453
|
-
dedup: {
|
|
454
|
-
score: Math.round(d3Score),
|
|
455
|
-
issues: d3Issues.length,
|
|
456
|
-
details: {
|
|
457
|
-
titleDuplicates: issues.filter(i => i.rule === 'title-duplicate').length,
|
|
458
|
-
sourceRefsBloat: issues.filter(i => i.rule === 'source-refs-bloat').length,
|
|
459
|
-
},
|
|
460
|
-
},
|
|
461
|
-
maturity: {
|
|
462
|
-
score: Math.round(d4Score),
|
|
463
|
-
issues: d4Issues.length,
|
|
464
|
-
details: {
|
|
465
|
-
draft: byMaturity['draft'] || 0,
|
|
466
|
-
verified: byMaturity['verified'] || 0,
|
|
467
|
-
proven: byMaturity['proven'] || 0,
|
|
468
|
-
archived: byMaturity['archived'] || 0,
|
|
469
|
-
draftRatio: Math.round(draftRatio * 100),
|
|
470
|
-
provenRatio: Math.round(provenRatio * 100),
|
|
471
|
-
promotionBlocked: issues.filter(i => i.rule === 'promotion-blocked').length,
|
|
472
|
-
},
|
|
473
|
-
},
|
|
474
|
-
freshness: {
|
|
475
|
-
score: Math.round(d5Score),
|
|
476
|
-
issues: d5Issues.length,
|
|
477
|
-
details: {
|
|
478
|
-
avgAgeDays: Math.round(avgAge),
|
|
479
|
-
staleEntries: d5Issues.length,
|
|
480
|
-
staleRatio: Math.round(staleRatio * 100),
|
|
481
|
-
},
|
|
482
|
-
},
|
|
483
|
-
flywheel: {
|
|
484
|
-
score: d6Score,
|
|
485
|
-
issues: 0,
|
|
486
|
-
details: {
|
|
487
|
-
activeEntries: metrics.activeEntries,
|
|
488
|
-
entriesWithRefs: metrics.entriesWithRefs,
|
|
489
|
-
refCoverage: Math.round(metrics.refCoverage * 100),
|
|
490
|
-
avgRefCount: Math.round(metrics.avgRefs * 10) / 10,
|
|
491
|
-
dailyConsumptionEvents: metrics.dailyConsumptionEvents,
|
|
492
|
-
consumptionHitRate: Math.round(metrics.consumptionHitRate * 100),
|
|
493
|
-
},
|
|
494
|
-
},
|
|
495
|
-
incremental: this.computeIncremental(),
|
|
496
|
-
};
|
|
497
|
-
}
|
|
498
|
-
computeIncremental() {
|
|
499
|
-
const survival = this.store.getSurvivalRate(30);
|
|
500
|
-
if (!survival) {
|
|
501
|
-
return { score: 100, issues: 0, details: { note: 'no 30d snapshot available' } };
|
|
502
|
-
}
|
|
503
|
-
// Score = survival rate directly (80% target → 80/100)
|
|
71
|
+
// ── Internal ────────────────────────────────────────────
|
|
72
|
+
/** 打分要用的环境数据在此一次取齐(D6 消费统计、D7 快照存活) */
|
|
73
|
+
readEnv() {
|
|
504
74
|
return {
|
|
505
|
-
|
|
506
|
-
|
|
507
|
-
details: {
|
|
508
|
-
survivalRate: survival.rate,
|
|
509
|
-
survived: survival.survived,
|
|
510
|
-
total: survival.total,
|
|
511
|
-
snapshotDate: survival.snapshotDate,
|
|
512
|
-
},
|
|
75
|
+
dailyConsumptionEvents: this.store.getConsumptionStats()?.dailyEvents ?? 0,
|
|
76
|
+
survival: this.store.getSurvivalRate(audit_scoring_1.SURVIVAL_SNAPSHOT_DAYS),
|
|
513
77
|
};
|
|
514
78
|
}
|
|
515
|
-
|
|
516
|
-
/**
|
|
517
|
-
* 逐条目跑 perEntryRules(#111 收口):validate(单条目)、run(全量)与 autoFix 重扫共用
|
|
518
|
-
*/
|
|
519
|
-
scanEntries(entries, ctx) {
|
|
520
|
-
const issues = [];
|
|
521
|
-
for (const entry of entries) {
|
|
522
|
-
for (const rule of perEntryRules) {
|
|
523
|
-
const detail = ruleDetail(rule, entry, ctx);
|
|
524
|
-
if (detail) {
|
|
525
|
-
issues.push({
|
|
526
|
-
rule: rule.name,
|
|
527
|
-
entryId: entry.id,
|
|
528
|
-
title: entry.title,
|
|
529
|
-
severity: rule.severity,
|
|
530
|
-
action: rule.action,
|
|
531
|
-
detail,
|
|
532
|
-
});
|
|
533
|
-
}
|
|
534
|
-
}
|
|
535
|
-
}
|
|
536
|
-
return issues;
|
|
537
|
-
}
|
|
79
|
+
/** 修复动作先聚合再经 `applyAll` 落盘:一次审计只重写一次 index.json(#134) */
|
|
538
80
|
applyFixes(issues) {
|
|
539
|
-
|
|
81
|
+
const updates = [];
|
|
540
82
|
const processed = new Set();
|
|
541
83
|
for (const issue of issues) {
|
|
542
84
|
if (processed.has(issue.entryId))
|
|
543
85
|
continue;
|
|
544
86
|
switch (issue.action) {
|
|
545
87
|
case 'archive':
|
|
546
|
-
|
|
88
|
+
updates.push({ id: issue.entryId, partial: { maturity: 'archived' } });
|
|
547
89
|
processed.add(issue.entryId);
|
|
548
|
-
fixed++;
|
|
549
90
|
break;
|
|
550
91
|
case 'demote':
|
|
551
|
-
|
|
92
|
+
updates.push({ id: issue.entryId, partial: { maturity: 'draft' } });
|
|
552
93
|
processed.add(issue.entryId);
|
|
553
|
-
fixed++;
|
|
554
94
|
break;
|
|
555
95
|
case 'flag': {
|
|
556
96
|
const entry = this.store.get(issue.entryId);
|
|
557
97
|
if (entry && !entry.tags.includes('low_quality')) {
|
|
558
|
-
|
|
98
|
+
updates.push({ id: issue.entryId, partial: { tags: [...entry.tags, 'low_quality'] } });
|
|
559
99
|
processed.add(issue.entryId);
|
|
560
|
-
fixed++;
|
|
561
100
|
}
|
|
562
101
|
break;
|
|
563
102
|
}
|
|
564
103
|
case 'trim': {
|
|
565
104
|
const entry = this.store.get(issue.entryId);
|
|
566
|
-
if (entry && entry.sourceReferences && entry.sourceReferences.length > MAX_SOURCE_REFS) {
|
|
567
|
-
|
|
568
|
-
|
|
105
|
+
if (entry && entry.sourceReferences && entry.sourceReferences.length > audit_scoring_1.MAX_SOURCE_REFS) {
|
|
106
|
+
updates.push({
|
|
107
|
+
id: issue.entryId,
|
|
108
|
+
partial: { sourceReferences: entry.sourceReferences.slice(-audit_scoring_1.MAX_SOURCE_REFS) },
|
|
569
109
|
});
|
|
570
110
|
processed.add(issue.entryId);
|
|
571
|
-
fixed++;
|
|
572
111
|
}
|
|
573
112
|
break;
|
|
574
113
|
}
|
|
@@ -576,22 +115,8 @@ class KnowledgeAudit {
|
|
|
576
115
|
break;
|
|
577
116
|
}
|
|
578
117
|
}
|
|
579
|
-
|
|
580
|
-
|
|
581
|
-
calculateHealthScore(entries, issues) {
|
|
582
|
-
if (entries.length === 0)
|
|
583
|
-
return 100;
|
|
584
|
-
const penalty = issues.reduce((sum, issue) => {
|
|
585
|
-
switch (issue.severity) {
|
|
586
|
-
case 'critical': return sum + 10;
|
|
587
|
-
case 'high': return sum + 5;
|
|
588
|
-
case 'medium': return sum + 2;
|
|
589
|
-
case 'low': return sum + 1;
|
|
590
|
-
default: return sum;
|
|
591
|
-
}
|
|
592
|
-
}, 0);
|
|
593
|
-
const maxPenalty = entries.length * 10;
|
|
594
|
-
return Math.max(0, 100 - Math.round((penalty / Math.max(maxPenalty, 1)) * 100));
|
|
118
|
+
this.store.applyAll(updates);
|
|
119
|
+
return updates.length;
|
|
595
120
|
}
|
|
596
121
|
}
|
|
597
122
|
exports.KnowledgeAudit = KnowledgeAudit;
|