@skillit/client 0.2.0 → 0.3.1

package/README.md

@@ -0,0 +1,40 @@
+# @skillit/client
+
+> The `skillit` command-line interface: generate, audit, and refine AI-agent
+> skills from a TypeScript codebase, plus the Anthropic model client that powers
+> the headless refine loop.
+
+`@skillit/client` ships the `skillit` binary. It ties together the skillit
+source extractors (`@skillit/cli`, `@skillit/mcp`, `@skillit/core`) behind one
+CLI, and provides the Anthropic-backed `ModelClient` used by `skillit refine`
+when run without an agent.
+
+## Commands
+
+| Command          | What it does                                                                                         |
+| ---------------- | ---------------------------------------------------------------------------------------------------- |
+| `skillit gen`    | Deterministically (re)generate the skill from current source — no model, no install.                 |
+| `skillit audit`  | Audit + judge the generated skill; `--json` emits the full report with per-finding source locations. |
+| `skillit init`   | Detect the project and install the matching `@skillit/*` package (install/wire only).                |
+| `skillit refine` | Headless audit → draft → review loop that writes routing annotations back into source.               |
+| `skillit mcp`    | Extract / bundle skills from a live MCP server.                                                      |
+
+## Quick start
+
+```bash
+# Install
+npm install --save-dev @skillit/client
+
+# Generate a skill from a Commander CLI
+skillit gen --source cli --program ./dist/cli.js#program
+
+# Check its grade and findings as JSON
+skillit audit --source cli --program ./dist/cli.js#program --json
+```
+
+For the agent-driven workflow (recommended), use the bundled
+`/skillit-bootstrap` skill — see the repository README.
+
+## License
+
+MIT

package/dist/bin.d.ts

@@ -1,3 +1,4 @@
 #!/usr/bin/env node
-export {};
+import { buildProgram } from './program.js';
+export { buildProgram };
 //# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAM5C,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/bin.js

@@ -1,16 +1,24 @@
 #!/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);
-});
+import { pathToFileURL } from 'node:url';
+import { reportMcpErrorAndExit } from '@skillit/mcp';
+import { buildProgram } from './program.js';
+// Re-export the factory so `@skillit/cli`'s program loader can auto-discover
+// the skillit program from this package's `bin` entry (it probes `buildProgram`
+// / `createProgram` / `program` / `default`) when `skillit init/refine --source
+// cli` is run without an explicit `--program`.
+export { buildProgram };
+// Only parse argv when this file is the executed entry — NOT when it is
+// imported for introspection (auto-discovery does `import(bin)`). Parsing on
+// import would consume `process.argv` and could exit the host process.
+const argv1 = process.argv[1];
+if (argv1 !== undefined && import.meta.url === pathToFileURL(argv1).href) {
+    buildProgram()
+        .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

@@ -1 +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"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,6BAA6B;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,6EAA6E;AAC7E,gFAAgF;AAChF,gFAAgF;AAChF,+CAA+C;AAC/C,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,wEAAwE;AACxE,6EAA6E;AAC7E,uEAAuE;AACvE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACzE,YAAY,EAAE;SACX,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;SACxB,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACtB,0EAA0E;QAC1E,oEAAoE;QACpE,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/audit.d.ts

@@ -0,0 +1,34 @@
+import { Command } from 'commander';
+import { type ActionableImprovement, type AuditResult, type ExtractedSkill, type RefineSource, type SkillJudgeEstimate, type TargetLocation } from '@skillit/core';
+import { type RefineSourceKind } from '../detect-source.js';
+/** An improvement with each of its targets resolved to a concrete location (or null). */
+export interface AuditReportImprovement extends ActionableImprovement {
+    /** One entry per `targets[]`, in order; `null` when the source can't resolve it. */
+    resolvedLocations: Array<TargetLocation | null>;
+}
+/** The full JSON report emitted by `skillit audit --json`. */
+export interface AuditReport {
+    audit: AuditResult;
+    estimate: SkillJudgeEstimate;
+    improvements: AuditReportImprovement[];
+}
+/**
+ * Pure report builder: audit + score the skill, then resolve every improvement
+ * target to its on-disk location via the source's optional resolveTargetLocation.
+ */
+export declare function buildAuditReport(source: RefineSource, skill: ExtractedSkill): Promise<AuditReport>;
+/** Parsed options for the `audit` action. */
+export interface AuditCommandOpts {
+    source?: string;
+    program?: string;
+    configType?: string;
+    mcp?: string;
+    server?: string;
+    mode?: string;
+    overlay?: string;
+    json?: boolean;
+}
+export declare function runAuditCommand(opts: AuditCommandOpts): Promise<void>;
+export declare function buildAuditCommand(): Command;
+export type { RefineSourceKind };
+//# sourceMappingURL=audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAIL,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAK7B,yFAAyF;AACzF,MAAM,WAAW,sBAAuB,SAAQ,qBAAqB;IACnE,oFAAoF;IACpF,iBAAiB,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CACjD;AAED,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,YAAY,EAAE,sBAAsB,EAAE,CAAC;CACxC;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,WAAW,CAAC,CAkBtB;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqG3E;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAY3C;AAGD,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/commands/audit.js

@@ -0,0 +1,139 @@
+// packages/client/src/commands/audit.ts
+import { isAbsolute, join } from 'node:path';
+import { Command } from 'commander';
+import { auditSkill, ConfigRefineSource, estimateSkillJudgeScore } from '@skillit/core';
+import { CliRefineSource, loadProgram } from '@skillit/cli';
+import { classifyRefineSources, detectInstalledSources, detectProjectNature } from '../detect-source.js';
+import { parseConfigTypeSpec, resolveRefineSource } from './refine.js';
+import { resolveTypeDocEntry } from '../typedoc-entry.js';
+import { resolveMcpMode } from '../mcp-mode.js';
+/**
+ * Pure report builder: audit + score the skill, then resolve every improvement
+ * target to its on-disk location via the source's optional resolveTargetLocation.
+ */
+export async function buildAuditReport(source, skill) {
+    const audit = auditSkill(skill);
+    const estimate = estimateSkillJudgeScore(audit, skill);
+    const improvements = [];
+    for (const imp of estimate.improvements) {
+        const targets = imp.targets ?? [];
+        const resolvedLocations = [];
+        for (const target of targets) {
+            const loc = source.resolveTargetLocation
+                ? await source.resolveTargetLocation(target)
+                : undefined;
+            resolvedLocations.push(loc ?? null);
+        }
+        improvements.push({ ...imp, resolvedLocations });
+    }
+    return { audit, estimate, improvements };
+}
+export async function runAuditCommand(opts) {
+    const cwd = process.cwd();
+    // Auto-detect the project nature once when no explicit --source is given;
+    // reuse it for both the typedoc and mcp branches below.
+    const nature = opts.source === undefined ? await detectProjectNature(cwd) : undefined;
+    // mcp: explicit --source, an explicit --mcp path (which only the mcp source
+    // consumes), or auto-detected via @modelcontextprotocol/sdk.
+    const isMcp = opts.source === 'mcp' ||
+        (opts.source === undefined && (opts.mcp !== undefined || nature === 'mcp'));
+    // typedoc: explicit, or auto-detected as a plain TS library — but never when
+    // an explicit --mcp path was given (that routes to mcp above).
+    const isTypedoc = opts.source === 'typedoc' ||
+        (opts.source === undefined && opts.mcp === undefined && nature === 'typedoc');
+    let source;
+    if (isTypedoc) {
+        // Lazy import: keeps `@skillit/typedoc` (and its `typedoc` peer) off the CLI
+        // startup path so non-typedoc commands run without TypeDoc installed.
+        const { createTypeDocRefineSource } = await import('@skillit/typedoc');
+        const { entryPoints, tsconfig } = resolveTypeDocEntry(cwd);
+        source = createTypeDocRefineSource({ entryPoints, tsconfig, cwd });
+    }
+    else if (isMcp) {
+        if (opts.mcp === undefined) {
+            console.error('The mcp source requires --mcp <path> (path to mcp.json or MCP config file).');
+            process.exitCode = 1;
+            return;
+        }
+        const resolved = await resolveMcpMode(cwd, opts);
+        if ('error' in resolved) {
+            console.error(resolved.error);
+            process.exitCode = 1;
+            return;
+        }
+        // Lazy import: keeps `@skillit/mcp` (and its SDK peer) off the CLI startup
+        // path so non-mcp commands run without the MCP SDK installed.
+        const { createMcpRefineSource } = await import('@skillit/mcp');
+        source = await createMcpRefineSource({
+            mcpPath: isAbsolute(opts.mcp) ? opts.mcp : join(cwd, opts.mcp),
+            mode: resolved.mode,
+            cwd,
+            ...(opts.server !== undefined ? { serverName: opts.server } : {}),
+            overlayPath: opts.overlay
+                ? isAbsolute(opts.overlay)
+                    ? opts.overlay
+                    : join(cwd, opts.overlay)
+                : join(cwd, '.skillit-overlay.json'),
+            sourceGlob: join(cwd, '**', '*.ts')
+        });
+    }
+    else {
+        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;
+        }
+        if (resolution.kind === 'cli') {
+            const program = await loadProgram({ program: opts.program, cwd });
+            source = new CliRefineSource({ program, sourceGlob: join(cwd, '**', '*.ts'), cwd });
+        }
+        else if (resolution.kind === 'config') {
+            const parsed = parseConfigTypeSpec(opts.configType, cwd);
+            if ('error' in parsed) {
+                console.error(parsed.error);
+                process.exitCode = 1;
+                return;
+            }
+            // No explicit name: ConfigRefineSource derives it from the package nearest
+            // the config file (→ typeName), matching what `skillit gen` writes for the
+            // same source.
+            source = new ConfigRefineSource({
+                configFile: isAbsolute(parsed.configFile)
+                    ? parsed.configFile
+                    : join(cwd, parsed.configFile),
+                typeName: parsed.typeName
+            });
+        }
+        else {
+            console.error(`skillit audit does not yet support the ${resolution.kind} source; cli, config, and typedoc are supported in this release.`);
+            process.exitCode = 1;
+            return;
+        }
+    }
+    const skill = await source.extract();
+    const report = await buildAuditReport(source, skill);
+    if (opts.json) {
+        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+    }
+    else {
+        console.log(`Grade ${report.estimate.grade} (${report.estimate.total}/120)`);
+        console.log(`Fatal ${report.audit.summary.fatal}, Error ${report.audit.summary.error}, Warning ${report.audit.summary.warning}, Alert ${report.audit.summary.alert}`);
+    }
+}
+export function buildAuditCommand() {
+    return new Command('audit')
+        .description('Audit + judge the generated skill; emit findings (with target locations) as JSON')
+        .option('--source <kind>', 'cli | mcp | typedoc | config (auto-detected if omitted)')
+        .option('--program <file#export>', 'commander program entry (cli source)')
+        .option('--config-type <file#export>', 'config type entry (config source)')
+        .option('--mcp <path>', 'path to mcp.json or MCP config file')
+        .option('--server <name>', 'MCP server entry to select (mcp source)')
+        .option('--mode <build|runtime>', 'MCP refine mode (auto-detected if omitted)')
+        .option('--overlay <path>', 'overlay JSON path (mcp runtime mode)')
+        .option('--json', 'emit the full AuditResult + SkillJudgeEstimate as JSON')
+        .action((opts) => runAuditCommand(opts));
+}
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

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

package/dist/commands/gen.d.ts

@@ -0,0 +1,20 @@
+import { Command } from 'commander';
+import { type GenerateConfigSkillOpts, type GenerateMcpSkillOpts, type GenerateSkillOpts, type GenerateTypeDocSkillOpts } from '../generate.js';
+/** Injectable generators (test seam, mirrors InitDeps). */
+export interface GenDeps {
+    generateCliSkill?(opts: GenerateSkillOpts): Promise<void>;
+    generateConfigSkill?(opts: GenerateConfigSkillOpts): Promise<void>;
+    generateTypeDocSkill?(opts: GenerateTypeDocSkillOpts): Promise<void>;
+    generateMcpSkill?(opts: GenerateMcpSkillOpts): Promise<void>;
+}
+/** Parsed options for the `gen` action. */
+export interface GenCommandOpts {
+    source?: string;
+    program?: string;
+    configType?: string;
+    mcp?: string;
+    server?: string;
+    out: string;
+}
+export declare function buildGenCommand(deps?: GenDeps): Command;
+//# sourceMappingURL=gen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gen.d.ts","sourceRoot":"","sources":["../../src/commands/gen.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,OAAO,EAKL,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC9B,MAAM,gBAAgB,CAAC;AAIxB,2DAA2D;AAC3D,MAAM,WAAW,OAAO;IACtB,gBAAgB,CAAC,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,mBAAmB,CAAC,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,oBAAoB,CAAC,CAAC,IAAI,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,gBAAgB,CAAC,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAmBD,wBAAgB,eAAe,CAAC,IAAI,GAAE,OAAY,GAAG,OAAO,CAgG3D"}

package/dist/commands/gen.js

@@ -0,0 +1,108 @@
+// packages/client/src/commands/gen.ts
+import { isAbsolute, join } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { Command } from 'commander';
+import { classifyRefineSources, detectInstalledSources, detectProjectNature } from '../detect-source.js';
+import { generateCliSkill as defaultGenerateCliSkill, generateConfigSkill as defaultGenerateConfigSkill, generateMcpSkill as defaultGenerateMcpSkill, generateTypeDocSkill as defaultGenerateTypeDocSkill } from '../generate.js';
+import { parseConfigTypeSpec, resolveRefineSource } from './refine.js';
+import { resolveTypeDocEntry } from '../typedoc-entry.js';
+/** Strip a leading `@scope/` from a package name for 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';
+    }
+}
+export function buildGenCommand(deps = {}) {
+    const generateCliSkill = deps.generateCliSkill ?? defaultGenerateCliSkill;
+    const generateConfigSkill = deps.generateConfigSkill ?? defaultGenerateConfigSkill;
+    const generateTypeDocSkill = deps.generateTypeDocSkill ?? defaultGenerateTypeDocSkill;
+    const generateMcpSkill = deps.generateMcpSkill ?? defaultGenerateMcpSkill;
+    return new Command('gen')
+        .description('Deterministically (re)generate the skill from current source — no model, no install')
+        .option('--source <kind>', 'cli | mcp | typedoc | config (auto-detected if omitted)')
+        .option('--program <file#export>', 'commander program entry (cli source)')
+        .option('--config-type <file#export>', 'config type entry (config source)')
+        .option('--mcp <path>', 'path to mcp.json or MCP config file (mcp source)')
+        .option('--server <name>', 'MCP server entry to select (mcp source)')
+        .option('--out <dir>', 'output directory for the generated skill', 'skills')
+        .action(async (opts) => {
+        const cwd = process.cwd();
+        const outDir = join(cwd, opts.out);
+        // Detect the project nature at most once (it can spawn the project's CLI
+        // bin). Only needed to auto-route when --source is omitted.
+        const nature = opts.source === undefined ? await detectProjectNature(cwd) : undefined;
+        if (opts.source === 'config') {
+            if (opts.configType === undefined) {
+                throw new Error('The config source requires --config-type <file#export> (e.g. ./src/config.ts#MyConfig).');
+            }
+            const parsed = parseConfigTypeSpec(opts.configType, cwd);
+            if ('error' in parsed)
+                throw new Error(parsed.error);
+            // No explicit name: ConfigRefineSource derives it from the package
+            // nearest the config file (→ typeName), which is more correct in a
+            // monorepo than this command's cwd.
+            await generateConfigSkill({
+                configFile: parsed.configFile,
+                typeName: parsed.typeName,
+                outDir
+            });
+            return;
+        }
+        // mcp: explicit --source, an explicit --mcp path (which only the mcp
+        // source consumes), or auto-detected via @modelcontextprotocol/sdk.
+        const isMcp = opts.source === 'mcp' ||
+            (opts.source === undefined && (opts.mcp !== undefined || nature === 'mcp'));
+        if (isMcp) {
+            if (opts.mcp === undefined) {
+                throw new Error('The mcp source requires --mcp <path> (path to mcp.json or MCP config file).');
+            }
+            const mcpPath = isAbsolute(opts.mcp) ? opts.mcp : join(cwd, opts.mcp);
+            await generateMcpSkill({
+                mcpPath,
+                ...(opts.server !== undefined ? { server: opts.server } : {}),
+                outDir
+            });
+            return;
+        }
+        // typedoc: explicit, or auto-detected as a plain TS library.
+        const isTypedoc = opts.source === 'typedoc' || nature === 'typedoc';
+        if (isTypedoc) {
+            const { entryPoints, tsconfig } = resolveTypeDocEntry(cwd);
+            await generateTypeDocSkill({ cwd, entryPoints, tsconfig, outDir });
+            return;
+        }
+        // Resolve the cli source the same way refine does (handles auto-detection
+        // and the ambiguous/none guidance).
+        const candidates = await detectInstalledSources(cwd);
+        const detected = classifyRefineSources(candidates);
+        const resolution = resolveRefineSource(opts, detected, candidates);
+        if ('error' in resolution)
+            throw new Error(resolution.error);
+        if (resolution.kind === 'cli') {
+            const name = skillNameFrom(await readPackageName(cwd));
+            const nature = 'cli';
+            await generateCliSkill({
+                cwd,
+                nature,
+                name,
+                outDir,
+                ...(opts.program !== undefined ? { program: opts.program } : {})
+            });
+            return;
+        }
+        // Auto-detection resolved to a source gen can't generate yet (e.g. mcp).
+        throw new Error(`skillit gen does not yet support the ${resolution.kind} source; cli and config are supported in this release.`);
+    });
+}
+//# sourceMappingURL=gen.js.map

package/dist/commands/gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen.js","sourceRoot":"","sources":["../../src/commands/gen.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,IAAI,uBAAuB,EAC3C,mBAAmB,IAAI,0BAA0B,EACjD,gBAAgB,IAAI,uBAAuB,EAC3C,oBAAoB,IAAI,2BAA2B,EAKpD,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAoB1D,0EAA0E;AAC1E,SAAS,aAAa,CAAC,WAAmB;IACxC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACrF,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;QACjD,OAAO,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAI,GAAY,EAAE;IAChD,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;IAC1E,MAAM,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,IAAI,0BAA0B,CAAC;IACnF,MAAM,oBAAoB,GAAG,IAAI,CAAC,oBAAoB,IAAI,2BAA2B,CAAC;IACtF,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,uBAAuB,CAAC;IAE1E,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;SACtB,WAAW,CACV,qFAAqF,CACtF;SACA,MAAM,CAAC,iBAAiB,EAAE,yDAAyD,CAAC;SACpF,MAAM,CAAC,yBAAyB,EAAE,sCAAsC,CAAC;SACzE,MAAM,CAAC,6BAA6B,EAAE,mCAAmC,CAAC;SAC1E,MAAM,CAAC,cAAc,EAAE,kDAAkD,CAAC;SAC1E,MAAM,CAAC,iBAAiB,EAAE,yCAAyC,CAAC;SACpE,MAAM,CAAC,aAAa,EAAE,0CAA0C,EAAE,QAAQ,CAAC;SAC3E,MAAM,CAAC,KAAK,EAAE,IAAoB,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAEnC,yEAAyE;QACzE,4DAA4D;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEtF,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CACb,yFAAyF,CAC1F,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;YACzD,IAAI,OAAO,IAAI,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrD,mEAAmE;YACnE,mEAAmE;YACnE,oCAAoC;YACpC,MAAM,mBAAmB,CAAC;gBACxB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,MAAM;aACP,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,qEAAqE;QACrE,oEAAoE;QACpE,MAAM,KAAK,GACT,IAAI,CAAC,MAAM,KAAK,KAAK;YACrB,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC;QAC9E,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CACb,6EAA6E,CAC9E,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACtE,MAAM,gBAAgB,CAAC;gBACrB,OAAO;gBACP,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,MAAM;aACP,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,6DAA6D;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,CAAC;QACpE,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YAC3D,MAAM,oBAAoB,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,0EAA0E;QAC1E,oCAAoC;QACpC,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,UAAU,GAAG,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACnE,IAAI,OAAO,IAAI,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAE7D,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;YACvD,MAAM,MAAM,GAAqB,KAAK,CAAC;YACvC,MAAM,gBAAgB,CAAC;gBACrB,GAAG;gBACH,MAAM;gBACN,IAAI;gBACJ,MAAM;gBACN,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,yEAAyE;QACzE,MAAM,IAAI,KAAK,CACb,wCAAwC,UAAU,CAAC,IAAI,wDAAwD,CAChH,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/init.d.ts

@@ -1,32 +1,13 @@
 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.
+ * Injectable side-effecting steps for {@link buildInitCommand}. Phase 0 init is
+ * install/wire ONLY — it no longer generates or refines (those are `skillit
+ * gen` and `skillit refine`), so the only injectable step is the install.
  */
 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 {};

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

@@ -1 +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"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,KAAK,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9C;;;;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;CAC1E;AAqCD,wBAAgB,gBAAgB,CAAC,IAAI,GAAE,QAAa,GAAG,OAAO,CAkE7D"}

package/dist/commands/init.js

@@ -1,11 +1,7 @@
 // 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) {
@@ -23,24 +19,6 @@ function addDevCommand(pm, pkg) {
         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);
@@ -56,30 +34,24 @@ function defaultRunInstall(pkg, pm, cwd) {
         });
     });
 }
-/** 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)')
+        .description('Detect the project and install the right @skillit package (then run `skillit gen`)')
+        .option('--source <kind>', 'cli | mcp | typedoc | config (auto-detected if omitted)')
+        .option('--config-type <file#export>', 'config type entry (config source)')
         .action(async (opts) => {
         const cwd = process.cwd();
-        // 1. Resolve nature: explicit --source wins, else detect.
+        // Config source is built into the client — nothing to install. Just point
+        // the user at `skillit gen`.
+        if (opts.source === 'config') {
+            if (opts.configType === undefined) {
+                throw new Error('The config source requires --config-type <file#export> (e.g. ./src/config.ts#MyConfig).');
+            }
+            console.log(`Config source needs no install. Generate the skill with:\n  skillit gen --source config --config-type ${opts.configType}`);
+            return;
+        }
+        // Resolve nature: explicit --source wins, else detect.
         let nature;
         if (opts.source !== undefined) {
             if (!VALID_SOURCES.includes(opts.source)) {
@@ -90,7 +62,7 @@ export function buildInitCommand(deps = {}) {
         else {
             nature = await detectProjectNature(cwd);
         }
-        // 2 + 3. Map nature → package, install via the detected package manager.
+        // Map nature → package, install via the detected package manager.
         const pkg = natureToPackage(nature);
         const pm = detectPackageManager(cwd);
         const command = addDevCommand(pm, pkg);
@@ -99,53 +71,20 @@ export function buildInitCommand(deps = {}) {
         }
         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).
+        // Source-aware next step: `skillit gen` generates the cli source today;
+        // mcp uses `skillit mcp extract` and typedoc the TypeDoc plugin (gen
+        // support for those lands in a later phase). Don't point users at a
+        // command that would immediately error for their source.
         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);
+            console.log(`Installed ${pkg}. Generate the skill with:\n  skillit gen --source cli`);
+        }
+        else if (nature === 'mcp') {
+            console.log(`Installed ${pkg}. Generate the skill with:\n  skillit mcp extract\n(skillit gen support for the mcp source lands in a later phase.)`);
         }
         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}`);
+            console.log(`Installed ${pkg}. Generate the skill by running TypeDoc with the plugin enabled.\n(skillit gen support for the typedoc source lands in a later phase.)`);
         }
     });
 }