peaks-loop 3.1.2 → 4.0.0-beta

package/dist/src/cli/commands/core/skill-command.js

@@ -22,9 +22,9 @@ export function registerSkillCommand(program, io) {
                     return -1;
                 if (b.name === 'peaks-sop')
                     return 1;
-                if (a.name === 'peaks-solo')
+                if (a.name === 'peaks-code')
                     return -1;
-                if (b.name === 'peaks-solo')
+                if (b.name === 'peaks-code')
                     return 1;
                 return a.name.localeCompare(b.name);
             });
@@ -125,7 +125,7 @@ export function registerSkillCommand(program, io) {
         }
         if (options.checkStale === true) {
             // Slice 002 (v2.15.0) AC-1: pair the read with a staleness
-            // check so callers (peaks-solo Step 1, statusline) get both
+            // check so callers (peaks-code Step 1, statusline) get both
             // pieces of info from a single CLI invocation. The presence
             // is returned UNCHANGED — `--check-stale` is a read-only flag,
             // not a clear.
@@ -193,7 +193,7 @@ export function registerSkillCommand(program, io) {
         printResult(io, ok('skill.presence:clear', { active: false, removed, projectContextUpdated: true }), options.json);
     });
     // Slice 002 (v2.15.0) — AC-1: presence staleness detector.
-    // peaks-solo Step 1 (and `peaks solo should-pause --step
+    // peaks-code Step 1 (and `peaks solo should-pause --step
     // step-1-mode-select`) calls this to decide whether the recorded
     // `mode` field can be trusted or whether the LLM must AskUserQuestion.
     addJsonOption(skill

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

@@ -10,7 +10,7 @@
  * never touches.
  *
  * Skill-first / CLI-auxiliary red line (PB-4 / AC-19/20): this command is
- * a primitive that the peaks-solo / peaks-rd / peaks-qa SKILL.md compose.
+ * a primitive that the peaks-code / peaks-rd / peaks-qa SKILL.md compose.
  * Users do NOT invoke it directly; the --help text and dispatch
  * envelope's `nextActions` reinforce the point.
  */
@@ -43,7 +43,7 @@ export function registerDispatchCommand(parent, io) {
         'Dry-run by design; the LLM executes the returned toolCall in its own ' +
         'environment. Flags: --write-artifact (G7), --use-headroom (G7.7), ' +
         '--force (G9 CLI 兜底). ' +
-        'See skills/peaks-solo/references/sub-agent-dispatch.md for the ' +
+        'See skills/peaks-code/references/sub-agent-dispatch.md for the ' +
         'orchestrator contract.')
         .argument('<role>', 'sub-agent role (e.g. rd | qa | ui | txt | qa-business | qa-business-api)')
         // 2.7.0 slice-dag-dispatcher MVP: --prompt is required ONLY when --from-dag is NOT

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

@@ -26,20 +26,20 @@ function projectRoot(opts) {
  *
  * Resolution order:
  * 1. `--session-id` flag (explicit override)
- * 2. `getCurrentSessionId(project)` — reads `.peaks/_runtime/session.json` per peaks-solo
+ * 2. `getCurrentSessionId(project)` — reads `.peaks/_runtime/session.json` per peaks-code
  * 3. Error (NO_ACTIVE_SESSION) — must never silently fall back to a random uuid
  */
 function resolveJobStateRoot(opts) {
     const project = projectRoot(opts);
     const sessionId = opts.sessionId ?? getCurrentSessionId(project);
     if (!sessionId) {
-        throw new Error('NO_ACTIVE_SESSION: peaks job requires --session-id or an active peaks-solo session via peaks workspace init');
+        throw new Error('NO_ACTIVE_SESSION: peaks job requires --session-id or an active peaks-code session via peaks workspace init');
     }
     const rootDir = join(project, '.peaks', '_runtime', sessionId, 'job');
     return { rootDir, sessionId, projectRoot: project };
 }
 export function registerJobCommands(program, io = { stdout: (t) => process.stdout.write(t), stderr: (t) => process.stderr.write(t) }) {
-    const job = new Command('job').description('Drive long multi-slice work as one Job (peaks-solo Step 0.8+)');
+    const job = new Command('job').description('Drive long multi-slice work as one Job (peaks-code Step 0.8+)');
     job
         .command('init')
         .requiredOption('--job-id <jid>')
@@ -57,7 +57,7 @@ export function registerJobCommands(program, io = { stdout: (t) => process.stdou
         // a random UUID would scatter state across dirs and break resume/auto-compact.
         let sessionId = opts.sessionId ?? getCurrentSessionId(project);
         if (!sessionId) {
-            return printResult(io, fail('init', 'NO_ACTIVE_SESSION', 'peaks job init requires --session-id (or an active peaks-solo session via peaks workspace init)', { project }, [
+            return printResult(io, fail('init', 'NO_ACTIVE_SESSION', 'peaks job init requires --session-id (or an active peaks-code session via peaks workspace init)', { project }, [
                 'Re-run with --session-id <sid>',
                 'Or run `peaks workspace init` to create a session first'
             ]), opts);
@@ -239,7 +239,7 @@ export function registerJobCommands(program, io = { stdout: (t) => process.stdou
     addJsonOption(job.commands.find(c => c.name() === 'resume'));
     // v3.1.2: read the on-disk slice progress mirror written by `peaks
     // job checkpoint --state done`. Used by peaks solo gate-step-08 and
-    // by peaks-solo Step 0.7 (resume) to surface `Next: slice #N of M
+    // by peaks-code Step 0.7 (resume) to surface `Next: slice #N of M
     // (<currentSlice>)` without re-deriving from state.json.
     job
         .command('progress')

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

@@ -184,7 +184,7 @@ export function registerObservabilityCommands(program, io) {
     });
     addJsonOption(observability
         .command('repair-cycles')
-        .description('RD → QA repair-cycle count per slice. Cap = 3 (peaks-solo repair-loop contract); capHit flag is set when any slice hits the cap.')
+        .description('RD → QA repair-cycle count per slice. Cap = 3 (peaks-code repair-loop contract); capHit flag is set when any slice hits the cap.')
         .option('--project <path>', 'target project root (defaults to git root or cwd)')
         .option('--session <sessionId>', 'scope to one session (defaults to the canonical session binding)')).action((options) => {
         runRepairCycles(io, options);

package/dist/src/cli/commands/perf-audit-commands.js

@@ -37,7 +37,7 @@ function readStdinSync() {
 export function registerPerfAuditCommands(program, io) {
     const perfAudit = program
         .command('perf-audit')
-        .description('Independent performance audit skill driver. Reads the immutable peaks-prd handoff (sha256-locked) + the project-level perf-template.md, then writes a structured perf-<rid>.md artifact. Decoupled from peaks-rd 5-way fan-out per slice v2.12.0 (Group A, Tier 3). See skills/peaks-perf-audit/SKILL.md for the full workflow.');
+        .description('Independent performance audit skill driver. Reads the immutable peaks-prd handoff (sha256-locked) + the project-level perf-template.md, then writes a structured perf-<rid>.md artifact. Decoupled from peaks-rd 5-way fan-out per slice v2.12.0 (Group A, Tier 3). See skills/bee/peaks-perf-audit/SKILL.md for the full workflow.');
     addJsonOption(perfAudit
         .command('detect')
         .description('Read-only probe: returns the 5-state perf-audit runtime as a JSON envelope (ready / handoff-missing / template-missing / dispatch-failed / envelope-malformed). The peaks-perf-audit skill calls this first to decide whether to invoke `run`. Mirrors `peaks security-audit detect` semantics.')
@@ -100,7 +100,7 @@ export function registerPerfAuditCommands(program, io) {
             if (!isPerfAuditEnvelope(envelopeValue)) {
                 printResult(io, fail('perf-audit.run', 'ENVELOPE_MALFORMED', 'envelope failed isPerfAuditEnvelope validation (expected { verdict, violations, summary })', { receivedType: typeof envelopeValue }, [
                     'Verify the peaks-perf-audit skill prompt matches the strict-shape contract.',
-                    'Re-emit the envelope; see skills/peaks-perf-audit/references/audit-protocol.md.'
+                    'Re-emit the envelope; see skills/bee/peaks-perf-audit/references/audit-protocol.md.'
                 ]), options.json);
                 process.exitCode = 1;
                 return;

package/dist/src/cli/commands/security-audit-commands.js

@@ -37,7 +37,7 @@ function readStdinSync() {
 export function registerSecurityAuditCommands(program, io) {
     const securityAudit = program
         .command('security-audit')
-        .description('Independent security audit skill driver. Reads the immutable peaks-prd handoff (sha256-locked) + the project-level security-template.md, then writes a structured security-<rid>.md artifact. Decoupled from peaks-rd 5-way fan-out per slice v2.12.0 (Group A, Tier 2). See skills/peaks-security-audit/SKILL.md for the full workflow.');
+        .description('Independent security audit skill driver. Reads the immutable peaks-prd handoff (sha256-locked) + the project-level security-template.md, then writes a structured security-<rid>.md artifact. Decoupled from peaks-rd 5-way fan-out per slice v2.12.0 (Group A, Tier 2). See skills/bee/peaks-security-audit/SKILL.md for the full workflow.');
     addJsonOption(securityAudit
         .command('detect')
         .description('Read-only probe: returns the 5-state security-audit runtime as a JSON envelope (ready / handoff-missing / template-missing / dispatch-failed / envelope-malformed). The peaks-security-audit skill calls this first to decide whether to invoke `run`. Mirrors `peaks code-review detect-ocr` semantics.')
@@ -100,7 +100,7 @@ export function registerSecurityAuditCommands(program, io) {
             if (!isSecurityAuditEnvelope(envelopeValue)) {
                 printResult(io, fail('security-audit.run', 'ENVELOPE_MALFORMED', 'envelope failed isSecurityAuditEnvelope validation (expected { verdict, violations, summary })', { receivedType: typeof envelopeValue }, [
                     'Verify the peaks-security-audit skill prompt matches the strict-shape contract.',
-                    'Re-emit the envelope; see skills/peaks-security-audit/references/audit-protocol.md.'
+                    'Re-emit the envelope; see skills/bee/peaks-security-audit/references/audit-protocol.md.'
                 ]), options.json);
                 process.exitCode = 1;
                 return;

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

@@ -0,0 +1,80 @@
+import type { Command } from "commander";
+import type { ProgramIO } from "../cli-helpers.js";
+export interface CliResult {
+    ok: boolean;
+    error?: string;
+    data?: unknown;
+}
+/** Typed accessor over the flag map produced by `parseFlags`.
+ *
+ * `parseFlags` internally stores every flag with at least one value as a
+ * `string[]`. A flag with no following non-flag token (e.g. `--apply`,
+ * `--dry-run`) is recorded as `true`. This helper exposes three typed
+ * accessors so call-sites don't have to re-narrow `unknown` or
+ * `string | boolean | string[]` on every read:
+ *
+ *   - `flags.list(name)`     → `string[]` (always an array; a single
+ *                              occurrence is wrapped to a 1-element
+ *                              array at parse time)
+ *   - `flags.bool(name)`     → `boolean` (presence-of flag; missing
+ *                              flag is `false`)
+ *   - `flags.maybeString(name)` → `string | undefined` (first value,
+ *                              or `undefined` if the flag was given
+ *                              as a bare boolean with no value)
+ *
+ * The dispatch layer (runSediment) was previously peppered with
+ * `typeof flags.x === "string"` / `Array.isArray(flags.x)` narrowing.
+ * With this helper the call-sites collapse to one-line reads and the
+ * raw flag map stops leaking across the runSediment boundary.
+ */
+export declare class ParsedFlags {
+    private readonly raw;
+    constructor(raw: Record<string, string[] | true>);
+    /** Always returns an array. Missing flag → []. Single-occurrence
+     *  flag → a 1-element array (parseFlags normalizes this). */
+    list(name: string): string[];
+    /** Presence-of a bare boolean flag. Missing → false. */
+    bool(name: string): boolean;
+    /** First value of a flag, or `undefined` if the flag is absent or
+     *  was given as a bare boolean. */
+    maybeString(name: string): string | undefined;
+}
+/** Parse an argv tail into positional args + flag map.
+ *
+ * Supports:
+ *   --flag value    → flags[flag] = [value, ...] (advance i by 1)
+ *   --flag          → flags[flag] = true        (when next token starts with `--` or is undefined)
+ *   --flag v1 --flag v2   → repeated `--flag` values are accumulated
+ *
+ * Internally stores all values as `string[]` (or `true` for a bare
+ * boolean flag). Use the `ParsedFlags` helper to read typed accessors.
+ *
+ * Repeatable flag handling (Task 15b): when the same `--key` appears
+ * consecutively (e.g. `--segment a --segment b --segment c`), values
+ * are accumulated into a single `string[]`. A single occurrence is
+ * normalized to a 1-element array so callers can use `.list(name)`
+ * uniformly without shape-narrowing on the call-site.
+ */
+export declare function parseFlags(argv: string[]): {
+    positional: string[];
+    flags: ParsedFlags;
+};
+/** Dispatch a sediment verb argv to the matching implementation.
+ *
+ * Returns { ok: true, data? } on success and { ok: false, error }
+ * on validation failure or SYSTEM_PATH_FORBIDDEN. Unknown verbs
+ * return `{ ok: false, error: "UNKNOWN_VERB: <v>" }` so callers can
+ * distinguish "not yet implemented" from "zod rejected".
+ */
+export declare function runSediment(argv: string[], { home }: {
+    home: string;
+}): Promise<CliResult>;
+/** Register the `peaks skill sediment <verb>` subcommand group.
+ *
+ *  Task 15a wired 4 verbs; Task 15b adds 4 more (refine-bee / clone-bee /
+ *  promote / retire). The subcommand accepts variadic args so caller-side
+ *  code (peaks-cli action handler) can re-dispatch to `runSediment` for
+ *  the actual verb routing. Subsequent tasks (15c / 15d) will add the
+ *  remaining 10 verbs by extending the `runSediment` switch statement.
+ */
+export declare function registerSedimentCommands(program: Command, io: ProgramIO): void;