@phren/cli 0.1.13 → 0.1.14

package/dist/cli/namespaces.js

@@ -1,2011 +1,8 @@
-import * as fs from "fs";
-import * as path from "path";
-import { execFileSync } from "child_process";
-import { expandHomePath, findArchivedProjectNameCaseInsensitive, findProjectNameCaseInsensitive, getPhrenPath, getProjectDirs, homePath, hookConfigPath, normalizeProjectNameForCreate, readRootManifest, } from "../shared.js";
-import { isValidProjectName, errorMessage } from "../utils.js";
-import { logger } from "../logger.js";
-function resolveProjectStorePath(phrenPath, project) {
-    try {
-        const { getNonPrimaryStores } = require("../store-registry.js");
-        if (fs.existsSync(path.join(phrenPath, project)))
-            return phrenPath;
-        for (const store of getNonPrimaryStores(phrenPath)) {
-            if (fs.existsSync(path.join(store.path, project)))
-                return store.path;
-        }
-    }
-    catch { /* fall through */ }
-    return phrenPath;
-}
-import { readInstallPreferences, writeInstallPreferences } from "../init/preferences.js";
-import { buildSkillManifest, findLocalSkill, findSkill, getAllSkills } from "../skill/registry.js";
-import { detectSkillCollisions } from "../link/skills.js";
-import { setSkillEnabledAndSync, syncSkillLinksForScope } from "../skill/files.js";
-import { findProjectDir } from "../project-locator.js";
-import { TASK_FILE_ALIASES, addTask, completeTask, updateTask, reorderTask, pinTask, removeTask, workNextTask, tidyDoneTasks, linkTaskIssue, promoteTask, resolveTaskItem } from "../data/tasks.js";
-import { buildTaskIssueBody, createGithubIssueForTask, parseGithubIssueUrl, resolveProjectGithubRepo } from "../task/github.js";
-import { PROJECT_HOOK_EVENTS, PROJECT_OWNERSHIP_MODES, isProjectHookEnabled, parseProjectOwnershipMode, readProjectConfig, writeProjectConfig, writeProjectHookConfig, } from "../project-config.js";
-import { addFinding, removeFinding } from "../core/finding.js";
-import { supersedeFinding, retractFinding, resolveFindingContradiction } from "../finding/lifecycle.js";
-import { readCustomHooks, getHookTarget, HOOK_EVENT_VALUES, validateCustomHookCommand } from "../hooks.js";
-import { runtimeFile } from "../shared.js";
-import { resolveAllStores, addStoreToRegistry, removeStoreFromRegistry, generateStoreId, readTeamBootstrap, } from "../store-registry.js";
-const HOOK_TOOLS = ["claude", "copilot", "cursor", "codex"];
-function printSkillsUsage() {
-    console.log("Usage:");
-    console.log("  phren skills list [--project <name>]");
-    console.log("  phren skills show <name> [--project <name>]");
-    console.log("  phren skills edit <name> [--project <name>]");
-    console.log("  phren skills add <project> <path>");
-    console.log("  phren skills resolve <project|global> [--json]");
-    console.log("  phren skills doctor <project|global>");
-    console.log("  phren skills sync <project|global>");
-    console.log("  phren skills enable <project|global> <name>");
-    console.log("  phren skills disable <project|global> <name>");
-    console.log("  phren skills remove <project> <name>");
-}
-function printHooksUsage() {
-    console.log("Usage:");
-    console.log("  phren hooks list [--project <name>]");
-    console.log("  phren hooks show <tool>");
-    console.log("  phren hooks edit <tool>");
-    console.log("  phren hooks enable <tool>");
-    console.log("  phren hooks disable <tool>");
-    console.log("  phren hooks add-custom <event> <command>");
-    console.log("  phren hooks remove-custom <event> [<command>]");
-    console.log("  phren hooks errors [--limit <n>]");
-    console.log("  tools: claude|copilot|cursor|codex");
-    console.log("  events: " + HOOK_EVENT_VALUES.join(", "));
-}
-function normalizeHookTool(raw) {
-    if (!raw)
-        return null;
-    const tool = raw.toLowerCase();
-    return HOOK_TOOLS.includes(tool) ? tool : null;
-}
-function getOptionValue(args, name) {
-    const exactIdx = args.indexOf(name);
-    if (exactIdx !== -1)
-        return args[exactIdx + 1];
-    const prefixed = args.find((arg) => arg.startsWith(`${name}=`));
-    return prefixed ? prefixed.slice(name.length + 1) : undefined;
-}
-function parseMcpToggle(raw) {
-    if (!raw)
-        return undefined;
-    const normalized = raw.trim().toLowerCase();
-    if (normalized === "on" || normalized === "true" || normalized === "enabled")
-        return true;
-    if (normalized === "off" || normalized === "false" || normalized === "disabled")
-        return false;
-    return undefined;
-}
-function findSkillPath(name, profile, project) {
-    const found = findSkill(getPhrenPath(), profile, project, name);
-    if (!found || "error" in found)
-        return null;
-    return found.path;
-}
-function openInEditor(filePath) {
-    const editor = process.env.EDITOR || process.env.VISUAL || "nano";
-    try {
-        execFileSync(editor, [filePath], { stdio: "inherit" });
-    }
-    catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            logger.debug("cli-namespaces", `openInEditor: ${errorMessage(err)}`);
-        console.error(`Editor "${editor}" failed. Set $EDITOR to your preferred editor.`);
-        process.exit(1);
-    }
-}
-export function handleSkillsNamespace(args, profile) {
-    const subcommand = args[0];
-    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
-        printSkillsUsage();
-        return;
-    }
-    if (subcommand === "list") {
-        const projectIdx = args.indexOf("--project");
-        const project = projectIdx !== -1 ? args[projectIdx + 1] : undefined;
-        handleSkillList(profile, project);
-        return;
-    }
-    if (subcommand === "show" || subcommand === "edit") {
-        const name = args[1];
-        if (!name) {
-            printSkillsUsage();
-            process.exit(1);
-        }
-        const projectIdx = args.indexOf("--project");
-        const project = projectIdx !== -1 ? args[projectIdx + 1] : undefined;
-        const skillPath = findSkillPath(name, profile, project);
-        if (!skillPath) {
-            console.error(`Skill not found: "${name}"${project ? ` in project "${project}"` : ""}`);
-            process.exit(1);
-        }
-        if (subcommand === "show") {
-            console.log(fs.readFileSync(skillPath, "utf8"));
-        }
-        else {
-            openInEditor(skillPath);
-        }
-        return;
-    }
-    if (subcommand === "add") {
-        const project = args[1];
-        const skillPath = args[2];
-        if (!project || !skillPath) {
-            printSkillsUsage();
-            process.exit(1);
-        }
-        if (!isValidProjectName(project)) {
-            console.error(`Invalid project name: "${project}"`);
-            process.exit(1);
-        }
-        const source = path.resolve(expandHomePath(skillPath));
-        if (!fs.existsSync(source) || !fs.statSync(source).isFile()) {
-            console.error(`Skill file not found: ${source}`);
-            process.exit(1);
-        }
-        const baseName = path.basename(source);
-        const fileName = baseName.toLowerCase().endsWith(".md") ? baseName : `${baseName}.md`;
-        const destDir = path.join(getPhrenPath(), project, "skills");
-        const dest = path.join(destDir, fileName);
-        fs.mkdirSync(destDir, { recursive: true });
-        if (fs.existsSync(dest)) {
-            console.error(`Skill already exists: ${dest}`);
-            process.exit(1);
-        }
-        try {
-            fs.symlinkSync(source, dest);
-            console.log(`Linked skill ${fileName} into ${project}.`);
-        }
-        catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                logger.debug("cli-namespaces", `skill add symlinkFailed: ${errorMessage(err)}`);
-            fs.copyFileSync(source, dest);
-            console.log(`Copied skill ${fileName} into ${project}.`);
-        }
-        return;
-    }
-    if (subcommand === "resolve" || subcommand === "doctor" || subcommand === "sync") {
-        const scope = args[1];
-        if (!scope) {
-            printSkillsUsage();
-            process.exit(1);
-        }
-        if (scope.toLowerCase() !== "global" && !isValidProjectName(scope)) {
-            console.error(`Invalid project name: "${scope}"`);
-            process.exit(1);
-        }
-        if (subcommand === "sync") {
-            const syncedManifest = syncSkillLinksForScope(getPhrenPath(), scope);
-            if (!syncedManifest) {
-                console.error(`Project directory not found for "${scope}".`);
-                process.exit(1);
-            }
-            const mirrorDir = resolveSkillMirrorDir(scope) || homePath(".claude", "skills");
-            console.log(`Synced ${syncedManifest.skills.filter((skill) => skill.visibleToAgents).length} skill(s) for ${scope}.`);
-            console.log(`  ${path.join(path.dirname(mirrorDir), "skill-manifest.json")}`);
-            console.log(`  ${path.join(path.dirname(mirrorDir), "skill-commands.json")}`);
-            return;
-        }
-        const destDir = resolveSkillMirrorDir(scope);
-        const manifest = buildSkillManifest(getPhrenPath(), profile, scope, destDir || undefined);
-        if (subcommand === "resolve") {
-            if (args.includes("--json")) {
-                console.log(JSON.stringify(manifest, null, 2));
-                return;
-            }
-            printResolvedManifest(scope, manifest, destDir);
-            return;
-        }
-        printSkillDoctor(scope, manifest, destDir);
-        return;
-    }
-    if (subcommand === "enable" || subcommand === "disable") {
-        const scope = args[1];
-        const name = args[2];
-        if (!scope || !name) {
-            printSkillsUsage();
-            process.exit(1);
-        }
-        if (scope.toLowerCase() !== "global" && !isValidProjectName(scope)) {
-            console.error(`Invalid project name: "${scope}"`);
-            process.exit(1);
-        }
-        const resolved = findSkill(getPhrenPath(), profile, scope, name);
-        if (!resolved || "error" in resolved) {
-            console.error(`Skill not found: "${name}" in "${scope}"`);
-            process.exit(1);
-        }
-        setSkillEnabledAndSync(getPhrenPath(), scope, resolved.name, subcommand === "enable");
-        console.log(`${subcommand === "enable" ? "Enabled" : "Disabled"} skill ${resolved.name} in ${scope}.`);
-        return;
-    }
-    if (subcommand === "remove") {
-        const project = args[1];
-        const name = args[2];
-        if (!project || !name) {
-            printSkillsUsage();
-            process.exit(1);
-        }
-        if (!isValidProjectName(project)) {
-            console.error(`Invalid project name: "${project}"`);
-            process.exit(1);
-        }
-        const resolved = findLocalSkill(getPhrenPath(), project, name)?.path || null;
-        if (!resolved) {
-            console.error(`Skill not found: "${name}" in project "${project}"`);
-            process.exit(1);
-        }
-        const removePath = path.basename(resolved) === "SKILL.md" ? path.dirname(resolved) : resolved;
-        if (fs.statSync(removePath).isDirectory()) {
-            fs.rmSync(removePath, { recursive: true, force: true });
-        }
-        else {
-            fs.unlinkSync(removePath);
-        }
-        console.log(`Removed skill ${name.replace(/\.md$/i, "")} from ${project}.`);
-        return;
-    }
-    console.error(`Unknown skills subcommand: ${subcommand}`);
-    printSkillsUsage();
-    process.exit(1);
-}
-export function handleHooksNamespace(args) {
-    const subcommand = args[0];
-    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
-        printHooksUsage();
-        return;
-    }
-    if (subcommand === "list") {
-        const phrenPath = getPhrenPath();
-        const prefs = readInstallPreferences(phrenPath);
-        const hooksEnabled = prefs.hooksEnabled !== false;
-        const toolPrefs = prefs.hookTools && typeof prefs.hookTools === "object" ? prefs.hookTools : {};
-        const project = getOptionValue(args.slice(1), "--project");
-        if (project && !isValidProjectName(project)) {
-            console.error(`Project "${project}" not found.`);
-            process.exit(1);
-        }
-        if (project) {
-            const storePath = resolveProjectStorePath(phrenPath, project);
-            if (!fs.existsSync(path.join(storePath, project))) {
-                console.error(`Project "${project}" not found.`);
-                process.exit(1);
-            }
-        }
-        const rows = HOOK_TOOLS.map((tool) => ({
-            tool,
-            hookType: "lifecycle",
-            status: hooksEnabled && toolPrefs[tool] !== false ? "enabled" : "disabled",
-        }));
-        console.log("Tool      Hook Type  Status");
-        console.log("--------  ---------  --------");
-        for (const row of rows) {
-            console.log(`${row.tool.padEnd(8)}  ${row.hookType.padEnd(9)}  ${row.status}`);
-        }
-        if (project) {
-            const projectConfig = readProjectConfig(phrenPath, project);
-            const base = projectConfig.hooks?.enabled;
-            console.log("");
-            console.log(`Project ${project}`);
-            console.log(`  base: ${typeof base === "boolean" ? (base ? "enabled" : "disabled") : "inherit"}`);
-            for (const event of PROJECT_HOOK_EVENTS) {
-                const configured = projectConfig.hooks?.[event];
-                const effective = isProjectHookEnabled(phrenPath, project, event, projectConfig);
-                console.log(`  ${event}: ${effective ? "enabled" : "disabled"}${typeof configured === "boolean" ? ` (explicit ${configured ? "on" : "off"})` : " (inherit)"}`);
-            }
-        }
-        const customHooks = readCustomHooks(phrenPath);
-        if (customHooks.length > 0) {
-            console.log("");
-            console.log(`${customHooks.length} custom hook(s):`);
-            for (const h of customHooks) {
-                const hookKind = "webhook" in h ? "[webhook] " : "";
-                console.log(`  ${h.event}: ${hookKind}${getHookTarget(h)}${h.timeout ? ` (${h.timeout}ms)` : ""}`);
-            }
-        }
-        return;
-    }
-    if (subcommand === "show" || subcommand === "edit") {
-        const tool = normalizeHookTool(args[1]);
-        if (!tool) {
-            printHooksUsage();
-            process.exit(1);
-        }
-        const configPath = hookConfigPath(tool, getPhrenPath());
-        if (!configPath || !fs.existsSync(configPath)) {
-            console.error(`Hook config not found for "${tool}": ${configPath ?? "(unknown path)"}`);
-            process.exit(1);
-        }
-        if (subcommand === "show") {
-            console.log(fs.readFileSync(configPath, "utf8"));
-        }
-        else {
-            openInEditor(configPath);
-        }
-        return;
-    }
-    if (subcommand === "enable" || subcommand === "disable") {
-        const tool = normalizeHookTool(args[1]);
-        if (!tool) {
-            printHooksUsage();
-            process.exit(1);
-        }
-        const prefs = readInstallPreferences(getPhrenPath());
-        writeInstallPreferences(getPhrenPath(), {
-            hookTools: {
-                ...(prefs.hookTools && typeof prefs.hookTools === "object" ? prefs.hookTools : {}),
-                [tool]: subcommand === "enable",
-            },
-        });
-        console.log(`${subcommand === "enable" ? "Enabled" : "Disabled"} hooks for ${tool}.`);
-        return;
-    }
-    if (subcommand === "add-custom") {
-        const event = args[1];
-        const command = args.slice(2).join(" ");
-        if (!event || !command) {
-            console.error('Usage: phren hooks add-custom <event> "<command>"');
-            console.error("Events: " + HOOK_EVENT_VALUES.join(", "));
-            process.exit(1);
-        }
-        if (!HOOK_EVENT_VALUES.includes(event)) {
-            console.error(`Invalid event "${event}". Valid events: ${HOOK_EVENT_VALUES.join(", ")}`);
-            process.exit(1);
-        }
-        const commandErr = validateCustomHookCommand(command);
-        if (commandErr) {
-            console.error(commandErr);
-            process.exit(1);
-        }
-        const phrenPath = getPhrenPath();
-        const prefs = readInstallPreferences(phrenPath);
-        const existing = Array.isArray(prefs.customHooks) ? prefs.customHooks : [];
-        const newHook = { event: event, command };
-        writeInstallPreferences(phrenPath, { ...prefs, customHooks: [...existing, newHook] });
-        console.log(`Added custom hook for "${event}": ${command}`);
-        return;
-    }
-    if (subcommand === "remove-custom") {
-        const event = args[1];
-        if (!event) {
-            console.error('Usage: phren hooks remove-custom <event> [<command>]');
-            process.exit(1);
-        }
-        if (!HOOK_EVENT_VALUES.includes(event)) {
-            console.error(`Invalid event "${event}". Valid events: ${HOOK_EVENT_VALUES.join(", ")}`);
-            process.exit(1);
-        }
-        const command = args.slice(2).join(" ") || undefined;
-        const phrenPath = getPhrenPath();
-        const prefs = readInstallPreferences(phrenPath);
-        const existing = Array.isArray(prefs.customHooks) ? prefs.customHooks : [];
-        const remaining = existing.filter(h => h.event !== event || (command && !getHookTarget(h).includes(command)));
-        const removed = existing.length - remaining.length;
-        if (removed === 0) {
-            console.error(`No custom hooks matched event="${event}"${command ? ` command containing "${command}"` : ""}.`);
-            process.exit(1);
-        }
-        writeInstallPreferences(phrenPath, { ...prefs, customHooks: remaining });
-        console.log(`Removed ${removed} custom hook(s) for "${event}".`);
-        return;
-    }
-    if (subcommand === "errors") {
-        const phrenPath = getPhrenPath();
-        const logPath = runtimeFile(phrenPath, "hook-errors.log");
-        if (!fs.existsSync(logPath)) {
-            console.log("No hook errors recorded.");
-            return;
-        }
-        const content = fs.readFileSync(logPath, "utf8").trim();
-        if (!content) {
-            console.log("No hook errors recorded.");
-            return;
-        }
-        const lines = content.split("\n");
-        const limitArg = getOptionValue(args.slice(1), "--limit");
-        const limit = limitArg ? Math.max(1, parseInt(limitArg, 10) || 20) : 20;
-        const display = lines.slice(-limit);
-        console.log(`Hook errors (last ${display.length} of ${lines.length}):\n`);
-        for (const line of display) {
-            console.log(line);
-        }
-        return;
-    }
-    console.error(`Unknown hooks subcommand: ${subcommand}`);
-    printHooksUsage();
-    process.exit(1);
-}
-export function handleSkillList(profile, project) {
-    if (project) {
-        const manifest = buildSkillManifest(getPhrenPath(), profile, project, resolveSkillMirrorDir(project) || undefined);
-        printResolvedManifest(project, manifest, resolveSkillMirrorDir(project));
-        return;
-    }
-    const sources = getAllSkills(getPhrenPath(), profile);
-    if (!sources.length) {
-        console.log("No skills found.");
-        return;
-    }
-    const nameWidth = Math.max(4, ...sources.map((source) => source.name.length));
-    const sourceWidth = Math.max(6, ...sources.map((source) => source.source.length));
-    const formatWidth = Math.max(6, ...sources.map((source) => source.format.length));
-    const commandWidth = Math.max(7, ...sources.map((source) => source.command.length));
-    const statusWidth = 8;
-    console.log(`${"Name".padEnd(nameWidth)}  ${"Source".padEnd(sourceWidth)}  ${"Format".padEnd(formatWidth)}  ${"Command".padEnd(commandWidth)}  ${"Status".padEnd(statusWidth)}  Path`);
-    console.log(`${"─".repeat(nameWidth)}  ${"─".repeat(sourceWidth)}  ${"─".repeat(formatWidth)}  ${"─".repeat(commandWidth)}  ${"─".repeat(statusWidth)}  ${"─".repeat(30)}`);
-    for (const skill of sources) {
-        console.log(`${skill.name.padEnd(nameWidth)}  ${skill.source.padEnd(sourceWidth)}  ${skill.format.padEnd(formatWidth)}  ${skill.command.padEnd(commandWidth)}  ${(skill.enabled ? "enabled" : "disabled").padEnd(statusWidth)}  ${skill.path}`);
-    }
-    console.log(`\n${sources.length} skill(s) found.`);
-}
-export function handleDetectSkills(args, profile) {
-    const importFlag = args.includes("--import");
-    const nativeSkillsDir = homePath(".claude", "skills");
-    if (!fs.existsSync(nativeSkillsDir)) {
-        console.log("No native skills directory found at ~/.claude/skills/");
-        return;
-    }
-    const trackedSkills = new Set();
-    const phrenPath = getPhrenPath();
-    const globalSkillsDir = path.join(phrenPath, "global", "skills");
-    if (fs.existsSync(globalSkillsDir)) {
-        for (const entry of fs.readdirSync(globalSkillsDir)) {
-            trackedSkills.add(entry.replace(/\.md$/, ""));
-            if (fs.statSync(path.join(globalSkillsDir, entry)).isDirectory()) {
-                trackedSkills.add(entry);
-            }
-        }
-    }
-    for (const dir of getProjectDirs(phrenPath, profile)) {
-        for (const projectSkillsDir of [path.join(dir, "skills"), path.join(dir, ".claude", "skills")]) {
-            if (!fs.existsSync(projectSkillsDir))
-                continue;
-            for (const entry of fs.readdirSync(projectSkillsDir)) {
-                trackedSkills.add(entry.replace(/\.md$/, ""));
-            }
-        }
-    }
-    const untracked = [];
-    for (const entry of fs.readdirSync(nativeSkillsDir)) {
-        const entryPath = path.join(nativeSkillsDir, entry);
-        const stat = fs.statSync(entryPath);
-        try {
-            if (fs.lstatSync(entryPath).isSymbolicLink())
-                continue;
-        }
-        catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                logger.debug("cli-namespaces", `skillList lstat: ${errorMessage(err)}`);
-        }
-        const name = entry.replace(/\.md$/, "");
-        if (trackedSkills.has(name))
-            continue;
-        if (stat.isFile() && entry.endsWith(".md")) {
-            untracked.push({ name, path: entryPath, isDir: false });
-        }
-        else if (stat.isDirectory()) {
-            const skillFile = path.join(entryPath, "SKILL.md");
-            if (fs.existsSync(skillFile)) {
-                untracked.push({ name, path: entryPath, isDir: true });
-            }
-        }
-    }
-    if (!untracked.length) {
-        console.log("All skills in ~/.claude/skills/ are already tracked by phren.");
-        return;
-    }
-    console.log(`Found ${untracked.length} untracked skill(s) in ~/.claude/skills/:\n`);
-    for (const skill of untracked) {
-        console.log(`  ${skill.name}  (${skill.path})`);
-    }
-    if (!importFlag) {
-        console.log("\nRun with --import to copy these into phren global skills.");
-        return;
-    }
-    fs.mkdirSync(globalSkillsDir, { recursive: true });
-    let imported = 0;
-    for (const skill of untracked) {
-        const dest = skill.isDir
-            ? path.join(globalSkillsDir, skill.name)
-            : path.join(globalSkillsDir, `${skill.name}.md`);
-        if (fs.existsSync(dest)) {
-            console.log(`  skip ${skill.name} (already exists in global/skills/)`);
-            continue;
-        }
-        if (skill.isDir) {
-            fs.cpSync(skill.path, dest, { recursive: true });
-        }
-        else {
-            fs.copyFileSync(skill.path, dest);
-        }
-        const destDisplay = skill.isDir ? `global/skills/${skill.name}/` : `global/skills/${skill.name}.md`;
-        console.log(`  imported ${skill.name} -> ${destDisplay}`);
-        imported++;
-    }
-    console.log(`\nImported ${imported} skill(s). They are now tracked in phren global skills.`);
-}
-function resolveSkillMirrorDir(scope) {
-    if (scope.toLowerCase() === "global")
-        return homePath(".claude", "skills");
-    const projectDir = findProjectDir(scope);
-    return projectDir ? path.join(projectDir, ".claude", "skills") : null;
-}
-function printResolvedManifest(scope, manifest, destDir) {
-    console.log(`Scope: ${scope}`);
-    console.log(`Mirror: ${destDir || "(unavailable on disk)"}`);
-    console.log("");
-    for (const skill of manifest.skills) {
-        const status = skill.visibleToAgents ? "visible" : "disabled";
-        const overrideText = skill.overrides.length ? ` override:${skill.overrides.length}` : "";
-        console.log(`${skill.command}  ${skill.name}  ${skill.source}  ${status}${overrideText}`);
-        console.log(`  ${skill.path}`);
-    }
-    if (manifest.problems.length) {
-        console.log("\nProblems:");
-        for (const problem of manifest.problems) {
-            console.log(`- ${problem.message}`);
-        }
-    }
-}
-function printSkillDoctor(scope, manifest, destDir) {
-    printResolvedManifest(scope, manifest, destDir);
-    const problems = [];
-    if (!destDir) {
-        problems.push(`Mirror target for ${scope} is not discoverable on disk.`);
-    }
-    else {
-        const parentDir = path.dirname(destDir);
-        if (!fs.existsSync(path.join(parentDir, "skill-manifest.json"))) {
-            problems.push(`Missing generated manifest: ${path.join(parentDir, "skill-manifest.json")}`);
-        }
-        if (!fs.existsSync(path.join(parentDir, "skill-commands.json"))) {
-            problems.push(`Missing generated command registry: ${path.join(parentDir, "skill-commands.json")}`);
-        }
-        for (const skill of manifest.skills.filter((entry) => entry.visibleToAgents)) {
-            const dest = path.join(destDir, skill.format === "folder" ? skill.name : path.basename(skill.path));
-            try {
-                if (!fs.existsSync(dest) || fs.realpathSync(dest) !== fs.realpathSync(skill.root)) {
-                    problems.push(`Mirror drift for ${skill.name}: expected ${dest} -> ${skill.root}`);
-                }
-            }
-            catch {
-                problems.push(`Mirror drift for ${skill.name}: expected ${dest} -> ${skill.root}`);
-            }
-        }
-        // Check for user-owned files blocking phren skill links
-        const phrenPath = getPhrenPath();
-        const srcDir = scope.toLowerCase() === "global"
-            ? path.join(phrenPath, "global", "skills")
-            : path.join(phrenPath, scope, "skills");
-        const collisions = detectSkillCollisions(srcDir, destDir, phrenPath);
-        for (const collision of collisions) {
-            problems.push(`Skill collision: ${collision.message}`);
-        }
-    }
-    if (!manifest.problems.length && !problems.length) {
-        console.log("\nDoctor: no skill pipeline issues detected.");
-        return;
-    }
-    console.log("\nDoctor findings:");
-    for (const problem of [...manifest.problems.map((entry) => entry.message), ...problems]) {
-        console.log(`- ${problem}`);
-    }
-}
-export async function handleProjectsNamespace(args, profile) {
-    const subcommand = args[0];
-    if (!subcommand || subcommand === "list" || subcommand === "--help" || subcommand === "-h") {
-        if (subcommand === "--help" || subcommand === "-h") {
-            console.log("Usage:");
-            console.log("  phren projects list               List all projects");
-            console.log("  phren projects configure <name>   Update per-project enrollment settings");
-            console.log("    flags: --ownership=<mode> --hooks=on|off");
-            console.log("  phren projects remove <name>      Remove a project (asks for confirmation)");
-            console.log("  phren projects export <name>      Export project data as JSON to stdout");
-            console.log("  phren projects import <file>      Import project from a JSON file");
-            console.log("  phren projects archive <name>     Archive a project (removes from active index)");
-            console.log("  phren projects unarchive <name>   Restore an archived project");
-            return;
-        }
-        return handleProjectsList(profile);
-    }
-    if (subcommand === "add") {
-        console.error("`phren projects add` has been removed from the supported workflow.");
-        console.error("Use `cd ~/your-project && phren add` so enrollment stays path-based.");
-        process.exit(1);
-    }
-    if (subcommand === "remove") {
-        const manifest = readRootManifest(getPhrenPath());
-        if (manifest?.installMode === "project-local") {
-            console.error("projects remove is unsupported in project-local mode. Use `phren uninstall`.");
-            process.exit(1);
-        }
-        const name = args[1];
-        if (!name) {
-            console.error("Usage: phren projects remove <name>");
-            process.exit(1);
-        }
-        return handleProjectsRemove(name, profile);
-    }
-    if (subcommand === "configure") {
-        const name = args[1];
-        if (!name) {
-            console.error(`Usage: phren projects configure <name> [--ownership=${PROJECT_OWNERSHIP_MODES.join("|")}] [--hooks=on|off]`);
-            process.exit(1);
-        }
-        if (!isValidProjectName(name)) {
-            console.error(`Invalid project name: "${name}".`);
-            process.exit(1);
-        }
-        if (!fs.existsSync(path.join(getPhrenPath(), name))) {
-            console.error(`Project "${name}" not found.`);
-            process.exit(1);
-        }
-        const ownershipArg = args.find((arg) => arg.startsWith("--ownership="))?.slice("--ownership=".length);
-        const hooksArg = args.find((arg) => arg.startsWith("--hooks="))?.slice("--hooks=".length);
-        const ownership = ownershipArg ? parseProjectOwnershipMode(ownershipArg) : undefined;
-        const hooksEnabled = parseMcpToggle(hooksArg);
-        if (!ownershipArg && hooksArg === undefined) {
-            console.error(`Usage: phren projects configure <name> [--ownership=${PROJECT_OWNERSHIP_MODES.join("|")}] [--hooks=on|off]`);
-            process.exit(1);
-        }
-        if (ownershipArg && !ownership) {
-            console.error(`Usage: phren projects configure <name> [--ownership=${PROJECT_OWNERSHIP_MODES.join("|")}] [--hooks=on|off]`);
-            process.exit(1);
-        }
-        if (hooksArg !== undefined && hooksEnabled === undefined) {
-            console.error(`Invalid --hooks value "${hooksArg}". Use on or off.`);
-            process.exit(1);
-        }
-        const updates = [];
-        if (ownership) {
-            writeProjectConfig(getPhrenPath(), name, { ownership });
-            updates.push(`ownership=${ownership}`);
-        }
-        if (hooksEnabled !== undefined) {
-            writeProjectHookConfig(getPhrenPath(), name, { enabled: hooksEnabled });
-            updates.push(`hooks=${hooksEnabled ? "on" : "off"}`);
-        }
-        console.log(`Updated ${name}: ${updates.join(", ")}`);
-        return;
-    }
-    if (subcommand === "export") {
-        const name = args[1];
-        if (!name) {
-            console.error("Usage: phren projects export <name>");
-            process.exit(1);
-        }
-        if (!isValidProjectName(name)) {
-            console.error(`Invalid project name: "${name}".`);
-            process.exit(1);
-        }
-        const phrenPath = getPhrenPath();
-        const storePath = resolveProjectStorePath(phrenPath, name);
-        const projectDir = path.join(storePath, name);
-        if (!fs.existsSync(projectDir)) {
-            console.error(`Project "${name}" not found.`);
-            process.exit(1);
-        }
-        const { readFindings, readTasks, resolveTaskFilePath } = await import("../data/access.js");
-        const exported = { project: name, exportedAt: new Date().toISOString(), version: 1 };
-        const summaryPath = path.join(projectDir, "summary.md");
-        if (fs.existsSync(summaryPath))
-            exported.summary = fs.readFileSync(summaryPath, "utf8");
-        const learningsResult = readFindings(storePath, name);
-        if (learningsResult.ok)
-            exported.learnings = learningsResult.data;
-        const findingsPath = path.join(projectDir, "FINDINGS.md");
-        if (fs.existsSync(findingsPath))
-            exported.findingsRaw = fs.readFileSync(findingsPath, "utf8");
-        const taskResult = readTasks(storePath, name);
-        if (taskResult.ok) {
-            exported.task = taskResult.data.items;
-            const taskRawPath = resolveTaskFilePath(storePath, name);
-            if (taskRawPath && fs.existsSync(taskRawPath))
-                exported.taskRaw = fs.readFileSync(taskRawPath, "utf8");
-        }
-        const claudePath = path.join(projectDir, "CLAUDE.md");
-        if (fs.existsSync(claudePath))
-            exported.claudeMd = fs.readFileSync(claudePath, "utf8");
-        process.stdout.write(JSON.stringify(exported, null, 2) + "\n");
-        return;
-    }
-    if (subcommand === "import") {
-        const filePath = args[1];
-        if (!filePath) {
-            console.error("Usage: phren projects import <file>");
-            process.exit(1);
-        }
-        const resolvedPath = path.resolve(expandHomePath(filePath));
-        if (!fs.existsSync(resolvedPath)) {
-            console.error(`File not found: ${resolvedPath}`);
-            process.exit(1);
-        }
-        let rawData;
-        try {
-            rawData = fs.readFileSync(resolvedPath, "utf8");
-        }
-        catch (err) {
-            console.error(`Failed to read file: ${errorMessage(err)}`);
-            process.exit(1);
-        }
-        let decoded;
-        try {
-            decoded = JSON.parse(rawData);
-        }
-        catch {
-            console.error("Invalid JSON in file.");
-            process.exit(1);
-        }
-        if (!decoded || typeof decoded !== "object" || !decoded.project) {
-            console.error("Invalid import payload: missing project field.");
-            process.exit(1);
-        }
-        const { TASKS_FILENAME } = await import("../data/access.js");
-        const phrenPath = getPhrenPath();
-        const projectName = normalizeProjectNameForCreate(String(decoded.project));
-        if (!isValidProjectName(projectName)) {
-            console.error(`Invalid project name: "${decoded.project}".`);
-            process.exit(1);
-        }
-        const existingProject = findProjectNameCaseInsensitive(phrenPath, projectName);
-        if (existingProject && existingProject !== projectName) {
-            console.error(`Project "${existingProject}" already exists with different casing. Refusing to import "${projectName}".`);
-            process.exit(1);
-        }
-        const projectDir = path.join(phrenPath, projectName);
-        if (fs.existsSync(projectDir)) {
-            console.error(`Project "${projectName}" already exists. Remove it first or use the MCP tool with overwrite:true.`);
-            process.exit(1);
-        }
-        const imported = [];
-        const stagingRoot = fs.mkdtempSync(path.join(phrenPath, `.phren-import-${projectName}-`));
-        const stagedProjectDir = path.join(stagingRoot, projectName);
-        try {
-            fs.mkdirSync(stagedProjectDir, { recursive: true });
-            if (typeof decoded.summary === "string") {
-                fs.writeFileSync(path.join(stagedProjectDir, "summary.md"), decoded.summary);
-                imported.push("summary.md");
-            }
-            if (typeof decoded.claudeMd === "string") {
-                fs.writeFileSync(path.join(stagedProjectDir, "CLAUDE.md"), decoded.claudeMd);
-                imported.push("CLAUDE.md");
-            }
-            if (typeof decoded.findingsRaw === "string") {
-                fs.writeFileSync(path.join(stagedProjectDir, "FINDINGS.md"), decoded.findingsRaw);
-                imported.push("FINDINGS.md");
-            }
-            else if (Array.isArray(decoded.learnings) && decoded.learnings.length > 0) {
-                const date = new Date().toISOString().slice(0, 10);
-                const lines = [`# ${projectName} Findings`, "", `## ${date}`, ""];
-                for (const item of decoded.learnings) {
-                    if (item.text)
-                        lines.push(`- ${item.text}`);
-                }
-                lines.push("");
-                fs.writeFileSync(path.join(stagedProjectDir, "FINDINGS.md"), lines.join("\n"));
-                imported.push("FINDINGS.md");
-            }
-            if (typeof decoded.taskRaw === "string") {
-                fs.writeFileSync(path.join(stagedProjectDir, TASKS_FILENAME), decoded.taskRaw);
-                imported.push(TASKS_FILENAME);
-            }
-            fs.renameSync(stagedProjectDir, projectDir);
-            fs.rmSync(stagingRoot, { recursive: true, force: true });
-            console.log(`Imported project "${projectName}": ${imported.join(", ") || "(no files)"}`);
-        }
-        catch (err) {
-            try {
-                fs.rmSync(stagingRoot, { recursive: true, force: true });
-            }
-            catch { /* best-effort */ }
-            console.error(`Import failed: ${errorMessage(err)}`);
-            process.exit(1);
-        }
-        return;
-    }
-    if (subcommand === "archive" || subcommand === "unarchive") {
-        const name = args[1];
-        if (!name) {
-            console.error(`Usage: phren projects ${subcommand} <name>`);
-            process.exit(1);
-        }
-        if (!isValidProjectName(name)) {
-            console.error(`Invalid project name: "${name}".`);
-            process.exit(1);
-        }
-        const phrenPath = getPhrenPath();
-        if (subcommand === "archive") {
-            const activeProject = findProjectNameCaseInsensitive(phrenPath, name);
-            const storePath = resolveProjectStorePath(phrenPath, activeProject ?? name);
-            const projectDir = activeProject ? path.join(storePath, activeProject) : path.join(storePath, name);
-            const archiveDir = path.join(storePath, `${activeProject ?? name}.archived`);
-            if (!fs.existsSync(projectDir)) {
-                console.error(`Project "${name}" not found.`);
-                process.exit(1);
-            }
-            if (fs.existsSync(archiveDir)) {
-                console.error(`Archive "${name}.archived" already exists. Unarchive or remove it first.`);
-                process.exit(1);
-            }
-            try {
-                fs.renameSync(projectDir, archiveDir);
-                console.log(`Archived project "${name}". Data preserved at ${archiveDir}.`);
-                console.log("Note: the search index will be updated on next search.");
-            }
-            catch (err) {
-                console.error(`Archive failed: ${errorMessage(err)}`);
-                process.exit(1);
-            }
-        }
-        else {
-            const activeProject = findProjectNameCaseInsensitive(phrenPath, name);
-            if (activeProject) {
-                console.error(`Project "${activeProject}" already exists as an active project.`);
-                process.exit(1);
-            }
-            const archivedProject = findArchivedProjectNameCaseInsensitive(phrenPath, name);
-            const storePath = resolveProjectStorePath(phrenPath, archivedProject ?? name);
-            const projectDir = path.join(storePath, archivedProject ?? name);
-            const archiveDir = path.join(storePath, `${archivedProject ?? name}.archived`);
-            if (!fs.existsSync(archiveDir)) {
-                const available = fs.readdirSync(phrenPath)
-                    .filter((e) => e.endsWith(".archived"))
-                    .map((e) => e.replace(/\.archived$/, ""));
-                if (available.length > 0) {
-                    console.error(`No archive found for "${name}". Available archives: ${available.join(", ")}`);
-                }
-                else {
-                    console.error(`No archive found for "${name}".`);
-                }
-                process.exit(1);
-            }
-            try {
-                fs.renameSync(archiveDir, projectDir);
-                console.log(`Unarchived project "${archivedProject ?? name}". It is now active again.`);
-                console.log("Note: the search index will be updated on next search.");
-            }
-            catch (err) {
-                console.error(`Unarchive failed: ${errorMessage(err)}`);
-                process.exit(1);
-            }
-        }
-        return;
-    }
-    console.error(`Unknown subcommand: ${subcommand}`);
-    console.error("Usage: phren projects [list|configure|remove|export|import|archive|unarchive]");
-    process.exit(1);
-}
-function handleProjectsList(profile) {
-    const phrenPath = getPhrenPath();
-    const projectDirs = getProjectDirs(phrenPath, profile);
-    const projects = projectDirs
-        .map((dir) => path.basename(dir))
-        .filter((name) => name !== "global")
-        .sort();
-    if (!projects.length) {
-        console.log("No projects found. Run: cd ~/your-project && phren add");
-        return;
-    }
-    console.log(`\nProjects in ${phrenPath}:\n`);
-    for (const name of projects) {
-        const projectDir = path.join(phrenPath, name);
-        let dirFiles;
-        try {
-            dirFiles = new Set(fs.readdirSync(projectDir));
-        }
-        catch (err) {
-            if ((process.env.PHREN_DEBUG))
-                logger.debug("cli-namespaces", `projects list readdir: ${errorMessage(err)}`);
-            dirFiles = new Set();
-        }
-        const tags = [];
-        if (dirFiles.has("FINDINGS.md"))
-            tags.push("findings");
-        if (TASK_FILE_ALIASES.some((filename) => dirFiles.has(filename)))
-            tags.push("tasks");
-        const tagStr = tags.length ? `  [${tags.join(", ")}]` : "";
-        console.log(`  ${name}${tagStr}`);
-    }
-    console.log(`\n${projects.length} project(s) total.`);
-    console.log("Add another project: cd ~/your-project && phren add");
-}
-async function handleProjectsRemove(name, profile) {
-    if (!isValidProjectName(name)) {
-        console.error(`Invalid project name: "${name}".`);
-        process.exit(1);
-    }
-    if (name === "global") {
-        console.error('Cannot remove the "global" project.');
-        process.exit(1);
-    }
-    const phrenPath = getPhrenPath();
-    const projectDir = path.join(phrenPath, name);
-    if (!fs.existsSync(projectDir)) {
-        console.error(`Project "${name}" not found at ${projectDir}`);
-        process.exit(1);
-    }
-    let fileCount = 0;
-    const countFiles = (dir) => {
-        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
-            if (entry.isDirectory())
-                countFiles(path.join(dir, entry.name));
-            else
-                fileCount++;
-        }
-    };
-    try {
-        countFiles(projectDir);
-    }
-    catch (err) {
-        if ((process.env.PHREN_DEBUG))
-            logger.debug("cli-namespaces", `projects remove countFiles: ${errorMessage(err)}`);
-    }
-    const readline = await import("readline");
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    const answer = await new Promise((resolve) => {
-        rl.question(`Remove project "${name}" (${fileCount} file${fileCount === 1 ? "" : "s"})? This cannot be undone. Type the project name to confirm: `, (input) => { rl.close(); resolve(input.trim()); });
-    });
-    if (answer !== name) {
-        console.log("Aborted.");
-        return;
-    }
-    fs.rmSync(projectDir, { recursive: true, force: true });
-    console.log(`Removed project "${name}".`);
-    console.log(`If this project was in a profile, remove it from profiles/${profile || "personal"}.yaml manually.`);
-}
-// ── Task namespace ────────────────────────────────────────────────────────────
-function printTaskUsage() {
-    console.log("Usage:");
-    console.log('  phren task add <project> "<text>"');
-    console.log('  phren task complete <project> "<text>"');
-    console.log('  phren task remove <project> "<text>"');
-    console.log('  phren task next [project]');
-    console.log('  phren task promote <project> "<text>" [--active]');
-    console.log('  phren task tidy [project] [--keep=<n>] [--dry-run]');
-    console.log('  phren task link <project> "<text>" --issue <number> [--url <url>]');
-    console.log('  phren task link <project> "<text>" --unlink');
-    console.log('  phren task create-issue <project> "<text>" [--repo <owner/name>] [--title "<title>"] [--done]');
-    console.log('  phren task update <project> "<text>" [--priority=high|medium|low] [--section=Active|Queue|Done] [--context="..."]');
-    console.log('  phren task pin <project> "<text>"');
-    console.log('  phren task reorder <project> "<text>" --rank=<n>');
-}
-export async function handleTaskNamespace(args) {
-    const subcommand = args[0];
-    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
-        printTaskUsage();
-        return;
-    }
-    if (subcommand === "list") {
-        // Delegate to the cross-project task view (same as `phren tasks`)
-        const { handleTaskView } = await import("./ops.js");
-        return handleTaskView(args[1] || "default");
-    }
-    if (subcommand === "add") {
-        const project = args[1];
-        const text = args.slice(2).join(" ");
-        if (!project || !text) {
-            console.error('Usage: phren task add <project> "<text>"');
-            process.exit(1);
-        }
-        const result = addTask(getPhrenPath(), project, text);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(`Task added: ${result.data.line}`);
-        return;
-    }
-    if (subcommand === "complete") {
-        const project = args[1];
-        const match = args.slice(2).join(" ");
-        if (!project || !match) {
-            console.error('Usage: phren task complete <project> "<text>"');
-            process.exit(1);
-        }
-        const result = completeTask(getPhrenPath(), project, match);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(result.data);
-        return;
-    }
-    if (subcommand === "update") {
-        const project = args[1];
-        if (!project) {
-            printTaskUsage();
-            process.exit(1);
-        }
-        // Collect non-flag args as the match text, flags as updates
-        const positional = [];
-        const updates = {};
-        for (const arg of args.slice(2)) {
-            if (arg.startsWith("--priority=")) {
-                updates.priority = arg.slice("--priority=".length);
-            }
-            else if (arg.startsWith("--section=")) {
-                updates.section = arg.slice("--section=".length);
-            }
-            else if (arg.startsWith("--context=")) {
-                updates.context = arg.slice("--context=".length);
-            }
-            else if (!arg.startsWith("--")) {
-                positional.push(arg);
-            }
-        }
-        const match = positional.join(" ");
-        if (!match) {
-            printTaskUsage();
-            process.exit(1);
-        }
-        const result = updateTask(getPhrenPath(), project, match, updates);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(result.data);
-        return;
-    }
-    if (subcommand === "pin") {
-        const project = args[1];
-        const match = args.slice(2).join(" ");
-        if (!project || !match) {
-            console.error('Usage: phren task pin <project> "<text>"');
-            process.exit(1);
-        }
-        const result = pinTask(getPhrenPath(), project, match);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(result.data);
-        return;
-    }
-    if (subcommand === "reorder") {
-        const project = args[1];
-        if (!project) {
-            printTaskUsage();
-            process.exit(1);
-        }
-        const positional = [];
-        let rankArg;
-        for (const arg of args.slice(2)) {
-            if (arg.startsWith("--rank=")) {
-                rankArg = arg.slice("--rank=".length);
-            }
-            else if (!arg.startsWith("--")) {
-                positional.push(arg);
-            }
-        }
-        const match = positional.join(" ");
-        const rank = rankArg ? Number.parseInt(rankArg, 10) : Number.NaN;
-        if (!match || !rankArg || !Number.isFinite(rank) || rank < 1) {
-            console.error('Usage: phren task reorder <project> "<text>" --rank=<n>');
-            process.exit(1);
-        }
-        const result = reorderTask(getPhrenPath(), project, match, rank);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(result.data);
-        return;
-    }
-    if (subcommand === "remove") {
-        const project = args[1];
-        const match = args.slice(2).join(" ");
-        if (!project || !match) {
-            console.error('Usage: phren task remove <project> "<text>"');
-            process.exit(1);
-        }
-        const result = removeTask(getPhrenPath(), project, match);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(result.data);
-        return;
-    }
-    if (subcommand === "next") {
-        const project = args[1];
-        if (!project) {
-            console.error("Usage: phren task next <project>");
-            process.exit(1);
-        }
-        const result = workNextTask(getPhrenPath(), project);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(result.data);
-        return;
-    }
-    if (subcommand === "promote") {
-        const project = args[1];
-        if (!project) {
-            printTaskUsage();
-            process.exit(1);
-        }
-        const positional = [];
-        let moveToActive = false;
-        for (const arg of args.slice(2)) {
-            if (arg === "--active") {
-                moveToActive = true;
-            }
-            else if (!arg.startsWith("--")) {
-                positional.push(arg);
-            }
-        }
-        const match = positional.join(" ");
-        if (!match) {
-            console.error('Usage: phren task promote <project> "<text>" [--active]');
-            process.exit(1);
-        }
-        const result = promoteTask(getPhrenPath(), project, match, moveToActive);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(`Promoted task "${result.data.line}" in ${project}${moveToActive ? " (moved to Active)" : ""}.`);
-        return;
-    }
-    if (subcommand === "tidy") {
-        const project = args[1];
-        if (!project) {
-            console.error("Usage: phren task tidy <project> [--keep=<n>] [--dry-run]");
-            process.exit(1);
-        }
-        let keep = 30;
-        let dryRun = false;
-        for (const arg of args.slice(2)) {
-            if (arg.startsWith("--keep=")) {
-                const n = Number.parseInt(arg.slice("--keep=".length), 10);
-                if (Number.isFinite(n) && n > 0)
-                    keep = n;
-            }
-            else if (arg === "--dry-run") {
-                dryRun = true;
-            }
-        }
-        const result = tidyDoneTasks(getPhrenPath(), project, keep, dryRun);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(result.data);
-        return;
-    }
-    if (subcommand === "link") {
-        const project = args[1];
-        if (!project) {
-            printTaskUsage();
-            process.exit(1);
-        }
-        const positional = [];
-        let issueArg;
-        let urlArg;
-        let unlink = false;
-        const rest = args.slice(2);
-        for (let i = 0; i < rest.length; i++) {
-            const arg = rest[i];
-            if (arg === "--issue" || arg === "-i") {
-                issueArg = rest[++i];
-            }
-            else if (arg.startsWith("--issue=")) {
-                issueArg = arg.slice("--issue=".length);
-            }
-            else if (arg === "--url") {
-                urlArg = rest[++i];
-            }
-            else if (arg.startsWith("--url=")) {
-                urlArg = arg.slice("--url=".length);
-            }
-            else if (arg === "--unlink") {
-                unlink = true;
-            }
-            else if (!arg.startsWith("--")) {
-                positional.push(arg);
-            }
-        }
-        const match = positional.join(" ");
-        if (!match) {
-            console.error('Usage: phren task link <project> "<text>" --issue <number>');
-            process.exit(1);
-        }
-        if (!unlink && !issueArg && !urlArg) {
-            console.error("Provide --issue <number> or --url <url> to link, or --unlink to remove the link.");
-            process.exit(1);
-        }
-        if (urlArg) {
-            const parsed = parseGithubIssueUrl(urlArg);
-            if (!parsed) {
-                console.error("--url must be a valid GitHub issue URL.");
-                process.exit(1);
-            }
-        }
-        const result = linkTaskIssue(getPhrenPath(), project, match, {
-            github_issue: issueArg,
-            github_url: urlArg,
-            unlink: unlink,
-        });
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        if (unlink) {
-            console.log(`Removed GitHub link from ${project} task.`);
-        }
-        else {
-            console.log(`Linked ${project} task to ${result.data.githubIssue ? `#${result.data.githubIssue}` : result.data.githubUrl}.`);
-        }
-        return;
-    }
-    if (subcommand === "create-issue") {
-        const project = args[1];
-        if (!project) {
-            printTaskUsage();
-            process.exit(1);
-        }
-        const positional = [];
-        let repoArg;
-        let titleArg;
-        let markDone = false;
-        const rest = args.slice(2);
-        for (let i = 0; i < rest.length; i++) {
-            const arg = rest[i];
-            if (arg === "--repo") {
-                repoArg = rest[++i];
-            }
-            else if (arg.startsWith("--repo=")) {
-                repoArg = arg.slice("--repo=".length);
-            }
-            else if (arg === "--title") {
-                titleArg = rest[++i];
-            }
-            else if (arg.startsWith("--title=")) {
-                titleArg = arg.slice("--title=".length);
-            }
-            else if (arg === "--done") {
-                markDone = true;
-            }
-            else if (!arg.startsWith("--")) {
-                positional.push(arg);
-            }
-        }
-        const match = positional.join(" ");
-        if (!match) {
-            console.error('Usage: phren task create-issue <project> "<text>" [--repo <owner/name>] [--title "<title>"] [--done]');
-            process.exit(1);
-        }
-        const phrenPath = getPhrenPath();
-        const resolved = resolveTaskItem(phrenPath, project, match);
-        if (!resolved.ok) {
-            console.error(resolved.error);
-            process.exit(1);
-        }
-        const targetRepo = repoArg || resolveProjectGithubRepo(phrenPath, project);
-        if (!targetRepo) {
-            console.error("Could not infer a GitHub repo. Provide --repo <owner/name> or add a GitHub URL to CLAUDE.md/summary.md.");
-            process.exit(1);
-        }
-        const created = createGithubIssueForTask({
-            repo: targetRepo,
-            title: titleArg?.trim() || resolved.data.line.replace(/\s*\[(high|medium|low)\]\s*$/i, "").trim(),
-            body: buildTaskIssueBody(project, resolved.data),
-        });
-        if (!created.ok) {
-            console.error(created.error);
-            process.exit(1);
-        }
-        const linked = linkTaskIssue(phrenPath, project, resolved.data.stableId ? `bid:${resolved.data.stableId}` : resolved.data.id, {
-            github_issue: created.data.issueNumber,
-            github_url: created.data.url,
-        });
-        if (!linked.ok) {
-            console.error(linked.error);
-            process.exit(1);
-        }
-        if (markDone) {
-            const completionMatch = linked.data.stableId ? `bid:${linked.data.stableId}` : linked.data.id;
-            const completed = completeTask(phrenPath, project, completionMatch);
-            if (!completed.ok) {
-                console.error(completed.error);
-                process.exit(1);
-            }
-        }
-        console.log(`Created GitHub issue ${created.data.issueNumber ? `#${created.data.issueNumber}` : created.data.url} for ${project} task.`);
-        return;
-    }
-    console.error(`Unknown task subcommand: ${subcommand}`);
-    printTaskUsage();
-    process.exit(1);
-}
-// ── Finding namespace ─────────────────────────────────────────────────────────
-function printFindingUsage() {
-    console.log("Usage:");
-    console.log('  phren finding add <project> "<text>"');
-    console.log('  phren finding remove <project> "<text>"');
-    console.log('  phren finding supersede <project> "<text>" --by "<newer guidance>"');
-    console.log('  phren finding retract <project> "<text>" --reason "<reason>"');
-    console.log('  phren finding contradictions [project]');
-    console.log('  phren finding resolve <project> "<finding_text>" "<other_text>" <keep_a|keep_b|keep_both|retract_both>');
-}
-export async function handleFindingNamespace(args) {
-    const subcommand = args[0];
-    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
-        printFindingUsage();
-        return;
-    }
-    if (subcommand === "list") {
-        const project = args[1];
-        if (!project) {
-            console.error("Usage: phren finding list <project>");
-            process.exit(1);
-        }
-        const phrenPath = getPhrenPath();
-        const { readFindings } = await import("../data/access.js");
-        const storePath = resolveProjectStorePath(phrenPath, project);
-        const result = readFindings(storePath, project);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        const items = result.data;
-        if (!items.length) {
-            console.log(`No findings found for "${project}".`);
-            return;
-        }
-        for (const entry of items.slice(0, 50)) {
-            console.log(`- [${entry.id}] ${entry.date}: ${entry.text}`);
-        }
-        return;
-    }
-    if (subcommand === "add") {
-        const project = args[1];
-        const text = args.slice(2).join(" ");
-        if (!project || !text) {
-            console.error('Usage: phren finding add <project> "<text>"');
-            process.exit(1);
-        }
-        const result = addFinding(getPhrenPath(), project, text);
-        if (!result.ok) {
-            console.error(result.message);
-            process.exit(1);
-        }
-        console.log(result.message);
-        return;
-    }
-    if (subcommand === "remove") {
-        const project = args[1];
-        const text = args.slice(2).join(" ");
-        if (!project || !text) {
-            console.error('Usage: phren finding remove <project> "<text>"');
-            process.exit(1);
-        }
-        const result = removeFinding(getPhrenPath(), project, text);
-        if (!result.ok) {
-            console.error(result.message);
-            process.exit(1);
-        }
-        console.log(result.message);
-        return;
-    }
-    if (subcommand === "supersede") {
-        const project = args[1];
-        if (!project) {
-            console.error('Usage: phren finding supersede <project> "<text>" --by "<newer guidance>"');
-            process.exit(1);
-        }
-        const rest = args.slice(2);
-        const byIdx = rest.indexOf("--by");
-        const byEqIdx = rest.findIndex(a => a.startsWith("--by="));
-        let text;
-        let byValue;
-        if (byEqIdx !== -1) {
-            byValue = rest[byEqIdx].slice("--by=".length);
-            text = rest.filter((_, i) => i !== byEqIdx && !rest[i].startsWith("--")).join(" ");
-        }
-        else if (byIdx !== -1) {
-            text = rest.slice(0, byIdx).join(" ");
-            byValue = rest.slice(byIdx + 1).join(" ");
-        }
-        else {
-            text = "";
-            byValue = "";
-        }
-        if (!text || !byValue) {
-            console.error('Usage: phren finding supersede <project> "<text>" --by "<newer guidance>"');
-            process.exit(1);
-        }
-        const result = supersedeFinding(getPhrenPath(), project, text, byValue);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(`Finding superseded: "${result.data.finding}" -> "${result.data.superseded_by}"`);
-        return;
-    }
-    if (subcommand === "retract") {
-        const project = args[1];
-        if (!project) {
-            console.error('Usage: phren finding retract <project> "<text>" --reason "<reason>"');
-            process.exit(1);
-        }
-        const rest = args.slice(2);
-        const reasonIdx = rest.indexOf("--reason");
-        const reasonEqIdx = rest.findIndex(a => a.startsWith("--reason="));
-        let text;
-        let reasonValue;
-        if (reasonEqIdx !== -1) {
-            reasonValue = rest[reasonEqIdx].slice("--reason=".length);
-            text = rest.filter((_, i) => i !== reasonEqIdx && !rest[i].startsWith("--")).join(" ");
-        }
-        else if (reasonIdx !== -1) {
-            text = rest.slice(0, reasonIdx).join(" ");
-            reasonValue = rest.slice(reasonIdx + 1).join(" ");
-        }
-        else {
-            text = "";
-            reasonValue = "";
-        }
-        if (!text || !reasonValue) {
-            console.error('Usage: phren finding retract <project> "<text>" --reason "<reason>"');
-            process.exit(1);
-        }
-        const result = retractFinding(getPhrenPath(), project, text, reasonValue);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(`Finding retracted: "${result.data.finding}" (reason: ${result.data.reason})`);
-        return;
-    }
-    if (subcommand === "contradictions") {
-        const project = args[1];
-        const phrenPath = getPhrenPath();
-        const RESERVED_DIRS = new Set(["global", ".runtime", ".sessions", ".config"]);
-        const { readFindings } = await import("../data/access.js");
-        const projects = project
-            ? [project]
-            : fs.readdirSync(phrenPath, { withFileTypes: true })
-                .filter((entry) => entry.isDirectory() && !RESERVED_DIRS.has(entry.name) && isValidProjectName(entry.name))
-                .map((entry) => entry.name);
-        const contradictions = [];
-        for (const p of projects) {
-            const result = readFindings(phrenPath, p);
-            if (!result.ok)
-                continue;
-            for (const finding of result.data) {
-                if (finding.status !== "contradicted")
-                    continue;
-                contradictions.push({ project: p, id: finding.id, text: finding.text, date: finding.date, status_ref: finding.status_ref });
-            }
-        }
-        if (!contradictions.length) {
-            console.log("No unresolved contradictions found.");
-            return;
-        }
-        console.log(`${contradictions.length} unresolved contradiction(s):\n`);
-        for (const c of contradictions) {
-            console.log(`[${c.project}] ${c.date}  ${c.id}`);
-            console.log(`  ${c.text}`);
-            if (c.status_ref)
-                console.log(`  contradicts: ${c.status_ref}`);
-            console.log("");
-        }
-        return;
-    }
-    if (subcommand === "resolve") {
-        const project = args[1];
-        const findingText = args[2];
-        const otherText = args[3];
-        const resolution = args[4];
-        const validResolutions = ["keep_a", "keep_b", "keep_both", "retract_both"];
-        if (!project || !findingText || !otherText || !resolution) {
-            console.error('Usage: phren finding resolve <project> "<finding_text>" "<other_text>" <keep_a|keep_b|keep_both|retract_both>');
-            process.exit(1);
-        }
-        if (!validResolutions.includes(resolution)) {
-            console.error(`Invalid resolution "${resolution}". Valid values: ${validResolutions.join(", ")}`);
-            process.exit(1);
-        }
-        const result = resolveFindingContradiction(getPhrenPath(), project, findingText, otherText, resolution);
-        if (!result.ok) {
-            console.error(result.error);
-            process.exit(1);
-        }
-        console.log(`Resolved contradiction in "${project}" with "${resolution}".`);
-        console.log(`  finding_a: ${result.data.finding_a.text} → ${result.data.finding_a.status}`);
-        console.log(`  finding_b: ${result.data.finding_b.text} → ${result.data.finding_b.status}`);
-        return;
-    }
-    console.error(`Unknown finding subcommand: ${subcommand}`);
-    printFindingUsage();
-    process.exit(1);
-}
-// ── Store namespace ──────────────────────────────────────────────────────────
-function printStoreUsage() {
-    console.log("Usage:");
-    console.log("  phren store list                        List registered stores");
-    console.log("  phren store add <name> --remote <url>   Add a team store");
-    console.log("  phren store remove <name>               Remove a store (local only)");
-    console.log("  phren store sync                        Pull all stores");
-    console.log("  phren store activity [--limit N]         Recent team findings");
-    console.log("  phren store subscribe <name> <project...>   Subscribe store to projects");
-    console.log("  phren store unsubscribe <name> <project...> Unsubscribe store from projects");
-}
-export async function handleStoreNamespace(args) {
-    const subcommand = args[0];
-    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
-        printStoreUsage();
-        return;
-    }
-    const phrenPath = getPhrenPath();
-    if (subcommand === "list") {
-        const stores = resolveAllStores(phrenPath);
-        if (stores.length === 0) {
-            console.log("No stores registered.");
-            return;
-        }
-        console.log(`${stores.length} store(s):\n`);
-        for (const store of stores) {
-            const exists = fs.existsSync(store.path) ? "ok" : "MISSING";
-            const syncInfo = store.remote ?? "(local)";
-            const projectCount = countStoreProjects(store);
-            console.log(`  ${store.name} (${store.role})`);
-            console.log(`    id:       ${store.id}`);
-            console.log(`    path:     ${store.path} [${exists}]`);
-            console.log(`    remote:   ${syncInfo}`);
-            console.log(`    sync:     ${store.sync}`);
-            console.log(`    projects: ${projectCount}`);
-            // Show last sync status if available
-            const health = readHealthForStore(store.path);
-            if (health) {
-                console.log(`    last sync: ${health}`);
-            }
-            console.log();
-        }
-        return;
-    }
-    if (subcommand === "add") {
-        const name = args[1];
-        if (!name) {
-            console.error("Usage: phren store add <name> --remote <url> [--role team|readonly]");
-            process.exit(1);
-        }
-        // Validate store name to prevent path traversal
-        if (!isValidProjectName(name)) {
-            console.error(`Invalid store name: "${name}". Use lowercase letters, numbers, and hyphens.`);
-            process.exit(1);
-        }
-        const remote = getOptionValue(args.slice(2), "--remote");
-        if (!remote) {
-            console.error("--remote <url> is required. Provide the git clone URL for the team store.");
-            process.exit(1);
-        }
-        // Prevent git option injection via --remote
-        if (remote.startsWith("-")) {
-            console.error(`Invalid remote URL: "${remote}". URLs must not start with "-".`);
-            process.exit(1);
-        }
-        const roleArg = getOptionValue(args.slice(2), "--role") ?? "team";
-        if (roleArg !== "team" && roleArg !== "readonly") {
-            console.error(`Invalid role: "${roleArg}". Use "team" or "readonly".`);
-            process.exit(1);
-        }
-        const storesDir = path.join(path.dirname(phrenPath), ".phren-stores");
-        const storePath = path.join(storesDir, name);
-        if (fs.existsSync(storePath)) {
-            console.error(`Directory already exists: ${storePath}`);
-            process.exit(1);
-        }
-        // Clone the remote
-        console.log(`Cloning ${remote} into ${storePath}...`);
-        try {
-            fs.mkdirSync(storesDir, { recursive: true });
-            execFileSync("git", ["clone", "--", remote, storePath], {
-                stdio: "inherit",
-                timeout: 60_000,
-            });
-        }
-        catch (err) {
-            console.error(`Clone failed: ${errorMessage(err)}`);
-            process.exit(1);
-        }
-        // Read .phren-team.yaml if present
-        const bootstrap = readTeamBootstrap(storePath);
-        const storeName = bootstrap?.name ?? name;
-        const storeRole = bootstrap?.default_role ?? roleArg;
-        const entry = {
-            id: generateStoreId(),
-            name: storeName,
-            path: storePath,
-            role: storeRole === "primary" ? "team" : storeRole, // Never allow adding a second primary
-            sync: storeRole === "readonly" ? "pull-only" : "managed-git",
-            remote,
-        };
-        try {
-            addStoreToRegistry(phrenPath, entry);
-        }
-        catch (err) {
-            console.error(`Failed to register store: ${errorMessage(err)}`);
-            process.exit(1);
-        }
-        console.log(`\nStore "${storeName}" added (${entry.role}).`);
-        console.log(`  id:   ${entry.id}`);
-        console.log(`  path: ${storePath}`);
-        return;
-    }
-    if (subcommand === "remove") {
-        const name = args[1];
-        if (!name) {
-            console.error("Usage: phren store remove <name>");
-            process.exit(1);
-        }
-        try {
-            const removed = removeStoreFromRegistry(phrenPath, name);
-            console.log(`Store "${name}" removed from registry.`);
-            console.log(`  Local directory preserved at: ${removed.path}`);
-            console.log(`  To delete: rm -rf "${removed.path}"`);
-        }
-        catch (err) {
-            console.error(`${errorMessage(err)}`);
-            process.exit(1);
-        }
-        return;
-    }
-    if (subcommand === "activity") {
-        const stores = resolveAllStores(phrenPath);
-        const teamStores = stores.filter((s) => s.role === "team");
-        if (teamStores.length === 0) {
-            console.log("No team stores registered. Add one with: phren store add <name> --remote <url>");
-            return;
-        }
-        const { readTeamJournalEntries } = await import("../finding/journal.js");
-        const limit = Number(getOptionValue(args.slice(1), "--limit") ?? "20");
-        const allEntries = [];
-        for (const store of teamStores) {
-            if (!fs.existsSync(store.path))
-                continue;
-            const { getStoreProjectDirs } = await import("../store-registry.js");
-            const projectDirs = getStoreProjectDirs(store);
-            for (const dir of projectDirs) {
-                const projectName = path.basename(dir);
-                const journalEntries = readTeamJournalEntries(store.path, projectName);
-                for (const je of journalEntries) {
-                    for (const entry of je.entries) {
-                        allEntries.push({ store: store.name, project: projectName, date: je.date, actor: je.actor, entry });
-                    }
-                }
-            }
-        }
-        allEntries.sort((a, b) => b.date.localeCompare(a.date));
-        const capped = allEntries.slice(0, limit);
-        if (capped.length === 0) {
-            console.log("No team activity yet.");
-            return;
-        }
-        console.log(`Team activity (${capped.length}/${allEntries.length}):\n`);
-        let lastDate = "";
-        for (const e of capped) {
-            if (e.date !== lastDate) {
-                console.log(`## ${e.date}`);
-                lastDate = e.date;
-            }
-            console.log(`  [${e.store}/${e.project}] ${e.actor}: ${e.entry}`);
-        }
-        return;
-    }
-    if (subcommand === "sync") {
-        const stores = resolveAllStores(phrenPath);
-        let hasErrors = false;
-        for (const store of stores) {
-            if (!fs.existsSync(store.path)) {
-                console.log(`  ${store.name}: SKIP (path missing)`);
-                continue;
-            }
-            const gitDir = path.join(store.path, ".git");
-            if (!fs.existsSync(gitDir)) {
-                console.log(`  ${store.name}: SKIP (not a git repo)`);
-                continue;
-            }
-            try {
-                execFileSync("git", ["pull", "--rebase", "--quiet"], {
-                    cwd: store.path,
-                    stdio: "pipe",
-                    timeout: 30_000,
-                });
-                // Re-apply sparse-checkout after pull on primary store to avoid materializing all files
-                if (store.role === "primary") {
-                    try {
-                        const sparseList = execFileSync("git", ["sparse-checkout", "list"], {
-                            cwd: store.path,
-                            stdio: "pipe",
-                            timeout: 10_000,
-                        }).toString().trim();
-                        if (sparseList) {
-                            execFileSync("git", ["sparse-checkout", "reapply"], {
-                                cwd: store.path,
-                                stdio: "pipe",
-                                timeout: 10_000,
-                            });
-                        }
-                    }
-                    catch {
-                        // sparse-checkout not configured — nothing to reapply
-                    }
-                }
-                console.log(`  ${store.name}: ok`);
-            }
-            catch (err) {
-                console.log(`  ${store.name}: FAILED (${errorMessage(err).split("\n")[0]})`);
-                hasErrors = true;
-            }
-        }
-        if (hasErrors) {
-            console.error("\nSome stores failed to sync. Run 'phren doctor' for details.");
-        }
-        return;
-    }
-    if (subcommand === "subscribe") {
-        const storeName = args[1];
-        const projects = args.slice(2);
-        if (!storeName || projects.length === 0) {
-            console.error("Usage: phren store subscribe <store-name> <project1> [project2...]");
-            process.exit(1);
-        }
-        try {
-            const { subscribeStoreProjects } = await import("../store-registry.js");
-            subscribeStoreProjects(phrenPath, storeName, projects);
-            console.log(`Added ${projects.length} project(s) to "${storeName}"`);
-        }
-        catch (err) {
-            console.error(`Failed to subscribe: ${errorMessage(err)}`);
-            process.exit(1);
-        }
-        return;
-    }
-    if (subcommand === "unsubscribe") {
-        const storeName = args[1];
-        const projects = args.slice(2);
-        if (!storeName || projects.length === 0) {
-            console.error("Usage: phren store unsubscribe <store-name> <project1> [project2...]");
-            process.exit(1);
-        }
-        try {
-            const { unsubscribeStoreProjects } = await import("../store-registry.js");
-            unsubscribeStoreProjects(phrenPath, storeName, projects);
-            console.log(`Removed ${projects.length} project(s) from "${storeName}"`);
-        }
-        catch (err) {
-            console.error(`Failed to unsubscribe: ${errorMessage(err)}`);
-            process.exit(1);
-        }
-        return;
-    }
-    console.error(`Unknown store subcommand: ${subcommand}`);
-    printStoreUsage();
-    process.exit(1);
-}
-// ── Profile namespace ────────────────────────────────────────────────────────
-function printProfileUsage() {
-    console.log("Usage:");
-    console.log("  phren profile list                  List all available profiles");
-    console.log("  phren profile switch <name>         Switch to an active profile");
-}
-export function handleProfileNamespace(args) {
-    const subcommand = args[0];
-    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
-        printProfileUsage();
-        return;
-    }
-    const phrenPath = getPhrenPath();
-    if (subcommand === "list") {
-        const { listProfiles } = require("../profile-store.js");
-        const result = listProfiles(phrenPath);
-        if (!result.ok) {
-            console.error(`Failed to list profiles: ${result.error}`);
-            process.exit(1);
-        }
-        const profiles = result.data || [];
-        if (profiles.length === 0) {
-            console.log("No profiles available.");
-            return;
-        }
-        const { listMachines } = require("../profile-store.js");
-        const machinesResult = listMachines(phrenPath);
-        const machines = machinesResult.ok ? machinesResult.data : {};
-        const { getMachineName } = require("../machine-identity.js");
-        const currentMachine = getMachineName();
-        const activeProfile = machines[currentMachine];
-        console.log(`${profiles.length} profile(s):\n`);
-        for (const profile of profiles) {
-            const isCurrent = profile.name === activeProfile ? " (current)" : "";
-            const projectCount = profile.projects?.length ?? 0;
-            console.log(`  ${profile.name}${isCurrent}`);
-            console.log(`    projects: ${projectCount}`);
-            console.log();
-        }
-        return;
-    }
-    if (subcommand === "switch") {
-        const profileName = args[1];
-        if (!profileName) {
-            console.error("Usage: phren profile switch <name>");
-            process.exit(1);
-        }
-        const { setMachineProfile, getDefaultMachineAlias, listProfiles } = require("../profile-store.js");
-        // Validate that profile exists
-        const listResult = listProfiles(phrenPath);
-        if (!listResult.ok) {
-            console.error(`Failed to list profiles: ${listResult.error}`);
-            process.exit(1);
-        }
-        const profiles = listResult.data || [];
-        if (!profiles.some((p) => p.name === profileName)) {
-            console.error(`Profile not found: "${profileName}"`);
-            console.log("Available profiles:");
-            for (const p of profiles) {
-                console.log(`  - ${p.name}`);
-            }
-            process.exit(1);
-        }
-        const machineAlias = getDefaultMachineAlias();
-        const result = setMachineProfile(phrenPath, machineAlias, profileName);
-        if (!result.ok) {
-            console.error(`Failed to switch profile: ${result.error}`);
-            process.exit(1);
-        }
-        console.log(`Switched to profile: ${profileName} (machine: ${machineAlias})`);
-        return;
-    }
-    console.error(`Unknown profile subcommand: ${subcommand}`);
-    printProfileUsage();
-    process.exit(1);
-}
-// ── Promote namespace ────────────────────────────────────────────────────────
-export async function handlePromoteNamespace(args) {
-    if (!args[0] || args[0] === "--help" || args[0] === "-h") {
-        console.log("Usage:");
-        console.log('  phren promote <project> "finding text..." --to <store>');
-        console.log("  Copies a finding from the primary store to a team store.");
-        return;
-    }
-    const phrenPath = getPhrenPath();
-    const project = args[0];
-    if (!isValidProjectName(project)) {
-        console.error(`Invalid project name: "${project}"`);
-        process.exit(1);
-    }
-    const toStore = getOptionValue(args.slice(1), "--to");
-    if (!toStore) {
-        console.error("--to <store> is required. Specify the target team store.");
-        process.exit(1);
-    }
-    // Everything between project and --to is the finding text
-    const toIdx = args.indexOf("--to");
-    const findingText = args.slice(1, toIdx !== -1 ? toIdx : undefined).join(" ").trim();
-    if (!findingText) {
-        console.error("Finding text is required.");
-        process.exit(1);
-    }
-    const stores = resolveAllStores(phrenPath);
-    const targetStore = stores.find((s) => s.name === toStore);
-    if (!targetStore) {
-        const available = stores.map((s) => s.name).join(", ");
-        console.error(`Store "${toStore}" not found. Available: ${available}`);
-        process.exit(1);
-    }
-    if (targetStore.role === "readonly") {
-        console.error(`Store "${toStore}" is read-only.`);
-        process.exit(1);
-    }
-    if (targetStore.role === "primary") {
-        console.error(`Cannot promote to primary store — finding is already there.`);
-        process.exit(1);
-    }
-    // Find the matching finding in the primary store
-    const { readFindings } = await import("../data/access.js");
-    const findingsResult = readFindings(phrenPath, project);
-    if (!findingsResult.ok) {
-        console.error(`Could not read findings for project "${project}".`);
-        process.exit(1);
-    }
-    const match = findingsResult.data.find((item) => item.text.includes(findingText) || findingText.includes(item.text));
-    if (!match) {
-        console.error(`No finding matching "${findingText.slice(0, 80)}..." found in ${project}.`);
-        process.exit(1);
-    }
-    // Write to target store
-    const targetProjectDir = path.join(targetStore.path, project);
-    fs.mkdirSync(targetProjectDir, { recursive: true });
-    const { addFindingToFile } = await import("../shared/content.js");
-    const result = addFindingToFile(targetStore.path, project, match.text);
-    if (!result.ok) {
-        console.error(`Failed to add finding to ${toStore}: ${result.error}`);
-        process.exit(1);
-    }
-    console.log(`Promoted to ${toStore}/${project}:`);
-    console.log(`  "${match.text.slice(0, 120)}${match.text.length > 120 ? "..." : ""}"`);
-}
-// ── Review namespace ────────────────────────────────────────────────────────
-export async function handleReviewNamespace(args) {
-    const subcommand = args[0];
-    if (!subcommand || subcommand === "--help" || subcommand === "-h") {
-        console.log("Usage:");
-        console.log("  phren review [project]                       Show review queue items");
-        console.log("  phren review approve <project> <text>        Approve and remove item");
-        console.log("  phren review reject <project> <text>         Reject and remove item");
-        console.log("");
-        console.log("Examples:");
-        console.log('  phren review myproject');
-        console.log('  phren review approve myproject "Always validate input"');
-        console.log('  phren review reject myproject "Avoid async in loops"');
-        return;
-    }
-    // Handle "approve" and "reject" subcommands
-    if (subcommand === "approve" || subcommand === "reject") {
-        const action = subcommand;
-        const project = args[1];
-        const lineText = args.slice(2).join(" ");
-        if (!project || !lineText) {
-            console.error(`Usage: phren review ${action} <project> <text>`);
-            process.exit(1);
-        }
-        if (!isValidProjectName(project)) {
-            console.error(`Invalid project name: "${project}".`);
-            process.exit(1);
-        }
-        const phrenPath = getPhrenPath();
-        const { approveQueueItem, rejectQueueItem } = await import("../data/access.js");
-        const result = action === "approve"
-            ? approveQueueItem(phrenPath, project, lineText)
-            : rejectQueueItem(phrenPath, project, lineText);
-        if (!result.ok) {
-            console.error(`Failed to ${action} item: ${result.error ?? "Unknown error"}`);
-            process.exit(1);
-        }
-        console.log(`${action === "approve" ? "✓ Approved" : "✗ Rejected"}: ${lineText.slice(0, 100)}${lineText.length > 100 ? "..." : ""}`);
-        return;
-    }
-    // Default: show review queue (first arg is project name if not a subcommand)
-    const { handleReview } = await import("./actions.js");
-    return handleReview(args);
-}
-function countStoreProjects(store) {
-    if (!fs.existsSync(store.path))
-        return 0;
-    try {
-        const storeRegistry = require("../store-registry.js");
-        return storeRegistry.getStoreProjectDirs(store).length;
-    }
-    catch {
-        return 0;
-    }
-}
-function readHealthForStore(storePath) {
-    try {
-        const healthPath = path.join(storePath, ".runtime", "health.json");
-        if (!fs.existsSync(healthPath))
-            return null;
-        const raw = JSON.parse(fs.readFileSync(healthPath, "utf8"));
-        const lastSync = raw?.lastSync;
-        if (!lastSync)
-            return null;
-        const parts = [];
-        if (lastSync.lastPullStatus)
-            parts.push(`pull=${lastSync.lastPullStatus}`);
-        if (lastSync.lastPushStatus)
-            parts.push(`push=${lastSync.lastPushStatus}`);
-        if (lastSync.lastSuccessfulPullAt)
-            parts.push(`at=${lastSync.lastSuccessfulPullAt.slice(0, 16)}`);
-        return parts.join(", ") || null;
-    }
-    catch {
-        return null;
-    }
-}
+// Re-export all namespace handlers from domain-specific modules
+export { handleSkillsNamespace, handleHooksNamespace, handleSkillList, handleDetectSkills } from "./namespaces-skills.js";
+export { handleProjectsNamespace } from "./namespaces-projects.js";
+export { handleTaskNamespace } from "./namespaces-tasks.js";
+export { handleFindingNamespace } from "./namespaces-findings.js";
+export { handleStoreNamespace, handlePromoteNamespace } from "./namespaces-store.js";
+export { handleProfileNamespace } from "./namespaces-profile.js";
+export { handleReviewNamespace } from "./namespaces-review.js";