@opvs-ai/cli 0.23.0 → 0.25.0

package/dist/commands/code.js

@@ -1,9 +1,10 @@
 /**
- * opvs code — the tenant code index query door (TCI · 2.2)
+ * opvs code — the tenant code index query door (TCI · 2.2 + 2.4)
  *
  * The question this answers is "does this already exist in the repo?", asked by
- * an agent that is about to write something. It is the CLI face of
- * `GET /api/v1/code/{project_id}/context` and `.../summary`.
+ * an agent that is about to write something. It is the CLI face of every read
+ * the API serves under `/api/v1/code/{project_id}/`: context, summary, tree,
+ * files, symbols, and the stable-node reads (resolve, changes).
  *
  * ⚠️ THE VERDICT IS NOT THE WHOLE ANSWER.
  * `indexed: false` and `verdict: "none"` are DIFFERENT facts and the API returns
@@ -18,6 +19,15 @@
  * scope ceiling. `code:write` (the ingest lane) is deliberately not, and there is
  * no CLI command for it: an index pass is a 50,000-row bulk load and a worker
  * session must not be able to spend one (D5).
+ *
+ * SEND ONLY WHAT THE USER SET (TCI-112, P2.4)
+ * ---------------------------------------------
+ * Every option here is optional except `--project`. The brief is explicit: do
+ * not invent a default the server did not ask for. A `branch=undefined` on the
+ * wire is a real filter reading as "the branch named 'undefined'"; a
+ * `directory=` left out of `/files` lets the API apply its own `.` default; a
+ * `format=undefined` is a literal string on the URL. Each `if (opts.x) ...`
+ * gate exists so the request the server sees is the request the user asked for.
  */
 import { getEffectiveConfig, createClient } from "@opvs-ai/core";
 import { buildUrl, printResponse } from "../lib/format.js";
@@ -86,5 +96,183 @@ export function registerCodeCommands(program) {
             process.exit(1);
         }
     });
+    // ── tree: the directory rollup behind the canvas (TCI-25) ───────
+    code
+        .command("tree")
+        .description("Directory rollup for a project — where the code lives, how deep, and how much was stored")
+        .requiredOption("--project <id>", "Project id (board_groups.id where kind=project)")
+        .option("--branch <name>", "Answer from a specific indexed branch")
+        .option("--depth <n>", "Deepest directory level to return (1-based; server max 3)")
+        .option("--format <fmt>", "yaml | md | json — overrides the configured default")
+        .action(async (opts) => {
+        const wsSlug = program.opts().workspace;
+        const cfg = getEffectiveConfig(wsSlug);
+        try {
+            const client = createClient(wsSlug);
+            const params = {};
+            if (opts.branch)
+                params.branch = opts.branch;
+            if (opts.depth)
+                params.depth = opts.depth;
+            const url = buildUrl(`/api/v1/code/${opts.project}/tree`, params, opts.format || cfg.format);
+            const res = await client.get(url);
+            await printResponse(res);
+        }
+        catch (err) {
+            const e = err;
+            console.error(`Error: ${e.detail || "Failed to fetch code tree"}`);
+            process.exit(1);
+        }
+    });
+    // ── files: the files beneath one directory that carry symbols ───
+    code
+        .command("files [directory]")
+        .description("Files beneath a directory that carry symbols, most first (default directory: '.')")
+        .requiredOption("--project <id>", "Project id (board_groups.id where kind=project)")
+        .option("--direct", "Only files sitting directly in the directory, not beneath it")
+        .option("--branch <name>", "Answer from a specific indexed branch")
+        .option("--limit <n>", "Max files to return")
+        .option("--format <fmt>", "yaml | md | json — overrides the configured default")
+        .action(async (directory, opts) => {
+        const wsSlug = program.opts().workspace;
+        const cfg = getEffectiveConfig(wsSlug);
+        try {
+            const client = createClient(wsSlug);
+            const params = {};
+            // Only set `directory` if the user gave one. The API's default is `.`,
+            // so omitting it is a request for the whole repo — NOT a request for
+            // the literal string "undefined".
+            if (directory !== undefined)
+                params.directory = directory;
+            if (opts.direct)
+                params.direct = "true";
+            if (opts.branch)
+                params.branch = opts.branch;
+            if (opts.limit)
+                params.limit = opts.limit;
+            const url = buildUrl(`/api/v1/code/${opts.project}/files`, params, opts.format || cfg.format);
+            const res = await client.get(url);
+            await printResponse(res);
+        }
+        catch (err) {
+            const e = err;
+            console.error(`Error: ${e.detail || "Failed to fetch code files"}`);
+            process.exit(1);
+        }
+    });
+    // ── symbols: every symbol in one file, in file order ─────────────
+    code
+        .command("symbols <file_path>")
+        .description("Every symbol in one file, in file order (no edges)")
+        .requiredOption("--project <id>", "Project id (board_groups.id where kind=project)")
+        .option("--branch <name>", "Answer from a specific indexed branch")
+        .option("--limit <n>", "Max symbols to return")
+        .option("--format <fmt>", "yaml | md | json — overrides the configured default")
+        .action(async (filePath, opts) => {
+        const wsSlug = program.opts().workspace;
+        const cfg = getEffectiveConfig(wsSlug);
+        try {
+            const client = createClient(wsSlug);
+            const params = { file_path: filePath };
+            if (opts.branch)
+                params.branch = opts.branch;
+            if (opts.limit)
+                params.limit = opts.limit;
+            const url = buildUrl(`/api/v1/code/${opts.project}/symbols`, params, opts.format || cfg.format);
+            const res = await client.get(url);
+            await printResponse(res);
+        }
+        catch (err) {
+            const e = err;
+            console.error(`Error: ${e.detail || "Failed to fetch code symbols"}`);
+            process.exit(1);
+        }
+    });
+    // ── resolve: text anchors to the current state of stable nodes ──
+    // The schema caps `anchors` at 1000. The cap is checked HERE, before any
+    // request, so a too-large batch fails locally (exit 1) and never spends a
+    // request slot on the server — the same locality a worker session needs
+    // (D5: a worker must not be able to spend a `code:write`, and by extension a
+    // 1000-anchor resolve that the server will refuse anyway).
+    const MAX_RESOLVE_ANCHORS = 1000;
+    code
+        .command("resolve <anchors...>")
+        .description("Resolve text anchors to the current state of stable code nodes (max 1000 anchors)")
+        .requiredOption("--project <id>", "Project id (board_groups.id where kind=project)")
+        .option("--format <fmt>", "yaml | md | json — overrides the configured default")
+        .action(async (anchors, opts) => {
+        if (anchors.length > MAX_RESOLVE_ANCHORS) {
+            console.error(`Error: too many anchors (${anchors.length}); max is ${MAX_RESOLVE_ANCHORS}`);
+            process.exit(1);
+        }
+        const wsSlug = program.opts().workspace;
+        const cfg = getEffectiveConfig(wsSlug);
+        try {
+            const client = createClient(wsSlug);
+            const url = buildUrl(`/api/v1/code/${opts.project}/nodes/resolve`, undefined, opts.format || cfg.format);
+            const res = await client.post(url, { anchors });
+            await printResponse(res);
+        }
+        catch (err) {
+            const e = err;
+            console.error(`Error: ${e.detail || "Failed to resolve code nodes"}`);
+            process.exit(1);
+        }
+    });
+    // ── changes: stable-node history feed (TCI-102, TCI-127) ─────────
+    // D47 (wave 2, TCI-122): the endpoint takes `node_id=` (repeatable, at most
+    // 100) and `path_prefix=` to scope history to one file or one subtree. The
+    // cap is enforced HERE, before any request, so a 101-id batch fails locally
+    // and never spends a request slot on the server (D5).
+    //
+    // `buildUrl` in `@opvs-ai/core` takes a flat record — it cannot send two
+    // `node_id=` parameters, because `Record<string, ...>` collapses repeated
+    // keys to the last value. Per the brief, the query string is built in this
+    // command instead. The `buildUrl` call still carries every single-valued
+    // param (`after`, `limit`, `path_prefix`, `format`); the repeated `node_id`
+    // values are appended by hand, one `node_id=<value>` per occurrence. The
+    // repeated keys are kept intact by `encodeURIComponent`.
+    const MAX_CHANGE_NODE_IDS = 100;
+    code
+        .command("changes")
+        .description("Stable-node history feed for the attached branch, oldest first")
+        .requiredOption("--project <id>", "Project id (board_groups.id where kind=project)")
+        .option("--after <id>", "Return events after this event id (cursor)")
+        .option("--limit <n>", "Max events to return (server max 500)")
+        .option("--node-id <id>", "Stable node UUID; repeat to select up to 100 nodes", (value, prev) => [...prev, value], [])
+        .option("--path-prefix <path>", "Repo-relative path; matches the file itself and its descendants")
+        .option("--format <fmt>", "yaml | md | json — overrides the configured default")
+        .action(async (opts) => {
+        const nodeIds = Array.isArray(opts.nodeId) ? opts.nodeId : [];
+        if (nodeIds.length > MAX_CHANGE_NODE_IDS) {
+            console.error(`Error: too many --node-id values (${nodeIds.length}); max is ${MAX_CHANGE_NODE_IDS}`);
+            process.exit(1);
+        }
+        const wsSlug = program.opts().workspace;
+        const cfg = getEffectiveConfig(wsSlug);
+        try {
+            const client = createClient(wsSlug);
+            const params = {};
+            if (opts.after)
+                params.after = opts.after;
+            if (opts.limit)
+                params.limit = opts.limit;
+            if (opts.pathPrefix)
+                params.path_prefix = opts.pathPrefix;
+            const url = buildUrl(`/api/v1/code/${opts.project}/nodes/changes`, params, opts.format || cfg.format);
+            const finalUrl = nodeIds.length > 0
+                ? `${url}${url.includes("?") ? "&" : "?"}${nodeIds
+                    .map((id) => `node_id=${encodeURIComponent(id)}`)
+                    .join("&")}`
+                : url;
+            const res = await client.get(finalUrl);
+            await printResponse(res);
+        }
+        catch (err) {
+            const e = err;
+            console.error(`Error: ${e.detail || "Failed to fetch code node changes"}`);
+            process.exit(1);
+        }
+    });
 }
 //# sourceMappingURL=code.js.map

package/dist/commands/code.js.map

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

package/dist/commands/memory-capture.d.ts

@@ -0,0 +1,76 @@
+/** Opt-in, local-first session capture for supported coding runtimes. */
+import { Command } from "commander";
+import { type ContentState } from "../lib/redact.js";
+type Runtime = "claude_code" | "cline" | "codex" | "cursor" | "opencode";
+type HookName = "post-tool" | "stop" | "session-end";
+type PluginRuntime = "cline" | "opencode";
+type EventKind = "session.started" | "action" | "observation" | "message" | "error" | "session.completed";
+export interface CaptureEvent {
+    id: string;
+    kind: EventKind;
+    index: number;
+    fidelity: "seen" | "guessed";
+    content_state: ContentState;
+    timestamp?: string;
+    data: Record<string, unknown>;
+}
+export interface CaptureState {
+    version: 1;
+    enabled: true;
+    token: string;
+    api_url: string;
+    brand_id: number | null;
+    codex_files: Record<string, number>;
+}
+export interface CapturePayload {
+    runtime: Runtime;
+    session_id: string;
+    events: CaptureEvent[];
+}
+interface FetchLike {
+    (input: string | URL | Request, init?: RequestInit): Promise<Response>;
+}
+export declare function loadCaptureState(): CaptureState | null;
+export declare function saveCaptureState(state: CaptureState): void;
+export declare function disableCapture(): void;
+export declare function deterministicEventId(runtime: Runtime, sessionId: string, eventIndex: number, rawLine: string): string;
+/** Map one Claude hook input. No field not named here can leave the machine. */
+export declare function buildClaudeEvents(hook: HookName, input: Record<string, unknown>, options?: {
+    rawLine?: string;
+    redact?: boolean;
+}): CapturePayload;
+/** Map Cursor hook input conservatively; every semantic mapping is inferred. */
+export declare function buildCursorEvents(hook: HookName, input: Record<string, unknown>, options?: {
+    rawLine?: string;
+    redact?: boolean;
+}): CapturePayload | null;
+/** Map an OpenCode or Cline hook conservatively; their semantics are inferred. */
+export declare function buildPluginRuntimeEvent(runtime: PluginRuntime, hook: HookName, input: Record<string, unknown>, options?: {
+    rawLine?: string;
+    redact?: boolean;
+}): CapturePayload | null;
+/** Map one Codex session JSONL line using only documented message/tool fields. */
+export declare function buildCodexEvent(sessionId: string, lineIndex: number, rawLine: string, redact?: boolean): CaptureEvent | null;
+export declare function sendCapture(state: CaptureState, payload: CapturePayload, fetchImpl?: FetchLike): Promise<void>;
+type AgentHookDependencies = {
+    loadState: typeof loadCaptureState;
+    send: typeof sendCapture;
+    readInput: () => Promise<string>;
+};
+export declare function runAgentHook(hook: HookName, dependencies?: Partial<AgentHookDependencies>, options?: {
+    runtime?: PluginRuntime;
+}): Promise<void>;
+/** Find only the rollout belonging to this Codex thread. */
+export declare function codexRolloutForThread(root: string, threadId: string): string | null;
+type CodexNotifyDependencies = {
+    loadState: typeof loadCaptureState;
+    saveState: typeof saveCaptureState;
+    send: typeof sendCapture;
+    readInput: () => Promise<string>;
+    codexHome: () => string;
+};
+export declare function runCodexNotify(payload?: string, dependencies?: Partial<CodexNotifyDependencies>): Promise<void>;
+export declare function enableCapture(workspace: string | undefined, suppliedToken: string | undefined, fetchImpl?: FetchLike): Promise<void>;
+/** Add `hook ...` and `capture on|off` below an existing memory command. */
+export declare function registerCaptureHooks(memory: Command): void;
+export {};