peaks-loop 4.0.0-beta → 4.0.0-beta.3

package/dist/src/services/loop/loop-release-types.js

@@ -0,0 +1,162 @@
+import { z } from "zod";
+/**
+ * LoopRelease — spec §4.1 (Loop Engineering Asset).
+ *
+ * M1 scope was the §4.1 fields. M3 (this slice) ADDS the share /
+ * desktop extension fields from §4.1 / §7A:
+ *   - shareable              (boolean, default true)
+ *   - share_excluded_paths   (string[], default [])
+ *   - desktop_visible        (boolean, default true)
+ *   - export_bundle_format   ('peaks.bundle/1', CLI-written constant)
+ *
+ * The four M3 fields are added with `.default(...)` so an in-memory
+ * object built from a pre-M3 snapshot still parses after the
+ * migration runs. NO enforcement on `shareable=false` is added in M3
+ * — the schema-only addition is the contract; full export /
+ * desktop enforcement lands in M7 (see plan
+ * m3-bee-release-extension.md and spec §7A).
+ *
+ * Field semantics — see the spec for full prose. Highlights:
+ *
+ *   - `id` is the stable kebab-case loop id; the storage key.
+ *   - `schema_version` is the constant literal `"peaks.loop/1"`; a
+ *     schema-version bump requires a new table / new enum case and a
+ *     migration — never edit this literal in place.
+ *   - `lifecycle_status` is `candidate` / `stable` / `retired`; the
+ *     default on first crystallization is `candidate`. LLMs cannot
+ *     auto-promote to `stable` (see spec §5.6).
+ *   - `linked_bees` is a denormalized pointer list of bee ids; the
+ *     authoritative loop↔bee relations live in `loop_bee_relation`
+ *     (M2). Keeping it here matches the spec §4.1 row shape and lets
+ *     M1 readers iterate the loop without an extra join.
+ *   - `success_criteria` / `evaluator_policy` are NL strings, not
+ *     machine-checked predicates; the evaluator definitions live in
+ *     the M4 evolution layer.
+ *   - `share_excluded_paths` is a JSON-encoded TEXT column at the
+ *     SQLite layer; the Zod schema accepts a string[] and the store
+ *     does the JSON.stringify/parse boundary work. Matches the
+ *     existing `loop_release` style (success_criteria_json, …).
+ *   - `export_bundle_format` is pinned to the literal
+ *     `"peaks.bundle/1"` per the spec §7A.2 contract — no other
+ *     value is accepted in this schema version.
+ */
+export const LoopReleaseLifecycleStatusSchema = z.enum([
+    "candidate",
+    "stable",
+    "retired",
+]);
+/**
+ * The M3 share / desktop extension fields, listed for code-search /
+ * lint discoverability. They are now part of the schema (with safe
+ * defaults) — see `LoopReleaseM3ExtensionSchema` below.
+ *
+ *   - shareable: defaults to true.
+ *   - share_excluded_paths: string[] (defaults to []).
+ *   - desktop_visible: defaults to true.
+ *   - export_bundle_format: constant "peaks.bundle/1" (CLI-written).
+ */
+export const LOOP_RELEASE_M3_FIELDS = [
+    "shareable",
+    "share_excluded_paths",
+    "desktop_visible",
+    "export_bundle_format",
+];
+/**
+ * M3 share / desktop extension schema. Added to `LoopReleaseInputSchema`
+ * via `.extend(...)` so existing callers that omit these fields still
+ * parse — the Zod defaults below supply the spec values
+ * (true / [] / true / "peaks.bundle/1").
+ *
+ * `export_bundle_format` is pinned to a literal per spec §7A.2: the
+ * CLI is the only writer and only `"peaks.bundle/1"` is accepted. A
+ * schema-version bump is required to introduce another value.
+ */
+export const LoopReleaseM3ExtensionSchema = z.object({
+    shareable: z.boolean().default(true),
+    share_excluded_paths: z
+        .array(z.string().min(1).max(4096))
+        .default([]),
+    desktop_visible: z.boolean().default(true),
+    export_bundle_format: z
+        .literal("peaks.bundle/1")
+        .default("peaks.bundle/1"),
+});
+/**
+ * Zod schema for the create payload (LoopReleaseInput). Mirrors the
+ * §4.1 row shape; `schema_version` is defaulted (clients cannot
+ * override it) and `created_at` is not part of the input — the store
+ * stamps it from the server clock.
+ */
+export const LoopReleaseInputSchema = z
+    .object({
+    id: z
+        .string()
+        .min(1)
+        .max(64)
+        .regex(/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/, {
+        message: "id must be kebab-case starting with a lowercase letter (e.g. loop-onboarding-research)",
+    }),
+    name: z.string().min(1).max(200),
+    scenario: z.string().trim().min(1).max(4000),
+    trigger_policy: z.string().trim().min(1).max(2000),
+    success_criteria: z
+        .array(z.string().trim().min(1).max(1000))
+        .min(1, "success_criteria must list at least one declarative criterion"),
+    interaction_policy: z
+        .string()
+        .trim()
+        .min(1, "interaction_policy must declare human-NL-choice-only semantics")
+        .max(2000),
+    feedback_policy: z.string().trim().min(1).max(2000),
+    evolution_policy: z.string().trim().min(1).max(2000),
+    evaluator_policy: z.array(z.string().trim().min(1).max(1000)).min(1),
+    linked_bees: z.array(z.string().min(1).max(64)).default([]),
+    run_history: z.array(z.string().min(1).max(128)).default([]),
+    crystallization_evidence: z.array(z.string().min(1).max(128)).default([]),
+    lifecycle_status: LoopReleaseLifecycleStatusSchema,
+    version: z
+        .string()
+        .regex(/^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/, {
+        message: "version must be a semver string (e.g. 0.1.0)",
+    }),
+})
+    .extend(LoopReleaseM3ExtensionSchema.shape);
+/**
+ * Full Zod schema for a LoopRelease row as persisted. Differs from the
+ * input schema only in that `schema_version` is exposed (and defaulted
+ * to the fixed literal). The literal constraint still rejects any
+ * client-supplied value other than `"peaks.loop/1"`; the default
+ * means omitting the key is fine and the output always carries the
+ * constant.
+ *
+ * We expose this as the canonical "row schema" used by lint and
+ * service.create/read paths.
+ */
+export const LoopReleaseSchema = LoopReleaseInputSchema.extend({
+    schema_version: z
+        .literal("peaks.loop/1")
+        .default("peaks.loop/1"),
+});
+/**
+ * Convenience: strict-parse an unknown payload into a LoopRelease row.
+ * Throws ZodError on failure. This is the public validation boundary.
+ */
+export function parseLoopRelease(input) {
+    return LoopReleaseSchema.parse(input);
+}
+/**
+ * Convenience: safe-parse that returns a Result-like shape so callers
+ * (CLI layer in M5) can render findings without try/catch noise.
+ */
+export function safeParseLoopRelease(input) {
+    const r = LoopReleaseSchema.safeParse(input);
+    if (r.success)
+        return { ok: true, row: r.data };
+    return {
+        ok: false,
+        findings: r.error.issues.map((i) => ({
+            path: i.path.join("."),
+            message: i.message,
+        })),
+    };
+}

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/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

@@ -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-code', skillName: 'peaks-code', 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/share/bundle-reader.d.ts

@@ -0,0 +1,100 @@
+/**
+ * bundle-reader.ts — readBundle(inPath) (spec §7A.2).
+ *
+ * M7 / spec §7A.2 / §10 RL-9 / acceptance AC-25 / AC-26.
+ *
+ * Reads a `peaks.bundle/1` tar.gz and lands the contained release
+ * on the local SkillHub. The reader is the symmetrical counterpart
+ * of `bundle-writer.ts` — same layout, same content-addressed
+ * blobs/, but with three hard guards:
+ *
+ *   1. `format_version_major !== 1` is a HARD block. The reader
+ *      throws `SHARE_BUNDLE_MAJOR_VERSION_MISMATCH` before any
+ *      SQL side-effect. (Major-version bumps are reserved for
+ *      breaking schema changes; the receiver is not assumed to
+ *      know how to translate.)
+ *   2. `format_version_minor` mismatch is a non-fatal warn (the
+ *      reader collects it as a warning on the return envelope).
+ *   3. The imported release ALWAYS lands as `candidate`. The
+ *      reader refuses to write any other status; the receiver
+ *      MUST run an independent evaluation before promoting the
+ *      imported release to `stable` (AC-26 — peaks loop promote
+ *      reads evolution_evaluation rows).
+ *
+ * The reader is also the integration point for AC-26 — the loop
+ * promote path (which lives in a future slice / CLI command) checks
+ * `evolution_evaluation.independent_scorer_verdict` before allowing
+ * a candidate → stable transition; this slice does not add a new
+ * `peaks loop promote` because `peaks asset crystallize` already
+ * enforces the brief-section + pre-run gates and creates the
+ * initial `candidate` row. The integration test for AC-26 verifies
+ * that a freshly imported bundle has no `evolution_evaluation`
+ * row and that promotion therefore cannot proceed.
+ */
+import type Database from "better-sqlite3";
+import { SHARE_BUNDLE_ERROR_CODES, type PeaksBundleKind } from "./bundle-types.js";
+/**
+ * Thrown when `format_version_major !== 1`. This is the explicit
+ * HARD block per spec §7A.2 (major mismatch).
+ */
+export declare class BundleMajorVersionMismatchError extends Error {
+    readonly code: typeof SHARE_BUNDLE_ERROR_CODES.MAJOR_VERSION_MISMATCH;
+    readonly receivedMajor: number;
+    constructor(receivedMajor: number);
+}
+/**
+ * Thrown when the schema-versions mapping is missing or carries
+ * non-canonical literals.
+ */
+export declare class BundleSchemaVersionsMismatchError extends Error {
+    readonly code: typeof SHARE_BUNDLE_ERROR_CODES.SCHEMA_VERSIONS_MISMATCH;
+    readonly received: Record<string, unknown> | undefined;
+    constructor(received: Record<string, unknown> | undefined);
+}
+/**
+ * Thrown when the caller asks to land as anything other than
+ * `candidate` (the only allowed target status).
+ */
+export declare class BundleImportToStableForbiddenError extends Error {
+    readonly code: typeof SHARE_BUNDLE_ERROR_CODES.IMPORT_TO_STABLE_FORBIDDEN;
+    constructor(receivedStatus: string);
+}
+/**
+ * Thrown when the bundle tarball is malformed (no manifest.json,
+ * bad JSON, etc.). Distinct from a ZodError so the CLI can map
+ * to a single BUNDLE_MALFORMED code.
+ */
+export declare class BundleMalformedError extends Error {
+    readonly code: typeof SHARE_BUNDLE_ERROR_CODES.BUNDLE_MALFORMED;
+    constructor(message: string);
+}
+export type ReadBundleArgs = {
+    db: Database.Database;
+    /** Blobs root for content-addressed file write-back. */
+    blobsDir: string;
+    /** Input `.tar.gz` bundle path. */
+    inPath: string;
+    /**
+     * Optional rename for the anchor asset on import. For `loop`
+     * bundles this is the loop id to overwrite the source id; for
+     * `bee` bundles this is the `--as` bee name.
+     */
+    asName?: string;
+};
+/**
+ * Successful read result. The reader lands the bundle as a
+ * `candidate` regardless of any other lifecycle status on the
+ * source — this is the hard import rule per spec §7A.2 / AC-25.
+ */
+export type ReadBundleResult = {
+    /** Anchor asset id actually written. */
+    assetId: string | number;
+    kind: PeaksBundleKind;
+    /** Always `candidate` — the reader does not honor any other status. */
+    importedAs: "candidate";
+    /** Non-fatal warnings (e.g. minor-version mismatch). */
+    warnings: string[];
+    /** Count of crystallization_event rows imported. */
+    evidenceBriefCount: number;
+};
+export declare function readBundle(args: ReadBundleArgs): ReadBundleResult;