@momentiq/dark-factory-cli 1.1.0 → 2.1.0

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"}

package/dist/skills/install.js

@@ -0,0 +1,315 @@
+// `df skills install <name>` — install a bundled skill into the consumer's
+// `.claude/skills/<name>/`, rendering all template files against the
+// consumer's `darkfactory.yaml`.
+//
+// Idempotency contract:
+//   - Re-running `df skills install <name>` overwrites the rendered files
+//     (no merge — the rendered file is a generated artifact).
+//   - If the rendered file would change AND it has been hand-edited since
+//     the last install (detected via a top-of-file GENERATED header marker),
+//     install refuses to overwrite without `--force`.
+//   - The generated header carries a hash of the manifest version + the
+//     resolved variable set, so a no-op re-run is detectable.
+//
+// Discovery:
+//   - The bundled skill source-of-truth lives at `packages/cli/skills/<name>/`
+//     in this repo; published, it lives at the equivalent location inside the
+//     installed npm package.
+//   - `resolveSkillSourceDir()` finds the dir relative to this module's
+//     compiled location (works for both src/ in dev and dist/ in production).
+import { createHash, } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync, } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadDarkFactoryConfig, resolveSkillOverrides, } from "./config.js";
+import { extractReferencedVariables, renderTemplateBody, } from "./template.js";
+/**
+ * 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 const KNOWN_SKILLS = [
+    "chief-engineer-review",
+    "chief-engineer-blitz",
+];
+/**
+ * The HTML-comment marker emitted at the top of every rendered file
+ * (after frontmatter for SKILL.md, at the very top for other files). Used
+ * to detect hand-edits at re-install time so we can refuse to overwrite
+ * unless `--force` is passed.
+ */
+const GENERATED_MARKER = "GENERATED by `df skills install";
+/**
+ * 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 function resolveSkillsRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    // src/skills/install.ts → ../../skills (two up: skills → src → package root)
+    // dist/skills/install.js → ../../skills (same depth)
+    return resolve(here, "..", "..", "skills");
+}
+function readManifest(skillName, sourceRoot) {
+    const manifestPath = join(sourceRoot, skillName, "skill.json");
+    if (!existsSync(manifestPath)) {
+        throw new Error(`df skills install: unknown skill "${skillName}" — no manifest at ${manifestPath}. Known skills: ${KNOWN_SKILLS.join(", ")}.`);
+    }
+    const raw = readFileSync(manifestPath, "utf8");
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`df skills install: skill.json for "${skillName}" is not valid JSON — ${err.message}`);
+    }
+    // Light structural check — full schema is in skills/skill-schema.json.
+    // We rely on the renderer's per-variable check (catches typos) and the
+    // file-write loop (catches missing files); a heavyweight zod parse is
+    // overkill for a directory we author + ship ourselves.
+    const m = parsed;
+    if (typeof m.name !== "string" || typeof m.version !== "string") {
+        throw new Error(`df skills install: skill.json for "${skillName}" missing required fields (name, version).`);
+    }
+    if (m.name !== skillName) {
+        throw new Error(`df skills install: skill.json#name "${String(m.name)}" does not match directory name "${skillName}".`);
+    }
+    if (!Array.isArray(m.files) || m.files.length === 0) {
+        throw new Error(`df skills install: skill.json#files for "${skillName}" must be a non-empty array.`);
+    }
+    if (typeof m.variables !== "object" || m.variables === null) {
+        throw new Error(`df skills install: skill.json#variables for "${skillName}" must be an object.`);
+    }
+    return parsed;
+}
+/**
+ * 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 function listBundledSkills(sourceRoot) {
+    const root = sourceRoot ?? resolveSkillsRoot();
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    for (const entry of readdirSync(root, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const name = entry.name;
+        const manifestPath = join(root, name, "skill.json");
+        if (!existsSync(manifestPath))
+            continue;
+        try {
+            const m = JSON.parse(readFileSync(manifestPath, "utf8"));
+            const item = {
+                name: m.name,
+                version: m.version,
+                summary: m.summary,
+                ...(m.originatingRepo !== undefined
+                    ? { originatingRepo: m.originatingRepo }
+                    : {}),
+            };
+            out.push(item);
+        }
+        catch {
+            // Skip malformed manifests so a single bad dir doesn't break the list.
+        }
+    }
+    // Stable order — alphabetical by name, regardless of FS readdir order.
+    out.sort((a, b) => a.name.localeCompare(b.name));
+    return out;
+}
+/**
+ * Read an existing rendered file, if it exists, and return the marker line
+ * embedded by a previous install (if any) so we can detect hand-edits.
+ */
+function detectExistingMarker(absPath) {
+    if (!existsSync(absPath))
+        return { present: false, hash: null };
+    const body = readFileSync(absPath, "utf8");
+    // Marker shape: `# install-hash: <64-hex>` on a line by itself, after the
+    // GENERATED prefix line. We match the hash specifically; if the hash isn't
+    // present (or doesn't match the freshly-computed one), we treat the file
+    // as hand-edited.
+    const match = body.match(/install-hash:\s*([0-9a-f]{64})/);
+    if (match)
+        return { present: true, hash: match[1] ?? null };
+    // Marker comment present but no hash → also treat as old format / hand-edited.
+    if (body.includes(GENERATED_MARKER))
+        return { present: true, hash: null };
+    return { present: false, hash: null };
+}
+/**
+ * Compute a stable hash of (manifest.version + resolved-variables) so a
+ * re-render with identical inputs produces an identical hash. Embedded in
+ * the GENERATED header so subsequent installs can skip a no-op rewrite.
+ */
+function computeInstallHash(manifest, resolved) {
+    const h = createHash("sha256");
+    h.update(manifest.name);
+    h.update("\n");
+    h.update(manifest.version);
+    h.update("\n");
+    // Sort for determinism — renderTemplateBody returns in template-encounter
+    // order but the hash should not depend on which template referenced the
+    // variable first.
+    const sorted = [...resolved].sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of sorted) {
+        h.update(entry.name);
+        h.update("=");
+        h.update(entry.value);
+        h.update("\n");
+    }
+    return h.digest("hex");
+}
+/**
+ * Inject the GENERATED marker (with install-hash) into a rendered body.
+ * For .md files with YAML frontmatter, the marker goes immediately after
+ * the closing `---`. For other files, it goes at the top.
+ */
+function injectInstallMarker(body, skillName, installHash) {
+    const marker = [
+        `<!--`,
+        `  ${GENERATED_MARKER} ${skillName}\`. Do not hand-edit.`,
+        `  install-hash: ${installHash}`,
+        `  Re-render with: df skills install ${skillName}`,
+        `  Or edit darkfactory.yaml + the upstream template, then re-install.`,
+        `-->`,
+        ``,
+    ].join("\n");
+    // Detect YAML frontmatter (--- ... ---) at file start.
+    if (body.startsWith("---\n")) {
+        const closing = body.indexOf("\n---", 4);
+        if (closing !== -1) {
+            const afterFm = closing + "\n---".length;
+            const head = body.slice(0, afterFm);
+            const tail = body.slice(afterFm);
+            // Ensure exactly one blank line between frontmatter and marker.
+            const tailTrim = tail.replace(/^\n+/, "");
+            return `${head}\n\n${marker}${tailTrim}`;
+        }
+    }
+    return `${marker}${body}`;
+}
+/**
+ * Strip a previously-injected marker block from a body so we can compare
+ * the freshly-rendered body to the on-disk body modulo the marker (which
+ * carries a hash that changes per-install).
+ */
+function stripInstallMarker(body) {
+    // The marker block is a `<!-- … -->` whose first content line starts with
+    // the GENERATED prefix. Conservative match — only the first such block.
+    const re = /<!--\s*\n\s+GENERATED by `df skills install [^]*?-->\n?/;
+    return body.replace(re, "");
+}
+/**
+ * Install one skill into the consumer's `.claude/skills/<name>/`.
+ */
+export function installSkill(options) {
+    const sourceRoot = options._sourceRoot ?? resolveSkillsRoot();
+    const skillSourceDir = join(sourceRoot, options.skillName);
+    if (!existsSync(skillSourceDir) || !statSync(skillSourceDir).isDirectory()) {
+        throw new Error(`df skills install: unknown skill "${options.skillName}". Known skills: ${KNOWN_SKILLS.join(", ")}.`);
+    }
+    const manifest = readManifest(options.skillName, sourceRoot);
+    // Load consumer config + resolve overrides.
+    const loaded = loadDarkFactoryConfig(options.cwd);
+    const config = loaded.config;
+    const overrides = resolveSkillOverrides({ config, repoRoot: options.cwd });
+    const targetDir = options.targetDir ??
+        resolve(options.cwd, ".claude", "skills", options.skillName);
+    // First pass: render all files in-memory to compute the install hash
+    // from the full resolved-variable set across templates (so the hash
+    // changes when ANY variable resolves differently, not just one).
+    const renderedNoMarker = [];
+    const allVars = new Map();
+    for (const fileSpec of manifest.files) {
+        const templatePath = join(skillSourceDir, fileSpec.template);
+        if (!existsSync(templatePath)) {
+            throw new Error(`df skills install: template file missing at ${templatePath} (skill: ${manifest.name}).`);
+        }
+        const raw = readFileSync(templatePath, "utf8");
+        // Lint: every variable referenced must be declared.
+        for (const varName of extractReferencedVariables(raw)) {
+            if (!(varName in manifest.variables)) {
+                throw new Error(`df skills install: template ${fileSpec.template} references undeclared variable "{{${varName}}}" — add to skill.json#variables for skill "${manifest.name}".`);
+            }
+        }
+        const rendered = renderTemplateBody(raw, { manifest, overrides });
+        for (const entry of rendered.substituted) {
+            allVars.set(entry.name, entry.value);
+        }
+        renderedNoMarker.push({
+            target: fileSpec.target,
+            body: rendered.body,
+            substituted: rendered.substituted,
+        });
+    }
+    const resolvedVariables = Array.from(allVars, ([name, value]) => ({ name, value }));
+    const installHash = computeInstallHash(manifest, resolvedVariables);
+    // Second pass: inject marker + write to disk.
+    const files = [];
+    for (const r of renderedNoMarker) {
+        const absTarget = resolve(targetDir, r.target);
+        const finalBody = injectInstallMarker(r.body, manifest.name, installHash);
+        const existing = detectExistingMarker(absTarget);
+        const exists = existsSync(absTarget);
+        if (exists && existing.present === false) {
+            // File exists but has no marker → hand-edited or pre-template version.
+            if (!options.force) {
+                files.push({
+                    relTarget: r.target,
+                    absoluteTarget: absTarget,
+                    action: "skipped",
+                    reason: "file exists without GENERATED marker (hand-edited or pre-template). Re-run with --force to overwrite.",
+                });
+                continue;
+            }
+        }
+        if (exists && existing.present && existing.hash === installHash) {
+            // Hash matches → same manifest version + same resolved vars. Compare
+            // the body (modulo the marker) to detect a hand-edit the hash cannot
+            // catch: a user can edit the prose without touching the marker, and
+            // both `manifest.version` + the resolved-variable set stay identical,
+            // so the recomputed `installHash` still matches. Without this guard
+            // the next install silently treats the modified body as "unchanged"
+            // and the consumer drifts from the source-of-truth template.
+            const currentBody = readFileSync(absTarget, "utf8");
+            const currentWithoutMarker = stripInstallMarker(currentBody).trim();
+            const newWithoutMarker = stripInstallMarker(finalBody).trim();
+            if (currentWithoutMarker === newWithoutMarker) {
+                files.push({
+                    relTarget: r.target,
+                    absoluteTarget: absTarget,
+                    action: "unchanged",
+                });
+                continue;
+            }
+            if (!options.force) {
+                files.push({
+                    relTarget: r.target,
+                    absoluteTarget: absTarget,
+                    action: "skipped",
+                    reason: "rendered file body has been hand-edited (install-hash matches but content differs from the upstream template). Re-run with --force to overwrite.",
+                });
+                continue;
+            }
+        }
+        mkdirSync(dirname(absTarget), { recursive: true });
+        writeFileSync(absTarget, finalBody, "utf8");
+        files.push({
+            relTarget: r.target,
+            absoluteTarget: absTarget,
+            action: exists ? "updated" : "created",
+        });
+    }
+    return {
+        skillName: manifest.name,
+        manifestVersion: manifest.version,
+        configPath: loaded.configPath,
+        configIsDefault: loaded.isDefault,
+        resolvedVariables,
+        files,
+    };
+}
+//# sourceMappingURL=install.js.map