@winspan/claude-forge 8.54.4 → 9.12.0

package/dist/cli/commands/project.d.ts

@@ -0,0 +1,98 @@
+/**
+ * `cf project` command group — per-project onboarding aggregator (spec
+ * ed8cf2db §3).
+ *
+ * `cf project init` is a wrapper that runs the steps a new project usually
+ * needs in one shot:
+ *
+ *   1. Pre-flight (git-repo check)
+ *   2. Detect project type (node / python / rust / go / generic)
+ *   3. `cf claudemd init` (skippable via `--skip-claudemd`)
+ *   4. Create `.forge-knowledge/` skeleton (`.meta.json` + `overview.md`
+ *      placeholders)
+ *   4.5. Create `docs/architecture/core-beliefs.md` empty skeleton (committed
+ *      human-judgement invariant store — NOT gitignored)
+ *   5. Append `.forge-knowledge/` to `.gitignore` if absent
+ *   6. `cf knowledge init` (skippable via `--skip-knowledge`)
+ *   7. Write `<project>/.forge-installed.json` marker
+ *
+ * Idempotent: if `.forge-installed.json` already exists and `--force` is not
+ * set, the command no-ops with a hint. Each step is also independently
+ * idempotent at the underlying primitive level.
+ *
+ * Behavior change vs primitives: NONE. This is purely a wrapper that calls
+ * `runClaudeMdWriter()` (from claudemd.ts) and `initCmd()` (from
+ * knowledge.ts) directly — no `cf` subprocess spawning, no shell-out
+ * (spec §5 — perf + clean error propagation).
+ */
+import type { Command } from 'commander';
+import { type ProjectMarker, type ProjectType, type StepStatus } from '../../core/diagnostics/markers.js';
+import { type InitCmdResult } from './knowledge.js';
+export interface RunProjectInitOptions {
+    /** Project root (cwd by default). */
+    projectRoot?: string;
+    /** Re-run even if `.forge-installed.json` exists. */
+    force?: boolean;
+    /** Skip the `cf claudemd init` step. */
+    skipClaudemd?: boolean;
+    /** Skip the `cf knowledge init` step. */
+    skipKnowledge?: boolean;
+    /** Override CLAUDE.md writer (for hermetic tests). */
+    claudeMdWriter?: (opts: {
+        command: 'init';
+        projectPath: string;
+        force: boolean;
+    }) => Promise<void>;
+    /** Override knowledge init (for hermetic tests). */
+    knowledgeInit?: (opts: {
+        force?: boolean;
+        hook?: boolean;
+        skipCrossModule?: boolean;
+    }) => Promise<void | InitCmdResult>;
+    /** Override `now()` for deterministic markers. */
+    now?: () => Date;
+}
+export interface RunProjectInitResult {
+    /** Process exit code suggestion. 0=ok, 1=fatal, 2=partial. */
+    exitCode: 0 | 1 | 2;
+    /** Reason for non-zero exit (or `null` on success). */
+    errorReason: string | null;
+    /** Per-step status map (mirrors marker `steps`). */
+    steps: ProjectMarker['steps'];
+    /** Detected project type. */
+    projectType: ProjectType;
+    /** Whether this was a noop (marker already existed, no --force). */
+    noop: boolean;
+}
+/**
+ * Run the `cf project init` flow. Returns a structured result so callers
+ * (CLI action + tests) can decide on exit code + output without coupling.
+ */
+export declare function runProjectInit(opts?: RunProjectInitOptions): Promise<RunProjectInitResult>;
+/**
+ * Create `.forge-knowledge/{.meta.json,overview.md}` placeholders if
+ * absent. Each sub-step is independently idempotent.
+ */
+export declare function ensureKnowledgeSkeleton(projectRoot: string): void;
+/**
+ * Create `docs/architecture/core-beliefs.md` empty skeleton if absent.
+ * Mirrors `ensureKnowledgeSkeleton`: pure sync `fs`, idempotent (never
+ * overwrites an existing file), zero AI.
+ *
+ * IMPORTANT: this file is a committed human-judgement doc and MUST NOT be
+ * gitignored — it is the per-repo invariant store decision-maker reads. Unlike
+ * `ensureKnowledgeSkeleton` (whose `.forge-knowledge/` IS gitignored), this
+ * helper deliberately does NOT touch `.gitignore`.
+ */
+export declare function ensureBeliefsSkeleton(projectRoot: string): void;
+/**
+ * Ensure `.gitignore` contains `.forge-knowledge/`. Returns step status.
+ *
+ * - File missing → creates it with the entry → "ok"
+ * - Entry already present → no change → "ok"
+ * - Entry absent → appends with a "# Claude Forge KB cache" header → "ok"
+ * - Disk error → "failed"
+ */
+export declare function ensureGitignoreEntry(projectRoot: string): StepStatus;
+export declare function register(program: Command): void;
+//# sourceMappingURL=project.d.ts.map

package/dist/cli/commands/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAA+B,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIjF,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yCAAyC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,sDAAsD;IACtD,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnG,oDAAoD;IACpD,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QACrB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,KAAK,OAAO,CAAC,IAAI,GAAG,aAAa,CAAC,CAAC;IACpC,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,uDAAuD;IACvD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,oDAAoD;IACpD,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC9B,6BAA6B;IAC7B,WAAW,EAAE,WAAW,CAAC;IACzB,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CA8G/B;AAsED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAiBjE;AAyDD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAS/D;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAoBpE;AAID,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwC/C"}

package/dist/cli/commands/project.js

@@ -0,0 +1,382 @@
+/**
+ * `cf project` command group — per-project onboarding aggregator (spec
+ * ed8cf2db §3).
+ *
+ * `cf project init` is a wrapper that runs the steps a new project usually
+ * needs in one shot:
+ *
+ *   1. Pre-flight (git-repo check)
+ *   2. Detect project type (node / python / rust / go / generic)
+ *   3. `cf claudemd init` (skippable via `--skip-claudemd`)
+ *   4. Create `.forge-knowledge/` skeleton (`.meta.json` + `overview.md`
+ *      placeholders)
+ *   4.5. Create `docs/architecture/core-beliefs.md` empty skeleton (committed
+ *      human-judgement invariant store — NOT gitignored)
+ *   5. Append `.forge-knowledge/` to `.gitignore` if absent
+ *   6. `cf knowledge init` (skippable via `--skip-knowledge`)
+ *   7. Write `<project>/.forge-installed.json` marker
+ *
+ * Idempotent: if `.forge-installed.json` already exists and `--force` is not
+ * set, the command no-ops with a hint. Each step is also independently
+ * idempotent at the underlying primitive level.
+ *
+ * Behavior change vs primitives: NONE. This is purely a wrapper that calls
+ * `runClaudeMdWriter()` (from claudemd.ts) and `initCmd()` (from
+ * knowledge.ts) directly — no `cf` subprocess spawning, no shell-out
+ * (spec §5 — perf + clean error propagation).
+ */
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import { detectProjectType, isGitRepo, readProjectMarker, writeProjectMarker, } from '../../core/diagnostics/markers.js';
+import { runClaudeMdWriter } from './claudemd.js';
+import { initCmd as runKnowledgeInit } from './knowledge.js';
+/**
+ * Run the `cf project init` flow. Returns a structured result so callers
+ * (CLI action + tests) can decide on exit code + output without coupling.
+ */
+export async function runProjectInit(opts = {}) {
+    const projectRoot = opts.projectRoot ?? process.cwd();
+    const claudeMdWriter = opts.claudeMdWriter ?? runClaudeMdWriter;
+    const knowledgeInit = opts.knowledgeInit ?? runKnowledgeInit;
+    // ── Pre-flight: must be inside a git repo ────────────────────────────
+    if (!isGitRepo(projectRoot)) {
+        return {
+            exitCode: 1,
+            errorReason: '`cf project init` 仅适用于 git 项目；请先 `git init`',
+            steps: { claudemd: 'skipped', knowledge: 'skipped', gitignore: 'skipped' },
+            projectType: 'generic',
+            noop: false,
+        };
+    }
+    const projectType = detectProjectType(projectRoot);
+    // ── Idempotency: existing marker + no force ──────────────────────────
+    const existing = readProjectMarker(projectRoot);
+    if (existing && !opts.force) {
+        return {
+            exitCode: 0,
+            errorReason: null,
+            steps: existing.steps,
+            projectType: existing.project_type,
+            noop: true,
+        };
+    }
+    // ── Run sub-steps ────────────────────────────────────────────────────
+    const steps = {
+        claudemd: 'skipped',
+        knowledge: 'skipped',
+        gitignore: 'skipped',
+    };
+    let hadFailure = false;
+    // Step 1: CLAUDE.md
+    if (!opts.skipClaudemd) {
+        const claudeMdPath = path.join(projectRoot, 'CLAUDE.md');
+        if (fs.existsSync(claudeMdPath) && !opts.force) {
+            steps.claudemd = 'skipped';
+            console.log(chalk.gray('→'), 'CLAUDE.md 已存在，跳过（用 --force 覆盖）');
+        }
+        else {
+            steps.claudemd = await runStep(async () => {
+                await claudeMdWriter({
+                    command: 'init',
+                    projectPath: projectRoot,
+                    force: Boolean(opts.force),
+                });
+            });
+            if (steps.claudemd === 'failed')
+                hadFailure = true;
+        }
+    }
+    // Step 2: `.forge-knowledge/` skeleton (always, idempotent)
+    ensureKnowledgeSkeleton(projectRoot);
+    // Step 2.5: `docs/architecture/core-beliefs.md` empty skeleton (always,
+    // idempotent). This file is a committed human-judgement doc — it is NOT
+    // gitignored (unlike `.forge-knowledge/`), and is the per-project invariant
+    // store that decision-maker reads as a hard-constraint gate.
+    ensureBeliefsSkeleton(projectRoot);
+    // Step 3: `.gitignore` append
+    steps.gitignore = ensureGitignoreEntry(projectRoot);
+    if (steps.gitignore === 'failed')
+        hadFailure = true;
+    // Step 4: `cf knowledge init` (heavy — calls `claude` CLI)
+    //
+    // Spec 2026-06-04/1200 (decision e0eb1695): `initCmd` no longer hard-exits on
+    // an unsupported project type. A true-generic project returns
+    // `{ skipped: 'generic' }` → we mark the step `skipped` (NOT `ok`/`failed`).
+    // Monorepo roots build a single aggregate KB and return void → `ok`.
+    if (!opts.skipKnowledge) {
+        steps.knowledge = await runStepWithResult(async () => {
+            return knowledgeInit({
+                force: Boolean(opts.force),
+                hook: true,
+                skipCrossModule: false,
+            });
+        });
+        if (steps.knowledge === 'failed')
+            hadFailure = true;
+    }
+    // ── Write marker ─────────────────────────────────────────────────────
+    try {
+        writeProjectMarker(projectRoot, {
+            project_type: projectType,
+            steps,
+            initialized_at: opts.now ? opts.now().toISOString() : undefined,
+        });
+    }
+    catch (err) {
+        return {
+            exitCode: 1,
+            errorReason: `marker write failed: ${err.message}`,
+            steps,
+            projectType,
+            noop: false,
+        };
+    }
+    return {
+        exitCode: hadFailure ? 2 : 0,
+        errorReason: hadFailure ? 'One or more sub-steps failed (see step status)' : null,
+        steps,
+        projectType,
+        noop: false,
+    };
+}
+// ── helpers ─────────────────────────────────────────────────────────────
+/**
+ * Run a step, catching both thrown errors AND `process.exit(N)` calls
+ * (the underlying primitives — `runClaudeMdWriter` / `initCmd` — call
+ * `process.exit(1)` on subprocess errors). We temporarily replace
+ * `process.exit` with a thrower so we can convert to a per-step status.
+ */
+async function runStep(fn) {
+    const realExit = process.exit;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const exitErrors = [];
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    process.exit = (code) => {
+        exitErrors.push(code);
+        throw new ProcessExitSignal(code);
+    };
+    try {
+        await fn();
+        return 'ok';
+    }
+    catch (err) {
+        if (err instanceof ProcessExitSignal) {
+            return err.code === 0 ? 'ok' : 'failed';
+        }
+        return 'failed';
+    }
+    finally {
+        process.exit = realExit;
+    }
+}
+class ProcessExitSignal extends Error {
+    code;
+    constructor(code) {
+        super(`process.exit(${code}) intercepted by runStep`);
+        this.code = code;
+    }
+}
+/**
+ * Like {@link runStep}, but inspects the resolved value of `fn` so a graceful
+ * `{ skipped: 'generic' }` return (from `initCmd` on a true-generic project)
+ * maps to the `skipped` step status instead of `ok`.
+ *
+ * Spec 2026-06-04/1200 (decision e0eb1695). Keeps `runStep` untouched for the
+ * other (void-returning) callers.
+ */
+async function runStepWithResult(fn) {
+    const realExit = process.exit;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    process.exit = (code) => {
+        throw new ProcessExitSignal(code);
+    };
+    try {
+        const out = await fn();
+        if (out && typeof out === 'object' && out.skipped === 'generic') {
+            return 'skipped';
+        }
+        return 'ok';
+    }
+    catch (err) {
+        if (err instanceof ProcessExitSignal) {
+            return err.code === 0 ? 'ok' : 'failed';
+        }
+        return 'failed';
+    }
+    finally {
+        process.exit = realExit;
+    }
+}
+/**
+ * Create `.forge-knowledge/{.meta.json,overview.md}` placeholders if
+ * absent. Each sub-step is independently idempotent.
+ */
+export function ensureKnowledgeSkeleton(projectRoot) {
+    const kbDir = path.join(projectRoot, '.forge-knowledge');
+    if (!fs.existsSync(kbDir)) {
+        fs.mkdirSync(kbDir, { recursive: true });
+    }
+    const metaPath = path.join(kbDir, '.meta.json');
+    if (!fs.existsSync(metaPath)) {
+        fs.writeFileSync(metaPath, '{}\n', 'utf-8');
+    }
+    const overviewPath = path.join(kbDir, 'overview.md');
+    if (!fs.existsSync(overviewPath)) {
+        fs.writeFileSync(overviewPath, '# Overview\n\n_To be generated by `cf knowledge build --apply`_\n', 'utf-8');
+    }
+}
+/**
+ * Skeleton body for a fresh `docs/architecture/core-beliefs.md`. Mirrors the
+ * header/boundary-rules comment block of claude-forge's own core-beliefs.md but
+ * leaves the three sections empty (a single placeholder comment each) — we do
+ * NOT seed any concrete invariants. New invariants enter only via the
+ * "decision establishes invariant → decision-maker proposes → user approves"
+ * feeding mechanism.
+ */
+const CORE_BELIEFS_SKELETON = `<!--
+================================================================================
+ core-beliefs.md — 项目不变量（人类判断层，非代码可派生）
+================================================================================
+
+这是 BOUNDED 工作记忆，不是 append-only 档案。decision-maker agent 每次决策前
+会【整篇读】本文件当硬约束，因此它必须保持小且高信号。
+
+界限规则：
+  - 软上限 ≤ 1 页 / ~20-30 条。逼近上限不是「扩容」信号，而是「该合并 / 退役」
+    的强制器（多条细粒度 belief 常可塌成一条高层原则）。
+  - 非 append-only：当某新决策【违背】某旧 belief（架构演进），旧的【退役 / 被
+    取代】，不堆积。decision-maker 读本文件这一步正是发现僵尸 belief 的位置。
+  - 增长靠「决策确立不变量 → decision-maker 提议 → 用户批准才写入」喂养。
+    增长快 = 提升门槛太低（把普通「决策」误当「不变量」），该收紧门槛而非扩文件。
+  - 与 decisions / outcome 档案的区别：本文件是 bounded 工作记忆（小、高信号、
+    每次整篇读、会退役合并）；decisions/outcome 表是 unbounded 长期档案。两层别混。
+
+填写纪律：每条 = 一句话陈述 + (来源)，能追溯来源才放，不凭空发明。
+范围纪律：只放意图层红线。流程治理规则归治理文档；实现细节归代码/约定，不进本文件。
+================================================================================
+-->
+
+# Core Beliefs（项目不变量）
+
+> 状态：**空骨架（由 \`cf project init\` scaffold）**。
+> 后续仅通过「决策确立不变量 → decision-maker 提议 → 用户批准」增减。
+
+---
+
+## 不变量（Invariants）—— 「永远 / 永不」级铁律
+
+<!-- 待填：决策确立「永远/永不」级红线时，由 decision-maker 提议、用户批准后写入。 -->
+
+---
+
+## 架构红线（Architecture Boundaries）—— 模块 / 分层不可越界
+
+<!-- 待填：决策确立模块/分层不可越界的边界时，由 decision-maker 提议、用户批准后写入。 -->
+
+---
+
+## 不可逆约定（One-way Doors）—— 一旦定下回滚代价极高
+
+<!-- 待填：决策确立一旦定下回滚代价极高的约定时，由 decision-maker 提议、用户批准后写入。 -->
+`;
+/**
+ * Create `docs/architecture/core-beliefs.md` empty skeleton if absent.
+ * Mirrors `ensureKnowledgeSkeleton`: pure sync `fs`, idempotent (never
+ * overwrites an existing file), zero AI.
+ *
+ * IMPORTANT: this file is a committed human-judgement doc and MUST NOT be
+ * gitignored — it is the per-repo invariant store decision-maker reads. Unlike
+ * `ensureKnowledgeSkeleton` (whose `.forge-knowledge/` IS gitignored), this
+ * helper deliberately does NOT touch `.gitignore`.
+ */
+export function ensureBeliefsSkeleton(projectRoot) {
+    const archDir = path.join(projectRoot, 'docs', 'architecture');
+    if (!fs.existsSync(archDir)) {
+        fs.mkdirSync(archDir, { recursive: true });
+    }
+    const beliefsPath = path.join(archDir, 'core-beliefs.md');
+    if (!fs.existsSync(beliefsPath)) {
+        fs.writeFileSync(beliefsPath, CORE_BELIEFS_SKELETON, 'utf-8');
+    }
+}
+/**
+ * Ensure `.gitignore` contains `.forge-knowledge/`. Returns step status.
+ *
+ * - File missing → creates it with the entry → "ok"
+ * - Entry already present → no change → "ok"
+ * - Entry absent → appends with a "# Claude Forge KB cache" header → "ok"
+ * - Disk error → "failed"
+ */
+export function ensureGitignoreEntry(projectRoot) {
+    const gitignorePath = path.join(projectRoot, '.gitignore');
+    try {
+        let content = '';
+        if (fs.existsSync(gitignorePath)) {
+            content = fs.readFileSync(gitignorePath, 'utf-8');
+        }
+        // Match lines like `.forge-knowledge/` or `.forge-knowledge` (no trailing slash)
+        const lines = content.split('\n').map((l) => l.trim());
+        if (lines.some((l) => l === '.forge-knowledge/' || l === '.forge-knowledge')) {
+            return 'ok';
+        }
+        const appendBlock = (content.length > 0 && !content.endsWith('\n') ? '\n' : '') +
+            '\n# Claude Forge KB cache\n.forge-knowledge/\n';
+        fs.writeFileSync(gitignorePath, content + appendBlock, 'utf-8');
+        return 'ok';
+    }
+    catch {
+        return 'failed';
+    }
+}
+// ── CLI registration ────────────────────────────────────────────────────
+export function register(program) {
+    const project = program
+        .command('project')
+        .description('Per-project Claude Forge commands');
+    project
+        .command('init')
+        .description('Onboard the current project (CLAUDE.md + KB + .gitignore + marker)')
+        .option('--force', 'Re-run even if already initialized')
+        .option('--skip-claudemd', 'Skip CLAUDE.md generation')
+        .option('--skip-knowledge', 'Skip knowledge-base init')
+        .action(async (opts) => {
+        const result = await runProjectInit({
+            force: Boolean(opts.force),
+            skipClaudemd: Boolean(opts.skipClaudemd),
+            skipKnowledge: Boolean(opts.skipKnowledge),
+        });
+        if (result.noop) {
+            console.log(chalk.gray('→'), '项目已 init，用 --force 重跑');
+            return;
+        }
+        console.log('');
+        console.log(chalk.bold('cf project init summary:'));
+        console.log(`  project type: ${result.projectType}`);
+        console.log(`  CLAUDE.md:     ${formatStep(result.steps.claudemd)}`);
+        console.log(`  .gitignore:    ${formatStep(result.steps.gitignore)}`);
+        console.log(`  knowledge:     ${formatStep(result.steps.knowledge)}`);
+        if (result.exitCode === 1) {
+            console.error(chalk.red('✗'), result.errorReason);
+            process.exit(1);
+        }
+        else if (result.exitCode === 2) {
+            console.error(chalk.yellow('!'), result.errorReason);
+            process.exit(2);
+        }
+        else {
+            console.log(chalk.green('\n✓ project ready'));
+        }
+    });
+}
+function formatStep(s) {
+    switch (s) {
+        case 'ok':
+            return chalk.green('ok');
+        case 'skipped':
+            return chalk.gray('skipped');
+        case 'failed':
+            return chalk.red('failed');
+    }
+}
+//# sourceMappingURL=project.js.map

package/dist/cli/commands/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/cli/commands/project.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/skills.d.ts

@@ -1,3 +1,134 @@
 import type { Command } from 'commander';
+import { SkillRegistry } from '../../skills/registry.js';
+import { SQLiteStorage } from '../../core/storage/sqlite.js';
+interface InvokeOptions {
+    reason?: string;
+    json?: boolean;
+    /** Explicit session id (else $CLAUDE_SESSION_ID env → DB lookup → sentinel). */
+    sessionId?: string;
+    /** Project path for the level-3 session DB lookup (defaults to cwd). */
+    project?: string;
+    /**
+     * Optional agent name (decision 234f1ad4 Q6): when an agent pulls a skill it
+     * can pass `--agent coder` so the row's `agent_id` is written (previously
+     * always NULL on the CLI path). Future-proofing for first-class (agent,skill)
+     * pairing — does NOT break existing callers that omit it.
+     */
+    agent?: string;
+}
+/** Injectable deps for invokeSkill — lets tests pass a temp DB + capture io. */
+interface InvokeDeps {
+    storage?: SQLiteStorage;
+    io?: {
+        log: (m: string) => void;
+        error: (m: string) => void;
+    };
+}
+/**
+ * Invoke a skill by id, printing its full methodology content.
+ * Exit code 1 on failure so Bash callers can detect errors.
+ *
+ * Telemetry (decision 4e118b92): every successful CLI invoke now persists a
+ * skill_invocations row via the SHARED skillInvoke() write path, marked
+ * invocation_type='cli' so it is distinguishable from MCP (`dynamic`) and
+ * legacy keyword-match (`static`) rows. The `--reason` is recorded verbatim so
+ * follow-through SQL like `reason LIKE 'coder/%'` / `'verify/%'` works, and
+ * parseWorkflowMeta (inside skillInvoke) populates workflow/phase/feature_slug.
+ *
+ * This is the working path for subagents, which have NO MCP access — the MCP
+ * `skill_invoke` tool is uncallable from coder/verify-agent, so guidance now
+ * points them at `cf skill invoke` (Bash).
+ */
+export declare function invokeSkill(skillId: string, options: InvokeOptions, deps?: InvokeDeps): Promise<void>;
+interface FeedbackOptions {
+    skill?: string;
+    rating?: string;
+    note?: string;
+    sessionId?: string;
+    project?: string;
+}
+interface UsefulnessOptions {
+    json?: boolean;
+}
+/** Injectable deps for the feedback / usefulness commands (test seam). */
+interface FeedbackDeps {
+    storage?: SQLiteStorage;
+    io?: {
+        log: (m: string) => void;
+        error: (m: string) => void;
+    };
+}
+/**
+ * `cf skill feedback --skill <id> --rating <helped|partial|not-actionable>`:
+ * stamp a POST-USE usefulness self-assessment onto the most-recent un-rated
+ * skill_invocations row for that skill in the current session.
+ *
+ * Telemetry discipline: this is advisory — it must NEVER throw into the agent's
+ * main flow. Invalid rating → exit 1 (the one hard validation, so a typo is
+ * caught). DB-open failure / 0-row-found → soft path, exit 0.
+ */
+export declare function feedbackSkill(options: FeedbackOptions, deps?: FeedbackDeps): Promise<void>;
+/**
+ * `cf skill usefulness [--json]`: per-skill usefulness aggregation, sorted
+ * worst-actionable-rate first (least-useful skills on top = P1 refinement
+ * candidates). actionable_rate = helped / total_rated (STRICT helped-only).
+ * Un-rated pulls are reported as `pending`, excluded from the rate denominator.
+ */
+export declare function usefulnessSkills(options: UsefulnessOptions, deps?: FeedbackDeps): Promise<void>;
+interface SearchOptions {
+    top?: string;
+    json?: boolean;
+}
+interface SkillSearchMatch {
+    id: string;
+    name: string;
+    description: string;
+    keywords: string[];
+    score: number;
+}
+interface SkillSearchResult {
+    query: string;
+    matches: SkillSearchMatch[];
+    /** True when the best match is below SEARCH_MIN_SCORE → agent should skip pull. */
+    no_strong_match: boolean;
+}
+/** Minimal shape `scoreSkills` needs — lets unit tests pass plain objects. */
+interface ScorableSkill {
+    id: string;
+    name: string;
+    description?: string;
+    keywords: string[];
+}
+/**
+ * Score one skill against the query tokens by token overlap.
+ *
+ * - Each query token that appears among the skill's keyword tokens scores 2
+ *   (keywords are the curated relevance signal → weighted highest).
+ * - Each query token that appears in the skill's name/description tokens scores 1.
+ * - A query token counts at most once (keyword hit dominates a name/desc hit).
+ *
+ * Pure + deterministic — no LLM, no embedding. Exported-shape via searchSkills.
+ */
+export declare function scoreSkillMatch(skill: ScorableSkill, queryTokens: string[]): number;
+/**
+ * Rank skills by relevance to a task description. Pure function over a skill
+ * list so it is unit-testable without a registry/filesystem.
+ */
+export declare function rankSkills(skills: ScorableSkill[], taskDesc: string, top: number): SkillSearchResult;
+/** Injectable deps for searchSkills — lets tests pass a stub registry + io. */
+interface SearchDeps {
+    registry?: SkillRegistry;
+    io?: {
+        log: (m: string) => void;
+        error: (m: string) => void;
+    };
+}
+/**
+ * `cf skill search <task-desc> [--top N] [--json]`: dynamic skill discovery.
+ * Source of truth is the live SkillRegistry (same data `cf skill list` uses) —
+ * no new data source. Supports machine (--json, for agents) + human output.
+ */
+export declare function searchSkills(taskDesc: string, options: SearchOptions, deps?: SearchDeps): Promise<void>;
 export declare function register(program: Command): void;
+export {};
 //# sourceMappingURL=skills.d.ts.map

package/dist/cli/commands/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/skills.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8QzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa/C"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/skills.ts"],"names":[],"mappings":"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"}