@opvs-ai/cli 0.22.0 → 0.24.1

package/dist/commands/memory-lessons.js

@@ -0,0 +1,135 @@
+/**
+ * opvs memory lessons — pull and contribute a skill's shared lessons (AS-590).
+ *
+ * Skills that are installed on a brand can contribute their own anonymized
+ * lessons and pull the ones other brands left behind. The CLI is the terminal
+ * face of `/api/v1/skill-lessons/{vendor}/{name}`; the route validates the
+ * `<vendor>/<name>` reference server-side, but we validate it here too so a
+ * typo never hits the wire.
+ *
+ * The provenance field is one-way: `source_engagement_hash` is `sha256("cli:" +
+ * workspace_slug + ":" + body)`. It must NEVER carry a brand id (AS-445 sealed
+ * anything credential-shaped at curation, but the CLI never gets to find out the
+ * hard way).
+ */
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { createClient } from "@opvs-ai/core";
+import { buildUrl, printJson } from "../lib/format.js";
+const SEGMENT_RE = /^[a-z0-9][a-z0-9-]{0,63}$/;
+const REF_RE = /^@?([a-z0-9][a-z0-9-]{0,63})\/([a-z0-9][a-z0-9-]{0,63})$/;
+export function parseSkillRef(ref) {
+    const match = REF_RE.exec(ref);
+    if (!match)
+        return null;
+    if (!SEGMENT_RE.test(match[1]) || !SEGMENT_RE.test(match[2]))
+        return null;
+    return { vendor: match[1], name: match[2] };
+}
+/** sha256("cli:" + workspace_slug + ":" + body) — never a brand id (AS-590). */
+export function lessonProvenanceHash(workspace, body) {
+    return createHash("sha256").update(`cli:${workspace ?? ""}:${body}`).digest("hex");
+}
+function readBody(body, bodyFile) {
+    if (body && bodyFile) {
+        throw new Error("provide exactly one of --body or --body-file");
+    }
+    if (bodyFile)
+        return readFileSync(bodyFile, "utf8");
+    if (!body)
+        throw new Error("--body or --body-file is required");
+    return body;
+}
+function fail(message) {
+    console.error(`Error: ${message}`);
+    process.exit(1);
+}
+function workspaceOf(command) {
+    let current = command;
+    while (current) {
+        const opts = current.opts();
+        if (opts.workspace)
+            return opts.workspace;
+        current = current.parent;
+    }
+    return undefined;
+}
+export function registerLessonCommands(memory) {
+    const lessons = memory.command("lessons").description("Pull and contribute a skill's shared lessons");
+    lessons
+        .command("get <vendor>/<name>")
+        .description("Pull a skill's shared lessons")
+        .option("--query <text>", "FTS search over body + tags")
+        .option("--limit <n>", "Max items", "25")
+        .option("--since <cursor>", "Forward cursor from a prior pull")
+        .action(async (ref, opts) => {
+        const parsed = parseSkillRef(ref);
+        if (!parsed) {
+            fail(`invalid vendor/name: ${ref} (use <vendor>/<name>, e.g. opvs-ai/opvs-vibe)`);
+        }
+        const wsSlug = workspaceOf(memory);
+        try {
+            const client = createClient(wsSlug);
+            const params = {};
+            if (opts.query)
+                params.query = opts.query;
+            if (opts.limit)
+                params.limit = opts.limit;
+            if (opts.since)
+                params.since = opts.since;
+            const url = buildUrl(`/api/v1/skill-lessons/${parsed.vendor}/${parsed.name}`, params);
+            const res = await client.get(url);
+            printJson(await res.json());
+        }
+        catch (err) {
+            const detail = err?.detail;
+            fail(detail || "Failed to pull skill lessons");
+        }
+    });
+    lessons
+        .command("add <vendor>/<name>")
+        .description("Contribute an anonymized lesson to a skill (→ pending)")
+        .requiredOption("--kind <kind>", "learning | pattern")
+        .option("--body <text>", "The lesson text (NO brand data)")
+        .option("-f, --body-file <path>", "Read the lesson text from a file")
+        .option("--tags <a,b>", "Comma-separated tags")
+        .action(async (ref, opts) => {
+        const parsed = parseSkillRef(ref);
+        if (!parsed) {
+            fail(`invalid vendor/name: ${ref} (use <vendor>/<name>, e.g. opvs-ai/opvs-vibe)`);
+        }
+        if (opts.kind !== "learning" && opts.kind !== "pattern") {
+            fail(`invalid --kind: ${opts.kind} (expected learning | pattern)`);
+        }
+        const wsSlug = workspaceOf(memory);
+        let body;
+        try {
+            body = readBody(opts.body, opts.bodyFile);
+        }
+        catch (err) {
+            fail(err instanceof Error ? err.message : "Failed to read lesson body");
+        }
+        const payload = {
+            kind: opts.kind,
+            body,
+            tags: opts.tags
+                ? opts.tags
+                    .split(",")
+                    .map((tag) => tag.trim())
+                    .filter(Boolean)
+                : null,
+            source_engagement_hash: lessonProvenanceHash(wsSlug, body),
+            craft_id: null,
+        };
+        try {
+            const client = createClient(wsSlug);
+            const res = await client.post(`/api/v1/skill-lessons/${parsed.vendor}/${parsed.name}`, payload);
+            printJson(await res.json());
+        }
+        catch (err) {
+            const detail = err?.detail;
+            fail(detail || "Failed to contribute skill lesson");
+        }
+    });
+}
+//# sourceMappingURL=memory-lessons.js.map

package/dist/commands/memory-lessons.js.map

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

package/dist/commands/memory.d.ts

@@ -0,0 +1,24 @@
+/**
+ * opvs memory — search typed repository memory and propose human curation.
+ */
+import { Command } from "commander";
+interface MemoryEntry {
+    id: string;
+    card?: string | null;
+    scopes?: string[];
+    anchors?: string[];
+    pinned?: boolean;
+    [key: string]: unknown;
+}
+interface ServicePattern {
+    service: string;
+    pattern: string;
+}
+/** Keep the API's relative order within the pinned and unpinned groups. */
+export declare function pinnedFirst(entries: MemoryEntry[]): MemoryEntry[];
+/** Read the service names and path patterns from the canonical registry. */
+export declare function parseServicePatterns(registry: string): ServicePattern[];
+/** Apply services.yaml's global "most specific wins" rule to a repository path. */
+export declare function serviceForPath(path: string, patterns: ServicePattern[]): string | undefined;
+export declare function registerMemoryCommands(program: Command): void;
+export {};

package/dist/commands/memory.js

@@ -0,0 +1,239 @@
+/**
+ * opvs memory — search typed repository memory and propose human curation.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { createClient } from "@opvs-ai/core";
+import { buildUrl, printJson } from "../lib/format.js";
+import { registerCaptureHooks } from "./memory-capture.js";
+import { registerMemoryHooks } from "./memory-hook.js";
+import { registerMemoryInstallCommands } from "./memory-install.js";
+import { registerLessonCommands } from "./memory-lessons.js";
+const SEARCH_PATH = "/api/v1/memory/entries/search";
+/** Keep the API's relative order within the pinned and unpinned groups. */
+export function pinnedFirst(entries) {
+    return entries
+        .map((entry, index) => ({ entry, index }))
+        .sort((a, b) => Number(Boolean(b.entry.pinned)) - Number(Boolean(a.entry.pinned)) || a.index - b.index)
+        .map(({ entry }) => entry);
+}
+function unquote(value) {
+    const trimmed = value.trim();
+    if (trimmed.length >= 2 &&
+        ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+            (trimmed.startsWith("'") && trimmed.endsWith("'")))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+/** Read the service names and path patterns from the canonical registry. */
+export function parseServicePatterns(registry) {
+    const patterns = [];
+    let service;
+    let inCodePaths = false;
+    for (const line of registry.split(/\r?\n/)) {
+        const serviceMatch = line.match(/^ {2}- name:\s*(\S+)\s*$/);
+        if (serviceMatch) {
+            service = unquote(serviceMatch[1]);
+            inCodePaths = false;
+            continue;
+        }
+        if (!service)
+            continue;
+        const planningMatch = line.match(/^ {4}planning_dir:\s*(.+?)\s*$/);
+        if (planningMatch) {
+            const planningDir = unquote(planningMatch[1].replace(/\s+#.*$/, ""));
+            if (planningDir !== "null")
+                patterns.push({ service, pattern: planningDir });
+            continue;
+        }
+        if (/^ {4}code_paths:\s*$/.test(line)) {
+            inCodePaths = true;
+            continue;
+        }
+        if (/^ {4}\S/.test(line)) {
+            inCodePaths = false;
+            continue;
+        }
+        if (inCodePaths) {
+            const pathMatch = line.match(/^ {6}-\s+(.+?)\s*$/);
+            if (pathMatch) {
+                const pattern = unquote(pathMatch[1].replace(/\s+#.*$/, ""));
+                if (pattern)
+                    patterns.push({ service, pattern });
+            }
+        }
+    }
+    return patterns;
+}
+function globRegex(pattern) {
+    const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*+/g, ".*");
+    return new RegExp(`^${escaped}${pattern.endsWith("/") ? "" : "$"}`);
+}
+function matchesPattern(path, pattern) {
+    if (pattern.includes("*"))
+        return globRegex(pattern).test(path);
+    return pattern.endsWith("/") ? path.startsWith(pattern) : path === pattern;
+}
+function specificity(pattern) {
+    const wildcard = pattern.indexOf("*");
+    return [wildcard === -1 ? pattern.length : wildcard, pattern.length];
+}
+/** Apply services.yaml's global "most specific wins" rule to a repository path. */
+export function serviceForPath(path, patterns) {
+    const normalized = path.replace(/\\/g, "/").replace(/^\.\//, "");
+    let best;
+    for (const candidate of patterns) {
+        if (!matchesPattern(normalized, candidate.pattern))
+            continue;
+        if (!best) {
+            best = candidate;
+            continue;
+        }
+        const [candidatePrefix, candidateLength] = specificity(candidate.pattern);
+        const [bestPrefix, bestLength] = specificity(best.pattern);
+        if (candidatePrefix > bestPrefix || (candidatePrefix === bestPrefix && candidateLength > bestLength)) {
+            best = candidate;
+        }
+    }
+    return best?.service;
+}
+function findServicesRegistry(start) {
+    let directory = resolve(start);
+    while (true) {
+        const candidate = join(directory, "memory", "services.yaml");
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(directory);
+        if (parent === directory)
+            throw new Error("memory/services.yaml was not found in this repository");
+        directory = parent;
+    }
+}
+function entriesFrom(payload) {
+    if (!payload || typeof payload !== "object")
+        return [];
+    const items = payload.items;
+    return Array.isArray(items) ? items : [];
+}
+function uniqueEntries(entries) {
+    const seen = new Set();
+    return entries.filter((entry) => {
+        if (seen.has(entry.id))
+            return false;
+        seen.add(entry.id);
+        return true;
+    });
+}
+async function searchEntries(client, params) {
+    const response = await client.get(buildUrl(SEARCH_PATH, params));
+    return (await response.json());
+}
+function contextResult(entries) {
+    const sorted = pinnedFirst(uniqueEntries(entries));
+    return { total: sorted.length, items: sorted };
+}
+function fail(error, fallback) {
+    const detail = error?.detail;
+    console.error(`Error: ${detail || (error instanceof Error ? error.message : fallback)}`);
+    process.exit(1);
+}
+export function registerMemoryCommands(program) {
+    const memory = program.command("memory").description("Search typed repository memory and request curation");
+    registerMemoryHooks(memory);
+    registerCaptureHooks(memory);
+    registerMemoryInstallCommands(memory);
+    registerLessonCommands(memory);
+    memory
+        .command("search <query>")
+        .description("Search typed memory, with pinned entries first")
+        .option("--service <name>", "Restrict to the service scope from memory/services.yaml")
+        .option("--type <type>", "Restrict to an entry type")
+        .action(async (query, opts) => {
+        const wsSlug = program.opts().workspace;
+        try {
+            const client = createClient(wsSlug);
+            const params = { q: query, pinned_first: "true" };
+            if (opts.service)
+                params.scope = `service:${opts.service}`;
+            if (opts.type)
+                params.type = opts.type;
+            const result = await searchEntries(client, params);
+            const items = pinnedFirst(entriesFrom(result));
+            printJson({ ...result, total: items.length, items });
+        }
+        catch (error) {
+            fail(error, "Failed to search memory");
+        }
+    });
+    memory
+        .command("context")
+        .description("Show memory relevant to repository files or a card, with pinned entries first")
+        .option("--files <paths>", "Comma-separated repository paths")
+        .option("--card <ref>", "Card ref whose memory should be shown")
+        .action(async (opts) => {
+        if (Boolean(opts.files) === Boolean(opts.card)) {
+            console.error("Error: provide exactly one of --files <paths> or --card <ref>");
+            process.exit(1);
+        }
+        const wsSlug = program.opts().workspace;
+        try {
+            const client = createClient(wsSlug);
+            if (opts.card) {
+                const result = await searchEntries(client, {
+                    card: opts.card,
+                    pinned_first: "true",
+                });
+                printJson(contextResult(entriesFrom(result).filter((entry) => entry.card === opts.card)));
+                return;
+            }
+            const files = (opts.files ?? "")
+                .split(",")
+                .map((path) => path.trim().replace(/\\/g, "/").replace(/^\.\//, ""))
+                .filter(Boolean);
+            const registry = readFileSync(findServicesRegistry(process.cwd()), "utf8");
+            const patterns = parseServicePatterns(registry);
+            const services = new Set(files.map((path) => serviceForPath(path, patterns)).filter(Boolean));
+            const entries = [];
+            for (const anchor of files) {
+                const result = await searchEntries(client, { anchor, pinned_first: "true" });
+                entries.push(...entriesFrom(result));
+            }
+            for (const service of services) {
+                const result = await searchEntries(client, {
+                    scope: `service:${service}`,
+                    pinned_first: "true",
+                });
+                entries.push(...entriesFrom(result));
+            }
+            printJson(contextResult(entries));
+        }
+        catch (error) {
+            fail(error, "Failed to load memory context");
+        }
+    });
+    memory
+        .command("pin-request <id>")
+        .description("Propose a pin by commenting on the entry's card; this never pins the entry")
+        .requiredOption("--reason <text>", "Why a human should pin this entry")
+        .action(async (id, opts) => {
+        const wsSlug = program.opts().workspace;
+        try {
+            const client = createClient(wsSlug);
+            const response = await client.get(`/api/v1/memory/entries/${encodeURIComponent(id)}`);
+            const entry = (await response.json());
+            if (!entry.card) {
+                console.error("Error: this memory entry has no card on which to record a pin request");
+                process.exit(1);
+            }
+            const comment = await client.post(`/api/v1/board/tasks/${encodeURIComponent(entry.card)}/comments`, {
+                content: `Pin request for memory entry \`${entry.id}\`: ${opts.reason}`,
+            });
+            printJson(await comment.json());
+        }
+        catch (error) {
+            fail(error, "Failed to request a memory pin");
+        }
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/commands/memory.js.map

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

package/dist/commands/myMail.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+/** Register commands for the current person's PAT-backed OPVS mailbox. */
+export declare function registerMyMailCommands(program: Command): void;

package/dist/commands/myMail.js

@@ -0,0 +1,119 @@
+import { randomUUID } from "node:crypto";
+import { createClient, getEffectiveConfig } from "@opvs-ai/core";
+import { Option } from "commander";
+import { buildUrl, printJson, printResponse } from "../lib/format.js";
+function fail(err, fallback) {
+    const error = err;
+    console.error(`Error: ${error.detail || error.message || fallback}`);
+    return process.exit(1);
+}
+function isNotFound(err) {
+    const error = err;
+    return error.status === 404 || error.statusCode === 404 || error.detail === "Not found";
+}
+function rejectRefused(result) {
+    if (result.status === "rejected") {
+        console.error(`Error: ${result.reason || "Message rejected"}`);
+        process.exit(1);
+        return true;
+    }
+    return false;
+}
+/** Register commands for the current person's PAT-backed OPVS mailbox. */
+export function registerMyMailCommands(program) {
+    const myMail = program
+        .command("my-mail")
+        .description("Read and write your OPVS mailbox");
+    myMail
+        .command("inbox")
+        .description("List messages in your OPVS mailbox")
+        .option("--status <status>", "Filter by message status")
+        .option("--limit <n>", "Maximum messages to return", "50")
+        .action(async (opts) => {
+        const workspace = program.opts().workspace;
+        const config = getEffectiveConfig(workspace);
+        const params = {};
+        if (opts.status)
+            params.status = opts.status;
+        if (opts.limit)
+            params.limit = opts.limit;
+        try {
+            const response = await createClient(workspace).get(buildUrl("/api/v1/me/mail", params, config.format));
+            await printResponse(response);
+        }
+        catch (err) {
+            if (isNotFound(err)) {
+                console.error("You have no OPVS mailbox yet.");
+                process.exit(1);
+                return;
+            }
+            fail(err, "Failed to fetch your mailbox");
+        }
+    });
+    myMail
+        .command("thread <thread_id>")
+        .description("Read a thread in your OPVS mailbox")
+        .action(async (threadId) => {
+        const workspace = program.opts().workspace;
+        const config = getEffectiveConfig(workspace);
+        try {
+            const response = await createClient(workspace).get(buildUrl(`/api/v1/me/mail/threads/${encodeURIComponent(threadId)}`, {}, config.format));
+            await printResponse(response);
+        }
+        catch (err) {
+            fail(err, "Failed to read thread");
+        }
+    });
+    myMail
+        .command("send <to> <body>")
+        .description("Send a message from your OPVS mailbox")
+        .addOption(new Option("--type <type>", "Message type: ? ! ~ ^ . > <")
+        .choices(["?", "!", "~", "^", ".", ">", "<"])
+        .default("."))
+        .action(async (to, body, opts) => {
+        const workspace = program.opts().workspace;
+        // Create this once per command invocation. createClient may retry the
+        // request, and each attempt must carry the same idempotency key.
+        const idempotencyKey = randomUUID();
+        try {
+            const response = await createClient(workspace).post("/api/v1/me/mail/send", { to, body, type: opts.type }, { "Idempotency-Key": idempotencyKey });
+            const result = (await response.json());
+            if (rejectRefused(result))
+                return;
+            printJson(result);
+        }
+        catch (err) {
+            fail(err, "Failed to send message");
+        }
+    });
+    myMail
+        .command("reply <message_id> <body>")
+        .description("Reply to a message in your OPVS mailbox")
+        .action(async (messageId, body) => {
+        const workspace = program.opts().workspace;
+        try {
+            const response = await createClient(workspace).post(`/api/v1/me/mail/messages/${encodeURIComponent(messageId)}/reply`, { body });
+            const result = (await response.json());
+            if (rejectRefused(result))
+                return;
+            printJson(result);
+        }
+        catch (err) {
+            fail(err, "Failed to reply");
+        }
+    });
+    myMail
+        .command("status <message_id> <status>")
+        .description("Update a message status in your OPVS mailbox")
+        .action(async (messageId, status) => {
+        const workspace = program.opts().workspace;
+        try {
+            const response = await createClient(workspace).patch(`/api/v1/me/mail/messages/${encodeURIComponent(messageId)}/status`, { status });
+            await printResponse(response);
+        }
+        catch (err) {
+            fail(err, "Failed to update message status");
+        }
+    });
+}
+//# sourceMappingURL=myMail.js.map

package/dist/commands/myMail.js.map

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

package/dist/commands/orgChart.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+/** Register commands for the brand's AI Office org chart. */
+export declare function registerOrgChartCommands(program: Command): void;

package/dist/commands/orgChart.js

@@ -0,0 +1,88 @@
+import { createClient } from "@opvs-ai/core";
+import { Option } from "commander";
+import { buildUrl, printResponse } from "../lib/format.js";
+function fail(err, fallback) {
+    const e = err;
+    const status = e.status ?? e.statusCode;
+    if (status === 404) {
+        console.error("Not found");
+    }
+    else if (status === 422) {
+        console.error(e.detail || e.message || fallback);
+    }
+    else {
+        console.error(`Error: ${e.detail || e.message || fallback}`);
+    }
+    return process.exit(1);
+}
+/** Repeatable commander argParser that turns `--manager <id>` into an array. */
+const collectManagers = (value, acc) => {
+    acc.push(value);
+    return acc;
+};
+/** Register commands for the brand's AI Office org chart. */
+export function registerOrgChartCommands(program) {
+    const orgChart = program
+        .command("org-chart")
+        .description("Read and write the brand's AI Office org chart");
+    orgChart
+        .command("show")
+        .description("Show the brand's AI Office org chart")
+        .addOption(new Option("--format <format>", "Output format (default text; json|yaml pass through)")
+        .choices(["text", "json", "yaml"])
+        .default("text"))
+        .action(async (opts) => {
+        const workspace = program.opts().workspace;
+        try {
+            // text → no hint, CLI parses the JSON and prints lines.
+            // json|yaml → pass the format to the server, print whatever comes back.
+            const requestFormat = opts.format === "text" ? undefined : opts.format;
+            const response = await createClient(workspace).get(buildUrl("/api/v1/org-chart", {}, requestFormat));
+            if (opts.format === "text") {
+                const data = (await response.json());
+                const namesByHire = new Map((data.nodes ?? []).map((n) => [n.hire_id, n.name]));
+                for (const node of data.nodes ?? []) {
+                    const managerNames = node.manager_hire_ids.map((id) => namesByHire.get(id) ?? id);
+                    const tail = managerNames.length ? managerNames.join(", ") : "nobody";
+                    console.log(`${node.name} (${node.role}) → reports to: ${tail}`);
+                }
+            }
+            else {
+                await printResponse(response);
+            }
+        }
+        catch (err) {
+            fail(err, "Failed to fetch org chart");
+        }
+    });
+    orgChart
+        .command("set-manager <hire_id>")
+        .description("Replace the manager list for a hire (--none clears it)")
+        .option("--manager <hire_id>", "Manager hire id (repeatable)", collectManagers, [])
+        .option("--none", "Clear all managers")
+        .action(async (hireId, opts) => {
+        // Bare `set-manager <hire>` would silently send `manager_hire_ids: []`
+        // and clear the hire's managers — refuse it before any request.
+        if (!opts.none && opts.manager.length === 0) {
+            console.error("Error: give --manager <hire_id> (repeatable) or --none");
+            process.exit(1);
+            return;
+        }
+        // Both intents are about the same wire field — picking one silently would
+        // send a bundle the operator did not ask for.
+        if (opts.none && opts.manager.length > 0) {
+            console.error("Error: --none cannot be combined with --manager");
+            process.exit(1);
+            return;
+        }
+        const workspace = program.opts().workspace;
+        try {
+            const response = await createClient(workspace).put(`/api/v1/org-chart/agents/${encodeURIComponent(hireId)}/managers`, { manager_hire_ids: opts.none ? [] : opts.manager });
+            await printResponse(response);
+        }
+        catch (err) {
+            fail(err, "Failed to set managers");
+        }
+    });
+}
+//# sourceMappingURL=orgChart.js.map