@dougharness/cli 1.0.1

package/dist/generate/settings.js

@@ -0,0 +1,213 @@
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+// Merges Doug's hooks and a minimal permission allowlist into an existing .claude/settings.json.
+// The hook wiring itself is derived from plugins/doug-gates/hooks/hooks.json (see dougHooks below), not
+// hardcoded here, so the two can no longer drift (card generated-settings-wiring-drift). Hook commands point
+// at the vendored copy under .doug/hooks so the project is self-contained.
+export const HOOK_MARK = "\"$CLAUDE_PROJECT_DIR/.doug/hooks/scripts/";
+export const STATUSLINE_COMMAND = "node .doug/hooks/scripts/statusline.mjs";
+// Card no-nested-agents-gate: Claude Code's per-project subagent spawn depth (settings.md, sub-agents.md).
+export const SUBAGENT_DEPTH_ENV = "CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH";
+function cmd(script) {
+    return `node "$CLAUDE_PROJECT_DIR/.doug/hooks/scripts/${script}.mjs"`;
+}
+// Locates the gates package (scripts + lib + hooks.json) to vendor into the project.
+export function gatesSourceDir() {
+    const require = createRequire(import.meta.url);
+    const pkg = require.resolve("@dougharness/gates/package.json");
+    return dirname(pkg);
+}
+// The plugin's command form: node "${CLAUDE_PLUGIN_ROOT}/scripts/<name>.mjs".
+const PLUGIN_COMMAND_RE = /^node "\$\{CLAUDE_PLUGIN_ROOT\}\/scripts\/([A-Za-z0-9_-]+)\.mjs"$/;
+// Rewrites one plugin-form command into the vendored form a generated project actually runs (cmd()'s shape).
+// A command that isn't the plugin form throws rather than being dropped or copied through verbatim: a literal
+// ${CLAUDE_PLUGIN_ROOT} in a project's settings.json would be a broken hook, so a future hooks.json entry that
+// doesn't fit this shape has to be loud, not silently absent.
+function vendoredCommand(pluginCommand, event, index, path) {
+    const m = PLUGIN_COMMAND_RE.exec(pluginCommand);
+    if (!m) {
+        throw new Error(`doug init: the ${event} hook ${index} in ${path} command is not the plugin form ` +
+            `(node "\${CLAUDE_PLUGIN_ROOT}/scripts/<name>.mjs"): ${JSON.stringify(pluginCommand)}. ` +
+            `Fix the command in the gates package.`);
+    }
+    return cmd(m[1]);
+}
+// Renders a value for a "found X" error message. `undefined` reads as "absent" (JSON.stringify(undefined) is
+// undefined, not a string, which produced the "...: undefined" gap this hardening fixes); everything else is
+// its JSON text, so a string comes back quoted and a number or a stray object is unambiguous.
+function describeValue(v) {
+    return v === undefined ? "absent" : JSON.stringify(v);
+}
+// Renders a value's shape for a "found X" message about structure (an array vs. an object vs. a primitive)
+// rather than about one field's exact value - used where the message is about what kind of thing was found,
+// not what it equals.
+function describeShape(v) {
+    if (v === undefined)
+        return "undefined";
+    if (v === null)
+        return "null";
+    if (Array.isArray(v))
+        return "an array";
+    if (typeof v === "object")
+        return "an object";
+    return `${typeof v} ${JSON.stringify(v)}`;
+}
+// Reads and JSON-parses hooks.json, turning the two failures that aren't about the hooks shape itself (an
+// unreadable file, invalid JSON) into a message that names the file and says what to do, instead of letting a
+// raw fs or parser error reach bin.ts's generic "doug: <stack>" printer.
+function readHooksJsonFile(path) {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new Error(`doug init: cannot read ${path}: ${msg}. The @dougharness/gates package is incomplete; reinstall it.`);
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new Error(`doug init: ${path} is not valid JSON: ${msg}. Fix the file in the gates package.`);
+    }
+}
+// Derives the hook wiring a generated project gets from plugins/doug-gates/hooks/hooks.json, the same
+// declaration the plugin itself runs from. Checked field by field (card generated-settings-wiring-drift): the
+// two describe the same 8 events, the same groups in the same order, the same matchers, scripts, and timeouts.
+// They differ in exactly one way that has to survive the derivation, plus three things that are legitimately
+// out of its scope:
+//   1. Command prefix: the plugin form points at "${CLAUDE_PLUGIN_ROOT}/scripts/<x>.mjs"; a generated project
+//      needs "$CLAUDE_PROJECT_DIR/.doug/hooks/scripts/<x>.mjs" (the vendored copy, so the project is
+//      self-contained). vendoredCommand() above performs this one rewrite and nothing else.
+//   2. The status line is a settings key, not a hook. hooks.json declares no statusline hook and must not;
+//      STATUSLINE_COMMAND and the statusLine handling in mergeSettings stay outside this derivation.
+//   3. permissions are settings-only and stay outside this derivation too.
+//   4. No hook is excluded from a generated project today: every script hooks.json declares belongs in a
+//      generated project. If that ever stops being true, the exclusion has to be an explicit named list here,
+//      not a loosened comparison against hooks.json.
+//   5. env (card no-nested-agents-gate: CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH) is settings-only too, like
+//      statusLine and permissions; it stays outside this derivation.
+export function dougHooks(gatesDir = gatesSourceDir()) {
+    const path = join(gatesDir, "hooks/hooks.json");
+    const doc = readHooksJsonFile(path);
+    // The whole document not being an object (an array, a string, a number, ...) is a different problem from an
+    // object that merely lacks a "hooks" key, and needs its own message: describeShape(doc) would otherwise
+    // describe the missing property, not the document itself, and print the confusing "found undefined" this
+    // check exists to avoid.
+    if (doc === null || typeof doc !== "object" || Array.isArray(doc)) {
+        throw new Error(`doug init: ${path} is not a JSON object (found ${describeShape(doc)}); the file must have the shape ` +
+            `{ "hooks": { "<Event>": [ { "matcher"?: ..., "hooks": [ ... ] } ] } }.`);
+    }
+    const hooksVal = doc.hooks;
+    if (hooksVal === undefined || hooksVal === null || typeof hooksVal !== "object" || Array.isArray(hooksVal)) {
+        throw new Error(`doug init: ${path} has no "hooks" object (found ${describeShape(hooksVal)}); the file must have the shape ` +
+            `{ "hooks": { "<Event>": [ { "matcher"?: ..., "hooks": [ ... ] } ] } }.`);
+    }
+    const out = {};
+    for (const [event, groupsVal] of Object.entries(hooksVal)) {
+        if (!Array.isArray(groupsVal)) {
+            throw new Error(`doug init: ${path}'s "${event}" hook event is not an array (found ${describeShape(groupsVal)}); ` +
+                `each event must be an array of hook groups.`);
+        }
+        out[event] = groupsVal.map((groupVal, gi) => {
+            if (groupVal === null || typeof groupVal !== "object" || Array.isArray(groupVal)) {
+                throw new Error(`doug init: the "${event}" hook group ${gi} in ${path} is not an object (found ${describeShape(groupVal)}); ` +
+                    `each group must be an object with a "hooks" array (and an optional "matcher").`);
+            }
+            const group = groupVal;
+            if (!Array.isArray(group.hooks)) {
+                throw new Error(`doug init: the "${event}" hook group ${gi} in ${path} has no "hooks" array (found ${describeShape(group.hooks)}); ` +
+                    `each group must have a "hooks": [ ... ] array of hook objects.`);
+            }
+            const hooks = group.hooks.map((hookVal, hi) => {
+                if (hookVal === null || typeof hookVal !== "object" || Array.isArray(hookVal)) {
+                    throw new Error(`doug init: the ${event} hook ${hi} in ${path} is not an object (found ${describeShape(hookVal)}).`);
+                }
+                const h = hookVal;
+                // Refuse rather than coerce: an absent type is not a command hook either, so a plugin field the
+                // generator doesn't know how to vendor never gets silently turned into one.
+                if (h.type !== "command") {
+                    throw new Error(`doug init: the ${event} hook ${hi} in ${path} has type ${describeValue(h.type)} but only "command" hooks ` +
+                        `can be vendored into a project; a prompt, agent, http, or mcp_tool hook has no script to copy. ` +
+                        `Change the hook or add vendoring for that type.`);
+                }
+                if (typeof h.command !== "string") {
+                    throw new Error(`doug init: the ${event} hook ${hi} in ${path} has no command string (found ${describeValue(h.command)}).`);
+                }
+                // Pass through, don't validate - this card's decision (hooks-json-read-hardening; the schema facts it's
+                // based on are in docs/research/hooks-json-read-hardening.md, promoted there on landing): every field
+                // the hook carries besides `command` rides along untouched, in hooks.json's key order, because the
+                // generator's job is translating a file the plugin already runs from, not policing it against a schema
+                // it doesn't fully know - Claude Code's handling of a key that isn't documented today is unverified,
+                // and dropping a documented optional field (timeout, if, statusMessage, once, args, async,
+                // asyncRewake, shell) would be exactly the mistranslation this card exists to remove. Spreading h
+                // before overwriting `command` keeps it at its original position rather than moving it to the end.
+                return { ...h, command: vendoredCommand(h.command, event, hi, path) };
+            });
+            // Pass through the group the same way: any extra key (e.g. `if`) survives untouched, and `hooks` is
+            // overwritten in place so it keeps hooks.json's own key order (matcher before hooks) rather than being
+            // rebuilt - which also keeps "absent stays absent": a matcher-less group here has no `matcher` key at
+            // all, never an explicit `"matcher": undefined`, because JSON has no way to declare one.
+            return { ...group, hooks };
+        });
+    }
+    return out;
+}
+function isDougEntry(e) {
+    return e.hooks.some((h) => h.command && h.command.includes(".doug/hooks/scripts/"));
+}
+export function permissionAllow(d, cfg) {
+    const out = new Set();
+    for (const c of Object.values(cfg.commands)) {
+        // "pnpm test" -> Bash(pnpm test *) so flags and file args are allowed.
+        out.add(`Bash(${c} *)`);
+        out.add(`Bash(${c})`);
+    }
+    if (d.node.packageManager) {
+        const pm = d.node.packageManager;
+        out.add(`Bash(${pm} exec *)`);
+        if (pm === "npm")
+            out.add("Bash(npx *)");
+    }
+    if (d.node.singleTestCommand) {
+        const bin = d.node.singleTestCommand.split(" <")[0];
+        out.add(`Bash(${bin} *)`);
+    }
+    if (d.python.present && d.python.singleTestCommand) {
+        const bin = d.python.singleTestCommand.split(" <")[0];
+        out.add(`Bash(${bin} *)`);
+    }
+    out.add("Bash(git status *)");
+    out.add("Bash(git diff *)");
+    out.add("Bash(git log *)");
+    return [...out];
+}
+export function mergeSettings(existing, d, cfg, gatesDir = gatesSourceDir()) {
+    const s = existing ? JSON.parse(JSON.stringify(existing)) : {};
+    s.hooks = s.hooks || {};
+    for (const [event, entries] of Object.entries(dougHooks(gatesDir))) {
+        const kept = (s.hooks[event] || []).filter((e) => !isDougEntry(e));
+        s.hooks[event] = [...kept, ...entries];
+    }
+    if (!s.statusLine || (typeof s.statusLine.command === "string" && s.statusLine.command.includes(".doug/hooks/scripts/statusline.mjs"))) {
+        s.statusLine = { type: "command", command: STATUSLINE_COMMAND };
+    }
+    s.permissions = s.permissions || {};
+    const allow = new Set(s.permissions.allow || []);
+    for (const rule of permissionAllow(d, cfg))
+        allow.add(rule);
+    s.permissions.allow = [...allow];
+    const deny = new Set(s.permissions.deny || []);
+    deny.add("Read(./.env)");
+    deny.add("Read(./.env.*)");
+    s.permissions.deny = [...deny];
+    // Treat a missing cfg.subagents (an older config.json) as the default 1.
+    const maxSpawnDepth = cfg.subagents ? cfg.subagents.maxSpawnDepth : 1;
+    if (maxSpawnDepth !== null) {
+        s.env = { ...(s.env || {}), [SUBAGENT_DEPTH_ENV]: String(maxSpawnDepth) };
+    }
+    return s;
+}
+//# sourceMappingURL=settings.js.map

package/dist/generate/settings.js.map

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

package/dist/generate/skills.d.ts

@@ -0,0 +1,8 @@
+import type { Detection } from "../detect/types.js";
+import type { DougConfig } from "./config.js";
+export interface SkillFile {
+    path: string;
+    content: string;
+}
+export declare function generateSkills(d: Detection, cfg: DougConfig): SkillFile[];
+export declare function isDougSkill(text: string): boolean;

package/dist/generate/skills.js

@@ -0,0 +1,264 @@
+import { runScript } from "../detect/node.js";
+import { AGENT_MARK } from "./agents.js";
+const PROJECT_NOTES_HEADING = "## Project notes";
+function bashPair(command) {
+    return [`Bash(${command} *)`, `Bash(${command})`];
+}
+// The permission tokens must come from the command text before its placeholder: a literal
+// `<path/to/file.test.ts>` in a Bash rule can never match. Returns the joined prefix of tokens
+// before the first token containing `<`, the whole command when there is no such token, or null
+// when the command begins with the placeholder token.
+function permissionPrefix(command) {
+    const tokens = command.split(/\s+/);
+    const idx = tokens.findIndex((t) => t.includes("<"));
+    if (idx === 0)
+        return null;
+    if (idx === -1)
+        return command;
+    return tokens.slice(0, idx).join(" ");
+}
+function firstScript(scripts, names) {
+    for (const name of names) {
+        if (Object.prototype.hasOwnProperty.call(scripts, name))
+            return name;
+    }
+    return null;
+}
+function renderSkill(spec) {
+    const lines = [];
+    lines.push("---");
+    lines.push(`name: ${spec.name}`);
+    lines.push(`description: ${JSON.stringify(spec.description)}`);
+    lines.push(`allowed-tools: ${spec.allowedTools}`);
+    if (spec.manualOnly)
+        lines.push("disable-model-invocation: true");
+    lines.push("metadata:");
+    lines.push(`  ${AGENT_MARK}`);
+    lines.push("---");
+    lines.push("");
+    lines.push("## Commands");
+    lines.push("");
+    lines.push("```sh");
+    for (const c of spec.commands.lines)
+        lines.push(c);
+    lines.push("```");
+    lines.push("");
+    if (spec.steps) {
+        lines.push("## Steps");
+        lines.push("");
+        spec.steps.forEach((s, i) => lines.push(`${i + 1}. ${s}`));
+        lines.push("");
+    }
+    lines.push("## Rules");
+    lines.push("");
+    for (const r of spec.rules)
+        lines.push(`- ${r}`);
+    lines.push("");
+    lines.push(PROJECT_NOTES_HEADING);
+    return lines.join("\n") + "\n";
+}
+export function generateSkills(d, cfg) {
+    const n = d.node;
+    const pm = n.packageManager ?? "npm";
+    const files = [];
+    // 1. run
+    const runScriptName = firstScript(n.scripts, ["dev", "start", "serve"]);
+    if (runScriptName) {
+        const command = runScript(pm, runScriptName);
+        files.push({
+            path: ".claude/skills/run/SKILL.md",
+            content: renderSkill({
+                name: "run",
+                description: `Starts the project's dev server with its \`${runScriptName}\` script`,
+                allowedTools: [...bashPair(command), "Read", "Grep", "Glob"].join(" "),
+                manualOnly: false,
+                commands: { kind: "sh", lines: [command] },
+                steps: null,
+                rules: [
+                    "Run the command and report what it prints.",
+                    "Stop the server before finishing when it does not exit on its own.",
+                ],
+            }),
+        });
+    }
+    // 2. test
+    if (cfg.commands.test) {
+        const command = cfg.commands.test;
+        files.push({
+            path: ".claude/skills/test/SKILL.md",
+            content: renderSkill({
+                name: "test",
+                description: "Runs the project's test suite",
+                allowedTools: [...bashPair(command), "Edit", "Write", "Read", "Grep", "Glob"].join(" "),
+                manualOnly: false,
+                commands: { kind: "sh", lines: [command] },
+                steps: null,
+                rules: [
+                    "Run the full suite and report the real exit status.",
+                    "Add or update a test with the change; never delete one to make it pass.",
+                ],
+            }),
+        });
+    }
+    // 3. migrate
+    const migrationDirs = d.python.present
+        ? [...new Set([...d.repo.migrationDirs, ...d.python.migrationDirs])].sort()
+        : d.repo.migrationDirs;
+    if (migrationDirs.length) {
+        const migrateScriptName = firstScript(n.scripts, ["migrate", "db:migrate", "migrate:dev", "prisma:migrate"]);
+        const command = migrateScriptName ? runScript(pm, migrateScriptName) : null;
+        const dirs = migrationDirs.join(", ");
+        files.push({
+            path: ".claude/skills/migrate/SKILL.md",
+            content: renderSkill({
+                name: "migrate",
+                description: "Runs the project's database migrations",
+                allowedTools: (command ? [...bashPair(command), "Read", "Grep", "Glob"] : ["Read", "Grep", "Glob"]).join(" "),
+                manualOnly: true,
+                commands: command
+                    ? { kind: "sh", lines: [command] }
+                    : {
+                        kind: "sh",
+                        lines: ["# No migration script was detected; use the project's own migration tool."],
+                    },
+                steps: command
+                    ? [`List migration directories: ${dirs}.`, `Run \`${command}\`.`, "Verify the migration applied cleanly."]
+                    : [
+                        `List migration directories: ${dirs}.`,
+                        "Use the project's own migration tool to apply pending migrations.",
+                        "Verify the migration applied cleanly.",
+                    ],
+                rules: ["Never hand-edit a migration file already applied.", "Report what ran and its result."],
+            }),
+        });
+    }
+    // 4. release
+    const releaseScriptName = firstScript(n.scripts, ["release", "publish", "version"]);
+    if (releaseScriptName) {
+        const command = runScript(pm, releaseScriptName);
+        files.push({
+            path: ".claude/skills/release/SKILL.md",
+            content: renderSkill({
+                name: "release",
+                description: `Runs the project's release with its \`${releaseScriptName}\` script`,
+                allowedTools: [...bashPair(command), "Read", "Grep", "Glob"].join(" "),
+                manualOnly: true,
+                commands: { kind: "sh", lines: [command] },
+                steps: ["Confirm the working tree is clean.", `Run \`${command}\`.`, "Verify the release published."],
+                rules: ["Never release from a dirty working tree.", "Report what ran and its result."],
+            }),
+        });
+    }
+    // 5. pr
+    if (d.repo.isGit) {
+        const base = d.repo.defaultBranch;
+        const pushCmd = "git push -u origin HEAD";
+        const prCmd = base ? `gh pr create --base ${base} --fill` : "gh pr create --fill";
+        files.push({
+            path: ".claude/skills/pr/SKILL.md",
+            content: renderSkill({
+                name: "pr",
+                description: "Opens a pull request for the current branch",
+                allowedTools: [
+                    ...["git status", "git diff", "git log", "git add", "git commit", "git push", "gh pr create"].flatMap(bashPair),
+                    "Read",
+                    "Grep",
+                    "Glob",
+                ].join(" "),
+                manualOnly: true,
+                commands: {
+                    kind: "sh",
+                    lines: ["git status", "git diff", "git log", "git add <files>", 'git commit -m "<message>"', pushCmd, prCmd],
+                },
+                steps: [
+                    "Check status with `git status`.",
+                    "Review the diff with `git diff` and the history with `git log`.",
+                    "Stage and commit with `git add` and `git commit`.",
+                    `Push with \`${pushCmd}\`.`,
+                    `Open the PR with \`${prCmd}\`${base ? ` against \`${base}\`` : ""}.`,
+                ],
+                rules: ["Never force-push.", "Report the PR URL when it opens."],
+            }),
+        });
+    }
+    // 6. preflight
+    if (cfg.stopGate.commands.length) {
+        const gateCommands = cfg.stopGate.commands.map((name) => cfg.commands[name]);
+        const scriptInvocation = 'bash "${CLAUDE_SKILL_DIR}/scripts/preflight.sh"';
+        files.push({
+            path: ".claude/skills/preflight/SKILL.md",
+            content: renderSkill({
+                name: "preflight",
+                description: "Runs the project's gate commands in order before finishing",
+                allowedTools: [...gateCommands.flatMap(bashPair), "Bash(bash *)", "Read", "Grep", "Glob"].join(" "),
+                manualOnly: true,
+                commands: { kind: "sh", lines: [scriptInvocation] },
+                steps: gateCommands.map((c) => `Run \`${c}\`.`),
+                rules: ["Run every gate command; do not skip one to save time.", "Report each command's real exit status."],
+            }),
+        });
+        const scriptLines = ["#!/usr/bin/env bash", `# ${AGENT_MARK}`, "set -euo pipefail"];
+        for (const c of gateCommands) {
+            scriptLines.push(`echo "Running: ${c}"`);
+            scriptLines.push(c);
+        }
+        files.push({ path: ".claude/skills/preflight/scripts/preflight.sh", content: scriptLines.join("\n") + "\n" });
+    }
+    // 7. characterization-test
+    if (n.testFramework || d.python.testFramework) {
+        const pythonOnly = !n.testFramework;
+        const named = pythonOnly
+            ? [d.python.singleTestCommand, d.python.present ? (cfg.commands["py:test"] ?? cfg.commands.test) : null].filter((c) => !!c)
+            : [n.singleTestCommand, cfg.commands.test].filter((c) => !!c);
+        const frameworkName = pythonOnly ? "pytest" : n.testFramework;
+        const permissionPrefixes = [...new Set(named.map(permissionPrefix).filter((p) => p !== null))];
+        files.push({
+            path: ".claude/skills/characterization-test/SKILL.md",
+            content: renderSkill({
+                name: "characterization-test",
+                description: `Writes a characterization test with ${frameworkName} that pins current behavior`,
+                allowedTools: [...permissionPrefixes.flatMap(bashPair), "Edit", "Write", "Read", "Grep", "Glob"].join(" "),
+                manualOnly: false,
+                commands: { kind: "sh", lines: named },
+                steps: null,
+                rules: [
+                    "Run the single-test command after writing the test.",
+                    "Never delete or weaken the test to make it pass.",
+                ],
+            }),
+        });
+    }
+    // 8. doug-skills (always generated, manual-only, the refresh path)
+    files.push({
+        path: ".claude/skills/doug-skills/SKILL.md",
+        content: renderSkill({
+            name: "doug-skills",
+            description: "Refreshes this project's generated skills and agents by re-running doug init",
+            allowedTools: "Bash(doug init*)",
+            manualOnly: true,
+            commands: { kind: "sh", lines: ["doug init --dry-run", "doug init --yes"] },
+            steps: [
+                "Run `doug init --dry-run` in the project directory to print the proposal.",
+                "Show the proposal to the user.",
+                "Run `doug init --yes` only after the user says yes.",
+            ],
+            rules: [
+                "This is how the skills above appear once the project has code the detectors can see.",
+                "Never invent another doug init flag.",
+            ],
+        }),
+    });
+    return files;
+}
+export function isDougSkill(text) {
+    const withoutBom = text.startsWith("") ? text.slice(1) : text;
+    const lines = withoutBom.split("\n").map((l) => (l.endsWith("\r") ? l.slice(0, -1) : l));
+    if (lines[0] === "---") {
+        const closingIdx = lines.indexOf("---", 1);
+        if (closingIdx > 0) {
+            return lines.slice(0, closingIdx).some((l) => l.trim() === AGENT_MARK);
+        }
+    }
+    return lines.slice(0, 5).some((l) => l.trim() === `# ${AGENT_MARK}`);
+}
+//# sourceMappingURL=skills.js.map

package/dist/generate/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/generate/skills.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAWzC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAYjD,SAAS,QAAQ,CAAC,OAAe;IAC/B,OAAO,CAAC,QAAQ,OAAO,KAAK,EAAE,QAAQ,OAAO,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,0FAA0F;AAC1F,+FAA+F;AAC/F,gGAAgG;AAChG,sDAAsD;AACtD,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/B,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,WAAW,CAAC,OAA+B,EAAE,KAAe;IACnE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,IAAe;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAClD,IAAI,IAAI,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;IAClE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC,CAAC;IAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACpB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACjD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAY,EAAE,GAAe;IAC1D,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;IACjB,MAAM,EAAE,GAAG,CAAC,CAAC,cAAc,IAAI,KAAK,CAAC;IACrC,MAAM,KAAK,GAAgB,EAAE,CAAC;IAE9B,SAAS;IACT,MAAM,aAAa,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACxE,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,EAAE,aAAa,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,6BAA6B;YACnC,OAAO,EAAE,WAAW,CAAC;gBACnB,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,8CAA8C,aAAa,WAAW;gBACnF,YAAY,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACtE,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE;gBAC1C,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE;oBACL,4CAA4C;oBAC5C,oEAAoE;iBACrE;aACF,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,UAAU;IACV,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE,WAAW,CAAC;gBACnB,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,+BAA+B;gBAC5C,YAAY,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACvF,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE;gBAC1C,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE;oBACL,qDAAqD;oBACrD,yEAAyE;iBAC1E;aACF,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,aAAa;IACb,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO;QACpC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;QAC3E,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;IACzB,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,iBAAiB,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC7G,MAAM,OAAO,GAAG,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,iCAAiC;YACvC,OAAO,EAAE,WAAW,CAAC;gBACnB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,wCAAwC;gBACrD,YAAY,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBAC7G,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,OAAO;oBACf,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE;oBAClC,CAAC,CAAC;wBACE,IAAI,EAAE,IAAI;wBACV,KAAK,EAAE,CAAC,2EAA2E,CAAC;qBACrF;gBACL,KAAK,EAAE,OAAO;oBACZ,CAAC,CAAC,CAAC,+BAA+B,IAAI,GAAG,EAAE,SAAS,OAAO,KAAK,EAAE,uCAAuC,CAAC;oBAC1G,CAAC,CAAC;wBACE,+BAA+B,IAAI,GAAG;wBACtC,mEAAmE;wBACnE,uCAAuC;qBACxC;gBACL,KAAK,EAAE,CAAC,mDAAmD,EAAE,iCAAiC,CAAC;aAChG,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,aAAa;IACb,MAAM,iBAAiB,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IACpF,IAAI,iBAAiB,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,iCAAiC;YACvC,OAAO,EAAE,WAAW,CAAC;gBACnB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,yCAAyC,iBAAiB,WAAW;gBAClF,YAAY,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACtE,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE;gBAC1C,KAAK,EAAE,CAAC,oCAAoC,EAAE,SAAS,OAAO,KAAK,EAAE,+BAA+B,CAAC;gBACrG,KAAK,EAAE,CAAC,0CAA0C,EAAE,iCAAiC,CAAC;aACvF,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,QAAQ;IACR,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;QAClC,MAAM,OAAO,GAAG,yBAAyB,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,uBAAuB,IAAI,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC;QAClF,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,4BAA4B;YAClC,OAAO,EAAE,WAAW,CAAC;gBACnB,IAAI,EAAE,IAAI;gBACV,WAAW,EAAE,6CAA6C;gBAC1D,YAAY,EAAE;oBACZ,GAAG,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,OAAO,CACnG,QAAQ,CACT;oBACD,MAAM;oBACN,MAAM;oBACN,MAAM;iBACP,CAAC,IAAI,CAAC,GAAG,CAAC;gBACX,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE;oBACR,IAAI,EAAE,IAAI;oBACV,KAAK,EAAE,CAAC,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,OAAO,EAAE,KAAK,CAAC;iBAC7G;gBACD,KAAK,EAAE;oBACL,iCAAiC;oBACjC,iEAAiE;oBACjE,mDAAmD;oBACnD,eAAe,OAAO,KAAK;oBAC3B,sBAAsB,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG;iBACtE;gBACD,KAAK,EAAE,CAAC,mBAAmB,EAAE,kCAAkC,CAAC;aACjE,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,eAAe;IACf,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7E,MAAM,gBAAgB,GAAG,iDAAiD,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,mCAAmC;YACzC,OAAO,EAAE,WAAW,CAAC;gBACnB,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,4DAA4D;gBACzE,YAAY,EAAE,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBACnG,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,gBAAgB,CAAC,EAAE;gBACnD,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC;gBAC/C,KAAK,EAAE,CAAC,uDAAuD,EAAE,yCAAyC,CAAC;aAC5G,CAAC;SACH,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,CAAC,qBAAqB,EAAE,KAAK,UAAU,EAAE,EAAE,mBAAmB,CAAC,CAAC;QACpF,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;YACzC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,+CAA+C,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IAChH,CAAC;IAED,2BAA2B;IAC3B,IAAI,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC;QACpC,MAAM,KAAK,GAAG,UAAU;YACtB,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAC3G,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CACxB;YACH,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,aAAa,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;QAC9D,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5G,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,+CAA+C;YACrD,OAAO,EAAE,WAAW,CAAC;gBACnB,IAAI,EAAE,uBAAuB;gBAC7B,WAAW,EAAE,uCAAuC,aAAa,6BAA6B;gBAC9F,YAAY,EAAE,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;gBAC1G,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE;gBACtC,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE;oBACL,qDAAqD;oBACrD,kDAAkD;iBACnD;aACF,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,IAAI,CAAC;QACT,IAAI,EAAE,qCAAqC;QAC3C,OAAO,EAAE,WAAW,CAAC;YACnB,IAAI,EAAE,aAAa;YACnB,WAAW,EAAE,8EAA8E;YAC3F,YAAY,EAAE,kBAAkB;YAChC,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,qBAAqB,EAAE,iBAAiB,CAAC,EAAE;YAC3E,KAAK,EAAE;gBACL,2EAA2E;gBAC3E,gCAAgC;gBAChC,qDAAqD;aACtD;YACD,KAAK,EAAE;gBACL,sFAAsF;gBACtF,sCAAsC;aACvC;SACF,CAAC;KACH,CAAC,CAAC;IAEH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzF,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3C,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,UAAU,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK,UAAU,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/init.d.ts

@@ -0,0 +1,10 @@
+export interface InitOptions {
+    dir: string;
+    yes: boolean;
+    dryRun: boolean;
+    color: boolean;
+    quiet: boolean;
+    /** Skip the vendored hook file diffs in the printout (they are long and identical every time). */
+    showHookFiles: boolean;
+}
+export declare function runInit(opts: InitOptions): Promise<number>;

package/dist/init.js

@@ -0,0 +1,69 @@
+import { createInterface } from "node:readline";
+import { resolve } from "node:path";
+import { detect } from "./detect/index.js";
+import { buildProposal, summarize } from "./generate/proposal.js";
+import { renderDiff } from "./diff.js";
+import { applyChanges } from "./apply.js";
+async function confirm(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((res) => rl.question(question, res));
+    rl.close();
+    return /^y(es)?$/i.test(answer.trim());
+}
+export async function runInit(opts) {
+    const dir = resolve(opts.dir);
+    const log = (s) => {
+        if (!opts.quiet)
+            process.stdout.write(s + "\n");
+    };
+    const detection = detect(dir);
+    const proposal = buildProposal(detection);
+    log("");
+    log("Detected:");
+    log(summarize(proposal));
+    if (proposal.notes.length) {
+        log("");
+        log("Notes:");
+        for (const n of proposal.notes)
+            log(`  - ${n}`);
+    }
+    log("");
+    if (proposal.changes.length === 0) {
+        log("Nothing to change. The project is already configured.");
+        return 0;
+    }
+    const hookFiles = proposal.changes.filter((c) => c.path.startsWith(".doug/hooks/"));
+    const visible = proposal.changes.filter((c) => opts.showHookFiles || !c.path.startsWith(".doug/hooks/"));
+    log(`Proposed changes (${proposal.changes.length} files):`);
+    log("");
+    for (const c of visible) {
+        log(renderDiff(c, { color: opts.color }));
+        log("");
+    }
+    if (!opts.showHookFiles && hookFiles.length) {
+        log(`create  .doug/hooks/  (${hookFiles.length} vendored hook files from @dougharness/gates; pass --show-hooks to print them)`);
+        log("");
+    }
+    if (opts.dryRun) {
+        log("Dry run. Nothing written.");
+        return 0;
+    }
+    if (!opts.yes) {
+        if (!process.stdin.isTTY) {
+            log("Not a TTY and --yes not given. Nothing written.");
+            return 2;
+        }
+        const ok = await confirm("Apply these changes? [y/N] ");
+        if (!ok) {
+            log("Aborted. Nothing written.");
+            return 1;
+        }
+    }
+    const written = applyChanges(dir, proposal.changes);
+    log(`Wrote ${written.length} files.`);
+    log("");
+    log("Next: open Claude Code in this directory. Hooks are active immediately.");
+    log("      Edit CLAUDE.md's Gotchas section by hand; keep the file short.");
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY1C,KAAK,UAAU,OAAO,CAAC,QAAgB;IACrC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAW,MAAM,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9E,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAiB;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE;QACxB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,QAAQ,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAE1C,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,GAAG,CAAC,WAAW,CAAC,CAAC;IACjB,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IACzB,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC1B,GAAG,CAAC,EAAE,CAAC,CAAC;QACR,GAAG,CAAC,QAAQ,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK;YAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,GAAG,CAAC,EAAE,CAAC,CAAC;IAER,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QAC7D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IACpF,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IACzG,GAAG,CAAC,qBAAqB,QAAQ,CAAC,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC;IAC5D,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC1C,GAAG,CAAC,EAAE,CAAC,CAAC;IACV,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;QAC5C,GAAG,CAAC,0BAA0B,SAAS,CAAC,MAAM,gFAAgF,CAAC,CAAC;QAChI,GAAG,CAAC,EAAE,CAAC,CAAC;IACV,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACjC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,iDAAiD,CAAC,CAAC;YACvD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,6BAA6B,CAAC,CAAC;QACxD,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACjC,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACpD,GAAG,CAAC,SAAS,OAAO,CAAC,MAAM,SAAS,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,GAAG,CAAC,yEAAyE,CAAC,CAAC;IAC/E,GAAG,CAAC,sEAAsE,CAAC,CAAC;IAC5E,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/trace.d.ts

@@ -0,0 +1,9 @@
+import { type TraceLine } from "@dougharness/gates/lib/trace.mjs";
+export interface TraceIo {
+    stdout(s: string): void;
+    stderr(s: string): void;
+}
+export declare const TRACE_USAGE = "Usage:\n  doug trace [dir] [--session <id>] [--json]\n\nReplays the newest trace under <dir>/.doug/.state/trace (or the session named by --session) and attributes\nevents, tool calls, wall time, and tokens to each agent. Tokens come only from what Claude Code reported at\nSubagentStop; the main session and anything unreported show null.\n";
+export declare function pickTraceFile(traceDir: string, session: string | null): string | null;
+export declare function renderTrace(session: string, file: string, lines: TraceLine[]): string;
+export declare function runTrace(argv: string[], io?: TraceIo): Promise<number>;