openwolf-enhanced 1.9.3

package/dist/src/cli/index.js

@@ -0,0 +1,158 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Command } from "commander";
+import { initCommand } from "./init.js";
+import { statusCommand } from "./status.js";
+import { scanCommand } from "./scan.js";
+import { dashboardCommand } from "./dashboard.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+function getVersion() {
+    try {
+        const pkgPath = path.resolve(__dirname, "../../../package.json");
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        return pkg.version || "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+export function createProgram() {
+    const program = new Command();
+    program
+        .name("openwolf")
+        .description("Token-conscious AI brain for Claude Code projects")
+        .version(getVersion());
+    program
+        .command("init")
+        .description("Initialize .wolf/ in current project")
+        .action(initCommand);
+    program
+        .command("status")
+        .description("Show daemon health, last session stats, file integrity")
+        .action(statusCommand);
+    program
+        .command("scan")
+        .description("Force full anatomy rescan")
+        .option("--check", "Verify anatomy.md matches filesystem (no changes)")
+        .action(scanCommand);
+    program
+        .command("dashboard")
+        .description("Open browser to dashboard")
+        .action(dashboardCommand);
+    const daemon = program
+        .command("daemon")
+        .description("Daemon management");
+    daemon
+        .command("start")
+        .description("Start daemon via pm2")
+        .action(async () => {
+        const { daemonStart } = await import("./daemon-cmd.js");
+        daemonStart();
+    });
+    daemon
+        .command("stop")
+        .description("Stop daemon")
+        .action(async () => {
+        const { daemonStop } = await import("./daemon-cmd.js");
+        daemonStop();
+    });
+    daemon
+        .command("restart")
+        .description("Restart daemon")
+        .action(async () => {
+        const { daemonRestart } = await import("./daemon-cmd.js");
+        daemonRestart();
+    });
+    daemon
+        .command("logs")
+        .description("Show last 50 lines of daemon log")
+        .action(async () => {
+        const { daemonLogs } = await import("./daemon-cmd.js");
+        daemonLogs();
+    });
+    const cron = program
+        .command("cron")
+        .description("Cron task management");
+    cron
+        .command("list")
+        .description("Show all cron tasks with next run times")
+        .action(async () => {
+        const { cronList } = await import("./cron-cmd.js");
+        cronList();
+    });
+    cron
+        .command("run <id>")
+        .description("Manually trigger a cron task")
+        .action(async (id) => {
+        const { cronRun } = await import("./cron-cmd.js");
+        await cronRun(id);
+    });
+    cron
+        .command("retry <id>")
+        .description("Retry a dead-lettered task")
+        .action(async (id) => {
+        const { cronRetry } = await import("./cron-cmd.js");
+        cronRetry(id);
+    });
+    // --- Update command ---
+    program
+        .command("update")
+        .description("Update all registered OpenWolf projects to latest version")
+        .option("--dry-run", "Show what would be updated without making changes")
+        .option("--project <name>", "Update only a specific project (partial name match)")
+        .option("--list", "List all registered projects")
+        .action(async (opts) => {
+        const { updateCommand, listProjects } = await import("./update.js");
+        if (opts.list) {
+            listProjects();
+        }
+        else {
+            await updateCommand(opts);
+        }
+    });
+    // --- Restore command ---
+    program
+        .command("restore [backup]")
+        .description("Restore .wolf from a backup (run in project dir). Without args, lists available backups.")
+        .action(async (backup) => {
+        const { restoreCommand } = await import("./update.js");
+        restoreCommand(backup);
+    });
+    // --- Design QC command ---
+    program
+        .command("designqc [target]")
+        .description("Capture full-page screenshots for design evaluation by Claude Code")
+        .option("--url <url>", "Dev server URL (auto-starts server if omitted)")
+        .option("--routes <routes...>", "Specific routes to check")
+        .option("--quality <n>", "JPEG quality 1-100 (lower = fewer tokens)", "70")
+        .option("--max-width <n>", "Max capture width in px", "1200")
+        .option("--desktop-only", "Skip mobile viewport captures")
+        .action(async (target, opts) => {
+        const { designqcCommand } = await import("./designqc-cmd.js");
+        await designqcCommand(target, opts);
+    });
+    // --- Doctor command ---
+    program
+        .command("doctor")
+        .description("Report .wolf/ health & footprint, then compact (daemon-independent)")
+        .option("--dry-run", "Only report sizes/warnings; write nothing")
+        .action(async (opts) => {
+        const { doctorCommand } = await import("./doctor-cmd.js");
+        await doctorCommand(opts);
+    });
+    // --- Bug command ---
+    const bug = program
+        .command("bug")
+        .description("Bug memory management");
+    bug
+        .command("search <term>")
+        .description("Search buglog for matching entries")
+        .action(async (term) => {
+        const { bugSearch } = await import("./bug-cmd.js");
+        bugSearch(term);
+    });
+    return program;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,UAAU,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,SAAS,UAAU;IACjB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,OAAO,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,mDAAmD,CAAC;SAChE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEzB,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sCAAsC,CAAC;SACnD,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvB,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,aAAa,CAAC,CAAC;IAEzB,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,SAAS,EAAE,mDAAmD,CAAC;SACtE,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvB,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAE5B,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,mBAAmB,CAAC,CAAC;IAEpC,MAAM;SACH,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,sBAAsB,CAAC;SACnC,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACxD,WAAW,EAAE,CAAC;IAChB,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,aAAa,CAAC;SAC1B,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACvD,UAAU,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,gBAAgB,CAAC;SAC7B,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC1D,aAAa,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACvD,UAAU,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEL,MAAM,IAAI,GAAG,OAAO;SACjB,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAEvC,IAAI;SACD,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,yCAAyC,CAAC;SACtD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACnD,QAAQ,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEL,IAAI;SACD,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,EAAE;QAC3B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAClD,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC,CAAC,CAAC;IAEL,IAAI;SACD,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,EAAE;QAC3B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QACpD,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEL,yBAAyB;IACzB,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2DAA2D,CAAC;SACxE,MAAM,CAAC,WAAW,EAAE,mDAAmD,CAAC;SACxE,MAAM,CAAC,kBAAkB,EAAE,qDAAqD,CAAC;SACjF,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;SAChD,MAAM,CAAC,KAAK,EAAE,IAA4D,EAAE,EAAE;QAC7E,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,0BAA0B;IAC1B,OAAO;SACJ,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,0FAA0F,CAAC;SACvG,MAAM,CAAC,KAAK,EAAE,MAAe,EAAE,EAAE;QAChC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACvD,cAAc,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEL,4BAA4B;IAC5B,OAAO;SACJ,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,oEAAoE,CAAC;SACjF,MAAM,CAAC,aAAa,EAAE,gDAAgD,CAAC;SACvE,MAAM,CAAC,sBAAsB,EAAE,0BAA0B,CAAC;SAC1D,MAAM,CAAC,eAAe,EAAE,2CAA2C,EAAE,IAAI,CAAC;SAC1E,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,CAAC;SAC5D,MAAM,CAAC,gBAAgB,EAAE,+BAA+B,CAAC;SACzD,MAAM,CAAC,KAAK,EAAE,MAA0B,EAAE,IAAqG,EAAE,EAAE;QAClJ,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC9D,MAAM,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEL,yBAAyB;IACzB,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qEAAqE,CAAC;SAClF,MAAM,CAAC,WAAW,EAAE,2CAA2C,CAAC;SAChE,MAAM,CAAC,KAAK,EAAE,IAA0B,EAAE,EAAE;QAC3C,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QAC1D,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,sBAAsB;IACtB,MAAM,GAAG,GAAG,OAAO;SAChB,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,uBAAuB,CAAC,CAAC;IAExC,GAAG;SACA,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,oCAAoC,CAAC;SACjD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC7B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACnD,SAAS,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/cli/init.js

@@ -0,0 +1,493 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { execFileSync } from "node:child_process";
+import { findProjectRoot } from "../scanner/project-root.js";
+import { scanProject } from "../scanner/anatomy-scanner.js";
+import { readJSON, writeJSON, readText, writeText, safeCopyFile } from "../utils/fs-safe.js";
+import { ensureDir } from "../utils/paths.js";
+import { isWindows } from "../utils/platform.js";
+import { copyHookScripts } from "../utils/hooks-deploy.js";
+import { detectProjectName, applyTemplatePlaceholders } from "../utils/seed.js";
+import { registerProject, getRegisteredProjects } from "./registry.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Read version from package.json
+function getVersion() {
+    try {
+        const pkgPath = path.resolve(__dirname, "../../../package.json");
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        return pkg.version || "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+// Files that are safe to overwrite on upgrade (config/protocol, not user data)
+const ALWAYS_OVERWRITE = [
+    "OPENWOLF.md",
+    "config.json",
+    "reframe-frameworks.md",
+];
+// Files that contain user/session data — only create if missing, never overwrite
+const CREATE_IF_MISSING = [
+    "identity.md",
+    "cerebrum.md",
+    "memory.md",
+    "anatomy.md",
+    "STATUS.md",
+    "token-ledger.json",
+    "buglog.json",
+    "cron-manifest.json",
+    "cron-state.json",
+    "designqc-report.json",
+    "suggestions.json",
+];
+// Use $CLAUDE_PROJECT_DIR so hooks resolve correctly even if CWD changes during a session
+const HOOK_SETTINGS = {
+    hooks: {
+        SessionStart: [
+            {
+                matcher: "",
+                hooks: [
+                    {
+                        type: "command",
+                        _managedBy: "openwolf",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.wolf/hooks/session-start.js"',
+                        timeout: 5,
+                    },
+                ],
+            },
+        ],
+        PreToolUse: [
+            {
+                matcher: "Read",
+                hooks: [
+                    {
+                        type: "command",
+                        _managedBy: "openwolf",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.wolf/hooks/pre-read.js"',
+                        timeout: 5,
+                    },
+                ],
+            },
+            {
+                matcher: "Write|Edit|MultiEdit",
+                hooks: [
+                    {
+                        type: "command",
+                        _managedBy: "openwolf",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.wolf/hooks/pre-write.js"',
+                        timeout: 5,
+                    },
+                ],
+            },
+        ],
+        PostToolUse: [
+            {
+                matcher: "Read",
+                hooks: [
+                    {
+                        type: "command",
+                        _managedBy: "openwolf",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.wolf/hooks/post-read.js"',
+                        timeout: 5,
+                    },
+                ],
+            },
+            {
+                matcher: "Write|Edit|MultiEdit",
+                hooks: [
+                    {
+                        type: "command",
+                        _managedBy: "openwolf",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.wolf/hooks/post-write.js"',
+                        timeout: 10,
+                    },
+                ],
+            },
+        ],
+        Stop: [
+            {
+                matcher: "",
+                hooks: [
+                    {
+                        type: "command",
+                        _managedBy: "openwolf",
+                        command: 'node "$CLAUDE_PROJECT_DIR/.wolf/hooks/stop.js"',
+                        timeout: 10,
+                    },
+                ],
+            },
+        ],
+    },
+};
+export async function initCommand() {
+    // Check Node.js version
+    const nodeVersion = parseInt(process.version.slice(1), 10);
+    if (nodeVersion < 20) {
+        console.error(`Node.js 20+ required. Current: ${process.version}`);
+        process.exit(1);
+    }
+    // Detect project root
+    const projectRoot = findProjectRoot();
+    console.log(`Project root: ${projectRoot}`);
+    const wolfDir = path.join(projectRoot, ".wolf");
+    const isUpgrade = fs.existsSync(wolfDir);
+    const version = getVersion();
+    if (isUpgrade) {
+        console.log(`Upgrading OpenWolf to v${version}...`);
+    }
+    // Create .wolf/ directory
+    ensureDir(wolfDir);
+    ensureDir(path.join(wolfDir, "hooks"));
+    // Find templates directory
+    const actualTemplatesDir = findTemplatesDir();
+    // --- Template files ---
+    let createdCount = 0;
+    let skippedCount = 0;
+    for (const file of ALWAYS_OVERWRITE) {
+        writeTemplateFile(actualTemplatesDir, wolfDir, file);
+        createdCount++;
+    }
+    const newlyCreated = new Set();
+    for (const file of CREATE_IF_MISSING) {
+        const destPath = path.join(wolfDir, file);
+        if (fs.existsSync(destPath)) {
+            skippedCount++;
+        }
+        else {
+            writeTemplateFile(actualTemplatesDir, wolfDir, file);
+            createdCount++;
+            newlyCreated.add(file);
+        }
+    }
+    // --- Cerebrum: seed project info only if fresh ---
+    if (!isUpgrade) {
+        seedCerebrum(wolfDir, projectRoot);
+        seedIdentity(wolfDir, projectRoot);
+    }
+    // --- STATUS.md: substitute {{PROJECT_NAME}} / {{DATE}} when freshly created ---
+    if (newlyCreated.has("STATUS.md")) {
+        seedStatus(wolfDir, projectRoot);
+    }
+    // --- Token ledger: set created_at only if empty ---
+    const ledgerPath = path.join(wolfDir, "token-ledger.json");
+    const ledger = readJSON(ledgerPath, {});
+    if (!ledger.created_at) {
+        ledger.created_at = new Date().toISOString();
+        writeJSON(ledgerPath, ledger);
+    }
+    // --- Hook scripts: always update (bug fixes, new features) ---
+    copyHookScripts(wolfDir);
+    // --- Claude settings: replace OpenWolf hooks (upgrade old paths) ---
+    const claudeDir = path.join(projectRoot, ".claude");
+    ensureDir(claudeDir);
+    const settingsPath = path.join(claudeDir, "settings.json");
+    if (fs.existsSync(settingsPath)) {
+        const existing = readJSON(settingsPath, {});
+        const merged = replaceOpenWolfHooks(existing, HOOK_SETTINGS);
+        writeJSON(settingsPath, merged);
+    }
+    else {
+        writeJSON(settingsPath, HOOK_SETTINGS);
+    }
+    // --- Claude rules: always update ---
+    const rulesDir = path.join(claudeDir, "rules");
+    ensureDir(rulesDir);
+    const rulesContent = readTemplateContent("claude-rules-openwolf.md", actualTemplatesDir);
+    writeText(path.join(rulesDir, "openwolf.md"), rulesContent);
+    // --- CLAUDE.md: add snippet if missing ---
+    const claudeMdPath = path.join(projectRoot, "CLAUDE.md");
+    const snippetContent = readTemplateContent("claude-md-snippet.md", actualTemplatesDir);
+    if (fs.existsSync(claudeMdPath)) {
+        const existing = readText(claudeMdPath);
+        if (!existing.includes("OpenWolf")) {
+            writeText(claudeMdPath, snippetContent + "\n\n" + existing);
+        }
+    }
+    else {
+        writeText(claudeMdPath, snippetContent);
+    }
+    // --- Anatomy scan: only on fresh init ---
+    let fileCount = 0;
+    if (!isUpgrade) {
+        try {
+            fileCount = scanProject(wolfDir, projectRoot);
+        }
+        catch {
+            console.log("  Anatomy scan deferred — will run on first session.");
+        }
+    }
+    else {
+        // On upgrade, read existing count
+        try {
+            const anatomyContent = readText(path.join(wolfDir, "anatomy.md"));
+            const m = anatomyContent.match(/Files:\s*(\d+)/);
+            fileCount = m ? parseInt(m[1], 10) : 0;
+        }
+        catch {
+            fileCount = 0;
+        }
+    }
+    // --- Avoid dashboard/daemon port collisions with other projects (upstream #20) ---
+    if (!isUpgrade) {
+        try {
+            resolvePortCollisions(wolfDir, projectRoot);
+        }
+        catch { /* non-fatal */ }
+    }
+    // --- Daemon ---
+    let daemonStatus = "start manually with: openwolf daemon start";
+    try {
+        const pm2Bin = isWindows() ? "pm2.cmd" : "pm2";
+        execFileSync(isWindows() ? "where" : "which", ["pm2"], { stdio: "ignore" });
+        // Sanitize the project name so it can't inject pm2/shell args.
+        const name = `openwolf-${path.basename(projectRoot).replace(/[^A-Za-z0-9_.-]/g, "-")}`;
+        // Resolve daemon script relative to openwolf's install dir, not the target project
+        const daemonScript = path.resolve(__dirname, "..", "daemon", "wolf-daemon.js");
+        try {
+            execFileSync(pm2Bin, ["start", daemonScript, "--name", name, "--cwd", projectRoot], {
+                stdio: "ignore",
+                env: { ...process.env, OPENWOLF_PROJECT_ROOT: projectRoot },
+            });
+            execFileSync(pm2Bin, ["save"], { stdio: "ignore" });
+            daemonStatus = "running via pm2";
+        }
+        catch {
+            daemonStatus = "pm2 found but daemon start failed. Try: openwolf daemon start";
+        }
+    }
+    catch {
+        daemonStatus = "pm2 not found. Install with: pnpm add -g pm2";
+    }
+    // --- Register in central registry (skip if this IS the openwolf source repo) ---
+    try {
+        const projectName = detectProjectName(projectRoot);
+        if (projectName === "openwolf") {
+            // Don't register the openwolf dev repo — it would get updated by `openwolf update`
+        }
+        else {
+            registerProject(projectRoot, projectName, version);
+        }
+    }
+    catch {
+        // Non-fatal — registry is a convenience feature
+    }
+    // --- Summary ---
+    console.log("");
+    if (isUpgrade) {
+        console.log(`  ✓ OpenWolf upgraded to v${version}`);
+        console.log(`  ✓ All .wolf data preserved (${skippedCount} files: cerebrum, memory, anatomy, buglog, ledger)`);
+        console.log(`  ✓ Hook scripts updated (6 hooks)`);
+        console.log(`  ✓ ${createdCount} config files updated`);
+        console.log(`  ✓ Anatomy: ${fileCount} files tracked (unchanged)`);
+    }
+    else {
+        console.log(`  ✓ OpenWolf v${version} initialized`);
+        console.log(`  ✓ .wolf/ created with ${createdCount} files`);
+        console.log(`  ✓ Claude Code hooks registered (6 hooks)`);
+        console.log(`  ✓ CLAUDE.md updated`);
+        console.log(`  ✓ .claude/rules/openwolf.md created`);
+        console.log(`  ✓ Anatomy scan: ${fileCount} files indexed`);
+    }
+    console.log(`  ✓ Daemon: ${daemonStatus}`);
+    console.log("");
+    console.log("  You're ready. Just use 'claude' as normal — OpenWolf is watching.");
+    console.log("");
+}
+// ─── Helpers ─────────────────────────────────────────────────
+function findTemplatesDir() {
+    const candidates = [
+        path.resolve(__dirname, "..", "..", "..", "src", "templates"),
+        path.resolve(__dirname, "..", "..", "src", "templates"),
+        path.resolve(__dirname, "..", "templates"),
+        path.resolve(__dirname, "templates"),
+    ];
+    for (const dir of candidates) {
+        if (fs.existsSync(dir))
+            return dir;
+    }
+    return candidates[0]; // fallback — generateTemplate will handle missing files
+}
+function writeTemplateFile(templatesDir, wolfDir, file) {
+    const srcPath = path.join(templatesDir, file);
+    const destPath = path.join(wolfDir, file);
+    if (fs.existsSync(srcPath)) {
+        safeCopyFile(srcPath, destPath);
+    }
+    else {
+        generateTemplate(destPath, file);
+    }
+}
+function readTemplateContent(filename, templatesDir) {
+    const filePath = path.join(templatesDir, filename);
+    if (fs.existsSync(filePath)) {
+        return fs.readFileSync(filePath, "utf-8");
+    }
+    return getEmbeddedTemplate(filename);
+}
+function getEmbeddedTemplate(filename) {
+    const templates = {
+        "claude-md-snippet.md": `# OpenWolf\n\n@.wolf/OPENWOLF.md\n\nThis project uses OpenWolf for context management. Read and follow .wolf/OPENWOLF.md every session. Check .wolf/cerebrum.md before generating code. Check .wolf/anatomy.md before reading files.`,
+        "claude-rules-openwolf.md": `---\ndescription: OpenWolf protocol enforcement — active on all files\nglobs: **/*\n---\n\n- Read .wolf/STATUS.md FIRST when resuming a session — it holds the current quest, next steps, and decisions\n- Update .wolf/STATUS.md (✅ done / 🚀 next quest) when a quest finishes or before suggesting /clear\n- Check .wolf/anatomy.md before reading any project file\n- Check .wolf/cerebrum.md Do-Not-Repeat list before generating code\n- After writing or editing files, update .wolf/anatomy.md and append to .wolf/memory.md\n- After receiving a user correction, update .wolf/cerebrum.md immediately (Preferences, Learnings, or Do-Not-Repeat)\n- LEARN from every interaction: if you discover a convention, user preference, or project pattern, add it to .wolf/cerebrum.md. Low threshold — when in doubt, log it.\n- BEFORE fixing any bug or error: read .wolf/buglog.json for known fixes\n- AFTER fixing any bug, error, failed test, failed build, or user-reported problem: ALWAYS log to .wolf/buglog.json with error_message, root_cause, fix, and tags\n- If you edit a file more than twice in a session, that likely indicates a bug — log it to .wolf/buglog.json\n- When the user asks to check/evaluate UI design: run \`openwolf designqc\` to capture screenshots, then read them from .wolf/designqc-captures/\n- When the user asks to change/pick/migrate UI framework: read .wolf/reframe-frameworks.md, ask decision questions, recommend a framework, then execute with the framework's prompt`,
+    };
+    return templates[filename] ?? "";
+}
+// Bump this project's daemon/dashboard ports if another registered project already uses them.
+function resolvePortCollisions(wolfDir, projectRoot) {
+    const configPath = path.join(wolfDir, "config.json");
+    let cfg;
+    try {
+        cfg = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        return;
+    }
+    const daemonPort = cfg.openwolf?.daemon?.port ?? 18790;
+    const dashPort = cfg.openwolf?.dashboard?.port ?? 18791;
+    const here = path.resolve(projectRoot).toLowerCase();
+    const used = new Set();
+    for (const p of getRegisteredProjects()) {
+        if (path.resolve(p.root).toLowerCase() === here)
+            continue;
+        try {
+            const other = JSON.parse(fs.readFileSync(path.join(p.root, ".wolf", "config.json"), "utf-8"));
+            const d = other?.openwolf?.daemon?.port;
+            const w = other?.openwolf?.dashboard?.port;
+            if (typeof d === "number")
+                used.add(d);
+            if (typeof w === "number")
+                used.add(w);
+        }
+        catch { /* skip unreadable project config */ }
+    }
+    let offset = 0;
+    while (used.has(daemonPort + offset) || used.has(dashPort + offset))
+        offset += 2;
+    if (offset === 0)
+        return;
+    cfg.openwolf = cfg.openwolf ?? {};
+    cfg.openwolf.daemon = cfg.openwolf.daemon ?? {};
+    cfg.openwolf.dashboard = cfg.openwolf.dashboard ?? {};
+    cfg.openwolf.daemon.port = daemonPort + offset;
+    cfg.openwolf.dashboard.port = dashPort + offset;
+    try {
+        fs.writeFileSync(configPath, JSON.stringify(cfg, null, 2), "utf-8");
+    }
+    catch { /* non-fatal */ }
+}
+function generateTemplate(destPath, file) {
+    const templates = {
+        "OPENWOLF.md": `# OpenWolf Operating Protocol\n\nYou are working in an OpenWolf-managed project. These rules apply every turn.\n\n## File Navigation\n\n1. Check \`.wolf/anatomy.md\` BEFORE reading any file.\n2. If the description is sufficient, do NOT read the full file.\n3. If a file is not in anatomy.md, search with Grep/Glob.\n\n## Code Generation\n\n1. Read \`.wolf/cerebrum.md\` and respect every entry.\n2. Check \`## Do-Not-Repeat\` section.\n\n## After Actions\n\n1. Append to \`.wolf/memory.md\`.\n2. After file changes: update \`.wolf/anatomy.md\`.\n\n## Token Discipline\n\n- Never re-read a file already read this session.\n- Prefer anatomy.md descriptions over full reads.\n`,
+        "identity.md": `# Identity\n\n- **Name:** Wolf\n- **Role:** AI development assistant for this project\n- **Tone:** Direct, concise, technically precise\n`,
+        "cerebrum.md": `# Cerebrum\n\n> OpenWolf's learning memory.\n\n## User Preferences\n\n## Key Learnings\n\n## Do-Not-Repeat\n\n## Decision Log\n`,
+        "memory.md": `# Memory\n\n> Chronological action log.\n`,
+        "anatomy.md": `# anatomy.md\n\n> Project structure index. Pending initial scan.\n`,
+        "STATUS.md": `# STATUS — {{PROJECT_NAME}}\n\n> Single source of truth for resuming work. Read this FIRST when starting a session.\n> Update at the end of every quest so the next \\\`/clear\\\` resumes in one read.\n>\n> Last updated: {{DATE}}\n\n---\n\n## ✅ Done\n\n- (nothing yet — move items here as quests complete)\n\n## 🚀 Next phase\n\n**Goal:** _<what we're building next>_\n\n### Acceptance criteria\n1. _<concrete, user-visible outcome>_\n\n### Files to create / edit\n- _<path — purpose>_\n\n## 📁 Active architecture\n\n- **Stack:** _<frameworks / languages>_\n\n## ⚠️ Pending / gotchas\n\n- _<known issues, blockers>_\n\n## 🔧 Useful commands\n\n\\\`\\\`\\\`bash\n# add the commands you run most often here\n\\\`\\\`\\\`\n`,
+        "config.json": JSON.stringify({
+            version: 1,
+            openwolf: {
+                enabled: true,
+                anatomy: { auto_scan_on_init: true, rescan_interval_hours: 6, max_description_length: 100, max_files: 500, exclude_patterns: ["node_modules", ".git", "dist", "build", ".wolf", ".next", ".nuxt", "coverage", "__pycache__", ".cache", "target", ".vscode", ".idea", ".turbo", ".vercel", ".netlify", ".output", "*.min.js", "*.min.css"] },
+                token_audit: { enabled: true, report_frequency: "weekly", waste_threshold_percent: 15, chars_per_token_code: 3.5, chars_per_token_prose: 4.0 },
+                cron: { enabled: true, max_retry_attempts: 3, dead_letter_enabled: true, heartbeat_interval_minutes: 30, use_claude_p: true, api_key_env: null },
+                memory: { consolidation_after_days: 7, max_entries_before_consolidation: 200 },
+                retention: { token_ledger_max_sessions: 200, session_io_max: 100, buglog_max_entries: 200, backups_keep: 10, memory_consolidate_after_days: 7, memory_max_bytes: 262144, daemon_log_max_bytes: 524288 },
+                cerebrum: { max_tokens: 2000, reflection_frequency: "weekly" },
+                daemon: { port: 18790, log_level: "info" },
+                dashboard: { enabled: true, port: 18791, host: "127.0.0.1" },
+                designqc: { enabled: true, viewports: [{ name: "desktop", width: 1440, height: 900 }, { name: "mobile", width: 375, height: 812 }], max_screenshots: 6, chrome_path: null },
+            },
+        }, null, 2),
+        "token-ledger.json": JSON.stringify({ version: 1, created_at: "", lifetime: { total_tokens_estimated: 0, total_reads: 0, total_writes: 0, total_sessions: 0, anatomy_hits: 0, anatomy_misses: 0, repeated_reads_blocked: 0, estimated_savings_vs_bare_cli: 0 }, sessions: [], daemon_usage: [], waste_flags: [], optimization_report: { last_generated: null, patterns: [] } }, null, 2),
+        "buglog.json": JSON.stringify({ version: 1, bugs: [] }, null, 2),
+        "cron-manifest.json": JSON.stringify({ version: 1, tasks: [] }, null, 2),
+        "cron-state.json": JSON.stringify({ last_heartbeat: null, engine_status: "initialized", execution_log: [], dead_letter_queue: [], upcoming: [] }, null, 2),
+        "designqc-report.json": JSON.stringify({ captured_at: null, captures: [], total_size_kb: 0, estimated_tokens: 0 }, null, 2),
+        "suggestions.json": JSON.stringify({ suggestions: [], generated_at: null }, null, 2),
+    };
+    const content = templates[file] ?? "";
+    fs.writeFileSync(destPath, content, "utf-8");
+}
+function seedStatus(wolfDir, projectRoot) {
+    applyTemplatePlaceholders(path.join(wolfDir, "STATUS.md"), projectRoot);
+}
+function seedCerebrum(wolfDir, projectRoot) {
+    const projectName = detectProjectName(projectRoot);
+    const projectDescription = detectProjectDescription(projectRoot);
+    if (!projectName && !projectDescription)
+        return;
+    const cerebrumPath = path.join(wolfDir, "cerebrum.md");
+    let cerebrum = readText(cerebrumPath);
+    const projectInfo = [
+        `- **Project:** ${projectName || path.basename(projectRoot)}`,
+        projectDescription ? `- **Description:** ${projectDescription}` : "",
+    ].filter(Boolean).join("\n");
+    // Insert after ## Key Learnings section
+    cerebrum = cerebrum.replace(/## Key Learnings\n\n<!-- Project-specific conventions discovered during development\. -->/, `## Key Learnings\n\n${projectInfo}`);
+    // Fallback: if the comment wasn't found (embedded template), try simpler pattern
+    if (!cerebrum.includes("**Project:**")) {
+        cerebrum = cerebrum.replace(/## Key Learnings\n/, `## Key Learnings\n\n${projectInfo}\n`);
+    }
+    cerebrum = cerebrum.replace(/Last updated: —/, `Last updated: ${new Date().toISOString().slice(0, 10)}`);
+    writeText(cerebrumPath, cerebrum);
+}
+function seedIdentity(wolfDir, projectRoot) {
+    const projectName = detectProjectName(projectRoot);
+    if (!projectName)
+        return;
+    const identityPath = path.join(wolfDir, "identity.md");
+    let content = readText(identityPath);
+    content = content.replace(/\*\*Name:\*\* Wolf/, `**Name:** ${projectName}`);
+    content = content.replace(/\*\*Role:\*\* AI development assistant for this project/, `**Role:** AI development assistant for ${projectName}`);
+    writeText(identityPath, content);
+}
+/**
+ * Replace all OpenWolf hook entries in settings.json with the current version.
+ * Removes old-style relative-path hooks and inserts the new $CLAUDE_PROJECT_DIR hooks.
+ * Preserves any non-OpenWolf hooks the user may have added.
+ */
+function replaceOpenWolfHooks(existing, hookSettings) {
+    const merged = { ...existing };
+    if (!merged.hooks) {
+        merged.hooks = {};
+    }
+    const hooks = merged.hooks;
+    for (const [event, newMatchers] of Object.entries(hookSettings.hooks)) {
+        if (!hooks[event]) {
+            hooks[event] = [];
+        }
+        // Remove any existing OpenWolf hook entries (match by .wolf/hooks/ in command)
+        hooks[event] = hooks[event].filter((entry) => {
+            const isOpenWolfHook = entry.hooks?.some((h) => (h.command && h.command.includes(".wolf/hooks/")) || h._managedBy === "openwolf");
+            return !isOpenWolfHook;
+        });
+        // Add the new OpenWolf hooks
+        for (const matcher of newMatchers) {
+            hooks[event].push(matcher);
+        }
+    }
+    return merged;
+}
+function detectProjectDescription(projectRoot) {
+    // Try package.json
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(projectRoot, "package.json"), "utf-8"));
+        if (pkg.description)
+            return pkg.description;
+    }
+    catch { }
+    // Try README first line/paragraph
+    for (const readme of ["README.md", "readme.md", "README.rst", "README.txt"]) {
+        try {
+            const content = fs.readFileSync(path.join(projectRoot, readme), "utf-8");
+            const lines = content.split("\n").filter(l => l.trim() && !l.startsWith("#") && !l.startsWith("=") && !l.startsWith("-") && !l.startsWith("!["));
+            if (lines.length > 0)
+                return lines[0].trim().slice(0, 200);
+        }
+        catch { }
+    }
+    return "";
+}
+//# sourceMappingURL=init.js.map