@momentiq/dark-factory-cli 1.1.0 → 2.0.0

package/dist/skills/config.d.ts

@@ -0,0 +1,176 @@
+import { z } from "zod";
+export declare const CONFIG_FILENAME = "darkfactory.yaml";
+export declare const DarkFactoryConfigSchema: z.ZodObject<{
+    repo: z.ZodOptional<z.ZodObject<{
+        displayName: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        slug: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        ownerRepo: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        ownerRepo?: string | undefined;
+        displayName?: string | undefined;
+        slug?: string | undefined;
+    }, {
+        ownerRepo?: string | undefined;
+        displayName?: string | undefined;
+        slug?: string | undefined;
+    }>>;
+    docs: z.ZodOptional<z.ZodObject<{
+        manifesto: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        adrDir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        cycleDocsDir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        rfcDir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        prdDir: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        manifesto?: string | undefined;
+        adrDir?: string | undefined;
+        cycleDocsDir?: string | undefined;
+        rfcDir?: string | undefined;
+        prdDir?: string | undefined;
+    }, {
+        manifesto?: string | undefined;
+        adrDir?: string | undefined;
+        cycleDocsDir?: string | undefined;
+        rfcDir?: string | undefined;
+        prdDir?: string | undefined;
+    }>>;
+    agents: z.ZodOptional<z.ZodObject<{
+        chiefEngineer: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        chiefEngineer?: string | undefined;
+    }, {
+        chiefEngineer?: string | undefined;
+    }>>;
+    qualityGates: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    qualityGatesExtras: z.ZodOptional<z.ZodObject<{
+        apiTypes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        apiTypes?: string | undefined;
+    }, {
+        apiTypes?: string | undefined;
+    }>>;
+    worktreeRoot: z.ZodOptional<z.ZodString>;
+    agentCommitterOrg: z.ZodOptional<z.ZodString>;
+    skills: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        enabled?: boolean | undefined;
+    }, {
+        enabled?: boolean | undefined;
+    }>>>;
+}, "strict", z.ZodTypeAny, {
+    docs?: {
+        manifesto?: string | undefined;
+        adrDir?: string | undefined;
+        cycleDocsDir?: string | undefined;
+        rfcDir?: string | undefined;
+        prdDir?: string | undefined;
+    } | undefined;
+    repo?: {
+        ownerRepo?: string | undefined;
+        displayName?: string | undefined;
+        slug?: string | undefined;
+    } | undefined;
+    agents?: {
+        chiefEngineer?: string | undefined;
+    } | undefined;
+    qualityGates?: string[] | undefined;
+    qualityGatesExtras?: {
+        apiTypes?: string | undefined;
+    } | undefined;
+    worktreeRoot?: string | undefined;
+    agentCommitterOrg?: string | undefined;
+    skills?: Record<string, {
+        enabled?: boolean | undefined;
+    }> | undefined;
+}, {
+    docs?: {
+        manifesto?: string | undefined;
+        adrDir?: string | undefined;
+        cycleDocsDir?: string | undefined;
+        rfcDir?: string | undefined;
+        prdDir?: string | undefined;
+    } | undefined;
+    repo?: {
+        ownerRepo?: string | undefined;
+        displayName?: string | undefined;
+        slug?: string | undefined;
+    } | undefined;
+    agents?: {
+        chiefEngineer?: string | undefined;
+    } | undefined;
+    qualityGates?: string[] | undefined;
+    qualityGatesExtras?: {
+        apiTypes?: string | undefined;
+    } | undefined;
+    worktreeRoot?: string | undefined;
+    agentCommitterOrg?: string | undefined;
+    skills?: Record<string, {
+        enabled?: boolean | undefined;
+    }> | undefined;
+}>;
+export type DarkFactoryConfig = z.infer<typeof DarkFactoryConfigSchema>;
+export interface LoadedDarkFactoryConfig {
+    readonly config: DarkFactoryConfig;
+    readonly configPath: string;
+    /**
+     * True when the consumer has no `darkfactory.yaml` at the repo root and
+     * the renderer falls back to manifest defaults entirely. Callers may
+     * surface a hint to create one.
+     */
+    readonly isDefault: boolean;
+}
+/**
+ * Locate + parse `darkfactory.yaml` at `repoRoot`. Returns a defaulted
+ * empty config when the file does not exist (so callers can render skills
+ * against pure manifest defaults without special-casing the missing file).
+ * Throws on parse / schema errors — those are explicit consumer mistakes
+ * the install should fail closed on.
+ */
+export declare function loadDarkFactoryConfig(repoRoot: string): LoadedDarkFactoryConfig;
+/**
+ * Parse a git remote URL into `<owner>/<repo>`. Handles both the SSH
+ * shorthand (`git@github.com:owner/repo[.git]`) and the HTTPS form
+ * (`https://github.com/owner/repo[.git]`). Returns null when neither
+ * shape matches — we don't want to populate `OWNER_REPO` from a URL we
+ * couldn't confidently parse.
+ */
+export declare function parseGitRemoteOwnerRepo(remoteUrl: string): string | null;
+/**
+ * Best-effort inference of `<owner>/<repo>` from the consumer's
+ * `origin` git remote. Returns null when the repo is not a git checkout,
+ * has no origin, or origin has an unparseable URL. Never throws — the
+ * caller treats null as "no inference available, fall back to manifest
+ * default".
+ */
+export declare function inferGitOriginOwnerRepo(repoRoot: string): string | null;
+export interface ResolveSkillOverridesOptions {
+    readonly config: DarkFactoryConfig;
+    /**
+     * Consumer repo root. When provided, `OWNER_REPO` / `REPO_SLUG` fall back
+     * to git-remote inference when the yaml does not provide them. Omit in
+     * unit tests that want pure-config behavior.
+     */
+    readonly repoRoot?: string;
+}
+/**
+ * Resolve the install-time variable overrides for one skill, given the
+ * loaded consumer config. The output is the `overrides` arg to
+ * `renderTemplateBody` — a map from variable name to value (scalar string)
+ * or values (string[] for kind:"list").
+ *
+ * Precedence for `OWNER_REPO` / `REPO_SLUG`:
+ *   1. yaml `repo.ownerRepo` / `repo.slug` (explicit; wins)
+ *   2. git remote inference from `repoRoot` (when supplied)
+ *   3. manifest default (renderer falls back when this map omits the key)
+ *
+ * Variable→config-key mapping is hard-coded here because there is exactly
+ * one consumer-config schema. A generic mapping system is not worth the
+ * indirection at this size.
+ */
+export declare function resolveSkillOverrides(options: ResolveSkillOverridesOptions): Record<string, string | string[]>;
+/**
+ * Returns the list of skills the consumer has marked `enabled: true` in
+ * `darkfactory.yaml#skills`. Used by `df skills install --all`.
+ */
+export declare function enabledSkillNames(config: DarkFactoryConfig): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/skills/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/skills/config.ts"],"names":[],"mappings":"AA2CA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAmClD,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,GACf,uBAAuB,CA+BzB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWxE;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAavE;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CA0DnC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAKrE"}

package/dist/skills/config.js

@@ -0,0 +1,251 @@
+// `darkfactory.yaml` — unified consumer config loader.
+//
+// The single config surface for all `df`-installed assets (skills today;
+// future hooks/agents tomorrow). Lives at the consumer repo root as a
+// plain YAML file. Avoids fragmenting per-asset config across multiple
+// files (e.g. `.dark-factory/skills.json`, `.agent-review/extras.json`).
+//
+// Shape (all keys optional — every consumer of the config supplies
+// defaults):
+//
+//   repo:
+//     displayName: "Dark Factory Platform"
+//     slug: "dark-factory-platform"
+//     ownerRepo: "momentiq-ai/dark-factory-platform"
+//   docs:
+//     manifesto: "docs/PRINCIPLES.md"
+//     adrDir: "docs/ADR"
+//     cycleDocsDir: "docs/roadmap/cycles"
+//     rfcDir: "docs/rfcs"
+//     prdDir: "docs/prds"
+//   agents:
+//     chiefEngineer: ".claude/agents/chief-engineer.md"
+//   qualityGates:
+//     - "make quality-gates"
+//   qualityGatesExtras:
+//     apiTypes: "make generate-api-types"
+//   worktreeRoot: ".claude/worktrees"
+//   agentCommitterOrg: "momentiq"
+//   skills:
+//     chief-engineer-review:
+//       enabled: true
+//     chief-engineer-blitz:
+//       enabled: true
+//
+// Backed by the existing `yaml` workspace dep (already required by other
+// CLI surfaces); zod validates the shape so a malformed config fails closed
+// at load time with a useful error.
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { z } from "zod";
+export const CONFIG_FILENAME = "darkfactory.yaml";
+const repoSchema = z
+    .object({
+    displayName: z.string().optional(),
+    slug: z.string().optional(),
+    ownerRepo: z.string().optional(),
+})
+    .partial()
+    .optional();
+const docsSchema = z
+    .object({
+    manifesto: z.string().optional(),
+    adrDir: z.string().optional(),
+    cycleDocsDir: z.string().optional(),
+    rfcDir: z.string().optional(),
+    prdDir: z.string().optional(),
+})
+    .partial()
+    .optional();
+const agentsSchema = z
+    .object({
+    chiefEngineer: z.string().optional(),
+})
+    .partial()
+    .optional();
+const skillEntrySchema = z
+    .object({
+    enabled: z.boolean().optional(),
+})
+    .partial();
+export const DarkFactoryConfigSchema = z
+    .object({
+    repo: repoSchema,
+    docs: docsSchema,
+    agents: agentsSchema,
+    qualityGates: z.array(z.string()).optional(),
+    qualityGatesExtras: z
+        .object({
+        apiTypes: z.string().optional(),
+    })
+        .partial()
+        .optional(),
+    worktreeRoot: z.string().optional(),
+    agentCommitterOrg: z.string().optional(),
+    skills: z.record(skillEntrySchema).optional(),
+})
+    .strict();
+/**
+ * Locate + parse `darkfactory.yaml` at `repoRoot`. Returns a defaulted
+ * empty config when the file does not exist (so callers can render skills
+ * against pure manifest defaults without special-casing the missing file).
+ * Throws on parse / schema errors — those are explicit consumer mistakes
+ * the install should fail closed on.
+ */
+export function loadDarkFactoryConfig(repoRoot) {
+    const configPath = resolve(repoRoot, CONFIG_FILENAME);
+    if (!existsSync(configPath)) {
+        return {
+            config: DarkFactoryConfigSchema.parse({}),
+            configPath,
+            isDefault: true,
+        };
+    }
+    const raw = readFileSync(configPath, "utf8");
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch (err) {
+        throw new Error(`${CONFIG_FILENAME}: YAML parse error — ${err.message}`);
+    }
+    // Empty file → empty object (yaml parser returns null for a file
+    // containing only comments / whitespace; treat that as the empty config).
+    const candidate = parsed === null || parsed === undefined ? {} : parsed;
+    const result = DarkFactoryConfigSchema.safeParse(candidate);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".") || "(root)"}: ${i.message}`)
+            .join("\n");
+        throw new Error(`${CONFIG_FILENAME}: schema validation failed:\n${issues}`);
+    }
+    return { config: result.data, configPath, isDefault: false };
+}
+/**
+ * Parse a git remote URL into `<owner>/<repo>`. Handles both the SSH
+ * shorthand (`git@github.com:owner/repo[.git]`) and the HTTPS form
+ * (`https://github.com/owner/repo[.git]`). Returns null when neither
+ * shape matches — we don't want to populate `OWNER_REPO` from a URL we
+ * couldn't confidently parse.
+ */
+export function parseGitRemoteOwnerRepo(remoteUrl) {
+    const trimmed = remoteUrl.trim();
+    // SSH: git@host:owner/repo[.git]
+    const ssh = trimmed.match(/^[^@]+@[^:]+:([^/]+)\/([^/]+?)(?:\.git)?$/);
+    if (ssh)
+        return `${ssh[1]}/${ssh[2]}`;
+    // HTTPS/HTTP: https://host[:port]/owner/repo[.git]
+    const https = trimmed.match(/^https?:\/\/[^/]+\/([^/]+)\/([^/]+?)(?:\.git)?\/?$/);
+    if (https)
+        return `${https[1]}/${https[2]}`;
+    return null;
+}
+/**
+ * Best-effort inference of `<owner>/<repo>` from the consumer's
+ * `origin` git remote. Returns null when the repo is not a git checkout,
+ * has no origin, or origin has an unparseable URL. Never throws — the
+ * caller treats null as "no inference available, fall back to manifest
+ * default".
+ */
+export function inferGitOriginOwnerRepo(repoRoot) {
+    let url;
+    try {
+        url = execFileSync("git", ["config", "--get", "remote.origin.url"], {
+            cwd: repoRoot,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+    if (url.length === 0)
+        return null;
+    return parseGitRemoteOwnerRepo(url);
+}
+/**
+ * Resolve the install-time variable overrides for one skill, given the
+ * loaded consumer config. The output is the `overrides` arg to
+ * `renderTemplateBody` — a map from variable name to value (scalar string)
+ * or values (string[] for kind:"list").
+ *
+ * Precedence for `OWNER_REPO` / `REPO_SLUG`:
+ *   1. yaml `repo.ownerRepo` / `repo.slug` (explicit; wins)
+ *   2. git remote inference from `repoRoot` (when supplied)
+ *   3. manifest default (renderer falls back when this map omits the key)
+ *
+ * Variable→config-key mapping is hard-coded here because there is exactly
+ * one consumer-config schema. A generic mapping system is not worth the
+ * indirection at this size.
+ */
+export function resolveSkillOverrides(options) {
+    const { config, repoRoot } = options;
+    const overrides = {};
+    if (config.repo?.displayName !== undefined) {
+        overrides.REPO_NAME = config.repo.displayName;
+    }
+    if (config.repo?.slug !== undefined) {
+        overrides.REPO_SLUG = config.repo.slug;
+    }
+    if (config.repo?.ownerRepo !== undefined) {
+        overrides.OWNER_REPO = config.repo.ownerRepo;
+    }
+    if ((overrides.OWNER_REPO === undefined || overrides.REPO_SLUG === undefined) &&
+        repoRoot !== undefined) {
+        const inferred = inferGitOriginOwnerRepo(repoRoot);
+        if (inferred !== null) {
+            const slashIndex = inferred.indexOf("/");
+            if (overrides.OWNER_REPO === undefined) {
+                overrides.OWNER_REPO = inferred;
+            }
+            if (overrides.REPO_SLUG === undefined && slashIndex > 0) {
+                overrides.REPO_SLUG = inferred.slice(slashIndex + 1);
+            }
+        }
+    }
+    if (config.docs?.manifesto !== undefined) {
+        overrides.MANIFESTO_PATH = config.docs.manifesto;
+    }
+    if (config.docs?.adrDir !== undefined) {
+        overrides.ADR_DIR = config.docs.adrDir;
+    }
+    if (config.docs?.cycleDocsDir !== undefined) {
+        overrides.CYCLE_DOCS_DIR = config.docs.cycleDocsDir;
+    }
+    if (config.docs?.rfcDir !== undefined) {
+        overrides.RFC_DIR = config.docs.rfcDir;
+    }
+    if (config.docs?.prdDir !== undefined) {
+        overrides.PRD_DIR = config.docs.prdDir;
+    }
+    if (config.agents?.chiefEngineer !== undefined) {
+        overrides.CE_AGENT_PATH = config.agents.chiefEngineer;
+    }
+    if (config.qualityGates !== undefined && config.qualityGates.length > 0) {
+        overrides.QUALITY_GATE_TARGETS = config.qualityGates;
+    }
+    if (config.qualityGatesExtras?.apiTypes !== undefined) {
+        overrides.API_TYPES_TARGET = config.qualityGatesExtras.apiTypes;
+    }
+    if (config.worktreeRoot !== undefined) {
+        overrides.WORKTREE_ROOT = config.worktreeRoot;
+    }
+    if (config.agentCommitterOrg !== undefined) {
+        overrides.AGENT_COMMITTER_ORG = config.agentCommitterOrg;
+    }
+    return overrides;
+}
+/**
+ * Returns the list of skills the consumer has marked `enabled: true` in
+ * `darkfactory.yaml#skills`. Used by `df skills install --all`.
+ */
+export function enabledSkillNames(config) {
+    if (!config.skills)
+        return [];
+    return Object.entries(config.skills)
+        .filter(([, entry]) => entry.enabled === true)
+        .map(([name]) => name);
+}
+//# sourceMappingURL=config.js.map

package/dist/skills/config.js.map

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

package/dist/skills/index.d.ts

@@ -0,0 +1,4 @@
+export { installSkill, listBundledSkills, resolveSkillsRoot, KNOWN_SKILLS, type InstallOptions, type InstallResult, type InstalledFile, type ListedSkill, } from "./install.js";
+export { loadDarkFactoryConfig, resolveSkillOverrides, enabledSkillNames, inferGitOriginOwnerRepo, parseGitRemoteOwnerRepo, DarkFactoryConfigSchema, CONFIG_FILENAME, type DarkFactoryConfig, type LoadedDarkFactoryConfig, type ResolveSkillOverridesOptions, } from "./config.js";
+export { renderTemplateBody, extractReferencedVariables, type SkillManifest, type SkillVariableDef, type RenderResult, type RenderTemplateOptions, type VariableOverride, } from "./template.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/skills/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,GAClC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,EAC1B,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,eAAe,CAAC"}

package/dist/skills/index.js

@@ -0,0 +1,8 @@
+// Public exports for the `skills` module — consumed by:
+//   - `src/cli.ts` (the `df skills install/list` CLI surface)
+//   - `src/mcp/tools/skills-install.ts` (the parallel MCP tool surface)
+//   - `src/index.ts` (the library export for downstream consumers)
+export { installSkill, listBundledSkills, resolveSkillsRoot, KNOWN_SKILLS, } from "./install.js";
+export { loadDarkFactoryConfig, resolveSkillOverrides, enabledSkillNames, inferGitOriginOwnerRepo, parseGitRemoteOwnerRepo, DarkFactoryConfigSchema, CONFIG_FILENAME, } from "./config.js";
+export { renderTemplateBody, extractReferencedVariables, } from "./template.js";
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/skills/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,8DAA8D;AAC9D,wEAAwE;AACxE,mEAAmE;AAEnE,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,GAKb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,GAIhB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,0BAA0B,GAM3B,MAAM,eAAe,CAAC"}

package/dist/skills/install.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Names of the skills bundled with this CLI. Adding a new skill = (1) drop
+ * the source-of-truth dir under `skills/`, (2) append the name here.
+ */
+export declare const KNOWN_SKILLS: ReadonlyArray<string>;
+export interface InstallOptions {
+    /** Consumer repo root. `darkfactory.yaml` is loaded from here. */
+    readonly cwd: string;
+    /** Skill name (must be in KNOWN_SKILLS). */
+    readonly skillName: string;
+    /**
+     * Override location of the target install dir. Defaults to
+     * `<cwd>/.claude/skills/<skillName>/`. Tests override to a temp dir.
+     */
+    readonly targetDir?: string;
+    /** Force-overwrite hand-edited rendered files. */
+    readonly force?: boolean;
+    /** Override the bundled-skills source dir (tests). */
+    readonly _sourceRoot?: string;
+}
+export interface InstalledFile {
+    readonly relTarget: string;
+    readonly absoluteTarget: string;
+    readonly action: "created" | "updated" | "unchanged" | "skipped";
+    /** Present when action = "skipped" — explains why. */
+    readonly reason?: string;
+}
+export interface InstallResult {
+    readonly skillName: string;
+    readonly manifestVersion: string;
+    readonly configPath: string;
+    readonly configIsDefault: boolean;
+    readonly resolvedVariables: ReadonlyArray<{
+        readonly name: string;
+        readonly value: string;
+    }>;
+    readonly files: ReadonlyArray<InstalledFile>;
+}
+export interface ListedSkill {
+    readonly name: string;
+    readonly version: string;
+    readonly summary: string;
+    readonly originatingRepo?: string;
+}
+/**
+ * Resolve the absolute path of the bundled-skills source-of-truth root.
+ * In dev (running from src/), the path is `<package>/skills/`. In a
+ * published install (running from dist/), the path is the same — the
+ * `files` array in package.json carries the `skills/` dir verbatim and
+ * `dist/skills/index.js`'s ../../skills resolution lands on it.
+ */
+export declare function resolveSkillsRoot(): string;
+/**
+ * List every bundled skill (one-entry per dir under the source root that
+ * has a valid skill.json). Used by `df skills list` + `df_skills_list`.
+ */
+export declare function listBundledSkills(sourceRoot?: string): ListedSkill[];
+/**
+ * Install one skill into the consumer's `.claude/skills/<name>/`.
+ */
+export declare function installSkill(options: InstallOptions): InstallResult;
+//# sourceMappingURL=install.d.ts.map

package/dist/skills/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/skills/install.ts"],"names":[],"mappings":"AA8CA;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,MAAM,CAG9C,CAAC;AAUF,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IACjE,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7F,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AA8CD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CA2BpE;AA6FD;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CA0HnE"}