@shakecodeslikecray/npc-cli 0.4.3 → 0.4.5

package/dist/commands/init.js

@@ -0,0 +1,145 @@
+import { existsSync, readFileSync, writeFileSync, copyFileSync, chmodSync, mkdirSync, } from "node:fs";
+import { join } from "node:path";
+import { createInterface } from "node:readline";
+import { execFileSync } from "node:child_process";
+import * as api from "../client/api.js";
+import { CREDENTIALS_PATH } from "../config.js";
+import { fetchAndCache } from "./fetch.js";
+function ask(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+export async function init(opts) {
+    // 1. Check auth
+    if (!existsSync(CREDENTIALS_PATH)) {
+        console.error("Not authenticated. Run: npc auth login");
+        process.exit(1);
+    }
+    // 2. Check .git
+    if (!existsSync(".git")) {
+        throw new Error("Not a git repository. Run this from a git repo root.");
+    }
+    // 3. Pick project
+    let projectId = opts.project;
+    let projectName = "";
+    if (!projectId) {
+        const projects = await api.listProjects();
+        if (projects.length === 0) {
+            throw new Error("No projects found. Create one first in the NPC dashboard.");
+        }
+        console.log("\nProjects:");
+        for (let i = 0; i < projects.length; i++) {
+            console.log(`  ${i + 1}) ${projects[i].name}`);
+        }
+        const choice = await ask(`\nSelect project [1-${projects.length}]: `);
+        const idx = parseInt(choice, 10) - 1;
+        if (isNaN(idx) || idx < 0 || idx >= projects.length) {
+            throw new Error("Invalid selection.");
+        }
+        projectId = projects[idx].id;
+        projectName = projects[idx].name;
+    }
+    // 4. Pick repo
+    let repoId = opts.repo;
+    let repoName = "";
+    if (!repoId) {
+        const repos = await api.getProjectRepos(projectId);
+        if (repos.length === 0) {
+            throw new Error("No repos found for this project. Create one first.");
+        }
+        console.log("\nRepos:");
+        for (let i = 0; i < repos.length; i++) {
+            console.log(`  ${i + 1}) ${repos[i].name}`);
+        }
+        const choice = await ask(`\nSelect repo [1-${repos.length}]: `);
+        const idx = parseInt(choice, 10) - 1;
+        if (isNaN(idx) || idx < 0 || idx >= repos.length) {
+            throw new Error("Invalid selection.");
+        }
+        repoId = repos[idx].id;
+        repoName = repos[idx].name;
+    }
+    else {
+        // If repo ID was provided directly, fetch repos to get the name
+        const repos = await api.getProjectRepos(projectId);
+        const match = repos.find((r) => r.id === repoId);
+        repoName = match?.name ?? repoId;
+    }
+    // 5. Write .npcrc.json
+    const npcrc = { project_id: projectId, repo_id: repoId, repo_name: repoName };
+    writeFileSync(".npcrc.json", JSON.stringify(npcrc, null, 2) + "\n");
+    console.log("\n[ok] .npcrc.json written");
+    // 6. Add .npc/ to .gitignore
+    const gitignorePath = ".gitignore";
+    let gitignore = existsSync(gitignorePath)
+        ? readFileSync(gitignorePath, "utf-8")
+        : "";
+    if (!gitignore.includes(".npc/")) {
+        gitignore = gitignore.trimEnd() + "\n.npc/\n";
+        writeFileSync(gitignorePath, gitignore);
+        console.log("[ok] .npc/ added to .gitignore");
+    }
+    else {
+        console.log("[ok] .npc/ already in .gitignore");
+    }
+    // 7. Install git hooks
+    if (opts.hooks !== false) {
+        const hooksDir = join(".git", "hooks");
+        mkdirSync(hooksDir, { recursive: true });
+        const hooks = {
+            "pre-push": "#!/bin/sh\nexec npc hook pre-push \"$@\"\n",
+            "pre-commit": "#!/bin/sh\nexec npc hook pre-commit \"$@\"\n",
+        };
+        for (const [name, content] of Object.entries(hooks)) {
+            const hookPath = join(hooksDir, name);
+            // Skip if already installed
+            if (existsSync(hookPath)) {
+                const existing = readFileSync(hookPath, "utf-8");
+                if (existing.includes("npc hook")) {
+                    console.log(`[ok] ${name} hook already installed`);
+                    continue;
+                }
+                // Back up existing hook
+                const bakPath = `${hookPath}.bak`;
+                copyFileSync(hookPath, bakPath);
+                console.log(`[ok] backed up existing ${name} hook to ${name}.bak`);
+            }
+            writeFileSync(hookPath, content);
+            chmodSync(hookPath, 0o755);
+            console.log(`[ok] ${name} hook installed`);
+        }
+    }
+    else {
+        console.log("[--] hooks skipped (--no-hooks)");
+    }
+    // 8. Run npc fetch
+    if (opts.fetch !== false) {
+        console.log("\nFetching work items...");
+        try {
+            const result = await fetchAndCache(repoId);
+            console.log(`[ok] Cached ${result.item_count} items, ${result.edge_count} edges, ${result.cr_count} CRs`);
+        }
+        catch (err) {
+            console.warn(`[warn] fetch failed: ${err.message || err}`);
+        }
+    }
+    else {
+        console.log("[--] fetch skipped (--no-fetch)");
+    }
+    // 9. Detect Claude Code
+    try {
+        execFileSync("which", ["claude"], { stdio: "pipe" });
+        console.log("\nClaude Code detected. Install NPC plugins:\n" +
+            "  claude plugins:add-marketplace shakecodeslikecray/fordel-plugins");
+    }
+    catch {
+        // claude not found, skip
+    }
+    console.log("\nDone. Repository initialized for NPC.");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -1,4 +1,6 @@
 export declare const NPC_DIR: string;
+export declare const NPC_LOCAL_DIR = ".npc";
+export declare const NPC_CACHE_DIR: string;
 export declare const CREDENTIALS_PATH: string;
 export declare const DEFAULT_API_URL = "https://npc-api.fordelstudios.com";
 /**

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,QAA0B,CAAC;AAC/C,eAAO,MAAM,gBAAgB,QAAoC,CAAC;AAClE,eAAO,MAAM,eAAe,sCAAsC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAkC,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,QAA0B,CAAC;AAC/C,eAAO,MAAM,aAAa,SAAS,CAAC;AACpC,eAAO,MAAM,aAAa,QAAyB,CAAC;AACpD,eAAO,MAAM,gBAAgB,QAAoC,CAAC;AAClE,eAAO,MAAM,eAAe,sCAAsC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAkC,CAAC"}

package/dist/config.js

@@ -1,6 +1,8 @@
 import { homedir } from "node:os";
 import { join } from "node:path";
 export const NPC_DIR = join(homedir(), ".npc");
+export const NPC_LOCAL_DIR = ".npc";
+export const NPC_CACHE_DIR = join(NPC_DIR, "cache");
 export const CREDENTIALS_PATH = join(NPC_DIR, "credentials.json");
 export const DEFAULT_API_URL = "https://npc-api.fordelstudios.com";
 /**

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,mCAAmC,CAAC;AAEnE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG,mCAAmC,CAAC;AAEnE;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC"}

package/dist/index.js

@@ -7,6 +7,9 @@ import { fileURLToPath } from "node:url";
 import * as auth from "./client/auth.js";
 import * as api from "./client/api.js";
 import { CREDENTIALS_PATH, DEFAULT_API_URL } from "./config.js";
+import { readNpcrc, fetchAndCache } from "./commands/fetch.js";
+import { prePush, preCommit } from "./commands/hook.js";
+import { init } from "./commands/init.js";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf8"));
 function prompt(question) {
@@ -437,20 +440,71 @@ program
 });
 program
     .command("pull")
-    .description("Get next unblocked task from the queue")
+    .description("Pull next L2 feature from the queue with all tasks")
     .option("-r, --repo <id>", "Filter by repo UUID")
+    .option("--id <uuid>", "Pull a specific L2 by ID")
+    .option("--l4", "Legacy: pull a single L4 task instead of L2 feature")
     .action(async (opts) => {
     try {
-        const result = await api.queueNext(opts.repo);
+        const level = opts.l4 ? "l4" : "l2";
+        const result = await api.queueNext(opts.repo, level, opts.id);
         const wi = result.work_item;
-        console.log(`Task: ${wi.title}`);
-        console.log(`ID: ${wi.id}`);
-        console.log(`State: ${wi.state}`);
-        console.log(`Priority: ${wi.priority}`);
-        if (wi.description)
-            console.log(`Description: ${wi.description}`);
-        if (result.ancestors.length > 0) {
-            console.log(`Context: ${result.ancestors.map((a) => a.title).join(" > ")}`);
+        if (level === "l4") {
+            // Legacy single-task output
+            console.log(`Task: ${wi.title}`);
+            console.log(`ID: ${wi.id}`);
+            console.log(`State: ${wi.state}`);
+            console.log(`Priority: ${wi.priority}`);
+            if (wi.description)
+                console.log(`Description: ${wi.description}`);
+            if (result.ancestors.length > 0) {
+                console.log(`Context: ${result.ancestors.map((a) => a.title).join(" > ")}`);
+            }
+        }
+        else {
+            // L2 feature tree output
+            console.log(`\nFeature: ${wi.title} (${wi.state})`);
+            console.log(`ID: ${wi.id}`);
+            if (wi.priority && wi.priority !== "none")
+                console.log(`Priority: ${wi.priority}`);
+            if (result.ancestors.length > 0) {
+                console.log(`Context: ${result.ancestors.map((a) => a.title).join(" > ")}`);
+            }
+            if (wi.description)
+                console.log(`\n${wi.description}`);
+            // Group descendants into L3 → L4 tree
+            const descendants = result.descendants || [];
+            const l3s = descendants.filter((d) => d.parent_id === wi.id);
+            const l4sByParent = new Map();
+            for (const d of descendants) {
+                if (d.parent_id && d.parent_id !== wi.id) {
+                    const arr = l4sByParent.get(d.parent_id) || [];
+                    arr.push(d);
+                    l4sByParent.set(d.parent_id, arr);
+                }
+            }
+            if (l3s.length > 0) {
+                console.log(`\nTasks:`);
+                for (const l3 of l3s) {
+                    console.log(`  ${l3.title} [L3]`);
+                    const children = l4sByParent.get(l3.id) || [];
+                    for (const l4 of children) {
+                        const blocked = l4.state === "todo" && l4.claimed_by ? "blocked" : "unblocked";
+                        const stateTag = l4.claimed_by && l4.state === "doing" ? "doing" : l4.state;
+                        console.log(`    [${l4.id.slice(0, 8)}] ${l4.title.padEnd(40)} ${stateTag} (${blocked})`);
+                    }
+                }
+            }
+            // Summary
+            const leaves = descendants.filter((d) => !descendants.some((c) => c.parent_id === d.id));
+            const doing = leaves.filter((l) => l.state === "doing").length;
+            const todo = leaves.filter((l) => l.state === "todo").length;
+            const done = leaves.filter((l) => l.state === "done").length;
+            console.log(`\n${leaves.length} tasks: ${doing} doing, ${todo} todo, ${done} done`);
+            // Auto-refresh local cache after pulling
+            const rc = readNpcrc();
+            if (rc)
+                fetchAndCache(rc.repo_id).catch(() => { });
         }
     }
     catch (err) {
@@ -458,6 +512,19 @@ program
         process.exit(1);
     }
 });
+program
+    .command("release <task-id>")
+    .description("Release a claimed L2 feature back to the queue")
+    .action(async (taskId) => {
+    try {
+        await api.releaseWorkItem(taskId);
+        console.log(`Released: ${taskId}`);
+    }
+    catch (err) {
+        console.error("Error:", err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
 program
     .command("start <task-id>")
     .description("Start working on a task")
@@ -1063,5 +1130,175 @@ testCaseCmd
         process.exit(1);
     }
 });
+// ─── Change Requests ───
+const crCmd = program.command("cr").description("Change request operations");
+crCmd
+    .command("list")
+    .description("List change requests")
+    .option("-r, --repo <id>", "Repo ID (reads .npcrc.json if omitted)")
+    .option("-s, --state <state>", "Filter by state")
+    .action(async (opts) => {
+    try {
+        const repoId = opts.repo || (await readNpcrc())?.repo_id;
+        if (!repoId) {
+            console.error("No repo ID. Use --repo or add .npcrc.json");
+            process.exit(1);
+        }
+        const crs = await api.listChangeRequests(repoId, opts.state);
+        if (crs.length === 0) {
+            console.log("No change requests found.");
+            return;
+        }
+        console.table(crs.map((cr) => ({
+            id: cr.id.slice(0, 8),
+            type: cr.cr_type,
+            state: cr.state,
+            title: cr.title.slice(0, 50),
+            hours: cr.estimated_hours ?? "--",
+            submitted: cr.submitter_name || "Unknown",
+        })));
+    }
+    catch (err) {
+        console.error("Error:", err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
+crCmd
+    .command("pending-qa")
+    .description("List scheduled CRs that need QA items generated")
+    .option("-r, --repo <id>", "Repo ID (reads .npcrc.json if omitted)")
+    .action(async (opts) => {
+    try {
+        const repoId = opts.repo || (await readNpcrc())?.repo_id;
+        if (!repoId) {
+            console.error("No repo ID. Use --repo or add .npcrc.json");
+            process.exit(1);
+        }
+        // Get scheduled CRs
+        const crs = await api.listChangeRequests(repoId, "scheduled");
+        if (crs.length === 0) {
+            console.log("No scheduled CRs.");
+            return;
+        }
+        // Get user flows and their use cases to check existing QA coverage
+        const flows = await api.listUserFlows(repoId);
+        const existingUCTitles = new Set();
+        for (const flow of flows) {
+            const ucs = await api.listUseCases(repoId, flow.id);
+            for (const uc of ucs)
+                existingUCTitles.add(uc.title);
+        }
+        // Filter CRs that don't have matching use cases
+        const pending = crs.filter((cr) => !existingUCTitles.has(`CR: ${cr.title}`));
+        if (pending.length === 0) {
+            console.log("All scheduled CRs have QA coverage.");
+            return;
+        }
+        console.log(`\n${pending.length} CR(s) need QA items:\n`);
+        for (const cr of pending) {
+            console.log(`  [${cr.id.slice(0, 8)}] ${cr.title}`);
+            console.log(`    Type: ${cr.cr_type} | Hours: ${cr.estimated_hours ?? "--"} | By: ${cr.submitter_name || "Unknown"}`);
+            if (cr.description)
+                console.log(`    ${cr.description.slice(0, 120)}`);
+            console.log();
+        }
+        // Output machine-readable JSON for the cron agent
+        console.log("---JSON---");
+        console.log(JSON.stringify(pending.map((cr) => ({
+            id: cr.id,
+            title: cr.title,
+            description: cr.description,
+            cr_type: cr.cr_type,
+            linked_l1: cr.linked_l1,
+        }))));
+    }
+    catch (err) {
+        console.error("Error:", err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
+// ─── Fetch ───
+program
+    .command("fetch")
+    .description("Fetch and cache work items, edges, and CRs for the current repo")
+    .option("-r, --repo <id>", "Repo ID (reads .npcrc.json if omitted)")
+    .option("--force", "Ignore cache staleness, always fetch")
+    .option("-s, --state <state>", "Filter items by state (todo, doing, done)")
+    .option("-q, --search <query>", "Search items by title")
+    .option("--sort <field>", "Sort by field (created_at, updated_at, sort_order)")
+    .option("--labels <labels>", "Filter by labels (comma-separated)")
+    .option("--per-page <n>", "Items per page (default: all)")
+    .action(async (opts) => {
+    try {
+        const repoId = opts.repo || readNpcrc()?.repo_id;
+        if (!repoId) {
+            console.error("No repo ID. Use --repo or add .npcrc.json");
+            process.exit(1);
+        }
+        const params = {};
+        if (opts.state)
+            params.state = opts.state;
+        if (opts.search)
+            params.q = opts.search;
+        if (opts.sort)
+            params.sort = opts.sort;
+        if (opts.labels)
+            params.labels = opts.labels;
+        if (opts.perPage)
+            params.per_page = opts.perPage;
+        console.log("Fetching data from NPC API...");
+        const result = await fetchAndCache(repoId, params);
+        console.log(`Cached ${result.item_count} items, ${result.edge_count} edges, ${result.cr_count} CRs`);
+        console.log(`Cache dir: ${result.cache_dir}`);
+    }
+    catch (err) {
+        console.error("Error:", err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
+// ---------------------------------------------------------------------------
+// Hook commands (called by git hooks)
+// ---------------------------------------------------------------------------
+const hookCmd = program.command("hook").description("Git hook handlers (called by git hooks)");
+hookCmd
+    .command("pre-push")
+    .description("Pre-push hook: signals, CR detection, telemetry")
+    .action(async () => {
+    try {
+        await prePush();
+    }
+    catch (e) {
+        console.log("NPC: Hook error (push continues):", e.message || e);
+    }
+    process.exit(0);
+});
+hookCmd
+    .command("pre-commit")
+    .description("Pre-commit hook: task tracking enforcement")
+    .action(async () => {
+    try {
+        await preCommit();
+    }
+    catch (e) {
+        console.error("NPC:", e.message || e);
+        process.exit(1);
+    }
+});
+program
+    .command("init")
+    .description("Initialize NPC in current repo: auth, config, hooks, cache")
+    .option("-p, --project <id>", "Project UUID (skip interactive)")
+    .option("-r, --repo <id>", "Repo UUID (skip interactive)")
+    .option("--no-hooks", "Skip git hook installation")
+    .option("--no-fetch", "Skip initial data fetch")
+    .action(async (opts) => {
+    try {
+        await init(opts);
+    }
+    catch (err) {
+        console.error("Error:", err.message || err);
+        process.exit(1);
+    }
+});
 program.parse();
 //# sourceMappingURL=index.js.map