@phren/cli/dist/cli/namespaces-review.js

Knowledge layer for AI agents - CLI, MCP server, and data layer

import { isValidProjectName } from "../utils.js";
import { getPhrenPath } from "../shared.js";
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);
        }
        // Print the data layer's own message rather than a generic one. approve
        // and reject each have several distinct outcomes — promoted, already
        // present, already archived, removed from the archive, discarded — and
        // collapsing them into "Approved" hides the difference that matters most:
        // on a store whose findings have aged into reference/topics/, most
        // approvals dequeue without promoting anything.
        const summary = lineText.slice(0, 100) + (lineText.length > 100 ? "..." : "");
        const mark = action === "approve" ? "✓" : "✗";
        const payload = result.data;
        const detail = typeof payload === "string"
            ? payload
            : payload?.message;
        console.log(`${mark} ${detail ?? (action === "approve" ? "Approved" : "Rejected")}`);
        console.log(`  ${summary}`);
        return;
    }
    // Default: show review queue (first arg is project name if not a subcommand)
    const { handleReview } = await import("./actions.js");
    return handleReview(args);
}