@phren/cli/dist/cli/ops.js

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

import { taskReadiness, filterTaskDoc, taskCounts } from "../data/task-contract.js";
import * as fs from "fs";
import * as path from "path";
import { execFileSync } from "child_process";
import { EXEC_TIMEOUT_MS, findProjectNameCaseInsensitive, getPhrenPath, normalizeProjectNameForCreate, } from "../shared.js";
import { isValidProjectName, errorMessage } from "../utils.js";
import { readTasksAcrossProjects, TASKS_FILENAME, FINDINGS_FILENAME } from "../data/access.js";
import { applyGravity } from "../data/tasks.js";
import { buildIndex, queryRows } from "../shared/index.js";
import { resolveSubprocessArgs } from "./hooks.js";
import { listAllSessions, getSessionArtifacts } from "../tools/session.js";
export function handleTaskView(profile, filter = {}, project) {
    const docs = readTasksAcrossProjects(getPhrenPath(), profile).filter(doc => !project || doc.project.toLowerCase() === project.toLowerCase());
    if (!docs.length) {
        console.log("No tasks found.");
        return;
    }
    let totalActive = 0;
    let totalQueue = 0;
    for (const original of docs) {
        const doc = filterTaskDoc(getPhrenPath(), original, filter);
        const activeCount = doc.items.Active.length;
        const queueCount = doc.items.Queue.length;
        if (activeCount === 0 && queueCount === 0)
            continue;
        totalActive += activeCount;
        totalQueue += queueCount;
        console.log(`\n## ${doc.project}`);
        const counts = taskCounts(getPhrenPath(), original);
        console.log(`  Human: ${counts.human}; Agent ready: ${counts.agentReady}; waiting on human: ${counts.agentWaitingOnHuman}; waiting on task: ${counts.agentWaitingOnTask}.`);
        if (activeCount > 0) {
            console.log("  Active:");
            const activeWithGravity = applyGravity(doc.items.Active).sort((a, b) => (a.rank ?? 0) - (b.rank ?? 0));
            for (const item of activeWithGravity) {
                const rankTag = item.rank !== undefined ? ` [#${item.rank}]` : "";
                const github = item.githubIssue ? ` [gh:#${item.githubIssue}]` : item.githubUrl ? " [gh]" : "";
                const ready = taskReadiness(getPhrenPath(), original, item);
                console.log(`    - ${item.line}${rankTag}${github} [${ready.responsibility} · ${ready.readiness}]`);
                for (const prerequisite of ready.prerequisites) {
                    const responsibility = prerequisite.missing ? "Unknown responsibility" : prerequisite.responsibility === "human" ? "Human" : "Agent";
                    console.log(`      ${prerequisite.missing ? "Unavailable" : prerequisite.completed ? "✓" : "Waiting on"} [${responsibility}] ${prerequisite.title}`);
                    console.log(`        ${prerequisite.storeId}/${prerequisite.project}/${prerequisite.stableId}`);
                }
            }
        }
        if (queueCount > 0) {
            console.log("  Queue:");
            const queueWithGravity = applyGravity(doc.items.Queue).sort((a, b) => (a.rank ?? 0) - (b.rank ?? 0));
            for (const item of queueWithGravity) {
                const rankTag = item.rank !== undefined ? ` [#${item.rank}]` : "";
                const github = item.githubIssue ? ` [gh:#${item.githubIssue}]` : item.githubUrl ? " [gh]" : "";
                const ready = taskReadiness(getPhrenPath(), original, item);
                console.log(`    - ${item.line}${rankTag}${github} [${ready.responsibility} · ${ready.readiness}]`);
                for (const prerequisite of ready.prerequisites) {
                    const responsibility = prerequisite.missing ? "Unknown responsibility" : prerequisite.responsibility === "human" ? "Human" : "Agent";
                    console.log(`      ${prerequisite.missing ? "Unavailable" : prerequisite.completed ? "✓" : "Waiting on"} [${responsibility}] ${prerequisite.title}`);
                    console.log(`        ${prerequisite.storeId}/${prerequisite.project}/${prerequisite.stableId}`);
                }
            }
        }
    }
    if (totalActive === 0 && totalQueue === 0) {
        console.log("All tasks are empty.");
        return;
    }
    console.log(`\n${totalActive} active, ${totalQueue} queued across ${docs.length} project(s).`);
}
export async function handleSessionsView(args) {
    const phrenPath = getPhrenPath();
    const sessionId = args[0];
    if (sessionId) {
        // Drill into a specific session
        const sessions = listAllSessions(phrenPath, 200);
        const session = sessions.find(s => s.sessionId === sessionId || s.sessionId.startsWith(sessionId));
        if (!session) {
            console.error(`Session "${sessionId}" not found.`);
            process.exit(1);
        }
        const artifacts = await getSessionArtifacts(phrenPath, session.sessionId);
        console.log(`Session: ${session.sessionId.slice(0, 8)}`);
        console.log(`Project: ${session.project ?? "—"}`);
        console.log(`Started: ${session.startedAt.slice(0, 16).replace("T", " ")}`);
        console.log(`Duration: ${session.durationMins ?? 0} min`);
        console.log(`Status: ${session.status}`);
        if (session.summary)
            console.log(`Summary: ${session.summary}`);
        if (artifacts.findings.length > 0) {
            console.log(`\nFindings (${artifacts.findings.length}):`);
            for (const f of artifacts.findings)
                console.log(`  - [${f.project}] ${f.text}`);
        }
        if (artifacts.tasks.length > 0) {
            console.log(`\nTasks (${artifacts.tasks.length}):`);
            for (const t of artifacts.tasks)
                console.log(`  - [${t.project}/${t.section}] ${t.text}`);
        }
        return;
    }
    // List all sessions
    const sessions = listAllSessions(phrenPath, 50);
    if (sessions.length === 0) {
        console.log("No sessions found.");
        return;
    }
    console.log("Sessions (newest first):\n");
    for (const s of sessions) {
        const id = s.sessionId.slice(0, 8);
        const proj = s.project ?? "—";
        const dur = s.durationMins != null ? `${s.durationMins}m` : "?";
        const status = s.status === "active" ? " ●" : "";
        const findings = s.findingsAdded > 0 ? ` ${s.findingsAdded}f` : "";
        const date = s.startedAt.slice(0, 16).replace("T", " ");
        const summary = s.summary ? `  ${s.summary.slice(0, 50)}` : "";
        console.log(`  ${id}${status}  ${date}  ${dur}${findings}  ${proj}${summary}`);
    }
    console.log(`\n${sessions.length} session(s). Use \`phren sessions <id>\` to drill into one.`);
}
export async function handleQuickstart() {
    const { runInit } = await import("../init/init.js");
    const { runLink } = await import("../link/link.js");
    const dirBasename = path.basename(process.cwd());
    const readline = await import("readline");
    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
    const projectName = await new Promise((resolve) => {
        rl.question(`Project name [${dirBasename}]: `, (answer) => {
            rl.close();
            resolve(answer.trim() || dirBasename);
        });
    });
    const normalizedProjectName = normalizeProjectNameForCreate(projectName);
    if (!isValidProjectName(normalizedProjectName)) {
        console.error(`Error: invalid project name "${projectName}". Use lowercase letters, numbers, hyphens, or underscores.`);
        return;
    }
    console.log(`\nInitializing phren for "${normalizedProjectName}"...\n`);
    await runInit({ yes: true });
    const phrenPath = getPhrenPath();
    await runLink(phrenPath, {});
    const existingProject = findProjectNameCaseInsensitive(phrenPath, normalizedProjectName);
    if (existingProject && existingProject !== normalizedProjectName) {
        console.error(`Error: project "${existingProject}" already exists with different casing. Refusing to create "${normalizedProjectName}" because it would split the same project on case-sensitive filesystems.`);
        return;
    }
    const projectDir = path.join(phrenPath, normalizedProjectName);
    if (!fs.existsSync(projectDir)) {
        fs.mkdirSync(projectDir, { recursive: true });
        fs.writeFileSync(path.join(projectDir, FINDINGS_FILENAME), `# ${normalizedProjectName} Findings\n`);
        fs.writeFileSync(path.join(projectDir, TASKS_FILENAME), `# ${normalizedProjectName} Tasks\n\n## Active\n\n## Queue\n\n## Done\n`);
    }
    console.log(`\n\u2713 phren ready. Project: ${normalizedProjectName}. Try: phren search 'your query'`);
}
export async function handleDebugInjection(args, profile) {
    let cwd = process.cwd();
    let sessionId = `debug-${Date.now()}`;
    const promptParts = [];
    for (let i = 0; i < args.length; i++) {
        const arg = args[i];
        if (arg === "--cwd") {
            cwd = args[++i] || cwd;
            continue;
        }
        if (arg === "--session") {
            sessionId = args[++i] || sessionId;
            continue;
        }
        if (arg === "--prompt") {
            promptParts.push(args[++i] || "");
            continue;
        }
        promptParts.push(arg);
    }
    const prompt = promptParts.join(" ").trim();
    if (!prompt) {
        console.error('Usage: phren debug-injection --prompt "your prompt here" [--cwd <path>] [--session <id>]');
        process.exit(1);
    }
    const subprocessArgs = resolveSubprocessArgs("hook-prompt");
    if (!subprocessArgs) {
        console.error("Could not resolve phren entrypoint for debug-injection.");
        process.exit(1);
    }
    const payload = JSON.stringify({
        prompt,
        cwd,
        session_id: sessionId,
    });
    try {
        const out = execFileSync(process.execPath, subprocessArgs, {
            cwd: process.cwd(),
            encoding: "utf8",
            stdio: ["pipe", "pipe", "pipe"],
            input: payload,
            env: {
                ...process.env,
                PHREN_PATH: getPhrenPath(),
                PHREN_PROFILE: profile,
            },
            timeout: EXEC_TIMEOUT_MS,
        }).trim();
        if (!out) {
            console.log("(no context injected)");
            return;
        }
        console.log(out);
    }
    catch (err) {
        const stderr = err instanceof Error && "stderr" in err ? String(err.stderr || "").trim() : "";
        if (stderr)
            console.error(stderr);
        console.error(`debug-injection failed: ${errorMessage(err)}`);
        process.exit(1);
    }
}
export async function handleInspectIndex(args, profile) {
    let project;
    let type;
    let limit = 20;
    for (let i = 0; i < args.length; i++) {
        const arg = args[i];
        if (arg === "--project") {
            project = args[++i];
            continue;
        }
        if (arg === "--type") {
            type = args[++i];
            continue;
        }
        if (arg === "--limit") {
            const parsed = Number.parseInt(args[++i] || "", 10);
            if (!Number.isNaN(parsed) && parsed > 0)
                limit = Math.min(parsed, 200);
            continue;
        }
        if (arg === "--help" || arg === "-h") {
            console.log("Usage: phren inspect-index [--project <name>] [--type <doc-type>] [--limit <n>]");
            return;
        }
    }
    const db = await buildIndex(getPhrenPath(), profile);
    const where = [];
    const params = [];
    if (project) {
        where.push("project = ?");
        params.push(project);
    }
    if (type) {
        where.push("type = ?");
        params.push(type);
    }
    const whereSql = where.length ? `WHERE ${where.join(" AND ")}` : "";
    const totalRows = queryRows(db, `SELECT count(*) FROM docs ${whereSql}`, params);
    const total = Number(totalRows?.[0]?.[0] ?? 0);
    console.log(`FTS index docs: ${total}`);
    if (project)
        console.log(`Project filter: ${project}`);
    if (type)
        console.log(`Type filter: ${type}`);
    const sample = queryRows(db, `SELECT project, filename, type, path FROM docs ${whereSql} ORDER BY project, type, filename LIMIT ?`, [...params, limit]);
    if (!sample || sample.length === 0) {
        console.log("No rows for current filter.");
        return;
    }
    console.log("");
    for (const row of sample) {
        const [proj, filename, docType, filePath] = row;
        console.log(`- ${proj}/${filename} (${docType})`);
        console.log(`  ${filePath}`);
    }
}