loadout-ai 0.7.0 → 0.9.0

package/dist/src/commands/catalog.js

@@ -1,24 +1,18 @@
-import { explainCatalogScore, loadEffectiveCatalog, loadCatalog, promoteCatalogCandidate, rankCatalog, refreshCatalog, validateCatalog, } from "../core/catalog/catalog.js";
-import { detectAgents, parseAgentSelection } from "../core/agents/paths.js";
-import { resolve } from "node:path";
-import { readFile } from "node:fs/promises";
-import { allPhaseRoutes, formatCostTable, formatModelCatalog, formatRouteRecommendation, formatRoutingTable, routePhase, routeTask, } from "../core/routing/route.js";
-import { applyFirstPartySkill, FIRST_PARTY_SKILLS, formatFirstPartySkillList, formatFirstPartySkillPlan, installedFirstPartySkills, planFirstPartySkill, removeFirstPartySkill, } from "../core/routing/first-party-skills.js";
-import { applyPickup, formatHandoffStatus, formatInbox, formatPickupPlan, getHandoffState, initHandoff, isHandoffInitialized, markDone, planPickup, readInbox, sendHandoff, } from "../core/routing/handoff.js";
+import { explainCatalogScore, loadEffectiveCatalog, loadCatalog, rankCatalog, refreshCatalog, } from "../core/catalog/catalog.js";
+import { parseAgentSelection } from "../core/agents/paths.js";
 import { catalogTrustStage, formatCatalogTrustStage, } from "../core/catalog/profiles.js";
 import { discoverHackerNewsRepositories } from "../core/discovery/community.js";
 import { discoverPrivateRepositories } from "../core/discovery/private-discovery.js";
 import { defaultGitHubDiscoveryQueries, discoverGitHubRepositories, } from "../core/discovery/github-discovery.js";
 import { formatStarHistory, readCatalogObservations, } from "../core/discovery/observations.js";
-import { writeFileAtomically } from "../core/install/atomic-file.js";
-import { formatReviewQueue, markPromoted, mergeReviewQueue, readReviewQueue, } from "../core/discovery/review-queue.js";
-import { applyProviderModelSelection, defaultModelConfigurationPath, formatProviderModelConfiguration, planProviderModelSelection, readProviderModelConfiguration, requestOpenRouter, } from "../core/routing/model-config.js";
-import { parseCompletionShell, renderShellCompletion, } from "../core/reporting/completion.js";
+import { formatReviewQueue, mergeReviewQueue, readReviewQueue, } from "../core/discovery/review-queue.js";
+import { applyProviderModelSelection, defaultModelConfigurationPath, formatProviderModelConfiguration, planProviderModelSelection, readProviderModelConfiguration, requestOpenRouter, } from "../core/agents/model-config.js";
 import { buildCatalogCoverage, formatCatalogCoverage, } from "../core/catalog/catalog-coverage.js";
-import { createCredentialResolver, createOsCredentialStore, } from "../core/routing/credentials.js";
-import { buildCandidateDossier, buildCatalogProposal, formatCandidateDossier, formatCandidateSummaries, listDiscoveryCandidates, readCandidateDossier, verifyCandidateDossierSource, writeCandidateDossier, } from "../core/discovery/candidate-intelligence.js";
+import { createCredentialResolver, createOsCredentialStore, } from "../core/agents/credentials.js";
 import { discoverSkillsSh } from "../core/discovery/skills-sh-discovery.js";
 import { discoverOfficialMcpRegistry } from "../core/discovery/mcp-registry-discovery.js";
+import { registerCandidateCommands } from "./catalog-candidate.js";
+import { registerWorkflowCommands } from "./catalog-workflows.js";
 import { readCredentialFromStdin } from "./support.js";
 export function registerCatalog(program) {
     program
@@ -90,148 +84,7 @@ export function registerCatalog(program) {
         for (const failure of result.observationFailures)
             console.error(`Warning: could not record release observation for ${failure.repository}: ${failure.error}`);
     });
-    const candidate = program
-        .command("candidate")
-        .description("Triage and statically inspect daily discovery candidates; never auto-promotes");
-    candidate
-        .command("list")
-        .allowExcessArguments(false)
-        .description("Rank discovery leads for human triage, not as universal quality")
-        .option("--limit <count>", "maximum candidates", "20")
-        .option("--query <words>", "require all search words")
-        .option("--include-reviewed", "include repositories already in the catalog")
-        .option("--feed <path>", "alternate discovered.json evidence feed")
-        .option("--json", "emit machine-readable JSON")
-        .action(async (options) => {
-        const limit = Number(options.limit);
-        if (!Number.isInteger(limit) || limit < 1 || limit > 500)
-            throw new Error("--limit must be an integer from 1 to 500");
-        const result = await listDiscoveryCandidates({
-            limit,
-            query: options.query,
-            includeReviewed: options.includeReviewed,
-            path: options.feed,
-        });
-        console.log(options.json
-            ? JSON.stringify(result, null, 2)
-            : formatCandidateSummaries(result));
-    });
-    candidate
-        .command("inspect")
-        .allowExcessArguments(false)
-        .description("Clone one lead at an immutable commit and build a static evidence dossier")
-        .argument("<repository>", "owner/repository present in the discovery feed")
-        .option("--feed <path>", "alternate discovered.json evidence feed")
-        .option("--write", "persist the dossier in private Loadout state")
-        .option("--output <path>", "persist at an explicit path (implies --write)")
-        .option("--json", "emit the complete dossier as JSON")
-        .action(async (repository, options) => {
-        const dossier = await buildCandidateDossier(repository, {
-            discoveryPath: options.feed,
-        });
-        const path = options.write || options.output
-            ? await writeCandidateDossier(dossier, options.output)
-            : undefined;
-        if (options.json)
-            return console.log(JSON.stringify({
-                dossier,
-                persisted: Boolean(path),
-                ...(path ? { path } : {}),
-            }, null, 2));
-        console.log(formatCandidateDossier(dossier));
-        if (path)
-            console.log(`Dossier: ${path}`);
-        else {
-            console.log("Preview only. Re-run with --write to persist this dossier.");
-        }
-    });
-    candidate
-        .command("propose")
-        .allowExcessArguments(false)
-        .description("Convert a reviewed dossier into a catalog-record proposal; never edits the catalog")
-        .argument("<dossier>", "persisted candidate dossier JSON")
-        .requiredOption("--id <id>", "lowercase kebab-case catalog id")
-        .requiredOption("--category <category>", "inspected catalog category")
-        .requiredOption("--platforms <ids>", "explicitly reviewed comma-separated platforms: windows,macos,linux")
-        .option("--display-name <name>", "reviewed display name")
-        .option("--description <text>", "reviewed description")
-        .option("--license <spdx>", "human-reviewed license override")
-        .option("--tier <tier>", "official, stable, trending, or community", "community")
-        .option("--approve", "confirm human review and write the proposal")
-        .option("--output <path>", "proposal JSON output path; required with --approve")
-        .option("--json", "emit machine-readable JSON")
-        .action(async (dossierPath, options) => {
-        const platforms = options.platforms
-            .split(",")
-            .map((item) => item.trim())
-            .filter(Boolean);
-        const knownPlatforms = new Set(["windows", "macos", "linux"]);
-        if (platforms.some((item) => !knownPlatforms.has(item)))
-            throw new Error("--platforms supports only windows, macos, and linux");
-        const knownTiers = new Set([
-            "official",
-            "stable",
-            "trending",
-            "community",
-        ]);
-        if (!knownTiers.has(options.tier))
-            throw new Error("--tier is invalid");
-        if (options.approve && !options.output)
-            throw new Error("--approve requires --output so catalog mutation stays separate");
-        const proposal = buildCatalogProposal(await verifyCandidateDossierSource(await readCandidateDossier(dossierPath)), {
-            id: options.id,
-            category: options.category,
-            operatingSystems: platforms,
-            tier: options.tier,
-            displayName: options.displayName,
-            description: options.description,
-            license: options.license,
-        }, await loadEffectiveCatalog());
-        const output = options.approve ? resolve(options.output) : undefined;
-        if (output)
-            await writeFileAtomically(output, `${JSON.stringify(proposal, null, 2)}\n`);
-        if (options.json)
-            return console.log(JSON.stringify({
-                proposal,
-                approved: Boolean(output),
-                catalogMutated: false,
-                ...(output ? { output } : {}),
-            }, null, 2));
-        console.log(JSON.stringify(proposal, null, 2));
-        if (!output)
-            console.log("Proposal preview only. Human review is still required; use --approve --output <path> to persist it.");
-        else
-            console.log(`Approved proposal written to ${output}.`);
-    });
-    candidate
-        .command("promote")
-        .allowExcessArguments(false)
-        .description("Merge a reviewed proposal into the local catalog; requires --approve")
-        .argument("<proposal>", "proposal JSON file from `candidate propose --approve`")
-        .option("--approve", "confirm human review and write to catalog")
-        .option("--json", "emit machine-readable JSON")
-        .action(async (proposalPath, options) => {
-        const proposal = JSON.parse(await readFile(resolve(proposalPath), "utf8"));
-        validateCatalog([proposal], { requireEvidence: true });
-        if (!options.approve) {
-            if (options.json)
-                return console.log(JSON.stringify({ proposal, promoted: false, catalogMutated: false }, null, 2));
-            console.log(JSON.stringify(proposal, null, 2));
-            console.log("Preview only. Re-run with --approve to merge into the catalog.");
-            return;
-        }
-        const result = await promoteCatalogCandidate(proposal);
-        const item = await markPromoted(proposal.repository);
-        if (options.json)
-            return console.log(JSON.stringify({
-                proposal,
-                promoted: true,
-                catalogMutated: true,
-                ...result,
-                reviewQueue: item,
-            }, null, 2));
-        console.log(`Promoted '${proposal.id}' into ${result.catalogPath} (${result.totalRecords} records). Review queue: ${item.repository} marked promoted.`);
-    });
+    registerCandidateCommands(program);
     program
         .command("discover")
         .description("Find public community leads; discovery never installs anything")
@@ -590,216 +443,5 @@ export function registerCatalog(program) {
         });
         console.log(`Verified model selection '${id}'. No credential value was stored or printed.`);
     });
-    const skills = program
-        .command("skills")
-        .description("Install the skills Loadout ships so your agents can use Loadout from inside a conversation");
-    skills
-        .command("list", { isDefault: true })
-        .description("Show the skills Loadout ships and whether they are installed")
-        .option("--json", "emit machine-readable JSON")
-        .action(async (options) => {
-        const installed = await installedFirstPartySkills();
-        console.log(options.json
-            ? JSON.stringify(FIRST_PARTY_SKILLS.map((skill) => ({
-                ...skill,
-                installed: installed.has(skill.id),
-            })), null, 2)
-            : formatFirstPartySkillList(installed));
-    });
-    skills
-        .command("install")
-        .description("Preview or install one Loadout skill into detected agents")
-        .argument("<id>", "skill id, for example loadout-router")
-        .option("--agents <ids>", "comma-separated agent ids; defaults to all detected")
-        .option("--yes", "apply after previewing")
-        .action(async (id, options) => {
-        const plan = await planFirstPartySkill(id, {
-            ...(options.agents
-                ? { agents: parseAgentSelection(options.agents) }
-                : {}),
-        });
-        console.log(formatFirstPartySkillPlan(plan));
-        if (!plan.targets.length)
-            return;
-        if (!options.yes) {
-            console.log("\nPreview only. Re-run with --yes to install.");
-            return;
-        }
-        await applyFirstPartySkill(plan);
-        console.log(`\nInstalled '${plan.skill.id}' for ${plan.targets.length} agent(s). Start a new agent session to pick it up.`);
-    });
-    skills
-        .command("remove")
-        .description("Preview or remove one Loadout skill from detected agents")
-        .argument("<id>", "skill id")
-        .option("--agents <ids>", "comma-separated agent ids; defaults to all detected")
-        .option("--yes", "apply after previewing")
-        .action(async (id, options) => {
-        const plan = await planFirstPartySkill(id, {
-            ...(options.agents
-                ? { agents: parseAgentSelection(options.agents) }
-                : {}),
-        });
-        const present = plan.targets.filter((target) => target.replacing);
-        if (!present.length) {
-            console.log(`'${id}' is not installed for any detected agent.`);
-            return;
-        }
-        for (const target of present)
-            console.log(`  remove → ${target.destination}  [${target.displayName}]`);
-        if (!options.yes) {
-            console.log("\nPreview only. Re-run with --yes to remove.");
-            return;
-        }
-        await removeFirstPartySkill(plan);
-        console.log(`\nRemoved '${id}' from ${present.length} agent(s).`);
-    });
-    const handoff = program
-        .command("handoff")
-        .description("Cross-agent file-based task handoff — send work between Claude Code, Codex, and other agents");
-    handoff
-        .command("init")
-        .description("Create the .handoff/ protocol directory in the current project")
-        .action(async () => {
-        const projectRoot = process.cwd();
-        if (await isHandoffInitialized(projectRoot)) {
-            console.log("Handoff already initialized at .handoff/");
-            return;
-        }
-        const dir = await initHandoff(projectRoot);
-        console.log(`Initialized handoff protocol at ${dir}`);
-        console.log("Add .handoff/ to version control so both agents share the message log.");
-    });
-    handoff
-        .command("send")
-        .description("Send a task or message to another agent")
-        .argument("<agent>", "target agent (e.g. codex, claude-code)")
-        .argument("<description...>", "task description")
-        .option("--from <agent>", "sending agent", "user")
-        .option("--type <type>", "message type: task, handoff, question, status, error, cancel", "task")
-        .option("--context <text>", "additional context for the receiving agent")
-        .option("--json", "emit machine-readable JSON")
-        .action(async (agent, descriptionWords, options) => {
-        const message = await sendHandoff(process.cwd(), agent, descriptionWords.join(" "), {
-            from: options.from,
-            type: options.type,
-            context: options.context,
-        });
-        console.log(options.json
-            ? JSON.stringify(message, null, 2)
-            : `Sent ${message.type} ${message.id} → ${message.to}: ${message.description}`);
-    });
-    handoff
-        .command("done")
-        .description("Mark a handoff task as completed")
-        .argument("<id>", "message id to mark done")
-        .option("--json", "emit machine-readable JSON")
-        .action(async (id, options) => {
-        const message = await markDone(process.cwd(), id);
-        console.log(options.json
-            ? JSON.stringify(message, null, 2)
-            : `Marked ${id} as done`);
-    });
-    handoff
-        .command("inbox")
-        .description("Show pending tasks addressed to one agent, as instructions it can act on")
-        .argument("<agent>", "agent reading its inbox (e.g. claude-code, codex)")
-        .option("--json", "emit machine-readable JSON")
-        .action(async (agent, options) => {
-        const messages = await readInbox(process.cwd(), agent);
-        console.log(options.json
-            ? JSON.stringify(messages, null, 2)
-            : formatInbox(agent, messages));
-    });
-    handoff
-        .command("pickup")
-        .description("Teach agents to check their handoff inbox by adding a managed block to CLAUDE.md / AGENTS.md")
-        .option("--agents <ids>", "comma-separated agents to instruct", "claude-code,codex")
-        .option("--yes", "write the files after previewing")
-        .action(async (options) => {
-        const agents = options.agents
-            .split(",")
-            .map((value) => value.trim())
-            .filter(Boolean);
-        const plans = [];
-        for (const agent of agents)
-            plans.push(await planPickup(process.cwd(), agent));
-        console.log(formatPickupPlan(plans));
-        if (!options.yes) {
-            console.log("\nPreview only. Re-run with --yes to write these files.");
-            return;
-        }
-        for (const plan of plans)
-            await applyPickup(plan);
-        console.log(`\nWrote pickup instructions for ${plans.length} agent(s). They will check their inbox on the next session.`);
-    });
-    handoff
-        .command("status")
-        .description("Show pending and completed handoff tasks")
-        .option("--json", "emit machine-readable JSON")
-        .action(async (options) => {
-        const state = await getHandoffState(process.cwd());
-        console.log(options.json
-            ? JSON.stringify(state, null, 2)
-            : formatHandoffStatus(state));
-    });
-    const route = program
-        .command("route")
-        .description("Recommend the right model tier and agent for a task — plan, implement, review, test, debug, or document");
-    route
-        .argument("[description...]", "natural-language task description")
-        .option("--phase <phase>", "explicit phase instead of auto-classify")
-        .option("--conserve", "recommend cheaper tiers to stretch remaining session quota")
-        .option("--cost", "show cost comparison table across all phases")
-        .option("--models", "list the full model catalog Loadout knows about")
-        .option("--provider <name>", "filter models by provider (anthropic, openai, google, deepseek, meta)")
-        .option("--tier <tier>", "filter models by tier (frontier, standard, fast)")
-        .option("--json", "emit machine-readable JSON")
-        .action(async (descriptionWords, options) => {
-        if (options.models) {
-            console.log(options.json
-                ? JSON.stringify((await import("../core/routing/route.js")).MODEL_CATALOG, null, 2)
-                : formatModelCatalog({
-                    provider: options.provider,
-                    tier: options.tier,
-                }));
-            return;
-        }
-        if (options.cost) {
-            console.log(options.json
-                ? JSON.stringify((await import("../core/routing/route.js")).estimateCostSavings(), null, 2)
-                : formatCostTable());
-            return;
-        }
-        const description = descriptionWords.join(" ").trim();
-        if (!description && !options.phase) {
-            console.log(options.json
-                ? JSON.stringify(allPhaseRoutes(options.conserve), null, 2)
-                : formatRoutingTable(options.conserve));
-            return;
-        }
-        const rec = options.phase
-            ? routePhase(options.phase, options.conserve)
-            : routeTask(description, options.conserve);
-        // Recommendations are only useful when they name agents this machine
-        // actually has, so detection drives both the advice and the handoff line.
-        const detected = await detectAgents();
-        const installedAgents = detected
-            .filter((agent) => agent.installed)
-            .map((agent) => agent.id);
-        console.log(options.json
-            ? JSON.stringify({ ...rec, installedAgents }, null, 2)
-            : formatRouteRecommendation(rec, {
-                installedAgents,
-                ...(description ? { description } : {}),
-                handoffReady: await isHandoffInitialized(process.cwd()),
-            }));
-    });
-    program
-        .command("completion")
-        .description("Print a shell-completion script; redirect it to your shell profile")
-        .argument("<shell>", "bash, zsh, fish, or powershell")
-        .action((shell) => {
-        process.stdout.write(renderShellCompletion(parseCompletionShell(shell)));
-    });
+    registerWorkflowCommands(program);
 }