@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
|
@@ -34,9 +34,11 @@ var __importStar = (this && this.__importStar) || (function () {
|
|
|
34
34
|
})();
|
|
35
35
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
36
|
exports.createSpecApprovalHandlers = createSpecApprovalHandlers;
|
|
37
|
-
|
|
38
|
-
// @implements A-SPEC-
|
|
37
|
+
exports.readProjectFile = readProjectFile;
|
|
38
|
+
// @implements A-SPEC-718, A-SPEC-551.1, A-SPEC-627.1, A-SPEC-622, A-SPEC-100.2, A-SPEC-128, A-SPEC-132, A-SPEC-133, A-SPEC-151, A-SPEC-188, A-SPEC-189, A-SPEC-244, A-SPEC-245, A-SPEC-729
|
|
39
|
+
// @implements A-SPEC-631, A-SPEC-733
|
|
39
40
|
const fs = __importStar(require("node:fs"));
|
|
41
|
+
const compat_impact_1 = require("../../spec/compat-impact");
|
|
40
42
|
const path = __importStar(require("node:path"));
|
|
41
43
|
const spec_store_1 = require("../../spec/spec-store");
|
|
42
44
|
const transition_policy_1 = require("../../spec/transition-policy");
|
|
@@ -50,6 +52,8 @@ const version_conflict_1 = require("../../spec/version-conflict");
|
|
|
50
52
|
const ledger_store_1 = require("../../governance/ledger-store");
|
|
51
53
|
const provenance_chain_1 = require("../../governance/provenance-chain");
|
|
52
54
|
const review_targets_1 = require("../../review/review-targets");
|
|
55
|
+
const requirement_triage_evidence_1 = require("../requirement-triage-evidence");
|
|
56
|
+
const approval_policy_1 = require("../approval-policy");
|
|
53
57
|
function createSpecApprovalHandlers(context) {
|
|
54
58
|
const { store, resolver, projectRootOf, cachedScan, tryElicit, elicitApproval, autonomousApproval } = context;
|
|
55
59
|
return {
|
|
@@ -85,62 +89,132 @@ function createSpecApprovalHandlers(context) {
|
|
|
85
89
|
let elicitExpiredMs;
|
|
86
90
|
let risk;
|
|
87
91
|
let subject;
|
|
92
|
+
// @implements A-SPEC-732 (round 2) — the digest a person or the autonomy grade decided on; the
|
|
93
|
+
// seal must be built from that same content.
|
|
94
|
+
let decidedSubject;
|
|
95
|
+
// A continuation is offered or spent only on a call that can land in this bound project.
|
|
96
|
+
const bindingOk = () => {
|
|
97
|
+
try {
|
|
98
|
+
if (store instanceof spec_store_1.LocalMarkdownRepository) {
|
|
99
|
+
const derived = context.projectRootOf(store.specsRoot);
|
|
100
|
+
if (fs.existsSync(path.join(derived, '.ax'))) {
|
|
101
|
+
return typeof a.root !== 'string' || a.root === '' || (0, write_target_1.resolveTarget)(context.projectRootOf(a.root), '.') === (0, write_target_1.resolveTarget)(derived, '.');
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
return typeof a.root === 'string' && a.root !== '';
|
|
105
|
+
}
|
|
106
|
+
catch {
|
|
107
|
+
return false;
|
|
108
|
+
}
|
|
109
|
+
};
|
|
88
110
|
if (approveResolved === undefined) {
|
|
89
111
|
const target = await store.read(a.id).catch(() => null);
|
|
90
112
|
// @implements A-SPEC-649 — the digest of what the operator will read rides the request.
|
|
91
113
|
subject = target ? (0, spec_digest_1.specDigest)(target.spec) : undefined;
|
|
92
114
|
if (target) {
|
|
93
|
-
|
|
94
|
-
//
|
|
95
|
-
//
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
// session envelope marker under this project's `.ax/state/` (which an agent cannot write).
|
|
101
|
-
const autonomyOn = (0, autonomy_1.autonomousApprovalEnabled)(process.env, a.root, new Date().toISOString());
|
|
102
|
-
// @implements A-SPEC-587 — an upstream REQ/H-SPEC is graded by the A-SPECs beneath it, so
|
|
103
|
-
// the store is consulted for its descendants (only then: the list is a cost the auto-grade
|
|
104
|
-
// A-SPEC/T-SPEC path does not pay). Unknown scope (none yet) keeps the human answer.
|
|
105
|
-
const upstream = target.spec.type === 'REQ' || target.spec.type === 'H-SPEC';
|
|
106
|
-
const below = upstream ? (0, autonomy_1.descendantAspecs)(target.spec, await store.list()) : undefined;
|
|
107
|
-
// @implements A-SPEC-649 — the grade is recorded on the request either way (the screen shows it).
|
|
108
|
-
risk = (0, autonomy_1.specApprovalAutonomy)(target.spec, resolver([target.spec]), below);
|
|
109
|
-
if (autonomyOn
|
|
110
|
-
&& (0, autonomy_1.specApprovalAutonomy)(target.spec, resolver([target.spec]), below) === 'auto') {
|
|
111
|
-
approveResolved = { approval: autonomousApproval(below?.map((s) => s.id)), source: 'autonomous' };
|
|
115
|
+
const targetSubject = (0, spec_digest_1.specDigest)(target.spec);
|
|
116
|
+
// A host-gated commit is a continuation of this exact original action. It is checked
|
|
117
|
+
// before presentation and is memory-only, so a bare retry never carries authority.
|
|
118
|
+
const hostApproval = bindingOk() ? context.consumeHostApproval({ kind: action.kind, target: action.target, subject: targetSubject, root: a.root }) : undefined;
|
|
119
|
+
if (hostApproval) {
|
|
120
|
+
approveResolved = { approval: hostApproval, source: 'elicitation' };
|
|
121
|
+
decidedSubject = targetSubject;
|
|
112
122
|
}
|
|
113
|
-
|
|
114
|
-
//
|
|
115
|
-
// dialog is auto-acceptable by an auto-mode client (the protocol cannot tell a human
|
|
116
|
-
// from an auto-accept), so a governance-critical spec is never offered it. Do nothing
|
|
117
|
-
// here — approveResolved stays undefined and the fail-closed refuse+enqueue path below
|
|
118
|
-
// routes the act to the out-of-band human queue (holmes-kit approve). The A-SPEC-532.1
|
|
119
|
-
// bound ("governance-critical specs never leave the human channel") thus becomes
|
|
120
|
-
// ENFORCED, not aspirational. Autonomy OFF (the else) and the auto-grade branch above
|
|
121
|
-
// stay byte-identical to before.
|
|
123
|
+
if (approveResolved !== undefined) {
|
|
124
|
+
// The rest of the existing seal path owns all validation and audit behavior.
|
|
122
125
|
}
|
|
123
126
|
else {
|
|
124
|
-
|
|
125
|
-
//
|
|
126
|
-
//
|
|
127
|
-
//
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
127
|
+
// @implements A-SPEC-532.2 — the autonomous gate sits BEFORE the human ask: when the
|
|
128
|
+
// out-of-band autonomy switch is on AND the spec is low/mid-risk (never gate-behavior, an
|
|
129
|
+
// architecture/taint file, or an upstream REQ/H/C — those stay human), the agent seals it
|
|
130
|
+
// itself. The switch is env-only and an agent cannot set it (pre-tool-use blocks that,
|
|
131
|
+
// A-SPEC-532.2). With autonomy off, every HITL spec uses the established elicitor path.
|
|
132
|
+
// With autonomy on, A-SPEC-718 preserves that UI only for known high-risk/architecture
|
|
133
|
+
// exceptions; an unclassified upstream request is intentionally queued instead.
|
|
134
|
+
// @implements A-SPEC-553.1 — autonomy is the out-of-band env switch OR a valid, non-expired
|
|
135
|
+
// session envelope marker under this project's `.ax/state/` (which an agent cannot write).
|
|
136
|
+
// @implements A-SPEC-732 (round 2) — at the PROJECT root: a raw root under .ax/specs let a planted
|
|
137
|
+
// marker switch autonomy on.
|
|
138
|
+
const autonomyRoot = (() => { try {
|
|
139
|
+
return context.projectRootOf(a.root ?? store.specsRoot);
|
|
131
140
|
}
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
141
|
+
catch {
|
|
142
|
+
return undefined;
|
|
143
|
+
} })();
|
|
144
|
+
const autonomyOn = (0, autonomy_1.autonomousApprovalEnabled)(process.env, autonomyRoot, new Date().toISOString());
|
|
145
|
+
// @implements A-SPEC-587 — an upstream REQ/H-SPEC is graded by the A-SPECs beneath it, so
|
|
146
|
+
// the store is consulted for its descendants (only then: the list is a cost the auto-grade
|
|
147
|
+
// A-SPEC/T-SPEC path does not pay). Unknown scope (none yet) keeps the human answer.
|
|
148
|
+
const upstream = target.spec.type === 'REQ' || target.spec.type === 'H-SPEC';
|
|
149
|
+
const below = upstream ? (0, autonomy_1.descendantAspecs)(target.spec, await store.list()) : undefined;
|
|
150
|
+
// @implements A-SPEC-649 — the grade is recorded on the request either way (the screen shows it).
|
|
151
|
+
risk = (0, autonomy_1.specApprovalAutonomy)(target.spec, resolver([target.spec]), below);
|
|
152
|
+
// @implements A-SPEC-729 (round 5) — a REQ never sealed and never admitted through the
|
|
153
|
+
// triage intake is not the agent's to seal: a human route may, an autonomous one may not.
|
|
154
|
+
// @implements A-SPEC-729 (round 6) — "never sealed" from the LEDGER: a hand-written
|
|
155
|
+
// approved_digest in a draft made a REQ look sealed and skip this rule (measured).
|
|
156
|
+
const noIntake = target.spec.type === 'REQ' && (() => {
|
|
157
|
+
try {
|
|
158
|
+
const intakeRoot = context.projectRootOf(a.root ?? store.specsRoot);
|
|
159
|
+
return !(0, requirement_triage_evidence_1.everSealedInLedger)(intakeRoot, a.id) && !(0, requirement_triage_evidence_1.hasRequirementIntakeRecord)(intakeRoot, a.id, target.spec.frontmatter.triage_evidence);
|
|
160
|
+
}
|
|
161
|
+
catch {
|
|
162
|
+
return true;
|
|
163
|
+
}
|
|
164
|
+
})();
|
|
165
|
+
if (noIntake)
|
|
166
|
+
risk = 'hitl';
|
|
167
|
+
if (autonomyOn && risk === 'auto') {
|
|
168
|
+
approveResolved = { approval: autonomousApproval(below?.map((s) => s.id)), source: 'autonomous' };
|
|
169
|
+
decidedSubject = targetSubject;
|
|
136
170
|
}
|
|
137
|
-
else if (
|
|
138
|
-
// @implements A-SPEC-
|
|
139
|
-
//
|
|
140
|
-
//
|
|
141
|
-
|
|
171
|
+
else if (autonomyOn && !(0, autonomy_1.requiresAutonomousApprovalPrompt)(target.spec, below)) {
|
|
172
|
+
// @implements A-SPEC-551.1 — autonomous mode does not turn an ordinary HITL request
|
|
173
|
+
// into a human decision. An unclassified upstream request is queued without opening
|
|
174
|
+
// a dialog; A-SPEC-718's architecture/high-risk exceptions take the next branch.
|
|
175
|
+
}
|
|
176
|
+
else {
|
|
177
|
+
const resealing = typeof target.spec.frontmatter.approved_digest === 'string';
|
|
178
|
+
// The MODEL text is capped BEFORE the server markers are appended (round-2): a ~185+ char
|
|
179
|
+
// title pushed '(재봉인)' past the dialog's 200-char summary cap, dressing a re-seal (the
|
|
180
|
+
// more consequential act) as a first approval. The cap cuts the title, never the marker.
|
|
181
|
+
const out = await tryElicit('spec-approve', a.id, `${a.id} — ${target.spec.title.slice(0, 120)}${resealing ? ' (재봉인)' : ''}${noIntake ? ' (triage 기록 없음)' : ''}`, autonomyOn ? 'autonomous-approve' : 'queue');
|
|
182
|
+
const presentation = out.kind === 'answered'
|
|
183
|
+
? (out.decision.granted ? { kind: 'approve', reason: out.decision.reason } : { kind: 'deny', reason: out.decision.reason })
|
|
184
|
+
: out.kind === 'expired' ? { kind: 'timeout' } : { kind: 'unavailable' };
|
|
185
|
+
const decision = (0, approval_policy_1.resolveApprovalPresentation)(presentation, { autonomous: autonomyOn, harness: context.approvalHarness() });
|
|
186
|
+
if (decision.kind === 'approved' && presentation.kind === 'approve') {
|
|
187
|
+
approveResolved = { approval: elicitApproval(out.kind === 'answered' ? out.decision.reason : undefined), source: 'elicitation' };
|
|
188
|
+
decidedSubject = targetSubject;
|
|
189
|
+
}
|
|
190
|
+
else if (decision.kind === 'approved' && presentation.kind === 'timeout') {
|
|
191
|
+
approveResolved = { approval: autonomousApproval(undefined, 'timeout'), source: 'autonomous' };
|
|
192
|
+
decidedSubject = targetSubject;
|
|
193
|
+
}
|
|
194
|
+
else if (out.kind === 'answered') {
|
|
195
|
+
// The human ANSWERED (deny/question/decline): the answer is the message, and no queue
|
|
196
|
+
// entry is filed — a decided request is not a pending one (REQ-246 visibility).
|
|
197
|
+
return { ok: false, reason: `spec_approve: 세션에서 거부됨 — ${out.decision.reason ?? '(사유 없음)'}. 사유를 해소한 뒤 다시 시도하십시오.` };
|
|
198
|
+
}
|
|
199
|
+
else if (out.kind === 'expired') {
|
|
200
|
+
// @implements A-SPEC-718 — a direct in-session prompt may time out. Only an explicit
|
|
201
|
+
// autonomous posture may turn that absence into a one-shot, audit-distinguishable grant.
|
|
202
|
+
// OFF keeps the established fail-closed expiry + queue behavior.
|
|
203
|
+
elicitExpiredMs = out.waitedMs;
|
|
204
|
+
}
|
|
205
|
+
else if (out.kind === 'silent' && context.approvalAdapter().kind === 'host-gated-tool' && bindingOk()) {
|
|
206
|
+
// The adapter's sensitive `approval_commit` invocation is rendered in the same agent
|
|
207
|
+
// session. Its complete immutable payload is what the host shows and what the server
|
|
208
|
+
// checks before a retry can consume it; it is never a config/env authorization.
|
|
209
|
+
const intent = context.prepareHostApproval({ kind: action.kind, target: action.target, subject: targetSubject, root: a.root });
|
|
210
|
+
return {
|
|
211
|
+
ok: false,
|
|
212
|
+
reason: `spec_approve: 이 세션은 직접 승인 폼을 광고하지 않았습니다. Holmes-Kit 승인 확인 UI에서 approval_commit 을 확인한 뒤 같은 spec_approve 를 다시 시도하십시오.`,
|
|
213
|
+
approvalIntent: intent,
|
|
214
|
+
};
|
|
215
|
+
}
|
|
216
|
+
// silent: the channel gave no answer — fall through to the byte-identical refusal.
|
|
142
217
|
}
|
|
143
|
-
// silent: the channel gave no answer — fall through to the byte-identical refusal.
|
|
144
218
|
}
|
|
145
219
|
}
|
|
146
220
|
}
|
|
@@ -155,7 +229,7 @@ function createSpecApprovalHandlers(context) {
|
|
|
155
229
|
catch {
|
|
156
230
|
refusedGrants = '';
|
|
157
231
|
}
|
|
158
|
-
return { ok: false, reason: (elicitExpiredMs !== undefined ? (0, elicit_approval_1.expiredNotice)(elicitExpiredMs) : '') + refusedGrants
|
|
232
|
+
return { ok: false, reason: (elicitExpiredMs !== undefined ? (0, elicit_approval_1.expiredNotice)(elicitExpiredMs) : '') + refusedGrants + (context.approvalRouteNote?.() ?? '')
|
|
159
233
|
+ 'spec_approve requires an out-of-band HOLMES_APPROVAL that COVERS this act — a request-payload approval is not a channel, and an expired or elsewhere-scoped token does not open this door (scoped approvals need kind "spec-approve"). (fail-closed)'
|
|
160
234
|
+ context.refusalQueueHint(a.root, { kind: 'spec-approve', target: a.id, why: '스펙 봉인 승인', ...(subject ? { subject } : {}), ...(risk ? { risk } : {}) }) };
|
|
161
235
|
}
|
|
@@ -238,6 +312,10 @@ function createSpecApprovalHandlers(context) {
|
|
|
238
312
|
// @implements A-SPEC-649 — a grant bound to a subject opens only for THAT subject: the digest of
|
|
239
313
|
// the spec read now (the same read the seal is based on) must equal the one the operator read.
|
|
240
314
|
// Measured 2026-09-14: a grant read against "Original title" sealed "CHANGED after the grant".
|
|
315
|
+
if (cur && decidedSubject !== undefined && (0, spec_digest_1.specDigest)(cur.spec) !== decidedSubject) {
|
|
316
|
+
return { ok: false, reason: `spec_approve: ${a.id} changed after the decision was made — the content decided on is not the content that would be sealed. Nothing was sealed; ask again.`
|
|
317
|
+
+ context.refusalQueueHint(a.root, { kind: 'spec-approve', target: a.id, why: '스펙 봉인 승인', subject: (0, spec_digest_1.specDigest)(cur.spec) }) };
|
|
318
|
+
}
|
|
241
319
|
if (cur && approveResolved.source === 'grant') {
|
|
242
320
|
const bound = approveResolved.approval;
|
|
243
321
|
if (typeof bound.subject === 'string' && bound.subject !== '' && bound.subject !== (0, spec_digest_1.specDigest)(cur.spec)) {
|
|
@@ -256,14 +334,7 @@ function createSpecApprovalHandlers(context) {
|
|
|
256
334
|
return { ok: false, reason: (0, spec_store_1.notFoundReason)(a.id, unreadable) };
|
|
257
335
|
}
|
|
258
336
|
const spec = cur.spec;
|
|
259
|
-
const prepared = (0, transition_policy_1.prepareApprovedSpec)(spec, specs, resolver, (rel) =>
|
|
260
|
-
try {
|
|
261
|
-
return a.root ? fs.readFileSync(path.join(a.root, rel), 'utf8') : null;
|
|
262
|
-
}
|
|
263
|
-
catch {
|
|
264
|
-
return null;
|
|
265
|
-
}
|
|
266
|
-
});
|
|
337
|
+
const prepared = (0, transition_policy_1.prepareApprovedSpec)(spec, specs, resolver, (rel) => (a.root ? readProjectFile(a.root, rel) : null));
|
|
267
338
|
if (!prepared.ok)
|
|
268
339
|
return prepared;
|
|
269
340
|
const { candidate, digest } = prepared;
|
|
@@ -366,7 +437,7 @@ function createSpecApprovalHandlers(context) {
|
|
|
366
437
|
try {
|
|
367
438
|
const ftt = filesToTouch(candidate);
|
|
368
439
|
const gap = declaredImpactGap(ftt, graph, (rel) => { try {
|
|
369
|
-
return
|
|
440
|
+
return readProjectFile(a.root, rel);
|
|
370
441
|
}
|
|
371
442
|
catch {
|
|
372
443
|
return null;
|
|
@@ -588,3 +659,50 @@ function createSpecApprovalHandlers(context) {
|
|
|
588
659
|
},
|
|
589
660
|
};
|
|
590
661
|
}
|
|
662
|
+
/** Largest Files-to-Touch file the approval act reads (A-SPEC-733 round 3). */
|
|
663
|
+
const PROJECT_READ_LIMIT = 2 * 1024 * 1024;
|
|
664
|
+
/**
|
|
665
|
+
* @implements A-SPEC-733 (round 3) — the approval act reads a Files-to-Touch path only when it is a
|
|
666
|
+
* regular file inside the project, at most 2 MB. Measured: a FIFO named there blocked approval, and a
|
|
667
|
+
* `../` path read a file outside the project. The descriptor is opened non-blocking and judged by
|
|
668
|
+
* fstat, so a path swapped between check and read is judged as what was opened.
|
|
669
|
+
*/
|
|
670
|
+
function readProjectFile(root, rel) {
|
|
671
|
+
let tooLarge = -1;
|
|
672
|
+
const text = readProjectFileOnce(root, rel, (n) => { tooLarge = n; });
|
|
673
|
+
if (tooLarge >= 0)
|
|
674
|
+
throw new compat_impact_1.FileTooLargeError(rel, tooLarge);
|
|
675
|
+
return text;
|
|
676
|
+
}
|
|
677
|
+
function readProjectFileOnce(root, rel, onTooLarge) {
|
|
678
|
+
let tooLarge = -1;
|
|
679
|
+
let fd;
|
|
680
|
+
try {
|
|
681
|
+
const realRoot = fs.realpathSync(root);
|
|
682
|
+
const real = fs.realpathSync(path.resolve(realRoot, rel));
|
|
683
|
+
if (!real.startsWith(realRoot + path.sep))
|
|
684
|
+
return null;
|
|
685
|
+
fd = fs.openSync(real, fs.constants.O_RDONLY | (fs.constants.O_NONBLOCK ?? 0));
|
|
686
|
+
const st = fs.fstatSync(fd);
|
|
687
|
+
if (!st.isFile())
|
|
688
|
+
return null;
|
|
689
|
+
// @implements A-SPEC-733 (round 5) — too large is reported, not skipped.
|
|
690
|
+
if (st.size > PROJECT_READ_LIMIT) {
|
|
691
|
+
tooLarge = st.size;
|
|
692
|
+
return null;
|
|
693
|
+
}
|
|
694
|
+
return fs.readFileSync(fd, 'utf8');
|
|
695
|
+
}
|
|
696
|
+
catch {
|
|
697
|
+
return null;
|
|
698
|
+
}
|
|
699
|
+
finally {
|
|
700
|
+
if (fd !== undefined)
|
|
701
|
+
try {
|
|
702
|
+
fs.closeSync(fd);
|
|
703
|
+
}
|
|
704
|
+
catch { /* already closed */ }
|
|
705
|
+
if (tooLarge >= 0)
|
|
706
|
+
onTooLarge(tooLarge);
|
|
707
|
+
}
|
|
708
|
+
}
|
|
@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
|
|
|
34
34
|
})();
|
|
35
35
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
36
|
exports.createSpecAuthoringHandlers = createSpecAuthoringHandlers;
|
|
37
|
+
// @implements A-SPEC-729, A-SPEC-724, A-SPEC-719
|
|
37
38
|
// @implements A-SPEC-618, A-SPEC-100.2, A-SPEC-128, A-SPEC-151, A-SPEC-169, A-SPEC-189, A-SPEC-420, A-SPEC-174, A-SPEC-252, A-SPEC-188, A-SPEC-146, A-SPEC-184
|
|
38
39
|
const fs = __importStar(require("node:fs"));
|
|
39
40
|
const path = __importStar(require("node:path"));
|
|
@@ -44,6 +45,7 @@ const legacy_format_1 = require("../../spec/legacy-format");
|
|
|
44
45
|
const write_target_1 = require("../../guardrail/write-target");
|
|
45
46
|
const root_1 = require("../../project/root");
|
|
46
47
|
const spec_id_guard_1 = require("../spec-id-guard");
|
|
48
|
+
const requirement_triage_evidence_1 = require("../requirement-triage-evidence");
|
|
47
49
|
function createSpecAuthoringHandlers(context) {
|
|
48
50
|
const { store, projectRootOf, resolver } = context;
|
|
49
51
|
return {
|
|
@@ -53,7 +55,7 @@ function createSpecAuthoringHandlers(context) {
|
|
|
53
55
|
// frontmatter and a machine-local absolute path lands in a git-shared document. A blacklist,
|
|
54
56
|
// not a whitelist: domain fields (`priority`, `slice`, …) must keep flowing through without
|
|
55
57
|
// anyone maintaining a list of them.
|
|
56
|
-
const { type, id, title, depends_on = [], root: reqRoot, ...extra } = a;
|
|
58
|
+
const { type, id, title, depends_on = [], root: reqRoot, triage_evidence, ...extra } = a;
|
|
57
59
|
// The server binds its spec store once, so a `root` naming another project cannot be honoured.
|
|
58
60
|
// Silently writing to this one is a data-integrity problem; refusing says so. Compared by
|
|
59
61
|
// resolved identity (A-SPEC-163) — `<root>//.` is the same directory, not a different project.
|
|
@@ -74,7 +76,11 @@ function createSpecAuthoringHandlers(context) {
|
|
|
74
76
|
if (boundSpecsRoot === null)
|
|
75
77
|
return null;
|
|
76
78
|
try {
|
|
77
|
-
|
|
79
|
+
// The first REQ is allowed to create the specs directory itself. Resolve from its
|
|
80
|
+
// existing `.ax` parent in that case; resolving a non-existent `.ax/specs` path cannot
|
|
81
|
+
// discover the already-bound workspace and would incorrectly reject valid evidence.
|
|
82
|
+
const derivationStart = fs.existsSync(boundSpecsRoot) ? boundSpecsRoot : path.dirname(boundSpecsRoot);
|
|
83
|
+
const d = projectRootOf(derivationStart);
|
|
78
84
|
return fs.existsSync(path.join(d, '.ax')) ? d : null;
|
|
79
85
|
}
|
|
80
86
|
catch {
|
|
@@ -241,19 +247,46 @@ function createSpecAuthoringHandlers(context) {
|
|
|
241
247
|
};
|
|
242
248
|
}
|
|
243
249
|
}
|
|
250
|
+
// @implements A-SPEC-719 — requirement intake is shared MCP enforcement, not harness prose.
|
|
251
|
+
// This stays immediately before the sole write. Structural, foreign-root, and occupied-target
|
|
252
|
+
// refusals above are deterministic and write nothing; preserving them lets callers repair the
|
|
253
|
+
// actual malformed request instead of first manufacturing evidence for an impossible create.
|
|
254
|
+
// A new REQ may still be born only from a current, prompt-bound v2 triage artifact. H/A/T
|
|
255
|
+
// creation remains the established continuation path and needs no second intake receipt.
|
|
256
|
+
if (type === 'REQ') {
|
|
257
|
+
const root = derivedForCreate ?? (typeof reqRoot === 'string' && reqRoot !== '' ? projectRootOf(reqRoot) : null);
|
|
258
|
+
const intake = root ? (0, requirement_triage_evidence_1.validateRequirementIntake)(root, triage_evidence) : (0, requirement_triage_evidence_1.validateRequirementIntake)('', undefined);
|
|
259
|
+
if (!intake.ok)
|
|
260
|
+
return { ok: false, reason: intake.reason };
|
|
261
|
+
// @implements A-SPEC-729 — spend it on THIS REQ (atomic), and let the REQ say what admitted it.
|
|
262
|
+
const digest = triage_evidence.digest;
|
|
263
|
+
const spent = (0, requirement_triage_evidence_1.consumeRequirementTriageEvidence)(root, digest, id);
|
|
264
|
+
if (!spent.ok)
|
|
265
|
+
return { ok: false, reason: spent.reason };
|
|
266
|
+
spec.frontmatter = { ...spec.frontmatter, triage_evidence: digest };
|
|
267
|
+
}
|
|
244
268
|
try {
|
|
245
269
|
await store.write(spec);
|
|
246
270
|
}
|
|
247
271
|
catch (e) {
|
|
248
272
|
// The pre-write path check above makes this a narrow race backstop; the store guard is the
|
|
249
273
|
// authority and this act relays it in the same wording the other writers use.
|
|
274
|
+
// @implements A-SPEC-729 — a failure after the spend leaves the evidence spent: say so.
|
|
275
|
+
const spentNote = type === 'REQ' ? ' 이 triage evidence는 이미 소비되었습니다 — requirement_triage(persist:true)를 다시 실행해 새 증거를 받으십시오.' : '';
|
|
250
276
|
if (e instanceof spec_store_1.TargetPathOccupiedError) {
|
|
251
277
|
return {
|
|
252
278
|
ok: false,
|
|
253
279
|
reason: `${id}의 목적지(${e.occupiedPath})에 스토어가 읽지 못하는 파일이 이미 있습니다 — 덮어쓰지 않습니다.`
|
|
254
|
-
+ ' 사람이 확인해 옮기거나 고친 뒤 다시 시도하십시오.',
|
|
280
|
+
+ ' 사람이 확인해 옮기거나 고친 뒤 다시 시도하십시오.' + spentNote,
|
|
255
281
|
};
|
|
256
282
|
}
|
|
283
|
+
// Only a raw filesystem error becomes a plain refusal; a structured refusal keeps its shape
|
|
284
|
+
// (code, holmesRefusal) and carries the spent note in its message.
|
|
285
|
+
if (spentNote && e && typeof e === 'object' && 'syscall' in e) {
|
|
286
|
+
return { ok: false, reason: `${id} could not be written (${e instanceof Error ? e.message : String(e)}).${spentNote}` };
|
|
287
|
+
}
|
|
288
|
+
if (spentNote && e instanceof Error)
|
|
289
|
+
e.message += spentNote;
|
|
257
290
|
throw e;
|
|
258
291
|
}
|
|
259
292
|
return { created: id };
|
|
@@ -4,6 +4,11 @@ export interface SpecQueryContext {
|
|
|
4
4
|
assertStoreReachable(tool: string, root: unknown): void;
|
|
5
5
|
resolver(specs: Spec[]): (id: string) => Spec | null;
|
|
6
6
|
}
|
|
7
|
+
type NextAction = {
|
|
8
|
+
id: string;
|
|
9
|
+
action: 'seal' | 'fill-then-seal' | 'fix-then-seal' | 'after-parent' | 'create-parent' | 'author-tspec';
|
|
10
|
+
reason: string;
|
|
11
|
+
};
|
|
7
12
|
export declare function createSpecQueryHandlers(context: SpecQueryContext): {
|
|
8
13
|
spec_validate(a: any): Promise<{
|
|
9
14
|
ok: boolean;
|
|
@@ -22,9 +27,40 @@ export declare function createSpecQueryHandlers(context: SpecQueryContext): {
|
|
|
22
27
|
status: "draft" | "review" | "approved" | "outdated";
|
|
23
28
|
}[];
|
|
24
29
|
}>;
|
|
25
|
-
spec_next(
|
|
26
|
-
|
|
30
|
+
spec_next(a?: {
|
|
31
|
+
id?: string;
|
|
32
|
+
}): Promise<{
|
|
33
|
+
ok: boolean;
|
|
34
|
+
reason: string;
|
|
35
|
+
next?: undefined;
|
|
36
|
+
actions?: undefined;
|
|
37
|
+
actionsTotal?: undefined;
|
|
38
|
+
chain?: undefined;
|
|
39
|
+
chainTotal?: undefined;
|
|
40
|
+
note?: undefined;
|
|
41
|
+
} | {
|
|
42
|
+
next: import("../../spec/spec-types").SpecType | null;
|
|
43
|
+
actions: NextAction[];
|
|
44
|
+
actionsTotal: number;
|
|
45
|
+
chain: {
|
|
46
|
+
id: string;
|
|
47
|
+
type: import("../../spec/spec-types").SpecType;
|
|
48
|
+
status: "draft" | "review" | "approved" | "outdated";
|
|
49
|
+
sealed: boolean;
|
|
50
|
+
}[];
|
|
51
|
+
chainTotal: number;
|
|
52
|
+
note: string;
|
|
53
|
+
ok?: undefined;
|
|
54
|
+
reason?: undefined;
|
|
27
55
|
} | {
|
|
28
|
-
next: null;
|
|
56
|
+
next: import("../../spec/spec-types").SpecType | null;
|
|
57
|
+
actions: NextAction[];
|
|
58
|
+
actionsTotal: number;
|
|
59
|
+
note: string;
|
|
60
|
+
ok?: undefined;
|
|
61
|
+
reason?: undefined;
|
|
62
|
+
chain?: undefined;
|
|
63
|
+
chainTotal?: undefined;
|
|
29
64
|
}>;
|
|
30
65
|
};
|
|
66
|
+
export {};
|
|
@@ -4,6 +4,102 @@ exports.createSpecQueryHandlers = createSpecQueryHandlers;
|
|
|
4
4
|
const validator_1 = require("../../spec/validator");
|
|
5
5
|
const legacy_format_1 = require("../../spec/legacy-format");
|
|
6
6
|
const spec_types_1 = require("../../spec/spec-types");
|
|
7
|
+
const spec_digest_1 = require("../../spec/spec-digest");
|
|
8
|
+
const approval_blockers_1 = require("../../spec/approval-blockers");
|
|
9
|
+
const ACTIONS_SHOWN = 20;
|
|
10
|
+
const CHAIN_ACTIONS_SHOWN = 50;
|
|
11
|
+
const CHAIN_ROWS_SHOWN = 200;
|
|
12
|
+
const NEXT_NOTE = '`next` is the first kind with no approved instance anywhere in the store (a v0.1 heuristic, not a step); '
|
|
13
|
+
+ '`actions` is what a slice needs now — pass `id` for one chain.';
|
|
14
|
+
const idOrder = (a, b) => a.localeCompare(b, 'en', { numeric: true });
|
|
15
|
+
function nextActions(specs, only) {
|
|
16
|
+
// @implements A-SPEC-736 (round 2) — judged against the WHOLE store even when only a chain is
|
|
17
|
+
// reported (the chain alone named an existing T-SPEC to author and an existing parent as missing),
|
|
18
|
+
// and with every lookup precomputed (the per-spec `specs.some` scan was quadratic).
|
|
19
|
+
const byId = new Map();
|
|
20
|
+
const idCount = new Map();
|
|
21
|
+
for (const s of specs) {
|
|
22
|
+
byId.set(s.id, s);
|
|
23
|
+
idCount.set(s.id, (idCount.get(s.id) ?? 0) + 1);
|
|
24
|
+
}
|
|
25
|
+
const withLiveT = new Set();
|
|
26
|
+
for (const t of specs)
|
|
27
|
+
if (t.type === 'T-SPEC' && t.status !== 'outdated')
|
|
28
|
+
for (const d of t.dependsOn ?? [])
|
|
29
|
+
withLiveT.add(d);
|
|
30
|
+
const sealed = (s) => !!(0, spec_digest_1.sealOf)(s).approvedDigest;
|
|
31
|
+
const parentsOf = (s) => (s.dependsOn ?? []).filter((d) => d !== s.id); // self-dependency ignored
|
|
32
|
+
const out = [];
|
|
33
|
+
for (const s of specs) {
|
|
34
|
+
if ((only && !only.has(s.id)) || s.status === 'outdated')
|
|
35
|
+
continue;
|
|
36
|
+
if (!sealed(s)) {
|
|
37
|
+
const missing = parentsOf(s).find((d) => !byId.has(d));
|
|
38
|
+
const retired = parentsOf(s).map((d) => byId.get(d)).find((p) => !!p && p.status === 'outdated');
|
|
39
|
+
const waiting = parentsOf(s).map((d) => byId.get(d)).find((p) => !!p && p.status !== 'outdated' && !sealed(p));
|
|
40
|
+
const holes = (0, approval_blockers_1.placeholderSections)(s);
|
|
41
|
+
if (missing)
|
|
42
|
+
out.push({ id: s.id, action: 'create-parent', reason: `depends on ${missing}, which does not exist — create it (spec_create) or correct depends_on` });
|
|
43
|
+
else if (retired)
|
|
44
|
+
out.push({ id: s.id, action: 'create-parent', reason: `depends on ${retired.id}, which is retired (outdated) — depend on its successor or correct depends_on` });
|
|
45
|
+
else if (waiting && parentsOf(waiting).includes(s.id))
|
|
46
|
+
out.push({ id: s.id, action: 'fix-then-seal', reason: `dependency cycle: ${s.id} and ${waiting.id} depend on each other — correct depends_on` });
|
|
47
|
+
else if (waiting)
|
|
48
|
+
out.push({ id: s.id, action: 'after-parent', reason: `seal ${waiting.id} first — a child cannot be sealed under an unsealed parent` });
|
|
49
|
+
else if (holes.length > 0)
|
|
50
|
+
out.push({ id: s.id, action: 'fill-then-seal', reason: `fill the placeholder section(s) ${holes.join(', ')}, then spec_approve` });
|
|
51
|
+
else {
|
|
52
|
+
// `seal` only when nothing spec_approve checks would refuse it: the gate's blockers, the
|
|
53
|
+
// actionable-criteria rule and a unique id (measured: both refused where `seal` was said).
|
|
54
|
+
const blockers = (0, approval_blockers_1.approvalBlockers)(s, (x) => byId.get(x) ?? null);
|
|
55
|
+
const criteria = (0, approval_blockers_1.unactionableCriteriaBlocker)(s);
|
|
56
|
+
if (criteria)
|
|
57
|
+
blockers.push(criteria);
|
|
58
|
+
if ((idCount.get(s.id) ?? 0) > 1)
|
|
59
|
+
blockers.push(`${s.id} exists more than once in the store — resolve the duplicate first`);
|
|
60
|
+
if (blockers.length > 0)
|
|
61
|
+
out.push({ id: s.id, action: 'fix-then-seal', reason: blockers.slice(0, 2).join('; ').slice(0, 400) });
|
|
62
|
+
else
|
|
63
|
+
out.push({ id: s.id, action: 'seal', reason: 'every parent is sealed and nothing blocks approval — spec_approve' });
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
else if (s.type === 'A-SPEC' && s.status === 'approved' && s.id.startsWith('A-SPEC-') && !withLiveT.has(s.id)) {
|
|
67
|
+
const tspec = `T-SPEC-${s.id.slice('A-SPEC-'.length)}`;
|
|
68
|
+
const mirror = byId.get(tspec);
|
|
69
|
+
out.push(mirror
|
|
70
|
+
? { id: tspec, action: 'author-tspec', reason: `${tspec} exists but is ${mirror.status} and no live T-SPEC depends on ${s.id} — author a new T-SPEC depending on ${s.id}, write the tests, seal it` }
|
|
71
|
+
: { id: tspec, action: 'author-tspec', reason: `${s.id} is sealed and no T-SPEC depends on it — spec_create ${tspec} (depends_on ${s.id}), write the tests, seal it` });
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
return out;
|
|
75
|
+
}
|
|
76
|
+
function chainOf(specs, id) {
|
|
77
|
+
const byId = new Map(specs.map((s) => [s.id, s]));
|
|
78
|
+
const children = new Map();
|
|
79
|
+
for (const s of specs)
|
|
80
|
+
for (const d of s.dependsOn ?? []) {
|
|
81
|
+
const list = children.get(d);
|
|
82
|
+
if (list)
|
|
83
|
+
list.push(s);
|
|
84
|
+
else
|
|
85
|
+
children.set(d, [s]);
|
|
86
|
+
}
|
|
87
|
+
const seen = new Set([id]);
|
|
88
|
+
const walk = (start, step) => {
|
|
89
|
+
const todo = [start];
|
|
90
|
+
while (todo.length > 0) {
|
|
91
|
+
for (const n of step(todo.pop()))
|
|
92
|
+
if (!seen.has(n)) {
|
|
93
|
+
seen.add(n);
|
|
94
|
+
todo.push(n);
|
|
95
|
+
}
|
|
96
|
+
}
|
|
97
|
+
};
|
|
98
|
+
walk(id, (x) => (byId.get(x)?.dependsOn ?? []).filter((d) => byId.has(d)));
|
|
99
|
+
walk(id, (x) => (children.get(x) ?? []).map((c) => c.id));
|
|
100
|
+
const rank = (s) => { const i = spec_types_1.SPEC_ORDER.indexOf(s.type); return i < 0 ? spec_types_1.SPEC_ORDER.length : i; };
|
|
101
|
+
return [...seen].map((x) => byId.get(x)).sort((a, b) => rank(a) - rank(b) || idOrder(a.id, b.id));
|
|
102
|
+
}
|
|
7
103
|
function createSpecQueryHandlers(context) {
|
|
8
104
|
return {
|
|
9
105
|
async spec_validate(a) {
|
|
@@ -60,15 +156,26 @@ function createSpecQueryHandlers(context) {
|
|
|
60
156
|
}),
|
|
61
157
|
};
|
|
62
158
|
},
|
|
63
|
-
async spec_next() {
|
|
159
|
+
async spec_next(a) {
|
|
64
160
|
const specs = await context.listSpecs();
|
|
65
|
-
// 다음에 작성 가능한 첫 미승인 단계
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
if (!
|
|
69
|
-
return {
|
|
161
|
+
// 다음에 작성 가능한 첫 미승인 단계 (v0.1 — kept for existing callers; see NEXT_NOTE)
|
|
162
|
+
const next = spec_types_1.SPEC_ORDER.find((t) => !specs.some((s) => s.type === t && s.status === 'approved')) ?? null;
|
|
163
|
+
if (typeof a?.id === 'string' && a.id !== '') {
|
|
164
|
+
if (!specs.some((s) => s.id === a.id))
|
|
165
|
+
return { ok: false, reason: `spec ${a.id} not found in the governed store` };
|
|
166
|
+
const chain = chainOf(specs, a.id);
|
|
167
|
+
const rank = new Map(chain.map((s, i) => [s.id, i]));
|
|
168
|
+
const actions = nextActions(specs, new Set(chain.map((s) => s.id)))
|
|
169
|
+
.sort((x, y) => (rank.get(x.id) ?? rank.get(x.id.replace(/^T-/, 'A-')) ?? 0) - (rank.get(y.id) ?? rank.get(y.id.replace(/^T-/, 'A-')) ?? 0));
|
|
170
|
+
return {
|
|
171
|
+
next, actions: actions.slice(0, CHAIN_ACTIONS_SHOWN), actionsTotal: actions.length,
|
|
172
|
+
chain: chain.slice(0, CHAIN_ROWS_SHOWN).map((s) => ({ id: s.id, type: s.type, status: s.status, sealed: !!(0, spec_digest_1.sealOf)(s).approvedDigest })),
|
|
173
|
+
chainTotal: chain.length,
|
|
174
|
+
note: NEXT_NOTE,
|
|
175
|
+
};
|
|
70
176
|
}
|
|
71
|
-
|
|
177
|
+
const all = nextActions([...specs].sort((x, y) => idOrder(x.id, y.id))).filter((x) => x.action !== 'after-parent');
|
|
178
|
+
return { next, actions: all.slice(0, ACTIONS_SHOWN), actionsTotal: all.length, note: NEXT_NOTE };
|
|
72
179
|
},
|
|
73
180
|
};
|
|
74
181
|
}
|
|
@@ -34,10 +34,11 @@ var __importStar = (this && this.__importStar) || (function () {
|
|
|
34
34
|
})();
|
|
35
35
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
36
36
|
exports.createTestExecutionHandlers = createTestExecutionHandlers;
|
|
37
|
-
// @implements A-SPEC-616, A-SPEC-100.2, A-SPEC-102.1, A-SPEC-121.2, A-SPEC-121.3, A-SPEC-128, A-SPEC-130, A-SPEC-189, A-SPEC-233, A-SPEC-419, A-SPEC-433, A-SPEC-534.5, A-SPEC-534.8, A-SPEC-578.4, A-SPEC-614
|
|
37
|
+
// @implements A-SPEC-616, A-SPEC-100.2, A-SPEC-102.1, A-SPEC-121.2, A-SPEC-121.3, A-SPEC-128, A-SPEC-130, A-SPEC-189, A-SPEC-233, A-SPEC-419, A-SPEC-433, A-SPEC-534.5, A-SPEC-534.8, A-SPEC-578.4, A-SPEC-614, A-SPEC-734
|
|
38
38
|
const fs = __importStar(require("node:fs"));
|
|
39
39
|
const path = __importStar(require("node:path"));
|
|
40
40
|
const node_child_process_1 = require("node:child_process");
|
|
41
|
+
const cpg_scanner_1 = require("../../cpg/cpg-scanner");
|
|
41
42
|
const change_source_1 = require("../../project/change-source");
|
|
42
43
|
const root_1 = require("../../project/root");
|
|
43
44
|
const ignore_1 = require("../../project/ignore");
|
|
@@ -53,6 +54,7 @@ const kills_check_1 = require("../../review/kills-check");
|
|
|
53
54
|
const test_evidence_1 = require("../../review/test-evidence");
|
|
54
55
|
const test_outcomes_1 = require("../../review/test-outcomes");
|
|
55
56
|
const maintenance_evidence_1 = require("../maintenance-evidence");
|
|
57
|
+
const bounded_io_1 = require("../../project/bounded-io");
|
|
56
58
|
// @implements A-SPEC-534.8
|
|
57
59
|
// The governed source file a `kills` mutation targets: one that @implements the A-SPEC AND contains
|
|
58
60
|
// the `where` literal. Bounded walk, skips vendored/test/hidden dirs. null when none qualifies.
|
|
@@ -78,12 +80,16 @@ function sourceFileWithMutation(root, aspecId, where) {
|
|
|
78
80
|
|| e.name === 'vendor' || e.name === 'third_party' || e.name.startsWith('.'))
|
|
79
81
|
continue;
|
|
80
82
|
const p = path.join(d, e.name);
|
|
83
|
+
// @implements A-SPEC-734 (round 10) — a foreign clone sorting first could become the mutation target.
|
|
81
84
|
if (e.isDirectory()) {
|
|
82
|
-
|
|
85
|
+
if (!(0, cpg_scanner_1.isNestedWorkTree)(p, root))
|
|
86
|
+
walk(p);
|
|
83
87
|
continue;
|
|
84
88
|
}
|
|
85
89
|
if (!SOURCE.test(e.name) || /\.test\./.test(e.name))
|
|
86
90
|
continue;
|
|
91
|
+
if (!(0, cpg_scanner_1.isRegularSource)(e, p, root))
|
|
92
|
+
continue;
|
|
87
93
|
let text;
|
|
88
94
|
try {
|
|
89
95
|
text = fs.readFileSync(p, 'utf8');
|
|
@@ -159,7 +165,7 @@ function createTestExecutionHandlers(context) {
|
|
|
159
165
|
const executedByAspec = (0, test_evidence_1.computeExecutedByAspec)(result.executedByFile ?? {}, anchors);
|
|
160
166
|
let head = '';
|
|
161
167
|
try {
|
|
162
|
-
head = (0, node_child_process_1.execFileSync)('git', ['-C', root, 'rev-parse', 'HEAD'], { encoding: 'utf8', env: (0, root_1.cleanSubprocessEnv)(), stdio: ['ignore', 'pipe', 'pipe'] }).trim();
|
|
168
|
+
head = (0, node_child_process_1.execFileSync)('git', ['-C', root, 'rev-parse', 'HEAD'], { timeout: bounded_io_1.GIT_TIMEOUT_MS, maxBuffer: bounded_io_1.GIT_MAX_BUFFER, encoding: 'utf8', env: (0, root_1.cleanSubprocessEnv)(), stdio: ['ignore', 'pipe', 'pipe'] }).trim();
|
|
163
169
|
}
|
|
164
170
|
catch { /* non-git */ }
|
|
165
171
|
// Record ONLY an actually-executed, GREEN run (review C4/C7): a red suite must not stand as
|