@shrkcrft/inspector 0.1.0-alpha.30 → 0.1.0-alpha.31
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/dist/acceptance-replay.js +1 -1
- package/dist/agent-contract-templates.js +6 -6
- package/dist/agent-contract.d.ts.map +1 -1
- package/dist/agent-contract.js +13 -8
- package/dist/agent-orchestration.js +2 -2
- package/dist/agent-task-prep.d.ts +16 -0
- package/dist/agent-task-prep.d.ts.map +1 -1
- package/dist/agent-task-prep.js +51 -4
- package/dist/ai-readiness.d.ts.map +1 -1
- package/dist/ai-readiness.js +21 -3
- package/dist/architecture-map.d.ts +16 -0
- package/dist/architecture-map.d.ts.map +1 -1
- package/dist/architecture-map.js +42 -26
- package/dist/area-explore.d.ts +2 -2
- package/dist/area-explore.d.ts.map +1 -1
- package/dist/area-explore.js +36 -16
- package/dist/area-map.d.ts +56 -11
- package/dist/area-map.d.ts.map +1 -1
- package/dist/area-map.js +106 -25
- package/dist/asset-doctor-proposed-exit.d.ts +21 -0
- package/dist/asset-doctor-proposed-exit.d.ts.map +1 -0
- package/dist/asset-doctor-proposed-exit.js +22 -0
- package/dist/asset-provenance.js +1 -1
- package/dist/boundaries-changed-only.d.ts +24 -1
- package/dist/boundaries-changed-only.d.ts.map +1 -1
- package/dist/boundaries-changed-only.js +12 -2
- package/dist/boundary-check-options.model.d.ts +40 -0
- package/dist/boundary-check-options.model.d.ts.map +1 -0
- package/dist/boundary-check-options.model.js +1 -0
- package/dist/boundary-check-result.model.d.ts +89 -0
- package/dist/boundary-check-result.model.d.ts.map +1 -0
- package/dist/boundary-check-result.model.js +1 -0
- package/dist/boundary-configuration-status.d.ts +38 -0
- package/dist/boundary-configuration-status.d.ts.map +1 -0
- package/dist/boundary-configuration-status.js +118 -0
- package/dist/boundary-configuration-status.model.d.ts +37 -0
- package/dist/boundary-configuration-status.model.d.ts.map +1 -0
- package/dist/boundary-configuration-status.model.js +1 -0
- package/dist/boundary-load-issue.model.d.ts +30 -0
- package/dist/boundary-load-issue.model.d.ts.map +1 -0
- package/dist/boundary-load-issue.model.js +1 -0
- package/dist/boundary-rule-check.model.d.ts +44 -0
- package/dist/boundary-rule-check.model.d.ts.map +1 -0
- package/dist/boundary-rule-check.model.js +1 -0
- package/dist/boundary-rule-invalidation.model.d.ts +31 -0
- package/dist/boundary-rule-invalidation.model.d.ts.map +1 -0
- package/dist/boundary-rule-invalidation.model.js +1 -0
- package/dist/boundary-rule-set-diff.model.d.ts +75 -0
- package/dist/boundary-rule-set-diff.model.d.ts.map +1 -0
- package/dist/boundary-rule-set-diff.model.js +1 -0
- package/dist/boundary-rule-sources.d.ts +28 -0
- package/dist/boundary-rule-sources.d.ts.map +1 -0
- package/dist/boundary-rule-sources.js +110 -0
- package/dist/boundary-stale-exception-finding.model.d.ts +12 -0
- package/dist/boundary-stale-exception-finding.model.d.ts.map +1 -0
- package/dist/boundary-stale-exception-finding.model.js +1 -0
- package/dist/boundary-unit-liveness.d.ts +35 -0
- package/dist/boundary-unit-liveness.d.ts.map +1 -0
- package/dist/boundary-unit-liveness.js +71 -0
- package/dist/change-intent.d.ts +3 -0
- package/dist/change-intent.d.ts.map +1 -1
- package/dist/change-intent.js +61 -27
- package/dist/changes-summary.d.ts.map +1 -1
- package/dist/changes-summary.js +19 -9
- package/dist/ci-integrity-report.js +1 -1
- package/dist/ci-predict.d.ts.map +1 -1
- package/dist/ci-predict.js +38 -5
- package/dist/code-intelligence-doctor.d.ts +6 -0
- package/dist/code-intelligence-doctor.d.ts.map +1 -1
- package/dist/code-intelligence-doctor.js +22 -7
- package/dist/command-recommender.d.ts +45 -2
- package/dist/command-recommender.d.ts.map +1 -1
- package/dist/command-recommender.js +41 -263
- package/dist/command-resolution-status.d.ts +44 -0
- package/dist/command-resolution-status.d.ts.map +1 -0
- package/dist/command-resolution-status.js +44 -0
- package/dist/command-safety-level.d.ts +15 -0
- package/dist/command-safety-level.d.ts.map +1 -0
- package/dist/command-safety-level.js +43 -0
- package/dist/command-taxonomy.js +1 -1
- package/dist/compliance-evidence.js +1 -1
- package/dist/compliance-profiles.js +1 -1
- package/dist/construct-registry.d.ts +40 -0
- package/dist/construct-registry.d.ts.map +1 -1
- package/dist/construct-registry.js +186 -82
- package/dist/context-tuning.d.ts +4 -0
- package/dist/context-tuning.d.ts.map +1 -1
- package/dist/context-tuning.js +10 -7
- package/dist/contract-template-registry.d.ts +10 -0
- package/dist/contract-template-registry.d.ts.map +1 -1
- package/dist/contract-template-registry.js +59 -33
- package/dist/contribution-kind.d.ts +52 -0
- package/dist/contribution-kind.d.ts.map +1 -0
- package/dist/contribution-kind.js +52 -0
- package/dist/contribution-load-failures.d.ts +106 -0
- package/dist/contribution-load-failures.d.ts.map +1 -0
- package/dist/contribution-load-failures.js +575 -0
- package/dist/contributions-report.d.ts +28 -0
- package/dist/contributions-report.d.ts.map +1 -0
- package/dist/contributions-report.js +242 -0
- package/dist/convention-registry.d.ts +22 -0
- package/dist/convention-registry.d.ts.map +1 -1
- package/dist/convention-registry.js +79 -39
- package/dist/coverage-report.d.ts.map +1 -1
- package/dist/coverage-report.js +6 -6
- package/dist/custom-checks.d.ts +60 -1
- package/dist/custom-checks.d.ts.map +1 -1
- package/dist/custom-checks.js +159 -6
- package/dist/dashboard/dashboard-data.d.ts +6 -0
- package/dist/dashboard/dashboard-data.d.ts.map +1 -1
- package/dist/dashboard/dashboard-data.js +99 -8
- package/dist/dashboard/dashboard-knowledge.d.ts.map +1 -1
- package/dist/dashboard/dashboard-knowledge.js +14 -2
- package/dist/decision-records.d.ts +20 -0
- package/dist/decision-records.d.ts.map +1 -1
- package/dist/decision-records.js +68 -20
- package/dist/declared-cross-references.d.ts +61 -0
- package/dist/declared-cross-references.d.ts.map +1 -0
- package/dist/declared-cross-references.js +550 -0
- package/dist/declared-gate-plane-rules.d.ts +24 -0
- package/dist/declared-gate-plane-rules.d.ts.map +1 -0
- package/dist/declared-gate-plane-rules.js +39 -0
- package/dist/declared-reference-coverage.d.ts +27 -0
- package/dist/declared-reference-coverage.d.ts.map +1 -0
- package/dist/declared-reference-coverage.js +50 -0
- package/dist/declared-xref-status.d.ts +19 -0
- package/dist/declared-xref-status.d.ts.map +1 -0
- package/dist/declared-xref-status.js +19 -0
- package/dist/delegate-pack-recipes.d.ts +13 -2
- package/dist/delegate-pack-recipes.d.ts.map +1 -1
- package/dist/delegate-pack-recipes.js +45 -14
- package/dist/demo-package.js +2 -2
- package/dist/demo-script.js +2 -2
- package/dist/demo-workflow.js +3 -3
- package/dist/dev-cycle.js +1 -1
- package/dist/dev-session.js +1 -1
- package/dist/doc-references.d.ts +23 -2
- package/dist/doc-references.d.ts.map +1 -1
- package/dist/doc-references.js +96 -17
- package/dist/doctor-result.d.ts +8 -0
- package/dist/doctor-result.d.ts.map +1 -1
- package/dist/doctor-verdict-kind.d.ts +19 -0
- package/dist/doctor-verdict-kind.d.ts.map +1 -0
- package/dist/doctor-verdict-kind.js +19 -0
- package/dist/doctor-verdict.d.ts +18 -0
- package/dist/doctor-verdict.d.ts.map +1 -0
- package/dist/doctor-verdict.js +28 -0
- package/dist/drift.d.ts +17 -0
- package/dist/drift.d.ts.map +1 -1
- package/dist/drift.js +40 -10
- package/dist/entrypoint-matrix.d.ts.map +1 -1
- package/dist/entrypoint-matrix.js +4 -1
- package/dist/feedback-ingestion.d.ts +28 -2
- package/dist/feedback-ingestion.d.ts.map +1 -1
- package/dist/feedback-ingestion.js +68 -19
- package/dist/fix-preview.d.ts.map +1 -1
- package/dist/fix-preview.js +9 -5
- package/dist/framework-extractor-outcomes.d.ts +27 -0
- package/dist/framework-extractor-outcomes.d.ts.map +1 -0
- package/dist/framework-extractor-outcomes.js +83 -0
- package/dist/fuzzy-impact.js +1 -1
- package/dist/healing-plan.d.ts.map +1 -1
- package/dist/healing-plan.js +3 -4
- package/dist/helper-catalog.d.ts +25 -0
- package/dist/helper-catalog.d.ts.map +1 -0
- package/dist/helper-catalog.js +91 -0
- package/dist/helper-registry.d.ts.map +1 -1
- package/dist/helper-registry.js +17 -1
- package/dist/helper-view.d.ts +33 -0
- package/dist/helper-view.d.ts.map +1 -0
- package/dist/helper-view.js +1 -0
- package/dist/i-asset-doctor-flags.d.ts +16 -0
- package/dist/i-asset-doctor-flags.d.ts.map +1 -0
- package/dist/i-asset-doctor-flags.js +1 -0
- package/dist/i-command-resolution.d.ts +22 -0
- package/dist/i-command-resolution.d.ts.map +1 -0
- package/dist/i-command-resolution.js +1 -0
- package/dist/i-command-resolve-options.d.ts +24 -0
- package/dist/i-command-resolve-options.d.ts.map +1 -0
- package/dist/i-command-resolve-options.js +1 -0
- package/dist/i-command-safety.d.ts +13 -0
- package/dist/i-command-safety.d.ts.map +1 -0
- package/dist/i-command-safety.js +1 -0
- package/dist/i-contribution-accepted-entry.d.ts +18 -0
- package/dist/i-contribution-accepted-entry.d.ts.map +1 -0
- package/dist/i-contribution-accepted-entry.js +1 -0
- package/dist/i-contribution-entry-rejection.d.ts +21 -0
- package/dist/i-contribution-entry-rejection.d.ts.map +1 -0
- package/dist/i-contribution-entry-rejection.js +1 -0
- package/dist/i-contribution-file-issue.d.ts +18 -0
- package/dist/i-contribution-file-issue.d.ts.map +1 -0
- package/dist/i-contribution-file-issue.js +1 -0
- package/dist/i-contribution-file-report.d.ts +40 -0
- package/dist/i-contribution-file-report.d.ts.map +1 -0
- package/dist/i-contribution-file-report.js +1 -0
- package/dist/i-contribution-file-validation.d.ts +24 -0
- package/dist/i-contribution-file-validation.d.ts.map +1 -0
- package/dist/i-contribution-file-validation.js +1 -0
- package/dist/i-contributions-report.d.ts +31 -0
- package/dist/i-contributions-report.d.ts.map +1 -0
- package/dist/i-contributions-report.js +1 -0
- package/dist/i-declared-xref-field.d.ts +25 -0
- package/dist/i-declared-xref-field.d.ts.map +1 -0
- package/dist/i-declared-xref-field.js +1 -0
- package/dist/i-declared-xref-issue.d.ts +25 -0
- package/dist/i-declared-xref-issue.d.ts.map +1 -0
- package/dist/i-declared-xref-issue.js +1 -0
- package/dist/i-declared-xref-report.d.ts +48 -0
- package/dist/i-declared-xref-report.d.ts.map +1 -0
- package/dist/i-declared-xref-report.js +1 -0
- package/dist/i-declared-xref-row.d.ts +29 -0
- package/dist/i-declared-xref-row.d.ts.map +1 -0
- package/dist/i-declared-xref-row.js +1 -0
- package/dist/i-doctor-verdict.d.ts +10 -0
- package/dist/i-doctor-verdict.d.ts.map +1 -0
- package/dist/i-doctor-verdict.js +1 -0
- package/dist/i-kind-outcomes.d.ts +13 -0
- package/dist/i-kind-outcomes.d.ts.map +1 -0
- package/dist/i-kind-outcomes.js +1 -0
- package/dist/i-pack-doctor-verdict.d.ts +15 -0
- package/dist/i-pack-doctor-verdict.d.ts.map +1 -0
- package/dist/i-pack-doctor-verdict.js +1 -0
- package/dist/i-probed-id-field.d.ts +17 -0
- package/dist/i-probed-id-field.d.ts.map +1 -0
- package/dist/i-probed-id-field.js +1 -0
- package/dist/i-reference-kind-declaration.d.ts +38 -0
- package/dist/i-reference-kind-declaration.d.ts.map +1 -0
- package/dist/i-reference-kind-declaration.js +1 -0
- package/dist/i-reference-warm-options.d.ts +21 -0
- package/dist/i-reference-warm-options.d.ts.map +1 -0
- package/dist/i-reference-warm-options.js +1 -0
- package/dist/i-registry-outcomes.d.ts +16 -0
- package/dist/i-registry-outcomes.d.ts.map +1 -0
- package/dist/i-registry-outcomes.js +1 -0
- package/dist/i-scaffold-pattern-doctor-report.d.ts +35 -0
- package/dist/i-scaffold-pattern-doctor-report.d.ts.map +1 -0
- package/dist/i-scaffold-pattern-doctor-report.js +1 -0
- package/dist/i-search-tuning-key-probe.d.ts +30 -0
- package/dist/i-search-tuning-key-probe.d.ts.map +1 -0
- package/dist/i-search-tuning-key-probe.js +1 -0
- package/dist/i-search-tuning-lint-issue.d.ts +61 -0
- package/dist/i-search-tuning-lint-issue.d.ts.map +1 -0
- package/dist/i-search-tuning-lint-issue.js +1 -0
- package/dist/i-search-tuning-lint-report.d.ts +38 -0
- package/dist/i-search-tuning-lint-report.d.ts.map +1 -0
- package/dist/i-search-tuning-lint-report.js +1 -0
- package/dist/i-unresolvable-reference-scan.d.ts +14 -0
- package/dist/i-unresolvable-reference-scan.d.ts.map +1 -0
- package/dist/i-unresolvable-reference-scan.js +1 -0
- package/dist/i-unresolvable-reference.d.ts +29 -0
- package/dist/i-unresolvable-reference.d.ts.map +1 -0
- package/dist/i-unresolvable-reference.js +1 -0
- package/dist/i-workspace-profile-payload.d.ts +12 -0
- package/dist/i-workspace-profile-payload.d.ts.map +1 -0
- package/dist/i-workspace-profile-payload.js +1 -0
- package/dist/impact-analysis.d.ts +15 -0
- package/dist/impact-analysis.d.ts.map +1 -1
- package/dist/impact-analysis.js +58 -13
- package/dist/impact-render.d.ts.map +1 -1
- package/dist/impact-render.js +22 -0
- package/dist/import-hygiene.d.ts +35 -1
- package/dist/import-hygiene.d.ts.map +1 -1
- package/dist/import-hygiene.js +107 -13
- package/dist/index.d.ts +141 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +172 -0
- package/dist/inspection-discovery.d.ts +45 -0
- package/dist/inspection-discovery.d.ts.map +1 -0
- package/dist/inspection-discovery.js +70 -0
- package/dist/knowledge-advisory-code.d.ts +17 -0
- package/dist/knowledge-advisory-code.d.ts.map +1 -0
- package/dist/knowledge-advisory-code.js +17 -0
- package/dist/knowledge-aged-entry.d.ts +10 -0
- package/dist/knowledge-aged-entry.d.ts.map +1 -0
- package/dist/knowledge-aged-entry.js +1 -0
- package/dist/knowledge-authoring.d.ts +24 -1
- package/dist/knowledge-authoring.d.ts.map +1 -1
- package/dist/knowledge-authoring.js +46 -7
- package/dist/knowledge-entry-verdict-record.d.ts +22 -0
- package/dist/knowledge-entry-verdict-record.d.ts.map +1 -0
- package/dist/knowledge-entry-verdict-record.js +1 -0
- package/dist/knowledge-entry-verdict.d.ts +17 -0
- package/dist/knowledge-entry-verdict.d.ts.map +1 -0
- package/dist/knowledge-entry-verdict.js +17 -0
- package/dist/knowledge-graph.d.ts +6 -0
- package/dist/knowledge-graph.d.ts.map +1 -1
- package/dist/knowledge-graph.js +18 -7
- package/dist/knowledge-kind-bucket.d.ts +19 -0
- package/dist/knowledge-kind-bucket.d.ts.map +1 -0
- package/dist/knowledge-kind-bucket.js +1 -0
- package/dist/knowledge-load-failure.d.ts +23 -0
- package/dist/knowledge-load-failure.d.ts.map +1 -0
- package/dist/knowledge-load-failure.js +1 -0
- package/dist/knowledge-reference-kind-bucket.d.ts +11 -0
- package/dist/knowledge-reference-kind-bucket.d.ts.map +1 -0
- package/dist/knowledge-reference-kind-bucket.js +1 -0
- package/dist/knowledge-stale-advisory.d.ts +14 -0
- package/dist/knowledge-stale-advisory.d.ts.map +1 -0
- package/dist/knowledge-stale-advisory.js +1 -0
- package/dist/knowledge-stale-coverage.d.ts +19 -0
- package/dist/knowledge-stale-coverage.d.ts.map +1 -0
- package/dist/knowledge-stale-coverage.js +1 -0
- package/dist/knowledge-stale-gate-flags.d.ts +33 -0
- package/dist/knowledge-stale-gate-flags.d.ts.map +1 -0
- package/dist/knowledge-stale-gate-flags.js +1 -0
- package/dist/knowledge-stale-gate-input.d.ts +46 -0
- package/dist/knowledge-stale-gate-input.d.ts.map +1 -0
- package/dist/knowledge-stale-gate-input.js +1 -0
- package/dist/knowledge-stale-gate-result.d.ts +33 -0
- package/dist/knowledge-stale-gate-result.d.ts.map +1 -0
- package/dist/knowledge-stale-gate-result.js +1 -0
- package/dist/knowledge-stale-gate-rule.d.ts +33 -0
- package/dist/knowledge-stale-gate-rule.d.ts.map +1 -0
- package/dist/knowledge-stale-gate-rule.js +1 -0
- package/dist/knowledge-stale-gate-violation.d.ts +13 -0
- package/dist/knowledge-stale-gate-violation.d.ts.map +1 -0
- package/dist/knowledge-stale-gate-violation.js +1 -0
- package/dist/knowledge-stale-gate.d.ts +83 -0
- package/dist/knowledge-stale-gate.d.ts.map +1 -0
- package/dist/knowledge-stale-gate.js +429 -0
- package/dist/knowledge-stale-quality-gate.d.ts +26 -0
- package/dist/knowledge-stale-quality-gate.d.ts.map +1 -0
- package/dist/knowledge-stale-quality-gate.js +110 -0
- package/dist/knowledge-stale.d.ts +122 -9
- package/dist/knowledge-stale.d.ts.map +1 -1
- package/dist/knowledge-stale.js +996 -291
- package/dist/knowledge-unverifiable-reason.d.ts +12 -0
- package/dist/knowledge-unverifiable-reason.d.ts.map +1 -0
- package/dist/knowledge-unverifiable-reason.js +12 -0
- package/dist/loader-diagnostics.d.ts +14 -2
- package/dist/loader-diagnostics.d.ts.map +1 -1
- package/dist/match-terms.d.ts +48 -0
- package/dist/match-terms.d.ts.map +1 -0
- package/dist/match-terms.js +155 -0
- package/dist/migration-profile-registry.d.ts +10 -0
- package/dist/migration-profile-registry.d.ts.map +1 -1
- package/dist/migration-profile-registry.js +57 -34
- package/dist/migration-readiness.d.ts.map +1 -1
- package/dist/migration-readiness.js +1 -3
- package/dist/nearest-id.d.ts +10 -26
- package/dist/nearest-id.d.ts.map +1 -1
- package/dist/nearest-id.js +9 -59
- package/dist/pack-asset-freshness.d.ts +65 -0
- package/dist/pack-asset-freshness.d.ts.map +1 -0
- package/dist/pack-asset-freshness.js +340 -0
- package/dist/pack-author-ux.d.ts +24 -3
- package/dist/pack-author-ux.d.ts.map +1 -1
- package/dist/pack-author-ux.js +87 -93
- package/dist/pack-contributions-inventory.d.ts +79 -39
- package/dist/pack-contributions-inventory.d.ts.map +1 -1
- package/dist/pack-contributions-inventory.js +443 -286
- package/dist/pack-doctor-verdict.d.ts +29 -0
- package/dist/pack-doctor-verdict.d.ts.map +1 -0
- package/dist/pack-doctor-verdict.js +45 -0
- package/dist/pack-doctor.d.ts +74 -1
- package/dist/pack-doctor.d.ts.map +1 -1
- package/dist/pack-doctor.js +281 -1
- package/dist/pack-helper-plan.d.ts +24 -0
- package/dist/pack-helper-plan.d.ts.map +1 -0
- package/dist/pack-helper-plan.js +77 -0
- package/dist/pack-helper-registry.d.ts +14 -0
- package/dist/pack-helper-registry.d.ts.map +1 -1
- package/dist/pack-helper-registry.js +76 -37
- package/dist/pack-manifest-reader.d.ts +8 -0
- package/dist/pack-manifest-reader.d.ts.map +1 -0
- package/dist/pack-manifest-reader.js +79 -0
- package/dist/pack-release-check.d.ts +14 -1
- package/dist/pack-release-check.d.ts.map +1 -1
- package/dist/pack-release-check.js +23 -1
- package/dist/pack-signature-status.d.ts +18 -6
- package/dist/pack-signature-status.d.ts.map +1 -1
- package/dist/pack-signature-status.js +59 -105
- package/dist/pack-test-runner.d.ts +27 -5
- package/dist/pack-test-runner.d.ts.map +1 -1
- package/dist/pack-test-runner.js +91 -35
- package/dist/pack-typecheck.d.ts +8 -0
- package/dist/pack-typecheck.d.ts.map +1 -0
- package/dist/pack-typecheck.js +76 -0
- package/dist/plan-review.d.ts +2 -0
- package/dist/plan-review.d.ts.map +1 -1
- package/dist/plan-review.js +17 -5
- package/dist/plan-simulation.d.ts.map +1 -1
- package/dist/plan-simulation.js +16 -5
- package/dist/playbook-load-issue.d.ts +16 -0
- package/dist/playbook-load-issue.d.ts.map +1 -0
- package/dist/playbook-load-issue.js +1 -0
- package/dist/playbook-registry.d.ts +32 -1
- package/dist/playbook-registry.d.ts.map +1 -1
- package/dist/playbook-registry.js +144 -55
- package/dist/policy-declaration.d.ts +18 -0
- package/dist/policy-declaration.d.ts.map +1 -0
- package/dist/policy-declaration.js +1 -0
- package/dist/policy-engine.d.ts +8 -0
- package/dist/policy-engine.d.ts.map +1 -1
- package/dist/policy-engine.js +26 -9
- package/dist/policy-overrides.d.ts.map +1 -1
- package/dist/policy-overrides.js +4 -4
- package/dist/policy-registry.d.ts +27 -0
- package/dist/policy-registry.d.ts.map +1 -1
- package/dist/policy-registry.js +87 -20
- package/dist/probed-id-fields.d.ts +21 -0
- package/dist/probed-id-fields.d.ts.map +1 -0
- package/dist/probed-id-fields.js +25 -0
- package/dist/probed-id-source.d.ts +11 -0
- package/dist/probed-id-source.d.ts.map +1 -0
- package/dist/probed-id-source.js +11 -0
- package/dist/profile-registry.d.ts +25 -2
- package/dist/profile-registry.d.ts.map +1 -1
- package/dist/profile-registry.js +59 -6
- package/dist/quality-gate-examination.d.ts +15 -0
- package/dist/quality-gate-examination.d.ts.map +1 -0
- package/dist/quality-gate-examination.js +15 -0
- package/dist/quality-gate-row-status.d.ts +19 -0
- package/dist/quality-gate-row-status.d.ts.map +1 -0
- package/dist/quality-gate-row-status.js +28 -0
- package/dist/quality-gate-status.d.ts +16 -0
- package/dist/quality-gate-status.d.ts.map +1 -0
- package/dist/quality-gate-status.js +16 -0
- package/dist/quality-html.d.ts.map +1 -1
- package/dist/quality-html.js +14 -3
- package/dist/quality-report-coverage.d.ts +26 -0
- package/dist/quality-report-coverage.d.ts.map +1 -0
- package/dist/quality-report-coverage.js +48 -0
- package/dist/quality-report.d.ts +28 -1
- package/dist/quality-report.d.ts.map +1 -1
- package/dist/quality-report.js +263 -35
- package/dist/query-intent-kind.d.ts +18 -0
- package/dist/query-intent-kind.d.ts.map +1 -0
- package/dist/query-intent-kind.js +18 -0
- package/dist/query-intent-result.d.ts +23 -0
- package/dist/query-intent-result.d.ts.map +1 -0
- package/dist/query-intent-result.js +1 -0
- package/dist/query-intent.d.ts +18 -0
- package/dist/query-intent.d.ts.map +1 -0
- package/dist/query-intent.js +336 -0
- package/dist/query-resolver.d.ts +18 -0
- package/dist/query-resolver.d.ts.map +1 -1
- package/dist/query-resolver.js +7 -4
- package/dist/ranked-recommendations.d.ts +36 -0
- package/dist/ranked-recommendations.d.ts.map +1 -0
- package/dist/ranked-recommendations.js +1 -0
- package/dist/ranker-explainability.d.ts.map +1 -1
- package/dist/ranker-explainability.js +38 -10
- package/dist/recommend-recipe.d.ts +17 -0
- package/dist/recommend-recipe.d.ts.map +1 -0
- package/dist/recommend-recipe.js +1 -0
- package/dist/recommend-recipes.d.ts +9 -0
- package/dist/recommend-recipes.d.ts.map +1 -0
- package/dist/recommend-recipes.js +106 -0
- package/dist/recommendation-candidate.d.ts +30 -0
- package/dist/recommendation-candidate.d.ts.map +1 -0
- package/dist/recommendation-candidate.js +1 -0
- package/dist/recommendation-confidence.d.ts +27 -0
- package/dist/recommendation-confidence.d.ts.map +1 -0
- package/dist/recommendation-confidence.js +1 -0
- package/dist/recommendation-ranking-options.d.ts +24 -0
- package/dist/recommendation-ranking-options.d.ts.map +1 -0
- package/dist/recommendation-ranking-options.js +1 -0
- package/dist/recommendation-ranking.d.ts +50 -0
- package/dist/recommendation-ranking.d.ts.map +1 -0
- package/dist/recommendation-ranking.js +527 -0
- package/dist/recommendation-source.d.ts +23 -0
- package/dist/recommendation-source.d.ts.map +1 -0
- package/dist/recommendation-source.js +23 -0
- package/dist/recommendation-suppression.d.ts +14 -0
- package/dist/recommendation-suppression.d.ts.map +1 -0
- package/dist/recommendation-suppression.js +14 -0
- package/dist/reference-asset-kind.d.ts +14 -0
- package/dist/reference-asset-kind.d.ts.map +1 -0
- package/dist/reference-asset-kind.js +14 -0
- package/dist/reference-content-check.d.ts +32 -0
- package/dist/reference-content-check.d.ts.map +1 -0
- package/dist/reference-content-check.js +143 -0
- package/dist/reference-failure.d.ts +31 -0
- package/dist/reference-failure.d.ts.map +1 -0
- package/dist/reference-failure.js +31 -0
- package/dist/reference-id-status.d.ts +15 -0
- package/dist/reference-id-status.d.ts.map +1 -0
- package/dist/reference-id-status.js +15 -0
- package/dist/reference-kind-declarations.d.ts +42 -0
- package/dist/reference-kind-declarations.d.ts.map +1 -0
- package/dist/reference-kind-declarations.js +142 -0
- package/dist/reference-lookup.d.ts +6 -0
- package/dist/reference-lookup.d.ts.map +1 -1
- package/dist/reference-lookup.js +13 -5
- package/dist/reference-registry.d.ts +109 -11
- package/dist/reference-registry.d.ts.map +1 -1
- package/dist/reference-registry.js +186 -30
- package/dist/reference-subject.d.ts +20 -0
- package/dist/reference-subject.d.ts.map +1 -0
- package/dist/reference-subject.js +1 -0
- package/dist/registration-hint-discovery-status.d.ts +25 -0
- package/dist/registration-hint-discovery-status.d.ts.map +1 -0
- package/dist/registration-hint-discovery-status.js +25 -0
- package/dist/registration-hint-registry.d.ts +80 -0
- package/dist/registration-hint-registry.d.ts.map +1 -1
- package/dist/registration-hint-registry.js +356 -138
- package/dist/registry-lifecycle.d.ts +200 -19
- package/dist/registry-lifecycle.d.ts.map +1 -1
- package/dist/registry-lifecycle.js +526 -136
- package/dist/release-readiness.d.ts.map +1 -1
- package/dist/release-readiness.js +10 -7
- package/dist/release-smoke.d.ts.map +1 -1
- package/dist/release-smoke.js +11 -7
- package/dist/report-site.d.ts.map +1 -1
- package/dist/report-site.js +25 -7
- package/dist/repository-intelligence.d.ts.map +1 -1
- package/dist/repository-intelligence.js +3 -2
- package/dist/repository-knowledge-model.d.ts.map +1 -1
- package/dist/repository-knowledge-model.js +18 -5
- package/dist/resolve-project-config.d.ts +64 -0
- package/dist/resolve-project-config.d.ts.map +1 -1
- package/dist/resolve-project-config.js +240 -32
- package/dist/reuse/compute-reuse-coverage.d.ts +29 -0
- package/dist/reuse/compute-reuse-coverage.d.ts.map +1 -0
- package/dist/reuse/compute-reuse-coverage.js +198 -0
- package/dist/reuse/rank-reuse-candidates.d.ts +38 -0
- package/dist/reuse/rank-reuse-candidates.d.ts.map +1 -0
- package/dist/reuse/rank-reuse-candidates.js +212 -0
- package/dist/reuse/rank-reuse-options.d.ts +20 -0
- package/dist/reuse/rank-reuse-options.d.ts.map +1 -0
- package/dist/reuse/rank-reuse-options.js +1 -0
- package/dist/reuse/rank-reuse-suggestions.d.ts +15 -0
- package/dist/reuse/rank-reuse-suggestions.d.ts.map +1 -0
- package/dist/reuse/rank-reuse-suggestions.js +31 -0
- package/dist/reuse/resolve-curated-reuse.d.ts +43 -0
- package/dist/reuse/resolve-curated-reuse.d.ts.map +1 -0
- package/dist/reuse/resolve-curated-reuse.js +115 -0
- package/dist/reuse/reuse-candidate.d.ts +29 -0
- package/dist/reuse/reuse-candidate.d.ts.map +1 -0
- package/dist/reuse/reuse-candidate.js +1 -0
- package/dist/reuse/reuse-coverage-report.d.ts +74 -0
- package/dist/reuse/reuse-coverage-report.d.ts.map +1 -0
- package/dist/reuse/reuse-coverage-report.js +1 -0
- package/dist/reuse/reuse-curated-coverage.d.ts +36 -0
- package/dist/reuse/reuse-curated-coverage.d.ts.map +1 -0
- package/dist/reuse/reuse-curated-coverage.js +1 -0
- package/dist/reuse/reuse-curated-resolution.d.ts +36 -0
- package/dist/reuse/reuse-curated-resolution.d.ts.map +1 -0
- package/dist/reuse/reuse-curated-resolution.js +1 -0
- package/dist/reuse/reuse-curated-status.d.ts +21 -0
- package/dist/reuse/reuse-curated-status.d.ts.map +1 -0
- package/dist/reuse/reuse-curated-status.js +21 -0
- package/dist/reuse/reuse-match-detail.d.ts +15 -0
- package/dist/reuse/reuse-match-detail.d.ts.map +1 -0
- package/dist/reuse/reuse-match-detail.js +1 -0
- package/dist/reuse/reuse-ranking.d.ts +37 -0
- package/dist/reuse/reuse-ranking.d.ts.map +1 -0
- package/dist/reuse/reuse-ranking.js +1 -0
- package/dist/reuse/reuse-suggestion.d.ts +19 -0
- package/dist/reuse/reuse-suggestion.d.ts.map +1 -0
- package/dist/reuse/reuse-suggestion.js +1 -0
- package/dist/reuse/reuse-symbol-lookup.d.ts +28 -0
- package/dist/reuse/reuse-symbol-lookup.d.ts.map +1 -0
- package/dist/reuse/reuse-symbol-lookup.js +1 -0
- package/dist/reuse/reuse-tokenize.d.ts +11 -0
- package/dist/reuse/reuse-tokenize.d.ts.map +1 -0
- package/dist/reuse/reuse-tokenize.js +26 -0
- package/dist/reuse/score-reuse-name.d.ts +16 -0
- package/dist/reuse/score-reuse-name.d.ts.map +1 -0
- package/dist/reuse/score-reuse-name.js +35 -0
- package/dist/reuse/score-reuse-primitive.d.ts +33 -0
- package/dist/reuse/score-reuse-primitive.d.ts.map +1 -0
- package/dist/reuse/score-reuse-primitive.js +92 -0
- package/dist/review-packet.d.ts +2 -0
- package/dist/review-packet.d.ts.map +1 -1
- package/dist/review-packet.js +13 -6
- package/dist/role-views.d.ts.map +1 -1
- package/dist/role-views.js +16 -16
- package/dist/routing-recommends-channels.d.ts +24 -0
- package/dist/routing-recommends-channels.d.ts.map +1 -0
- package/dist/routing-recommends-channels.js +19 -0
- package/dist/run-boundary-check.d.ts +118 -0
- package/dist/run-boundary-check.d.ts.map +1 -0
- package/dist/run-boundary-check.js +592 -0
- package/dist/safety-audit.js +1 -1
- package/dist/scaffold-coverage.js +1 -1
- package/dist/scaffold-pattern-doctor-report.d.ts +19 -0
- package/dist/scaffold-pattern-doctor-report.d.ts.map +1 -0
- package/dist/scaffold-pattern-doctor-report.js +54 -0
- package/dist/scaffold-patterns.d.ts +75 -1
- package/dist/scaffold-patterns.d.ts.map +1 -1
- package/dist/scaffold-patterns.js +375 -84
- package/dist/schema-inventory.d.ts.map +1 -1
- package/dist/schema-inventory.js +4 -3
- package/dist/search-document-id.d.ts +52 -0
- package/dist/search-document-id.d.ts.map +1 -0
- package/dist/search-document-id.js +72 -0
- package/dist/search-document-prefix.d.ts +7 -0
- package/dist/search-document-prefix.d.ts.map +1 -0
- package/dist/search-document-prefix.js +1 -0
- package/dist/search-index.d.ts.map +1 -1
- package/dist/search-index.js +20 -23
- package/dist/search-tuning-explain.d.ts +6 -0
- package/dist/search-tuning-explain.d.ts.map +1 -1
- package/dist/search-tuning-explain.js +19 -17
- package/dist/search-tuning-key-probes.d.ts +16 -0
- package/dist/search-tuning-key-probes.d.ts.map +1 -0
- package/dist/search-tuning-key-probes.js +65 -0
- package/dist/search-tuning-key-resolution.d.ts +25 -0
- package/dist/search-tuning-key-resolution.d.ts.map +1 -0
- package/dist/search-tuning-key-resolution.js +1 -0
- package/dist/search-tuning-key-resolver.d.ts +4 -0
- package/dist/search-tuning-key-resolver.d.ts.map +1 -0
- package/dist/search-tuning-key-resolver.js +107 -0
- package/dist/search-tuning-key-status.d.ts +24 -0
- package/dist/search-tuning-key-status.d.ts.map +1 -0
- package/dist/search-tuning-key-status.js +24 -0
- package/dist/search-tuning-lint.d.ts +9 -0
- package/dist/search-tuning-lint.d.ts.map +1 -0
- package/dist/search-tuning-lint.js +468 -0
- package/dist/search-tuning-registry.d.ts +43 -0
- package/dist/search-tuning-registry.d.ts.map +1 -1
- package/dist/search-tuning-registry.js +214 -49
- package/dist/self-audit.d.ts +12 -0
- package/dist/self-audit.d.ts.map +1 -1
- package/dist/self-audit.js +36 -10
- package/dist/self-config-doctor-v2.d.ts +145 -3
- package/dist/self-config-doctor-v2.d.ts.map +1 -1
- package/dist/self-config-doctor-v2.js +1304 -181
- package/dist/self-config-doctor.d.ts +20 -1
- package/dist/self-config-doctor.d.ts.map +1 -1
- package/dist/self-config-doctor.js +53 -280
- package/dist/settled-unit-states.d.ts +9 -0
- package/dist/settled-unit-states.d.ts.map +1 -0
- package/dist/settled-unit-states.js +14 -0
- package/dist/sharkcraft-inspector.d.ts +34 -0
- package/dist/sharkcraft-inspector.d.ts.map +1 -1
- package/dist/sharkcraft-inspector.js +273 -26
- package/dist/spec/spec-evidence.d.ts.map +1 -1
- package/dist/spec/spec-evidence.js +14 -20
- package/dist/split-identifier.d.ts +21 -0
- package/dist/split-identifier.d.ts.map +1 -0
- package/dist/split-identifier.js +27 -0
- package/dist/start-here.d.ts.map +1 -1
- package/dist/start-here.js +1 -2
- package/dist/substitute-placeholders.d.ts +8 -0
- package/dist/substitute-placeholders.d.ts.map +1 -0
- package/dist/substitute-placeholders.js +9 -0
- package/dist/symbol-index.d.ts +33 -0
- package/dist/symbol-index.d.ts.map +1 -1
- package/dist/symbol-index.js +241 -3
- package/dist/symbol-member-entry.d.ts +26 -0
- package/dist/symbol-member-entry.d.ts.map +1 -0
- package/dist/symbol-member-entry.js +1 -0
- package/dist/symbol-member-kind.d.ts +14 -0
- package/dist/symbol-member-kind.d.ts.map +1 -0
- package/dist/symbol-member-kind.js +14 -0
- package/dist/task-packet.d.ts.map +1 -1
- package/dist/task-packet.js +52 -9
- package/dist/task-ranker.d.ts +8 -0
- package/dist/task-ranker.d.ts.map +1 -1
- package/dist/task-ranker.js +25 -13
- package/dist/task-risk.js +1 -1
- package/dist/task-routing-hint-registry.d.ts +20 -1
- package/dist/task-routing-hint-registry.d.ts.map +1 -1
- package/dist/task-routing-hint-registry.js +186 -42
- package/dist/template-drift.d.ts.map +1 -1
- package/dist/template-drift.js +30 -9
- package/dist/template-lint.d.ts.map +1 -1
- package/dist/template-lint.js +160 -2
- package/dist/term-query.d.ts +10 -0
- package/dist/term-query.d.ts.map +1 -0
- package/dist/term-query.js +1 -0
- package/dist/test-definitions.d.ts +6 -3
- package/dist/test-definitions.d.ts.map +1 -1
- package/dist/test-runner.d.ts +95 -10
- package/dist/test-runner.d.ts.map +1 -1
- package/dist/test-runner.js +309 -308
- package/dist/tuning-query-tokens.d.ts +29 -0
- package/dist/tuning-query-tokens.d.ts.map +1 -0
- package/dist/tuning-query-tokens.js +51 -0
- package/dist/typecheck-files.d.ts +36 -0
- package/dist/typecheck-files.d.ts.map +1 -0
- package/dist/typecheck-files.js +158 -0
- package/dist/uncertainty.js +1 -1
- package/dist/universal-search.d.ts.map +1 -1
- package/dist/universal-search.js +5 -3
- package/dist/unregistered-exports.d.ts +19 -0
- package/dist/unregistered-exports.d.ts.map +1 -0
- package/dist/unregistered-exports.js +141 -0
- package/dist/unresolvable-reason.d.ts +11 -0
- package/dist/unresolvable-reason.d.ts.map +1 -0
- package/dist/unresolvable-reason.js +11 -0
- package/dist/upgrade-advisor.d.ts.map +1 -1
- package/dist/upgrade-advisor.js +16 -9
- package/dist/validate-contribution-file.d.ts +4 -0
- package/dist/validate-contribution-file.d.ts.map +1 -0
- package/dist/validate-contribution-file.js +228 -0
- package/dist/why-file.d.ts +3 -0
- package/dist/why-file.d.ts.map +1 -1
- package/dist/why-file.js +7 -3
- package/package.json +17 -17
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One entry's verdict in the staleness sweep — three buckets, never one.
|
|
3
|
+
*
|
|
4
|
+
* The sweep used to report only reference-level counts, so an entry that
|
|
5
|
+
* declared NO references contributed nothing and was folded into the healthy
|
|
6
|
+
* total: the less verifiable a corpus was, the healthier it looked. An entry
|
|
7
|
+
* the check could not examine is its own bucket, reported with its id.
|
|
8
|
+
*/
|
|
9
|
+
export declare enum KnowledgeEntryVerdict {
|
|
10
|
+
/** At least one reference / anchor was checked, and every checked one resolved. */
|
|
11
|
+
Verified = "verified",
|
|
12
|
+
/** At least one checked reference / anchor did not resolve. */
|
|
13
|
+
Stale = "stale",
|
|
14
|
+
/** Nothing about this entry could be checked — see its reason. */
|
|
15
|
+
Unverifiable = "unverifiable"
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=knowledge-entry-verdict.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-entry-verdict.d.ts","sourceRoot":"","sources":["../src/knowledge-entry-verdict.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,oBAAY,qBAAqB;IAC/B,mFAAmF;IACnF,QAAQ,aAAa;IACrB,+DAA+D;IAC/D,KAAK,UAAU;IACf,kEAAkE;IAClE,YAAY,iBAAiB;CAC9B"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One entry's verdict in the staleness sweep — three buckets, never one.
|
|
3
|
+
*
|
|
4
|
+
* The sweep used to report only reference-level counts, so an entry that
|
|
5
|
+
* declared NO references contributed nothing and was folded into the healthy
|
|
6
|
+
* total: the less verifiable a corpus was, the healthier it looked. An entry
|
|
7
|
+
* the check could not examine is its own bucket, reported with its id.
|
|
8
|
+
*/
|
|
9
|
+
export var KnowledgeEntryVerdict;
|
|
10
|
+
(function (KnowledgeEntryVerdict) {
|
|
11
|
+
/** At least one reference / anchor was checked, and every checked one resolved. */
|
|
12
|
+
KnowledgeEntryVerdict["Verified"] = "verified";
|
|
13
|
+
/** At least one checked reference / anchor did not resolve. */
|
|
14
|
+
KnowledgeEntryVerdict["Stale"] = "stale";
|
|
15
|
+
/** Nothing about this entry could be checked — see its reason. */
|
|
16
|
+
KnowledgeEntryVerdict["Unverifiable"] = "unverifiable";
|
|
17
|
+
})(KnowledgeEntryVerdict || (KnowledgeEntryVerdict = {}));
|
|
@@ -22,6 +22,12 @@ export interface IKnowledgeGraph {
|
|
|
22
22
|
edges: IGraphEdge[];
|
|
23
23
|
/** Convenience: lookup by composite id (kind:id). */
|
|
24
24
|
byId: ReadonlyMap<string, IGraphNode>;
|
|
25
|
+
/**
|
|
26
|
+
* Declared edges NOT drawn because an endpoint is not a node of this graph
|
|
27
|
+
* (a dangling id, or a kind the graph does not model). A shrunken graph says
|
|
28
|
+
* it shrank — `shrk self-config xrefs --dangling-only` lists the ids.
|
|
29
|
+
*/
|
|
30
|
+
droppedEdges?: number;
|
|
25
31
|
}
|
|
26
32
|
/**
|
|
27
33
|
* Build the full SharkCraft knowledge graph for the current inspection.
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../src/knowledge-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,GACR,MAAM,GACN,UAAU,GACV,KAAK,CAAC;AAEV,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,0BAA0B,GAC1B,kBAAkB,GAClB,uBAAuB,GACvB,uBAAuB,GACvB,UAAU,CAAC;AAEf,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,qDAAqD;IACrD,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../src/knowledge-graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,GACR,MAAM,GACN,UAAU,GACV,KAAK,CAAC;AAEV,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GACzB,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,mBAAmB,GACnB,0BAA0B,GAC1B,kBAAkB,GAClB,uBAAuB,GACvB,uBAAuB,GACvB,UAAU,CAAC;AAEf,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,qDAAqD;IACrD,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,qBAAqB,GAAG,eAAe,CA0RtF;AAED,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,GAAG,CAAC,EAAE;QAAE,QAAQ,EAAE,iBAAiB,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAC7C,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC1C,UAAU,CA+DZ;AAgDD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,GAAG,EAAE;IAAE,IAAI,CAAC,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACxC;IACD,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB,GAAG,IAAI,CA+BP"}
|
package/dist/knowledge-graph.js
CHANGED
|
@@ -9,6 +9,7 @@ export function buildKnowledgeGraph(inspection) {
|
|
|
9
9
|
const nodes = [];
|
|
10
10
|
const edges = [];
|
|
11
11
|
const byId = new Map();
|
|
12
|
+
let droppedEdges = 0;
|
|
12
13
|
function addNode(n) {
|
|
13
14
|
const key = nodeKey(n.kind, n.id);
|
|
14
15
|
if (byId.has(key))
|
|
@@ -19,10 +20,12 @@ export function buildKnowledgeGraph(inspection) {
|
|
|
19
20
|
function addEdge(from, to, relation, why) {
|
|
20
21
|
const fromKey = nodeKey(from.kind, from.id);
|
|
21
22
|
const toKey = nodeKey(to.kind, to.id);
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
if (!byId.has(fromKey))
|
|
23
|
+
// An edge to a node we didn't see is not drawn — but it is COUNTED, so the
|
|
24
|
+
// graph never reads as complete while it silently lost edges.
|
|
25
|
+
if (!byId.has(toKey) || !byId.has(fromKey)) {
|
|
26
|
+
droppedEdges += 1;
|
|
25
27
|
return;
|
|
28
|
+
}
|
|
26
29
|
edges.push({ from: fromKey, to: toKey, relation, why });
|
|
27
30
|
}
|
|
28
31
|
function sourceOf(map, id) {
|
|
@@ -142,8 +145,10 @@ export function buildKnowledgeGraph(inspection) {
|
|
|
142
145
|
: byId.has(kKey)
|
|
143
146
|
? 'knowledge'
|
|
144
147
|
: null;
|
|
145
|
-
if (!targetKind)
|
|
148
|
+
if (!targetKind) {
|
|
149
|
+
droppedEdges += 1;
|
|
146
150
|
continue;
|
|
151
|
+
}
|
|
147
152
|
addEdge({ kind: 'pipeline', id: pipeline.id }, { kind: targetKind, id: ref }, 'pipeline-step-references', `step ${step.id} references`);
|
|
148
153
|
}
|
|
149
154
|
}
|
|
@@ -157,11 +162,17 @@ export function buildKnowledgeGraph(inspection) {
|
|
|
157
162
|
addEdge({ kind: 'boundary', id: r.id }, { kind: 'path', id }, 'boundary-related-path', 'relatedPathConventions');
|
|
158
163
|
}
|
|
159
164
|
}
|
|
160
|
-
// Pack contributions: pack → its contributed items.
|
|
165
|
+
// Pack contributions: pack → its contributed items. A contributed rule or
|
|
166
|
+
// path convention is a `rule:` / `path:` node, not a `knowledge:` one — the
|
|
167
|
+
// edge used to target `knowledge:<id>` and was silently dropped for both.
|
|
168
|
+
const entryKinds = new Map();
|
|
169
|
+
for (const e of inspection.knowledgeEntries) {
|
|
170
|
+
entryKinds.set(e.id, String(e.type) === 'rule' ? 'rule' : String(e.type) === 'path' ? 'path' : 'knowledge');
|
|
171
|
+
}
|
|
161
172
|
for (const [id, src] of inspection.entrySources) {
|
|
162
173
|
if (src.type !== 'pack' || !src.packageName)
|
|
163
174
|
continue;
|
|
164
|
-
addEdge({ kind: 'pack', id: src.packageName }, { kind: 'knowledge', id }, 'pack-contributes', 'knowledge entry');
|
|
175
|
+
addEdge({ kind: 'pack', id: src.packageName }, { kind: entryKinds.get(id) ?? 'knowledge', id }, 'pack-contributes', 'knowledge entry');
|
|
165
176
|
}
|
|
166
177
|
for (const [id, src] of inspection.templateSources) {
|
|
167
178
|
if (src.type !== 'pack' || !src.packageName)
|
|
@@ -183,7 +194,7 @@ export function buildKnowledgeGraph(inspection) {
|
|
|
183
194
|
continue;
|
|
184
195
|
addEdge({ kind: 'pack', id: src.packageName }, { kind: 'boundary', id }, 'pack-contributes', 'boundary rule');
|
|
185
196
|
}
|
|
186
|
-
return { nodes, edges, byId };
|
|
197
|
+
return { nodes, edges, byId, droppedEdges };
|
|
187
198
|
}
|
|
188
199
|
/**
|
|
189
200
|
* Find the shortest directed path (BFS) between two graph nodes. Edges are
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Per-kind counts of a staleness sweep — by asset kind (knowledge / boundary
|
|
3
|
+
* rule / policy) and by knowledge entry `type`.
|
|
4
|
+
*
|
|
5
|
+
* `scanned: 0` means the kind was NOT IN THE SWEEP, which a renderer must say
|
|
6
|
+
* in words — a row of zeros cannot tell "clean" from "never looked".
|
|
7
|
+
*/
|
|
8
|
+
export interface IKnowledgeKindBucket {
|
|
9
|
+
/** Subjects of this kind the sweep visited. */
|
|
10
|
+
scanned: number;
|
|
11
|
+
/** Of those, how many declare no references / anchors at all. */
|
|
12
|
+
zeroReferences: number;
|
|
13
|
+
/** References + anchors checked for this kind. */
|
|
14
|
+
referencesChecked: number;
|
|
15
|
+
verified: number;
|
|
16
|
+
stale: number;
|
|
17
|
+
unverifiable: number;
|
|
18
|
+
}
|
|
19
|
+
//# sourceMappingURL=knowledge-kind-bucket.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-kind-bucket.d.ts","sourceRoot":"","sources":["../src/knowledge-kind-bucket.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One knowledge-bearing file (`knowledgeFiles` / `ruleFiles` / `pathFiles` /
|
|
3
|
+
* `docsFiles`, local or pack-contributed) whose entries never reached the
|
|
4
|
+
* corpus — it failed to import, timed out, was skipped as a cached failure, or
|
|
5
|
+
* is declared by the config and does not exist.
|
|
6
|
+
*
|
|
7
|
+
* Read off `inspection.loaderDiagnostics` (the ONE record of what each loader
|
|
8
|
+
* did) by `describeInspectionDiscovery`. A corpus verdict over a load failure
|
|
9
|
+
* examined part of what it was told to, so it is never a pass.
|
|
10
|
+
*/
|
|
11
|
+
export interface IKnowledgeLoadFailure {
|
|
12
|
+
/** Project-relative when inside the project, else absolute. */
|
|
13
|
+
readonly file: string;
|
|
14
|
+
/** The loader slot (`knowledge` / `rules` / `paths` / `docs`). */
|
|
15
|
+
readonly kind: string;
|
|
16
|
+
/** `failed` / `timeout` / `cached-failed` / `missing`. */
|
|
17
|
+
readonly status: string;
|
|
18
|
+
/** The loader's message (the import error), or why nothing was read. */
|
|
19
|
+
readonly message: string;
|
|
20
|
+
/** Set for a pack-contributed file. */
|
|
21
|
+
readonly packName?: string;
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=knowledge-load-failure.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-load-failure.d.ts","sourceRoot":"","sources":["../src/knowledge-load-failure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/** Per-reference-kind outcome counts of a staleness sweep (`file`, `symbol`, `template`, …). */
|
|
2
|
+
export interface IKnowledgeReferenceKindBucket {
|
|
3
|
+
checked: number;
|
|
4
|
+
ok: number;
|
|
5
|
+
stale: number;
|
|
6
|
+
missing: number;
|
|
7
|
+
unknown: number;
|
|
8
|
+
/** Malformed references of this kind (a missing required field) — never checked. */
|
|
9
|
+
invalid: number;
|
|
10
|
+
}
|
|
11
|
+
//# sourceMappingURL=knowledge-reference-kind-bucket.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-reference-kind-bucket.d.ts","sourceRoot":"","sources":["../src/knowledge-reference-kind-bucket.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAC;CACjB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { IAssetReference } from '@shrkcrft/core';
|
|
2
|
+
import type { KnowledgeAdvisoryCode } from './knowledge-advisory-code.js';
|
|
3
|
+
import type { ReferenceAssetKind } from './reference-asset-kind.js';
|
|
4
|
+
/** One advisory from a staleness sweep — reported, never gating by itself. */
|
|
5
|
+
export interface IKnowledgeStaleAdvisory {
|
|
6
|
+
readonly code: KnowledgeAdvisoryCode;
|
|
7
|
+
/** The entry / boundary rule / policy the advisory is about. */
|
|
8
|
+
readonly subjectId: string;
|
|
9
|
+
readonly assetKind: ReferenceAssetKind;
|
|
10
|
+
readonly message: string;
|
|
11
|
+
/** A reference that would verify the claim, ready to paste into `references[]`. */
|
|
12
|
+
readonly suggestion?: IAssetReference;
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=knowledge-stale-advisory.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-stale-advisory.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-advisory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,8EAA8E;AAC9E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mFAAmF;IACnF,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;CACvC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The three entry buckets of a staleness sweep, over the entries in scope.
|
|
3
|
+
*
|
|
4
|
+
* `verified + stale + unverifiable === entriesInScope`, always. The CLI renders
|
|
5
|
+
* the unverifiable count AND its percentage on the summary line where a bare
|
|
6
|
+
* `0 stale` used to sit, and turns {@link referencedRatio} into the verdict's
|
|
7
|
+
* coverage (`examined` = verified + stale).
|
|
8
|
+
*/
|
|
9
|
+
export interface IKnowledgeStaleCoverage {
|
|
10
|
+
readonly entriesInScope: number;
|
|
11
|
+
readonly verified: number;
|
|
12
|
+
readonly stale: number;
|
|
13
|
+
readonly unverifiable: number;
|
|
14
|
+
/** `unverifiable / entriesInScope × 100`, one decimal place; 0 for an empty scope. */
|
|
15
|
+
readonly unverifiablePct: number;
|
|
16
|
+
/** `(verified + stale) / entriesInScope` — the share the check could examine; 0 for an empty scope. */
|
|
17
|
+
readonly referencedRatio: number;
|
|
18
|
+
}
|
|
19
|
+
//# sourceMappingURL=knowledge-stale-coverage.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-stale-coverage.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-coverage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,sFAAsF;IACtF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,uGAAuG;IACvG,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { IVerdictCoverage } from '@shrkcrft/core';
|
|
2
|
+
/**
|
|
3
|
+
* What a caller of the knowledge stale-check gate asked for EXPLICITLY — the
|
|
4
|
+
* flags of `shrk knowledge stale-check` / `verify`. `shrk quality`, `shrk
|
|
5
|
+
* release readiness` and every `buildQualityReport` consumer (MCP, the
|
|
6
|
+
* dashboard, the report site) pass `{}`: they run on the config alone.
|
|
7
|
+
*
|
|
8
|
+
* `knowledgeStaleGateInput` folds these over the config's `knowledgeCheck`
|
|
9
|
+
* block — the ONE place that precedence is decided (a flag wins) — so the verb,
|
|
10
|
+
* the quality gate and readiness cannot read the config three ways.
|
|
11
|
+
*/
|
|
12
|
+
export interface IKnowledgeStaleGateFlags {
|
|
13
|
+
/** `--ci`. */
|
|
14
|
+
readonly ci?: boolean;
|
|
15
|
+
/** The verb's own `--strict` (required references only, like `--ci`). */
|
|
16
|
+
readonly strict?: boolean;
|
|
17
|
+
/** Validated `--fail-on` categories. Absent / empty = not given: `knowledgeCheck.failOn` applies. */
|
|
18
|
+
readonly failOn?: readonly string[];
|
|
19
|
+
/** `--min-referenced` — wins over `knowledgeCheck.minReferenced`. */
|
|
20
|
+
readonly minReferenced?: {
|
|
21
|
+
readonly ratio: number;
|
|
22
|
+
readonly acceptedBy: string;
|
|
23
|
+
};
|
|
24
|
+
/** `--require-references` (ORed with `knowledgeCheck.requireReferences`). */
|
|
25
|
+
readonly requireReferences?: boolean;
|
|
26
|
+
/** `allowEmptyValve(args, entriesInScope)`. Never set from config. */
|
|
27
|
+
readonly emptyAcceptance?: Pick<IVerdictCoverage, 'acceptedBy'>;
|
|
28
|
+
/** `--stale-after`, in days — the window the `aged` category measures against. */
|
|
29
|
+
readonly staleAfterDays?: number;
|
|
30
|
+
/** `--as-of` (only meaningful with a `--stale-after` window). */
|
|
31
|
+
readonly asOf?: string;
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=knowledge-stale-gate-flags.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-stale-gate-flags.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-gate-flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC,cAAc;IACd,QAAQ,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;IACtB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,qGAAqG;IACrG,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,qEAAqE;IACrE,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,sEAAsE;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAChE,kFAAkF;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import type { IVerdictCoverage } from '@shrkcrft/core';
|
|
2
|
+
import type { IInspectionDiscovery } from './inspection-discovery.js';
|
|
3
|
+
/**
|
|
4
|
+
* What the knowledge stale-check verdict is decided FROM, besides the report —
|
|
5
|
+
* the flags of `shrk knowledge stale-check`, or the config `knowledgeCheck`
|
|
6
|
+
* block when `shrk quality` / `buildQualityReport` runs the same gate.
|
|
7
|
+
*/
|
|
8
|
+
export interface IKnowledgeStaleGateInput {
|
|
9
|
+
/** `--ci`: required references that fail are blocking. */
|
|
10
|
+
readonly ci: boolean;
|
|
11
|
+
/** The verb's own `--strict` (required references, like `--ci`). */
|
|
12
|
+
readonly strict: boolean;
|
|
13
|
+
/** Validated `--fail-on` categories (see `KNOWLEDGE_FAIL_ON_CATEGORIES`). */
|
|
14
|
+
readonly failOn: ReadonlySet<string>;
|
|
15
|
+
/**
|
|
16
|
+
* `--min-referenced <ratio>` (or `knowledgeCheck.minReferenced`): the least
|
|
17
|
+
* share of in-scope entries the check must examine. Below it the run FAILS;
|
|
18
|
+
* at or above it the remaining unverifiable entries are ACCEPTED, and the
|
|
19
|
+
* acceptance is printed with `acceptedBy` verbatim.
|
|
20
|
+
*/
|
|
21
|
+
readonly minReferenced?: {
|
|
22
|
+
readonly ratio: number;
|
|
23
|
+
readonly acceptedBy: string;
|
|
24
|
+
};
|
|
25
|
+
/** `--require-references` / `--fail-on unverifiable` / `knowledgeCheck.requireReferences`. */
|
|
26
|
+
readonly requireReferences: boolean;
|
|
27
|
+
/**
|
|
28
|
+
* The `--allow-empty` valve (`allowEmptyValve(args, entriesInScope)`), or `{}`.
|
|
29
|
+
* Honoured ONLY for a legitimately empty scope — never over a missing
|
|
30
|
+
* `sharkcraft/` folder or a config that failed to load.
|
|
31
|
+
*/
|
|
32
|
+
readonly emptyAcceptance: Pick<IVerdictCoverage, 'acceptedBy'>;
|
|
33
|
+
/** The run was narrowed to a changeset (`--changed-only` / `--since` / `--staged` / `--files`). */
|
|
34
|
+
readonly scoped: boolean;
|
|
35
|
+
/** Where discovery landed — the refusal names it when nothing was loaded. */
|
|
36
|
+
readonly discovery: IInspectionDiscovery;
|
|
37
|
+
/**
|
|
38
|
+
* Set when the request can never be evaluated as asked — a category that
|
|
39
|
+
* cannot fire (`aged` with no `--stale-after` window, from a flag or from
|
|
40
|
+
* `knowledgeCheck.failOn`), or `--as-of` with no window to date. The verb
|
|
41
|
+
* exits `3`; `shrk quality` reports the item `error`; readiness is not ready.
|
|
42
|
+
* Never a verdict.
|
|
43
|
+
*/
|
|
44
|
+
readonly usageProblem?: string;
|
|
45
|
+
}
|
|
46
|
+
//# sourceMappingURL=knowledge-stale-gate-input.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-stale-gate-input.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-gate-input.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,8FAA8F;IAC9F,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAC/D,mGAAmG;IACnG,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { IVerdictCoverage } from '@shrkcrft/core';
|
|
2
|
+
import type { IKnowledgeStaleGateRule } from './knowledge-stale-gate-rule.js';
|
|
3
|
+
/**
|
|
4
|
+
* The knowledge stale-check verdict INPUTS, before settling: a proposed exit,
|
|
5
|
+
* the run coverage (entries examined of entries in scope) and the rules.
|
|
6
|
+
* `shrk knowledge stale-check` settles them with `buildGateEnvelope`; `shrk
|
|
7
|
+
* quality` and `buildQualityReport` (MCP, the dashboard, the report site) with
|
|
8
|
+
* `settleKnowledgeStaleGate` — the same numbers either way.
|
|
9
|
+
*/
|
|
10
|
+
export interface IKnowledgeStaleGate {
|
|
11
|
+
/** 0 / 1 / 2 from what was found — settle it; never return it raw. */
|
|
12
|
+
readonly proposed: number;
|
|
13
|
+
/** Why `proposed` is 1: each blocking condition, in order. */
|
|
14
|
+
readonly reasons: readonly string[];
|
|
15
|
+
readonly requiredStale: number;
|
|
16
|
+
readonly requiredMissing: number;
|
|
17
|
+
/** The envelope rules (`knowledge-references`, `knowledge-files`), or none for an empty scope. */
|
|
18
|
+
readonly rules: readonly IKnowledgeStaleGateRule[];
|
|
19
|
+
/** Knowledge entries examined (verified + stale) of entries in scope. */
|
|
20
|
+
readonly runCoverage: IVerdictCoverage;
|
|
21
|
+
/** True when 0 entries loaded because discovery / config failed — `--allow-empty` never clears that. */
|
|
22
|
+
readonly discoveryFailed: boolean;
|
|
23
|
+
/** One-line explanation for a not-verified verdict, when there is a better one than the shortfall. */
|
|
24
|
+
readonly notVerifiedLead?: string;
|
|
25
|
+
/**
|
|
26
|
+
* Round 13: failing (stale / missing) references this mode WAIVED — blocking
|
|
27
|
+
* nothing, printed as an acceptance (`knowledge-references`'
|
|
28
|
+
* `unitAcceptance`). The ✓ sentence names them instead of claiming "no stale
|
|
29
|
+
* or missing references".
|
|
30
|
+
*/
|
|
31
|
+
readonly waived: number;
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=knowledge-stale-gate-result.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-stale-gate-result.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-gate-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,kGAAkG;IAClG,QAAQ,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACnD,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,wGAAwG;IACxG,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,sGAAsG;IACtG,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import type { IVerdictCoverage } from '@shrkcrft/core';
|
|
2
|
+
import type { IKnowledgeStaleGateViolation } from './knowledge-stale-gate-violation.js';
|
|
3
|
+
/**
|
|
4
|
+
* One rule of the knowledge stale-check verdict (`knowledge-references`, or
|
|
5
|
+
* `knowledge-files` for a knowledge file that never loaded). Structurally a
|
|
6
|
+
* CLI gate-envelope rule (`IGateRuleResult` of type `knowledge`): the verb
|
|
7
|
+
* passes it to `buildGateEnvelope` as is, and `shrk quality` / every
|
|
8
|
+
* `buildQualityReport` consumer settles the SAME record through core's
|
|
9
|
+
* `settleVerdict` — the inspector cannot import the CLI's type, so the shape
|
|
10
|
+
* lives here, below both.
|
|
11
|
+
*/
|
|
12
|
+
export interface IKnowledgeStaleGateRule {
|
|
13
|
+
readonly id: string;
|
|
14
|
+
readonly type: 'knowledge';
|
|
15
|
+
readonly status: 'passed' | 'failed' | 'skipped' | 'error';
|
|
16
|
+
readonly severity: 'error' | 'warning';
|
|
17
|
+
readonly counts: Readonly<Record<string, number>>;
|
|
18
|
+
readonly violations: readonly IKnowledgeStaleGateViolation[];
|
|
19
|
+
readonly skipReason?: string;
|
|
20
|
+
readonly error?: string;
|
|
21
|
+
/** What the rule examined against what it was asked to. REQUIRED. */
|
|
22
|
+
readonly coverage: IVerdictCoverage;
|
|
23
|
+
/**
|
|
24
|
+
* An ACCEPTANCE riding next to `coverage` (round 13), folded by the envelope
|
|
25
|
+
* exactly like a selector unit acceptance (`ruleVerdictRecords`): the failing
|
|
26
|
+
* references this run's mode waived — `required: false` under `--ci` /
|
|
27
|
+
* `--strict`, or outside the chosen `--fail-on` categories — printed in
|
|
28
|
+
* `accepted` at exit 0, so the ✓ line never stands over a STALE row in
|
|
29
|
+
* silence. Never a shortfall; `rules[].status` never reads it.
|
|
30
|
+
*/
|
|
31
|
+
readonly unitAcceptance?: IVerdictCoverage;
|
|
32
|
+
}
|
|
33
|
+
//# sourceMappingURL=knowledge-stale-gate-rule.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-stale-gate-rule.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-gate-rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAExF;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,UAAU,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC;;;;;;;OAOG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB,CAAC;CAC5C"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One failing reference / anchor / entry in a knowledge stale-check rule —
|
|
3
|
+
* structurally the CLI gate envelope's `IGateViolation`, so the verb hands the
|
|
4
|
+
* rule to `buildGateEnvelope` unchanged.
|
|
5
|
+
*/
|
|
6
|
+
export interface IKnowledgeStaleGateViolation {
|
|
7
|
+
readonly id: string;
|
|
8
|
+
readonly file?: string;
|
|
9
|
+
readonly line?: number;
|
|
10
|
+
readonly message?: string;
|
|
11
|
+
readonly hint?: string;
|
|
12
|
+
}
|
|
13
|
+
//# sourceMappingURL=knowledge-stale-gate-violation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-stale-gate-violation.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-gate-violation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* THE knowledge stale-check verdict — decided once, from the one report.
|
|
3
|
+
*
|
|
4
|
+
* `shrk knowledge stale-check` / `verify` settle it through `buildGateEnvelope`;
|
|
5
|
+
* `shrk quality`, `shrk release readiness` and every `buildQualityReport`
|
|
6
|
+
* consumer (MCP `get_quality_report`, the dashboard, the report site) through
|
|
7
|
+
* `settleKnowledgeStaleGate`. All of them call this, so the corpus verdict an
|
|
8
|
+
* agent chains on and the one the pre-push bundle folds cannot disagree.
|
|
9
|
+
* (Round 11 review: it lived in the CLI, so the MCP report — which cannot
|
|
10
|
+
* import the CLI — had no knowledge gate at all and read `pass` over a stale
|
|
11
|
+
* corpus `shrk quality` failed.)
|
|
12
|
+
*
|
|
13
|
+
* STRICT BY DEFAULT: every in-scope entry the check could not examine (no
|
|
14
|
+
* checkable `references[]` / `anchors[]`) is a coverage shortfall on the
|
|
15
|
+
* verdict, so a run with any unverifiable entry settles to `2` (not verified)
|
|
16
|
+
* — never `0`. The only ways to a `0` over an unverifiable remainder are
|
|
17
|
+
* explicit and printed: `--min-referenced <ratio>` (or
|
|
18
|
+
* `knowledgeCheck.minReferenced`) accepts the remainder when the examined share
|
|
19
|
+
* is at least the ratio, and fails the run below it; `--allow-empty` accepts a
|
|
20
|
+
* legitimately EMPTY scope only.
|
|
21
|
+
*/
|
|
22
|
+
import type { ISharkCraftConfig } from '@shrkcrft/config';
|
|
23
|
+
import { type ISettledVerdict } from '@shrkcrft/core';
|
|
24
|
+
import type { IInspectionDiscovery } from './inspection-discovery.js';
|
|
25
|
+
import { type IKnowledgeStaleReport } from './knowledge-stale.js';
|
|
26
|
+
import type { IKnowledgeStaleGateFlags } from './knowledge-stale-gate-flags.js';
|
|
27
|
+
import type { IKnowledgeStaleGateInput } from './knowledge-stale-gate-input.js';
|
|
28
|
+
import type { IKnowledgeStaleGate } from './knowledge-stale-gate-result.js';
|
|
29
|
+
/**
|
|
30
|
+
* Every `--fail-on` category. `all` keeps its historical meaning (any stale or
|
|
31
|
+
* missing reference); the round-11 categories are opt-in BY NAME, so no
|
|
32
|
+
* existing `--fail-on all` pipeline changes behaviour. (A MALFORMED reference
|
|
33
|
+
* is never a pass in any mode — it is a coverage shortfall, exit 2;
|
|
34
|
+
* `--fail-on invalid` makes it a failure, exit 1.)
|
|
35
|
+
*/
|
|
36
|
+
export declare const KNOWLEDGE_FAIL_ON_CATEGORIES: readonly string[];
|
|
37
|
+
/** Parse `--min-referenced`: a ratio `0..1` or a percentage `NN%`. `null` when malformed. */
|
|
38
|
+
export declare function parseMinReferenced(raw: string): number | null;
|
|
39
|
+
/** `0.266…` → `26.7%`, `1` → `100%`. */
|
|
40
|
+
export declare function formatPct(ratio: number): string;
|
|
41
|
+
/**
|
|
42
|
+
* Decide the stale-check verdict inputs. Pure: the report, the flags, the
|
|
43
|
+
* discovery — nothing else.
|
|
44
|
+
*/
|
|
45
|
+
export declare function evaluateKnowledgeStaleGate(report: IKnowledgeStaleReport, input: IKnowledgeStaleGateInput): IKnowledgeStaleGate;
|
|
46
|
+
/**
|
|
47
|
+
* A request whose `aged` category (or `--as-of`) has no `--stale-after` window
|
|
48
|
+
* to measure against can never fire — the vacuous-category class `--fail-on
|
|
49
|
+
* bogus` is refused for. `undefined` when the request is well-formed.
|
|
50
|
+
*/
|
|
51
|
+
export declare function knowledgeStaleWindowProblem(failOn: ReadonlySet<string>, agedFromConfig: boolean, staleAfterDays: number | undefined, asOf: string | undefined): string | undefined;
|
|
52
|
+
/**
|
|
53
|
+
* THE stale-check input — the verb's flags folded over the config's
|
|
54
|
+
* `knowledgeCheck` block. `shrk knowledge stale-check`, `shrk quality`, `shrk
|
|
55
|
+
* release readiness` and `buildQualityReport` all build their input here, so
|
|
56
|
+
* for a config-only request the verb's exit, the quality gate and
|
|
57
|
+
* `knowledgeCheck.ready` are one answer (they used to read the block three
|
|
58
|
+
* different ways).
|
|
59
|
+
*
|
|
60
|
+
* Precedence (a flag wins):
|
|
61
|
+
* - `--fail-on` replaces `knowledgeCheck.failOn` wholesale;
|
|
62
|
+
* - `knowledgeCheck.strict: true` ("promote any stale to a failure") adds
|
|
63
|
+
* `all` to the config's list; the verb's `--strict` / `--ci` (the R30
|
|
64
|
+
* required-only modes) take precedence over any `failOn`;
|
|
65
|
+
* - `--min-referenced` over `knowledgeCheck.minReferenced` (each printed as
|
|
66
|
+
* its own acceptance);
|
|
67
|
+
* - `--require-references` OR `knowledgeCheck.requireReferences`;
|
|
68
|
+
* - `--allow-empty` is a flag only — never read from config.
|
|
69
|
+
*/
|
|
70
|
+
export declare function knowledgeStaleGateInput(o: {
|
|
71
|
+
readonly flags: IKnowledgeStaleGateFlags;
|
|
72
|
+
readonly knowledgeCheck: ISharkCraftConfig['knowledgeCheck'];
|
|
73
|
+
readonly discovery: IInspectionDiscovery;
|
|
74
|
+
readonly scoped: boolean;
|
|
75
|
+
}): IKnowledgeStaleGateInput;
|
|
76
|
+
/**
|
|
77
|
+
* Settle a stale-check verdict WITHOUT an envelope (`shrk quality`, `shrk
|
|
78
|
+
* release readiness`, `buildQualityReport`) — exactly the fold
|
|
79
|
+
* `buildGateEnvelope` applies for the verb: the run coverage plus every rule's
|
|
80
|
+
* coverage, subject = rule id.
|
|
81
|
+
*/
|
|
82
|
+
export declare function settleKnowledgeStaleGate(gate: IKnowledgeStaleGate): ISettledVerdict;
|
|
83
|
+
//# sourceMappingURL=knowledge-stale-gate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"knowledge-stale-gate.d.ts","sourceRoot":"","sources":["../src/knowledge-stale-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAqC,KAAK,eAAe,EAAyB,MAAM,gBAAgB,CAAC;AAGhH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAGtE,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAU5E;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAazD,CAAC;AAKF,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK7D;AAED,wCAAwC;AACxC,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AA6CD;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,qBAAqB,EAC7B,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CA4RrB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,EAC3B,cAAc,EAAE,OAAO,EACvB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CASpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE;IACzC,QAAQ,CAAC,KAAK,EAAE,wBAAwB,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;IAC7D,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,GAAG,wBAAwB,CA8B3B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,mBAAmB,GAAG,eAAe,CASnF"}
|