@holmes-lab/holmes-kit 0.39.0 → 0.40.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 +344 -6
- package/README.md +54 -41
- package/dist/.build-id +1 -1
- package/dist/holmes/admission/core/admission-policy.d.ts +37 -0
- package/dist/holmes/admission/core/admission-policy.js +147 -0
- package/dist/holmes/admission/core/bounded-reader.d.ts +56 -0
- package/dist/holmes/admission/core/bounded-reader.js +135 -0
- package/dist/holmes/admission/core/change-classifier.d.ts +34 -0
- package/dist/holmes/admission/core/change-classifier.js +278 -0
- package/dist/holmes/admission/core/config-loader.d.ts +30 -0
- package/dist/holmes/admission/core/config-loader.js +145 -0
- package/dist/holmes/admission/core/event-judgement.d.ts +37 -0
- package/dist/holmes/admission/core/event-judgement.js +251 -0
- package/dist/holmes/admission/core/path-rules.d.ts +35 -0
- package/dist/holmes/admission/core/path-rules.js +88 -0
- package/dist/holmes/admission/core/pin.d.ts +7 -0
- package/dist/holmes/admission/core/pin.js +29 -0
- package/dist/holmes/admission/core/ports.d.ts +48 -0
- package/dist/holmes/admission/core/ports.js +11 -0
- package/dist/holmes/admission/core/range-resolver.d.ts +32 -0
- package/dist/holmes/admission/core/range-resolver.js +51 -0
- package/dist/holmes/admission/core/self-containment.d.ts +1 -0
- package/dist/holmes/admission/core/self-containment.js +125 -0
- package/dist/holmes/admission/core/signature-source.d.ts +9 -0
- package/dist/holmes/admission/core/signature-source.js +4 -0
- package/dist/holmes/admission/core/transition-planner.d.ts +15 -0
- package/dist/holmes/admission/core/transition-planner.js +14 -0
- package/dist/holmes/admission/core/verdict.d.ts +38 -0
- package/dist/holmes/admission/core/verdict.js +17 -0
- package/dist/holmes/admission/core/wiring.d.ts +44 -0
- package/dist/holmes/admission/core/wiring.js +618 -0
- package/dist/holmes/admission/forge/git-object-port.d.ts +4 -0
- package/dist/holmes/admission/forge/git-object-port.js +132 -0
- package/dist/holmes/assoc/assoc-arm.d.ts +1 -1
- package/dist/holmes/assoc/assoc-arm.js +1 -1
- package/dist/holmes/cli/agents.d.ts +8 -0
- package/dist/holmes/cli/agents.js +9 -5
- package/dist/holmes/cli/approve-cli.d.ts +2 -0
- package/dist/holmes/cli/approve-cli.js +392 -0
- package/dist/holmes/cli/approve-ref.d.ts +13 -7
- package/dist/holmes/cli/approve-ref.js +30 -10
- package/dist/holmes/cli/approve-status.d.ts +26 -2
- package/dist/holmes/cli/approve-status.js +98 -18
- package/dist/holmes/cli/approve-watch.d.ts +5 -0
- package/dist/holmes/cli/approve-watch.js +10 -5
- package/dist/holmes/cli/approve.d.ts +49 -13
- package/dist/holmes/cli/approve.js +249 -67
- package/dist/holmes/cli/attest.js +2 -1
- package/dist/holmes/cli/autonomy.d.ts +4 -1
- package/dist/holmes/cli/autonomy.js +17 -10
- package/dist/holmes/cli/codex-oracle.d.ts +11 -0
- package/dist/holmes/cli/codex-oracle.js +5 -1
- package/dist/holmes/cli/codex-toml.d.ts +10 -0
- package/dist/holmes/cli/codex-toml.js +36 -2
- package/dist/holmes/cli/doctor-boundary.d.ts +76 -0
- package/dist/holmes/cli/doctor-boundary.js +308 -0
- package/dist/holmes/cli/doctor-locks.d.ts +15 -0
- package/dist/holmes/cli/doctor-locks.js +119 -0
- package/dist/holmes/cli/doctor.d.ts +2 -0
- package/dist/holmes/cli/doctor.js +34 -5
- package/dist/holmes/cli/flags.d.ts +23 -0
- package/dist/holmes/cli/flags.js +89 -0
- package/dist/holmes/cli/index.d.ts +5 -1
- package/dist/holmes/cli/index.js +202 -424
- package/dist/holmes/cli/init.js +33 -0
- package/dist/holmes/cli/lock-recover.d.ts +5 -0
- package/dist/holmes/cli/lock-recover.js +126 -0
- package/dist/holmes/cli/mcp-processes.js +1 -1
- package/dist/holmes/cli/release-docs.js +1 -1
- package/dist/holmes/cli/run-exec.d.ts +141 -0
- package/dist/holmes/cli/run-exec.js +1435 -0
- package/dist/holmes/cli/run-provision.d.ts +3 -1
- package/dist/holmes/cli/run-provision.js +255 -44
- package/dist/holmes/cli/run-wiring.d.ts +69 -0
- package/dist/holmes/cli/run-wiring.js +270 -0
- package/dist/holmes/cli/run.d.ts +21 -0
- package/dist/holmes/cli/run.js +341 -92
- package/dist/holmes/cli/runtime-binding-approval.js +32 -19
- package/dist/holmes/cli/screen-safe.d.ts +3 -92
- package/dist/holmes/cli/screen-safe.js +18 -756
- package/dist/holmes/config/config.d.ts +2 -0
- package/dist/holmes/config/config.js +5 -2
- package/dist/holmes/cpg/foundation/language-matrix.js +2 -2
- package/dist/holmes/cpg/import-resolver.js +1 -1
- package/dist/holmes/governance/approval-decisions.d.ts +47 -0
- package/dist/holmes/governance/approval-decisions.js +29 -0
- package/dist/holmes/governance/approval-grants.d.ts +220 -1
- package/dist/holmes/governance/approval-grants.js +612 -33
- package/dist/holmes/governance/approval-queue.d.ts +26 -0
- package/dist/holmes/governance/approval-queue.js +109 -11
- package/dist/holmes/governance/approval-spend.d.ts +95 -0
- package/dist/holmes/governance/approval-spend.js +191 -0
- package/dist/holmes/governance/autonomous-shell.d.ts +61 -0
- package/dist/holmes/governance/autonomous-shell.js +332 -0
- package/dist/holmes/governance/autonomy.d.ts +5 -0
- package/dist/holmes/governance/autonomy.js +16 -11
- package/dist/holmes/governance/constitution.d.ts +5 -0
- package/dist/holmes/governance/constitution.js +32 -12
- package/dist/holmes/governance/full-autonomy.d.ts +10 -0
- package/dist/holmes/governance/full-autonomy.js +103 -7
- package/dist/holmes/governance/harness-catalog.d.ts +103 -0
- package/dist/holmes/governance/harness-catalog.js +348 -0
- package/dist/holmes/governance/human-channel.d.ts +38 -0
- package/dist/holmes/governance/human-channel.js +49 -0
- package/dist/holmes/governance/install-manifest.d.ts +22 -0
- package/dist/holmes/governance/install-manifest.js +160 -0
- package/dist/holmes/governance/ledger-rechain.js +2 -0
- package/dist/holmes/governance/ledger-store.conformance.d.ts +7 -1
- package/dist/holmes/governance/ledger-store.conformance.js +66 -0
- package/dist/holmes/governance/ledger-store.d.ts +88 -11
- package/dist/holmes/governance/ledger-store.js +186 -8
- package/dist/holmes/governance/provenance-chain.d.ts +16 -4
- package/dist/holmes/governance/provenance-chain.js +19 -4
- package/dist/holmes/governance/provenance-ledger.d.ts +6 -3
- package/dist/holmes/governance/provenance-ledger.js +53 -18
- package/dist/holmes/governance/push-gate-runner.js +11 -7
- package/dist/holmes/governance/recorded-pairs.d.ts +96 -0
- package/dist/holmes/governance/recorded-pairs.js +522 -0
- package/dist/holmes/governance/replica-id.d.ts +1 -1
- package/dist/holmes/governance/replica-id.js +1 -1
- package/dist/holmes/governance/spec-seam.d.ts +59 -0
- package/dist/holmes/governance/spec-seam.js +587 -0
- package/dist/holmes/governance/spend-kinds.d.ts +16 -0
- package/dist/holmes/governance/spend-kinds.js +18 -0
- package/dist/holmes/guardrail/decision-ledger.d.ts +2 -1
- package/dist/holmes/guardrail/decision-ledger.js +2 -1
- package/dist/holmes/guardrail/impact-gate.d.ts +1 -0
- package/dist/holmes/guardrail/impact-gate.js +1 -1
- package/dist/holmes/guardrail/line-continuation.d.ts +8 -0
- package/dist/holmes/guardrail/line-continuation.js +39 -0
- package/dist/holmes/guardrail/operator-person.d.ts +28 -4
- package/dist/holmes/guardrail/operator-person.js +57 -11
- package/dist/holmes/guardrail/refusal-codes.d.ts +8 -3
- package/dist/holmes/guardrail/refusal-codes.js +64 -10
- package/dist/holmes/guardrail/risk-classifier.d.ts +15 -9
- package/dist/holmes/guardrail/risk-classifier.js +228 -16
- package/dist/holmes/guardrail/risk-gate.d.ts +2 -8
- package/dist/holmes/guardrail/risk-gate.js +7 -34
- package/dist/holmes/guardrail/risk-types.d.ts +10 -0
- package/dist/holmes/guardrail/run-plan-scope.js +3 -1
- package/dist/holmes/guardrail/run-refusals.js +24 -8
- package/dist/holmes/guardrail/run-stages.d.ts +5 -0
- package/dist/holmes/guardrail/run-stages.js +25 -5
- package/dist/holmes/guardrail/scope-judgment.js +1 -1
- package/dist/holmes/guardrail/shell-words.js +24 -3
- package/dist/holmes/guardrail/unresolved-write.d.ts +40 -0
- package/dist/holmes/guardrail/unresolved-write.js +556 -0
- package/dist/holmes/guardrail/write-target.d.ts +3 -0
- package/dist/holmes/guardrail/write-target.js +26 -5
- package/dist/holmes/hooks/pre-tool-use.d.ts +105 -1
- package/dist/holmes/hooks/pre-tool-use.js +1134 -167
- package/dist/holmes/hooks/rtm-refresh-child.d.ts +1 -1
- package/dist/holmes/hooks/rtm-refresh-child.js +1 -1
- package/dist/holmes/hooks/stop.d.ts +23 -0
- package/dist/holmes/hooks/stop.js +86 -33
- package/dist/holmes/mcp/approval-adapters.js +3 -1
- package/dist/holmes/mcp/approval-commit.js +3 -2
- package/dist/holmes/mcp/approval-policy.d.ts +2 -1
- package/dist/holmes/mcp/approval-policy.js +3 -1
- package/dist/holmes/mcp/handlers/adoption.d.ts +1 -1
- package/dist/holmes/mcp/handlers/approval-ask.d.ts +3 -0
- package/dist/holmes/mcp/handlers/approval-ask.js +18 -7
- package/dist/holmes/mcp/handlers/entity-integration.d.ts +3 -3
- package/dist/holmes/mcp/handlers/entity-integration.js +29 -11
- package/dist/holmes/mcp/handlers/entity-renumber.d.ts +4 -4
- package/dist/holmes/mcp/handlers/entity-renumber.js +29 -11
- package/dist/holmes/mcp/handlers/entity-store.d.ts +2 -2
- package/dist/holmes/mcp/handlers/entity-store.js +133 -59
- package/dist/holmes/mcp/handlers/operator-inspection.d.ts +9 -5
- package/dist/holmes/mcp/handlers/operator-inspection.js +79 -16
- package/dist/holmes/mcp/handlers/phase-queries.d.ts +1 -1
- package/dist/holmes/mcp/handlers/requirement-triage.d.ts +4 -4
- package/dist/holmes/mcp/handlers/review-evidence.d.ts +2 -2
- package/dist/holmes/mcp/handlers/review-evidence.js +35 -11
- package/dist/holmes/mcp/handlers/review-queries.d.ts +5 -0
- package/dist/holmes/mcp/handlers/review-queries.js +8 -1
- package/dist/holmes/mcp/handlers/review-verdict.d.ts +3 -0
- package/dist/holmes/mcp/handlers/review-verdict.js +10 -3
- package/dist/holmes/mcp/handlers/risk-assessment.d.ts +7 -2
- package/dist/holmes/mcp/handlers/risk-assessment.js +34 -12
- package/dist/holmes/mcp/handlers/runtime-binding-tool.d.ts +2 -2
- package/dist/holmes/mcp/handlers/slice-orchestration.d.ts +6 -1
- package/dist/holmes/mcp/handlers/slice-orchestration.js +14 -1
- package/dist/holmes/mcp/handlers/spec-approval.d.ts +15 -3
- package/dist/holmes/mcp/handlers/spec-approval.js +32 -5
- package/dist/holmes/mcp/handlers/spec-authoring.d.ts +2 -2
- package/dist/holmes/mcp/handlers/spec-authoring.js +19 -2
- package/dist/holmes/mcp/handlers/spec-lifecycle.d.ts +11 -38
- package/dist/holmes/mcp/handlers/spec-lifecycle.js +441 -94
- package/dist/holmes/mcp/handlers/spec-queries.d.ts +2 -2
- package/dist/holmes/mcp/handlers/taint-screening.d.ts +1 -1
- package/dist/holmes/mcp/handlers/taint-screening.js +2 -2
- package/dist/holmes/mcp/handlers/test-execution.d.ts +1 -1
- package/dist/holmes/mcp/handlers/workspace-queries.d.ts +2 -2
- package/dist/holmes/mcp/handlers.d.ts +89 -79
- package/dist/holmes/mcp/handlers.js +69 -22
- package/dist/holmes/mcp/harness-attestation.d.ts +78 -5
- package/dist/holmes/mcp/harness-attestation.js +325 -53
- package/dist/holmes/mcp/maintenance-analyze.d.ts +1 -1
- package/dist/holmes/mcp/maintenance-analyze.js +9 -9
- package/dist/holmes/mcp/maintenance-evidence.js +31 -2
- package/dist/holmes/mcp/requirement-triage-evidence.js +22 -13
- package/dist/holmes/mcp/server-staleness.js +1 -1
- package/dist/holmes/mcp/server.js +9 -8
- package/dist/holmes/mcp/spec-id-guard.js +1 -1
- package/dist/holmes/mcp/tool-schemas.d.ts +13 -0
- package/dist/holmes/mcp/tool-schemas.js +29 -2
- package/dist/holmes/project/act-root.d.ts +19 -0
- package/dist/holmes/project/act-root.js +100 -0
- package/dist/holmes/project/baseline.js +4 -3
- package/dist/holmes/project/bounded-group.d.ts +47 -0
- package/dist/holmes/project/bounded-group.js +140 -0
- package/dist/holmes/project/bounded-io.d.ts +50 -2
- package/dist/holmes/project/bounded-io.js +138 -6
- package/dist/holmes/project/change-source.js +2 -2
- package/dist/holmes/project/instance-id.d.ts +10 -0
- package/dist/holmes/project/instance-id.js +233 -0
- package/dist/holmes/project/machine-identity.d.ts +25 -0
- package/dist/holmes/project/machine-identity.js +133 -0
- package/dist/holmes/project/owned-lock.d.ts +84 -0
- package/dist/holmes/project/owned-lock.js +263 -0
- package/dist/holmes/project/plain-lock-fs.d.ts +2 -0
- package/dist/holmes/project/plain-lock-fs.js +126 -0
- package/dist/holmes/project/request-lock.d.ts +85 -0
- package/dist/holmes/project/request-lock.js +459 -0
- package/dist/holmes/project/root.d.ts +12 -4
- package/dist/holmes/project/root.js +26 -7
- package/dist/holmes/project/run-records.d.ts +19 -0
- package/dist/holmes/project/run-records.js +94 -12
- package/dist/holmes/project/screen-text.d.ts +94 -0
- package/dist/holmes/project/screen-text.js +763 -0
- package/dist/holmes/project/spend-lock.d.ts +82 -0
- package/dist/holmes/project/spend-lock.js +413 -0
- package/dist/holmes/refresh/freshness-coordinator.d.ts +1 -1
- package/dist/holmes/refresh/freshness-coordinator.js +1 -1
- package/dist/holmes/review/condition-hunk-replay.js +4 -2
- package/dist/holmes/review/confidence-calibration.d.ts +1 -1
- package/dist/holmes/review/confidence-calibration.js +1 -1
- package/dist/holmes/review/content-verify.js +1 -1
- package/dist/holmes/review/hop-ablation.d.ts +4 -4
- package/dist/holmes/review/hop-ablation.js +5 -5
- package/dist/holmes/review/point-in-time-replay.js +12 -3
- package/dist/holmes/review/rank-diagnosis.d.ts +2 -2
- package/dist/holmes/review/rank-diagnosis.js +1 -1
- package/dist/holmes/review/replay-corpus.d.ts +10 -4
- package/dist/holmes/review/replay-corpus.js +25 -9
- package/dist/holmes/review/requirement-triage.js +2 -2
- package/dist/holmes/review/semantic-arm.d.ts +3 -3
- package/dist/holmes/review/semantic-arm.js +3 -3
- package/dist/holmes/review/test-outcomes.js +3 -1
- package/dist/holmes/review/test-runner.d.ts +11 -0
- package/dist/holmes/review/test-runner.js +31 -10
- package/dist/holmes/review/test-selection-breadth.js +2 -2
- package/dist/holmes/review/verdicts.d.ts +105 -8
- package/dist/holmes/review/verdicts.js +640 -36
- package/dist/holmes/rtm/anchor-census.d.ts +9 -0
- package/dist/holmes/rtm/anchor-census.js +151 -0
- package/dist/holmes/rtm/anchor-ids.d.ts +25 -1
- package/dist/holmes/rtm/anchor-ids.js +45 -2
- package/dist/holmes/rtm/comment-ranges.d.ts +2 -0
- package/dist/holmes/rtm/comment-ranges.js +104 -0
- package/dist/holmes/rtm/counted-tests.d.ts +1 -0
- package/dist/holmes/rtm/counted-tests.js +63 -0
- package/dist/holmes/rtm/impact-advisory.d.ts +1 -1
- package/dist/holmes/rtm/known-defects.js +1 -1
- package/dist/holmes/rtm/localize.js +1 -1
- package/dist/holmes/rtm/taint-benchmark.d.ts +1 -1
- package/dist/holmes/rtm/taint-vocabulary.d.ts +1 -1
- package/dist/holmes/rtm/test-scope.d.ts +31 -0
- package/dist/holmes/rtm/test-scope.js +166 -5
- package/dist/holmes/rtm/trace-gaps.js +1 -1
- package/dist/holmes/runtime/dispatch.d.ts +10 -0
- package/dist/holmes/runtime/dispatch.js +12 -1
- package/dist/holmes/semantic/cloud-usage.d.ts +1 -1
- package/dist/holmes/semantic/cloud-usage.js +1 -1
- package/dist/holmes/semantic/unreadable-paths.d.ts +1 -1
- package/dist/holmes/semantic/unreadable-paths.js +1 -1
- package/dist/holmes/spec/approval-blockers.js +1 -1
- package/dist/holmes/spec/entity-store.d.ts +6 -1
- package/dist/holmes/spec/entity-store.js +16 -2
- package/dist/holmes/spec/entity-transaction.d.ts +7 -2
- package/dist/holmes/spec/entity-transaction.js +87 -170
- package/dist/holmes/spec/spec-store.d.ts +12 -6
- package/dist/holmes/spec/spec-store.js +4 -2
- package/dist/holmes/spec/spec-types.js +1 -1
- package/dist/holmes/spec/succession-guard.d.ts +56 -0
- package/dist/holmes/spec/succession-guard.js +187 -0
- package/dist/holmes/spec/succession.d.ts +70 -0
- package/dist/holmes/spec/succession.js +171 -0
- package/dist/holmes/spec/transition-policy.d.ts +2 -2
- package/docs/install-guide.md +9 -3
- package/docs/language-support.md +78 -0
- package/package.json +4 -3
- package/playbooks/author-slice/PLAYBOOK.md +1 -1
- package/playbooks/promote-slice/PLAYBOOK.md +5 -1
- package/playbooks/publish/PLAYBOOK.md +45 -33
- package/dist/holmes/review/manual-baseline.d.ts +0 -209
- package/dist/holmes/review/manual-baseline.js +0 -2847
|
@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
36
36
|
exports.createSpecApprovalHandlers = createSpecApprovalHandlers;
|
|
37
37
|
exports.readProjectFile = readProjectFile;
|
|
38
38
|
// @implements A-SPEC-182.3, A-SPEC-718.3, A-SPEC-770.6, A-SPEC-718.1,A-SPEC-718.2, A-SPEC-718, A-SPEC-551.1, A-SPEC-551.2, A-SPEC-627.1, A-SPEC-622, A-SPEC-100.2, A-SPEC-128, A-SPEC-132, A-SPEC-133, A-SPEC-151, A-SPEC-188, A-SPEC-189, A-SPEC-244, A-SPEC-245, A-SPEC-729, A-SPEC-532.7, A-SPEC-792.1, A-SPEC-792.4
|
|
39
|
-
// @implements A-SPEC-631, A-SPEC-733
|
|
39
|
+
// @implements A-SPEC-631, A-SPEC-733, A-SPEC-245.9, A-SPEC-245.15
|
|
40
40
|
const fs = __importStar(require("node:fs"));
|
|
41
41
|
const compat_impact_1 = require("../../spec/compat-impact");
|
|
42
42
|
const path = __importStar(require("node:path"));
|
|
@@ -437,10 +437,34 @@ function createSpecApprovalHandlers(context) {
|
|
|
437
437
|
// conflict the EDIT wins and the APPROVAL loses: the edit is what a person just wrote; the
|
|
438
438
|
// approval is an act that can simply be retried. The reverse (the old behaviour) sealed
|
|
439
439
|
// stale content over a destroyed edit with no notice.
|
|
440
|
+
// @implements A-SPEC-245.3 — the grant is claimed for the seal it authorizes (a second seal on the same grant loses
|
|
441
|
+
// the claim), committed by the write and returned by a refusal or a throw
|
|
442
|
+
const claim = approveResolved.source === 'grant' && approveResolved.root && approveResolved.approval.nonce
|
|
443
|
+
? (0, approval_grants_1.claimGrant)(approveResolved.root, approveResolved.approval.nonce) : undefined;
|
|
444
|
+
if (claim === null) {
|
|
445
|
+
return { ok: false, code: 'grant-in-use', reason: `the approval grant for sealing ${a.id} is in use by another act — nothing was sealed; retry, or ask for a new approval` };
|
|
446
|
+
}
|
|
447
|
+
let spent = false;
|
|
440
448
|
try {
|
|
441
|
-
|
|
449
|
+
// @implements A-SPEC-245.9 (1b-1) — the grant is spent once across replicas where the seal's first byte is
|
|
450
|
+
// written: after the store's version and destination checks, inside the entity-store lock (A-SPEC-245.14)
|
|
451
|
+
await store.write(candidate, { expectedVersion: cur.version, beforePublish: (0, approval_grants_1.grantSpend)(claim ? approveResolved : undefined, `spec-approve ${a.id}`, () => { spent = true; }) });
|
|
442
452
|
}
|
|
443
453
|
catch (e) {
|
|
454
|
+
// @implements A-SPEC-245.15 (item 2) — after the spend was recorded the grant is used: committed, never returned
|
|
455
|
+
if (spent) {
|
|
456
|
+
try {
|
|
457
|
+
claim?.commit();
|
|
458
|
+
}
|
|
459
|
+
catch (c) {
|
|
460
|
+
process.stderr.write(`[Holmes-Kit] ${c.message}\n`);
|
|
461
|
+
}
|
|
462
|
+
}
|
|
463
|
+
else
|
|
464
|
+
claim?.release();
|
|
465
|
+
if (e instanceof approval_grants_1.GrantSpendRefusal) {
|
|
466
|
+
return { ok: false, code: 'grant-spend-refused', reason: `${a.id} was not sealed: ${e.message}` };
|
|
467
|
+
}
|
|
444
468
|
if (e instanceof spec_store_1.SpecVersionConflictError) {
|
|
445
469
|
// @implements A-SPEC-538.4 — the refusal is unchanged (refuse, write nothing, the edit
|
|
446
470
|
// wins); it now also CARRIES the conflict: the version this act read, the version now on
|
|
@@ -494,9 +518,12 @@ function createSpecApprovalHandlers(context) {
|
|
|
494
518
|
}
|
|
495
519
|
catch { /* a missed routing signal is not a broken seal */ }
|
|
496
520
|
}
|
|
497
|
-
// @implements A-SPEC-245 — single-use: the grant is spent by the seal it authorized.
|
|
498
|
-
|
|
499
|
-
(
|
|
521
|
+
// @implements A-SPEC-245, A-SPEC-245.3 — single-use: the grant is spent by the seal it authorized.
|
|
522
|
+
try {
|
|
523
|
+
claim?.commit();
|
|
524
|
+
}
|
|
525
|
+
catch (e) {
|
|
526
|
+
process.stderr.write(`[Holmes-Kit] ${e.message}\n`);
|
|
500
527
|
}
|
|
501
528
|
// @implements A-SPEC-566.2 — the impact advisory rides the SUCCESS, after the seal is done:
|
|
502
529
|
// the verdict is already committed, so nothing here can change it (advisory, never gate —
|
|
@@ -13,7 +13,7 @@ export declare function createSpecAuthoringHandlers(context: SpecAuthoringContex
|
|
|
13
13
|
} | {
|
|
14
14
|
created: any;
|
|
15
15
|
ok?: undefined;
|
|
16
|
-
reason?: undefined;
|
|
16
|
+
readonly reason?: undefined;
|
|
17
17
|
}>;
|
|
18
18
|
/**
|
|
19
19
|
* @implements A-SPEC-184
|
|
@@ -52,6 +52,6 @@ export declare function createSpecAuthoringHandlers(context: SpecAuthoringContex
|
|
|
52
52
|
type: import("../../spec/spec-types").SpecType;
|
|
53
53
|
legacyStatus: string;
|
|
54
54
|
remaining: import("../../spec/validator").Finding[];
|
|
55
|
-
reason?: undefined;
|
|
55
|
+
readonly reason?: undefined;
|
|
56
56
|
}>;
|
|
57
57
|
};
|
|
@@ -116,8 +116,8 @@ function createSpecAuthoringHandlers(context) {
|
|
|
116
116
|
// `projectRootOf` below already expands Windows 8.3 aliases (it ends in `canonicalPath`,
|
|
117
117
|
// i.e. `realpathSync.native`); the JS `fs.realpathSync` that used to stand here does not.
|
|
118
118
|
// So the same directory arrived under two spellings and the containment test said "another
|
|
119
|
-
// project": measured 2026-09-19, `C:\Users\
|
|
120
|
-
// `C:\Users\
|
|
119
|
+
// project": measured 2026-09-19, `C:\Users\FIRSTL~1\…\probe83` was refused while
|
|
120
|
+
// `C:\Users\First Last\…\probe83` — the same directory — created. `change-source.ts`
|
|
121
121
|
// named this rule on 2026-08-23 after the identical failure; this is the same rule, here.
|
|
122
122
|
const real = (p2) => { try {
|
|
123
123
|
return (0, root_1.canonicalPath)(p2);
|
|
@@ -289,6 +289,23 @@ function createSpecAuthoringHandlers(context) {
|
|
|
289
289
|
e.message += spentNote;
|
|
290
290
|
throw e;
|
|
291
291
|
}
|
|
292
|
+
// @implements A-SPEC-792.28 — the tool's own record of what it wrote (the provenance a draft is staged on). Best
|
|
293
|
+
// effort: the spec is written; a ledger that cannot take the line leaves the draft unproven, never the act failed.
|
|
294
|
+
// Only into a ledger that already exists beside the store (`<root>/.ax/specs` and `<root>/.ax/ledger`): creating
|
|
295
|
+
// nothing keeps a reader footprint-free (A-SPEC-148) and a store outside .ax unledgered (as before).
|
|
296
|
+
try {
|
|
297
|
+
const specsRoot = store.specsRoot;
|
|
298
|
+
const axDir = typeof specsRoot === 'string' ? path.dirname(path.resolve(specsRoot)) : '';
|
|
299
|
+
const ledgerDir = path.join(axDir, 'ledger');
|
|
300
|
+
if (typeof specsRoot === 'string' && path.basename(path.resolve(specsRoot)) === 'specs' && path.basename(axDir) === '.ax'
|
|
301
|
+
&& fs.existsSync(ledgerDir) && fs.lstatSync(ledgerDir).isDirectory()) {
|
|
302
|
+
const { FileLedgerStore } = require('../../governance/ledger-store');
|
|
303
|
+
new FileLedgerStore(ledgerDir).append({
|
|
304
|
+
ts: new Date().toISOString(), actor: 'holmes-kit', kind: 'spec-created', summary: `created ${id}`, inputs: [id],
|
|
305
|
+
});
|
|
306
|
+
}
|
|
307
|
+
}
|
|
308
|
+
catch { /* the draft stays unproven for autonomous staging */ }
|
|
292
309
|
return { created: id };
|
|
293
310
|
},
|
|
294
311
|
/**
|
|
@@ -24,7 +24,12 @@ export interface SpecLifecycleContext {
|
|
|
24
24
|
why: string;
|
|
25
25
|
title?: string;
|
|
26
26
|
}): string;
|
|
27
|
+
fullAutonomyHome?(): string;
|
|
27
28
|
}
|
|
29
|
+
type Supersession = {
|
|
30
|
+
id: string;
|
|
31
|
+
supersededBy: string;
|
|
32
|
+
};
|
|
28
33
|
export declare function createSpecLifecycleHandlers(context: SpecLifecycleContext): {
|
|
29
34
|
/**
|
|
30
35
|
* Move a document to `outdated` — the only path there.
|
|
@@ -47,25 +52,10 @@ export declare function createSpecLifecycleHandlers(context: SpecLifecycleContex
|
|
|
47
52
|
root?: string;
|
|
48
53
|
id: string;
|
|
49
54
|
reason?: string;
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
id?: undefined;
|
|
55
|
-
dependents?: undefined;
|
|
56
|
-
} | {
|
|
57
|
-
ok: boolean;
|
|
58
|
-
retired: boolean;
|
|
59
|
-
id: string;
|
|
60
|
-
dependents: never[];
|
|
61
|
-
reason: string;
|
|
62
|
-
} | {
|
|
63
|
-
ok: boolean;
|
|
64
|
-
retired: boolean;
|
|
65
|
-
id: string;
|
|
66
|
-
dependents: string[];
|
|
67
|
-
reason?: undefined;
|
|
68
|
-
}>;
|
|
55
|
+
supersededBy?: string;
|
|
56
|
+
directive?: string;
|
|
57
|
+
also?: Supersession[];
|
|
58
|
+
}): Promise<Record<string, unknown>>;
|
|
69
59
|
/**
|
|
70
60
|
* @implements A-SPEC-700.2
|
|
71
61
|
* The plan a person SAW, executed under ONE approval, before the merge. `plan` reads; `apply`
|
|
@@ -117,23 +107,6 @@ export declare function createSpecLifecycleHandlers(context: SpecLifecycleContex
|
|
|
117
107
|
spec_unseal(a: {
|
|
118
108
|
root?: string;
|
|
119
109
|
id: string;
|
|
120
|
-
}): Promise<
|
|
121
|
-
ok: boolean;
|
|
122
|
-
reason: string;
|
|
123
|
-
unsealed?: undefined;
|
|
124
|
-
id?: undefined;
|
|
125
|
-
dependents?: undefined;
|
|
126
|
-
} | {
|
|
127
|
-
ok: boolean;
|
|
128
|
-
unsealed: boolean;
|
|
129
|
-
id: string;
|
|
130
|
-
dependents: never[];
|
|
131
|
-
reason: string;
|
|
132
|
-
} | {
|
|
133
|
-
ok: boolean;
|
|
134
|
-
unsealed: boolean;
|
|
135
|
-
id: string;
|
|
136
|
-
dependents: string[];
|
|
137
|
-
reason?: undefined;
|
|
138
|
-
}>;
|
|
110
|
+
}): Promise<Record<string, unknown>>;
|
|
139
111
|
};
|
|
112
|
+
export {};
|