youmd 0.8.0 → 0.8.5

package/dist/commands/project.js

@@ -40,12 +40,18 @@ exports.projectCommand = projectCommand;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const readline = __importStar(require("readline"));
+const child_process_1 = require("child_process");
 const chalk_1 = __importDefault(require("chalk"));
 const project_1 = require("../lib/project");
 const project_log_1 = require("./project-log");
 const config_1 = require("../lib/config");
+const api_1 = require("../lib/api");
 const projectContext_1 = require("../lib/projectContext");
+const portfolio_audit_1 = require("../lib/portfolio-audit");
+const reusable_patterns_1 = require("../lib/reusable-patterns");
+const project_strategy_1 = require("../lib/project-strategy");
 // ─── Helpers ──────────────────────────────────────────────────────────
+const ACCENT = chalk_1.default.hex("#C46A3A");
 function createRL() {
     return readline.createInterface({
         input: process.stdin,
@@ -385,9 +391,845 @@ async function editFile(args) {
     console.log(`  ${fullPath}`);
     console.log("");
 }
+function readFlagValue(args, flag) {
+    const inline = args.find((arg) => arg.startsWith(`${flag}=`));
+    if (inline)
+        return inline.slice(flag.length + 1);
+    const index = args.indexOf(flag);
+    if (index === -1)
+        return undefined;
+    return args[index + 1];
+}
+function hasFlag(args, flag) {
+    return args.includes(flag) || args.some((arg) => arg === flag || arg.startsWith(`${flag}=`));
+}
+function readAllFlagValues(args, flag) {
+    const values = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (arg === flag && args[i + 1])
+            values.push(args[i + 1]);
+        if (arg.startsWith(`${flag}=`))
+            values.push(arg.slice(flag.length + 1));
+    }
+    return values;
+}
+function nonFlagArgs(args, valueFlags) {
+    const out = [];
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        const inlineValueFlag = valueFlags.some((flag) => arg.startsWith(`${flag}=`));
+        if (inlineValueFlag)
+            continue;
+        if (valueFlags.includes(arg)) {
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith("--"))
+            continue;
+        out.push(arg);
+    }
+    return out;
+}
+function csvFlag(args, flag) {
+    const value = readFlagValue(args, flag);
+    return value ? value.split(",").map((item) => item.trim()).filter(Boolean) : [];
+}
+function normalizeProjectSlug(value) {
+    if (!value)
+        return undefined;
+    const slug = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 90);
+    if (!slug || slug === "personal" || slug === "uncategorized")
+        return undefined;
+    return slug;
+}
+function printPortfolioWriteResult(label, res) {
+    if (!res.ok || !res.data?.success) {
+        console.log("");
+        console.log(chalk_1.default.red(`  ${label} failed`) + chalk_1.default.dim(` — ${(0, api_1.apiErrorMessage)(res.data) || `HTTP ${res.status}`}`));
+        console.log("");
+        return false;
+    }
+    const snapshot = res.data.snapshot;
+    console.log("");
+    console.log(chalk_1.default.green(`  ${label} saved`));
+    if (res.data.taskId)
+        console.log(chalk_1.default.dim(`  task: ${res.data.taskId}`));
+    if (res.data.captureId)
+        console.log(chalk_1.default.dim(`  capture: ${res.data.captureId}`));
+    if (res.data.taskIds?.length)
+        console.log(chalk_1.default.dim(`  routed tasks: ${res.data.taskIds.join(", ")}`));
+    if (snapshot) {
+        console.log(chalk_1.default.dim(`  snapshot: ${snapshot.path}`));
+        if (snapshot.bundleVersion)
+            console.log(chalk_1.default.dim(`  bundle: v${snapshot.bundleVersion}`));
+        if (snapshot.publishVersion)
+            console.log(chalk_1.default.dim(`  published: v${snapshot.publishVersion}`));
+        if (snapshot.repoSync.attempted) {
+            if (snapshot.repoSync.ok) {
+                const push = snapshot.repoSync.push;
+                console.log(chalk_1.default.dim(`  repo sync: ${push?.via || "pr"}${push?.merged === false ? " pending" : " merged/current"}`));
+                if (push?.prUrl)
+                    console.log(chalk_1.default.dim(`  pr: ${push.prUrl}`));
+            }
+            else {
+                console.log(chalk_1.default.hex("#C46A3A")(`  repo sync failed: ${snapshot.repoSync.error || "unknown error"}`));
+            }
+        }
+        else {
+            console.log(chalk_1.default.dim("  repo sync skipped"));
+        }
+    }
+    console.log("");
+    return true;
+}
+function printProjectHelp(topic) {
+    const normalized = (topic || "").toLowerCase();
+    if (normalized === "task" || normalized === "tasks") {
+        console.log("");
+        console.log("  " + chalk_1.default.bold("youmd project task") + chalk_1.default.dim(" — create or update portfolio tasks"));
+        console.log("");
+        console.log("  " + chalk_1.default.cyan("create:"));
+        console.log(`    ${chalk_1.default.cyan("youmd project task agent youmd: verify sync proof")} ${chalk_1.default.dim("# agent-owned project task")}`);
+        console.log(`    ${chalk_1.default.cyan("youmd project task me personal: follow up with billing")} ${chalk_1.default.dim("# human-owned personal task")}`);
+        console.log(`    ${chalk_1.default.cyan("youmd project task --owner agent --project youmd --title \"Audit MCP slice\" --no-sync")}`);
+        console.log("");
+        console.log("  " + chalk_1.default.cyan("update:"));
+        console.log(`    ${chalk_1.default.cyan("youmd project task update <task-id> --status in_progress --priority high")}`);
+        console.log(`    ${chalk_1.default.cyan("youmd project task update <task-id> --owner human --owner-label Houston --personal")}`);
+        console.log("");
+        console.log("  " + chalk_1.default.cyan("common flags:"));
+        console.log(`    ${chalk_1.default.cyan("--owner <agent|human|me>")}        ${chalk_1.default.dim("task owner")}`);
+        console.log(`    ${chalk_1.default.cyan("--owner-label <name>")}           ${chalk_1.default.dim("specific human/agent label")}`);
+        console.log(`    ${chalk_1.default.cyan("--project <slug>|--personal")}    ${chalk_1.default.dim("project scope or uncategorized personal")}`);
+        console.log(`    ${chalk_1.default.cyan("--status <state>")}               ${chalk_1.default.dim("proposed, open, in_progress, done, snoozed, cancelled")}`);
+        console.log(`    ${chalk_1.default.cyan("--priority <level>")}             ${chalk_1.default.dim("low, normal, high, urgent")}`);
+        console.log(`    ${chalk_1.default.cyan("--tags a,b,c")}                   ${chalk_1.default.dim("searchable tags")}`);
+        console.log(`    ${chalk_1.default.cyan("--no-sync")}                      ${chalk_1.default.dim("save to You.md without pushing repo snapshot")}`);
+        console.log("");
+        return;
+    }
+    if (normalized === "braindump" || normalized === "brain-dump" || normalized === "dump") {
+        console.log("");
+        console.log("  " + chalk_1.default.bold("youmd project braindump") + chalk_1.default.dim(" — preserve raw dumps and route tasks"));
+        console.log("");
+        console.log("  " + chalk_1.default.cyan("examples:"));
+        console.log(`    ${chalk_1.default.cyan("youmd project braindump project:youmd raw idea text --agent-task \"Audit MCP slice\"")}`);
+        console.log(`    ${chalk_1.default.cyan("youmd project braindump --project badapp --summary \"Watch workout capture\" --text \"raw transcript\"")}`);
+        console.log(`    ${chalk_1.default.cyan("youmd project braindump --project youmd --text \"raw\" --human-task \"Decide priority\" --no-sync")}`);
+        console.log("");
+        console.log("  " + chalk_1.default.cyan("common flags:"));
+        console.log(`    ${chalk_1.default.cyan("--project <slug>")}       ${chalk_1.default.dim("portfolio project association")}`);
+        console.log(`    ${chalk_1.default.cyan("--summary <text>")}       ${chalk_1.default.dim("short searchable synthesis")}`);
+        console.log(`    ${chalk_1.default.cyan("--text|--raw <text>")}    ${chalk_1.default.dim("raw source text, preserved first")}`);
+        console.log(`    ${chalk_1.default.cyan("--insights a,b,c")}       ${chalk_1.default.dim("through-lines or reusable ideas")}`);
+        console.log(`    ${chalk_1.default.cyan("--agent-task <title>")}   ${chalk_1.default.dim("proposed agent-owned task")}`);
+        console.log(`    ${chalk_1.default.cyan("--human-task <title>")}   ${chalk_1.default.dim("proposed Houston-owned task")}`);
+        console.log(`    ${chalk_1.default.cyan("--task agent: <title>")}  ${chalk_1.default.dim("alternate task syntax")}`);
+        console.log(`    ${chalk_1.default.cyan("--no-sync")}              ${chalk_1.default.dim("save to You.md without pushing repo snapshot")}`);
+        console.log("");
+        return;
+    }
+    console.log("");
+    console.log("  " + chalk_1.default.bold("youmd project") + chalk_1.default.dim(" — manage project agent context"));
+    console.log("");
+    console.log("  " + chalk_1.default.cyan("subcommands:"));
+    console.log("");
+    console.log(`    ${chalk_1.default.cyan("init [name]".padEnd(28))} ${chalk_1.default.dim("initialize a new project")}`);
+    console.log(`    ${chalk_1.default.cyan("list".padEnd(28))} ${chalk_1.default.dim("list all projects")}`);
+    console.log(`    ${chalk_1.default.cyan("show [name]".padEnd(28))} ${chalk_1.default.dim("show project details (auto-detects in project dir)")}`);
+    console.log(`    ${chalk_1.default.cyan("memories <name>".padEnd(28))} ${chalk_1.default.dim("list project memories")}`);
+    console.log(`    ${chalk_1.default.cyan("remember <name> <cat> <msg>".padEnd(28))} ${chalk_1.default.dim("add a memory to a project")}`);
+    console.log(`    ${chalk_1.default.cyan("edit <name> <file>".padEnd(28))} ${chalk_1.default.dim("show a project file path for editing")}`);
+    console.log(`    ${chalk_1.default.cyan("log <message...>".padEnd(28))} ${chalk_1.default.dim("append an agent activity entry to project-context/you.md/log.md")}`);
+    console.log(`    ${chalk_1.default.cyan("log".padEnd(28))} ${chalk_1.default.dim("read last 15 entries from the activity log")}`);
+    console.log(`    ${chalk_1.default.cyan("task agent youmd: ...".padEnd(28))} ${chalk_1.default.dim("save an agent/human portfolio task and sync the repo snapshot")}`);
+    console.log(`    ${chalk_1.default.cyan("task update <id> --status ...".padEnd(28))} ${chalk_1.default.dim("edit task owner, project scope, metadata, and triage fields")}`);
+    console.log(`    ${chalk_1.default.cyan("braindump project:youmd ...".padEnd(28))} ${chalk_1.default.dim("capture raw dump text, route tasks, and sync the repo snapshot")}`);
+    console.log(`    ${chalk_1.default.cyan("portfolio-audit".padEnd(28))} ${chalk_1.default.dim("scan recent projects and env key names without printing secrets")}`);
+    console.log(`    ${chalk_1.default.cyan("portfolio-hydrate".padEnd(28))} ${chalk_1.default.dim("hydrate portfolio graph from GitHub + local auditor results")}`);
+    console.log(`    ${chalk_1.default.cyan("env-audit --fingerprints".padEnd(28))} ${chalk_1.default.dim("detect reused key values by local salted HMAC")}`);
+    console.log("");
+    console.log(chalk_1.default.dim("  help: youmd project task --help | youmd project braindump --help"));
+    console.log(chalk_1.default.dim("  projects are stored in .youmd/projects/<name>/"));
+    console.log(chalk_1.default.dim("  run from a project directory for auto-detection."));
+    console.log("");
+}
+function parseTaskArgs(args) {
+    const ownerFlag = readFlagValue(args, "--owner");
+    let ownerType = ownerFlag === "me" || ownerFlag === "human" ? "human" : "agent";
+    const ownerLabel = readFlagValue(args, "--owner-label");
+    let projectSlug = normalizeProjectSlug(readFlagValue(args, "--project"));
+    const priority = readFlagValue(args, "--priority") || "normal";
+    const status = readFlagValue(args, "--status") || "open";
+    const description = readFlagValue(args, "--description") || readFlagValue(args, "--notes");
+    const tags = csvFlag(args, "--tags");
+    let title = readFlagValue(args, "--title");
+    const rawParts = nonFlagArgs(args, [
+        "--owner", "--owner-label", "--project", "--priority", "--status",
+        "--description", "--notes", "--tags", "--title",
+    ]);
+    if (rawParts[0] === "add")
+        rawParts.shift();
+    let raw = rawParts.join(" ").trim();
+    if (!title) {
+        const ownerMatch = raw.match(/^(me|human|agent)\s+(.+)$/i);
+        if (ownerMatch) {
+            ownerType = ownerMatch[1].toLowerCase() === "agent" ? "agent" : "human";
+            raw = ownerMatch[2].trim();
+        }
+        const scoped = raw.match(/^([^:]{1,90}):\s*(.+)$/);
+        if (scoped) {
+            projectSlug = normalizeProjectSlug(scoped[1]);
+            title = scoped[2].trim();
+        }
+        else {
+            title = raw;
+        }
+    }
+    if (!title?.trim())
+        return null;
+    return {
+        projectSlug,
+        title: title.trim(),
+        description,
+        ownerType,
+        ownerLabel,
+        status,
+        priority,
+        tags,
+        sourceType: "cli",
+        syncRepo: !hasFlag(args, "--no-sync"),
+        agentName: "youmd CLI",
+    };
+}
+function parseTaskUpdateArgs(args) {
+    const rawArgs = [...args];
+    if (["update", "edit", "triage"].includes((rawArgs[0] || "").toLowerCase())) {
+        rawArgs.shift();
+    }
+    const taskId = readFlagValue(rawArgs, "--task-id") || readFlagValue(rawArgs, "--id") || nonFlagArgs(rawArgs, [
+        "--task-id", "--id", "--owner", "--owner-label", "--project", "--priority", "--status",
+        "--description", "--notes", "--title", "--tags", "--due",
+    ])[0];
+    if (!taskId?.trim())
+        return null;
+    const ownerFlag = readFlagValue(rawArgs, "--owner");
+    const projectFlagPresent = hasFlag(rawArgs, "--project") || hasFlag(rawArgs, "--personal");
+    const projectFlag = hasFlag(rawArgs, "--personal") ? "personal" : readFlagValue(rawArgs, "--project");
+    const dueFlagPresent = hasFlag(rawArgs, "--due") || hasFlag(rawArgs, "--clear-due");
+    const dueFlag = hasFlag(rawArgs, "--clear-due") ? "clear" : readFlagValue(rawArgs, "--due");
+    const payload = {
+        taskId: taskId.trim(),
+        syncRepo: !hasFlag(rawArgs, "--no-sync"),
+        agentName: "youmd CLI",
+    };
+    const title = readFlagValue(rawArgs, "--title");
+    if (title !== undefined)
+        payload.title = title;
+    if (hasFlag(rawArgs, "--description") || hasFlag(rawArgs, "--notes") || hasFlag(rawArgs, "--clear-description")) {
+        payload.description = hasFlag(rawArgs, "--clear-description")
+            ? null
+            : (readFlagValue(rawArgs, "--description") ?? readFlagValue(rawArgs, "--notes") ?? null);
+    }
+    if (ownerFlag) {
+        payload.ownerType = ownerFlag === "me" || ownerFlag === "human" ? "human" : "agent";
+    }
+    if (hasFlag(rawArgs, "--owner-label") || hasFlag(rawArgs, "--clear-owner-label")) {
+        payload.ownerLabel = hasFlag(rawArgs, "--clear-owner-label")
+            ? null
+            : (readFlagValue(rawArgs, "--owner-label") ?? null);
+    }
+    if (projectFlagPresent) {
+        payload.projectSlug = normalizeProjectSlug(projectFlag) ?? null;
+    }
+    const status = readFlagValue(rawArgs, "--status");
+    if (status !== undefined)
+        payload.status = status;
+    const priority = readFlagValue(rawArgs, "--priority");
+    if (priority !== undefined)
+        payload.priority = priority;
+    if (dueFlagPresent) {
+        if (!dueFlag || ["clear", "none", "null"].includes(dueFlag.toLowerCase())) {
+            payload.dueAt = null;
+        }
+        else {
+            const parsed = Date.parse(dueFlag);
+            payload.dueAt = Number.isFinite(parsed) ? parsed : Number(dueFlag);
+        }
+    }
+    if (hasFlag(rawArgs, "--tags")) {
+        payload.tags = csvFlag(rawArgs, "--tags");
+    }
+    const changedFields = [
+        "projectSlug", "title", "description", "ownerType", "ownerLabel",
+        "status", "priority", "dueAt", "tags",
+    ];
+    return changedFields.some((field) => payload[field] !== undefined) ? payload : null;
+}
+function parseBrainDumpTask(value, ownerType, projectSlug) {
+    const title = value.trim();
+    if (!title)
+        return null;
+    return {
+        projectSlug,
+        title,
+        ownerType,
+        status: "proposed",
+        priority: "normal",
+        tags: ["braindump"],
+    };
+}
+function parseBrainDumpArgs(args) {
+    let projectSlug = normalizeProjectSlug(readFlagValue(args, "--project"));
+    const summary = readFlagValue(args, "--summary");
+    const tags = csvFlag(args, "--tags");
+    const insights = csvFlag(args, "--insights");
+    const textFlag = readFlagValue(args, "--text") || readFlagValue(args, "--raw");
+    const rawParts = nonFlagArgs(args, [
+        "--project", "--summary", "--tags", "--insights", "--text", "--raw",
+        "--task", "--agent-task", "--human-task",
+    ]);
+    if (rawParts[0] === "add" || rawParts[0] === "capture")
+        rawParts.shift();
+    let rawText = (textFlag || rawParts.join(" ")).trim();
+    const projectPrefix = rawText.match(/^project:([a-zA-Z0-9_-]+)\s+(.+)$/);
+    if (projectPrefix) {
+        projectSlug = normalizeProjectSlug(projectPrefix[1]);
+        rawText = projectPrefix[2].trim();
+    }
+    if (!rawText)
+        return null;
+    const tasks = [
+        ...readAllFlagValues(args, "--task")
+            .map((value) => {
+            const match = value.match(/^(me|human|agent):\s*(.+)$/i);
+            if (match) {
+                return parseBrainDumpTask(match[2], match[1].toLowerCase() === "agent" ? "agent" : "human", projectSlug);
+            }
+            return parseBrainDumpTask(value, "agent", projectSlug);
+        })
+            .filter((task) => task !== null),
+        ...readAllFlagValues(args, "--agent-task")
+            .map((value) => parseBrainDumpTask(value, "agent", projectSlug))
+            .filter((task) => task !== null),
+        ...readAllFlagValues(args, "--human-task")
+            .map((value) => parseBrainDumpTask(value, "human", projectSlug))
+            .filter((task) => task !== null),
+    ];
+    return {
+        rawText,
+        summary,
+        projectSlugs: projectSlug ? [projectSlug] : [],
+        tags,
+        insights,
+        source: "cli",
+        tasks,
+        metadata: {
+            command: "youmd project braindump",
+            capturedAt: new Date().toISOString(),
+        },
+        syncRepo: !hasFlag(args, "--no-sync"),
+        agentName: "youmd CLI",
+    };
+}
+async function saveTaskFromCli(args) {
+    if (!(0, config_1.isAuthenticated)()) {
+        console.log("");
+        console.log(chalk_1.default.yellow("  not authenticated. run: youmd login"));
+        console.log("");
+        return;
+    }
+    if (["update", "edit", "triage"].includes((args[0] || "").toLowerCase())) {
+        const payload = parseTaskUpdateArgs(args);
+        if (!payload) {
+            console.log("");
+            console.log(chalk_1.default.yellow("  usage: youmd project task update <task-id> --status in_progress --owner agent --project youmd"));
+            console.log(chalk_1.default.dim("  clear scope: youmd project task update <task-id> --personal"));
+            console.log("");
+            return;
+        }
+        const res = await (0, api_1.updatePortfolioTask)(payload);
+        printPortfolioWriteResult("portfolio task update", res);
+        return;
+    }
+    const payload = parseTaskArgs(args);
+    if (!payload) {
+        console.log("");
+        console.log(chalk_1.default.yellow("  usage: youmd project task agent youmd: verify sync proof"));
+        console.log(chalk_1.default.dim("  or:    youmd project task --owner me --project personal --title \"follow up\""));
+        console.log(chalk_1.default.dim("  edit:  youmd project task update <task-id> --status in_progress --priority high"));
+        console.log("");
+        return;
+    }
+    const res = await (0, api_1.savePortfolioTask)(payload);
+    printPortfolioWriteResult("portfolio task", res);
+}
+async function saveBrainDumpFromCli(args) {
+    if (!(0, config_1.isAuthenticated)()) {
+        console.log("");
+        console.log(chalk_1.default.yellow("  not authenticated. run: youmd login"));
+        console.log("");
+        return;
+    }
+    const payload = parseBrainDumpArgs(args);
+    if (!payload) {
+        console.log("");
+        console.log(chalk_1.default.yellow("  usage: youmd project braindump project:youmd raw idea text --agent-task \"follow up\""));
+        console.log(chalk_1.default.dim("  or:    youmd project braindump --project youmd --summary \"...\" --text \"...\""));
+        console.log("");
+        return;
+    }
+    const res = await (0, api_1.saveBrainDump)(payload);
+    printPortfolioWriteResult("brain dump", res);
+}
+function showPortfolioAudit(args) {
+    const root = readFlagValue(args, "--root");
+    const json = hasFlag(args, "--json");
+    const includeDotenv = hasFlag(args, "--include-dotenv");
+    const fingerprints = hasFlag(args, "--fingerprints");
+    const result = (0, portfolio_audit_1.runPortfolioAudit)({ root, includeDotenv, fingerprints, activeDays: 365 });
+    if (json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log("");
+    console.log("  " + chalk_1.default.bold("portfolio audit") + chalk_1.default.dim(" — project/api/env map"));
+    console.log("");
+    console.log(chalk_1.default.dim(`  root: ${result.root}`));
+    console.log(chalk_1.default.dim(`  projects scanned: ${result.projectsScanned}`));
+    console.log(chalk_1.default.dim(`  env files scanned: ${result.envFilesScanned}`));
+    console.log(chalk_1.default.dim(`  providers detected: ${result.providers.length}`));
+    console.log("");
+    if (!fingerprints) {
+        console.log(chalk_1.default.dim("  secret values were not read. add --fingerprints to compare reused values by local salted HMAC."));
+        console.log("");
+    }
+    else {
+        console.log(chalk_1.default.dim("  fingerprints are local salted HMAC prefixes, not raw secret values."));
+        console.log("");
+    }
+    for (const provider of result.providers.slice(0, 20)) {
+        const shared = provider.sharedFingerprints.length > 0
+            ? ACCENT(` / ${provider.sharedFingerprints.length} shared value group${provider.sharedFingerprints.length === 1 ? "" : "s"}`)
+            : "";
+        console.log(`  ${chalk_1.default.cyan(provider.provider)} ${chalk_1.default.dim(`(${provider.category})`)}${shared}`);
+        console.log(chalk_1.default.dim(`    projects: ${provider.projects.join(", ") || "none"}`));
+        console.log(chalk_1.default.dim(`    key names: ${provider.keyNames.slice(0, 8).join(", ")}${provider.keyNames.length > 8 ? ", ..." : ""}`));
+        if (provider.sharedFingerprints.length > 0) {
+            for (const group of provider.sharedFingerprints.slice(0, 3)) {
+                console.log(chalk_1.default.dim(`    shared ${group.fingerprint}: ${group.projects.join(", ")} (${group.keyNames.join(", ")})`));
+            }
+        }
+        console.log("");
+    }
+    console.log(chalk_1.default.dim("  dashboard: /api or /env"));
+    console.log(chalk_1.default.dim("  skill: /skill use portfolio-graph-auditor"));
+    console.log("");
+}
+function inferStackName(name, projectPath) {
+    const key = `${name} ${projectPath}`.toLowerCase();
+    if (key.includes("youmd"))
+        return "YouStack";
+    if (key.includes("bamfaiapp") || key.includes("bamf.ai"))
+        return "BAMFStack";
+    if (key.includes("bamfsite") || key.includes("bamfos"))
+        return "BAMFOSStack";
+    if (key.includes("badapp"))
+        return "BadStack";
+    if (key.includes("foldermd"))
+        return "FolderMD Stack";
+    if (key.includes("bigbounce"))
+        return "AstroStack";
+    if (key.includes("hubify"))
+        return "HubStack";
+    if (key.includes("myo"))
+        return "Myo Stack";
+    return "Project Stack";
+}
+function shouldHydrateLocalProject(project, includeNested) {
+    if (!project.name || project.path === ".")
+        return false;
+    if (project.path.includes(".reference-repos/") || project.path.startsWith(".dev-skills/"))
+        return false;
+    if (project.path.includes("/project-context/"))
+        return false;
+    if (includeNested)
+        return true;
+    const depth = project.path.split("/").filter(Boolean).length;
+    return depth === 1 || (depth <= 2 && project.envFiles.length > 0);
+}
+function readTextIfExists(filePath) {
+    try {
+        if (!fs.existsSync(filePath))
+            return "";
+        return fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+function cleanDocSnippet(text, limit = 420) {
+    const cleaned = text
+        .replace(/```[\s\S]*?```/g, " ")
+        .replace(/<!--[\s\S]*?-->/g, " ")
+        .split(/\n\s*\n/)
+        .map((block) => block.replace(/[#*_>`[\]]/g, " ").replace(/\s+/g, " ").trim())
+        .find((block) => {
+        const lower = block.toLowerCase();
+        const setupBoilerplate = (/\b(requires?|install(?:ation)?|getting started|quick start|setup|setup script|dependencies|run|start)\b/.test(lower) &&
+            /\b(node\.?js|npm|pnpm|yarn|bun|nvm|localhost|\.env|docker|dev server|chmod|script|dependencies)\b/.test(lower)) || (/\b(?:copy|create|configure|add|set|update)\b/.test(lower) &&
+            /\.env(?:\.example|\.local)?/.test(lower)) || /\b(?:localhost|preview\/web|dev server)\b/.test(lower) ||
+            /\bcursor will expose\b/.test(lower) ||
+            (/\b(?:compile|build)\b/.test(lower) && /\b(?:app|production|bundle|dist)\b/.test(lower)) ||
+            /^(?:.+\s+)?product requirements document(?:\s*\(prd\))?$/.test(lower) ||
+            /^(?:version|last updated|founder|status|date):\s/.test(lower) ||
+            /^\s*(npm|pnpm|yarn|bun|nvm|docker)\s+/i.test(block);
+        return block.length > 24 && !setupBoilerplate;
+    }) ?? "";
+    return cleaned ? cleaned.slice(0, limit) : undefined;
+}
+function repoFullNameFromRemote(absPath) {
+    try {
+        const remote = (0, child_process_1.execFileSync)("git", ["-C", absPath, "config", "--get", "remote.origin.url"], {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        const match = remote.match(/github\.com[:/](.+?)(?:\.git)?$/);
+        return match?.[1];
+    }
+    catch {
+        return undefined;
+    }
+}
+function githubCommitUrl(repoFullName, sha) {
+    return repoFullName ? `https://github.com/${repoFullName}/commit/${sha}` : undefined;
+}
+function readRecentCommitEvents(absPath, relPath, days) {
+    try {
+        const output = (0, child_process_1.execFileSync)("git", [
+            "-C",
+            absPath,
+            "log",
+            `--since=${Math.max(1, Math.min(days, 365))} days ago`,
+            "--max-count=40",
+            "--pretty=format:%H%x1f%ct%x1f%s",
+        ], {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        if (!output)
+            return [];
+        const repoFullName = repoFullNameFromRemote(absPath);
+        return output.split("\n").map((line) => {
+            const [sha, epoch, subject] = line.split("\x1f");
+            const occurredAt = Number(epoch) * 1000;
+            return {
+                kind: "commit",
+                title: subject || "Commit",
+                summary: subject || undefined,
+                url: sha ? githubCommitUrl(repoFullName, sha) : undefined,
+                source: "local-git",
+                evidencePath: relPath,
+                dedupeKey: sha ? `commit:${sha}` : undefined,
+                tags: ["commit", "shipped"],
+                metadata: { sha, repoFullName },
+                occurredAt: Number.isFinite(occurredAt) ? occurredAt : Date.now(),
+            };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function readRecentPrEvents(absPath, relPath, days) {
+    const repoFullName = repoFullNameFromRemote(absPath);
+    if (!repoFullName)
+        return [];
+    const since = new Date(Date.now() - Math.max(1, Math.min(days, 365)) * 86400000).toISOString().slice(0, 10);
+    try {
+        const output = (0, child_process_1.execFileSync)("gh", [
+            "pr",
+            "list",
+            "--repo",
+            repoFullName,
+            "--state",
+            "all",
+            "--search",
+            `updated:>=${since}`,
+            "--limit",
+            "30",
+            "--json",
+            "number,title,state,updatedAt,mergedAt,url",
+        ], {
+            encoding: "utf-8",
+            stdio: ["ignore", "pipe", "ignore"],
+        }).trim();
+        const rows = JSON.parse(output || "[]");
+        return rows.map((row) => {
+            const occurredAt = Date.parse(row.mergedAt || row.updatedAt || "");
+            return {
+                kind: "pull-request",
+                title: row.title || `Pull request #${row.number ?? "?"}`,
+                summary: row.state ? `${row.state.toLowerCase()} pull request #${row.number ?? "?"}` : undefined,
+                url: row.url,
+                source: "github-pr",
+                evidencePath: relPath,
+                dedupeKey: row.number ? `pr:${repoFullName}:${row.number}` : undefined,
+                tags: ["pull-request", row.state?.toLowerCase() || "pr"].filter(Boolean),
+                metadata: { repoFullName, number: row.number, state: row.state },
+                occurredAt: Number.isFinite(occurredAt) ? occurredAt : Date.now(),
+            };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+function readProjectDocs(absPath) {
+    const docs = [];
+    const readmePath = ["README.md", "readme.md"].map((file) => path.join(absPath, file)).find((file) => fs.existsSync(file));
+    const overviewPath = path.join(absPath, "project-context", "overview.md");
+    const currentStatePath = path.join(absPath, "project-context", "CURRENT_STATE.md");
+    const todoPath = path.join(absPath, "project-context", "TODO.md");
+    const tasksMdPath = path.join(absPath, "project-context", "tasks.md");
+    const tasksJsonPath = path.join(absPath, "project-context", "tasks.json");
+    const prdPath = path.join(absPath, "project-context", "PRD.md");
+    const changelogPath = path.join(absPath, "project-context", "CHANGELOG.md");
+    const featuresPath = path.join(absPath, "project-context", "FEATURES.md");
+    const designPath = path.join(absPath, "project-context", "design.md");
+    const researchPath = path.join(absPath, "project-context", "research.md");
+    const ideasPath = path.join(absPath, "project-context", "ideas.md");
+    const architecturePath = path.join(absPath, "project-context", "ARCHITECTURE.md");
+    const readme = readmePath ? readTextIfExists(readmePath) : "";
+    const overview = readTextIfExists(overviewPath);
+    const currentState = readTextIfExists(currentStatePath);
+    const todo = readTextIfExists(todoPath);
+    const tasks = readTextIfExists(tasksMdPath) || readTextIfExists(tasksJsonPath);
+    const prd = readTextIfExists(prdPath);
+    if (readmePath)
+        docs.push(path.relative(absPath, readmePath));
+    if (fs.existsSync(overviewPath))
+        docs.push("project-context/overview.md");
+    if (fs.existsSync(currentStatePath))
+        docs.push("project-context/CURRENT_STATE.md");
+    if (fs.existsSync(todoPath))
+        docs.push("project-context/TODO.md");
+    if (fs.existsSync(tasksMdPath))
+        docs.push("project-context/tasks.md");
+    if (fs.existsSync(tasksJsonPath))
+        docs.push("project-context/tasks.json");
+    if (fs.existsSync(prdPath))
+        docs.push("project-context/PRD.md");
+    if (fs.existsSync(changelogPath))
+        docs.push("project-context/CHANGELOG.md");
+    if (fs.existsSync(featuresPath))
+        docs.push("project-context/FEATURES.md");
+    if (fs.existsSync(designPath))
+        docs.push("project-context/design.md");
+    if (fs.existsSync(researchPath))
+        docs.push("project-context/research.md");
+    if (fs.existsSync(ideasPath))
+        docs.push("project-context/ideas.md");
+    if (fs.existsSync(architecturePath))
+        docs.push("project-context/ARCHITECTURE.md");
+    return {
+        summary: cleanDocSnippet(overview) ??
+            cleanDocSnippet(readme) ??
+            cleanDocSnippet(prd) ??
+            cleanDocSnippet(currentState),
+        focus: cleanDocSnippet(currentState, 360) ??
+            cleanDocSnippet(todo, 360) ??
+            cleanDocSnippet(tasks, 360),
+        docs,
+        contents: {
+            readme,
+            overview,
+            currentState,
+            todo,
+            tasks,
+            prd,
+            features: readTextIfExists(featuresPath),
+            design: readTextIfExists(designPath),
+            research: readTextIfExists(researchPath),
+            ideas: readTextIfExists(ideasPath),
+            architecture: readTextIfExists(architecturePath),
+        },
+    };
+}
+function shippedCount(events, days) {
+    const cutoff = Date.now() - days * 86400000;
+    return events.filter((event) => event.occurredAt >= cutoff && (event.kind === "commit" || event.kind === "pull-request" || event.tags?.includes("shipped"))).length;
+}
+function hydrationProjectsFromAudit(result, options) {
+    return result.projects
+        .filter((project) => shouldHydrateLocalProject(project, options.includeNested))
+        .slice(0, options.limit)
+        .map((project) => {
+        const absPath = path.join(result.root, project.path);
+        const docs = readProjectDocs(absPath);
+        const commitEvents = readRecentCommitEvents(absPath, project.path, options.days);
+        const prEvents = options.includePrs ? readRecentPrEvents(absPath, project.path, options.days) : [];
+        const activityEvents = [...commitEvents, ...prEvents]
+            .sort((a, b) => b.occurredAt - a.occurredAt)
+            .slice(0, 70);
+        const latestSubjects = activityEvents
+            .filter((event) => event.kind === "commit" || event.kind === "pull-request")
+            .slice(0, 4)
+            .map((event) => event.title)
+            .join("; ");
+        const shippedToday = shippedCount(activityEvents, 1);
+        const shipped7d = shippedCount(activityEvents, 7);
+        const shipped30d = shippedCount(activityEvents, 30);
+        const fallbackSummary = `Local portfolio auditor found ${project.name} at ${project.path}${project.providers.length ? ` using ${project.providers.slice(0, 6).join(", ")}` : ""}.`;
+        const stackName = inferStackName(project.name, project.path);
+        const strategy = options.strategy
+            ? (0, project_strategy_1.synthesizeProjectStrategy)({
+                projectName: project.name,
+                stackName,
+                docs: docs.contents,
+                providers: project.providers,
+                recentActivityTitles: activityEvents.slice(0, 8).map((event) => event.title),
+                shippedToday,
+                shipped7d,
+                shipped30d,
+                fallbackSummary,
+            })
+            : {};
+        return {
+            name: project.name,
+            path: project.path,
+            stackName,
+            status: activityEvents.length ? "active" : "local-audited",
+            summary: docs.summary || fallbackSummary,
+            ...strategy,
+            focus: docs.focus || (latestSubjects ? `Recent shipping activity: ${latestSubjects}` : "Audit project role, API/MCP ownership, reusable patterns, and env/service-account boundaries."),
+            docs: docs.docs,
+            envFiles: project.envFiles,
+            providers: project.providers,
+            tags: [
+                ...project.providers.map((provider) => provider.toLowerCase().replace(/[^a-z0-9]+/g, "-")).filter(Boolean),
+                activityEvents.length ? "activity-hydrated" : "local-audit",
+            ],
+            lastActivityAt: activityEvents[0]?.occurredAt ?? Date.now(),
+            activityEvents: [
+                {
+                    kind: "summary",
+                    title: `Shipped ${shippedToday} today / ${shipped7d} in 7d / ${shipped30d} in 30d`,
+                    summary: latestSubjects || docs.focus || docs.summary || fallbackSummary,
+                    source: "local-portfolio-audit",
+                    evidencePath: project.path,
+                    dedupeKey: `summary:${project.path}`,
+                    tags: ["activity-summary", "shipped"],
+                    metadata: { shippedToday, shipped7d, shipped30d, providerCount: project.providers.length },
+                    occurredAt: activityEvents[0]?.occurredAt ?? Date.now(),
+                },
+                ...activityEvents,
+            ],
+        };
+    });
+}
+async function hydratePortfolioFromCli(args) {
+    if (!(0, config_1.isAuthenticated)()) {
+        console.log("");
+        console.log(chalk_1.default.yellow("  not authenticated. run: youmd login"));
+        console.log("");
+        return;
+    }
+    const root = readFlagValue(args, "--root");
+    const days = Number(readFlagValue(args, "--days") ?? 90);
+    const limit = Number(readFlagValue(args, "--limit") ?? 80);
+    const includeNested = hasFlag(args, "--include-nested");
+    const includeTracked = !hasFlag(args, "--no-github");
+    const includePrs = !hasFlag(args, "--no-prs");
+    const strategy = !hasFlag(args, "--no-strategy");
+    const reusablePatternsEnabled = !hasFlag(args, "--no-patterns");
+    const dryRun = hasFlag(args, "--dry-run");
+    const audit = (0, portfolio_audit_1.runPortfolioAudit)({ root, includeDotenv: hasFlag(args, "--include-dotenv"), fingerprints: false, activeDays: days });
+    const projects = hydrationProjectsFromAudit(audit, {
+        includeNested,
+        limit: Math.max(1, Math.min(limit, 200)),
+        days: Number.isFinite(days) ? days : 90,
+        includePrs,
+        strategy,
+    });
+    const patternMining = reusablePatternsEnabled
+        ? (0, reusable_patterns_1.mineReusablePatterns)({
+            root: audit.root,
+            projects: audit.projects
+                .filter((project) => shouldHydrateLocalProject(project, includeNested))
+                .slice(0, Math.max(1, Math.min(limit, 200))),
+            maxProjects: Math.max(1, Math.min(limit, 200)),
+        })
+        : null;
+    const reusablePatternsPayload = patternMining?.patterns ?? [];
+    console.log("");
+    console.log("  " + chalk_1.default.bold("portfolio hydrate") + chalk_1.default.dim(" — auditor -> portfolio graph"));
+    console.log("");
+    console.log(chalk_1.default.dim(`  root: ${audit.root}`));
+    console.log(chalk_1.default.dim(`  auditor projects scanned: ${audit.projectsScanned}`));
+    console.log(chalk_1.default.dim(`  local hydration candidates: ${projects.length}`));
+    console.log(chalk_1.default.dim(`  github tracked sync: ${includeTracked ? `${Number.isFinite(days) ? days : 90}d` : "skipped"}`));
+    console.log(chalk_1.default.dim(`  local git/PR activity: commits${includePrs ? " + pull requests" : ""}`));
+    console.log(chalk_1.default.dim(`  strategy fields: ${strategy ? "docs + activity synthesis" : "skipped"}`));
+    console.log(chalk_1.default.dim(`  reusable patterns: ${patternMining ? `${patternMining.patterns.length} mined from ${patternMining.projectsScanned} projects / ${patternMining.filesScanned} files` : "skipped"}`));
+    console.log("");
+    for (const project of projects.slice(0, 12)) {
+        console.log(`  ${chalk_1.default.cyan(project.name.padEnd(24))} ${chalk_1.default.dim(project.path || "")}`);
+    }
+    if (projects.length > 12)
+        console.log(chalk_1.default.dim(`  ... ${projects.length - 12} more`));
+    if (patternMining && patternMining.patterns.length > 0) {
+        console.log("");
+        for (const pattern of patternMining.patterns.slice(0, 8)) {
+            console.log(`  ${chalk_1.default.hex("#C46A3A")(pattern.name.padEnd(36))} ${chalk_1.default.dim(`${pattern.usageProjects.length} project${pattern.usageProjects.length === 1 ? "" : "s"}`)}`);
+        }
+        if (patternMining.patterns.length > 8)
+            console.log(chalk_1.default.dim(`  ... ${patternMining.patterns.length - 8} more patterns`));
+    }
+    console.log("");
+    if (dryRun) {
+        console.log(chalk_1.default.dim("  dry run only. remove --dry-run to hydrate Convex portfolio records."));
+        console.log("");
+        return;
+    }
+    const res = await (0, api_1.hydratePortfolioProjects)({
+        projects,
+        reusablePatterns: reusablePatternsPayload,
+        includeTracked,
+        days: Number.isFinite(days) ? days : 90,
+        limit: Number.isFinite(limit) ? limit : 80,
+        source: "local-portfolio-audit",
+        agentName: "youmd CLI portfolio-graph-auditor",
+    });
+    if (!res.ok || !res.data?.success) {
+        console.log(chalk_1.default.red("  portfolio hydrate failed") + chalk_1.default.dim(` — ${(0, api_1.apiErrorMessage)(res.data) || `HTTP ${res.status}`}`));
+        console.log("");
+        return;
+    }
+    const tracked = res.data.tracked;
+    console.log(chalk_1.default.green("  portfolio graph hydrated"));
+    if (tracked) {
+        console.log(chalk_1.default.dim(`  github tracked: ${tracked.tracked} considered / ${tracked.created} created / ${tracked.updated} updated`));
+    }
+    console.log(chalk_1.default.dim(`  local audit: ${res.data.local.upserted} upserted / ${res.data.local.skipped} skipped`));
+    if (res.data.patterns) {
+        console.log(chalk_1.default.dim(`  reusable patterns: ${res.data.patterns.upserted} upserted / ${res.data.patterns.created} created / ${res.data.patterns.updated} updated`));
+    }
+    console.log("");
+}
 // ─── Main command router ──────────────────────────────────────────────
 async function projectCommand(subcommand, ...args) {
     const sub = (subcommand || "").toLowerCase();
+    if (sub === "--help" || sub === "-h" || args.includes("--help") || args.includes("-h")) {
+        printProjectHelp(sub === "--help" || sub === "-h" ? undefined : sub);
+        return;
+    }
     switch (sub) {
         case "init":
             await initProject(args);
@@ -419,6 +1261,25 @@ async function projectCommand(subcommand, ...args) {
                 (0, project_log_1.projectLogRead)();
             }
             break;
+        case "task":
+        case "tasks":
+            await saveTaskFromCli(args);
+            break;
+        case "braindump":
+        case "brain-dump":
+        case "dump":
+            await saveBrainDumpFromCli(args);
+            break;
+        case "portfolio-audit":
+        case "env-audit":
+        case "apis":
+            showPortfolioAudit(args);
+            break;
+        case "portfolio-hydrate":
+        case "hydrate-portfolio":
+        case "hydrate":
+            await hydratePortfolioFromCli(args);
+            break;
         default: {
             // If no subcommand, try auto-detecting the current project
             const detected = (0, config_1.detectProjectContext)();
@@ -427,23 +1288,7 @@ async function projectCommand(subcommand, ...args) {
                 showProject([]);
                 return;
             }
-            console.log("");
-            console.log("  " + chalk_1.default.bold("youmd project") + chalk_1.default.dim(" — manage project agent context"));
-            console.log("");
-            console.log("  " + chalk_1.default.cyan("subcommands:"));
-            console.log("");
-            console.log(`    ${chalk_1.default.cyan("init [name]".padEnd(28))} ${chalk_1.default.dim("initialize a new project")}`);
-            console.log(`    ${chalk_1.default.cyan("list".padEnd(28))} ${chalk_1.default.dim("list all projects")}`);
-            console.log(`    ${chalk_1.default.cyan("show [name]".padEnd(28))} ${chalk_1.default.dim("show project details (auto-detects in project dir)")}`);
-            console.log(`    ${chalk_1.default.cyan("memories <name>".padEnd(28))} ${chalk_1.default.dim("list project memories")}`);
-            console.log(`    ${chalk_1.default.cyan("remember <name> <cat> <msg>".padEnd(28))} ${chalk_1.default.dim("add a memory to a project")}`);
-            console.log(`    ${chalk_1.default.cyan("edit <name> <file>".padEnd(28))} ${chalk_1.default.dim("show a project file path for editing")}`);
-            console.log(`    ${chalk_1.default.cyan("log <message...>".padEnd(28))} ${chalk_1.default.dim("append an agent activity entry to project-context/you.md/log.md")}`);
-            console.log(`    ${chalk_1.default.cyan("log".padEnd(28))} ${chalk_1.default.dim("read last 15 entries from the activity log")}`);
-            console.log("");
-            console.log(chalk_1.default.dim("  projects are stored in .youmd/projects/<name>/"));
-            console.log(chalk_1.default.dim("  run from a project directory for auto-detection."));
-            console.log("");
+            printProjectHelp();
             break;
         }
     }