peaks-loop 4.0.34 → 4.0.36

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 4.0.36 — 2026-09-10 (派发提示词瘦身 + 波次调度 + 编排器上下文审计)
+
+**Highlights**:
+
+1. **派发提示词瘦身（不牺牲规则）** — 每次派发的提示词里约 52% 是 CLI 注入的重复 boilerplate。本轮压缩 L1/生命周期/上下文探测段，并把 test-tool 块统一为一份（去掉 vitest/jest/mocha 举例，保留全部操作性规则，补上只存在于完整块里的 PB-5 例外规则）。7 个角色现在**字节完全一致**：rd/qa/qa-business/sc/prd **3897 → 3191 B（−18.1%）**。绑定规则 **21/21**、runner 规则 **5/5** 全角色断言。
+   - 契约指针实验**已回退**——它每次多 165 B 却不减任何内容，净亏。
+
+2. **文件重叠感知的波次调度** — 新 planner 按切面文件集计算波次：同一波内文件两两不重叠，重叠的推迟到后续波并**注明被哪个文件挡住**；附加式接入 `--from-dag`（`firstLevelWaves`），不改原调度语义。
+
+3. **编排器上下文审计 + 纪律** — 新增 `peaks code context-audit`：读会话 transcript 按 (工具, 命令) 汇总上下文消耗 Top-N。本仓库实测 **779 KB / 586 组**，且 Top-5 仅占 ~15%——**是长尾，不是单一元凶**。
+   - `--summary` 用于 memory reindex/list、doctor、request list：envelope **9.4–59 KB → 1.7–1.9 KB**（−79% ~ −97%），默认 `--json` 形状字节不变。
+   - SKILL.md 绑定规则：单次工具输出 >2 KB 禁止直接灌入编排器上下文。
+   - 子代理最终报告封顶 **≤40 行 / 2 KB**（5 个必填字段，细节写 artifact），已纳入 `BINDING_RULE_TOKENS`。
+
+**验证**：build clean、tsc clean、全量 141 files / 1270 passed（1 skipped）。
+
+## 4.0.35 — 2026-09-10 (记忆系统 overhaul — 写入合一 / 索引重建 / 按任务调取 / 漂移健康检查 / rotate)
+
+**Highlights**:
+
+1. **记忆写入单一权威** — `peaks memory ingest` 把 IDE 侧（Claude Code）记忆导入 `.peaks/memory/`，源目录只读、**绝不写 `~/.claude/`**；SKILL.md 明确：工作流内"沉淀记忆"落 `.peaks/memory/`，IDE 侧仅作会话笔记。
+
+2. **索引重建 + 根因修复** — `peaks memory reindex` 全量重扫并重建 `index.json`。**根因**：共享 frontmatter 解析器只认顶层 `type:`，按契约写 `metadata.type` 的文件被**静默丢弃**。现按 `metadata.type → kind → type` 解析，未识别值**输出清单**而非静默跳过。name 解析新增 `name → title → 文件名` 回退；重名冲突上报不覆盖。本仓库实测：索引 **231 → 276**。
+
+3. **调取按任务 + 分层预算** — preflight 此前 `fetchBlock(_taskTitle)` 的 `taskTitle` **完全未使用**，永远注入同一批 feedback+layerA。现按任务排序（per-token fuzzy，无网络/无 embedding），hot 必进、warm 按相关度入选，三重预算（条数/字节/时间）+ 可观测字段。warm 层首次可被注入。顺带修：读取器原来只扁平化 4 种 kind，丢了 decision/rule/convention/module/lesson。
+
+4. **kind 词表 8 → 21** — 纳入语料中实际使用的 13 个 kind（`bug`/`investigation`/`technical-pattern`/`project-rule`/`design`/`handoff`/`session-handoff`/`project-todo`/`publish-closure`/`project-closure`/`slice-closure`/`slice-pilot-findings`/`sediment`），单一常量驱动解析/索引/CLI/doctor。
+
+5. **`peaks memory rotate`（清除机制）** — 实现 2026-07-24 pruning policy 早已规定但从未实现的轮转：A/B 层永不入选（测试断言）、C 层满 **6 个月**且未被钉住 → 归档、D 层 → 报告待删（不删）、每个候选先过 `src/`+`skills/` 引用 grep。默认 dry-run。
+
+6. **doctor 漂移检查** — 新增 `l3-memory-coverage` / `l3-memory-orphans` / `l3-memory-unclassified`；此前只校验"index.json 是合法 JSON"，46% 不可见也报 ok。
+
+**验证**：build clean、tsc clean、全量 133 files / 1180 passed（1 skipped）；本仓库 rotate dry-run `A:22 B:146 C:138 D:12`。
+
 ## 4.0.34 — 2026-09-09 (mode 模型收敛 + auto-compact 死命令 + 上下文窗口覆盖 + 确认门去 TTY)
 
 **Highlights**:

package/dist/cli/commands/code-runtime-commands.d.ts

@@ -1,10 +1,13 @@
 /**
  * Slice rid-024 — runtime probes: post-compact-detect / auto-compact /
- * context-now / gate-step-08 / emit-handoff.
+ * context-now / context-audit / gate-step-08 / emit-handoff.
  *
  * Extracted from code-commands.ts (rid-024 split).
- * Owns: 5 sub-commands that read or mutate runtime state.
+ * Owns: 6 sub-commands that read or mutate runtime state.
  * Owns the `readActiveSid` helper (only used by these runtime probes).
+ *
+ * Slice 2026-09-10-context-audit-and-discipline added `context-audit`
+ * (what fills the window, grouped by tool + short input key).
  */
 import type { Command } from 'commander';
 import { type ProgramIO } from '../cli-helpers.js';

package/dist/cli/commands/code-runtime-commands.js

@@ -1,15 +1,19 @@
 /**
  * Slice rid-024 — runtime probes: post-compact-detect / auto-compact /
- * context-now / gate-step-08 / emit-handoff.
+ * context-now / context-audit / gate-step-08 / emit-handoff.
  *
  * Extracted from code-commands.ts (rid-024 split).
- * Owns: 5 sub-commands that read or mutate runtime state.
+ * Owns: 6 sub-commands that read or mutate runtime state.
  * Owns the `readActiveSid` helper (only used by these runtime probes).
+ *
+ * Slice 2026-09-10-context-audit-and-discipline added `context-audit`
+ * (what fills the window, grouped by tool + short input key).
  */
 import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 import { detectPostCompactResume, formatPostCompactResumeLogLine } from '../../services/code/post-compact-detector.js';
 import { runAutoCompact } from '../../services/code/auto-compact-orchestrator.js';
+import { auditContext } from '../../services/context/context-audit.js';
 import { evaluateStep08, STEP_08_BACKUP_REGEX } from '../../services/code/step-08-gate.js';
 import { evaluateEmitHandoff, JOB_NOT_INITIALIZED, JOB_REMAINING_BLOCKED } from '../../services/code/emit-handoff.js';
 import { readJobShapeDecision, JobShapeDecisionError } from '../../services/code/job-shape-decision.js';
@@ -254,6 +258,57 @@ export function registerCodeRuntimeCommands(code, io) {
             process.exitCode = 1;
         }
     });
+    // Slice 2026-09-10-context-audit-and-discipline (Slice A): visibility into
+    // WHAT fills the orchestrator window. `context-now` returns a ratio; this
+    // returns the grouped byte breakdown of tool results from the live
+    // transcript. Read-only + fail-soft: an unavailable transcript reports
+    // `available:false` with a reason and NEVER sets a non-zero exit code.
+    addJsonOption(code
+        .command('context-audit')
+        .description('Slice 2026-09-10 Slice A: report what fills the current session\'s ' +
+        'context window, grouped by tool + short input key (command line / ' +
+        'path tail / pattern), sorted by bytes. Locates the CURRENT session\'s ' +
+        'IDE transcript through the active adapter\'s ' +
+        '`compact.resolveTranscriptPath` (vendor-neutral); emits total bytes, ' +
+        'entry count, and the top-N groups ' +
+        '(`{tool, key, bytes, pctOfTotal, count}`). Read-only and fail-soft — ' +
+        'a missing/oversized/corrupt transcript returns `available:false` ' +
+        'with a reason and never blocks. Never dumps tool result content.')
+        .requiredOption('--project <path>', 'target project root')
+        .option('--session-id <sid>', 'override session id (default: read from active presence)')
+        .option('--top <n>', 'number of top entries to emit (default 15, max 100)', (value) => Number(value))
+        .option('--transcript <path>', 'override the transcript jsonl path (test seam)')).action((opts) => {
+        try {
+            // `resolveOuterSessionId` checks the env signal FIRST, so the peaks
+            // session id is only a fallback lookup key — mirror context-now's
+            // 'unknown' default so an unbound presence still resolves via env.
+            const sessionId = opts.sessionId ?? readActiveSid(opts.project) ?? 'unknown';
+            const outerSessionId = resolveOuterSessionId(opts.project, sessionId);
+            const result = auditContext({
+                outerSessionId: outerSessionId ?? null,
+                ...(opts.top !== undefined ? { topN: opts.top } : {}),
+                ...(opts.transcript !== undefined ? { transcriptPath: opts.transcript } : {}),
+            });
+            // Fail-soft contract: unavailability is DATA, not an error. The exit
+            // code stays 0 so a `context-audit` call can never block a workflow.
+            const nextActions = result.available
+                ? [`${result.entryCount} tool result(s) across ${result.groupCount} group(s); showing top ${result.entries.length}.`]
+                : [`context-audit unavailable: ${result.reason ?? 'unknown'} — continue without it (read-only probe).`];
+            printResult(io, ok('code.context-audit', { ...result }, [], nextActions), opts.json);
+        }
+        catch (err) {
+            printResult(io, ok('code.context-audit', {
+                available: false,
+                reason: `audit-failed: ${getErrorMessage(err)}`,
+                transcriptPath: null,
+                totalBytes: 0,
+                entryCount: 0,
+                groupCount: 0,
+                topN: 0,
+                entries: []
+            }, [], ['context-audit is a read-only probe; continue without it.']), opts.json);
+        }
+    });
     // v3.1.2 Step 0.8 — Mechanical PreToolUse gate.
     // Wire-installed by `peaks workspace init` (extends the existing hook
     // installer). Exit code is the load-bearing contract:

package/dist/cli/commands/core/doctor-command.d.ts

@@ -1,5 +1,13 @@
 import type { Command } from 'commander';
 import { type ProgramIO } from '../../cli-helpers.js';
+/**
+ * Slice 2026-09-10-context-audit-and-discipline (Slice B): bounded view of
+ * the doctor envelope. The `checks` array (one object per check, each with a
+ * full message) and the stale-binding instance list collapse to counts +
+ * names-of-first-N; the summary counters and log section are scalars and are
+ * kept verbatim. ≤ 2 KB by construction.
+ */
+export declare function buildDoctorSummary(data: Record<string, unknown>): Record<string, unknown>;
 export type BindingSource = 'canonical' | 'legacy';
 export type DoctorLogsSection = {
     logDir: string;

package/dist/cli/commands/core/doctor-command.js

@@ -4,6 +4,7 @@ import { findProjectRoot } from '../../../services/config/config-safety.js';
 import { loadSkillRegistry } from '../../../services/skills/skill-registry.js';
 import { planStatusLineInstall } from '../../../services/skills/statusline-settings-service.js';
 import { addJsonOption, printResult } from '../../cli-helpers.js';
+import { boundedNames, fitSummaryToBytes } from '../../../services/context/summary-view.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 // slice-3b Option C: the doctor subpackage owns the check pipeline but
 // does NOT import cross-domain utils from the main package (avoids
@@ -38,6 +39,43 @@ function statusLineAlreadyInstalledForScope(scope, projectRoot) {
         return false;
     }
 }
+/**
+ * Slice 2026-09-10-context-audit-and-discipline (Slice B): bounded view of
+ * the doctor envelope. The `checks` array (one object per check, each with a
+ * full message) and the stale-binding instance list collapse to counts +
+ * names-of-first-N; the summary counters and log section are scalars and are
+ * kept verbatim. ≤ 2 KB by construction.
+ */
+export function buildDoctorSummary(data) {
+    const checks = Array.isArray(data.checks) ? data.checks : [];
+    const label = (c) => {
+        const id = typeof c.id === 'string' ? c.id : 'unknown';
+        if (c.ok === true)
+            return `ok ${id}`;
+        return `${c.severity === 'warning' ? 'warn' : 'FAIL'} ${id}`;
+    };
+    const failed = checks.filter((c) => c.ok === false);
+    const stale = typeof data.staleBinding === 'object' && data.staleBinding !== null
+        ? data.staleBinding
+        : null;
+    const view = {
+        view: 'summary',
+        summary: data.summary,
+        checks: boundedNames(checks.map(label)),
+        failed: boundedNames(failed.map((c) => `${typeof c.id === 'string' ? c.id : 'unknown'}: ${typeof c.message === 'string' ? c.message : ''}`)),
+    };
+    if (stale !== null) {
+        view.staleBinding = {
+            ttlMs: stale.ttlMs,
+            staleCount: stale.staleCount,
+            droppedCount: stale.droppedCount,
+            droppedSids: boundedNames(Array.isArray(stale.droppedSids) ? stale.droppedSids.map((s) => String(s)) : []),
+        };
+    }
+    if (data.logs !== undefined)
+        view.logs = data.logs;
+    return fitSummaryToBytes(view);
+}
 function doctorStatusLineInstalledProbe() {
     const projectRoot = findProjectRoot(process.cwd());
     // Check both scopes: a user may have installed the statusLine globally, which
@@ -136,7 +174,8 @@ export function registerDoctorCommand(program, io) {
         // scan) addressable for non-current projects. The doctor was
         // hardcoded to findProjectRoot(process.cwd()) which is the
         // wrong default for users inspecting a sibling project.
-        .option('--project <path>', 'target project root (defaults to git root or cwd)')).action(async (options) => {
+        .option('--project <path>', 'target project root (defaults to git root or cwd)')
+        .option('--summary', 'JSON envelope only: emit check counts + names-of-first-N (≤ 2 KB) instead of the full checks/stale-binding arrays; the default envelope is unchanged')).action(async (options) => {
         // v2.18.2 cycle 2 (Q2 arbitration): --rebuild-binding and
         // --cleanup-stale BOTH mutate the binding file. Running them
         // together is ambiguous (rebuild rewrites callerIds; cleanup
@@ -209,9 +248,12 @@ export function registerDoctorCommand(program, io) {
             droppedCount: droppedStale.length,
             droppedSids: droppedStale
         };
-        const data = logsSection === null
+        const fullData = logsSection === null
             ? { ...report, staleBinding: staleBindingSection }
             : { ...report, logs: logsSection, staleBinding: staleBindingSection };
+        // Slice B: `--summary` is opt-in and affects the JSON envelope only (the
+        // human-readable path below already prints one line per check).
+        const data = options.summary === true ? buildDoctorSummary(fullData) : fullData;
         // Slice 2026-08-05-statusline-sid-only-marker-and-multi-binary-drift-guard
         // repair cycle: `report.summary.ok` already factors in the
         // severity-aware aggregation in `buildReport` (warnings do NOT

package/dist/cli/commands/core/memory-command.js

@@ -1,6 +1,8 @@
-import { executeProjectMemoryBackup, executeProjectMemoryExtract, summarizeProjectMemoryBackupResult, summarizeProjectMemoryExtractResult } from '../../../services/memory/project-memory-service.js';
+import { executeProjectMemoryBackup, executeProjectMemoryExtract, summarizeProjectMemoryBackupResult, summarizeProjectMemoryExtractResult, VALID_PROJECT_MEMORY_KINDS } from '../../../services/memory/project-memory-service.js';
 import { fail, ok } from 'peaks-loop-shared/result';
 import { addJsonOption, getErrorMessage, printResult } from '../../cli-helpers.js';
+/** Derived from the canonical kind vocabulary — never hand-maintain a list here. */
+const KIND_HELP = VALID_PROJECT_MEMORY_KINDS.join(', ');
 export function registerMemoryCommand(program, io) {
     const memory = program.command('memory').description('Manage project-local Peaks memory');
     addJsonOption(memory
@@ -48,9 +50,10 @@ export function registerMemoryCommand(program, io) {
     addJsonOption(memory
         .command('list')
         .description('List all memory entries from .peaks/memory/index.json. Pass --pick to spawn fzf for interactive multi-select; the picked subset is written to .peaks/memory/picked.json.')
-        .option('--kind <kind>', 'filter by memory kind (one of: project, rule, decision, reference, feedback, convention, module, lesson)')
+        .option('--kind <kind>', `filter by memory kind (one of: ${KIND_HELP})`)
         .option('--pick', 'spawn fzf for interactive multi-select (requires fzf >= 0.38); writes picked.json')
         .option('--fzf-bin <path>', 'override fzf binary path (default: fzf on PATH)', 'fzf')
+        .option('--summary', 'emit counts + names-of-first-N only (≤ 2 KB) instead of the full entry array; the default envelope is unchanged')
         .option('--project <path>', 'target project root (defaults to git root or cwd)')).action((options) => {
         void import('../memory-commands.js').then(({ runMemoryList }) => {
             void runMemoryList(io, {
@@ -58,6 +61,7 @@ export function registerMemoryCommand(program, io) {
                 ...(options.pick === true ? { pick: true } : {}),
                 ...(options.fzfBin ? { fzfBin: options.fzfBin } : {}),
                 ...(options.project !== undefined ? { project: options.project } : {}),
+                ...(options.summary === true ? { summary: true } : {}),
                 ...(options.json !== undefined ? { json: options.json } : {}),
             });
         }).catch((error) => {
@@ -72,10 +76,68 @@ export function registerMemoryCommand(program, io) {
                 process.exitCode = 1;
         });
     });
+    addJsonOption(memory
+        .command('reindex')
+        .description('Rebuild .peaks/memory/index.json from every memory file on disk and regenerate MEMORY.md; reports unclassified files and orphans both ways. Dry-run by default; pass --apply to write.')
+        .option('--project <path>', 'target project root (defaults to git root or cwd)')
+        .option('--dry-run', 'report drift without writing (default)')
+        .option('--apply', 'rebuild index.json and regenerate MEMORY.md')
+        .option('--summary', 'emit drift counts + names-of-first-N only (≤ 2 KB) instead of the full arrays; the default envelope is unchanged')).action((options) => {
+        void import('../memory-commands.js').then(({ runMemoryReindex }) => {
+            void runMemoryReindex(io, {
+                ...(options.project !== undefined ? { project: options.project } : {}),
+                ...(options.dryRun === true ? { dryRun: true } : {}),
+                ...(options.apply === true ? { apply: true } : {}),
+                ...(options.summary === true ? { summary: true } : {}),
+                ...(options.json !== undefined ? { json: options.json } : {}),
+            });
+        }).catch((error) => {
+            printResult(io, fail('memory.reindex', 'MEMORY_REINDEX_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
+            process.exitCode = 1;
+        });
+    });
+    addJsonOption(memory
+        .command('ingest')
+        .description('Import memories written by the IDE-side agent (~/.claude/projects/<hash>/memory/*.md) into the peaks-owned .peaks/memory store. The IDE-side dir is read-only. Dry-run by default; pass --apply to write.')
+        .option('--project <path>', 'target project root (defaults to git root or cwd)')
+        .option('--source-dir <path>', 'override the IDE-side memory directory')
+        .option('--dry-run', 'preview imports without writing (default)')
+        .option('--apply', 'write normalized memories into .peaks/memory')).action((options) => {
+        void import('../memory-commands.js').then(({ runMemoryIngest }) => {
+            void runMemoryIngest(io, {
+                ...(options.project !== undefined ? { project: options.project } : {}),
+                ...(options.sourceDir !== undefined ? { sourceDir: options.sourceDir } : {}),
+                ...(options.dryRun === true ? { dryRun: true } : {}),
+                ...(options.apply === true ? { apply: true } : {}),
+                ...(options.json !== undefined ? { json: options.json } : {}),
+            });
+        }).catch((error) => {
+            printResult(io, fail('memory.ingest', 'MEMORY_INGEST_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
+            process.exitCode = 1;
+        });
+    });
+    addJsonOption(memory
+        .command('rotate')
+        .description('Tier-driven retention for .peaks/memory/ (sediment pruning policy, tier 1: archive only, never delete). Tier assignment: explicit `metadata.tier: A|B|C|D` wins; else files under archived/ are D, files pinned in MEMORY.md are B, kinds rule/convention/project-rule are A, kinds decision/reference/feedback/module/bug/investigation/technical-pattern are B, everything else is C. Tier C older than 6 months (frontmatter updatedAt/updated/modified, else file mtime) and not pinned is archived; tier D is reported as a delete-candidate only. Tier A/B are never selected, every candidate must pass a reference grep against src/ + skills/, and --apply refuses an empty plan or a failed gate. Dry-run by default.')
+        .option('--project <path>', 'target project root (defaults to git root or cwd)')
+        .option('--dry-run', 'report the rotation plan without moving anything (default)')
+        .option('--apply', 'move tier-C candidates into .peaks/memory/archived/')).action((options) => {
+        void import('../memory-commands.js').then(({ runMemoryRotate }) => {
+            void runMemoryRotate(io, {
+                ...(options.project !== undefined ? { project: options.project } : {}),
+                ...(options.dryRun === true ? { dryRun: true } : {}),
+                ...(options.apply === true ? { apply: true } : {}),
+                ...(options.json !== undefined ? { json: options.json } : {}),
+            });
+        }).catch((error) => {
+            printResult(io, fail('memory.rotate', 'MEMORY_ROTATE_BOOTSTRAP_FAILED', getErrorMessage(error), {}, []), options.json);
+            process.exitCode = 1;
+        });
+    });
     addJsonOption(memory
         .command('search <query>')
         .description('Fuzzy-search the memory index (deterministic, local, zero-token). Default --limit 6.')
-        .option('--kind <kind>', 'filter by memory kind (one of: project, rule, decision, reference, feedback, convention, module, lesson)')
+        .option('--kind <kind>', `filter by memory kind (one of: ${KIND_HELP})`)
         .option('--limit <n>', 'maximum number of matches to return', (value) => Number(value))
         .option('--project <path>', 'target project root (defaults to git root or cwd)')).action((query, options) => {
         // Lazy import avoids a top-of-file import cycle (memory-commands.ts

package/dist/cli/commands/dispatch-commands.js

@@ -35,9 +35,10 @@ import { DEFAULT_PREFERENCES } from '../../services/preferences/preferences-type
 import { writeLogEntry } from '../../services/log/logger.js';
 import { PROMPT_LIMIT_BYTES, RECOMMENDED_ROLES, validateRole } from './sub-agent-shared.js';
 import { runDispatchFromDag } from './dispatch-from-dag.js';
-import { TEST_TOOL_DETECTION_BLOCK, formatTestToolDetection } from '../../services/dispatch/test-tool-detection.js';
-import { MemoryPreflightService } from '../../services/context/memory-preflight-service.js';
+import { TEST_TOOL_DETECTION_BLOCK } from '../../services/dispatch/test-tool-detection.js';
+import { MemoryPreflightService, deriveMemoryQuery } from '../../services/context/memory-preflight-service.js';
 import { buildDispatchSystemPrompt } from '../../services/context/build-dispatch-system-prompt.js';
+import { readSessionCapsule } from '../../services/dispatch/session-capsule.js';
 import { computeUiLibraryDispatchBlock } from '../../services/standards/ui-library-dispatch-block.js';
 import { readFreshContextBlock } from '../../services/fresh-context/fresh-context-block.js';
 import { createDispatchProvenanceToken, DISPATCH_PROVENANCE_ENV, writeDispatchProvenance, } from '../../services/worktree/dispatch-provenance.js';
@@ -373,7 +374,9 @@ export function registerDispatchCommand(parent, io) {
             // memory preflight block (or silently skip when unavailable) via the
             // pure-function builder.
             const preflightService = new MemoryPreflightService(projectRoot, projectPrefs);
-            const memoryBlock = await preflightService.fetchBlock(role);
+            // Slice 2026-09-09-memory-retrieval: rank the injected memory by the
+            // task at hand (role + first line of the brief), not the bare role.
+            const memoryBlock = await preflightService.fetchBlock(deriveMemoryQuery(role, options.prompt));
             // Slice 2026-09-03-codegraph-preread (Option A): pre-dispatch
             // codegraph preflight for RD planning. BEFORE the RD sub-agent's
             // prompt is composed, ensure the codegraph index exists (init +
@@ -441,10 +444,17 @@ export function registerDispatchCommand(parent, io) {
                 // "no probe available" hint instead of failing the
                 // dispatch.
             }
+            // Slice 2026-09-10-dispatch-token-and-swarm §4: advisory background
+            // capsule published by the orchestrator via `peaks sub-agent share`.
+            // Absent capsule → no pointer and no precedence line (byte-identical
+            // legacy prompt).
+            const capsuleRef = readSessionCapsule({ projectRoot, sid, rid });
             const memoryAugmentedBody = buildDispatchSystemPrompt({
                 taskTitle: role,
                 taskBody: options.prompt,
                 memoryBlock,
+                // 2026-09-10-dispatch-block-d (Option D): the composer owns the ONE
+                // unified Test Tool Detection injection for every role.
                 contextProbe,
                 // exactOptionalPropertyTypes: only set codegraphBlock when the rd
                 // preflight actually produced a value (null = attempted-unavailable,
@@ -457,7 +467,11 @@ export function registerDispatchCommand(parent, io) {
                 // Same optionality contract for the fresh-context block: set only
                 // when the rd/prd read ran (null = no block on disk → no block,
                 // undefined = non-rd/prd role → legacy prompt unchanged).
-                ...(freshContextBlock !== undefined ? { freshContextBlock } : {})
+                ...(freshContextBlock !== undefined ? { freshContextBlock } : {}),
+                // §4: advisory session capsule pointer + precedence line.
+                ...(capsuleRef !== null
+                    ? { capsule: { batchId: capsuleRef.batchId, key: capsuleRef.key, bytes: capsuleRef.bytes } }
+                    : {})
             });
             // Part 2.C: when --isolation worktree, prepend an isolation envelope
             // block so the sub-agent sees the lease id + worktree path. The block
@@ -496,7 +510,7 @@ export function registerDispatchCommand(parent, io) {
                     `confirm the file exists. Anti-fake-green rule (sediment 2026-08-11-rid-001-redo-fake-green-recovery-closure §Lesson 1): ` +
                     `if the file does not exist, your verdict MUST be \`status: "blocked"\` with reason "must_ls_files_failed". Do NOT silently skip this step.\n`;
             }
-            const effectivePrompt = `${formatTestToolDetection()}\n\n${memoryAugmentedBody}${isolationBlock}${mustLsFilesBlock}`;
+            const effectivePrompt = `${memoryAugmentedBody}${isolationBlock}${mustLsFilesBlock}`;
             const warnings = [...decision.warnings];
             let toolCall;
             try {

package/dist/cli/commands/dispatch-from-dag.js

@@ -32,6 +32,7 @@ import { fail, ok } from 'peaks-loop-shared/result';
 import { detectInstalledIde } from '../../services/ide/ide-detector.js';
 import { getAdapter } from '../../services/ide/ide-registry.js';
 import { getCurrentSessionId } from '../../services/skills/skill-presence-service.js';
+import { planFileOverlapWaves } from '../../services/dispatch/file-overlap-wave-planner.js';
 export async function runDispatchFromDag(role, options, asJson, io) {
     if (!options.fromDag)
         return;
@@ -135,6 +136,19 @@ export async function runDispatchFromDag(role, options, asJson, io) {
     // end-to-end, but they are NOT surfaced in the CLI envelope (the LLM
     // sees them only after re-invoking with fresh level-1 contracts).
     const firstLevelIds = new Set(levelArr[0] ?? []);
+    // Slice 2026-09-10-dispatch-token-and-swarm §3: when EVERY first-level
+    // node declares `files`, refine the level into file-overlap waves so the
+    // LLM fans out without serializing on a shared file. Emitted additively
+    // in the envelope; the topological dispatch flow itself is unchanged.
+    // Nodes without `files` → `firstLevelWaves: null` (legacy envelope).
+    const firstLevelDescriptors = [...firstLevelIds].map((id) => ({
+        id,
+        files: dag.nodes.find((n) => n.id === id)?.files ?? []
+    }));
+    const firstLevelWaves = firstLevelDescriptors.length > 0
+        && firstLevelDescriptors.every((d) => d.files.length > 0)
+        ? planFileOverlapWaves(firstLevelDescriptors).waves
+        : null;
     const emittedToolCalls = [];
     const emittedSliceIds = [];
     // CLI runner: emit the per-slice `buildToolCall` envelope, then return
@@ -240,6 +254,9 @@ export async function runDispatchFromDag(role, options, asJson, io) {
         dispatchCount: emittedSliceIds.length,
         levelsTotal: levelArr.length,
         firstLevel: emittedSliceIds,
+        // §3: file-overlap wave plan for the first level (null when any
+        // first-level node omits `files`). Additive field.
+        firstLevelWaves,
         toolCalls: emittedToolCalls,
         existingContractCount: existingContracts.length,
         expectedCompletionSeconds: 60,

package/dist/cli/commands/memory-commands.d.ts

@@ -1,3 +1,5 @@
+import { type MemoryIndexEntry, type MemoryIndexSnapshot, type ProjectMemoryKind } from '../../services/memory/memory-search-service.js';
+import { type MemoryReindexReport } from '../../services/memory/project-memory-service.js';
 import { type ProgramIO } from '../cli-helpers.js';
 export interface MemorySearchCommandOptions {
     query: string;
@@ -12,6 +14,47 @@ export interface MemoryListCommandOptions {
     fzfBin?: string;
     project?: string;
     json?: boolean;
+    /** Slice B: emit counts + names-of-first-N instead of the full entry array. */
+    summary?: boolean;
+}
+export interface MemoryReindexCommandOptions {
+    project?: string;
+    dryRun?: boolean;
+    apply?: boolean;
+    json?: boolean;
+    /** Slice B: emit counts + names-of-first-N instead of the full arrays. */
+    summary?: boolean;
+}
+/**
+ * Slice 2026-09-10-context-audit-and-discipline (Slice B): bounded view of
+ * `memory reindex`. The full report's arrays stay on disk / in the default
+ * envelope; this replaces them with `{count, names}` views (≤ 2 KB).
+ */
+export declare function buildMemoryReindexSummary(report: MemoryReindexReport): Record<string, unknown>;
+/**
+ * Slice B: bounded view of `memory list`. `count` is the true total; `names`
+ * carries `name (kind)` labels for the first N entries.
+ */
+export declare function buildMemoryListSummary(data: {
+    snapshot: MemoryIndexSnapshot;
+    entries: readonly MemoryIndexEntry[];
+    kindFilter: ProjectMemoryKind | undefined;
+    pickedEntries: readonly MemoryIndexEntry[];
+    pickedOutputPath: string | null;
+    fzfVersion: string | null;
+}): Record<string, unknown>;
+export interface MemoryIngestCommandOptions {
+    project?: string;
+    sourceDir?: string;
+    dryRun?: boolean;
+    apply?: boolean;
+    json?: boolean;
+}
+export interface MemoryRotateCommandOptions {
+    project?: string;
+    dryRun?: boolean;
+    apply?: boolean;
+    json?: boolean;
 }
 export declare function runMemoryList(io: ProgramIO, options: MemoryListCommandOptions): Promise<void>;
 /**
@@ -19,3 +62,19 @@ export declare function runMemoryList(io: ProgramIO, options: MemoryListCommandO
  * exercise the full envelope without spawning a subprocess.
  */
 export declare function runMemorySearch(io: ProgramIO, options: MemorySearchCommandOptions): Promise<void>;
+/**
+ * `peaks memory reindex` — rebuild `.peaks/memory/index.json` from disk and
+ * regenerate `MEMORY.md`. Dry-run by default; `--apply` writes.
+ */
+export declare function runMemoryReindex(io: ProgramIO, options: MemoryReindexCommandOptions): Promise<void>;
+/**
+ * `peaks memory rotate` — tier-driven retention for `.peaks/memory/`.
+ * Implements the sediment pruning policy (tier 1: archive, never delete).
+ * Dry-run by default; `--apply` moves tier-C candidates into `archived/`.
+ */
+export declare function runMemoryRotate(io: ProgramIO, options: MemoryRotateCommandOptions): Promise<void>;
+/**
+ * `peaks memory ingest` — import memories written by the IDE-side agent into
+ * `.peaks/memory/`. The IDE-side source is read-only; dry-run by default.
+ */
+export declare function runMemoryIngest(io: ProgramIO, options: MemoryIngestCommandOptions): Promise<void>;