peaks-cli 1.4.1 → 1.4.2

package/dist/src/services/retrospective/retrospective-search-service.js

@@ -0,0 +1,75 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fuzzyMatchWithKey } from '../fuzzy-matching/fuzzy-match-service.js';
+const DEFAULT_LIMIT = 6;
+/**
+ * Read `.peaks/retrospective/index.json` and return the entries.
+ * Throws structured errors with stable codes that the CLI converts
+ * to the peaks envelope.
+ */
+function readIndex(projectRoot) {
+    const resolvedRoot = resolve(projectRoot);
+    const indexPath = join(resolvedRoot, '.peaks', 'retrospective', 'index.json');
+    if (!existsSync(indexPath)) {
+        const err = new Error(`INDEX_MISSING: retrospective index not found at ${indexPath}`);
+        err.code = 'INDEX_MISSING';
+        throw err;
+    }
+    let raw;
+    try {
+        raw = readFileSync(indexPath, 'utf8');
+    }
+    catch (cause) {
+        const err = new Error(`INDEX_INVALID: failed to read retrospective index at ${indexPath}: ${cause.message}`);
+        err.code = 'INDEX_INVALID';
+        throw err;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (cause) {
+        const err = new Error(`INDEX_INVALID: malformed retrospective index at ${indexPath}: ${cause.message}`);
+        err.code = 'INDEX_INVALID';
+        throw err;
+    }
+    const index = parsed;
+    return Array.isArray(index.entries) ? index.entries : [];
+}
+/**
+ * Run the generic fuzzy kernel against the on-disk retrospective index.
+ * Searchable text is `title + " " + summary` per spec §Component Details.
+ * `--type` and `--outcome` filters compose with AND before the kernel
+ * runs (cheaper to filter, then fuzzy on a smaller set).
+ */
+export function searchRetrospective(input) {
+    if (input.query === '') {
+        const err = new Error('EMPTY_QUERY: searchRetrospective requires a non-empty query (use `peaks retrospective index` to list all)');
+        err.code = 'EMPTY_QUERY';
+        throw err;
+    }
+    const projectRoot = input.projectRoot ?? process.cwd();
+    const limit = input.limit ?? DEFAULT_LIMIT;
+    let candidates = readIndex(projectRoot);
+    if (input.type !== undefined) {
+        candidates = candidates.filter((e) => e.type === input.type);
+    }
+    if (input.outcome !== undefined) {
+        candidates = candidates.filter((e) => e.outcome === input.outcome);
+    }
+    const matches = fuzzyMatchWithKey(input.query, candidates, { keyFn: (e) => `${e.title} ${e.summary}`, limit, caseSensitive: false });
+    return matches.map((m) => {
+        const entry = m.item;
+        return {
+            id: entry.id,
+            sessionId: entry.sessionId,
+            type: entry.type,
+            title: entry.title,
+            summary: entry.summary,
+            outcome: entry.outcome,
+            artifactPaths: entry.artifactPaths,
+            score: m.score,
+            positions: m.positions,
+        };
+    });
+}

package/dist/src/services/standards/project-context.d.ts

@@ -1,6 +1,6 @@
 export type BuildTool = 'umi' | 'next' | 'vite' | 'rsbuild' | 'rspack' | 'farm' | 'craco' | 'webpack' | 'gulp' | 'angular' | 'custom' | 'unknown';
 export type ComponentLibrary = {
-    readonly name: 'antd' | 'antd-pro' | 'mui' | 'shadcn' | 'element-plus' | 'element-ui' | 'arco' | 'tdesign' | 'semi' | 'nextui' | 'chakra' | 'vant' | 'none';
+    readonly name: 'antd' | 'antd-pro' | 'mui' | 'element-plus' | 'element-ui' | 'arco' | 'tdesign' | 'semi' | 'nextui' | 'chakra' | 'vant' | 'none';
     readonly majorVersion?: string;
     readonly hasProSuite?: boolean;
 };

package/dist/src/services/standards/project-context.js

@@ -64,8 +64,6 @@ function detectComponentLibrary(deps) {
     }
     if ('@mui/material' in deps)
         return { name: 'mui', ...(majorOf(deps['@mui/material']) !== undefined ? { majorVersion: majorOf(deps['@mui/material']) } : {}) };
-    if ('tailwindcss' in deps && Object.keys(deps).some((d) => d.startsWith('@radix-ui/')))
-        return { name: 'shadcn' };
     if ('element-plus' in deps)
         return { name: 'element-plus' };
     if ('element-ui' in deps)
@@ -279,8 +277,6 @@ export function componentLibraryLabel(lib) {
                 return 'Ant Design + Ant Design Pro';
             case 'mui':
                 return 'Material UI';
-            case 'shadcn':
-                return 'shadcn/ui (Tailwind + Radix)';
             case 'element-plus':
                 return 'Element Plus';
             case 'element-ui':

package/dist/src/services/standards/project-standards-service.js

@@ -159,8 +159,6 @@ function renderCommonCodingStyle(ctx) {
     }
     if (lib === 'mui')
         stackRules.push('- Style MUI via `sx`, `styled()`, and `theme`. Do NOT apply TailwindCSS utility classes directly to MUI components.');
-    if (lib === 'shadcn')
-        stackRules.push('- Use existing shadcn component variants and Tailwind utility classes. Do not introduce a competing component library.');
     if (ctx.cssFrameworks.includes('tailwind') && (lib === 'antd' || lib === 'antd-pro' || lib === 'mui')) {
         stackRules.push('- TailwindCSS is for layout/utility only; component-library tokens own component styling.');
     }
@@ -185,7 +183,7 @@ function renderCodeReview(ctx) {
     const extra = [];
     const lib = ctx.componentLibrary.name;
     if (lib === 'antd' || lib === 'antd-pro') {
-        extra.push('- Block PRs that introduce a second component library (MUI/shadcn/Chakra) alongside antd.');
+        extra.push('- Block PRs that introduce a second component library (MUI/Chakra) alongside antd.');
         extra.push('- Block PRs that import antd v3/v4 APIs in this v5 project, or vice versa.');
     }
     if (ctx.cssFrameworks.includes('tailwind') && (lib === 'antd' || lib === 'antd-pro' || lib === 'mui')) {

package/dist/src/services/workspace/migrate-1-4-1-service.js

@@ -41,7 +41,7 @@ function sha256(content) {
 function enumerateLegacySessions(projectRoot) {
     // Legacy per-session dirs: `.peaks/<sid>/` (NOT `.peaks/_runtime/<sid>/`).
     // We skip well-known non-session entries.
-    const SKIP = new Set(['memory', 'PROJECT.md', 'retrospective', 'scope', 'skill-scope', '.peaks-init-hooks-decision.json', 'session.json', '.session.json', '_runtime', '_sub_agents', 'change', 'caller', 'callers', 'sop-state', 'system', 'active-skill.json', '.active-skill.json']);
+    const SKIP = new Set(['memory', 'PROJECT.md', 'retrospective', 'scope', '.peaks-init-hooks-decision.json', 'session.json', '.session.json', '_runtime', '_sub_agents', 'change', 'caller', 'callers', 'sop-state', 'system', 'active-skill.json', '.active-skill.json']);
     const peaksRoot = join(projectRoot, '.peaks');
     if (!existsSync(peaksRoot))
         return [];

package/dist/src/shared/version.d.ts

@@ -1 +1 @@
-export declare const CLI_VERSION = "1.4.1";
+export declare const CLI_VERSION = "1.4.2";

package/dist/src/shared/version.js

@@ -1 +1 @@
-export const CLI_VERSION = "1.4.1";
+export const CLI_VERSION = "1.4.2";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peaks-cli",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Cross-AI-IDE workflow-gating CLI + skill family (Claude Code shipped, Trae in progress; Codex / Cursor / Qoder / Tongyi Lingma on the roadmap).",
   "author": "SquabbyZ",
   "license": "MIT",
@@ -55,15 +55,11 @@
   },
   "dependencies": {
     "@colbymchenry/codegraph": "0.7.10",
-    "chalk": "^5.6.2",
     "commander": "^12.1.0",
-    "headroom-ai": "0.22.4",
-    "ora": "^8.2.0",
-    "shadcn": "4.7.0",
-    "terminal-kit": "^3.1.2"
+    "fzf": "^0.5.2",
+    "headroom-ai": "0.22.4"
   },
   "devDependencies": {
-    "@types/chalk": "^2.2.4",
     "@types/node": "^22.10.2",
     "@vitest/coverage-v8": "^2.1.8",
     "tsx": "^4.19.2",

package/skills/peaks-solo/SKILL.md

@@ -185,7 +185,7 @@ Five CLI commands harden the workflow against silent skips: `peaks request lint`
 
 ## Peaks-Cli Completion handoff
 
-After final validation, refresh project-local standards via `peaks standards init/update` (never hand-write). Use Peaks-Cli TXT for the compact handoff capsule: mode, validated decisions, artifact paths, standards deltas, open questions, next action. Do NOT call `peaks skill presence:clear --project <repo>` at workflow end (presence remains active for follow-ups).
+After final validation, refresh project-local standards via `peaks standards init/update` (never hand-write). Use Peaks-Cli TXT for the compact handoff capsule: mode, validated decisions, artifact paths, standards deltas, open questions, next action. **Presence management is delegated to the last downstream skill in the workflow** — peaks-solo does not call `peaks skill presence:clear` itself, and does not enforce a "no clear" rule. The downstream skills (peaks-rd, peaks-qa, peaks-txt) each manage their own presence per their respective SKILL.md.
 
 → see `references/completion-handoff.md` for the full handoff + "no auto-exit" rule.
 

package/skills/peaks-solo/references/completion-handoff.md

@@ -8,7 +8,9 @@ Use Peaks-Cli TXT for the compact handoff capsule: mode, validated decisions, ar
 
 ## Workflow completion (no auto-exit)
 
-Do NOT call `peaks skill presence:clear --project <repo>` at workflow end. The presence file and header remain active so the user stays inside the workflow context. The user can continue with follow-up requirements naturally — no need to re-invoke `/peaks-solo`. The header continues to display the active skill and current gate.
+peaks-solo does NOT itself call `peaks skill presence:clear --project <repo>` at workflow end. Presence management is delegated to the last downstream skill in the workflow (peaks-rd, peaks-qa, peaks-txt); each of those skills owns its own presence:clear step per its SKILL.md. peaks-solo only sets presence: it does not unset it.
+
+The user can continue with follow-up requirements naturally — no need to re-invoke `/peaks-solo` to do so. The header continues to display whatever skill is active; the user can `/peaks-solo` again to re-anchor.
 
 Before ending, extract durable memories from this session:
 ```bash

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

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-import { type ProgramIO } from '../cli-helpers.js';
-export declare function registerShadcnCommands(program: Command, io: ProgramIO): void;

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

@@ -1,35 +0,0 @@
-import { createShadcnInvocation, executeShadcnInvocation } from '../../services/shadcn/shadcn-service.js';
-import { fail } from '../../shared/result.js';
-import { getErrorMessage, printResult, redactSensitiveErrorMessage } from '../cli-helpers.js';
-function printShadcnFailure(io, error, exitCode = 1) {
-    printResult(io, fail('shadcn', 'SHADCN_COMMAND_FAILED', redactSensitiveErrorMessage(getErrorMessage(error)), {}, ['Check the shadcn command arguments before retrying']), false);
-    process.exitCode = exitCode;
-}
-async function runShadcnCommand(io, args) {
-    try {
-        const invocation = createShadcnInvocation({ args });
-        const result = await executeShadcnInvocation(invocation);
-        const didFail = result.exitCode !== null && result.exitCode !== 0;
-        if (result.stdout.length > 0) {
-            io.stdout((didFail ? redactSensitiveErrorMessage(result.stdout) : result.stdout).trimEnd());
-        }
-        if (result.stderr.length > 0) {
-            io.stderr((didFail ? redactSensitiveErrorMessage(result.stderr) : result.stderr).trimEnd());
-        }
-        if (didFail) {
-            process.exitCode = result.exitCode;
-        }
-    }
-    catch (error) {
-        printShadcnFailure(io, error);
-    }
-}
-export function registerShadcnCommands(program, io) {
-    program
-        .command('shadcn')
-        .description('Run the pinned shadcn CLI bundled with Peaks')
-        .allowUnknownOption(true)
-        .helpOption(false)
-        .argument('<args...>', 'arguments forwarded to shadcn')
-        .action((args) => runShadcnCommand(io, args));
-}

package/dist/src/cli/commands/skill-context-stats-command.d.ts

@@ -1,40 +0,0 @@
-/**
- * `peaks skill context-stats` — R003.2
- *
- * Reports the per-project skill context footprint for the LLM:
- *   - Total bytes of allowed skills (full SKILL.md)
- *   - Total bytes of denied skills (shadow stubs in the project-local mirror)
- *   - Estimated token counts (chars/4 for full skills, bytes*0.25 for stubs)
- *   - Shadow-stub reduction percentage vs. the original full SKILL.md bytes
- *
- * If no scope is applied (no `.peaks/scope/skills.json`), returns the
- * "no-scope" branch with a recommended command.
- */
-import { type ResultEnvelope } from '../../shared/result.js';
-export interface RunContextStatsInput {
-    readonly projectRoot: string;
-    readonly json: boolean;
-    /** Average bytes-per-skill estimate for denied skills without a real SKILL.md (default 7000). */
-    readonly estimatedDeniedOriginalBytes?: number;
-}
-export interface ContextStatsData {
-    readonly scope: unknown;
-    readonly totals: {
-        readonly allowedCount: number;
-        readonly deniedCount: number;
-        readonly allowedBytes: number;
-        readonly stubBytes: number;
-        readonly originalDeniedBytes: number;
-        readonly shadowReductionPct: number;
-        readonly totalBytes: number;
-    };
-    readonly estimatedTokens: {
-        readonly allowed: number;
-        readonly denied: number;
-        readonly total: number;
-    };
-    readonly message?: string;
-    readonly recommendedCommand?: string;
-    readonly human?: string;
-}
-export declare function runContextStats(input: RunContextStatsInput): Promise<ResultEnvelope<ContextStatsData>>;

package/dist/src/cli/commands/skill-context-stats-command.js

@@ -1,96 +0,0 @@
-/**
- * `peaks skill context-stats` — R003.2
- *
- * Reports the per-project skill context footprint for the LLM:
- *   - Total bytes of allowed skills (full SKILL.md)
- *   - Total bytes of denied skills (shadow stubs in the project-local mirror)
- *   - Estimated token counts (chars/4 for full skills, bytes*0.25 for stubs)
- *   - Shadow-stub reduction percentage vs. the original full SKILL.md bytes
- *
- * If no scope is applied (no `.peaks/scope/skills.json`), returns the
- * "no-scope" branch with a recommended command.
- */
-import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-import { ok, fail } from '../../shared/result.js';
-export async function runContextStats(input) {
-    const projectRoot = input.projectRoot;
-    const scopePath = join(projectRoot, '.peaks', 'scope', 'skills.json');
-    if (!existsSync(scopePath)) {
-        const noScopeData = {
-            scope: null,
-            totals: {
-                allowedCount: 0,
-                deniedCount: 0,
-                allowedBytes: 0,
-                stubBytes: 0,
-                originalDeniedBytes: 0,
-                shadowReductionPct: 0,
-                totalBytes: 0,
-            },
-            estimatedTokens: { allowed: 0, denied: 0, total: 0 },
-            message: 'No scope applied. Run `peaks skill scope --apply --loose` to enable the skill whitelist for this project.',
-            recommendedCommand: 'peaks skill scope --apply --loose',
-        };
-        return fail('skill.context-stats', 'NO_SCOPE', 'No scope applied to this project.', noScopeData);
-    }
-    const raw = JSON.parse(readFileSync(scopePath, 'utf8'));
-    const allowlist = raw.allowlist;
-    const denied = [];
-    // Walk .claude/skills/ to find shadow stubs (denied skills not in allowlist).
-    const skillsMirror = join(projectRoot, '.claude', 'skills');
-    let stubBytes = 0;
-    let originalDeniedBytes = 0;
-    const estimatedDeniedOriginalBytes = input.estimatedDeniedOriginalBytes ?? 7000;
-    if (existsSync(skillsMirror)) {
-        for (const entry of readdirSync(skillsMirror)) {
-            const skillMd = join(skillsMirror, entry, 'SKILL.md');
-            if (!existsSync(skillMd))
-                continue;
-            if (allowlist.includes(entry))
-                continue; // allowed skills are NOT in the mirror
-            denied.push(entry);
-            const stat = statSync(skillMd);
-            stubBytes += stat.size;
-            // Heuristic: a denied skill would have loaded its full body (~7000 bytes) without shadow-fallback.
-            // We use this as the "original" to compute the reduction.
-            originalDeniedBytes += estimatedDeniedOriginalBytes;
-        }
-    }
-    // For allowed skills, compute the sum of their original SKILL.md bytes from the global catalog.
-    // We don't know the global catalog path here; estimate at 364 KB / 44 = 8272 bytes per allowed skill.
-    const allowedBytes = allowlist.length * 8272; // matches the R002 measurement
-    const totalBytes = allowedBytes + stubBytes;
-    const shadowReductionPct = originalDeniedBytes > 0 ? 1 - stubBytes / originalDeniedBytes : 0;
-    // Token estimation: chars / 4 for full skills; bytes * 0.25 for stubs (YAML is denser).
-    const allowedTokens = Math.round(allowedBytes / 4);
-    const deniedTokens = Math.round(stubBytes * 0.25);
-    const totalTokens = allowedTokens + deniedTokens;
-    const totals = {
-        allowedCount: allowlist.length,
-        deniedCount: denied.length,
-        allowedBytes,
-        stubBytes,
-        originalDeniedBytes,
-        shadowReductionPct,
-        totalBytes,
-    };
-    const estimatedTokens = {
-        allowed: allowedTokens,
-        denied: deniedTokens,
-        total: totalTokens,
-    };
-    const data = {
-        scope: raw,
-        totals,
-        estimatedTokens,
-    };
-    if (!input.json) {
-        data.human = [
-            `Allowed: ${allowlist.length} skills, ${(allowedBytes / 1024).toFixed(1)} KB / ${(allowedTokens / 1000).toFixed(1)}K tokens.`,
-            `Denied: ${denied.length} skills, ${(stubBytes / 1024).toFixed(1)} KB / ${(deniedTokens / 1000).toFixed(1)}K tokens (${(shadowReductionPct * 100).toFixed(1)}% shadow-stub reduction).`,
-            `Total: ${(totalBytes / 1024).toFixed(1)} KB / ${(totalTokens / 1000).toFixed(1)}K tokens.`,
-        ].join('\n');
-    }
-    return ok('skill.context-stats', data);
-}

package/dist/src/cli/commands/skill-scope-commands.d.ts

@@ -1,51 +0,0 @@
-/**
- * `peaks skill scope` CLI surface (slice 025.1).
- *
- * Four subcommands (mutually exclusive):
- * - `--detect` — dry-run; prints the relevance matrix, never touches files.
- * - `--apply`  — writes the source-of-truth + IDE-native config.
- * - `--show`   — reads the source-of-truth + native config back.
- * - `--reset`  — removes the source-of-truth + IDE-native config.
- *
- * Exit code matrix (tech-doc §6.3):
- *   0  success
- *   1  uncaught error
- *   2  invalid usage (missing/incompatible flags)
- *   3  source-of-truth written but adapter returned NOT_SUPPORTED
- *   4  adapter failure other than NOT_SUPPORTED
- */
-import { Command } from 'commander';
-import { type ResultEnvelope } from '../../shared/result.js';
-import { type ProgramIO } from '../cli-helpers.js';
-export type SkillScopeAction = 'detect' | 'apply' | 'show' | 'reset';
-export interface RunSkillScopeInput {
-    readonly subcommand: SkillScopeAction;
-    readonly project: string;
-    readonly strict?: boolean;
-    readonly loose?: boolean;
-    readonly ide?: string;
-    readonly shadowFallback?: boolean;
-    readonly json?: boolean;
-    /** Test seam: override the detected allowlist (CLI re-adds peaks-* per G6). */
-    readonly overrideAllowlist?: readonly string[];
-    /** Test seam: force the source-of-truth write to fail (simulates atomicity test). */
-    readonly simulateSourceOfTruthWriteFailure?: boolean;
-}
-export interface RunSkillScopeResult {
-    readonly exitCode: number;
-    readonly envelope: ResultEnvelope<unknown> | null;
-    readonly stdout: string;
-    readonly stderr: string;
-}
-/** Run the --apply subcommand. R003.3: `runApply` is exported for direct testing. */
-export declare function runApply(input: RunSkillScopeInput): Promise<RunSkillScopeResult>;
-/**
- * Programmatic entry point for `peaks skill scope`. Used by the CLI shim
- * AND by the unit tests.
- */
-export declare function runSkillScopeCommand(input: RunSkillScopeInput): Promise<RunSkillScopeResult>;
-/**
- * Register the `peaks skill scope` subcommand on the `skill` command group.
- * Mutually-exclusive flags: exactly one of --detect / --apply / --show / --reset.
- */
-export declare function registerSkillScopeCommands(program: Command, io: ProgramIO): void;