peaks-loop 4.0.0-beta → 4.0.0-beta.11

package/skills/peaks-solo/references/sediment-prompt-template.md

@@ -0,0 +1,62 @@
+# peaks-solo — Sediment Prompt Template (沉淀提议 AskUserQuestion)
+
+> 自规划兜底跑完(转交 leaf 跑完则由 leaf 内部 Step 11 处理,**不重复问**)→ peaks-solo 用本模板提议沉淀。
+> **核心约束(HC-9 Human-NL-Choice-Only 锁死):** 必须用 AskUserQuestion 4-option,**不**允许自由文本输入;**默认推荐 = (a)**,**不**是 (d)。
+
+## 4-option AskUserQuestion 模板
+
+```yaml
+question: "本次结果是否沉淀?"
+options:
+  - label: "(a) 沉淀为普通 lesson / convention"
+    description: "通过 peaks memory extract --apply 写到 .peaks/memory/<user>/,作为可复用 lessons/conventions。"
+  - label: "(b) 沉淀为 Loop Engineering 资产"
+    description: "通过 peaks asset crystallize 提升为 Loop Engineering Asset(标准 / skill / SOP / framework)。"
+  - label: "(c) 改 scope 再沉淀"
+    description: "本次 scope 不对,LLM 继续追问(例如想问清楚是什么 lesson),然后再走 (a) 或 (b)。"
+  - label: "(d) 不沉淀"
+    description: "单次性结果,丢弃,不写入任何 .peaks/ 路径。"
+multiSelect: false
+```
+
+## 默认推荐
+
+**默认推荐 = (a)**(普通 lesson / convention),**不**是 (d)。
+
+**为什么推荐 (a) 而不是 (b):** (b) 沉淀为 Loop Engineering Asset 是**重操作**——会进入 `.peaks/standards/` 或 `.peaks/memory/<asset>/`,影响所有 peaks-* skill 的语义。普通 lesson / convention 风险低、可回滚、不会污染项目 invariants,适合作为大多数一次性结果的首选归宿。(b) 仅在 LLM 识别 ≥ 2 个 reuse signals 时推荐。
+
+## LLM 必须给一段 NL rationale
+
+在调 AskUserQuestion 前,LLM **必须**先(在最终回复里,AskUserQuestion 之前)给一段 1-3 句的 NL 解释,说明为什么推荐 (a) 或 (b)。模板:
+
+> "我推荐 (a) 沉淀为普通 lesson / convention,理由:<1 句:本次结果的可复用程度 / 适用范围 / 为什么不是 (b) / 为什么不是 (d)>。如果你认为这是 Loop Engineering 级别的资产,选 (b);如果本次是单次性 / scope 不对,选 (c) 或 (d)。"
+
+**禁止:** 直接弹 AskUserQuestion 不解释;**禁止:** 默认推荐 (d)。
+
+## 触发条件矩阵
+
+| peaks-solo 跑完类型 | 是否问沉淀 | trigger 标记 |
+|---|---|---|
+| 转交 leaf 跑完 | **不问**(leaf 内部 Step 11 处理) | `leaf_handled` |
+| 自规划兜底跑完(成功) | **默认问** | `success_default_prompt` |
+| 自规划兜底跑完(部分失败) | **附带"是否继续"二选一 + 沉淀四选一**两个 AskUserQuestion | `partial_failure` |
+| 用户主动说"沉淀这个" / "把这个记下来" | **立即问**(跳过自规划完成检测) | `user_explicit` |
+| LLM 识别 ≥ 2 个 reuse signals(同一结果可在 ≥ 2 个未来场景复用) | **附带 4-section brief 问**(在 question 前先输出 brief:reuse contexts / scope / drift risks / crystallize recommendation) | `llm_suggested` |
+| 沉淀提议被用户选 (d) 后 | **不重复问**,直接关闭 peaks-solo session | `user_declined` |
+| 沉淀提议被用户选 (c) 后(scope 改) | **继续追问 → 再问一次 4-option** | `scope_change` |
+
+## 沉淀后的执行
+
+| 用户选 | LLM 执行 |
+|---|---|
+| (a) | `peaks memory extract --apply --session-id <sid> --project <repo>` —— 走现成 CLI,不重写 |
+| (b) | `peaks asset crystallize --asset <name> --project <repo>` —— 走现成 CLI;**仅**在用户明确选 (b) 后执行 |
+| (c) | 继续 AskUserQuestion 追问(例如"具体是什么场景的 lesson?" / "适用哪个子项目?") |
+| (d) | 不写任何文件;peaks-solo 直接结束 |
+
+## 反 pattern 警告
+
+- **不推荐 (b) 默认推荐** —— 大多数一次性结果进不了 Loop Engineering Asset 层;盲目 crystallize 会污染 `.peaks/standards/`。
+- **不静默丢弃** —— 用户没明示"不要沉淀",就必须问;选 (d) 必须是用户**主动选**,不是 LLM 默认。
+- **不重复问** —— 转交 leaf 跑完由 leaf 处理 sediment;peaks-solo 只对**自规划兜底跑完**问。
+- **不让用户自由文本** —— HC-9 锁死;不在 AskUserQuestion 选项之外加 free-form input。

package/skills/peaks-solo/references/triage-decision-table.md

@@ -0,0 +1,31 @@
+# peaks-solo — Triage Decision Table
+
+> 关键词 → leaf skill 快速映射。peaks-solo 在 §3 triage 决策流里先扫本表做"启发式预判",再用 `peaks skill search --query "<NL>"` 做精确匹配。
+> 匹配规则:case-insensitive substring(命中即行;同 NL 多行命中 → AskUserQuestion 多选)。
+
+| keyword | → | leaf skill |
+|---|---|---|
+| code / 代码 / 改 bug / 写功能 / 全流程 / 端到端 / PR / 测试覆盖 / 改 src | → | /peaks-code |
+| 文档 / article / blog / 内容 / 写稿 / 内容工作流 / 公众号 / 长文 | → | /peaks-content |
+| 健康 / health / 体检 / audit / 报告 / doctor report / 项目诊断 | → | /peaks-doctor |
+| issue / 修 issue / sweep / 批量修 / open issue 处理 | → | /peaks-issue-fix-orchestrator |
+| SOP / 流程 / 工作流 / 审批 / 门禁 / 标准操作 | → | /peaks-sop |
+| 性能 / perf / 慢 / 优化 / latency / 响应时间 | → | /peaks-perf-audit (or 自规划) |
+| 安全 / security / 漏洞 / vulnerability / OWASP | → | /peaks-security-audit (or 自规划) |
+| 状态 / status / 进度 / 现在到哪 / 当前在哪一步 | → | /peaks-status |
+| 跑测试 / test / vitest / unit test | → | /peaks-test |
+| 恢复 / resume / 继续 / 接上次 | → | /peaks-resume |
+| 不知道 / 随便 / 帮我 / 你帮我决定 / 我想做点东西 | → | peaks-solo triage (this skill) |
+| 切片 / slice / 拆解任务 / 大任务拆小 | → | /peaks-slice-decompose |
+| 想法 / brain-storm / 创意 / 探索思路 | → | /peaks-ide |
+| 最终审查 / final review / 验收 / 4-dim evidence | → | /peaks-final-review |
+| 研究 / research / 信息查询 / GitHub trending / top 10 / 调查 | → | (no leaf) → 自规划(deep-search / WebSearch) |
+| 一句话需求 / 一次性 / 单次性 | → | peaks-solo 自规划兜底 |
+
+## 使用说明
+
+1. **先扫表,再跑 search。** 表是 O(N) 的 substring 命中;跑 `peaks skill search` 是兜底。两者结果不一致时,以 search 为准(search 读的是 live frontmatter)。
+2. **多行命中 → AskUserQuestion 多选,**模板见 SKILL.md §3.1。
+3. **(e) "都不对" → 自规划兜底。** 走 SKILL.md §4。
+4. **空表条目:** "研究 / 信息查询 / GitHub trending / top 10" 等一次性信息查询,**当前 skill 池没有专属 leaf**,peaks-solo 直接走自规划(deep-search / WebSearch)。
+5. **本表是 opportunistic 表,**不是 exhaustive 表。S2/S3 后续可在 dogfood 中发现新关键词补行。

package/skills/peaks-status/SKILL.md

@@ -3,9 +3,9 @@ name: peaks-status
 description: Universal status primitive for any in-flight Peaks-Loop workflow (orchestrator-agnostic). Reads the existing CLI primitives (peaks skill presence, peaks session list, peaks project dashboard, peaks request show) and renders a 1-screen status table. Use when the user asks "where are we", "现在到哪了", "what's the current state" for ANY bee (peaks-code, future peaks-research, …). Triggers on "/peaks-status", "现在到哪了", "what is the current state", "show me the dashboard". (Replaces peaks-status as a top-level primitive.)
 ---
 
-# Peaks-Loop Solo Status (wrapper)
+# Peaks-Loop Code Status (wrapper)
 
-Peaks-Loop Solo Status is a thin wrapper that renders a compact status table for the current peaks-code orchestrator state. It is the answer to "I just want to know where we are" — no PRD, no RD, no QA, no full peaks-code orchestration. Just read the existing CLI state and render a 1-screen summary.
+Peaks-Loop Code Status is a thin wrapper that renders a compact status table for the current peaks-code orchestrator state. It is the answer to "I just want to know where we are" — no PRD, no RD, no QA, no full peaks-code orchestration. Just read the existing CLI state and render a 1-screen summary.
 
 **This is a transparent wrapper.** The user does not stay in this skill — the status table is rendered, and control hands off (back to the user, or to `peaks-code` if the user wants to act on the status).
 

package/skills/peaks-test/SKILL.md

@@ -3,9 +3,9 @@ name: peaks-test
 description: Universal test-runner primitive for any in-flight Peaks-Loop workflow (orchestrator-agnostic). Runs the project's test suite on the current repo and reports results. Use when the user asks "run the tests", "跑一下 test", "跑测试" for ANY bee (peaks-code, future peaks-research, …). Triggers on "/peaks-test", "跑一下 test", "跑测试", "run the tests", "test now". (Replaces peaks-test as a top-level primitive.)
 ---
 
-# Peaks-Loop Solo Test (wrapper)
+# Peaks-Loop Code Test (wrapper)
 
-Peaks-Loop Solo Test is a thin wrapper that runs the project's test suite on the current repo and reports results. It is the answer to "I just want to see if the tests pass" — no PRD, no RD, no QA, no full peaks-code orchestration. Just `pnpm vitest run` and a compact summary.
+Peaks-Loop Code Test is a thin wrapper that runs the project's test suite on the current repo and reports results. It is the answer to "I just want to see if the tests pass" — no PRD, no RD, no QA, no full peaks-code orchestration. Just `pnpm vitest run` and a compact summary.
 
 **This is a transparent wrapper.** The user does not stay in this skill — the test command runs, the result is summarized, and control hands off (back to the user, or to `peaks-code` if the user wants to act on the result).
 

package/dist/src/cli/cli-helpers.d.ts

@@ -1,43 +0,0 @@
-import { Command } from 'commander';
-import { getErrorMessage, ok, redactSensitiveErrorMessage, type ResultEnvelope } from '../shared/result.js';
-import type { ArtifactProvider, GuidedArtifactSetup } from '../services/artifacts/artifact-service.js';
-import type { ConfigLayer } from '../services/config/config-service.js';
-import type { MiniMaxProviderSmokeResult } from '../services/providers/minimax-provider-service.js';
-import type { MiniMaxWorkerResult } from '../services/providers/minimax-worker-service.js';
-import type { RecommendationWorkflow } from '../services/recommendations/recommendation-service.js';
-export type ProgramIO = {
-    stdout: (text: string) => void;
-    stderr: (text: string) => void;
-};
-export declare function printResult<T>(io: ProgramIO, result: ResultEnvelope<T>, asJson?: boolean): void;
-export declare function addJsonOption(command: Command): Command;
-export declare function failUnsupportedNonDryRun(io: ProgramIO, command: string, asJson?: boolean): void;
-/** CLI shim helper: render a `{ ok: boolean, error?, data? }` envelope
- *  and set `process.exitCode = 1` on failure.
- *
- *  Library functions MUST return envelopes like `{ ok, error?, data? }`
- *  and MUST NOT mutate `process.exitCode` themselves. The shim (the
- *  Commander `.action()` callback in `register*Commands`) owns the
- *  process-exit side-effect so the library can be re-used from non-CLI
- *  contexts (vitest, programmatic dispatch, plugin loading).
- *
- *  Output format mirrors the existing `registerSedimentCommands` shim:
- *  a JSON envelope on stdout (one line, parseable), nothing else.
- */
-export interface CliEnvelope {
-    ok: boolean;
-    error?: string;
-    data?: unknown;
-}
-export declare function printCliEnvelope(io: ProgramIO, r: CliEnvelope): void;
-export declare function isRecommendationWorkflow(value: string): value is RecommendationWorkflow;
-export declare function isArtifactProvider(value: string): value is ArtifactProvider;
-export declare function isArtifactSetupStep(value: string): value is GuidedArtifactSetup['step'];
-export declare function isArtifactRepoSegment(value: string): boolean;
-export declare function isMiniMaxHttpsUrl(value: string): boolean;
-export declare function parseConfigLayer(value: string | undefined): ConfigLayer | undefined | null;
-export declare function printInvalidConfigLayer(io: ProgramIO, command: string, asJson?: boolean): void;
-export declare function multipleOption(value: string, previous: string[]): string[];
-export declare function summarizeMiniMaxSmokeResult(result: MiniMaxProviderSmokeResult): MiniMaxProviderSmokeResult;
-export declare function summarizeMiniMaxWorkerResult(result: MiniMaxWorkerResult): MiniMaxWorkerResult;
-export { getErrorMessage, ok, redactSensitiveErrorMessage };

package/dist/src/cli/cli-helpers.js

@@ -1,86 +0,0 @@
-import { fail, getErrorMessage, ok, redactSensitiveErrorMessage } from '../shared/result.js';
-const MINIMAX_API_HOST = 'api.minimaxi.com';
-export function printResult(io, result, asJson = false) {
-    if (asJson) {
-        io.stdout(JSON.stringify(result, null, 2));
-        return;
-    }
-    if (!result.ok) {
-        io.stderr(`${result.code}: ${result.message}`);
-        for (const action of result.nextActions) {
-            io.stderr(`- ${action}`);
-        }
-        return;
-    }
-    io.stdout(JSON.stringify(result.data, null, 2));
-    for (const warning of result.warnings) {
-        io.stderr(`warning: ${warning}`);
-    }
-    for (const action of result.nextActions) {
-        io.stdout(`next: ${action}`);
-    }
-}
-export function addJsonOption(command) {
-    return command.option('--json', 'print machine-readable JSON envelope');
-}
-export function failUnsupportedNonDryRun(io, command, asJson) {
-    printResult(io, fail(command, 'UNSUPPORTED_NON_DRY_RUN', 'Only dry-run planning is supported', {}, ['Rerun with --dry-run or omit --no-dry-run']), asJson);
-    process.exitCode = 1;
-}
-export function printCliEnvelope(io, r) {
-    if (r.ok) {
-        io.stdout(JSON.stringify({ ok: true, data: r.data ?? null }));
-        return;
-    }
-    io.stdout(JSON.stringify({ ok: false, error: r.error }));
-    process.exitCode = 1;
-}
-export function isRecommendationWorkflow(value) {
-    return value === 'code-refactor' || value === 'product-refactor' || value === 'frontend-design';
-}
-export function isArtifactProvider(value) {
-    return value === 'github' || value === 'gitlab';
-}
-export function isArtifactSetupStep(value) {
-    return value === 'detect' || value === 'configure' || value === 'validate' || value === 'complete';
-}
-export function isArtifactRepoSegment(value) {
-    return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value) && !value.includes('..') && !value.endsWith('.');
-}
-export function isMiniMaxHttpsUrl(value) {
-    try {
-        const url = new URL(value);
-        return url.protocol === 'https:' && url.hostname === MINIMAX_API_HOST && url.username.length === 0 && url.password.length === 0 && url.search.length === 0 && url.hash.length === 0;
-    }
-    catch {
-        return false;
-    }
-}
-export function parseConfigLayer(value) {
-    if (value === undefined) {
-        return undefined;
-    }
-    return value === 'user' || value === 'project' ? value : null;
-}
-export function printInvalidConfigLayer(io, command, asJson) {
-    printResult(io, fail(command, 'INVALID_CONFIG_LAYER', 'Config layer must be user or project', {}, ['Use --layer user or --layer project']), asJson);
-    process.exitCode = 1;
-}
-export function multipleOption(value, previous) {
-    return [...(previous || []), value];
-}
-export function summarizeMiniMaxSmokeResult(result) {
-    return { ...result, responseText: null, summary: null };
-}
-export function summarizeMiniMaxWorkerResult(result) {
-    const provider = summarizeMiniMaxSmokeResult(result.provider);
-    return {
-        ...result,
-        provider,
-        reviewHandoff: {
-            model: result.reviewHandoff.model,
-            prompt: '[redacted]'
-        }
-    };
-}
-export { getErrorMessage, ok, redactSensitiveErrorMessage };

package/dist/src/cli/commands/agent-commands.d.ts

@@ -1,20 +0,0 @@
-/**
- * peaks agent * CLI surface — Slice: ECC 64 agents soft-optional
- * integration (per spec §7.2 line 818).
- *
- * Registers the new `peaks agent` top-level command with two
- * subcommands:
- *   - `peaks agent run <name> [--target <path>]`  — shell out to
- *     `npx ecc agent run <name> --target <path> --json` when ECC
- *     is installed; soft-fail with the 4-option install prompt
- *     when it isn't.
- *   - `peaks agent list`                          — emit the 12
- *     canonical ECC agents (the wrapper hardcodes the
- *     most-used subset; the full 64-agent list is
- *     discoverable at runtime via `npx ecc agent list`).
- *
- * The wrapper service is `src/services/agent/ecc-agent-service.ts`.
- */
-import { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare function registerAgentCommands(program: Command, io: ProgramIO): void;

package/dist/src/cli/commands/agent-commands.js

@@ -1,48 +0,0 @@
-import { runEccAgent, validateEccAgent, CANONICAL_ECC_AGENTS, } from '../../services/agent/ecc-agent-service.js';
-import { addJsonOption, getErrorMessage, printResult } from '../cli-helpers.js';
-import { fail, ok } from '../../shared/result.js';
-export function registerAgentCommands(program, io) {
-    const agent = program
-        .command('agent')
-        .description('Run an ECC agent (soft-optional per spec §7.2). 64 agents are npm-installable via npx ecc; peaks-loop shells out when ECC is installed and soft-fails with a 4-option install prompt when it is not. Native peaks-loop diagnostics still run via `peaks doctor scan`.');
-    addJsonOption(agent
-        .command('run <name>')
-        .description(`Run an ECC agent by name (e.g. 'security-reviewer', 'code-reviewer'). The canonical subprocess is \`npx ecc agent run <name> --target <path> --json\`.`)
-        .option('--target <path>', 'project root or file to analyze (default: cwd)')
-        .option('--enable', 'enable the ECC subprocess for this call (overrides default-off; soft-fails with the 4-option install prompt when ECC is missing)')).action(async (name, options) => {
-        const validationError = validateEccAgent(name);
-        if (validationError !== null) {
-            printResult(io, fail('agent.run', 'INVALID_AGENT_NAME', validationError, { agent: name }, [
-                'Use `peaks agent list` to see the canonical 12 agents',
-            ]), options.json);
-            process.exitCode = 1;
-            return;
-        }
-        const projectRoot = options.target ?? process.cwd();
-        try {
-            const result = runEccAgent({
-                agent: name,
-                projectRoot,
-                enableAgent: options.enable === true,
-            });
-            const data = { ...result, projectRoot };
-            const nextActions = [];
-            if (result.reason === 'flag-enabled-but-ecc-missing') {
-                nextActions.push('ECC not installed. Pick one of the four options below:', '  a) Install: run `npx ecc --help` to install, then re-run `peaks agent run`.', '  b) Skip this run: use the peaks-loop native diagnostic via `peaks doctor scan`.', '  c) Skip forever: run `peaks preferences set agentShieldEnabled false`.', '  d) Learn more: see docs/superpowers/specs/2026-06-11-peaks-loop-l1-l2-l3-redesign.md §7.2.');
-            }
-            const envelope = ok('agent.run', data, [...result.warnings], nextActions);
-            printResult(io, envelope, options.json);
-        }
-        catch (error) {
-            const message = getErrorMessage(error);
-            printResult(io, fail('agent.run', 'AGENT_RUN_FAILED', message, { agent: name, projectRoot, spawned: false }, [message]), options.json);
-            process.exitCode = 1;
-        }
-    });
-    addJsonOption(agent
-        .command('list')
-        .description(`List the 12 canonical ECC agents (peaks-loop ships a static subset; the full 64 are ECC-discovered).`)).action((options) => {
-        const envelope = ok('agent.list', { agents: CANONICAL_ECC_AGENTS.map((a) => ({ name: a.name, description: a.description })) }, [], ['Run any agent with: `peaks agent run <name> --target <path>`']);
-        printResult(io, envelope, options.json);
-    });
-}