@skillit/client 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,32 @@
+# @skillit/client
+
+## 0.2.0
+
+### Minor Changes
+
+- [#41](https://github.com/pradeepmouli/skillit/pull/41) [`989f899`](https://github.com/pradeepmouli/skillit/commit/989f899fd506f422d67c808bce8b5302f11986c6) Thanks [@pradeepmouli](https://github.com/pradeepmouli)! - - fix(client): guard msg.content[0] access — throw on empty or non-text response
+  - fix(typedoc/refine): fix JSDoc closer indentation + use async fs I/O in TypeDocRefineSource
+  - feat(client): add skillit bin with refine command
+  - feat(client): add AnthropicModelClient (Sonnet drafter, Opus reviewer)
+  - feat(client): scaffold @skillit/client package
+
+- [#53](https://github.com/pradeepmouli/skillit/pull/53) [`95caa9e`](https://github.com/pradeepmouli/skillit/commit/95caa9e1d0ed3e6562470940b857a83bc8e4a37a) Thanks [@pradeepmouli](https://github.com/pradeepmouli)! - `refine` and `init` gain `--model-client api|claude|codex|copilot`: drive the
+  audit→draft→review loop through an already-authenticated agent CLI instead of
+  the Anthropic API. Per-CLI adapters (claude maps the drafter/reviewer split to
+  Sonnet/Opus; codex/copilot use their default model) reuse the existing prompt
+  builders and verdict parser; `--model-cli-timeout` bounds each call. Default
+  remains `api`.
+
+- [#52](https://github.com/pradeepmouli/skillit/pull/52) [`30e9f03`](https://github.com/pradeepmouli/skillit/commit/30e9f03756bb3596e0cf90bb91beb37dd6bb9c18) Thanks [@pradeepmouli](https://github.com/pradeepmouli)! - Multi-source `refine` (CLI), `skillit init`, ast-grep-based JSDoc editing, and guidance injection.
+  - **core**: new `refine/ast-edit.ts` wrapping `@ast-grep/napi` — `upsertJsDocTag`/`readJsDocTags` replace the regex/offset JSDoc surgery; `insertJsDocTag` reimplemented on top of it. `RefineSource.guidance?()` and `guidance` on draft/review requests; `refineSkill` threads the source's bundled guidance skill into every draft/review. `audit-score` surfaces CLI command annotation gaps as work items.
+  - **cli**: `CliRefineSource` (extract → bundled `skillit-cli-docs` guidance → JSDoc write-back onto the correlated `*Options` interface); commander program loader (`--program file#export` + `bin` auto-find); `*Options` interface JSDoc reader for loop closure.
+  - **client**: `refine` is source-aware — `--source cli|mcp|typedoc` with detection from installed `@skillit/*` packages, plus `--program`; `--mcp` no longer globally required. New `skillit init` command: detect project nature → install the matching package → generate the initial skill into top-level `skills/` → refine (CLI path automated; mcp/typedoc print next-step guidance).
+
+### Patch Changes
+
+- [#54](https://github.com/pradeepmouli/skillit/pull/54) [`314f9b0`](https://github.com/pradeepmouli/skillit/commit/314f9b0218304e40d6fa6da628fcb112d2940912) Thanks [@pradeepmouli](https://github.com/pradeepmouli)! - Rebrand `@to-skills` → `@skillit`: package scope, a single `skillit` CLI (MCP commands now mounted as `skillit mcp …`), bundled skill names (`skillit-cli-docs`/`skillit-docs`/`skillit-mcp-docs`), and the `package.json` config key (`skillit.mcp`). No API or behavior changes.
+
+- Updated dependencies [[`989f899`](https://github.com/pradeepmouli/skillit/commit/989f899fd506f422d67c808bce8b5302f11986c6), [`9699e6f`](https://github.com/pradeepmouli/skillit/commit/9699e6f9896f4153ecdad6b1bbc87ead20e773ef), [`30e9f03`](https://github.com/pradeepmouli/skillit/commit/30e9f03756bb3596e0cf90bb91beb37dd6bb9c18), [`314f9b0`](https://github.com/pradeepmouli/skillit/commit/314f9b0218304e40d6fa6da628fcb112d2940912)]:
+  - @skillit/cli@0.4.0
+  - @skillit/core@1.5.0
+  - @skillit/mcp@0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Pradeep Mouli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// packages/client/src/bin.ts
+import { Command } from 'commander';
+import { buildMcpCommand, reportMcpErrorAndExit } from '@skillit/mcp';
+import { buildInitCommand } from './commands/init.js';
+import { buildRefineCommand } from './commands/refine.js';
+const program = new Command('skillit').description('skillit CLI').version('0.1.0');
+program.addCommand(buildRefineCommand());
+program.addCommand(buildInitCommand());
+program.addCommand(buildMcpCommand());
+program.parseAsync(process.argv).catch((err) => {
+    // Preserve the mcp exit-code contract for the `skillit mcp …` path; other
+    // errors keep the prior generic behavior (stderr message + exit 1).
+    reportMcpErrorAndExit(err);
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,6BAA6B;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEnF,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC,CAAC;AAEtC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtD,0EAA0E;IAC1E,oEAAoE;IACpE,qBAAqB,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,33 @@
+import { Command } from 'commander';
+import { type RefineSourceKind } from '../detect-source.js';
+import { type RefineCommandOpts } from './refine.js';
+type PackageManager = 'pnpm' | 'yarn' | 'npm';
+/** Options passed to the (CLI-path) skill generator. */
+export interface GenerateSkillOpts {
+    /** Project root being initialized. */
+    cwd: string;
+    /** Resolved project nature. */
+    nature: RefineSourceKind;
+    /** Skill name (consumer package name, scope stripped). */
+    name: string;
+    /** Absolute output directory (`<cwd>/<out>`). */
+    outDir: string;
+    /** `--program <file#export>` entry, if provided. */
+    program?: string;
+}
+/**
+ * Injectable side-effecting steps for {@link buildInitCommand}. All optional;
+ * real defaults run install / generate / refine. Tests inject stubs so no real
+ * install, network, or model call runs.
+ */
+export interface InitDeps {
+    /** Install `pkg` as a dev dependency in `cwd` using package manager `pm`. */
+    runInstall?(pkg: string, pm: PackageManager, cwd: string): Promise<void>;
+    /** Generate the initial skill (CLI path only). */
+    generateSkill?(opts: GenerateSkillOpts): Promise<void>;
+    /** Dispatch the refine loop for the resolved source. */
+    runRefine?(opts: RefineCommandOpts): Promise<void>;
+}
+export declare function buildInitCommand(deps?: InitDeps): Command;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEvE,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9C,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,6EAA6E;IAC7E,UAAU,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,kDAAkD;IAClD,aAAa,CAAC,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,wDAAwD;IACxD,SAAS,CAAC,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAuED,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,QAAa,GAAG,OAAO,CA8F7D"}

package/dist/commands/init.js

@@ -0,0 +1,152 @@
+// packages/client/src/commands/init.ts
+import { spawn } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { Command } from 'commander';
+import { extractCliSkill, loadProgram, writeCliSkill } from '@skillit/cli';
+import { detectPackageManager, detectProjectNature } from '../detect-source.js';
+import { runRefineCommand } from './refine.js';
+const VALID_SOURCES = ['cli', 'mcp', 'typedoc'];
+/** Map a project nature to the `@skillit/*` package that handles it. */
+function natureToPackage(nature) {
+    if (nature === 'cli')
+        return '@skillit/cli';
+    if (nature === 'mcp')
+        return '@skillit/mcp';
+    return 'typedoc-plugin-skillit';
+}
+/** Build the package manager's add-dev command line (for messaging + spawn). */
+function addDevCommand(pm, pkg) {
+    if (pm === 'pnpm')
+        return `pnpm add -D ${pkg}`;
+    if (pm === 'yarn')
+        return `yarn add -D ${pkg}`;
+    return `npm install -D ${pkg}`;
+}
+/** Strip a leading `@scope/` from a package name for use as a skill dir name. */
+function skillNameFrom(packageName) {
+    const slash = packageName.indexOf('/');
+    if (packageName.startsWith('@') && slash !== -1) {
+        return packageName.slice(slash + 1);
+    }
+    return packageName;
+}
+async function readPackageName(cwd) {
+    try {
+        const raw = await readFile(join(cwd, 'package.json'), 'utf8');
+        const pkg = JSON.parse(raw);
+        return pkg.name ?? 'skill';
+    }
+    catch {
+        return 'skill';
+    }
+}
+/** Default install: spawn the package manager's add-dev command, cwd-scoped. */
+function defaultRunInstall(pkg, pm, cwd) {
+    const command = addDevCommand(pm, pkg);
+    const [bin, ...args] = command.split(' ');
+    return new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { cwd, stdio: 'inherit' });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`exited with code ${code}`));
+        });
+    });
+}
+/** Default CLI-path skill generation: loadProgram → extractCliSkill → writeCliSkill. */
+async function defaultGenerateSkill(opts) {
+    const program = await loadProgram({ program: opts.program, cwd: opts.cwd });
+    const skill = await extractCliSkill({ program, metadata: { name: opts.name } });
+    writeCliSkill(skill, { outDir: opts.outDir });
+}
+/** Default refine dispatch: reuse the shared refine command body. */
+function defaultRunRefine(opts) {
+    return runRefineCommand(opts);
+}
+export function buildInitCommand(deps = {}) {
+    const runInstall = deps.runInstall ?? defaultRunInstall;
+    const generateSkill = deps.generateSkill ?? defaultGenerateSkill;
+    const runRefine = deps.runRefine ?? defaultRunRefine;
+    return new Command('init')
+        .description('Detect the project, install the right @skillit package, generate + refine a skill')
+        .option('--source <kind>', 'cli | mcp | typedoc (auto-detected if omitted)')
+        .option('--program <file#export>', 'commander program entry (cli source)')
+        .option('--out <dir>', 'output directory for the generated skill', 'skills')
+        .option('--model-client <kind>', 'model backend for refine: api | claude | codex | copilot', 'api')
+        .option('--model-cli-timeout <ms>', 'per-call timeout for cli model backends (ms)')
+        .action(async (opts) => {
+        const cwd = process.cwd();
+        // 1. Resolve nature: explicit --source wins, else detect.
+        let nature;
+        if (opts.source !== undefined) {
+            if (!VALID_SOURCES.includes(opts.source)) {
+                throw new Error(`Invalid --source value: ${opts.source}. Use --source <cli|mcp|typedoc>.`);
+            }
+            nature = opts.source;
+        }
+        else {
+            nature = await detectProjectNature(cwd);
+        }
+        // 2 + 3. Map nature → package, install via the detected package manager.
+        const pkg = natureToPackage(nature);
+        const pm = detectPackageManager(cwd);
+        const command = addDevCommand(pm, pkg);
+        try {
+            await runInstall(pkg, pm, cwd);
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            // Surface the exact command and STOP — do not generate or refine.
+            throw new Error(`Install failed (${reason}). Run it manually:\n  ${command}`);
+        }
+        // 4 + 5. Generate + refine — CLI-first: only the cli source is fully
+        // automated this pass. For mcp/typedoc, skip both and print actionable
+        // next-step guidance rather than silently no-opping (refine needs
+        // source-specific flags like --mcp that init can't supply yet).
+        if (nature === 'cli') {
+            const outDir = join(cwd, opts.out);
+            const name = skillNameFrom(await readPackageName(cwd));
+            const generateOpts = {
+                cwd,
+                nature,
+                name,
+                outDir,
+                ...(opts.program !== undefined ? { program: opts.program } : {})
+            };
+            try {
+                await generateSkill(generateOpts);
+            }
+            catch (error) {
+                // The cli source only auto-loads a commander program. A yargs/other
+                // CLI (still classified as 'cli') can't be generated yet — degrade
+                // gracefully: surface the reason and how to proceed, do NOT crash,
+                // and do NOT run refine/regenerate on a failed generate.
+                const reason = error instanceof Error ? error.message : String(error);
+                console.log(`Installed ${pkg}, but couldn't auto-load a commander program (${reason}). ` +
+                    `If this is a commander CLI, run: skillit refine --source cli --program <file#export>. ` +
+                    `(yargs/other CLIs aren't auto-generated yet.)`);
+                return;
+            }
+            await runRefine({
+                source: nature,
+                ...(opts.program !== undefined ? { program: opts.program } : {}),
+                ...(opts.modelClient !== undefined ? { modelClient: opts.modelClient } : {}),
+                ...(opts.modelCliTimeout !== undefined ? { modelCliTimeout: opts.modelCliTimeout } : {}),
+                maxIterations: '5',
+                items: '5'
+            });
+            // refine only writes JSDoc back into source files; regenerate so the
+            // on-disk skill reflects the freshly-written annotations. Runs only
+            // after a successful refine (a refine throw propagates above).
+            await generateSkill(generateOpts);
+        }
+        else {
+            const extra = nature === 'mcp' ? ' [--mcp <path>]' : '';
+            console.log(`Installed ${pkg}. Skill generation + refine for the ${nature} source isn't automated yet — run: skillit refine --source ${nature}${extra}`);
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/refine.d.ts

@@ -0,0 +1,49 @@
+import { Command } from 'commander';
+import { type DetectedRefineSource, type RefineSourceKind } from '../detect-source.js';
+/** Options consulted by {@link resolveRefineSource}. */
+export interface RefineSourceResolveOpts {
+    source?: string;
+    mcp?: string;
+}
+/** Result of resolving the refine source: a concrete kind or an actionable error. */
+export type RefineSourceResolution = {
+    kind: 'cli' | 'mcp';
+} | {
+    error: string;
+};
+/**
+ * Resolve the refine source from explicit `--source` (wins) or detection,
+ * then validate per-source flag requirements. Pure and unit-testable: it does
+ * not read the filesystem or invoke the model.
+ *
+ * @param opts - parsed `--source` / `--mcp` flags
+ * @param detected - result of {@link detectRefineSource} for the cwd
+ * @param candidates - the raw installed source kinds (from
+ *   {@link detectInstalledSources}); named in the ambiguous error
+ */
+export declare function resolveRefineSource(opts: RefineSourceResolveOpts, detected: DetectedRefineSource, candidates?: readonly RefineSourceKind[]): RefineSourceResolution;
+/** Parsed options for the `refine` action / {@link runRefineCommand}. */
+export interface RefineCommandOpts {
+    source?: string;
+    program?: string;
+    mcp?: string;
+    server?: string;
+    overlay?: string;
+    mode?: string;
+    sourceGlob?: string;
+    maxIterations: string;
+    items: string;
+    modelClient?: string;
+    modelCliTimeout?: string;
+}
+/** The model backend to use; defaults to the API client. */
+export declare function resolveModelClientKind(raw: string | undefined): string;
+/**
+ * The body of the `refine` command action, extracted so it can be reused
+ * programmatically (e.g. by `skillit init`) without argv gymnastics. Sets
+ * `process.exitCode` and writes progress/errors to the console exactly as the
+ * CLI does.
+ */
+export declare function runRefineCommand(opts: RefineCommandOpts): Promise<void>;
+export declare function buildRefineCommand(): Command;
+//# sourceMappingURL=refine.d.ts.map

package/dist/commands/refine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine.d.ts","sourceRoot":"","sources":["../../src/commands/refine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAW7B,wDAAwD;AACxD,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qFAAqF;AACrF,MAAM,MAAM,sBAAsB,GAAG;IAAE,IAAI,EAAE,KAAK,GAAG,KAAK,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAKjF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,EAAE,oBAAoB,EAC9B,UAAU,GAAE,SAAS,gBAAgB,EAAO,GAC3C,sBAAsB,CA4BxB;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEtE;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoG7E;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAe5C"}

package/dist/commands/refine.js

@@ -0,0 +1,201 @@
+// packages/client/src/commands/refine.ts
+import { Command } from 'commander';
+import { McpRefineSource, TypeScriptMcpRefineSource, extractMcpSkill, readMcpConfigFile } from '@skillit/mcp';
+import { CliRefineSource, loadProgram } from '@skillit/cli';
+import { refineSkill } from '@skillit/core';
+import { createModelClient } from '../model/model-client-factory.js';
+import { detectRefineMode } from '../detect-mode.js';
+import { classifyRefineSources, detectInstalledSources } from '../detect-source.js';
+import { join } from 'node:path';
+function parsePositiveInt(raw, flag) {
+    const n = parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 1) {
+        throw new Error(`${flag} must be a positive integer, got: ${raw}`);
+    }
+    return n;
+}
+const VALID_SOURCES = ['cli', 'mcp', 'typedoc'];
+const SOURCE_FORM = '--source <cli|mcp|typedoc>';
+/**
+ * Resolve the refine source from explicit `--source` (wins) or detection,
+ * then validate per-source flag requirements. Pure and unit-testable: it does
+ * not read the filesystem or invoke the model.
+ *
+ * @param opts - parsed `--source` / `--mcp` flags
+ * @param detected - result of {@link detectRefineSource} for the cwd
+ * @param candidates - the raw installed source kinds (from
+ *   {@link detectInstalledSources}); named in the ambiguous error
+ */
+export function resolveRefineSource(opts, detected, candidates = []) {
+    let kind;
+    if (opts.source !== undefined) {
+        if (!VALID_SOURCES.includes(opts.source)) {
+            return { error: `Invalid --source value: ${opts.source}. Use ${SOURCE_FORM}.` };
+        }
+        kind = opts.source;
+    }
+    else if (detected === 'ambiguous') {
+        return {
+            error: `Cannot determine refine source: multiple @skillit sources installed (found: ${candidates.join(', ')}).
+Pass ${SOURCE_FORM} to choose one.`
+        };
+    }
+    else if (detected === 'none') {
+        return {
+            error: `Cannot determine refine source: no @skillit source package detected.
+Pass ${SOURCE_FORM} to choose one.`
+        };
+    }
+    else {
+        kind = detected;
+    }
+    if (kind === 'typedoc') {
+        return { error: 'typedoc refine not yet supported; use --source cli|mcp.' };
+    }
+    if (kind === 'mcp' && opts.mcp === undefined) {
+        return { error: 'The mcp source requires --mcp <path> (path to mcp.json or MCP config file).' };
+    }
+    return { kind };
+}
+/** The model backend to use; defaults to the API client. */
+export function resolveModelClientKind(raw) {
+    return raw ?? 'api';
+}
+/**
+ * The body of the `refine` command action, extracted so it can be reused
+ * programmatically (e.g. by `skillit init`) without argv gymnastics. Sets
+ * `process.exitCode` and writes progress/errors to the console exactly as the
+ * CLI does.
+ */
+export async function runRefineCommand(opts) {
+    const cwd = process.cwd();
+    const maxIterations = parsePositiveInt(opts.maxIterations, '--max-iterations');
+    const itemsPerIteration = parsePositiveInt(opts.items, '--items');
+    const timeoutMs = opts.modelCliTimeout !== undefined
+        ? parsePositiveInt(opts.modelCliTimeout, '--model-cli-timeout')
+        : undefined;
+    let model;
+    try {
+        model = createModelClient(resolveModelClientKind(opts.modelClient), timeoutMs !== undefined ? { timeoutMs } : {});
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+        return;
+    }
+    const candidates = await detectInstalledSources(cwd);
+    const detected = classifyRefineSources(candidates);
+    const resolution = resolveRefineSource(opts, detected, candidates);
+    if ('error' in resolution) {
+        console.error(resolution.error);
+        process.exitCode = 1;
+        return;
+    }
+    let source;
+    let reportInPlace = false;
+    if (resolution.kind === 'cli') {
+        const program = await loadProgram({ program: opts.program, cwd });
+        const sourceGlob = opts.sourceGlob ?? join(cwd, '**', '*.ts');
+        source = new CliRefineSource({ program, sourceGlob, cwd });
+        reportInPlace = true;
+    }
+    else {
+        // mcp source: --mcp guaranteed present by resolveRefineSource.
+        const mcpPath = opts.mcp;
+        const overlayPath = opts.overlay ?? join(cwd, '.skillit-overlay.json');
+        let mode;
+        if (opts.mode === 'build' || opts.mode === 'runtime') {
+            mode = opts.mode;
+        }
+        else if (opts.mode !== undefined) {
+            console.error(`Invalid --mode value: ${opts.mode}. Use 'build' or 'runtime'.`);
+            process.exitCode = 1;
+            return;
+        }
+        else {
+            const detectedMode = await detectRefineMode(cwd, mcpPath);
+            if (detectedMode === 'ambiguous') {
+                console.error(`Cannot determine refine mode.
+Use --mode build  (TypeScript MCP server you own)
+     --mode runtime  (consuming project, any MCP server)`);
+                process.exitCode = 1;
+                return;
+            }
+            mode = detectedMode;
+        }
+        if (mode === 'build') {
+            console.log('Refining in build mode (TypeScript MCP)');
+        }
+        else {
+            console.log('Refining in runtime mode (overlay)');
+        }
+        const entries = await readMcpConfigFile(mcpPath);
+        const entry = opts.server
+            ? entries.find((e) => e.name === opts.server)
+            : entries.find((e) => !e.disabled);
+        if (!entry) {
+            const name = opts.server ? `"${opts.server}"` : 'any enabled server';
+            throw new Error(`Could not find ${name} in ${mcpPath}`);
+        }
+        if (mode === 'build') {
+            const sourceGlob = opts.sourceGlob ?? join(cwd, '**', '*.ts');
+            source = new TypeScriptMcpRefineSource({
+                transport: entry.transport,
+                sourceGlob
+            });
+            reportInPlace = true;
+        }
+        else {
+            source = new McpRefineSource({
+                overlayPath,
+                extract: () => extractMcpSkill({ transport: entry.transport })
+            });
+        }
+        const result = await runRefine(source, model, maxIterations, itemsPerIteration);
+        reportResult(result, { reportInPlace, overlayPath });
+        process.exitCode = result.passed ? 0 : 1;
+        return;
+    }
+    const result = await runRefine(source, model, maxIterations, itemsPerIteration);
+    reportResult(result, { reportInPlace });
+    process.exitCode = result.passed ? 0 : 1;
+}
+export function buildRefineCommand() {
+    return new Command('refine')
+        .description('Autonomously improve a skill via the audit→draft→review loop')
+        .option('--source <kind>', 'cli | mcp | typedoc (auto-detected if omitted)')
+        .option('--program <file#export>', 'commander program entry (cli source)')
+        .option('--mcp <path>', 'path to mcp.json or MCP config file')
+        .option('--server <name>', 'server name within the config (defaults to first enabled)')
+        .option('--overlay <path>', 'path to overlay JSON file (runtime mode only)')
+        .option('--mode <mode>', 'refine mode: build or runtime (auto-detected if omitted)')
+        .option('--source-glob <glob>', 'glob pattern for TypeScript source files')
+        .option('--max-iterations <n>', 'iteration cap (default 5)', '5')
+        .option('--items <n>', 'work items per iteration (default 5)', '5')
+        .option('--model-client <kind>', 'model backend: api | claude | codex | copilot', 'api')
+        .option('--model-cli-timeout <ms>', 'per-call timeout for cli model backends (ms)')
+        .action((opts) => runRefineCommand(opts));
+}
+function runRefine(source, model, maxIterations, itemsPerIteration) {
+    return refineSkill({
+        source,
+        model,
+        maxIterations,
+        itemsPerIteration,
+        onIteration: (iter) => {
+            const { grade, total } = iter.estimate;
+            console.log(`  Iteration ${iter.iteration}: grade ${grade} (${total}/120), ${iter.fixes.length} fix(es) applied`);
+        }
+    });
+}
+function reportResult(result, opts) {
+    console.log(`\nDone. Reason: ${result.stoppedReason}`);
+    console.log(`Final grade: ${result.finalEstimate.grade} (${result.finalEstimate.total}/120)`);
+    if (opts.reportInPlace) {
+        console.log(`Source files updated in place.`);
+    }
+    else if (opts.overlayPath && result.iterations.length > 0) {
+        console.log(`Overlay: ${opts.overlayPath}`);
+    }
+}
+//# sourceMappingURL=refine.js.map

package/dist/commands/refine.js.map

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

package/dist/detect-mode.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Detect refine mode from project context.
+ *
+ * @param cwd - directory to inspect for build/runtime signals
+ * @param mcpConfigPath - optional path to the --mcp config file; if its
+ *   basename is a known runtime config filename, or its contents contain a
+ *   top-level `mcpServers` key, it is treated as an additional runtime signal.
+ */
+export declare function detectRefineMode(cwd: string, mcpConfigPath?: string): Promise<'build' | 'runtime' | 'ambiguous'>;
+//# sourceMappingURL=detect-mode.d.ts.map

package/dist/detect-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-mode.d.ts","sourceRoot":"","sources":["../src/detect-mode.ts"],"names":[],"mappings":"AAwEA;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC,CAU5C"}