peaks-loop 3.1.2 → 4.0.0-beta.2

package/dist/src/services/migrate-skill-name/schema.d.ts

@@ -0,0 +1,42 @@
+import { z } from 'zod';
+/**
+ * Result shape for `peaks session migrate-skill-name`.
+ *
+ * Counters:
+ *   - `scannedFiles` — every .json / .md under `.peaks/_runtime/**` (excluding
+ *     skip dirs below).
+ *   - `modifiedFiles` — files whose contents would change (dry-run reports
+ *     the predicted count; --apply reports the actually-written count).
+ *   - `keyValueReplacements` — `"skill": "<old>"` → `"skill": "<new>"`.
+ *   - `stringReplacements` — `/<old>` → `/<new>` slash-trigger mentions.
+ *
+ * Errors are surfaced per-file with `errors: [ "<absPath>: <message>", … ]`;
+ * the tool never silently skips a broken JSON file (Karpathy §4 honesty:
+ * silence on bad data is the worst kind of fake-green).
+ */
+export declare const MigrateResultSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    scannedFiles: z.ZodNumber;
+    modifiedFiles: z.ZodNumber;
+    keyValueReplacements: z.ZodNumber;
+    stringReplacements: z.ZodNumber;
+    skipped: z.ZodArray<z.ZodString, "many">;
+    errors: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    ok: boolean;
+    skipped: string[];
+    scannedFiles: number;
+    modifiedFiles: number;
+    keyValueReplacements: number;
+    stringReplacements: number;
+    errors: string[];
+}, {
+    ok: boolean;
+    skipped: string[];
+    scannedFiles: number;
+    modifiedFiles: number;
+    keyValueReplacements: number;
+    stringReplacements: number;
+    errors: string[];
+}>;
+export type MigrateResult = z.infer<typeof MigrateResultSchema>;

package/dist/src/services/migrate-skill-name/schema.js

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+/**
+ * Result shape for `peaks session migrate-skill-name`.
+ *
+ * Counters:
+ *   - `scannedFiles` — every .json / .md under `.peaks/_runtime/**` (excluding
+ *     skip dirs below).
+ *   - `modifiedFiles` — files whose contents would change (dry-run reports
+ *     the predicted count; --apply reports the actually-written count).
+ *   - `keyValueReplacements` — `"skill": "<old>"` → `"skill": "<new>"`.
+ *   - `stringReplacements` — `/<old>` → `/<new>` slash-trigger mentions.
+ *
+ * Errors are surfaced per-file with `errors: [ "<absPath>: <message>", … ]`;
+ * the tool never silently skips a broken JSON file (Karpathy §4 honesty:
+ * silence on bad data is the worst kind of fake-green).
+ */
+export const MigrateResultSchema = z.object({
+    ok: z.boolean(),
+    scannedFiles: z.number().int().nonnegative(),
+    modifiedFiles: z.number().int().nonnegative(),
+    keyValueReplacements: z.number().int().nonnegative(),
+    stringReplacements: z.number().int().nonnegative(),
+    skipped: z.array(z.string()),
+    errors: z.array(z.string()),
+});

package/dist/src/services/observability/aggregation.d.ts

@@ -51,7 +51,7 @@ export type RepairCycleReport = {
         cycleCount: number;
     }>;
 };
-/** RD/QA repair-loop cap (matches the peaks-solo repair-loop contract). */
+/** RD/QA repair-loop cap (matches the peaks-code repair-loop contract). */
 export declare const REPAIR_CYCLE_CAP = 3;
 export declare function aggregateStatus(events: readonly ObservabilityEvent[]): StatusAggregate;
 export declare function aggregateSlices(events: readonly ObservabilityEvent[]): SliceRollup[];

package/dist/src/services/observability/aggregation.js

@@ -28,7 +28,7 @@ const TERMINAL_HAPPY_STATES = new Set([
     'boundary-recorded'
 ]);
 const TERMINAL_FAIL_STATES = new Set(['blocked']);
-/** RD/QA repair-loop cap (matches the peaks-solo repair-loop contract). */
+/** RD/QA repair-loop cap (matches the peaks-code repair-loop contract). */
 export const REPAIR_CYCLE_CAP = 3;
 // v2.12.0 fan-out collapse: see OBSERVABILITY_SUBAGENT_ROLES for the
 // rationale on why `security-reviewer` was dropped and `peaks-security-audit`

package/dist/src/services/perf/perf-baseline-service.d.ts

@@ -1,7 +1,7 @@
 /**
  * Performance baseline scaffolding for the RD stage.
  *
- * peaks-solo's RD stage runs before the QA stage. The user-facing pain is
+ * peaks-code's RD stage runs before the QA stage. The user-facing pain is
  * that performance tests (lighthouse / k6 / project-local benches / etc.)
  * have historically only been run at QA Gate A4 — too late in the loop,
  * because a slow regression discovered at QA triggers a return-to-rd

package/dist/src/services/perf/perf-baseline-service.js

@@ -1,7 +1,7 @@
 /**
  * Performance baseline scaffolding for the RD stage.
  *
- * peaks-solo's RD stage runs before the QA stage. The user-facing pain is
+ * peaks-code's RD stage runs before the QA stage. The user-facing pain is
  * that performance tests (lighthouse / k6 / project-local benches / etc.)
  * have historically only been run at QA Gate A4 — too late in the loop,
  * because a slow regression discovered at QA triggers a return-to-rd

package/dist/src/services/prd/handoff-types.d.ts

@@ -4,7 +4,7 @@
  * The handoff is the **immutable** single source of truth that all
  * downstream consumers (peaks-rd main loop + 4 audit sub-agents +
  * peaks-qa) read. It is written by peaks-prd AFTER user confirmation
- * (per `skills/peaks-prd/SKILL.md` Step 5.5) and replaces the legacy
+ * (per `skills/bee/peaks-prd/SKILL.md` Step 5.5) and replaces the legacy
  * peaks-rd tech-doc handoff (v2.10.0 and earlier).
  *
  * Frontmatter invariant: `handoffHash` MUST equal the lowercase hex

package/dist/src/services/prd/handoff-types.js

@@ -4,7 +4,7 @@
  * The handoff is the **immutable** single source of truth that all
  * downstream consumers (peaks-rd main loop + 4 audit sub-agents +
  * peaks-qa) read. It is written by peaks-prd AFTER user confirmation
- * (per `skills/peaks-prd/SKILL.md` Step 5.5) and replaces the legacy
+ * (per `skills/bee/peaks-prd/SKILL.md` Step 5.5) and replaces the legacy
  * peaks-rd tech-doc handoff (v2.10.0 and earlier).
  *
  * Frontmatter invariant: `handoffHash` MUST equal the lowercase hex

package/dist/src/services/preferences/preferences-service.d.ts

@@ -22,7 +22,7 @@ export declare function writeAtomic(filePath: string, prefs: ProjectPreferences)
  * verbatim. v1's `agentShieldPrompt` and `loopAutonomousEnabled` were
  * already present, so they carry through unchanged. The `fanout` field
  * is new in v2 — it defaults to `{ defaultMode: 'fan-out' }` so the
- * pre-v2 behavior (peak-solo SKILL instructed fan-out when ≥ 2 leaves)
+ * pre-v2 behavior (peak-code SKILL instructed fan-out when ≥ 2 leaves)
  * is preserved.
  */
 export type MigrateResult = {

package/dist/src/services/preferences/preferences-types.d.ts

@@ -68,7 +68,7 @@ export interface ProjectPreferences {
      */
     readonly schema_version: typeof PREFERENCES_SCHEMA_VERSION;
     /**
-     * Slice 2026-06-28-solo-mode-bypass-fix: economyMode is a
+     * Slice 2026-06-28-code-mode-bypass-fix: economyMode is a
      * **MODEL-SELECTION** knob only — it chooses between the cheap
      * configured provider (`getConfiguredExecutionModelId`) and the
      * strongest planner/reviewer model (`STRONGEST_MODEL_ID`). It does

package/dist/src/services/progress/progress-service.d.ts

@@ -1,5 +1,5 @@
 /**
- * Sub-agent progress file for the RD/QA sub-agents in `peaks-solo`'s
+ * Sub-agent progress file for the RD/QA sub-agents in `peaks-code`'s
  * Swarm phase. A sub-agent (or the LLM via the `peaks progress step`
  * CLI) writes a stable JSON file at
  * `.peaks/_sub_agents/<sid>/subagent-progress.json`. The dispatch +

package/dist/src/services/progress/progress-service.js

@@ -1,5 +1,5 @@
 /**
- * Sub-agent progress file for the RD/QA sub-agents in `peaks-solo`'s
+ * Sub-agent progress file for the RD/QA sub-agents in `peaks-code`'s
  * Swarm phase. A sub-agent (or the LLM via the `peaks progress step`
  * CLI) writes a stable JSON file at
  * `.peaks/_sub_agents/<sid>/subagent-progress.json`. The dispatch +

package/dist/src/services/rd/standards-diagnostic.d.ts

@@ -60,7 +60,7 @@ export declare function buildRdStandardsGateList(input: {
     readonly missing: boolean;
 }): ReadonlyArray<RdStandardGate>;
 /**
- * Single entry point for the RD / QA / Solo bootstrap. Returns the
+ * Single entry point for the RD / QA / Code bootstrap. Returns the
  * exit code + error code + diagnostic + gate list. The CLI wrapper is
  * responsible for `process.stderr.write(diagnostic ?? '')` and
  * `process.exit(result.exitCode)`.

package/dist/src/services/rd/standards-diagnostic.js

@@ -2,7 +2,7 @@
  * Slice 2026-06-16-peaks-rd-no-gates — missing-project-standards diagnostic
  * + JSON gate list shape for the RD bootstrap path.
  *
- * Background: when `peaks-rd` (or `peaks-qa` / `peaks-solo`) starts in a
+ * Background: when `peaks-rd` (or `peaks-qa` / `peaks-code`) starts in a
  * project whose `.claude/rules/{common,typescript}/` is missing or empty,
  * the existing code-review / security / performance gates were silently
  * dropped. This module makes the missing-standards condition observable:
@@ -20,7 +20,7 @@
  *   G4  The remediation string is the exact copy-pasteable CLI invocation.
  *
  * This module is a pure-function helper. The `peaks rd` / `peaks qa` /
- * `peaks solo` runtime hooks call `resolveRdStartupStandardsCheck` at
+ * `peaks code` runtime hooks call `resolveRdStartupStandardsCheck` at
  * bootstrap and decide whether to write `process.stderr` + JSON envelope
  * + exit. The bootstrap is intentionally side-effect-free here so unit
  * tests can run it without spawning child processes.
@@ -112,7 +112,7 @@ export function buildRdStandardsGateList(input) {
     ];
 }
 /**
- * Single entry point for the RD / QA / Solo bootstrap. Returns the
+ * Single entry point for the RD / QA / Code bootstrap. Returns the
  * exit code + error code + diagnostic + gate list. The CLI wrapper is
  * responsible for `process.stderr.write(diagnostic ?? '')` and
  * `process.exit(result.exitCode)`.

package/dist/src/services/recommendations/capability-seed-items.js

@@ -86,7 +86,7 @@ export const seedCapabilityItems = [
     capability('codegraph.project-indexing', 'codegraph', 'Codegraph Project Indexing', 'cli', 'project-analysis', ['engineer'], 'medium', 'peaks-rd-local-scan', 'Use Peaks RD local project scanning when codegraph is unavailable.', 'Codegraph Project Indexing', 'Codegraph 项目索引', 'Indexes a local project through the peaks codegraph execution boundary for role-skill analysis.', '通过 peaks codegraph 执行边界索引本地项目，辅助角色 skill 分析。'),
     capability('codegraph.semantic-query', 'codegraph', 'Codegraph Semantic Query', 'cli', 'project-analysis', ['engineer'], 'medium', 'peaks-rd-local-scan', 'Use local Grep/Glob and RD scanning when codegraph semantic query is unavailable.', 'Codegraph Semantic Query', 'Codegraph 语义查询', 'Queries local symbols and project relationships for RD planning evidence.', '查询本地符号和项目关系，为 RD 规划提供证据。'),
     capability('codegraph.impact-analysis', 'codegraph', 'Codegraph Impact Analysis', 'cli', 'impact-analysis', ['engineer', 'qa'], 'medium', 'peaks-rd-qa-impact-review', 'Use RD changed-file analysis and QA regression planning when codegraph affected output is unavailable.', 'Codegraph Impact Analysis', 'Codegraph 影响面分析', 'Analyzes likely impact for changed files so RD and QA can focus planning and regression scope.', '分析变更文件的可能影响面，帮助 RD 与 QA 聚焦规划和回归范围。'),
-    capability('codegraph.context-pack', 'codegraph', 'Codegraph Context Pack', 'cli', 'context-pack', ['engineer', 'qa', 'product'], 'medium', 'peaks-txt-context-capsule', 'Use Peaks TXT context capsules and role-skill handoffs when codegraph context output is unavailable.', 'Codegraph Context Pack', 'Codegraph 上下文包', 'Builds task-specific local context that Solo, RD, and TXT can use as supporting evidence.', '生成任务相关的本地上下文，作为 Solo、RD 与 TXT 的辅助证据。'),
+    capability('codegraph.context-pack', 'codegraph', 'Codegraph Context Pack', 'cli', 'context-pack', ['engineer', 'qa', 'product'], 'medium', 'peaks-txt-context-capsule', 'Use Peaks TXT context capsules and role-skill handoffs when codegraph context output is unavailable.', 'Codegraph Context Pack', 'Codegraph 上下文包', 'Builds task-specific local context that Code, RD, and TXT can use as supporting evidence.', '生成任务相关的本地上下文，作为 Code、RD 与 TXT 的辅助证据。'),
     capability('playwright-mcp.browser-validation', 'playwright-mcp', 'Playwright MCP Browser Validation', 'mcp', 'browser-validation', ['engineer', 'qa'], 'medium', 'manual-browser-test', 'Use local Playwright or manual browser verification.', 'Playwright Browser Validation', 'Playwright 浏览器验证', 'Validates UI flows through controlled browser automation.', '通过受控浏览器自动化验证 UI 流程。'),
     capability('chrome-devtools-mcp.browser-debug', 'chrome-devtools-mcp', 'Chrome DevTools Browser Debug', 'mcp', 'browser-debug', ['engineer', 'qa'], 'medium', 'manual-devtools-inspection', 'Use browser screenshots, console logs, and network traces supplied by the user.', 'Chrome DevTools Debug', 'Chrome DevTools 调试', 'Inspects runtime UI, console, network, and performance behavior.', '检查运行时 UI、控制台、网络和性能行为。'),
     capability('figma-context-mcp.design-context', 'figma-context-mcp', 'Figma Design Context', 'mcp', 'design-context', ['designer', 'engineer'], 'medium', 'manual-design-input', 'Ask the user for screenshots, tokens, or exported design notes.', 'Figma Design Context', 'Figma 设计上下文', 'Reads design context for UI implementation planning.', '读取设计上下文以辅助 UI 实现规划。'),

package/dist/src/services/recommendations/capability-seed-mappings.js

@@ -6,7 +6,7 @@ export const seedCapabilityLandingMappings = [
     mapping({ capabilityId: 'codegraph.impact-analysis', sourceId: 'codegraph', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-rd', skillName: 'peaks-rd', guidance: 'Dry-run reference only: peaks-rd may use peaks codegraph affected --project <path> <files...> --json to inspect likely impact before slice planning and red-line checks when execution is approved.' }),
     mapping({ capabilityId: 'codegraph.impact-analysis', sourceId: 'codegraph', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-qa', skillName: 'peaks-qa', guidance: 'Use affected output as regression-surface evidence only; QA validation and test evidence remain authoritative.' }),
     mapping({ capabilityId: 'codegraph.context-pack', sourceId: 'codegraph', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-rd', skillName: 'peaks-rd', guidance: 'Dry-run reference only: peaks-rd may use peaks codegraph context --project <path> <task> to gather local evidence for RD analysis when execution is approved, without replacing standards dry-runs.' }),
-    mapping({ capabilityId: 'codegraph.context-pack', sourceId: 'codegraph', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-solo', skillName: 'peaks-solo', guidance: 'Solo may attach local context packs or affected summaries before role handoff so RD, QA, and TXT share the same project evidence.' }),
+    mapping({ capabilityId: 'codegraph.context-pack', sourceId: 'codegraph', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-code', skillName: 'peaks-code', guidance: 'Code may attach local context packs or affected summaries before role handoff so RD, QA, and TXT share the same project evidence.' }),
     mapping({ capabilityId: 'codegraph.context-pack', sourceId: 'codegraph', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-txt', skillName: 'peaks-txt', guidance: 'TXT may summarize recorded codegraph context packs into handoffs while treating them as supporting evidence only.' }),
     mapping({ capabilityId: 'playwright-mcp.browser-validation', sourceId: 'playwright-mcp', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-qa', skillName: 'peaks-qa', guidance: 'Use for browser and E2E validation after user-approved app targets are available.' }),
     mapping({ capabilityId: 'chrome-devtools-mcp.browser-debug', sourceId: 'chrome-devtools-mcp', sourceGroup: 'access-repo', landingKind: 'skill', target: 'peaks-ui', skillName: 'peaks-ui', guidance: 'Use for runtime UI, console, network, and performance inspection.' }),

package/dist/src/services/recommendations/recommendation-service.js

@@ -75,7 +75,7 @@ export function createRecommendationPlan(options) {
     return {
         intent: options.workflow,
         workflow: options.workflow,
-        profile: 'solo-guided-auto',
+        profile: 'code-guided-auto',
         audience: ['engineer'],
         options: [recommendedOption],
         requiredCapabilities,

package/dist/src/services/refactor/refactor-service.d.ts

@@ -1,4 +1,4 @@
-export type RefactorMode = 'solo' | 'rd';
+export type RefactorMode = 'code' | 'rd';
 export type RefactorDryRun = {
     mode: RefactorMode;
     implementationAllowed: false;

package/dist/src/services/sc/sc-service.js

@@ -473,7 +473,7 @@ export function validateArtifactRetention(sliceId) {
     };
     if (!workspace) {
         // No workspace: validate against the resolved session dir directly
-        // (this is the common peaks-solo / peaks-rd invocation: the slice
+        // (this is the common peaks-code / peaks-rd invocation: the slice
         // lives under the project-root `.peaks/_runtime/<sessionId>/`, and the
         // workspace artifact path is irrelevant). When the resolution also
         // fails, fall back to the legacy "No workspace configured" failure

package/dist/src/services/sediment/dispose-confirm.d.ts

@@ -0,0 +1,9 @@
+import type { BeeManifest } from "./types.js";
+export type DisposePlan = {
+    decision: "destroy";
+    auto: true;
+} | {
+    decision: null;
+    requiresUserPrompt: true;
+};
+export declare function planDispose(m: BeeManifest): DisposePlan;

package/dist/src/services/sediment/dispose-confirm.js

@@ -0,0 +1,5 @@
+export function planDispose(m) {
+    if (m.source === "system")
+        return { decision: "destroy", auto: true };
+    return { decision: null, requiresUserPrompt: true };
+}

package/dist/src/services/sediment/json-schema.d.ts

@@ -0,0 +1,247 @@
+import { z } from "zod";
+export declare const BeeManifestSchema: z.ZodEffects<z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"peaks.bee/1">;
+    name: z.ZodString;
+    source: z.ZodEnum<["system", "user"]>;
+    promotion_status: z.ZodEnum<["candidate", "stable", "retired", "system-stable"]>;
+    description: z.ZodString;
+    segments: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        inputs: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<["string", "number", "boolean", "json"]>;
+            required: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }, {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }>, "many">;
+        outputs: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<["string", "number", "boolean", "json"]>;
+            required: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }, {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }>, "many">;
+        sideEffects: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        outputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        inputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        sideEffects: string[];
+    }, {
+        name: string;
+        outputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        inputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        sideEffects: string[];
+    }>, "many">;
+    entrypoint: z.ZodObject<{
+        preamble: z.ZodString;
+        refs: z.ZodArray<z.ZodObject<{
+            path: z.ZodString;
+            kind: z.ZodEnum<["file", "dir", "script"]>;
+        }, "strip", z.ZodTypeAny, {
+            path: string;
+            kind: "file" | "script" | "dir";
+        }, {
+            path: string;
+            kind: "file" | "script" | "dir";
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        preamble: string;
+        refs: {
+            path: string;
+            kind: "file" | "script" | "dir";
+        }[];
+    }, {
+        preamble: string;
+        refs: {
+            path: string;
+            kind: "file" | "script" | "dir";
+        }[];
+    }>;
+    promotion: z.ZodObject<{
+        minCycles: z.ZodNumber;
+        requiresHumanApproval: z.ZodBoolean;
+        requiresSmokeTest: z.ZodBoolean;
+        retireOnMissesInRow: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        minCycles: number;
+        requiresHumanApproval: boolean;
+        requiresSmokeTest: boolean;
+        retireOnMissesInRow?: number | undefined;
+    }, {
+        minCycles: number;
+        requiresHumanApproval: boolean;
+        requiresSmokeTest: boolean;
+        retireOnMissesInRow?: number | undefined;
+    }>;
+    createdBy: z.ZodEnum<["human", "llm"]>;
+    lastTouchedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    source: "user" | "system";
+    description: string;
+    schemaVersion: "peaks.bee/1";
+    promotion: {
+        minCycles: number;
+        requiresHumanApproval: boolean;
+        requiresSmokeTest: boolean;
+        retireOnMissesInRow?: number | undefined;
+    };
+    segments: {
+        name: string;
+        outputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        inputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        sideEffects: string[];
+    }[];
+    promotion_status: "candidate" | "stable" | "retired" | "system-stable";
+    entrypoint: {
+        preamble: string;
+        refs: {
+            path: string;
+            kind: "file" | "script" | "dir";
+        }[];
+    };
+    createdBy: "llm" | "human";
+    lastTouchedAt: string;
+}, {
+    name: string;
+    source: "user" | "system";
+    description: string;
+    schemaVersion: "peaks.bee/1";
+    promotion: {
+        minCycles: number;
+        requiresHumanApproval: boolean;
+        requiresSmokeTest: boolean;
+        retireOnMissesInRow?: number | undefined;
+    };
+    segments: {
+        name: string;
+        outputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        inputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        sideEffects: string[];
+    }[];
+    promotion_status: "candidate" | "stable" | "retired" | "system-stable";
+    entrypoint: {
+        preamble: string;
+        refs: {
+            path: string;
+            kind: "file" | "script" | "dir";
+        }[];
+    };
+    createdBy: "llm" | "human";
+    lastTouchedAt: string;
+}>, {
+    name: string;
+    source: "user" | "system";
+    description: string;
+    schemaVersion: "peaks.bee/1";
+    promotion: {
+        minCycles: number;
+        requiresHumanApproval: boolean;
+        requiresSmokeTest: boolean;
+        retireOnMissesInRow?: number | undefined;
+    };
+    segments: {
+        name: string;
+        outputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        inputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        sideEffects: string[];
+    }[];
+    promotion_status: "candidate" | "stable" | "retired" | "system-stable";
+    entrypoint: {
+        preamble: string;
+        refs: {
+            path: string;
+            kind: "file" | "script" | "dir";
+        }[];
+    };
+    createdBy: "llm" | "human";
+    lastTouchedAt: string;
+}, {
+    name: string;
+    source: "user" | "system";
+    description: string;
+    schemaVersion: "peaks.bee/1";
+    promotion: {
+        minCycles: number;
+        requiresHumanApproval: boolean;
+        requiresSmokeTest: boolean;
+        retireOnMissesInRow?: number | undefined;
+    };
+    segments: {
+        name: string;
+        outputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        inputs: {
+            name: string;
+            type: "string" | "number" | "boolean" | "json";
+            required: boolean;
+        }[];
+        sideEffects: string[];
+    }[];
+    promotion_status: "candidate" | "stable" | "retired" | "system-stable";
+    entrypoint: {
+        preamble: string;
+        refs: {
+            path: string;
+            kind: "file" | "script" | "dir";
+        }[];
+    };
+    createdBy: "llm" | "human";
+    lastTouchedAt: string;
+}>;

package/dist/src/services/sediment/json-schema.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+export const BeeManifestSchema = z.object({
+    schemaVersion: z.literal("peaks.bee/1"),
+    name: z.string().regex(/^bee-[a-z0-9][a-z0-9-]*$|^peaks-[a-z0-9][a-z0-9-]*$/),
+    source: z.enum(["system", "user"]),
+    promotion_status: z.enum(["candidate", "stable", "retired", "system-stable"]),
+    description: z.string().min(1).max(200),
+    segments: z.array(z.object({
+        name: z.string(),
+        inputs: z.array(z.object({ name: z.string(), type: z.enum(["string", "number", "boolean", "json"]), required: z.boolean() })),
+        outputs: z.array(z.object({ name: z.string(), type: z.enum(["string", "number", "boolean", "json"]), required: z.boolean() })),
+        sideEffects: z.array(z.string()),
+    })),
+    entrypoint: z.object({
+        preamble: z.string(),
+        refs: z.array(z.object({ path: z.string(), kind: z.enum(["file", "dir", "script"]) })),
+    }),
+    promotion: z.object({
+        minCycles: z.number().int().nonnegative(),
+        requiresHumanApproval: z.boolean(),
+        requiresSmokeTest: z.boolean(),
+        retireOnMissesInRow: z.number().int().positive().optional(),
+    }),
+    createdBy: z.enum(["human", "llm"]),
+    lastTouchedAt: z.string().datetime(),
+}).refine((m) => !(m.source === "system" && m.promotion_status !== "system-stable"), { message: "source=system must have promotion_status=system-stable" });

package/dist/src/services/sediment/manifest-lint.d.ts

@@ -0,0 +1,13 @@
+import type { BeeManifest } from "./types.js";
+export type Finding = {
+    path: string;
+    message: string;
+};
+export type LintResult = {
+    ok: true;
+} | {
+    ok: false;
+    findings: Finding[];
+};
+export declare function lintManifest(m: unknown): LintResult;
+export declare function lintManifestStrict(m: unknown): BeeManifest;

package/dist/src/services/sediment/manifest-lint.js

@@ -0,0 +1,11 @@
+import { BeeManifestSchema } from "./json-schema.js";
+export function lintManifest(m) {
+    const r = BeeManifestSchema.safeParse(m);
+    if (r.success)
+        return { ok: true };
+    return { ok: false, findings: r.error.issues.map((i) => ({ path: i.path.join("."), message: i.message })) };
+}
+export function lintManifestStrict(m) {
+    const r = BeeManifestSchema.parse(m);
+    return r;
+}

package/dist/src/services/sediment/pool-paths.d.ts

@@ -0,0 +1,22 @@
+export declare class SYSTEM_PATH_FORBIDDEN extends Error {
+    constructor(p: string);
+}
+export interface Home {
+    home: string;
+}
+export declare const resolvePoolRoot: ({ home }: Home) => string;
+export declare const resolveSystemDir: ({ home }: Home) => string;
+export declare const resolveUserBeesDir: ({ home }: Home) => string;
+export declare const resolveUserBeeDir: ({ home }: Home, name: string) => string;
+export declare const resolveSegmentsDir: ({ home }: Home) => string;
+export declare const resolveSegmentDir: ({ home }: Home, name: string) => string;
+export declare const resolveStateDbPath: ({ home }: Home) => string;
+export declare const resolveBlobsDir: ({ home }: Home) => string;
+/**
+ * Normalize `..` segments via `path.resolve` before splitting, so a path like
+ * `/h/foo/../.system/evil` collapses to `/h/.system/evil` and its `.system`
+ * segment is correctly identified. Also defends against Windows-style
+ * traversal patterns such as `..\\.system\\evil`.
+ */
+export declare function isSystemPath(p: string): boolean;
+export declare function assertNotSystemPath(p: string): void;

package/dist/src/services/sediment/pool-paths.js

@@ -0,0 +1,25 @@
+import { join, resolve as pathResolve } from "node:path";
+export class SYSTEM_PATH_FORBIDDEN extends Error {
+    constructor(p) { super(`SYSTEM_PATH_FORBIDDEN: refusing to write ${p}`); }
+}
+export const resolvePoolRoot = ({ home }) => join(home, ".peaks", "skills");
+export const resolveSystemDir = ({ home }) => join(resolvePoolRoot({ home }), ".system");
+export const resolveUserBeesDir = ({ home }) => join(resolvePoolRoot({ home }), "bees");
+export const resolveUserBeeDir = ({ home }, name) => join(resolveUserBeesDir({ home }), name);
+export const resolveSegmentsDir = ({ home }) => join(resolvePoolRoot({ home }), "segments");
+export const resolveSegmentDir = ({ home }, name) => join(resolveSegmentsDir({ home }), name);
+export const resolveStateDbPath = ({ home }) => join(resolvePoolRoot({ home }), "state.db");
+export const resolveBlobsDir = ({ home }) => join(resolvePoolRoot({ home }), "blobs");
+/**
+ * Normalize `..` segments via `path.resolve` before splitting, so a path like
+ * `/h/foo/../.system/evil` collapses to `/h/.system/evil` and its `.system`
+ * segment is correctly identified. Also defends against Windows-style
+ * traversal patterns such as `..\\.system\\evil`.
+ */
+export function isSystemPath(p) {
+    return pathResolve(p).split(/[\\/]/).some((seg) => seg === ".system");
+}
+export function assertNotSystemPath(p) {
+    if (isSystemPath(p))
+        throw new SYSTEM_PATH_FORBIDDEN(p);
+}