@winspan/claude-forge 8.54.4 → 9.12.0

package/dist/skills/builtin-skills.js

@@ -0,0 +1,68 @@
+/**
+ * Built-in skills for claude-forge.
+ *
+ * Canonical source: `src/skills/distilled/*.md`. The official-purge spec
+ * (2026-05-27, 1110) removed:
+ *   - the OFFICIAL_SKILL_KEYWORDS map (keyword data moved to .md frontmatter)
+ *   - the registry-side ALIAS reverse-merge (single source of truth = the .md)
+ *   - the cf admin migrate-skill-ids tool + cf skills upgrade/rollback pipeline
+ *   - the OFFICIAL_TO_DISTILLED_ALIAS map (no remaining consumers)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import matter from 'gray-matter';
+/**
+ * Load built-in skills from a directory of .md files.
+ * Each .md file should have frontmatter with at minimum a `name` field.
+ * The `keywords` or `tags` field in frontmatter provides keyword matching hints.
+ *
+ * Canonical source dir: `src/skills/distilled/`. The function name is kept
+ * for callers that reference it; semantically it loads "built-in"
+ * (claude-forge-shipped) skills regardless of which subdir they live in.
+ *
+ * @param builtinDir - Path to the directory containing built-in skill .md files
+ * @returns Array of BuiltinSkill objects
+ */
+export function loadBuiltinSkills(builtinDir) {
+    if (!fs.existsSync(builtinDir)) {
+        throw new Error(`Built-in skills directory not found: ${builtinDir}`);
+    }
+    const entries = fs.readdirSync(builtinDir);
+    const skills = [];
+    for (const filename of entries) {
+        if (!filename.endsWith('.md'))
+            continue;
+        const filePath = path.join(builtinDir, filename);
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const parsed = matter(raw);
+        const { data, content: body } = parsed;
+        const id = path.basename(filename, '.md');
+        const name = typeof data.name === 'string' ? data.name : id;
+        const version = typeof data.version === 'string' ? data.version : '1.0.0';
+        const description = typeof data.description === 'string' ? data.description : '';
+        // Support both `keywords` (claude-forge standard) and `tags` (Claude Code official skill convention)
+        const rawKeywords = data.keywords ?? data.tags;
+        const keywords = Array.isArray(rawKeywords)
+            ? rawKeywords.filter((k) => typeof k === 'string')
+            : [];
+        // Phase 7 — pairing fields. Optional; absence means "no pairing, inject
+        // skill content directly" (existing behavior).
+        const spawnAgent = typeof data.spawn_agent === 'string' && data.spawn_agent.trim().length > 0
+            ? data.spawn_agent.trim()
+            : undefined;
+        const spawnAgentPrompt = typeof data.spawn_agent_prompt === 'string' && data.spawn_agent_prompt.length > 0
+            ? data.spawn_agent_prompt
+            : undefined;
+        skills.push({
+            name,
+            version,
+            description,
+            keywords,
+            content: raw, // full file content including frontmatter
+            spawn_agent: spawnAgent,
+            spawn_agent_prompt: spawnAgentPrompt,
+        });
+    }
+    return skills;
+}
+//# sourceMappingURL=builtin-skills.js.map

package/dist/skills/builtin-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-skills.js","sourceRoot":"","sources":["../../src/skills/builtin-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAejC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,wCAAwC,UAAU,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC3B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAEvC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1E,MAAM,WAAW,GAAG,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAEjF,qGAAqG;QACrG,MAAM,WAAW,GAAY,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC;QACxD,MAAM,QAAQ,GAAa,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;YACnD,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YAC/D,CAAC,CAAC,EAAE,CAAC;QAEP,wEAAwE;QACxE,+CAA+C;QAC/C,MAAM,UAAU,GACd,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YACxE,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE;YACzB,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,gBAAgB,GACpB,OAAO,IAAI,CAAC,kBAAkB,KAAK,QAAQ,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;YAC/E,CAAC,CAAC,IAAI,CAAC,kBAAkB;YACzB,CAAC,CAAC,SAAS,CAAC;QAEhB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,OAAO;YACP,WAAW;YACX,QAAQ;YACR,OAAO,EAAE,GAAG,EAAE,0CAA0C;YACxD,WAAW,EAAE,UAAU;YACvB,kBAAkB,EAAE,gBAAgB;SACrC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/skills/distill/attribution.d.ts

@@ -0,0 +1,59 @@
+/**
+ * attribution.ts
+ *
+ * License + provenance helpers for distilled skills. Per spec Q6 each
+ * distilled skill carries attribution in BOTH the frontmatter (machine-
+ * readable, for audit / per-skill lookup) and in the project-root NOTICE
+ * file (cumulative append-only).
+ */
+export interface UpstreamSource {
+    /** Upstream repo URL (e.g. github.com/obra/superpowers) */
+    upstream: string;
+    /** SPDX-style license tag (MIT / Apache-2.0 / …) */
+    license: string;
+    /** HEAD commit at fetch time */
+    commit: string;
+    /** Relative paths within the upstream that contributed to this distillation */
+    paths: string[];
+}
+export interface AttributionFrontmatter {
+    distilled_from: UpstreamSource[];
+    distilled_at: string;
+    distilled_by: string;
+    it_universal_score: number;
+    it_universal_dims: {
+        d1: number;
+        d2: number;
+        d3: number;
+        d4: number;
+        d5: number;
+    };
+    it_universal_rationale: string;
+}
+/**
+ * Build the YAML frontmatter object (caller wraps it). Kept as a plain object
+ * for easier testing — serialization happens in distiller.ts.
+ */
+export declare function buildAttribution(args: {
+    sources: UpstreamSource[];
+    distilledBy: string;
+    itUniversalScore: number;
+    itUniversalDims: AttributionFrontmatter['it_universal_dims'];
+    itUniversalRationale: string;
+    now?: Date;
+}): AttributionFrontmatter;
+/**
+ * Append to a project-root NOTICE file. Idempotent per (skillId, upstream)
+ * pair — re-running on the same skill won't double-append.
+ *
+ * NOTICE format intentionally simple:
+ *   ## <skillId>
+ *   - upstream: <url> @<commit> (license: <license>)
+ *     paths: <p1>, <p2>
+ */
+export declare function appendToNotice(noticePath: string, skillId: string, sources: UpstreamSource[]): Promise<void>;
+/**
+ * Generate the NOTICE header on a fresh init (called by `cf skills distill init`).
+ */
+export declare function ensureNoticeFile(noticePath: string): Promise<void>;
+//# sourceMappingURL=attribution.d.ts.map

package/dist/skills/distill/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../../src/skills/distill/attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,cAAc,EAAE,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;IAC7D,oBAAoB,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,sBAAsB,CASzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AA8BD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxE"}

package/dist/skills/distill/attribution.js

@@ -0,0 +1,101 @@
+/**
+ * attribution.ts
+ *
+ * License + provenance helpers for distilled skills. Per spec Q6 each
+ * distilled skill carries attribution in BOTH the frontmatter (machine-
+ * readable, for audit / per-skill lookup) and in the project-root NOTICE
+ * file (cumulative append-only).
+ */
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+/**
+ * Build the YAML frontmatter object (caller wraps it). Kept as a plain object
+ * for easier testing — serialization happens in distiller.ts.
+ */
+export function buildAttribution(args) {
+    return {
+        distilled_from: args.sources,
+        distilled_at: (args.now ?? new Date()).toISOString(),
+        distilled_by: args.distilledBy,
+        it_universal_score: args.itUniversalScore,
+        it_universal_dims: args.itUniversalDims,
+        it_universal_rationale: args.itUniversalRationale,
+    };
+}
+/**
+ * Append to a project-root NOTICE file. Idempotent per (skillId, upstream)
+ * pair — re-running on the same skill won't double-append.
+ *
+ * NOTICE format intentionally simple:
+ *   ## <skillId>
+ *   - upstream: <url> @<commit> (license: <license>)
+ *     paths: <p1>, <p2>
+ */
+export async function appendToNotice(noticePath, skillId, sources) {
+    // Ensure file exists with header.
+    let existing = '';
+    try {
+        existing = await fs.readFile(noticePath, 'utf-8');
+    }
+    catch {
+        existing = NOTICE_HEADER;
+    }
+    // Idempotency: if header for this skillId already exists, replace its block.
+    const header = `## ${skillId}`;
+    const headerIdx = existing.indexOf(header);
+    const newBlock = renderBlock(skillId, sources);
+    let nextContent;
+    if (headerIdx === -1) {
+        nextContent = existing.trimEnd() + '\n\n' + newBlock + '\n';
+    }
+    else {
+        // Replace the existing block up to the next "## " heading or EOF.
+        const tail = existing.slice(headerIdx);
+        const nextHeader = tail.search(/\n## /);
+        const before = existing.slice(0, headerIdx);
+        const after = nextHeader === -1 ? '' : tail.slice(nextHeader + 1);
+        nextContent = before + newBlock + (after ? '\n' + after : '\n');
+    }
+    await fs.mkdir(path.dirname(noticePath), { recursive: true });
+    await fs.writeFile(noticePath, nextContent, 'utf-8');
+}
+function renderBlock(skillId, sources) {
+    const lines = [`## ${skillId}`];
+    for (const s of sources) {
+        lines.push(`- upstream: ${s.upstream} @${s.commit.slice(0, 8)} (license: ${s.license})`);
+        if (s.paths.length > 0) {
+            lines.push(`  paths: ${s.paths.join(', ')}`);
+        }
+    }
+    return lines.join('\n');
+}
+const NOTICE_HEADER = [
+    '# NOTICE — Upstream Attribution',
+    '',
+    'This file accumulates license + provenance metadata for skills distilled',
+    'from open-source upstreams via `cf skills distill run`. It is APPEND-ONLY',
+    'in spirit; the tool replaces a skill\'s block when re-distilled so per-skill',
+    'attribution stays current.',
+    '',
+    'Upstream licenses preserved:',
+    '- obra/superpowers — MIT',
+    '- anthropics/skills — Apache-2.0',
+    '- affaan-m/ECC — MIT',
+    '',
+    '---',
+    '',
+].join('\n');
+/**
+ * Generate the NOTICE header on a fresh init (called by `cf skills distill init`).
+ */
+export async function ensureNoticeFile(noticePath) {
+    try {
+        await fs.access(noticePath);
+        return;
+    }
+    catch {
+        await fs.mkdir(path.dirname(noticePath), { recursive: true });
+        await fs.writeFile(noticePath, NOTICE_HEADER, 'utf-8');
+    }
+}
+//# sourceMappingURL=attribution.js.map

package/dist/skills/distill/attribution.js.map

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

package/dist/skills/distill/distiller.d.ts

@@ -0,0 +1,161 @@
+/**
+ * distiller.ts — R-B real implementation (spec 1851).
+ *
+ * Spawns the `claude` CLI in headless mode (`-p --agent skill-distiller
+ * --output-format stream-json`) and pipes the upstream skill markdown via
+ * stdin. The agent self-scores on the IT-universal rubric, then either emits
+ * a `---SKIP---...---END---` envelope (score < 3) or a
+ * `---SKILL---...---END---` envelope (score ≥ 3) which the caller writes to
+ * disk.
+ *
+ * No Anthropic SDK / API key required — runs entirely through the user's
+ * Claude Code subscription (OAuth from macOS Keychain).
+ *
+ * IMPORTANT: We deliberately do NOT pass `--bare`. Per `claude --help`,
+ * `--bare` forces "Anthropic auth is strictly ANTHROPIC_API_KEY or
+ * apiKeyHelper via --settings (OAuth and keychain are never read)". For users
+ * on a Claude Code subscription without an API key, this triggers
+ * "Not logged in" and every distill subprocess exits 1.
+ *
+ * Recursion protection (replaces what `--bare` used to give us):
+ *   • We spawn with env `CLAUDE_FORGE_DISTILL_SPAWN=1`.
+ *   • Every entry-point hook in `src/hooks/*.sh` checks that env var at the
+ *     very top and exits 0 immediately, so the spawned `claude` subprocess
+ *     never fires hook → daemon → claude → hook → ... loops.
+ *
+ * Errors:
+ *  - `ClaudeCliMissingError` — `claude` not on PATH
+ *  - `SkillSkippedError` — agent emitted SKIP envelope (low score)
+ *  - `SkillBlockMissingError` — agent output has no recognisable envelope
+ *  - `ProjectAnchorRejection` — distilled body still contains anchors (no retry per Q2)
+ */
+import type { TopicGroup } from './topic-deduper.js';
+import type { CandidateScore } from './topic-deduper.js';
+import type { Upstream } from './upstream-fetcher.js';
+import { type UpstreamSource } from './attribution.js';
+import { type BlacklistViolation } from './project-anchor-guard.js';
+export declare class SkillBlockMissingError extends Error {
+    readonly outputId: string;
+    readonly rawTextSnippet: string;
+    constructor(outputId: string, rawText: string);
+}
+export declare class ProjectAnchorRejection extends Error {
+    readonly hits: BlacklistViolation[];
+    readonly outputId: string;
+    constructor(outputId: string, hits: BlacklistViolation[]);
+}
+export declare class SkillSkippedError extends Error {
+    readonly outputId: string;
+    readonly score: number;
+    readonly rationale: string;
+    constructor(outputId: string, score: number, rationale: string);
+}
+export declare class ClaudeCliMissingError extends Error {
+    constructor();
+}
+export interface DistillProgressEvent {
+    type: string;
+    charCount?: number;
+    raw?: unknown;
+}
+export interface DistillerOptions {
+    outputDir: string;
+    noticePath: string;
+    upstreams: ReadonlyArray<Upstream>;
+    upstreamCommits: Record<string, string>;
+    force?: boolean;
+    /** Stream-json event callback for the SSE bridge. */
+    onProgress?: (event: DistillProgressEvent) => void;
+    /** User-initiated cancel. distill-manager propagates this from cancel(). */
+    cancelSignal?: AbortSignal;
+    /** Per-skill timeout. Default 600s (10 min). */
+    timeoutMs?: number;
+    /**
+     * Spec 1641 (force-outputid): override the topic-primary pick; distill
+     * THIS member instead of `group.members[0]`. The orchestrator sets this
+     * when the caller requested a specific outputId via `RunOptions.outputIds`
+     * and the inverse resolution found a non-primary member match.
+     */
+    forcedMember?: CandidateScore;
+    /**
+     * Spec 1641: override the `inferOutputId(group)` result so the write
+     * target is exactly `<outputDir>/<forcedOutputId>.md`. Pairs with
+     * `forcedMember` to guarantee the agent runs against the requested
+     * upstream and the resulting file lands at the caller-supplied path.
+     */
+    forcedOutputId?: string;
+}
+export interface DistillResult {
+    outputPath: string;
+    topicId: string;
+    primary: CandidateScore;
+    sources: UpstreamSource[];
+    realDistillation: boolean;
+    blacklistHits: number;
+}
+/**
+ * Spawn `claude -p --agent skill-distiller --output-format stream-json
+ * --include-partial-messages --input-format text` with the prompt on stdin.
+ * Accumulates assistant text from stream-json events. Returns the full
+ * assistant output (raw, before envelope parsing).
+ *
+ * Notes:
+ *   • No `--bare` — see file-header comment. We rely on
+ *     CLAUDE_FORGE_DISTILL_SPAWN=1 (set on child env, checked by every hook
+ *     entry-point) to break the recursion loop without disabling OAuth.
+ *
+ * Exported for testing.
+ */
+export declare function spawnSkillDistillerAgent(prompt: string, opts?: {
+    onProgress?: (event: DistillProgressEvent) => void;
+    cancelSignal?: AbortSignal;
+    timeoutMs?: number;
+}): Promise<string>;
+export declare function buildSkillDistillerPrompt(input: {
+    outputId: string;
+    upstreamMarkdown: string;
+    upstreamUrl: string;
+    topicId: string;
+}): string;
+/**
+ * Minimum body length (in chars, post-trim) for a SKILL envelope to be
+ * accepted. Anything shorter is treated as agent error (see spec 0930 Bug B —
+ * `distilled-security-hardening.md` produced a valid envelope with zero
+ * body chars; the orchestrator then marked the topic completed and refused
+ * to retry).
+ *
+ * 50 chars is well below the agent's 80-200 line target; legitimate skill
+ * markdown clears it trivially (`## When to use\n- one\n## Steps\n1. two\n`
+ * is already 50+).
+ */
+export declare const SKILL_BODY_MIN_CHARS = 50;
+/**
+ * Extract the body inside `---SKILL---...---END---` and strip the inner
+ * frontmatter. Returns null if the envelope is missing OR if the surviving
+ * body (after frontmatter strip + trim) is shorter than SKILL_BODY_MIN_CHARS.
+ */
+export declare function parseSkillBlock(text: string): string | null;
+/**
+ * Extract score + rationale from a `---SKIP---...---END---` envelope.
+ * Returns null if the SKIP envelope is missing.
+ */
+export declare function parseSkipBlock(text: string): {
+    score: number;
+    rationale: string;
+} | null;
+/**
+ * Distill one TopicGroup via the skill-distiller agent. Spawns claude CLI,
+ * parses the SKILL/SKIP envelope, runs project-anchor-guard, writes the
+ * distilled file + appends to NOTICE.
+ */
+export declare function distillGroup(group: TopicGroup, opts: DistillerOptions): Promise<DistillResult>;
+/**
+ * Derive the canonical output filename (without `.md`) for a topic group.
+ *
+ * Spec 1641: exported so `index.ts` can invert this — given a desired
+ * outputId, the orchestrator walks each group's members and checks which
+ * single-member synthetic group would produce that outputId, to pin down
+ * the exact upstream candidate the caller wants re-distilled.
+ */
+export declare function inferOutputId(group: TopicGroup): string;
+//# sourceMappingURL=distiller.d.ts.map

package/dist/skills/distill/distiller.d.ts.map

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