peaks-loop 4.1.4 → 4.1.5
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/.claude-plugin/marketplace.json +7 -2
- package/CHANGELOG.md +112 -0
- package/README-en.md +1 -1
- package/README.md +1 -1
- package/dist/cli/cli-helpers.d.ts +20 -0
- package/dist/cli/cli-helpers.js +34 -0
- package/dist/cli/commands/_register.js +2 -0
- package/dist/cli/commands/code-commands.d.ts +6 -4
- package/dist/cli/commands/code-commands.js +6 -4
- package/dist/cli/commands/code-gate-command.d.ts +5 -5
- package/dist/cli/commands/code-gate-command.js +49 -9
- package/dist/cli/commands/code-mode-gate-plan-command.d.ts +1 -1
- package/dist/cli/commands/code-mode-gate-plan-command.js +2 -2
- package/dist/cli/commands/core/memory-extract-command.js +10 -5
- package/dist/cli/commands/dispatch-cli-invocation-check.d.ts +108 -0
- package/dist/cli/commands/dispatch-cli-invocation-check.js +87 -0
- package/dist/cli/commands/dispatch-cli-invocation-scan.d.ts +66 -0
- package/dist/cli/commands/dispatch-cli-invocation-scan.js +162 -0
- package/dist/cli/commands/dispatch-commands.js +12 -5
- package/dist/cli/commands/dispatch-preflight.js +46 -0
- package/dist/cli/commands/dispatch-prompt-composition.d.ts +6 -0
- package/dist/cli/commands/dispatch-prompt-composition.js +29 -7
- package/dist/cli/commands/doc-commands.js +1 -1
- package/dist/cli/commands/feedback-commands-helpers.js +1 -1
- package/dist/cli/commands/final-review-prepare-command.js +22 -1
- package/dist/cli/commands/gate-commands-enforce.js +3 -3
- package/dist/cli/commands/hook-handle.js +41 -20
- package/dist/cli/commands/lint-commands.js +3 -1
- package/dist/cli/commands/loop-eval-capture-index.js +2 -4
- package/dist/cli/commands/perf-audit-commands.js +15 -5
- package/dist/cli/commands/project-commands.js +9 -6
- package/dist/cli/commands/race-commands.d.ts +15 -0
- package/dist/cli/commands/race-commands.js +65 -0
- package/dist/cli/commands/race-pilot-gate-record-command.d.ts +3 -0
- package/dist/cli/commands/race-pilot-gate-record-command.js +81 -0
- package/dist/cli/commands/request-command-options.d.ts +8 -0
- package/dist/cli/commands/request-commands.js +2 -0
- package/dist/cli/commands/request-init-command.js +67 -12
- package/dist/cli/commands/request-retag-command.d.ts +3 -0
- package/dist/cli/commands/request-retag-command.js +50 -0
- package/dist/cli/commands/request-show-command.d.ts +8 -0
- package/dist/cli/commands/request-show-command.js +14 -1
- package/dist/cli/commands/request-transition-command.js +12 -4
- package/dist/cli/commands/request-transition-failures.d.ts +14 -0
- package/dist/cli/commands/request-transition-failures.js +45 -3
- package/dist/cli/commands/scan-scope-commands.js +2 -2
- package/dist/cli/commands/security-audit-commands.js +26 -6
- package/dist/cli/commands/worktree-lease-gc-command.js +1 -1
- package/dist/services/artifacts/artifact-contract-block.d.ts +53 -0
- package/dist/services/artifacts/artifact-contract-block.js +212 -0
- package/dist/services/artifacts/artifact-prerequisites.d.ts +27 -19
- package/dist/services/artifacts/artifact-prerequisites.js +63 -133
- package/dist/services/artifacts/artifact-templates.d.ts +1 -1
- package/dist/services/artifacts/artifact-templates.js +17 -10
- package/dist/services/artifacts/prerequisite-checks.d.ts +87 -0
- package/dist/services/artifacts/prerequisite-checks.js +198 -0
- package/dist/services/artifacts/prerequisite-transition-event.d.ts +20 -0
- package/dist/services/artifacts/prerequisite-transition-event.js +27 -0
- package/dist/services/artifacts/request-artifact-metadata.d.ts +31 -0
- package/dist/services/artifacts/request-artifact-metadata.js +44 -0
- package/dist/services/artifacts/request-artifact-service.d.ts +5 -0
- package/dist/services/artifacts/request-artifact-service.js +23 -51
- package/dist/services/artifacts/request-artifact-state-helpers.d.ts +12 -0
- package/dist/services/artifacts/request-artifact-state-helpers.js +28 -4
- package/dist/services/artifacts/request-retag-service.d.ts +68 -0
- package/dist/services/artifacts/request-retag-service.js +125 -0
- package/dist/services/artifacts/request-state-order.d.ts +38 -0
- package/dist/services/artifacts/request-state-order.js +99 -0
- package/dist/services/artifacts/request-type-demand.d.ts +44 -0
- package/dist/services/artifacts/request-type-demand.js +71 -0
- package/dist/services/audit/audit-goal-service.d.ts +7 -0
- package/dist/services/audit/enforcers/active-skill-resolver.d.ts +18 -0
- package/dist/services/audit/enforcers/active-skill-resolver.js +48 -1
- package/dist/services/audit/enforcers/code-ban.d.ts +11 -2
- package/dist/services/audit/enforcers/code-ban.js +21 -1
- package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.d.ts +17 -0
- package/dist/services/audit/red-line-catalog-p2-a-bee-runtime.js +24 -7
- package/dist/services/audit-independent/handoff-missing-refusal.d.ts +26 -0
- package/dist/services/audit-independent/handoff-missing-refusal.js +109 -0
- package/dist/services/audit-independent/handoff-readers.d.ts +37 -0
- package/dist/services/audit-independent/handoff-readers.js +81 -0
- package/dist/services/audit-independent/index.d.ts +6 -1
- package/dist/services/audit-independent/index.js +6 -1
- package/dist/services/audit-independent/judged-declaration-build.d.ts +48 -0
- package/dist/services/audit-independent/judged-declaration-build.js +73 -0
- package/dist/services/audit-independent/judged-declaration-check.d.ts +79 -0
- package/dist/services/audit-independent/judged-declaration-check.js +155 -0
- package/dist/services/audit-independent/judged-declaration.d.ts +94 -0
- package/dist/services/audit-independent/judged-declaration.js +218 -0
- package/dist/services/audit-independent/perf-audit-service.js +12 -14
- package/dist/services/audit-independent/security-audit-artifact.d.ts +28 -0
- package/dist/services/audit-independent/security-audit-artifact.js +90 -0
- package/dist/services/audit-independent/security-audit-service.d.ts +6 -53
- package/dist/services/audit-independent/security-audit-service.js +34 -178
- package/dist/services/capability-guard-runner/contracts/J05.js +60 -14
- package/dist/services/codegraph/codegraph-index-integrity.js +2 -0
- package/dist/services/context/build-dispatch-system-prompt.d.ts +3 -3
- package/dist/services/context/build-dispatch-system-prompt.js +7 -7
- package/dist/services/context/collector.js +5 -1
- package/dist/services/dispatch/active-dispatch-index.d.ts +36 -0
- package/dist/services/dispatch/active-dispatch-index.js +118 -0
- package/dist/services/dispatch/batch-counter.js +1 -2
- package/dist/services/dispatch/dispatch-record-writer.d.ts +29 -16
- package/dist/services/dispatch/dispatch-record-writer.js +58 -100
- package/dist/services/dispatch/dispatch-sub-agent.js +1 -1
- package/dist/services/dispatch/karpathy-block.d.ts +55 -0
- package/dist/services/dispatch/karpathy-block.js +101 -0
- package/dist/services/dispatch/ledger-reaper.d.ts +80 -0
- package/dist/services/dispatch/ledger-reaper.js +131 -0
- package/dist/services/evidence/evidence-generator.js +15 -8
- package/dist/services/feedback/feedback-promotion-service.d.ts +8 -11
- package/dist/services/feedback/feedback-promotion-service.js +30 -35
- package/dist/services/feedback/promotion-artifact-json-evidence.d.ts +18 -0
- package/dist/services/feedback/promotion-artifact-missing.d.ts +22 -0
- package/dist/services/feedback/promotion-artifact-missing.js +63 -0
- package/dist/services/final-review/final-review-contract.d.ts +95 -4
- package/dist/services/final-review/final-review-contract.js +64 -0
- package/dist/services/final-review/final-review-delivery.d.ts +13 -0
- package/dist/services/final-review/final-review-delivery.js +26 -12
- package/dist/services/final-review/final-review-evidence-collect.js +8 -53
- package/dist/services/final-review/final-review-evidence-records.d.ts +21 -0
- package/dist/services/final-review/final-review-evidence-records.js +67 -0
- package/dist/services/final-review/final-review-evidence-sources.d.ts +22 -0
- package/dist/services/final-review/final-review-evidence-sources.js +28 -4
- package/dist/services/final-review/final-review-prompt.js +19 -6
- package/dist/services/final-review/final-review-runner.js +5 -0
- package/dist/services/final-review/final-review-service.d.ts +2 -2
- package/dist/services/final-review/index.d.ts +1 -1
- package/dist/services/final-review/pre-post-diff.d.ts +2 -75
- package/dist/services/final-review/pre-post-diff.js +60 -59
- package/dist/services/hooks/pre-tool-code-gate.d.ts +7 -1
- package/dist/services/hooks/pre-tool-code-gate.js +21 -2
- package/dist/services/hooks/worktree-authorization-gate.js +6 -31
- package/dist/services/hooks/worktree-refusal-messages.d.ts +74 -0
- package/dist/services/hooks/worktree-refusal-messages.js +102 -0
- package/dist/services/lint/eslint-runner-support.d.ts +1 -1
- package/dist/services/lint/eslint-runner-support.js +2 -1
- package/dist/services/lint/eslint-runner-types.d.ts +8 -0
- package/dist/services/lint/eslint-runner.js +17 -4
- package/dist/services/llm/anthropic-runner.js +24 -7
- package/dist/services/loop/loop-observability.d.ts +39 -0
- package/dist/services/loop/loop-observability.js +55 -0
- package/dist/services/loop/monotonic-guard.js +6 -9
- package/dist/services/loop/monotonic-runner.js +8 -7
- package/dist/services/loop/run-driver.js +18 -22
- package/dist/services/memory/project-memory-service/index/kind-dispatch.js +14 -1
- package/dist/services/memory/project-memory-service/index/project-memory-plan-exec.js +13 -2
- package/dist/services/memory/project-memory-service/index.d.ts +2 -2
- package/dist/services/memory/project-memory-service/index.js +1 -1
- package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.d.ts +36 -0
- package/dist/services/memory/project-memory-service/parsers/frontmatter-parse.js +48 -2
- package/dist/services/memory/project-memory-service/parsers/markdown-pure.d.ts +23 -1
- package/dist/services/memory/project-memory-service/parsers/markdown-pure.js +37 -0
- package/dist/services/memory/project-memory-service/types.d.ts +32 -0
- package/dist/services/observability/observability-service.d.ts +7 -0
- package/dist/services/observability/observability-service.js +2 -1
- package/dist/services/prd/gate-evidence-derivation.d.ts +4 -3
- package/dist/services/prd/gate-evidence-derivation.js +4 -3
- package/dist/services/qa/bdd-test-style-verifier.js +22 -8
- package/dist/services/race/gate2-evaluator.d.ts +58 -0
- package/dist/services/race/gate2-evaluator.js +111 -0
- package/dist/services/race/gate2-policy.d.ts +17 -0
- package/dist/services/race/gate2-policy.js +31 -0
- package/dist/services/race/lane-phase.d.ts +19 -0
- package/dist/services/race/lane-phase.js +113 -0
- package/dist/services/race/pilot-gate-store.d.ts +67 -0
- package/dist/services/race/pilot-gate-store.js +227 -0
- package/dist/services/scan/file-size-baseline.d.ts +26 -0
- package/dist/services/scan/file-size-baseline.js +150 -0
- package/dist/services/scan/file-size-scan.d.ts +42 -3
- package/dist/services/scan/file-size-scan.js +58 -42
- package/dist/services/scan/type-sanity-service.js +13 -3
- package/dist/services/skill/resume-detector.js +3 -3
- package/dist/services/skills/hooks-codegate-superpowers.d.ts +5 -6
- package/dist/services/skills/hooks-codegate-superpowers.js +7 -8
- package/dist/services/skills/hooks-settings-service.d.ts +1 -1
- package/dist/services/skills/hooks-settings-service.js +1 -1
- package/dist/services/skills/presence-lease-order.d.ts +13 -0
- package/dist/services/skills/presence-lease-order.js +24 -0
- package/dist/services/skills/skill-conformance-service.js +1 -0
- package/dist/services/skills/skill-statusline-service.js +4 -7
- package/dist/services/slice/slice-check-service.js +8 -8
- package/dist/services/workflow/pipeline-verify-gate-support.js +2 -1
- package/dist/services/workflow/pipeline-verify-service.js +1 -1
- package/dist/services/workflow/workflow-skip-service.d.ts +0 -20
- package/dist/services/workflow/workflow-skip-service.js +3 -4
- package/dist/services/workspace/claude-settings-retirements.d.ts +54 -0
- package/dist/services/workspace/claude-settings-retirements.js +112 -0
- package/dist/services/workspace/claude-settings-template-merge.d.ts +35 -15
- package/dist/services/workspace/claude-settings-template-merge.js +33 -53
- package/dist/services/workspace/claude-settings-template.d.ts +62 -12
- package/dist/services/workspace/claude-settings-template.js +58 -58
- package/dist/services/workspace/migrate-1-4-1-service.js +3 -0
- package/dist/services/workspace/reconcile-service.js +0 -1
- package/dist/shared/incrementing-number.d.ts +10 -0
- package/dist/shared/incrementing-number.js +27 -0
- package/package.json +5 -5
- package/skills/bee/peaks-perf-audit/SKILL.md +1 -1
- package/skills/bee/peaks-prd/SKILL.md +1 -1
- package/skills/bee/peaks-qa/SKILL.md +1 -1
- package/skills/bee/peaks-qa/references/qa-sub-agent-dispatch.md +2 -2
- package/skills/bee/peaks-qa/references/qa-transition-gates.md +1 -1
- package/skills/bee/peaks-rd/SKILL.md +2 -2
- package/skills/bee/peaks-rd/references/rd-fanout-contracts.md +1 -1
- package/skills/bee/peaks-rd/references/rd-sub-agent-dispatch.md +8 -4
- package/skills/bee/peaks-rd/references/rd-transition-gates.md +3 -3
- package/skills/bee/peaks-rd/references/v2-12-fanout-collapse.md +2 -2
- package/skills/bee/peaks-rd/references/writing-handoff-frontmatter.md +1 -1
- package/skills/bee/peaks-reviewer/SKILL.md +1 -1
- package/skills/bee/peaks-sc/SKILL.md +1 -1
- package/skills/bee/peaks-security-audit/SKILL.md +10 -2
- package/skills/bee/peaks-txt/SKILL.md +4 -3
- package/skills/bee/peaks-ui/SKILL.md +3 -3
- package/skills/peaks-audit/SKILL.md +29 -1
- package/skills/peaks-code/SKILL.md +5 -2
- package/skills/peaks-code/references/fast-lane-norm.md +42 -0
- package/skills/peaks-code/references/fast-mode.md +3 -2
- package/skills/peaks-code/references/local-artifact-workspace.md +3 -3
- package/skills/peaks-code/references/micro-cycle.md +3 -3
- package/skills/peaks-code/references/resume-detection.md +1 -1
- package/skills/peaks-code/references/runbook.md +12 -6
- package/skills/peaks-code/references/step-11-memory-sediment.md +4 -0
- package/skills/peaks-code/references/sub-agent-dispatch.md +1 -1
- package/skills/peaks-code/references/swarm-dispatch-contract.md +40 -16
- package/skills/peaks-code/references/workflow-gates-and-types.md +6 -6
- package/skills/peaks-code/references/worktree-governance.md +4 -4
- package/skills/peaks-content/SKILL.md +1 -1
- package/skills/peaks-doctor/SKILL.md +1 -1
- package/skills/peaks-final-review/SKILL.md +31 -11
- package/skills/peaks-ide/SKILL.md +1 -1
- package/skills/peaks-issue-fix-orchestrator/SKILL.md +1 -1
- package/skills/peaks-race-code/SKILL.md +185 -0
- package/skills/peaks-resume/SKILL.md +1 -1
- package/skills/peaks-slice-decompose/SKILL.md +1 -1
- package/skills/peaks-solo/SKILL.md +1 -1
- package/skills/peaks-sop/SKILL.md +1 -1
- package/skills/peaks-status/SKILL.md +1 -1
- package/skills/peaks-test/SKILL.md +7 -4
- package/dist/services/audit/enforcers/lint-peaks-skill-runtime.d.ts +0 -23
- package/dist/services/audit/enforcers/lint-peaks-skill-runtime.js +0 -64
|
@@ -7,31 +7,27 @@
|
|
|
7
7
|
* load-bearing: it reads `.peaks/_runtime/<sid>/loop/<rid>/spec.yaml`,
|
|
8
8
|
* walks each `evaluators[].kind` in order via `dispatchEvaluator`,
|
|
9
9
|
* captures a score row, persists the current cycle to disk, runs the
|
|
10
|
-
* monotonic guard against the prior cycle,
|
|
11
|
-
*
|
|
10
|
+
* monotonic guard against the prior cycle, emits that cycle's `cycle` and
|
|
11
|
+
* `monotonic-trigger` events (`loop-observability.ts`), and decides
|
|
12
|
+
* whether to continue / abort based on `termination.strategy`.
|
|
12
13
|
*
|
|
13
|
-
* Strategy semantics:
|
|
14
|
-
*
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
* the operator's responsibility.
|
|
19
|
-
* - anything else: `UNKNOWN_TERMINATION_STRATEGY`.
|
|
14
|
+
* Strategy semantics: `monotonic-violation` (default) aborts on
|
|
15
|
+
* MONOTONICITY_VIOLATION; `max-cycles` runs exactly `termination.maxCycles`
|
|
16
|
+
* (default 5), aborting on any violation along the way; `manual` runs exactly
|
|
17
|
+
* one cycle and exits 0, further cycles being the operator's responsibility;
|
|
18
|
+
* anything else is `UNKNOWN_TERMINATION_STRATEGY`.
|
|
20
19
|
*
|
|
21
|
-
* Karpathy §2 Simplicity First: no new deps. Pure
|
|
22
|
-
*
|
|
23
|
-
*
|
|
24
|
-
* index; cross-process locking is out of scope per the dispatch
|
|
25
|
-
* prompt.
|
|
26
|
-
*
|
|
27
|
-
* File budget: ≤ 800 lines.
|
|
20
|
+
* Karpathy §2 Simplicity First: no new deps. Pure data + JSON to disk. The
|
|
21
|
+
* in-process lock flag stops two concurrent `peaks loop run` calls (same
|
|
22
|
+
* sid+rid) corrupting the cycle index; cross-process locking is out of scope.
|
|
28
23
|
*/
|
|
29
|
-
import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
|
|
24
|
+
import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
|
|
30
25
|
import { join } from 'node:path';
|
|
31
26
|
import { resolveLoopSpec, lintLoopSpec, specPath, MONOTONIC_TERMINATION, DEFAULT_MAX_CYCLES } from './spec-service.js';
|
|
32
27
|
import { dispatchEvaluator } from './evaluator-dispatcher.js';
|
|
33
28
|
import { checkMonotonicImprovement, toScoreRow, DEFAULT_MONOTONIC_THRESHOLD } from './monotonic-guard.js';
|
|
34
29
|
import { nextCycleIndex, sliceDir } from './monotonic-runner.js';
|
|
30
|
+
import { emitCycleOutcome, emitMonotonicReport } from './loop-observability.js';
|
|
35
31
|
import { findProjectRoot } from '../config/config-safety.js';
|
|
36
32
|
function classifyFsError(err) {
|
|
37
33
|
const code = err?.code;
|
|
@@ -278,7 +274,11 @@ function runLoopLocked(spec, strategy, maxCycles, options) {
|
|
|
278
274
|
? persistCycleRecord(options.projectRoot, options.sid, options.rid, cycleNo, rows)
|
|
279
275
|
: null;
|
|
280
276
|
const record = buildCycleRecord(cycleNo, rows, previousCycle, threshold, persistedAt);
|
|
277
|
+
// The guard is pure and holds no binding, so the caller emits for it; one
|
|
278
|
+
// `cycle` event per cycle, after the push, or the per-event count doubles.
|
|
279
|
+
emitMonotonicReport(options.projectRoot, options.sid, record.monotonicReport);
|
|
281
280
|
cycles.push(record);
|
|
281
|
+
emitCycleOutcome(options.projectRoot, options.sid, cycleNo, record.monotonicReport);
|
|
282
282
|
finalReport = record.monotonicReport;
|
|
283
283
|
if (record.monotonicReport.monotonicityViolation) {
|
|
284
284
|
regressionCount += record.monotonicReport.regressions.length;
|
|
@@ -344,13 +344,9 @@ function loadCycleAt(projectRoot, sid, rid, n) {
|
|
|
344
344
|
return parseCycleFromPath(path, n);
|
|
345
345
|
}
|
|
346
346
|
function parseCycleFromPath(path, fallbackCycle) {
|
|
347
|
-
// Defer to monotonic-runner via a lazy require (the function is
|
|
348
|
-
// small and avoids leaking its internals).
|
|
349
|
-
// eslint-disable-next-line @typescript-eslint/no-var-requires
|
|
350
|
-
const fs = require('node:fs');
|
|
351
347
|
const readFile = (() => {
|
|
352
348
|
try {
|
|
353
|
-
return { ok: true, value:
|
|
349
|
+
return { ok: true, value: readFileSync(path, 'utf8') };
|
|
354
350
|
}
|
|
355
351
|
catch (err) {
|
|
356
352
|
return { ok: false, reason: classifyFsError(err) };
|
|
@@ -62,6 +62,7 @@ export function extractSessionMemories(options) {
|
|
|
62
62
|
extractedCount: 0,
|
|
63
63
|
writtenFiles: [],
|
|
64
64
|
updatedIndex: false,
|
|
65
|
+
skippedWrites: [],
|
|
65
66
|
droppedBlocks: [],
|
|
66
67
|
scanFailures: []
|
|
67
68
|
};
|
|
@@ -116,6 +117,7 @@ export function extractSessionMemories(options) {
|
|
|
116
117
|
extractedCount: 0,
|
|
117
118
|
writtenFiles: [],
|
|
118
119
|
updatedIndex: false,
|
|
120
|
+
skippedWrites: [],
|
|
119
121
|
droppedBlocks,
|
|
120
122
|
scanFailures
|
|
121
123
|
};
|
|
@@ -136,12 +138,22 @@ export function extractSessionMemories(options) {
|
|
|
136
138
|
// writes so callers can still tell what the run actually produced.
|
|
137
139
|
const existingNames = apply ? readStoredMemoryNames(primaryMemoryDir) : new Set();
|
|
138
140
|
const writtenFiles = [];
|
|
141
|
+
const skippedWrites = [];
|
|
139
142
|
if (apply) {
|
|
140
143
|
mkdirSync(primaryMemoryDir, { recursive: true });
|
|
141
144
|
for (const memory of allExtracted) {
|
|
142
145
|
const slug = slugify(memory.title);
|
|
143
|
-
if (existingNames.has(slug))
|
|
146
|
+
if (existingNames.has(slug)) {
|
|
147
|
+
// Same defect as the artifact path, one function over: the skip left no
|
|
148
|
+
// trace, so `extractedCount: 5` with 4 files on disk read as success.
|
|
149
|
+
skippedWrites.push({
|
|
150
|
+
slug,
|
|
151
|
+
title: memory.title,
|
|
152
|
+
sourceArtifact: memory.sourceArtifact,
|
|
153
|
+
filePath: join(primaryMemoryDir, `${slug}.md`)
|
|
154
|
+
});
|
|
144
155
|
continue;
|
|
156
|
+
}
|
|
145
157
|
const targetPath = join(primaryMemoryDir, `${slug}.md`);
|
|
146
158
|
const safePath = resolveInputPath(targetPath);
|
|
147
159
|
const stableSafePath = stablePath(safePath);
|
|
@@ -163,6 +175,7 @@ export function extractSessionMemories(options) {
|
|
|
163
175
|
extractedCount: allExtracted.length,
|
|
164
176
|
writtenFiles,
|
|
165
177
|
updatedIndex: apply && writtenFiles.length > 0,
|
|
178
|
+
skippedWrites,
|
|
166
179
|
droppedBlocks,
|
|
167
180
|
scanFailures
|
|
168
181
|
};
|
|
@@ -61,6 +61,7 @@ export function createProjectMemoryExtractPlan(options) {
|
|
|
61
61
|
export function executeProjectMemoryExtract(options) {
|
|
62
62
|
const plan = createProjectMemoryExtractPlan(options);
|
|
63
63
|
const writtenFiles = [];
|
|
64
|
+
const skippedWrites = [];
|
|
64
65
|
if (plan.apply) {
|
|
65
66
|
mkdirSync(plan.primaryMemoryDir, { recursive: true });
|
|
66
67
|
const safeMemoryDir = assertSafeProjectMemoryDir(plan.projectRoot);
|
|
@@ -74,8 +75,18 @@ export function executeProjectMemoryExtract(options) {
|
|
|
74
75
|
const existingNames = readStoredMemoryNames(plan.primaryMemoryDir);
|
|
75
76
|
for (const write of plan.plannedWrites) {
|
|
76
77
|
const slug = slugify(write.memory.title);
|
|
77
|
-
if (existingNames.has(slug))
|
|
78
|
+
if (existingNames.has(slug)) {
|
|
79
|
+
// Recorded, not merely skipped: a skip and a successful write left
|
|
80
|
+
// identical evidence in the envelope, so the block vanished from the
|
|
81
|
+
// report of a run that had extracted it.
|
|
82
|
+
skippedWrites.push({
|
|
83
|
+
slug,
|
|
84
|
+
title: write.memory.title,
|
|
85
|
+
sourceArtifact: write.memory.sourceArtifact,
|
|
86
|
+
filePath: write.filePath
|
|
87
|
+
});
|
|
78
88
|
continue;
|
|
89
|
+
}
|
|
79
90
|
const targetPath = resolveInputPath(write.filePath);
|
|
80
91
|
const stableTargetPath = stablePath(targetPath);
|
|
81
92
|
if (!isInsidePath(stableTargetPath, stableRealPath(safeMemoryDir))) {
|
|
@@ -97,7 +108,7 @@ export function executeProjectMemoryExtract(options) {
|
|
|
97
108
|
const indexPath = join(plan.primaryMemoryDir, 'index.json');
|
|
98
109
|
generateMemoryIndexFile(plan.projectRoot, plan.primaryMemoryDir, indexPath);
|
|
99
110
|
}
|
|
100
|
-
return { ...plan, writtenFiles };
|
|
111
|
+
return { ...plan, writtenFiles, skippedWrites };
|
|
101
112
|
}
|
|
102
113
|
export function createProjectMemoryBackupPlan(options) {
|
|
103
114
|
const projectRoot = normalizeRoot(options.projectRoot);
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
export type { BackupPlanOptions, ExtractedProjectMemory, MemoryBlockDrop, MemoryBlockDropReason, MemoryBlockParse, MemoryKindTier, ExtractPlanOptions, ExtractSessionMemoriesOptions, ExtractSessionMemoriesResult, MemoryIndex, MemoryIndexEntry, ProjectMemoryBackupPlan, ProjectMemoryBackupResult, ProjectMemoryBackupSummary, ProjectMemoryCopy, ProjectMemoryExtractPlan, ProjectMemoryExtractResult, ProjectMemoryExtractSummary, ProjectMemoryKind, ProjectMemoryReadResult, ProjectMemoryShowResult, ProjectMemoryWrite, StoredProjectMemory } from './types.js';
|
|
1
|
+
export type { BackupPlanOptions, ExtractedProjectMemory, MemoryBlockDrop, MemoryBlockDropReason, MemoryBlockParse, MemoryKindTier, MemoryWriteSkip, ExtractPlanOptions, ExtractSessionMemoriesOptions, ExtractSessionMemoriesResult, MemoryIndex, MemoryIndexEntry, ProjectMemoryBackupPlan, ProjectMemoryBackupResult, ProjectMemoryBackupSummary, ProjectMemoryCopy, ProjectMemoryExtractPlan, ProjectMemoryExtractResult, ProjectMemoryExtractSummary, ProjectMemoryKind, ProjectMemoryReadResult, ProjectMemoryShowResult, ProjectMemoryWrite, StoredProjectMemory } from './types.js';
|
|
2
2
|
export { VALID_PROJECT_MEMORY_KINDS } from './parsers/frontmatter.js';
|
|
3
3
|
export { HOT_MEMORY_KINDS, MEMORY_KIND_TIER, PROJECT_MEMORY_KINDS, WARM_MEMORY_KINDS } from './types.js';
|
|
4
|
-
export { describeMemoryBlockDrops, describeSessionScanFailures, summarizeBackupResult, summarizeExtractResult, summarizeMemoryBody, extractStableProjectMemories, extractStableProjectMemoriesWithDiagnostics, END_MARKER, START_MARKER } from './parsers/markdown-pure.js';
|
|
4
|
+
export { describeMemoryBlockDrops, describeMemoryWriteSkips, describeSessionScanFailures, MAX_NAMED_MEMORY_WRITE_SKIPS, summarizeBackupResult, summarizeExtractResult, summarizeMemoryBody, extractStableProjectMemories, extractStableProjectMemoriesWithDiagnostics, END_MARKER, START_MARKER } from './parsers/markdown-pure.js';
|
|
5
5
|
export type { SessionScanFailure } from './types.js';
|
|
6
6
|
export type { ExtractedMemoryBlocks } from './parsers/markdown-pure.js';
|
|
7
7
|
export { parseBlock, parseBlockResult, parseMemoryFrontmatter, parseStoredMemoryFile, renderMemoryFile, resolveMemoryKind, resolveMemoryName, slugify } from './parsers/frontmatter.js';
|
|
@@ -14,7 +14,7 @@ export { VALID_PROJECT_MEMORY_KINDS } from './parsers/frontmatter.js';
|
|
|
14
14
|
// Canonical kind vocabulary + hot/warm tier map (slice E)
|
|
15
15
|
export { HOT_MEMORY_KINDS, MEMORY_KIND_TIER, PROJECT_MEMORY_KINDS, WARM_MEMORY_KINDS } from './types.js';
|
|
16
16
|
// Pure markdown helpers
|
|
17
|
-
export { describeMemoryBlockDrops, describeSessionScanFailures, summarizeBackupResult, summarizeExtractResult, summarizeMemoryBody, extractStableProjectMemories, extractStableProjectMemoriesWithDiagnostics, END_MARKER, START_MARKER } from './parsers/markdown-pure.js';
|
|
17
|
+
export { describeMemoryBlockDrops, describeMemoryWriteSkips, describeSessionScanFailures, MAX_NAMED_MEMORY_WRITE_SKIPS, summarizeBackupResult, summarizeExtractResult, summarizeMemoryBody, extractStableProjectMemories, extractStableProjectMemoriesWithDiagnostics, END_MARKER, START_MARKER } from './parsers/markdown-pure.js';
|
|
18
18
|
// Frontmatter parser + renderer
|
|
19
19
|
export { parseBlock, parseBlockResult, parseMemoryFrontmatter, parseStoredMemoryFile, renderMemoryFile, resolveMemoryKind, resolveMemoryName, slugify } from './parsers/frontmatter.js';
|
|
20
20
|
// Store: path safety + sensitive content
|
|
@@ -5,6 +5,42 @@ export declare const VALID_MEMORY_KINDS: ReadonlySet<ProjectMemoryKind>;
|
|
|
5
5
|
/** Exported for guard tests + tooling that needs to enumerate the accepted
|
|
6
6
|
* set (CLI help text, `--kind` validation) without duplicating the literal. */
|
|
7
7
|
export declare const VALID_PROJECT_MEMORY_KINDS: readonly ProjectMemoryKind[];
|
|
8
|
+
/**
|
|
9
|
+
* Filename stem for a memory title, and the `name:` its stored frontmatter
|
|
10
|
+
* carries.
|
|
11
|
+
*
|
|
12
|
+
* The character class is Unicode-aware deliberately. An ASCII-only class
|
|
13
|
+
* reduced EVERY title written in a non-Latin script to the same empty string,
|
|
14
|
+
* so all of them landed on one constant name: whichever title arrived first
|
|
15
|
+
* took that file, and each later one was skipped because the store refuses to
|
|
16
|
+
* overwrite a file it already holds. Two titles that still reduce to one stem
|
|
17
|
+
* are refused outright by the plan builders' duplicate-name check.
|
|
18
|
+
*
|
|
19
|
+
* A title with no letter or digit in any script ("!!!") leaves nothing to build
|
|
20
|
+
* a name from. That branch takes the first 32 hex characters of the title's
|
|
21
|
+
* sha256 instead of a fixed constant, so distinct titles still reach distinct
|
|
22
|
+
* names. It is a DIGEST rather than the title's bytes because of LENGTH: an
|
|
23
|
+
* encoding that grew with the title (the two-hex-chars-per-byte
|
|
24
|
+
* `toString('hex')` this replaced) produced names past the filesystem limit for
|
|
25
|
+
* a long enough title, so the write failed and took the whole batch with it —
|
|
26
|
+
* measured, exit 1 and 0 files for a 140-character title. A digest is 39
|
|
27
|
+
* characters whatever the title is.
|
|
28
|
+
*
|
|
29
|
+
* THE FIXED LENGTH IS BOUGHT WITH A PROBABILISTIC GUARANTEE, and that is the
|
|
30
|
+
* strongest thing this branch can claim. For the derived branch distinct titles
|
|
31
|
+
* reach distinct names with overwhelming probability rather than by
|
|
32
|
+
* construction: a collision needs two titles whose first 128 digest bits agree
|
|
33
|
+
* — the birthday bound puts that at about n^2 / 2^129 for n derived names in one
|
|
34
|
+
* store, i.e. under 1 in 10^26 at a million names. The branch above keeps the
|
|
35
|
+
* stronger, exact property (two titles share a stem only if they are equal
|
|
36
|
+
* modulo case and runs of non-letter/non-digit characters). Neither branch loses
|
|
37
|
+
* a block silently on a collision: within a run the duplicate-name check refuses
|
|
38
|
+
* the whole extract, and across runs the later write is skipped and NAMED in the
|
|
39
|
+
* envelope's `warnings`.
|
|
40
|
+
*
|
|
41
|
+
* The '_' is outside the alphabet the branch above can emit, so a derived name
|
|
42
|
+
* cannot equal a title-derived stem.
|
|
43
|
+
*/
|
|
8
44
|
export declare function slugify(title: string): string;
|
|
9
45
|
/**
|
|
10
46
|
* Single implementation of the extract-path block parse. Returns a
|
|
@@ -7,6 +7,7 @@
|
|
|
7
7
|
// every name here so the `index.ts` barrel, `markdown-pure.ts` and the CLI
|
|
8
8
|
// keep importing them from `./parsers/frontmatter.js` unchanged.
|
|
9
9
|
// ---------------------------------------------------------------------------
|
|
10
|
+
import { createHash } from 'node:crypto';
|
|
10
11
|
import { PROJECT_MEMORY_KINDS } from '../types.js';
|
|
11
12
|
/** Accepted-kind set, derived from the canonical `PROJECT_MEMORY_KINDS`
|
|
12
13
|
* tuple so the parser cannot drift from the union type / tier map. */
|
|
@@ -14,12 +15,57 @@ export const VALID_MEMORY_KINDS = new Set(PROJECT_MEMORY_KINDS);
|
|
|
14
15
|
/** Exported for guard tests + tooling that needs to enumerate the accepted
|
|
15
16
|
* set (CLI help text, `--kind` validation) without duplicating the literal. */
|
|
16
17
|
export const VALID_PROJECT_MEMORY_KINDS = PROJECT_MEMORY_KINDS;
|
|
18
|
+
/**
|
|
19
|
+
* Hex characters of the title digest the derived branch keeps. 32 hex = 128
|
|
20
|
+
* bits, and the name is therefore `memory_` + 32 = **39 characters for every
|
|
21
|
+
* title**, however long the title is.
|
|
22
|
+
*/
|
|
23
|
+
const DERIVED_NAME_HEX_LENGTH = 32;
|
|
24
|
+
/**
|
|
25
|
+
* Filename stem for a memory title, and the `name:` its stored frontmatter
|
|
26
|
+
* carries.
|
|
27
|
+
*
|
|
28
|
+
* The character class is Unicode-aware deliberately. An ASCII-only class
|
|
29
|
+
* reduced EVERY title written in a non-Latin script to the same empty string,
|
|
30
|
+
* so all of them landed on one constant name: whichever title arrived first
|
|
31
|
+
* took that file, and each later one was skipped because the store refuses to
|
|
32
|
+
* overwrite a file it already holds. Two titles that still reduce to one stem
|
|
33
|
+
* are refused outright by the plan builders' duplicate-name check.
|
|
34
|
+
*
|
|
35
|
+
* A title with no letter or digit in any script ("!!!") leaves nothing to build
|
|
36
|
+
* a name from. That branch takes the first 32 hex characters of the title's
|
|
37
|
+
* sha256 instead of a fixed constant, so distinct titles still reach distinct
|
|
38
|
+
* names. It is a DIGEST rather than the title's bytes because of LENGTH: an
|
|
39
|
+
* encoding that grew with the title (the two-hex-chars-per-byte
|
|
40
|
+
* `toString('hex')` this replaced) produced names past the filesystem limit for
|
|
41
|
+
* a long enough title, so the write failed and took the whole batch with it —
|
|
42
|
+
* measured, exit 1 and 0 files for a 140-character title. A digest is 39
|
|
43
|
+
* characters whatever the title is.
|
|
44
|
+
*
|
|
45
|
+
* THE FIXED LENGTH IS BOUGHT WITH A PROBABILISTIC GUARANTEE, and that is the
|
|
46
|
+
* strongest thing this branch can claim. For the derived branch distinct titles
|
|
47
|
+
* reach distinct names with overwhelming probability rather than by
|
|
48
|
+
* construction: a collision needs two titles whose first 128 digest bits agree
|
|
49
|
+
* — the birthday bound puts that at about n^2 / 2^129 for n derived names in one
|
|
50
|
+
* store, i.e. under 1 in 10^26 at a million names. The branch above keeps the
|
|
51
|
+
* stronger, exact property (two titles share a stem only if they are equal
|
|
52
|
+
* modulo case and runs of non-letter/non-digit characters). Neither branch loses
|
|
53
|
+
* a block silently on a collision: within a run the duplicate-name check refuses
|
|
54
|
+
* the whole extract, and across runs the later write is skipped and NAMED in the
|
|
55
|
+
* envelope's `warnings`.
|
|
56
|
+
*
|
|
57
|
+
* The '_' is outside the alphabet the branch above can emit, so a derived name
|
|
58
|
+
* cannot equal a title-derived stem.
|
|
59
|
+
*/
|
|
17
60
|
export function slugify(title) {
|
|
18
61
|
const slug = title
|
|
19
62
|
.toLowerCase()
|
|
20
|
-
.replace(/[
|
|
63
|
+
.replace(/[^\p{L}\p{N}]+/gu, '-')
|
|
21
64
|
.replace(/^-+|-+$/g, '');
|
|
22
|
-
|
|
65
|
+
if (slug.length > 0)
|
|
66
|
+
return slug;
|
|
67
|
+
const digest = createHash('sha256').update(title, 'utf8').digest('hex');
|
|
68
|
+
return `memory_${digest.slice(0, DERIVED_NAME_HEX_LENGTH)}`;
|
|
23
69
|
}
|
|
24
70
|
/**
|
|
25
71
|
* Single implementation of the extract-path block parse. Returns a
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ExtractedProjectMemory, MemoryBlockDrop, ProjectMemoryBackupResult, ProjectMemoryBackupSummary, ProjectMemoryExtractResult, ProjectMemoryExtractSummary, SessionScanFailure } from '../types.js';
|
|
1
|
+
import type { ExtractedProjectMemory, MemoryBlockDrop, MemoryWriteSkip, ProjectMemoryBackupResult, ProjectMemoryBackupSummary, ProjectMemoryExtractResult, ProjectMemoryExtractSummary, SessionScanFailure } from '../types.js';
|
|
2
2
|
export declare const START_MARKER = "<!-- peaks-memory:start -->";
|
|
3
3
|
export declare const END_MARKER = "<!-- peaks-memory:end -->";
|
|
4
4
|
export declare function summarizeMemoryBody(body: string): string;
|
|
@@ -29,5 +29,27 @@ export declare function describeMemoryBlockDrops(dropped: ReadonlyArray<MemoryBl
|
|
|
29
29
|
* whole file that never yielded blocks at all.
|
|
30
30
|
*/
|
|
31
31
|
export declare function describeSessionScanFailures(failures: ReadonlyArray<SessionScanFailure>): string[];
|
|
32
|
+
/**
|
|
33
|
+
* How many skipped writes are NAMED before the list closes with a count.
|
|
34
|
+
*
|
|
35
|
+
* The COUNT must never be lost — the failure reported here is a reader who could
|
|
36
|
+
* not tell how many writes were skipped — so it is always `skips.length`, never
|
|
37
|
+
* the number of lines above it. The LIST is what is capped: it grows with the
|
|
38
|
+
* capsule while the envelope does not, and 200 skipped blocks measured 201 lines
|
|
39
|
+
* and a 95 KB envelope with no ceiling on `warnings` anywhere in the code.
|
|
40
|
+
*/
|
|
41
|
+
export declare const MAX_NAMED_MEMORY_WRITE_SKIPS = 20;
|
|
42
|
+
/**
|
|
43
|
+
* Render one warning line per planned write the store already held, plus a
|
|
44
|
+
* closing line with both counts.
|
|
45
|
+
*
|
|
46
|
+
* The counts are passed in rather than derived from `skips.length`: the caller
|
|
47
|
+
* observed the run, and `planned - skipped` is a claim about writes this
|
|
48
|
+
* function did not see. The closing line exists because the failure being
|
|
49
|
+
* reported is exactly a reader having no way to notice that the two counts
|
|
50
|
+
* differed — the named lines say which blocks were lost, the count says how
|
|
51
|
+
* many, and only the second one stays exact past the cap.
|
|
52
|
+
*/
|
|
53
|
+
export declare function describeMemoryWriteSkips(skips: ReadonlyArray<MemoryWriteSkip>, plannedCount: number, writtenCount: number): string[];
|
|
32
54
|
export declare function summarizeExtractResult(result: ProjectMemoryExtractResult): ProjectMemoryExtractSummary;
|
|
33
55
|
export declare function summarizeBackupResult(result: ProjectMemoryBackupResult): ProjectMemoryBackupSummary;
|
|
@@ -164,6 +164,43 @@ export function describeMemoryBlockDrops(dropped) {
|
|
|
164
164
|
export function describeSessionScanFailures(failures) {
|
|
165
165
|
return failures.map((failure) => `Could not read the session artifact ${failure.file}: ${failure.detail}.`);
|
|
166
166
|
}
|
|
167
|
+
/**
|
|
168
|
+
* How many skipped writes are NAMED before the list closes with a count.
|
|
169
|
+
*
|
|
170
|
+
* The COUNT must never be lost — the failure reported here is a reader who could
|
|
171
|
+
* not tell how many writes were skipped — so it is always `skips.length`, never
|
|
172
|
+
* the number of lines above it. The LIST is what is capped: it grows with the
|
|
173
|
+
* capsule while the envelope does not, and 200 skipped blocks measured 201 lines
|
|
174
|
+
* and a 95 KB envelope with no ceiling on `warnings` anywhere in the code.
|
|
175
|
+
*/
|
|
176
|
+
export const MAX_NAMED_MEMORY_WRITE_SKIPS = 20;
|
|
177
|
+
/**
|
|
178
|
+
* Render one warning line per planned write the store already held, plus a
|
|
179
|
+
* closing line with both counts.
|
|
180
|
+
*
|
|
181
|
+
* The counts are passed in rather than derived from `skips.length`: the caller
|
|
182
|
+
* observed the run, and `planned - skipped` is a claim about writes this
|
|
183
|
+
* function did not see. The closing line exists because the failure being
|
|
184
|
+
* reported is exactly a reader having no way to notice that the two counts
|
|
185
|
+
* differed — the named lines say which blocks were lost, the count says how
|
|
186
|
+
* many, and only the second one stays exact past the cap.
|
|
187
|
+
*/
|
|
188
|
+
export function describeMemoryWriteSkips(skips, plannedCount, writtenCount) {
|
|
189
|
+
if (skips.length === 0)
|
|
190
|
+
return [];
|
|
191
|
+
const lines = skips
|
|
192
|
+
.slice(0, MAX_NAMED_MEMORY_WRITE_SKIPS)
|
|
193
|
+
.map((skip) => `Skipped writing the memory "${skip.title}" from ${skip.sourceArtifact}: ${skip.filePath} already exists, so the block was not written.`);
|
|
194
|
+
const unlisted = skips.length - MAX_NAMED_MEMORY_WRITE_SKIPS;
|
|
195
|
+
if (unlisted > 0) {
|
|
196
|
+
// The dropped names are dropped for good: `skippedWrites` stays out of the
|
|
197
|
+
// envelope's `data`, so `warnings` is the only carrier. Saying so beats
|
|
198
|
+
// pointing the reader at a list that is not there.
|
|
199
|
+
lines.push(`… and ${unlisted} more skipped writes; the count below is the full number.`);
|
|
200
|
+
}
|
|
201
|
+
lines.push(`Wrote ${writtenCount} of ${plannedCount} planned memories; ${skips.length} skipped because the target file already exists.`);
|
|
202
|
+
return lines;
|
|
203
|
+
}
|
|
167
204
|
export function summarizeExtractResult(result) {
|
|
168
205
|
return {
|
|
169
206
|
apply: result.apply,
|
|
@@ -36,6 +36,26 @@ export type MemoryBlockDrop = {
|
|
|
36
36
|
/** Human-readable explanation of the failed precondition. */
|
|
37
37
|
detail: string;
|
|
38
38
|
};
|
|
39
|
+
/**
|
|
40
|
+
* A planned write that was NOT performed because the store already holds its
|
|
41
|
+
* target name.
|
|
42
|
+
*
|
|
43
|
+
* Distinct from `MemoryBlockDrop`: that one is a PARSE rejection, decided from
|
|
44
|
+
* the block's own text. This one is a WRITE skip — the block parsed, and it is
|
|
45
|
+
* still not in `.peaks/memory/`. Without it the two outcomes read alike from the
|
|
46
|
+
* envelope, because either one leaves `writtenFiles` short of `plannedWrites`.
|
|
47
|
+
* Empty on a preview, which writes nothing and so skips nothing.
|
|
48
|
+
*/
|
|
49
|
+
export type MemoryWriteSkip = {
|
|
50
|
+
/** Filename stem the write would have used — already present in the store. */
|
|
51
|
+
slug: string;
|
|
52
|
+
/** Title of the memory that was not written. */
|
|
53
|
+
title: string;
|
|
54
|
+
/** Artifact the block was read from. */
|
|
55
|
+
sourceArtifact: string;
|
|
56
|
+
/** Absolute path that already exists and was therefore left untouched. */
|
|
57
|
+
filePath: string;
|
|
58
|
+
};
|
|
39
59
|
/**
|
|
40
60
|
* Result of parsing one memory block, as a discriminated union.
|
|
41
61
|
*
|
|
@@ -72,6 +92,12 @@ export type ProjectMemoryExtractPlan = {
|
|
|
72
92
|
};
|
|
73
93
|
export type ProjectMemoryExtractResult = ProjectMemoryExtractPlan & {
|
|
74
94
|
writtenFiles: string[];
|
|
95
|
+
/**
|
|
96
|
+
* Planned writes the store already held, so `writtenFiles` is shorter than
|
|
97
|
+
* `plannedWrites` by exactly this many. Reported through the CLI envelope's
|
|
98
|
+
* `warnings` channel, which is why it adds no field to the summary.
|
|
99
|
+
*/
|
|
100
|
+
skippedWrites: MemoryWriteSkip[];
|
|
75
101
|
};
|
|
76
102
|
export type ProjectMemoryExtractSummary = {
|
|
77
103
|
apply: boolean;
|
|
@@ -171,6 +197,12 @@ export type ExtractSessionMemoriesResult = {
|
|
|
171
197
|
extractedCount: number;
|
|
172
198
|
writtenFiles: string[];
|
|
173
199
|
updatedIndex: boolean;
|
|
200
|
+
/**
|
|
201
|
+
* Planned writes the store already held, so `writtenFiles` is shorter than
|
|
202
|
+
* `extractedCount` by exactly this many. Same diagnostic contract as
|
|
203
|
+
* `ProjectMemoryExtractResult.skippedWrites`.
|
|
204
|
+
*/
|
|
205
|
+
skippedWrites: MemoryWriteSkip[];
|
|
174
206
|
/**
|
|
175
207
|
* Blocks that were FOUND between the markers in this session's artifacts but
|
|
176
208
|
* rejected by the parser. Same diagnostic contract as
|
|
@@ -90,6 +90,13 @@ export declare function emitTokenUsageEvent(opts: {
|
|
|
90
90
|
projectRoot: string;
|
|
91
91
|
inputTokens: number;
|
|
92
92
|
outputTokens: number;
|
|
93
|
+
/**
|
|
94
|
+
* Where the two counts came from. Required, not defaulted: a `0` the provider
|
|
95
|
+
* reported and a `0` nobody measured are the same number, and the whole point
|
|
96
|
+
* of the tag is to stop them being read as one — a caller that cannot say
|
|
97
|
+
* which it holds has not measured.
|
|
98
|
+
*/
|
|
99
|
+
source: 'provider' | 'estimated';
|
|
93
100
|
}): EmitResult;
|
|
94
101
|
/**
|
|
95
102
|
*/
|
|
@@ -39,9 +39,10 @@
|
|
|
39
39
|
* `AUDIT_REQUIRES_HANDOFF` row. An earlier revision of this comment
|
|
40
40
|
* claimed three, and QA caught prose that disagreed with the code, which
|
|
41
41
|
* is the defect this module exists to end. The security path declared is
|
|
42
|
-
* the config-specific `rd/security-review
|
|
43
|
-
*
|
|
44
|
-
*
|
|
42
|
+
* the config-specific `rd/security-review-<rid>.md` (it carried no rid
|
|
43
|
+
* until slice 9.37, so the second config slice in a session overwrote the
|
|
44
|
+
* first's review) — not the documented `audit/security-<rid>.md`, which no
|
|
45
|
+
* config slice writes)
|
|
45
46
|
* - docs / chore → NOTHING. No `rd:qa-handoff` row ⇒ nothing for Gate C
|
|
46
47
|
* to validate ⇒ nothing declared (see below)
|
|
47
48
|
*
|
|
@@ -39,9 +39,10 @@
|
|
|
39
39
|
* `AUDIT_REQUIRES_HANDOFF` row. An earlier revision of this comment
|
|
40
40
|
* claimed three, and QA caught prose that disagreed with the code, which
|
|
41
41
|
* is the defect this module exists to end. The security path declared is
|
|
42
|
-
* the config-specific `rd/security-review
|
|
43
|
-
*
|
|
44
|
-
*
|
|
42
|
+
* the config-specific `rd/security-review-<rid>.md` (it carried no rid
|
|
43
|
+
* until slice 9.37, so the second config slice in a session overwrote the
|
|
44
|
+
* first's review) — not the documented `audit/security-<rid>.md`, which no
|
|
45
|
+
* config slice writes)
|
|
45
46
|
* - docs / chore → NOTHING. No `rd:qa-handoff` row ⇒ nothing for Gate C
|
|
46
47
|
* to validate ⇒ nothing declared (see below)
|
|
47
48
|
*
|
|
@@ -185,15 +185,29 @@ function checkBody(call, sourceFile, relPath) {
|
|
|
185
185
|
expected: 'block-body callback with // given: / // when: / // then: comments at the top'
|
|
186
186
|
};
|
|
187
187
|
}
|
|
188
|
+
/**
|
|
189
|
+
* The callback block of an `it` / `test` call, or null when the call has
|
|
190
|
+
* no block-bodied callback.
|
|
191
|
+
*
|
|
192
|
+
* THE CALLBACK IS NOT `arguments[1]`. vitest accepts an options object
|
|
193
|
+
* between the description and the callback — `it(name, { timeout }, fn)` —
|
|
194
|
+
* and this repo's own test files use that overload. Read at a fixed
|
|
195
|
+
* position, the options object is neither an arrow nor a function
|
|
196
|
+
* expression, so this returned null, the comment check never ran, and a
|
|
197
|
+
* conformant file came back `missing-given-when-then`: a WRONG verdict,
|
|
198
|
+
* not a missed one. So the callback is the LAST argument that is an arrow
|
|
199
|
+
* or a function expression, at whatever arity.
|
|
200
|
+
*/
|
|
188
201
|
function getCallbackBlock(call) {
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
return null;
|
|
196
|
-
|
|
202
|
+
for (let i = call.arguments.length - 1; i >= 0; i -= 1) {
|
|
203
|
+
const arg = call.arguments[i];
|
|
204
|
+
if (arg === undefined)
|
|
205
|
+
continue;
|
|
206
|
+
if (!ts.isArrowFunction(arg) && !ts.isFunctionExpression(arg))
|
|
207
|
+
continue;
|
|
208
|
+
return ts.isBlock(arg.body) ? arg.body : null;
|
|
209
|
+
}
|
|
210
|
+
return null;
|
|
197
211
|
}
|
|
198
212
|
function checkBlockLeadingComments(block, sourceFile, relPath) {
|
|
199
213
|
// TypeScript's `getLeadingCommentRanges` API is unreliable for
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import type { RaceGate2Policy } from './gate2-policy.js';
|
|
2
|
+
export type LaneChosenBy = 'user-named' | 'user-picked';
|
|
3
|
+
export type TaskOutcome = 'landed' | 'escalated' | 'stopped';
|
|
4
|
+
export type RiskSurfaceHandling = 'refused' | 'escalated' | 'user-override-recorded' | 'none';
|
|
5
|
+
export type PilotGateVerdict = 'pass' | 'fail' | 'insufficient-evidence';
|
|
6
|
+
export type PilotTaskRow = {
|
|
7
|
+
readonly rid: string;
|
|
8
|
+
readonly sessionId: string;
|
|
9
|
+
readonly date: string;
|
|
10
|
+
readonly laneChosenBy: LaneChosenBy;
|
|
11
|
+
readonly outcome: TaskOutcome;
|
|
12
|
+
readonly filesChanged: readonly string[];
|
|
13
|
+
readonly riskSurfacesHit: readonly number[];
|
|
14
|
+
readonly riskSurfaceHandling: RiskSurfaceHandling;
|
|
15
|
+
readonly rolledBack: boolean;
|
|
16
|
+
readonly ciRed: boolean;
|
|
17
|
+
readonly missedRiskSurface: boolean;
|
|
18
|
+
};
|
|
19
|
+
export type PilotGateCounts = {
|
|
20
|
+
readonly taskCount: number;
|
|
21
|
+
readonly coreCapabilityTaskCount: number;
|
|
22
|
+
readonly sessionCount: number;
|
|
23
|
+
readonly safetyArmExercisedCount: number;
|
|
24
|
+
readonly rollbackCount: number;
|
|
25
|
+
readonly ciRedCount: number;
|
|
26
|
+
readonly missedRiskSurfaceCount: number;
|
|
27
|
+
};
|
|
28
|
+
export type PilotGateReason = {
|
|
29
|
+
readonly code: string;
|
|
30
|
+
readonly message: string;
|
|
31
|
+
readonly observed: number;
|
|
32
|
+
readonly threshold: number;
|
|
33
|
+
};
|
|
34
|
+
export type PilotGateEvaluation = {
|
|
35
|
+
readonly verdict: PilotGateVerdict;
|
|
36
|
+
readonly counts: PilotGateCounts;
|
|
37
|
+
readonly reasons: readonly PilotGateReason[];
|
|
38
|
+
};
|
|
39
|
+
/**
|
|
40
|
+
* The safety arm fired and left a disposition. A hit with `'none'` is a MISSING
|
|
41
|
+
* record, not a clean row — so `'none'` does not count (PRD §3.2(b)).
|
|
42
|
+
*
|
|
43
|
+
* Counting basis is deliberately different from `taskCount`'s: this predicate is
|
|
44
|
+
* applied over ALL records, `escalated` and `stopped` included. An escalation is
|
|
45
|
+
* the safety arm firing correctly, and a landed-only reading would exclude the
|
|
46
|
+
* one sample where it did (PRD §3.1, the exception paragraph).
|
|
47
|
+
*/
|
|
48
|
+
export declare function safetyArmExercised(row: PilotTaskRow): boolean;
|
|
49
|
+
/**
|
|
50
|
+
* The coverage condition, DERIVED — never a `coreCapability: true` the author
|
|
51
|
+
* wrote (PRD §3.2). A row qualifies by reaching a hard-blocked family, or by
|
|
52
|
+
* exercising the safety arm.
|
|
53
|
+
*
|
|
54
|
+
* It does NOT test `outcome`: the caller applies this over landed rows only
|
|
55
|
+
* (§3.1), which is a property of the counting set, not of the predicate.
|
|
56
|
+
*/
|
|
57
|
+
export declare function taskExercisesCoreCapability(row: PilotTaskRow): boolean;
|
|
58
|
+
export declare function evaluatePilotGate(tasks: readonly PilotTaskRow[], policy: RaceGate2Policy): PilotGateEvaluation;
|