@holmes-lab/holmes-kit 0.29.0 → 0.31.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 +556 -0
- package/README.md +15 -5
- package/bin/holmes-hook-antigravity.js +4 -0
- package/bin/holmes-kit.js +4 -0
- package/bin/holmes-pre-push.js +3 -0
- package/bin/holmes-stop-antigravity.js +4 -0
- package/dist/.build-id +1 -1
- package/dist/holmes/cli/agents-guidance-history.d.ts +1 -1
- package/dist/holmes/cli/agents-guidance-history.js +11 -2
- package/dist/holmes/cli/agents-guidance.d.ts +1 -0
- package/dist/holmes/cli/agents-guidance.js +11 -8
- package/dist/holmes/cli/agents.d.ts +41 -0
- package/dist/holmes/cli/agents.js +382 -2
- package/dist/holmes/cli/attest.d.ts +2 -0
- package/dist/holmes/cli/attest.js +66 -15
- package/dist/holmes/cli/ci-gate.js +16 -1
- package/dist/holmes/cli/claude-switches.d.ts +95 -0
- package/dist/holmes/cli/claude-switches.js +967 -0
- package/dist/holmes/cli/codex-hooks.d.ts +77 -0
- package/dist/holmes/cli/codex-hooks.js +802 -0
- package/dist/holmes/cli/codex-oracle.d.ts +194 -0
- package/dist/holmes/cli/codex-oracle.js +1245 -0
- package/dist/holmes/cli/codex-toml.d.ts +58 -1
- package/dist/holmes/cli/codex-toml.js +456 -40
- package/dist/holmes/cli/doctor.d.ts +108 -8
- package/dist/holmes/cli/doctor.js +1408 -98
- package/dist/holmes/cli/index.js +23 -11
- package/dist/holmes/cli/init.d.ts +13 -0
- package/dist/holmes/cli/init.js +749 -77
- package/dist/holmes/cli/interactive-prompt.js +2 -2
- package/dist/holmes/cli/mcp-launcher.d.ts +64 -6
- package/dist/holmes/cli/mcp-launcher.js +189 -6
- package/dist/holmes/cli/mcp-version.js +13 -2
- package/dist/holmes/cli/settings-merge.js +8 -2
- package/dist/holmes/cli/upgrade.d.ts +13 -0
- package/dist/holmes/cli/upgrade.js +116 -23
- package/dist/holmes/cli/workspace-scope.d.ts +22 -0
- package/dist/holmes/cli/workspace-scope.js +375 -0
- package/dist/holmes/cli/worktree-readiness.d.ts +1 -0
- package/dist/holmes/cli/worktree-readiness.js +17 -3
- package/dist/holmes/cpg/cpg-scanner.d.ts +29 -0
- package/dist/holmes/cpg/cpg-scanner.js +403 -3
- package/dist/holmes/cpg/cycle-detect.js +2 -1
- package/dist/holmes/cpg/forbidden-edges.js +9 -2
- package/dist/holmes/cpg/required-calls.js +8 -1
- package/dist/holmes/governance/autonomy.d.ts +9 -0
- package/dist/holmes/governance/autonomy.js +28 -1
- package/dist/holmes/governance/constitution-debt.js +3 -2
- package/dist/holmes/governance/constitution.js +15 -3
- package/dist/holmes/governance/provenance-chain.js +3 -2
- package/dist/holmes/governance/push-gate-runner.js +4 -3
- package/dist/holmes/guardrail/dependency-delta.js +4 -3
- package/dist/holmes/guardrail/linear-match.d.ts +57 -0
- package/dist/holmes/guardrail/linear-match.js +256 -0
- package/dist/holmes/guardrail/risk-classifier.d.ts +6 -7
- package/dist/holmes/guardrail/risk-classifier.js +931 -44
- package/dist/holmes/guardrail/risk-types.d.ts +6 -0
- package/dist/holmes/guardrail/scope-judgment.d.ts +4 -24
- package/dist/holmes/guardrail/scope-judgment.js +100 -23
- package/dist/holmes/guardrail/shell-words.d.ts +42 -0
- package/dist/holmes/guardrail/shell-words.js +1720 -0
- package/dist/holmes/guardrail/write-target.d.ts +168 -3
- package/dist/holmes/guardrail/write-target.js +2379 -87
- package/dist/holmes/hooks/adapters/antigravity.d.ts +3 -1
- package/dist/holmes/hooks/adapters/antigravity.js +115 -11
- package/dist/holmes/hooks/pre-tool-use.d.ts +32 -6
- package/dist/holmes/hooks/pre-tool-use.js +923 -87
- package/dist/holmes/hooks/rtm-refresh-child.d.ts +22 -1
- package/dist/holmes/hooks/rtm-refresh-child.js +102 -18
- package/dist/holmes/hooks/rtm-refresh.d.ts +20 -1
- package/dist/holmes/hooks/rtm-refresh.js +60 -15
- package/dist/holmes/hooks/session-start.d.ts +10 -0
- package/dist/holmes/hooks/session-start.js +31 -7
- package/dist/holmes/hooks/stop.d.ts +2 -1
- package/dist/holmes/hooks/stop.js +197 -91
- package/dist/holmes/mcp/approval-adapters.d.ts +22 -0
- package/dist/holmes/mcp/approval-adapters.js +21 -0
- package/dist/holmes/mcp/approval-commit.d.ts +20 -0
- package/dist/holmes/mcp/approval-commit.js +108 -0
- package/dist/holmes/mcp/approval-intent.d.ts +44 -0
- package/dist/holmes/mcp/approval-intent.js +67 -0
- package/dist/holmes/mcp/approval-policy.d.ts +14 -0
- package/dist/holmes/mcp/approval-policy.js +18 -0
- package/dist/holmes/mcp/elicit-approval.d.ts +2 -0
- package/dist/holmes/mcp/elicit-approval.js +8 -3
- package/dist/holmes/mcp/handlers/graph-operations.d.ts +17 -1
- package/dist/holmes/mcp/handlers/graph-operations.js +15 -6
- package/dist/holmes/mcp/handlers/maintenance-analysis.js +11 -5
- package/dist/holmes/mcp/handlers/maintenance-evidence.js +3 -2
- package/dist/holmes/mcp/handlers/phase-queries.d.ts +22 -7
- package/dist/holmes/mcp/handlers/phase-queries.js +81 -2
- package/dist/holmes/mcp/handlers/requirement-triage.d.ts +26 -0
- package/dist/holmes/mcp/handlers/requirement-triage.js +48 -11
- package/dist/holmes/mcp/handlers/review-evidence.d.ts +2 -1
- package/dist/holmes/mcp/handlers/review-evidence.js +15 -5
- package/dist/holmes/mcp/handlers/slice-orchestration.d.ts +18 -0
- package/dist/holmes/mcp/handlers/slice-orchestration.js +122 -16
- package/dist/holmes/mcp/handlers/spec-approval.d.ts +35 -2
- package/dist/holmes/mcp/handlers/spec-approval.js +175 -57
- package/dist/holmes/mcp/handlers/spec-authoring.js +36 -3
- package/dist/holmes/mcp/handlers/spec-queries.d.ts +39 -3
- package/dist/holmes/mcp/handlers/spec-queries.js +114 -7
- package/dist/holmes/mcp/handlers/test-execution.js +9 -3
- package/dist/holmes/mcp/handlers.d.ts +126 -8
- package/dist/holmes/mcp/handlers.js +109 -18
- package/dist/holmes/mcp/harness-attestation.d.ts +20 -0
- package/dist/holmes/mcp/harness-attestation.js +179 -0
- package/dist/holmes/mcp/maintenance-analyze.js +28 -4
- package/dist/holmes/mcp/maintenance-evidence.js +1 -1
- package/dist/holmes/mcp/requirement-triage-evidence.d.ts +72 -2
- package/dist/holmes/mcp/requirement-triage-evidence.js +227 -1
- package/dist/holmes/mcp/server.js +24 -3
- package/dist/holmes/mcp/supervisor.js +7 -3
- package/dist/holmes/mcp/tool-schemas.d.ts +8 -0
- package/dist/holmes/mcp/tool-schemas.js +54 -7
- package/dist/holmes/mcp/validate-args.js +12 -0
- package/dist/holmes/project/bounded-io.d.ts +102 -0
- package/dist/holmes/project/bounded-io.js +212 -0
- package/dist/holmes/project/change-source.js +3 -1
- package/dist/holmes/project/ci-runs.js +3 -2
- package/dist/holmes/project/ignore.d.ts +31 -2
- package/dist/holmes/project/ignore.js +409 -50
- package/dist/holmes/project/regular-file-guard.d.ts +13 -0
- package/dist/holmes/project/regular-file-guard.js +149 -0
- package/dist/holmes/project/root.js +12 -3
- package/dist/holmes/refresh/freshness-coordinator.d.ts +67 -0
- package/dist/holmes/refresh/freshness-coordinator.js +230 -0
- package/dist/holmes/reverse/anchor.js +4 -3
- package/dist/holmes/reverse/scan.js +6 -2
- package/dist/holmes/review/commit-text.js +3 -2
- package/dist/holmes/review/condition-hunk-replay.d.ts +12 -0
- package/dist/holmes/review/condition-hunk-replay.js +13 -2
- package/dist/holmes/review/condition-hunk-resolution.js +59 -8
- package/dist/holmes/review/failed-test-names.js +13 -10
- package/dist/holmes/review/findings.js +3 -1
- package/dist/holmes/review/kills-check.js +6 -1
- package/dist/holmes/review/point-in-time-replay.js +5 -4
- package/dist/holmes/review/replay-corpus.js +5 -4
- package/dist/holmes/review/requirement-triage-human-records.d.ts +59 -0
- package/dist/holmes/review/requirement-triage-human-records.js +119 -0
- package/dist/holmes/review/run-replay.js +3 -2
- package/dist/holmes/review/scope.js +6 -1
- package/dist/holmes/review/temporal-prior.js +3 -2
- package/dist/holmes/review/test-evidence.js +3 -2
- package/dist/holmes/review/test-outcomes.d.ts +28 -0
- package/dist/holmes/review/test-outcomes.js +92 -2
- package/dist/holmes/review/test-runner.d.ts +6 -0
- package/dist/holmes/review/test-runner.js +36 -15
- package/dist/holmes/rtm/advisory-outcomes.js +3 -2
- package/dist/holmes/rtm/anchor-ids.js +42 -2
- package/dist/holmes/rtm/file-anchors.js +4 -1
- package/dist/holmes/rtm/ftt-fulfilment.js +8 -3
- package/dist/holmes/rtm/git-changes.js +3 -1
- package/dist/holmes/rtm/graph-store.js +3 -2
- package/dist/holmes/rtm/test-scope.js +9 -4
- package/dist/holmes/spec/compat-impact.d.ts +25 -4
- package/dist/holmes/spec/compat-impact.js +682 -11
- package/dist/holmes/spec/entity-git-snapshot.js +3 -2
- package/dist/holmes/spec/entity-integration.js +3 -2
- package/dist/holmes/spec/entity-renumber-transaction.d.ts +19 -0
- package/dist/holmes/spec/entity-renumber-transaction.js +79 -6
- package/dist/holmes/spec/remote-spec-refs.js +3 -2
- package/dist/holmes/spec/renumber.js +25 -10
- package/dist/holmes/spec/spec-parser.js +9 -3
- package/dist/holmes/spec/yaml-scalar.js +2 -2
- package/dist/holmes/update/refresh.js +3 -1
- package/dist/holmes/update/update-notice.d.ts +6 -0
- package/dist/holmes/update/update-notice.js +18 -1
- package/package.json +11 -4
|
@@ -1,12 +1,52 @@
|
|
|
1
1
|
import { McpServerEntry } from './mcp-launcher';
|
|
2
|
+
type TomlTable = Record<string, unknown>;
|
|
3
|
+
/** The parsed document, or the parser's reason for refusing it (Codex refuses such a file whole). */
|
|
4
|
+
export declare function parseCodexConfig(raw: string): {
|
|
5
|
+
ok: true;
|
|
6
|
+
doc: TomlTable;
|
|
7
|
+
} | {
|
|
8
|
+
ok: false;
|
|
9
|
+
reason: string;
|
|
10
|
+
};
|
|
11
|
+
/** @implements A-SPEC-727 (round 10) — whether the holmes-kit table sets `enabled = false`. */
|
|
12
|
+
export declare function codexHolmesDisabled(raw: string): boolean;
|
|
13
|
+
/** Why Codex cannot load this config, or null when it parses. */
|
|
14
|
+
/**
|
|
15
|
+
* @implements A-SPEC-731 (round 6) — bytes → text only when they are valid UTF-8: Codex refuses the
|
|
16
|
+
* whole file otherwise, and a lenient read rewrote the bytes (and the backup) with U+FFFD (measured).
|
|
17
|
+
*/
|
|
18
|
+
export declare function readCodexConfigBytes(bytes: Uint8Array): {
|
|
19
|
+
ok: true;
|
|
20
|
+
text: string;
|
|
21
|
+
} | {
|
|
22
|
+
ok: false;
|
|
23
|
+
reason: string;
|
|
24
|
+
};
|
|
25
|
+
export declare function codexConfigLoadProblem(raw: string): string | null;
|
|
26
|
+
/**
|
|
27
|
+
* @implements A-SPEC-731 (round 4) — the write a caller is about to make, judged by the parser: null
|
|
28
|
+
* when `after` loads and its holmes-kit entry is exactly `want` (or absent when `want` is null), else
|
|
29
|
+
* the reason to write nothing.
|
|
30
|
+
*/
|
|
31
|
+
export declare function codexConfigWriteProblem(after: string, want: {
|
|
32
|
+
command: string;
|
|
33
|
+
args: string[];
|
|
34
|
+
env?: Record<string, string>;
|
|
35
|
+
} | null): string | null;
|
|
2
36
|
/** The one table holmes-kit owns in a Codex config.toml. */
|
|
3
37
|
export declare const CODEX_TABLE = "mcp_servers.holmes-kit";
|
|
38
|
+
/**
|
|
39
|
+
* The default configuration location actually loaded by Codex CLI. A named profile may layer a
|
|
40
|
+
* different config, but it is invocation state and cannot be inferred by an offline doctor run.
|
|
41
|
+
* Injectable values keep this platform-sensitive path rule deterministic in tests.
|
|
42
|
+
*/
|
|
43
|
+
export declare function defaultCodexConfigPath(env?: NodeJS.ProcessEnv, home?: string): string;
|
|
4
44
|
/**
|
|
5
45
|
* Serialize the `[mcp_servers.holmes-kit]` table. `env` is an inline table so the whole entry is ONE
|
|
6
46
|
* contiguous region (no `[mcp_servers.holmes-kit.env]` child header) — that keeps the merge boundary
|
|
7
47
|
* unambiguous: our region runs from the header to the next table header. Ends with a trailing newline.
|
|
8
48
|
*/
|
|
9
|
-
export declare function codexMcpBlock(entry: McpServerEntry,
|
|
49
|
+
export declare function codexMcpBlock(entry: McpServerEntry, _legacySpecsDir?: string): string;
|
|
10
50
|
/**
|
|
11
51
|
* Merge `block` (a full `codexMcpBlock` output) into `existing`. When `existing` is null/empty the
|
|
12
52
|
* block stands alone. When our table is already present its region is REPLACED (no duplicate); when
|
|
@@ -24,6 +64,22 @@ export declare function readCodexHolmesEntry(raw: string): {
|
|
|
24
64
|
command: string;
|
|
25
65
|
args: string[];
|
|
26
66
|
} | null;
|
|
67
|
+
/** @implements A-SPEC-721 — whether the config carries Holmes's table at all (well-formed or not). */
|
|
68
|
+
export declare function hasCodexHolmesTable(raw: string): boolean;
|
|
69
|
+
/** @implements A-SPEC-721 — whether the shared config configures the Holmes server at all. */
|
|
70
|
+
export declare function mentionsHolmes(raw: string): boolean;
|
|
71
|
+
/**
|
|
72
|
+
* @implements A-SPEC-721 — Holmes settings outside the one region init owns (dotted keys, an inline
|
|
73
|
+
* table under `[mcp_servers]`, a subtable without its parent). Merging our block into such a file
|
|
74
|
+
* would declare the table twice and Codex would reject the whole shared config.
|
|
75
|
+
*/
|
|
76
|
+
export declare function unownedHolmesShape(raw: string): boolean;
|
|
77
|
+
/**
|
|
78
|
+
* @implements A-SPEC-721 — a `HOLMES_SPECS` value set on any Holmes line (inline env, env subtable,
|
|
79
|
+
* quoted key; basic or literal string). Null when absent or unreadable. Doctor decides whether the
|
|
80
|
+
* value binds one fixed project.
|
|
81
|
+
*/
|
|
82
|
+
export declare function readCodexFixedSpecs(raw: string): string | null;
|
|
27
83
|
/**
|
|
28
84
|
* @implements A-SPEC-585
|
|
29
85
|
* The first invalid basic-string escape inside OUR table's `command =` / `args =` lines, with its
|
|
@@ -34,3 +90,4 @@ export declare function invalidTomlEscape(raw: string): {
|
|
|
34
90
|
escape: string;
|
|
35
91
|
line: number;
|
|
36
92
|
} | null;
|
|
93
|
+
export {};
|