@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
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { Spec } from '../spec/spec-parser';
|
|
2
2
|
import { PatchTarget } from '../guardrail/write-target';
|
|
3
3
|
import { Approval } from '../guardrail/risk-gate';
|
|
4
|
+
import { GrantSettlement, type GrantSettlementPending, type GrantSettlementResult } from '../governance/approval-grants';
|
|
4
5
|
import { RiskAction, RiskAssessment, RmSignal, StagedStoreSignal } from '../guardrail/risk-types';
|
|
5
6
|
import { type PreEditEvidenceMode } from '../guardrail/impact-gate';
|
|
6
7
|
export declare function resolveRmSignals(command: string, cwd: string, projectRoot?: string, specsDir?: string, scratchTmpdir?: string): Record<string, RmSignal> | undefined;
|
|
@@ -30,6 +31,20 @@ export declare function readApprovalFromEnv(): Approval | undefined;
|
|
|
30
31
|
* the empty word as its suffix. Words are read quote-aware; an operand that is only a glob or a variable still counts.
|
|
31
32
|
*/
|
|
32
33
|
export declare function sedInPlaceFiles(text: string): string[];
|
|
34
|
+
/**
|
|
35
|
+
* @implements A-SPEC-245.9 (1b-5, item 7) — `holmes-kit lock recover` retires a lock another process may hold: the
|
|
36
|
+
* operator's act. The CLI refuses it from an agent by the environment and the process ancestry, which a process
|
|
37
|
+
* reparented away from the harness escapes, so the gate refuses the command itself. A segment counts when its command
|
|
38
|
+
* word (after env, nohup, time, command, exec, builtin and NAME=value) runs the CLI — `holmes-kit`, `npx [-y]
|
|
39
|
+
* [@holmes-lab/]holmes-kit[@v]`, or `node <…/holmes/cli/index.js | …holmes-kit[.js]>` — and its next words are
|
|
40
|
+
* `lock recover`; a mention as an argument (echo, grep) is not the act.
|
|
41
|
+
*/
|
|
42
|
+
export declare function lockRecoverAct(command: string): boolean;
|
|
43
|
+
/**
|
|
44
|
+
* @implements A-SPEC-245.19 (item 2) — the advisory an allowed Bash command carries when its text names the act and
|
|
45
|
+
* hands it to something that runs text: the CLI will refuse it from a session.
|
|
46
|
+
*/
|
|
47
|
+
export declare function lockRecoverAdvisory(command: string): string | null;
|
|
33
48
|
/**
|
|
34
49
|
* @implements A-SPEC-732 (round 2) — the PreToolUse output. For `approval_commit` an unobjected call
|
|
35
50
|
* carries no decision: an `allow` would pre-empt the harness's own sensitive-tool confirmation, the
|
|
@@ -66,6 +81,58 @@ export declare function psShowsEnvironment(command: string): boolean;
|
|
|
66
81
|
* agent with a different authority, and that act is refused on its own. `--version`/`--help` alone is not a launch.
|
|
67
82
|
*/
|
|
68
83
|
export declare function agentCliLaunch(command: string): boolean;
|
|
84
|
+
/** The words of every segment that launches an agent CLI (A-SPEC-774.5 §1), quote-aware. */
|
|
85
|
+
/**
|
|
86
|
+
* @implements A-SPEC-774.26 — with each word, the quoted span it came from (-1: unquoted or mixed), so the option check
|
|
87
|
+
* can tell a quoted prompt (`-p "… cut -d= …"`) from options, and a quoted program (`tmux new -d 'claude …'`) from both.
|
|
88
|
+
*/
|
|
89
|
+
export declare function agentLaunchSegments(command: string, depth?: number, program?: {
|
|
90
|
+
test: (w: string) => boolean;
|
|
91
|
+
}): Array<{
|
|
92
|
+
words: string[];
|
|
93
|
+
spans: number[];
|
|
94
|
+
}>;
|
|
95
|
+
/** @implements A-SPEC-774.69 — a here-document: its body's place in the text, whether its delimiter was quoted, and its command's lead word. */
|
|
96
|
+
interface HereDoc {
|
|
97
|
+
bodyStart: number;
|
|
98
|
+
bodyEnd: number;
|
|
99
|
+
next: number;
|
|
100
|
+
quoted: boolean;
|
|
101
|
+
lead: string;
|
|
102
|
+
terminated: boolean;
|
|
103
|
+
}
|
|
104
|
+
/**
|
|
105
|
+
* @implements A-SPEC-774.75 — a here-document's delimiter word from `at` (after `<<`): read to a blank or `;&|<>()`, its
|
|
106
|
+
* quotes removed; any quoting makes the body quoted (`E"O"F` waits for `EOF`). Null when there is no word or a quote is
|
|
107
|
+
* left open before the newline.
|
|
108
|
+
*/
|
|
109
|
+
export declare function hereDocWord(text: string, at: number): {
|
|
110
|
+
delim: string;
|
|
111
|
+
quoted: boolean;
|
|
112
|
+
strip: boolean;
|
|
113
|
+
end: number;
|
|
114
|
+
} | null;
|
|
115
|
+
/** @implements A-SPEC-774.72 — what each character of a command is to the shell. */
|
|
116
|
+
declare const enum Ch {
|
|
117
|
+
Code = 0,
|
|
118
|
+
Single = 1,
|
|
119
|
+
Double = 2,
|
|
120
|
+
Ansi = 3,
|
|
121
|
+
Comment = 4,
|
|
122
|
+
Body = 5,
|
|
123
|
+
QuotedBody = 6,
|
|
124
|
+
Delim = 7,
|
|
125
|
+
Escape = 8
|
|
126
|
+
}
|
|
127
|
+
/**
|
|
128
|
+
* @implements A-SPEC-774.72 — the one quote state machine (F1.3-e, f): single quotes, double quotes, `$'…'` with its
|
|
129
|
+
* backslash escapes, a `#` comment from a word start to the newline, and here-document bodies after the newline that
|
|
130
|
+
* ends their `<<` line. The substitution scan, the here-document list and the segment lexer all read this.
|
|
131
|
+
*/
|
|
132
|
+
export declare function scanShell(command: string): {
|
|
133
|
+
kind: Ch[];
|
|
134
|
+
docs: HereDoc[];
|
|
135
|
+
};
|
|
69
136
|
export declare function dumpsEnvInCommandPosition(command: string, depth?: number): boolean;
|
|
70
137
|
/**
|
|
71
138
|
* Coerce a hook envelope into known shapes so a type surprise cannot become an exception.
|
|
@@ -143,6 +210,8 @@ export interface HookInput {
|
|
|
143
210
|
harness: 'codex' | 'antigravity';
|
|
144
211
|
};
|
|
145
212
|
}
|
|
213
|
+
/** Whether a text shows a marker once its quotes and backslashes are removed and its letters lowered. Substring tests only. */
|
|
214
|
+
export declare function patchMarked(text: string): boolean;
|
|
146
215
|
/**
|
|
147
216
|
* @implements A-SPEC-753.2 — what a denial leaves in the provenance ledger: the reason up to the operator command.
|
|
148
217
|
* The installer refusal (A-SPEC-753.1) carries the raw command after ` Operator: ` for the operator to run; the ledger
|
|
@@ -196,6 +265,7 @@ export declare function decideOnGateError(opts: {
|
|
|
196
265
|
}): {
|
|
197
266
|
permissionDecision: 'allow' | 'deny';
|
|
198
267
|
permissionDecisionReason?: string;
|
|
268
|
+
refusal?: string;
|
|
199
269
|
};
|
|
200
270
|
/**
|
|
201
271
|
* Is this project governed? Computed on the ERROR path, so it must not re-run the logic that just
|
|
@@ -243,7 +313,29 @@ export declare function gateErrorDecision(message: string, env?: NodeJS.ProcessE
|
|
|
243
313
|
export declare function wiredSpecsDir(argv: readonly string[], env: NodeJS.ProcessEnv): string;
|
|
244
314
|
/** Default spec root. Used to tell "never governed" apart from an explicitly configured HOLMES_SPECS. */
|
|
245
315
|
export declare const DEFAULT_SPECS_DIR = ".ax/specs";
|
|
246
|
-
export
|
|
316
|
+
export { anchorMoveOnly } from '../spec/succession-guard';
|
|
317
|
+
/**
|
|
318
|
+
* @implements A-SPEC-245.2 — the grants one judgement resolved, settled once at its final decision. Each branch that
|
|
319
|
+
* resolves a grant holds it here instead of spending it: an `.ax/roles` Write spent its grant at the roles branch and
|
|
320
|
+
* was then denied by the protected-directory branch, which resolved the same approval again and found it gone (one
|
|
321
|
+
* grant: denied and gone; two: allowed and both gone — measured).
|
|
322
|
+
*/
|
|
323
|
+
/**
|
|
324
|
+
* @implements A-SPEC-245.4 — the settlement is an explicit value in `opts`, settled once at the FINAL decision: the
|
|
325
|
+
* entry point creates it and settles it after the plan-scope, stage, role and run-refusal passes (each can still turn
|
|
326
|
+
* the allow into a deny, and a run-stage deny spent the grant of an act that never happened), and the counterfactual
|
|
327
|
+
* audit reading passes one that never spends. A caller that passes none is settled at this function's return.
|
|
328
|
+
*/
|
|
329
|
+
export declare function settleVerdict<V extends {
|
|
330
|
+
permissionDecision: 'allow' | 'deny';
|
|
331
|
+
permissionDecisionReason?: string;
|
|
332
|
+
}>(verdict: V, settlement: GrantSettlement): V;
|
|
333
|
+
/** @implements A-SPEC-245.9 (1b-2) — the main thread's half: settle the pending spends here and answer. */
|
|
334
|
+
export declare function settleOnMainThread(p: GrantSettlementPending): GrantSettlementResult;
|
|
335
|
+
/** @implements A-SPEC-245.4 (f) — the approval an audit line names: a grant this decision spent, else the counterfactual's environment approval. */
|
|
336
|
+
export declare function auditApprovalFor(envApproval: Approval | undefined, counterfactualDenied: boolean, settlement: GrantSettlement): Approval | undefined;
|
|
337
|
+
export declare function evaluateHook(...args: Parameters<typeof judgeHook>): ReturnType<typeof judgeHook>;
|
|
338
|
+
declare function judgeHook(input: {
|
|
247
339
|
tool_name: string;
|
|
248
340
|
tool_input: {
|
|
249
341
|
file_path?: string;
|
|
@@ -288,8 +380,20 @@ export declare function evaluateHook(input: {
|
|
|
288
380
|
onApprovalsSpent?: (approvals: Approval[]) => void;
|
|
289
381
|
/** @implements A-SPEC-792.5 — the home whose full autonomy profile applies (default os.homedir()); a test seam. */
|
|
290
382
|
home?: string;
|
|
383
|
+
/**
|
|
384
|
+
* @implements A-SPEC-792.32 — tests only: lifts the A-SPEC-792.31 safety stop so the autonomous spec recorder can be
|
|
385
|
+
* attacked. No environment variable, config or hook input sets it; the hook process never passes it.
|
|
386
|
+
*/
|
|
387
|
+
autonomySpecStaging?: boolean;
|
|
388
|
+
/** @implements A-SPEC-245.4 — where this judgement holds the grants it resolved; the caller settles it once. */
|
|
389
|
+
settlement?: GrantSettlement;
|
|
390
|
+
filed?: {
|
|
391
|
+
request?: string;
|
|
392
|
+
};
|
|
291
393
|
}): {
|
|
292
394
|
permissionDecision: 'allow' | 'deny';
|
|
293
395
|
permissionDecisionReason?: string;
|
|
396
|
+
refusal?: string;
|
|
397
|
+
request?: string;
|
|
294
398
|
};
|
|
295
399
|
export declare function readSpecsSync(root: string): Spec[];
|