@holmes-lab/holmes-kit 0.39.0 → 0.40.1
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 +578 -6
- package/README.md +120 -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 +226 -442
- package/dist/holmes/cli/init.js +33 -0
- package/dist/holmes/cli/interactive-prompt.d.ts +39 -2
- package/dist/holmes/cli/interactive-prompt.js +98 -16
- 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 +19 -0
- package/dist/holmes/config/config.js +18 -3
- 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 +12 -0
- package/dist/holmes/governance/autonomy.js +51 -15
- 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.d.ts +2 -0
- package/dist/holmes/governance/push-gate-runner.js +50 -9
- package/dist/holmes/governance/push-gate.d.ts +13 -2
- package/dist/holmes/governance/push-gate.js +106 -14
- 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/advisory-line.d.ts +102 -0
- package/dist/holmes/guardrail/advisory-line.js +718 -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 +7 -0
- package/dist/holmes/guardrail/impact-gate.js +33 -6
- 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 +116 -1
- package/dist/holmes/hooks/pre-tool-use.js +1176 -170
- 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/session-start.js +17 -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/maintenance-analysis.d.ts +13 -0
- package/dist/holmes/mcp/handlers/maintenance-analysis.js +59 -2
- 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 +471 -4
- package/dist/holmes/mcp/handlers/test-execution.js +199 -21
- package/dist/holmes/mcp/handlers/workspace-queries.d.ts +2 -2
- package/dist/holmes/mcp/handlers.d.ts +557 -82
- package/dist/holmes/mcp/handlers.js +74 -23
- 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 +6 -1
- package/dist/holmes/mcp/maintenance-analyze.js +13 -11
- package/dist/holmes/mcp/maintenance-evidence.d.ts +9 -0
- package/dist/holmes/mcp/maintenance-evidence.js +35 -3
- 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 +42 -9
- package/dist/holmes/project/act-root.d.ts +19 -0
- package/dist/holmes/project/act-root.js +100 -0
- package/dist/holmes/project/baseline.d.ts +15 -2
- package/dist/holmes/project/baseline.js +14 -8
- 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 +51 -2
- package/dist/holmes/project/bounded-io.js +140 -6
- package/dist/holmes/project/change-source.d.ts +4 -0
- package/dist/holmes/project/change-source.js +14 -6
- 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 +29 -8
- 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/evidence-mode.d.ts +21 -0
- package/dist/holmes/review/evidence-mode.js +33 -0
- package/dist/holmes/review/head-worktree.d.ts +55 -0
- package/dist/holmes/review/head-worktree.js +329 -0
- package/dist/holmes/review/hop-ablation.d.ts +4 -4
- package/dist/holmes/review/hop-ablation.js +5 -5
- package/dist/holmes/review/mrp.js +13 -3
- 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/run-provenance.d.ts +45 -0
- package/dist/holmes/review/run-provenance.js +314 -0
- package/dist/holmes/review/semantic-arm.d.ts +3 -3
- package/dist/holmes/review/semantic-arm.js +3 -3
- package/dist/holmes/review/test-evidence.d.ts +174 -0
- package/dist/holmes/review/test-evidence.js +330 -2
- package/dist/holmes/review/test-outcomes.js +3 -1
- package/dist/holmes/review/test-reports.d.ts +94 -0
- package/dist/holmes/review/test-reports.js +382 -0
- package/dist/holmes/review/test-runner.d.ts +180 -58
- package/dist/holmes/review/test-runner.js +560 -324
- package/dist/holmes/review/test-selection-breadth.js +2 -2
- package/dist/holmes/review/test-units.d.ts +159 -0
- package/dist/holmes/review/test-units.js +814 -0
- 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 +47 -34
- package/dist/holmes/review/manual-baseline.d.ts +0 -209
- package/dist/holmes/review/manual-baseline.js +0 -2847
|
@@ -34,22 +34,28 @@ var __importStar = (this && this.__importStar) || (function () {
|
|
|
34
34
|
})();
|
|
35
35
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
36
|
exports.DEFAULT_TTL_MINUTES = void 0;
|
|
37
|
+
exports.grantValidityText = grantValidityText;
|
|
37
38
|
exports.grantRequest = grantRequest;
|
|
39
|
+
exports.revokeCandidates = revokeCandidates;
|
|
38
40
|
exports.revokeGrant = revokeGrant;
|
|
41
|
+
exports.revokeWord = revokeWord;
|
|
39
42
|
exports.denyRequest = denyRequest;
|
|
40
43
|
exports.withdrawRequest = withdrawRequest;
|
|
41
44
|
exports.holdRequest = holdRequest;
|
|
42
45
|
exports.staleView = staleView;
|
|
46
|
+
exports.targetArg = targetArg;
|
|
43
47
|
exports.outsideInboxFooter = outsideInboxFooter;
|
|
48
|
+
exports.listedRequests = listedRequests;
|
|
44
49
|
exports.renderPending = renderPending;
|
|
45
50
|
exports.subjectCells = subjectCells;
|
|
46
51
|
exports.subjectRoom = subjectRoom;
|
|
47
52
|
exports.decisionSubject = decisionSubject;
|
|
48
53
|
exports.decisionDetail = decisionDetail;
|
|
54
|
+
exports.subjectDigest = subjectDigest;
|
|
49
55
|
exports.renderRefusals = renderRefusals;
|
|
50
56
|
exports.renderNonTtyHint = renderNonTtyHint;
|
|
51
57
|
exports.runInteractive = runInteractive;
|
|
52
|
-
// @implements A-SPEC-246, A-SPEC-
|
|
58
|
+
// @implements A-SPEC-794.55, A-SPEC-246, A-SPEC-794.30, A-SPEC-794.31, A-SPEC-794.32, A-SPEC-794.33, A-SPEC-794.34, A-SPEC-794.35, A-SPEC-794.37, A-SPEC-794.41,A-SPEC-626,A-SPEC-532.5, A-SPEC-770.3, A-SPEC-770.6, A-SPEC-770.12, A-SPEC-779.2, A-SPEC-792.2, A-SPEC-245.9, A-SPEC-245.15, A-SPEC-245.17
|
|
53
59
|
// @implements A-SPEC-549.4 — renderPending and renderNonTtyHint in this file are the English CLI
|
|
54
60
|
// surface the Hangul-absence guard reads.
|
|
55
61
|
const execution_context_1 = require("../project/execution-context");
|
|
@@ -61,6 +67,7 @@ const approval_queue_1 = require("../governance/approval-queue");
|
|
|
61
67
|
const screen_safe_1 = require("./screen-safe");
|
|
62
68
|
const approval_grants_1 = require("../governance/approval-grants");
|
|
63
69
|
const workspace_identity_1 = require("../project/workspace-identity");
|
|
70
|
+
const human_channel_1 = require("../governance/human-channel");
|
|
64
71
|
/**
|
|
65
72
|
* `holmes-kit approve` — the surface where a human decides.
|
|
66
73
|
*
|
|
@@ -140,7 +147,9 @@ const appendEvent = (root, event) => {
|
|
|
140
147
|
fs.mkdirSync(path.dirname(file), { recursive: true });
|
|
141
148
|
if (!isWritablePath(file))
|
|
142
149
|
return false;
|
|
143
|
-
|
|
150
|
+
// @implements A-SPEC-792.26 — the queue's decision seam: its actor is judged where it is written
|
|
151
|
+
const judged = 'actor' in event ? { ...event, actor: (0, human_channel_1.ledgerActor)(event.actor) } : event;
|
|
152
|
+
fs.appendFileSync(file, JSON.stringify({ ...judged, ts: new Date().toISOString(), ...(execution ? { execution } : {}) }) + '\n');
|
|
144
153
|
return true;
|
|
145
154
|
}
|
|
146
155
|
catch {
|
|
@@ -178,13 +187,22 @@ function recordIsSelfConsistent(entry) {
|
|
|
178
187
|
*/
|
|
179
188
|
function freshNonce(root, id) {
|
|
180
189
|
const { FileLedgerStore } = require('../governance/ledger-store');
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
190
|
+
// @implements A-SPEC-245.9 (H-2) — a revoked nonce is skipped as a spent one is: it never covers anything again
|
|
191
|
+
// @implements A-SPEC-794.5 — the walk is the one runtime-binding's "ever spent" uses (nonceWalk)
|
|
192
|
+
const { nonceWalk } = require('../governance/approval-spend');
|
|
193
|
+
return nonceWalk(new FileLedgerStore(path.join(root, '.ax', 'ledger')), id).fresh;
|
|
194
|
+
}
|
|
195
|
+
/**
|
|
196
|
+
* @implements A-SPEC-792.17 — what a decision line says about a grant's life: a grant without a time limit is spent by
|
|
197
|
+
* its first use (A-SPEC-532.5, 792.2), so it never shows the GRANT_NO_EXPIRY date as a validity period.
|
|
198
|
+
*/
|
|
199
|
+
function grantValidityText(expires) {
|
|
200
|
+
// @implements A-SPEC-245.9 (1b-6, item 8) — the use count and the expiry, as one phrase, for every grant
|
|
201
|
+
// @implements A-SPEC-245.17 (6c) — an empty expiry is no expiry a grant can carry: expired, it covers nothing
|
|
202
|
+
// @implements A-SPEC-245.18 (5c) — so is one that is not a date
|
|
203
|
+
if (expires === '' || (expires !== undefined && !Number.isFinite(Date.parse(expires))))
|
|
204
|
+
return 'expired — the grant carries no expiry it can be judged by, so it covers nothing';
|
|
205
|
+
return expires === approval_grants_1.GRANT_NO_EXPIRY || expires === undefined ? 'single use, no time limit — spent by its first use' : `single use, until ${expires}`;
|
|
188
206
|
}
|
|
189
207
|
function grantRequest(root, id, opts) {
|
|
190
208
|
const ttl = opts.ttlMinutes ?? exports.DEFAULT_TTL_MINUTES;
|
|
@@ -230,9 +248,13 @@ function grantRequest(root, id, opts) {
|
|
|
230
248
|
...(entry.subject ? { subject: entry.subject } : {}),
|
|
231
249
|
...(entry.execution?.runId ? { requestedBy: entry.execution.runId } : {}),
|
|
232
250
|
};
|
|
251
|
+
// @implements A-SPEC-792.27 — a person's grant keeps its provenance by structure: spending it records grant:<id>
|
|
252
|
+
// (which claims no person channel) and the grant names who decided; a plain string actor is written as judged text
|
|
253
|
+
const person = (0, human_channel_1.isMinted)(opts.actor);
|
|
233
254
|
const grant = {
|
|
234
255
|
...binding,
|
|
235
|
-
actor: opts.actor,
|
|
256
|
+
actor: person ? `grant:${id}` : (0, human_channel_1.ledgerActor)(opts.actor),
|
|
257
|
+
...(person ? { decidedBy: (0, human_channel_1.ledgerActor)(opts.actor) } : {}),
|
|
236
258
|
token: 'grant',
|
|
237
259
|
rationale: opts.rationale?.trim() ? opts.rationale : DEFAULT_RATIONALE,
|
|
238
260
|
// exact (round-14): the queue target is a LITERAL command the operator read on the decision
|
|
@@ -277,7 +299,9 @@ function grantRequest(root, id, opts) {
|
|
|
277
299
|
fs.renameSync(tmp, path.join(dir, `${id}.json`));
|
|
278
300
|
}
|
|
279
301
|
catch (e) {
|
|
280
|
-
|
|
302
|
+
// A-SPEC-794.32 — "run this again" failed: the record closed the request, so nothing was left to grant (P13). The
|
|
303
|
+
// grant cannot be used; the agent's next attempt is refused and files the request again, and that one is granted.
|
|
304
|
+
return { ok: false, reason: `could not move the grant file into place — the approval is recorded but cannot be used; the agent's next attempt files the request again, and that one can be granted\n ${(0, screen_safe_1.rowField)(e instanceof Error ? e.message : String(e), 76)}` };
|
|
281
305
|
}
|
|
282
306
|
return { ok: true, expires };
|
|
283
307
|
}
|
|
@@ -289,37 +313,154 @@ function grantRequest(root, id, opts) {
|
|
|
289
313
|
* granted here (nothing to withdraw). A grant already spent has no file; revoking it records the
|
|
290
314
|
* intent for the audit trail but cannot un-seal — the ledger is the record of what happened.
|
|
291
315
|
*/
|
|
316
|
+
const REQUEST_ID = /^req-[0-9a-f]{12}$/;
|
|
317
|
+
/**
|
|
318
|
+
* @implements A-SPEC-794.33 — what `--revoke` resolves against: the granted decisions and the ids the grant directory names,
|
|
319
|
+
* its claimed copies included (a grant whose row is torn, or whose file an act holds, still covers its act: A-1, A-2).
|
|
320
|
+
* A queue row's id counts only as a request id (a forged row's id is never a candidate: A-4). A-SPEC-794.35 — every grant
|
|
321
|
+
* file the store reads counts by its own name (`grantFileNames`), so a grant that covers its act is always revocable (A-M1).
|
|
322
|
+
*/
|
|
323
|
+
function revokeCandidates(root) {
|
|
324
|
+
const granted = Object.entries((0, approval_queue_1.readQueue)(root, { includeAllKinds: true }).decisions).filter(([, d]) => d.event === 'granted').map(([id]) => id)
|
|
325
|
+
.filter((id) => REQUEST_ID.test(id));
|
|
326
|
+
let files = [];
|
|
327
|
+
try {
|
|
328
|
+
files = fs.readdirSync(path.join(root, approval_grants_1.GRANTS_RELDIR)).map(approval_grants_1.grantFileIdOf).filter((n) => n !== null);
|
|
329
|
+
}
|
|
330
|
+
catch {
|
|
331
|
+
files = [];
|
|
332
|
+
}
|
|
333
|
+
return [...new Set([...granted, ...files])];
|
|
334
|
+
}
|
|
335
|
+
/** The grant files (claimed copies included) that are request `id`'s own: named for it, or naming it as request or nonce. */
|
|
336
|
+
function ownGrantFiles(root, id) {
|
|
337
|
+
const dir = path.join(root, approval_grants_1.GRANTS_RELDIR);
|
|
338
|
+
let names = [];
|
|
339
|
+
try {
|
|
340
|
+
names = fs.readdirSync(dir);
|
|
341
|
+
}
|
|
342
|
+
catch {
|
|
343
|
+
return [];
|
|
344
|
+
}
|
|
345
|
+
return names.filter((n) => {
|
|
346
|
+
if ((0, approval_grants_1.grantFileIdOf)(n) === id)
|
|
347
|
+
return true;
|
|
348
|
+
if (!n.endsWith('.json'))
|
|
349
|
+
return false;
|
|
350
|
+
try {
|
|
351
|
+
const g = JSON.parse(fs.readFileSync(path.join(dir, n), 'utf8'));
|
|
352
|
+
return (0, approval_grants_1.namesRequest)(g.request, id) || (0, approval_grants_1.namesRequest)(g.nonce, id);
|
|
353
|
+
}
|
|
354
|
+
catch {
|
|
355
|
+
return false;
|
|
356
|
+
}
|
|
357
|
+
}).map((n) => path.join(dir, n));
|
|
358
|
+
}
|
|
292
359
|
function revokeGrant(root, id, reason, actor) {
|
|
293
360
|
if (typeof reason !== 'string' || reason.trim() === '')
|
|
294
361
|
return { ok: false, reason: 'a revocation needs a --reason the agent can read' };
|
|
362
|
+
// @implements A-SPEC-794.33, A-SPEC-794.35 — only a candidate is revoked: a grant file's own name or a granted request
|
|
363
|
+
// id, never a forged row's id (`../x`, escapes) — membership, so every name the store reads is reachable and no other
|
|
364
|
+
if (!revokeCandidates(root).includes(id))
|
|
365
|
+
return { ok: false, reason: `no grant to revoke for ${(0, screen_safe_1.rowField)(id, 40)} — nothing was granted here` };
|
|
295
366
|
const decided = (0, approval_queue_1.readQueue)(root, { includeAllKinds: true }).decisions[id];
|
|
296
367
|
const dir = path.join(root, approval_grants_1.GRANTS_RELDIR);
|
|
297
|
-
|
|
368
|
+
// @implements A-SPEC-794.33 — a grant file that is a symbolic link is read as a grant, so it is revoked (as a link) too (A-3)
|
|
369
|
+
// @implements A-SPEC-245.4 (M3) — a grant an act holds claimed is revoked too: its claimed copy goes, so the act's
|
|
370
|
+
// release finds nothing to return and the revoked grant never comes back
|
|
371
|
+
const own = ownGrantFiles(root, id);
|
|
372
|
+
// @implements A-SPEC-245.9 (H-2) — under the spend lock: already spent (on the ledger, or a `consumed` queue event an
|
|
373
|
+
// older writer left), else the nonce-revoked row first, then the grant file and its claimed copies, then the queue event
|
|
374
|
+
// @implements A-SPEC-794.33 — a queue `consumed` row speaks only when no grant file is left: a development build's
|
|
375
|
+
// `consumed` beside a live file blocked revoking a grant that still covers its act (A-M1); the spend ledger decides
|
|
376
|
+
if (decided?.consumedTs && own.length === 0)
|
|
377
|
+
return { ok: false, reason: `the grant for ${(0, screen_safe_1.rowField)(id, 40)} is already spent — its act ran; nothing was revoked` };
|
|
378
|
+
const nonceOf = (file) => {
|
|
379
|
+
try {
|
|
380
|
+
const n = JSON.parse(fs.readFileSync(file, 'utf8')).nonce;
|
|
381
|
+
return typeof n === 'string' && n !== '' ? n : null;
|
|
382
|
+
}
|
|
383
|
+
catch {
|
|
384
|
+
return null;
|
|
385
|
+
}
|
|
386
|
+
};
|
|
387
|
+
// @implements A-SPEC-794.37 — every nonce its own files hold: a spent one does not stop the revocation of the next (A-M1)
|
|
388
|
+
const nonces = [...new Set(own.map(nonceOf).filter((n) => n !== null))];
|
|
389
|
+
if (nonces.length === 0)
|
|
390
|
+
nonces.push(id);
|
|
391
|
+
const spent = new Set();
|
|
298
392
|
try {
|
|
299
|
-
|
|
393
|
+
const { revokeNonce } = require('../governance/approval-spend');
|
|
394
|
+
for (const n of nonces)
|
|
395
|
+
if (revokeNonce(root, n, { actor, reason }) === 'spent')
|
|
396
|
+
spent.add(n);
|
|
300
397
|
}
|
|
301
|
-
catch {
|
|
302
|
-
|
|
398
|
+
catch (e) {
|
|
399
|
+
return { ok: false, reason: `the revocation could not take the spend lock in time — retry\n ${(0, screen_safe_1.rowField)(e instanceof Error ? e.message : String(e), 76)}` };
|
|
303
400
|
}
|
|
304
|
-
if (
|
|
305
|
-
return { ok: false, reason: `
|
|
306
|
-
|
|
401
|
+
if (spent.size === nonces.length)
|
|
402
|
+
return { ok: false, reason: `the grant for ${(0, screen_safe_1.rowField)(id, 40)} is already spent — its act ran; nothing was revoked` };
|
|
403
|
+
const goes = own.filter((f) => { const n = nonceOf(f); return n === null || !spent.has(n); });
|
|
404
|
+
for (const file of goes) {
|
|
307
405
|
try {
|
|
308
|
-
fs.rmSync(
|
|
406
|
+
fs.rmSync(file, { force: true });
|
|
309
407
|
}
|
|
310
408
|
catch (e) {
|
|
311
409
|
return { ok: false, reason: `could not remove the grant file:\n ${(0, screen_safe_1.rowField)(e instanceof Error ? e.message : String(e), 76)}` };
|
|
312
410
|
}
|
|
313
411
|
}
|
|
412
|
+
const removed = goes.length > 0;
|
|
314
413
|
if (!appendEvent(root, { event: 'revoked', id, reason, actor })) {
|
|
315
|
-
return { ok: false, reason:
|
|
414
|
+
return { ok: false, reason: removed
|
|
316
415
|
? 'the grant file is gone but the revocation could not be recorded (queue event) — check write permission on .ax/approvals'
|
|
317
416
|
: 'could not write the revocation record (queue event) — check write permission on .ax/approvals. Nothing was recorded' };
|
|
318
417
|
}
|
|
319
|
-
|
|
418
|
+
// @implements A-SPEC-794.37 — asked again after the removal: while a grant still covers the act this is no withdrawal
|
|
419
|
+
const after = (0, approval_grants_1.requestGrantState)(root, id, subjectOf(root, id), new Date().toISOString());
|
|
420
|
+
if (after.state === 'covers') {
|
|
421
|
+
return { ok: false, reason: `grant ${(0, screen_safe_1.rowField)(after.grant, 40)} still covers this act — revoke it too: ${revokeWordOf(after.grant)} --reason <text>${removed ? `\n removed: ${goes.map((f) => (0, screen_safe_1.rowField)(path.basename(f), 40)).join(', ')}` : ''}` };
|
|
422
|
+
}
|
|
423
|
+
// @implements A-SPEC-794.35, A-SPEC-794.37 — what else this reached is named, so a person's own copy does not die unannounced
|
|
424
|
+
const alsoRemoved = goes.map((f) => path.basename(f)).filter((n) => n !== `${id}.json`);
|
|
425
|
+
const stillHeld = (0, approval_grants_1.grantFileNames)(root).filter((n) => { const h = nonceOf(path.join(dir, n)); return h !== null && nonces.includes(h) && !spent.has(h); });
|
|
426
|
+
const notes = [...(alsoRemoved.length > 0 ? [`also removed: ${alsoRemoved.map((n) => (0, screen_safe_1.rowField)(n, 40)).join(', ')}`] : []),
|
|
427
|
+
...(stillHeld.length > 0 ? [`left holding the revoked nonce, so covering nothing: ${stillHeld.map((n) => (0, screen_safe_1.rowField)(n, 40)).join(', ')}`] : [])];
|
|
428
|
+
return notes.length > 0 ? { ok: true, note: notes.join('; ') } : { ok: true };
|
|
429
|
+
}
|
|
430
|
+
const subjectOf = (root, id) => (0, approval_queue_1.readQueue)(root, { includeAllKinds: true }).subjects?.[id];
|
|
431
|
+
const revokeWordOf = (file) => revokeWord(file.replace(/\.json$/, ''));
|
|
432
|
+
/**
|
|
433
|
+
* @implements A-SPEC-794.37 — the `--revoke=` word for a grant file's name, safe to paste into a POSIX shell: plain as it
|
|
434
|
+
* is, single-quoted otherwise, and with a control character through `printf` so that none reaches the screen raw.
|
|
435
|
+
*/
|
|
436
|
+
function revokeWord(name) {
|
|
437
|
+
// the flag parser refuses a value of blanks, so a blank name goes by its file name
|
|
438
|
+
if (name.trim() === '')
|
|
439
|
+
return `--revoke='${name}.json'`;
|
|
440
|
+
if (/^[A-Za-z0-9_][A-Za-z0-9_.-]*$/.test(name))
|
|
441
|
+
return `--revoke=${name}`;
|
|
442
|
+
// eslint-disable-next-line no-control-regex
|
|
443
|
+
if (/[\x00-\x1f\x7f]/.test(name)) {
|
|
444
|
+
const octal = [...Buffer.from(name)].map((b) => `\\0${b.toString(8).padStart(3, '0')}`).join('');
|
|
445
|
+
return `--revoke="$(printf '%b' '${octal}')"`;
|
|
446
|
+
}
|
|
447
|
+
return `--revoke='${name.replace(/'/g, `'\\''`)}'`;
|
|
320
448
|
}
|
|
449
|
+
/**
|
|
450
|
+
* @implements A-SPEC-794.33 — a request a person may close: a pending or refusal-log one, or one a development build filed
|
|
451
|
+
* (L3). A development record is rebuilt from its latest row and must still derive its own id; a grant never takes this
|
|
452
|
+
* path (0.40.0 grants no development request), so its closing row is a denial or a withdrawal, never a grant.
|
|
453
|
+
*/
|
|
454
|
+
const closable = (root, id) => {
|
|
455
|
+
const { entry, state } = findPending(root, id);
|
|
456
|
+
if (entry)
|
|
457
|
+
return entry;
|
|
458
|
+
const dev = state.devFiled?.[id];
|
|
459
|
+
return dev ? { id, kind: dev.kind, target: dev.target, why: '', count: 1, firstTs: '', lastTs: '',
|
|
460
|
+
...(dev.requesterRun ? { requesterRun: dev.requesterRun } : {}), ...(dev.requesterServer ? { requesterServer: dev.requesterServer } : {}) } : undefined;
|
|
461
|
+
};
|
|
321
462
|
function denyRequest(root, id, reason, actor) {
|
|
322
|
-
const
|
|
463
|
+
const entry = closable(root, id);
|
|
323
464
|
if (!entry)
|
|
324
465
|
return { ok: false, reason: `no pending request ${(0, screen_safe_1.rowField)(id, 40)}` };
|
|
325
466
|
// @implements A-SPEC-262.1 — round-4: the derivation gate guarded grant only, so a tampered record
|
|
@@ -343,7 +484,7 @@ function denyRequest(root, id, reason, actor) {
|
|
|
343
484
|
function withdrawRequest(root, id, reason, ctx) {
|
|
344
485
|
if (reason.trim() === '')
|
|
345
486
|
return { ok: false, reason: 'a withdrawal needs --reason — it is what the operator reads in place of a decision' };
|
|
346
|
-
const
|
|
487
|
+
const entry = closable(root, id);
|
|
347
488
|
if (!entry)
|
|
348
489
|
return { ok: false, reason: `no pending request ${(0, screen_safe_1.rowField)(id, 40)}` };
|
|
349
490
|
if (!recordIsSelfConsistent(entry))
|
|
@@ -352,7 +493,7 @@ function withdrawRequest(root, id, reason, ctx) {
|
|
|
352
493
|
// request otherwise had no requester, and the operator approved nine abandoned ones (2026-10-23).
|
|
353
494
|
if (entry.requesterServer !== undefined) {
|
|
354
495
|
if (ctx.server !== entry.requesterServer) {
|
|
355
|
-
return { ok: false, reason: `only the session whose MCP server filed ${(0, screen_safe_1.rowField)(id, 40)} withdraws it: filed by server ${(0, screen_safe_1.rowField)(entry.requesterServer, 60)}; this is ${ctx.server ? `server ${(0, screen_safe_1.rowField)(ctx.server, 60)}` : 'not that server'}` };
|
|
496
|
+
return { ok: false, reason: `only the session whose MCP server filed ${(0, screen_safe_1.rowField)(id, 40)} withdraws it: filed by server ${(0, screen_safe_1.rowField)(entry.requesterServer, 60)}; this is ${ctx.server ? `server ${(0, screen_safe_1.rowField)(ctx.server, 60)}` : 'not that server'} — if that session is gone, the operator denies it` }; // A-SPEC-794.41 (D8)
|
|
356
497
|
}
|
|
357
498
|
if (!appendEvent(root, { event: 'withdrawn', id, reason: reason.trim(), server: ctx.server, covered: entry.count })) {
|
|
358
499
|
return { ok: false, reason: 'could not write the withdrawal record (queue event) — check write permission on .ax/approvals. Nothing was recorded' };
|
|
@@ -401,11 +542,34 @@ function holdRequest(root, id, question, actor) {
|
|
|
401
542
|
*/
|
|
402
543
|
function staleView(flags) {
|
|
403
544
|
const raw = flags['stale-hours'];
|
|
545
|
+
// @implements A-SPEC-794.33 — a value that is not a finite number ≥ 0 is refused: `abc`, `-1` and `Infinity` turned the
|
|
546
|
+
// fold off without a word, and the screens then disagreed about what was listed (A-H2)
|
|
547
|
+
if (raw !== undefined && (typeof raw !== 'string' || !/^\s*\d+(?:\.\d+)?\s*$/.test(raw))) {
|
|
548
|
+
return { refusal: `--stale-hours expects a number of hours ≥ 0 (0 turns the fold off) — received: ${(0, screen_safe_1.rowField)(String(raw), 20)}` };
|
|
549
|
+
}
|
|
404
550
|
const hours = typeof raw === 'string' ? Number(raw) : 24;
|
|
405
|
-
|
|
551
|
+
// A-SPEC-794.34 — a value of 400 digits is Infinity as a number, which turned the fold off as `abc` once did (A-1)
|
|
552
|
+
if (!Number.isFinite(hours))
|
|
553
|
+
return { refusal: `--stale-hours expects a finite number of hours — received: ${(0, screen_safe_1.rowField)(String(raw), 20)}` };
|
|
554
|
+
if (hours === 0)
|
|
406
555
|
return null;
|
|
407
556
|
return { ttlMs: hours * 3_600_000, showAll: flags.all === true };
|
|
408
557
|
}
|
|
558
|
+
/**
|
|
559
|
+
* @implements A-SPEC-794.33 — the one spelling of `--target <root>` on a line made to be pasted (A-M5). Measured: a root
|
|
560
|
+
* named `/tmp/a;touch PWN1` ran `touch` in /bin/sh, because only white space was quoted. A root of plain path characters
|
|
561
|
+
* is printed bare; any other is POSIX single-quoted (PowerShell-literal on win32), so no byte of it is shell syntax. A
|
|
562
|
+
* root holding a control character is not printed: flattened, it would name another directory.
|
|
563
|
+
*/
|
|
564
|
+
function targetArg(root, platform = process.platform) {
|
|
565
|
+
if (root === undefined)
|
|
566
|
+
return '';
|
|
567
|
+
if (/[\u0000-\u001f\u007f-\u009f]/.test(root))
|
|
568
|
+
return ' --target <this project\'s root>';
|
|
569
|
+
if (/^[A-Za-z0-9_.:@/+-]+$/.test(root))
|
|
570
|
+
return ` --target ${root}`;
|
|
571
|
+
return ` --target ${platform === 'win32' ? (0, npx_bin_1.powershellLiteral)(root) : (0, npx_bin_1.posixLiteral)(root)}`;
|
|
572
|
+
}
|
|
409
573
|
/**
|
|
410
574
|
* @implements A-SPEC-770 — the one line an inbox screen ends with when this machine's refusal log holds open requests
|
|
411
575
|
* the screen does not list (A-SPEC-563.1 keeps gate refusals out of the inbox; A-SPEC-563.2 / A-SPEC-690 let
|
|
@@ -417,15 +581,36 @@ function outsideInboxFooter(outside, root) {
|
|
|
417
581
|
return null;
|
|
418
582
|
// @implements A-SPEC-770.2 — the commands name the workspace this screen read, so a line pasted elsewhere resolves
|
|
419
583
|
// the id against the right store (measured 2026-10-13: the hint reached the operator without any `--target`).
|
|
420
|
-
const target = root
|
|
584
|
+
const target = targetArg(root); // A-SPEC-794.33 — one quoting for every pasted line
|
|
421
585
|
// `◆` rather than the `◇` the spec sketched: §13 (approve-corpus) admits only the template's own glyphs on a decision
|
|
422
586
|
// row, and U+25C7 is of ambiguous width while U+25C6 is already furniture of this screen.
|
|
423
587
|
return `◆ ${outside} refusal(s) on this machine are outside this inbox (shell/gate refusals) — list them: ${(0, npx_bin_1.holmesKitCommand)(root)} approve --refusals${target} · grant one: ${(0, npx_bin_1.holmesKitCommand)(root)} approve --grant <id>${target}`;
|
|
424
588
|
}
|
|
589
|
+
/**
|
|
590
|
+
* @implements A-SPEC-507.1 — the LIST VIEW folds stale entries (C4: 51 rows, mostly week-old residue, buried the one live
|
|
591
|
+
* approval at [32]); the fold is the caller's `readQueue(root, { now, ttlMs })`.
|
|
592
|
+
* @implements A-SPEC-794.30 (the repair 794.10 made, re-ported) — the one order of the list and of a list number.
|
|
593
|
+
* @implements A-SPEC-794.32 — that order is the filing order, the view or not: newest activity first let a request filed
|
|
594
|
+
* after the list take [1], and `--grant 1` granted what no one had read (P2). A new filing is appended at the end.
|
|
595
|
+
*/
|
|
596
|
+
function listedRequests(state, _view) {
|
|
597
|
+
return state.pending;
|
|
598
|
+
}
|
|
425
599
|
function renderPending(state, view, outside, root) {
|
|
426
600
|
const withFooter = (lines) => {
|
|
427
|
-
|
|
428
|
-
|
|
601
|
+
// @implements A-SPEC-794.31 — development-build requests are named, never listed
|
|
602
|
+
const footers = [(0, approval_queue_1.devFiledNote)(state), outsideInboxFooter(outside, root)].filter((f) => f !== null);
|
|
603
|
+
return [...lines, ...footers].join('\n');
|
|
604
|
+
};
|
|
605
|
+
// A-SPEC-507.1 — the folded entries, named under any list: A-SPEC-794.32 — a queue of stale entries only printed no
|
|
606
|
+
// count of them, and `--all` (accepted again) shows them
|
|
607
|
+
const folded = () => {
|
|
608
|
+
if (!view || state.expired.length === 0)
|
|
609
|
+
return [];
|
|
610
|
+
if (!view.showAll)
|
|
611
|
+
return [`⏳ ${state.expired.length} folded as idle (no activity for over ${view.staleHours}h, still pending) — show with --all`]; // A-SPEC-794.41 (D10)
|
|
612
|
+
// Folding is not concealment: --all shows every expired entry under a template-owned prefix.
|
|
613
|
+
return state.expired.flatMap((p) => [`[idle] ${subjectCells('[idle] ', p)}`, ` last activity: ${(0, screen_safe_1.rowField)(p.lastTs, 28)} · id: ${(0, screen_safe_1.rowField)(p.id, 40)}`, '']);
|
|
429
614
|
};
|
|
430
615
|
if (state.pending.length === 0) {
|
|
431
616
|
// Round-7: this early return made the malformed-line row below UNREACHABLE in exactly the case
|
|
@@ -433,19 +618,13 @@ function renderPending(state, view, outside, root) {
|
|
|
433
618
|
// what an agent would see after destroying it. approval-queue.ts promises the opposite:
|
|
434
619
|
// "an empty-looking queue must be distinguishable from a corrupted one".
|
|
435
620
|
if (state.malformedLines > 0) {
|
|
436
|
-
return withFooter(['No requests awaiting approval.',
|
|
621
|
+
return withFooter(['No requests awaiting approval.', ...folded(),
|
|
437
622
|
`(${state.malformedLines} unreadable line(s) in the queue — check for corruption)`]);
|
|
438
623
|
}
|
|
439
|
-
return withFooter(['No requests awaiting approval.']);
|
|
624
|
+
return withFooter(['No requests awaiting approval.', ...folded()]);
|
|
440
625
|
}
|
|
441
626
|
const lines = [`◆ ${state.pending.length} request(s) awaiting approval`, ''];
|
|
442
|
-
|
|
443
|
-
// (C4: 51 rows, mostly week-old residue, buried the one live approval at [32]). Only when a view
|
|
444
|
-
// is passed: callers without one keep the legacy insertion order byte-for-byte.
|
|
445
|
-
const shown = view
|
|
446
|
-
? [...state.pending].sort((a, b) => (Date.parse(b.lastTs) || 0) - (Date.parse(a.lastTs) || 0))
|
|
447
|
-
: state.pending;
|
|
448
|
-
shown.forEach((p, i) => {
|
|
627
|
+
listedRequests(state, view).forEach((p, i) => {
|
|
449
628
|
// @implements A-SPEC-262.1 — every field here is AGENT-CONTROLLED (the target is the command it
|
|
450
629
|
// was blocked on). Round-1 forged two extra rows and hid the real ones behind an ANSI conceal,
|
|
451
630
|
// and the operator granted a `curl … | sh` they never saw. The template owns the line structure.
|
|
@@ -461,22 +640,11 @@ function renderPending(state, view, outside, root) {
|
|
|
461
640
|
lines.push(` blocked ${p.count}x${since}${p.hold ? ' (on hold)' : ''}`);
|
|
462
641
|
if (p.hold)
|
|
463
642
|
lines.push(` question: ${(0, screen_safe_1.rowField)(p.question ?? '(no question)', screen_safe_1.ROW_COLS)}`);
|
|
464
|
-
|
|
643
|
+
// A-SPEC-794.34 — the subject digest the id carries now, so the operator reads it before deciding (A-M1)
|
|
644
|
+
lines.push(` id: ${(0, screen_safe_1.rowField)(p.id, 40)}${subjectDigest(p) ? ` · subject ${subjectDigest(p)}` : ''}`);
|
|
465
645
|
lines.push('');
|
|
466
646
|
});
|
|
467
|
-
|
|
468
|
-
if (view.showAll) {
|
|
469
|
-
// Folding is not concealment: --all shows every expired entry under a template-owned prefix.
|
|
470
|
-
for (const p of state.expired) {
|
|
471
|
-
lines.push(`[expired] ${subjectCells('[expired] ', p)}`);
|
|
472
|
-
lines.push(` last activity: ${(0, screen_safe_1.rowField)(p.lastTs, 28)} · id: ${(0, screen_safe_1.rowField)(p.id, 40)}`);
|
|
473
|
-
lines.push('');
|
|
474
|
-
}
|
|
475
|
-
}
|
|
476
|
-
else {
|
|
477
|
-
lines.push(`⏳ ${state.expired.length} folded as expired (no activity for over ${view.staleHours}h) — show with --all`);
|
|
478
|
-
}
|
|
479
|
-
}
|
|
647
|
+
lines.push(...folded());
|
|
480
648
|
if (state.malformedLines > 0)
|
|
481
649
|
lines.push(`(${state.malformedLines} unreadable line(s) in the queue — check for corruption)`);
|
|
482
650
|
return withFooter(lines);
|
|
@@ -531,7 +699,15 @@ function decisionSubject(p, prefix = '\u2713 approved \u2014 ') {
|
|
|
531
699
|
* grant is keyed by.
|
|
532
700
|
*/
|
|
533
701
|
function decisionDetail(p, tail = '') {
|
|
534
|
-
|
|
702
|
+
// @implements A-SPEC-794.34 \u2014 and, on a row of its own, the subject the id carries now: a re-filing may carry another one
|
|
703
|
+
// (A-M1). `--list` names it on the id row too (A-SPEC-650's "no detail on the list" amended by 794.34, kept by 794.35:
|
|
704
|
+
// twelve hex digits the operator reads before deciding), and `--status` shows it in full context.
|
|
705
|
+
const subject = subjectDigest(p);
|
|
706
|
+
return ` ${(0, screen_safe_1.rowField)(p.id, 20)}${tail === '' ? '' : ` \u00b7 ${(0, screen_safe_1.rowField)(tail, 40)}`}${subject ? `\n subject ${subject}` : ''}`;
|
|
707
|
+
}
|
|
708
|
+
/** @implements A-SPEC-794.34 \u2014 the 12 hex digits a screen shows of a request's subject digest, or '' when it has none. */
|
|
709
|
+
function subjectDigest(p) {
|
|
710
|
+
return typeof p.subject === 'string' && /^sha256:[0-9a-f]{64}$/.test(p.subject) ? p.subject.slice(7, 19) : '';
|
|
535
711
|
}
|
|
536
712
|
/**
|
|
537
713
|
* The non-TTY fallback's next-command hint. Pure.
|
|
@@ -550,28 +726,33 @@ function decisionDetail(p, tail = '') {
|
|
|
550
726
|
* and this renderer is the reason an operator can find the id the deny message named. Row width
|
|
551
727
|
* follows the decision list's screen-safe discipline.
|
|
552
728
|
*/
|
|
553
|
-
function renderRefusals(refusals, limit = 20, root) {
|
|
729
|
+
function renderRefusals(refusals, limit = 20, root, open) {
|
|
554
730
|
if (refusals.length === 0)
|
|
555
731
|
return '◆ no refusals recorded on this machine';
|
|
556
732
|
const recent = refusals.slice(-Math.max(1, limit));
|
|
557
|
-
|
|
733
|
+
// @implements A-SPEC-794.55 — the log keeps every refusal; the open ones are what the --list footer counts
|
|
734
|
+
const openNote = open === undefined ? '' : `, ${open} still open (the --list footer's count)`;
|
|
735
|
+
const lines = [`◆ ${refusals.length} refusal(s) recorded on this machine${openNote} — showing ${recent.length} (newest last)`, ''];
|
|
558
736
|
for (const r of recent) {
|
|
559
737
|
lines.push(`${(0, screen_safe_1.rowField)(r.id, 20)} ${(0, screen_safe_1.rowField)(r.kind, screen_safe_1.KIND_COLS)} ${(0, screen_safe_1.rowField)(r.target, 40)}`);
|
|
560
738
|
lines.push(` \u2502 ${(0, screen_safe_1.rowField)(r.why, 66)} ${(0, screen_safe_1.rowField)(r.ts, 24)}`);
|
|
561
739
|
}
|
|
562
740
|
// @implements A-SPEC-770.1 — `--grant <id>`: the positional form this line named since 2026-09-06 is refused.
|
|
563
741
|
// @implements A-SPEC-770.2 — and the workspace whose log this screen read, when the caller knows it.
|
|
564
|
-
const target =
|
|
742
|
+
const target = targetArg(root); // A-SPEC-794.33
|
|
565
743
|
lines.push('', `decide one: ${(0, npx_bin_1.holmesKitCommand)(root)} approve --grant <id>${target}`);
|
|
566
744
|
return lines.join('\n');
|
|
567
745
|
}
|
|
568
|
-
function renderNonTtyHint(state) {
|
|
746
|
+
function renderNonTtyHint(state, root) {
|
|
569
747
|
if (state.pending.length === 0)
|
|
570
748
|
return '';
|
|
749
|
+
// @implements A-SPEC-794.32 — every command names the workspace the hint read: pasted in another directory, a bare
|
|
750
|
+
// command decided that directory's request (Q2). A-SPEC-794.33 — quoted by targetArg, so pasting it runs nothing (A-M5).
|
|
751
|
+
const target = targetArg(root);
|
|
571
752
|
// @implements A-SPEC-262.1 — round-2: the id is AGENT-CONTROLLED (foldQueue takes it verbatim and
|
|
572
753
|
// .ax/approvals has no write gate), and these three lines exist to be COPIED INTO A SHELL. A
|
|
573
754
|
// crafted id carrying a concealed `curl … | sh` rode into the operator's clipboard invisibly.
|
|
574
|
-
// Flattened, so what is pasted is what is read.
|
|
755
|
+
// Flattened, so what is pasted is what is read. A-SPEC-794.33 — no list number is offered: decisions take the id.
|
|
575
756
|
const p = state.pending[0];
|
|
576
757
|
// Flattened so it cannot forge a line, then SHELL-QUOTED so pasting it cannot run anything: this
|
|
577
758
|
// block exists to be copied into a shell, and the id is agent-controlled (round-2).
|
|
@@ -593,11 +774,10 @@ function renderNonTtyHint(state) {
|
|
|
593
774
|
const id = `${(0, screen_safe_1.safeRef)((0, screen_safe_1.rowField)(p.id, 40))}${wellFormed ? '' : ' # forged id — cannot decide'}`;
|
|
594
775
|
return [
|
|
595
776
|
'Interactive decisions work only in a TTY.',
|
|
596
|
-
'In this shell,
|
|
597
|
-
|
|
598
|
-
` holmes-kit approve --
|
|
599
|
-
` holmes-kit approve --
|
|
600
|
-
` holmes-kit approve --ask ${id} --question "<question>"`,
|
|
777
|
+
'In this shell, decide by id (a list number is refused):',
|
|
778
|
+
` holmes-kit approve --grant ${id}${target}`,
|
|
779
|
+
` holmes-kit approve --deny ${id} --reason "<reason>"${target}`,
|
|
780
|
+
` holmes-kit approve --ask ${id} --question "<question>"${target}`,
|
|
601
781
|
].join('\n');
|
|
602
782
|
}
|
|
603
783
|
/**
|
|
@@ -614,9 +794,11 @@ function renderNonTtyHint(state) {
|
|
|
614
794
|
* (REQ-262 Constraints: nothing is approved unseen). `[d]` still demands a reason, because an
|
|
615
795
|
* unreasoned denial is invisible to the agent; `[q]` holds with a question; `[s]` leaves it.
|
|
616
796
|
*/
|
|
617
|
-
async function runInteractive(root, io, actor) {
|
|
618
|
-
|
|
619
|
-
|
|
797
|
+
async function runInteractive(root, io, actor, stale) {
|
|
798
|
+
// @implements A-SPEC-794.33 — the screen folds as --list does (A-H2): an item idle past the window is counted, not presented
|
|
799
|
+
const state = (0, approval_queue_1.readQueue)(root, stale ? { now: Date.now(), ttlMs: stale.ttlMs } : undefined);
|
|
800
|
+
const view = stale ? { staleHours: stale.ttlMs / 3_600_000, showAll: stale.showAll } : undefined;
|
|
801
|
+
io.print(renderPending(state, view, (0, approval_queue_1.refusalsOutsideInbox)(root), root)); // @implements A-SPEC-770, A-SPEC-770.2
|
|
620
802
|
if (state.pending.length === 0)
|
|
621
803
|
return;
|
|
622
804
|
const grantDefault = (p) => {
|
|
@@ -626,7 +808,7 @@ async function runInteractive(root, io, actor) {
|
|
|
626
808
|
return false;
|
|
627
809
|
}
|
|
628
810
|
io.print(`\u2713 approved \u2014 ${decisionSubject(p, '\u2713 approved \u2014 ')}`);
|
|
629
|
-
io.print(decisionDetail(p,
|
|
811
|
+
io.print(decisionDetail(p, grantValidityText(r.expires)));
|
|
630
812
|
return true;
|
|
631
813
|
};
|
|
632
814
|
const queue = [...state.pending];
|
|
@@ -722,7 +904,7 @@ async function runInteractive(root, io, actor) {
|
|
|
722
904
|
continue;
|
|
723
905
|
}
|
|
724
906
|
io.print(`\u2713 approved \u2014 ${decisionSubject(p, '\u2713 approved \u2014 ')}`);
|
|
725
|
-
io.print(decisionDetail(p,
|
|
907
|
+
io.print(decisionDetail(p, grantValidityText(r.expires)));
|
|
726
908
|
}
|
|
727
909
|
else if (answer === 'v') {
|
|
728
910
|
const { renderDecisionContext } = require('./approve-context');
|
|
@@ -60,7 +60,8 @@ exports.BADGE_REL = path.join('.ax', 'badges', 'traced.svg');
|
|
|
60
60
|
const SPECS_REL = path.join('.ax', 'specs');
|
|
61
61
|
const git = (root, args) => {
|
|
62
62
|
try {
|
|
63
|
-
|
|
63
|
+
// @implements A-SPEC-792.39 — the shared inert git environment (its work-tree status ran the repository's fsmonitor).
|
|
64
|
+
return (0, node_child_process_1.execFileSync)('git', ['-C', root, ...args], { maxBuffer: bounded_io_1.GIT_MAX_BUFFER, timeout: 5000, stdio: ['ignore', 'pipe', 'ignore'], env: (0, bounded_io_1.gitEnv)((0, root_1.cleanSubprocessEnv)(process.env)) }).toString('utf8');
|
|
64
65
|
}
|
|
65
66
|
catch {
|
|
66
67
|
return undefined;
|
|
@@ -12,6 +12,8 @@ export interface AutonomyIO {
|
|
|
12
12
|
home?: string;
|
|
13
13
|
/** Internal: `status` without the full-profile line (the posture line it is followed by). */
|
|
14
14
|
postureOnly?: boolean;
|
|
15
|
+
/** @implements A-SPEC-245.9 (1b-1) — called once by `on`, after every refusal and before the marker is written; a throw writes nothing. */
|
|
16
|
+
beforeWrite?: () => void;
|
|
15
17
|
}
|
|
16
18
|
/** @implements A-SPEC-771 — the delegation subcommand's own inputs, parsed by the CLI entry and passed through. */
|
|
17
19
|
export interface AutonomyExtra {
|
|
@@ -89,9 +91,10 @@ export declare function runAutonomyFull(home: string, args: {
|
|
|
89
91
|
}, io: {
|
|
90
92
|
now: string;
|
|
91
93
|
actor: string;
|
|
94
|
+
beforeWrite?: () => void;
|
|
92
95
|
}): AutonomyResult;
|
|
93
96
|
/** @implements A-SPEC-718.7 — the posture `autonomy status` reports, never coloured by the caller's own environment. */
|
|
94
|
-
export declare function autonomyPostureLine(root: string, now: string): string;
|
|
97
|
+
export declare function autonomyPostureLine(root: string, now: string, postureOnly?: boolean): string;
|
|
95
98
|
/**
|
|
96
99
|
* The `holmes-kit autonomy status|on|off|delegate|revoke-delegation` core. Pure over injected io (clock/TTY/approval/
|
|
97
100
|
* env) so every branch is testable. Enabling (`on`) and delegating are protected exactly like `init --autonomy`: the
|