domain-knowledge-kit 0.2.16 → 0.2.19

package/dist/features/agent/commands/update.js

@@ -0,0 +1,316 @@
+import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { spawnSync, execFileSync } from "node:child_process";
+import { createInterface } from "node:readline";
+import { join } from "node:path";
+import { repoRoot, packageClaudeDir } from "../../../shared/paths.js";
+import { formatCliError } from "../../../shared/errors.js";
+import { pkgVersion, pkgName } from "../../../version.js";
+import { installClaudeConfig, installSkills, mergeClaudeSettings, refreshAgentsMd, } from "./init.js";
+import { computeArtifactDiff, dkkHookBasenames, dkkPermissionAllowEntries, scanInstalledArtifacts, } from "../dkk-artifacts.js";
+import { detectInstallMode, fetchLatestVersion } from "../install-mode.js";
+import { pruneDkkEntries } from "../settings-prune.js";
+import { ensureMcpRegistered } from "../mcp-register.js";
+/** Register the `update` subcommand. */
+export function registerUpdate(program) {
+    program
+        .command("update")
+        .description("Upgrade dkk and refresh DKK-managed artifacts (.claude/, .github/skills/, AGENTS.md, MCP) in this project")
+        .option("-y, --yes", "Skip interactive confirmation for the artifact diff")
+        .option("--check", "Dry-run: print the diff + plan but make no changes")
+        .option("--skip-npm", "Don't run npm upgrade (use the already-installed version)")
+        .option("--skip-artifacts", "Don't sweep/reinstall .claude/ and .github/skills/ files")
+        .option("--skip-mcp", "Don't auto-register the DKK MCP server")
+        .option("-r, --root <path>", "Override repository root")
+        .option("--post-upgrade", "Internal: re-exec phase after self-upgrade", false)
+        .action(async (opts) => {
+        try {
+            await runUpdate(opts);
+        }
+        catch (err) {
+            console.error(`Error: ${formatCliError(err)}`);
+            process.exit(1);
+        }
+    });
+}
+async function runUpdate(opts) {
+    const root = repoRoot(opts.root);
+    // ── Phase A: Pre-flight ─────────────────────────────────────────────
+    // .dkk/ must exist — `update` is project-scoped and only meaningful
+    // for repos that have already adopted DKK.
+    if (!existsSync(join(root, ".dkk"))) {
+        console.error(`Error: \`dkk update\` requires a DKK-using project (no .dkk/ found at ${root}).`);
+        console.error(`Hint: run \`dkk init\` first to bootstrap one.`);
+        process.exit(1);
+    }
+    // Skip Phase A/B/C entirely if we're already in the re-exec'd child.
+    if (!opts.postUpgrade) {
+        const install = detectInstallMode();
+        if (install.mode === "npx") {
+            console.error("Error: `dkk update` can't upgrade an npx-launched install.");
+            console.error("Hint: install dkk globally (`npm i -g domain-knowledge-kit`) or as a devDependency, then re-run.");
+            process.exit(1);
+        }
+        const current = pkgVersion;
+        const latest = opts.skipNpm ? current : fetchLatestVersion();
+        if (opts.skipNpm) {
+            console.log(`dkk: ${current} (npm upgrade skipped via --skip-npm)`);
+        }
+        else if (latest === null) {
+            console.warn(`Warning: could not contact the npm registry; proceeding without self-upgrade.`);
+        }
+        else if (current === latest) {
+            console.log(`dkk: already on the latest version (${current}).`);
+        }
+        else {
+            console.log(`dkk: ${current} → ${latest} (running npm install…)`);
+            // ── Phase B: Self-upgrade ───────────────────────────────────────
+            const npmArgs = buildNpmInstallArgs(install);
+            const npmResult = spawnSync("npm", npmArgs, { stdio: "inherit" });
+            if (npmResult.status !== 0) {
+                console.error(`Error: npm install failed with exit code ${npmResult.status ?? "unknown"}.`);
+                console.error(`Hint: run \`npm ${npmArgs.join(" ")}\` manually to see the underlying error, then re-run \`dkk update --skip-npm\`.`);
+                process.exit(1);
+            }
+            // ── Phase C: Re-exec onto the new install ───────────────────────
+            const newDkk = resolveDkkBinary(install);
+            if (!newDkk) {
+                console.warn("Warning: could not locate the freshly-installed `dkk` binary; refreshing artifacts using the in-memory templates (may be stale).");
+                // Fall through to phases D–H in the current process. Best-effort.
+            }
+            else {
+                const childArgs = buildReExecArgs(opts);
+                const child = spawnSync(newDkk, ["update", "--post-upgrade", ...childArgs], {
+                    stdio: "inherit",
+                });
+                process.exit(child.status ?? 0);
+            }
+        }
+    }
+    // ── Phase D: Artifact diff + sweep + reinstall ──────────────────────
+    let diffSummary = { added: 0, replaced: 0, removed: 0 };
+    // Track whether settings.json existed before the install path; if it
+    // didn't, Phase E has nothing to prune — installClaudeConfig just wrote
+    // a pristine copy of the template.
+    const settingsExistedBefore = existsSync(join(root, ".claude", "settings.json"));
+    if (!opts.skipArtifacts) {
+        const diff = computeArtifactDiff(root);
+        printArtifactDiff(diff);
+        if (opts.check) {
+            console.log("\n(--check) No changes made. Re-run without --check to apply.");
+            return;
+        }
+        const totalChanges = diff.toAdd.length + diff.toReplace.length + diff.toRemove.length;
+        if (totalChanges === 0) {
+            console.log("Artifacts: already up to date.");
+        }
+        else {
+            if (!opts.yes) {
+                const ok = await confirm(`Proceed with these changes? [y/N] `);
+                if (!ok) {
+                    console.log("Aborted. No changes made.");
+                    return;
+                }
+            }
+            sweepRemovedArtifacts(root);
+            installClaudeConfig(root, /*force*/ true, { skipSettings: true });
+            installSkills(root, /*force*/ true);
+            diffSummary = { added: diff.toAdd.length, replaced: diff.toReplace.length, removed: diff.toRemove.length };
+        }
+    }
+    // ── Phase E: settings.json prune + remerge ──────────────────────────
+    const settingsResult = pruneAndRemergeSettings(root, opts, settingsExistedBefore);
+    // ── Phase F: MCP auto-register ──────────────────────────────────────
+    let mcpOutcome = { status: "skipped", reason: "--skip-mcp" };
+    if (!opts.skipMcp && !opts.check) {
+        mcpOutcome = ensureMcpRegistered(root);
+    }
+    // ── Phase G: AGENTS.md refresh ──────────────────────────────────────
+    let agentsStatus = "skipped";
+    if (!opts.check) {
+        agentsStatus = refreshAgentsMd(root);
+    }
+    // ── Phase H: Summary report ─────────────────────────────────────────
+    printSummary(diffSummary, settingsResult, mcpOutcome, agentsStatus);
+}
+// ── Phase A helpers ───────────────────────────────────────────────────
+function buildNpmInstallArgs(install) {
+    if (install.mode === "global") {
+        return ["install", "-g", `${pkgName}@latest`];
+    }
+    // Local / unknown: install as a devDep into the current cwd. Bumps the
+    // host's package.json so subsequent runs pick up the new version.
+    return ["install", "--save-dev", `${pkgName}@latest`];
+}
+function resolveDkkBinary(install) {
+    // Try the obvious places first; fall back to `which`.
+    const candidates = [];
+    if (install.mode === "global" && install.globalNodeModules) {
+        candidates.push(join(install.globalNodeModules, ".bin", "dkk"));
+    }
+    candidates.push(join(process.cwd(), "node_modules", ".bin", "dkk"));
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    try {
+        const out = execFileSync("which", ["dkk"], {
+            encoding: "utf-8",
+            timeout: 5_000,
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        return out.length > 0 ? out : null;
+    }
+    catch {
+        return null;
+    }
+}
+function buildReExecArgs(opts) {
+    const args = [];
+    if (opts.yes)
+        args.push("--yes");
+    if (opts.check)
+        args.push("--check");
+    if (opts.skipArtifacts)
+        args.push("--skip-artifacts");
+    if (opts.skipMcp)
+        args.push("--skip-mcp");
+    if (opts.root)
+        args.push("--root", opts.root);
+    // --skip-npm is intentionally NOT forwarded: we've just finished the
+    // npm-install step, so a child re-exec should still continue with
+    // artifact refresh (the equivalent of --skip-npm at the child level).
+    return args;
+}
+// ── Phase D helpers ───────────────────────────────────────────────────
+function printArtifactDiff(diff) {
+    console.log("");
+    console.log("Artifact diff against the bundled template:");
+    if (diff.toAdd.length === 0 && diff.toReplace.length === 0 && diff.toRemove.length === 0) {
+        console.log("  (no changes)");
+        return;
+    }
+    for (const p of diff.toAdd)
+        console.log(`  + add      ${p}`);
+    for (const p of diff.toReplace)
+        console.log(`  ~ replace  ${p}`);
+    for (const p of diff.toRemove)
+        console.log(`  - remove   ${p}`);
+}
+function sweepRemovedArtifacts(root) {
+    // Recompute the diff at sweep-time so we delete exactly what we promised.
+    const diff = computeArtifactDiff(root);
+    for (const rel of diff.toRemove) {
+        const abs = join(root, rel);
+        try {
+            rmSync(abs, { recursive: true, force: true });
+            console.log(`Removed  ${rel}`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`Warning: could not remove ${rel}: ${msg}`);
+        }
+    }
+    // Belt-and-suspenders: also sweep any installed dkk-* directory that
+    // isn't in the new template's shipped list (handles the rare case where
+    // `computeArtifactDiff` couldn't recompute the same way — e.g. if a
+    // file was deleted between the two scans). No-op in the normal case.
+    for (const p of scanInstalledArtifacts(root).legacy) {
+        if (existsSync(p)) {
+            try {
+                rmSync(p, { recursive: true, force: true });
+            }
+            catch { /* ignore */ }
+        }
+    }
+}
+function pruneAndRemergeSettings(root, opts, existedBefore) {
+    if (opts.check || opts.skipArtifacts) {
+        return { status: "skipped", pruned: 0, added: 0, mixedWarnings: [] };
+    }
+    const templatePath = join(packageClaudeDir(), "settings.json");
+    if (!existsSync(templatePath)) {
+        return { status: "skipped", pruned: 0, added: 0, mixedWarnings: [] };
+    }
+    const settingsPath = join(root, ".claude", "settings.json");
+    // No existing file → just write the template verbatim. Phase D skipped
+    // settings.json so it's our responsibility to create it.
+    if (!existedBefore) {
+        const raw = readFileSync(templatePath, "utf-8");
+        writeFileSync(settingsPath, raw, "utf-8");
+        console.log(`Created  .claude/settings.json`);
+        return { status: "no-file", pruned: 0, added: 0, mixedWarnings: [] };
+    }
+    let existing;
+    let template;
+    try {
+        existing = JSON.parse(readFileSync(settingsPath, "utf-8"));
+        template = JSON.parse(readFileSync(templatePath, "utf-8"));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.warn(`Warning: could not parse settings.json (${msg}); leaving it untouched.`);
+        return { status: "malformed", pruned: 0, added: 0, mixedWarnings: [] };
+    }
+    const dkkAllow = new Set(dkkPermissionAllowEntries());
+    const dkkHooks = new Set(dkkHookBasenames());
+    const { pruned, removed, mixedHookWarnings } = pruneDkkEntries(existing, dkkAllow, dkkHooks);
+    const { merged, changes } = mergeClaudeSettings(pruned, template);
+    writeFileSync(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
+    for (const w of mixedHookWarnings)
+        console.warn(`Warning: ${w}`);
+    return {
+        status: removed.length > 0 ? "pruned-and-merged" : "merge-only",
+        pruned: removed.length,
+        added: changes.length,
+        mixedWarnings: mixedHookWarnings,
+    };
+}
+// ── Phase H helpers ───────────────────────────────────────────────────
+function printSummary(diff, settings, mcp, agents) {
+    console.log("");
+    console.log("── Summary ────────────────────────────────────────────────────────");
+    console.log(`dkk           ${pkgVersion}`);
+    console.log(`Artifacts     +${diff.added} added, ~${diff.replaced} replaced, -${diff.removed} removed`);
+    console.log(`settings.json ${formatSettingsResult(settings)}`);
+    console.log(`MCP server    ${formatMcpResult(mcp)}`);
+    console.log(`AGENTS.md     ${agents}`);
+    console.log("");
+    console.log("Next: run `dkk render` to validate the domain model.");
+}
+function formatSettingsResult(s) {
+    if (s.status === "no-file")
+        return "(none — created by artifact install)";
+    if (s.status === "skipped")
+        return "skipped";
+    if (s.status === "malformed")
+        return "left untouched (could not parse)";
+    return `pruned ${s.pruned}, added ${s.added}`;
+}
+function formatMcpResult(m) {
+    switch (m.status) {
+        case "already-registered":
+            return `already registered (${m.via === "project" ? ".mcp.json" : "claude CLI"})`;
+        case "registered":
+            return `registered via ${m.via === "claude-cli" ? "`claude mcp add`" : ".mcp.json"}`;
+        case "skipped":
+            return `skipped (${m.reason})`;
+        case "failed":
+            return `failed: ${m.reason} (run \`claude mcp add dkk -- dkk mcp\` manually)`;
+    }
+}
+// ── Confirmation prompt ──────────────────────────────────────────────
+/** Interactive Y/N prompt. Non-TTY stdin defaults to "no" (safer for CI). */
+function confirm(prompt) {
+    if (!process.stdin.isTTY) {
+        console.log(`${prompt}n   (no TTY — defaulting to abort; pass --yes to skip this prompt)`);
+        return Promise.resolve(false);
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(/^y(es)?$/i.test(answer.trim()));
+        });
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/features/agent/commands/update.js.map

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

package/dist/features/agent/dkk-artifacts.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Repo-relative paths that previous DKK versions installed but the current
+ * release no longer ships. `dkk update` removes any of these still present
+ * in a target repo. Append new entries here when a template file is
+ * renamed or retired.
+ */
+export declare const LEGACY_DKK_PATHS: readonly string[];
+export interface ClaudeArtifactInventory {
+    /** `.claude/hooks/<basename>.mjs` filenames the bundled template installs. */
+    hooks: string[];
+    /** `.claude/skills/<skill>/` directories the bundled template installs (matches the `dkk-*` prefix). */
+    skills: string[];
+    /** `.claude/agents/<agent>.md` filenames the bundled template installs. */
+    agents: string[];
+    /** `.claude/commands/<command>.md` filenames the bundled template installs. */
+    commands: string[];
+}
+/**
+ * Walk `tools/dkk/claude/` in the running DKK package and return the set of
+ * artifact basenames the template currently ships. Derived at runtime so
+ * future template additions don't require code changes here.
+ */
+export declare function dkkClaudeFiles(): ClaudeArtifactInventory;
+/**
+ * Skill directories the bundled `.github/skills/` template installs (e.g.
+ * `dkk-flow-implementer`). Returned as bare directory names.
+ */
+export declare function dkkGithubSkillDirs(): string[];
+/**
+ * `permissions.allow` entries the bundled `settings.json` template ships.
+ * Empty array if the template is missing or unparseable — callers should
+ * treat that as "DKK doesn't own any permissions" rather than erroring.
+ */
+export declare function dkkPermissionAllowEntries(): string[];
+/**
+ * Hook script basenames referenced by the bundled `settings.json` template
+ * (e.g. `session-start-prime.mjs`). Used to identify DKK-owned hook entries
+ * in a consumer's settings.json so they can be pruned cleanly.
+ */
+export declare function dkkHookBasenames(): string[];
+/**
+ * Result of scanning a target repo for every DKK-managed artifact path.
+ * Paths are absolute. Use {@link computeArtifactDiff} for the add / replace /
+ * remove triage.
+ */
+export interface InstalledArtifactScan {
+    dkkPrefixedClaude: string[];
+    dkkHooks: string[];
+    githubSkillDirs: string[];
+    legacy: string[];
+}
+/**
+ * Walk a target repo's `.claude/` and `.github/skills/` trees and return
+ * the set of paths the predicates flag as DKK-managed.
+ */
+export declare function scanInstalledArtifacts(root: string): InstalledArtifactScan;
+export interface ArtifactDiff {
+    /** Files in the new template that aren't present in the target repo. */
+    toAdd: string[];
+    /** Files present in both but with different content. */
+    toReplace: string[];
+    /** Files present locally that DKK no longer ships (renamed/removed templates + legacy paths). */
+    toRemove: string[];
+}
+/**
+ * Compute the add / replace / remove triage between the bundled template
+ * and a target repo. Paths are returned as repo-relative POSIX paths.
+ *
+ * `toAdd` and `toReplace` are derived by enumerating the bundled template's
+ * shipped files; `toRemove` is the set of installed DKK-managed paths that
+ * have no counterpart in the new template.
+ */
+export declare function computeArtifactDiff(root: string): ArtifactDiff;
+/** True if `name` (basename or first path segment) starts with `dkk-`. */
+export declare function isDkkPrefixed(path: string): boolean;
+//# sourceMappingURL=dkk-artifacts.d.ts.map

package/dist/features/agent/dkk-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dkk-artifacts.d.ts","sourceRoot":"","sources":["../../../src/features/agent/dkk-artifacts.ts"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAE7C,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACtC,8EAA8E;IAC9E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wGAAwG;IACxG,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,uBAAuB,CAUxD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAI7C;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAIpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAa3C;AA8BD;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IAEpC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAE5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAkD1E;AAED,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,wDAAwD;IACxD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAqG9D;AAcD,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD"}