@oxygen-agent/cli 1.1014.136 → 1.1014.618

package/dist/commands/context.js

@@ -0,0 +1,170 @@
+import { parseJsonObject, readPositiveInt } from "../cli-values.js";
+import { buildContextResolveBody, readCsvOption } from "../command-support.js";
+import { requestOxygen } from "../http-client.js";
+import { readOption } from "../util.js";
+import { Command } from "commander";
+function contextAssetsQuery(options) {
+    const query = new URLSearchParams();
+    if (readOption(options.type))
+        query.set("type", readOption(options.type) ?? "");
+    if (readOption(options.status))
+        query.set("status", readOption(options.status) ?? "");
+    for (const tag of readCsvOption(options.tags))
+        query.append("tag", tag);
+    if (options.includeArchived)
+        query.set("include_archived", "true");
+    const limit = readPositiveInt(options.limit);
+    if (limit !== undefined)
+        query.set("limit", String(limit));
+    const value = query.toString();
+    return value ? `?${value}` : "";
+}
+function buildContextAssetSearchBody(options) {
+    const tags = readCsvOption(options.tags);
+    const limit = readPositiveInt(options.limit);
+    return {
+        query: (readOption(options.query) ?? "").trim(),
+        ...(readOption(options.type) ? { type: readOption(options.type) } : {}),
+        ...(readOption(options.status) ? { status: readOption(options.status) } : {}),
+        ...(tags.length > 0 ? { tags } : {}),
+        ...(options.includeArchived ? { include_archived: true } : {}),
+        ...(limit !== undefined ? { limit } : {}),
+    };
+}
+function buildContextAssetUpsertBody(options) {
+    const asset = options.assetJson ? parseJsonObject(options.assetJson) : {};
+    const tags = readCsvOption(options.tags);
+    return {
+        ...asset,
+        ...(readOption(options.id) ? { id: readOption(options.id) } : {}),
+        ...(readOption(options.type) ? { type: readOption(options.type) } : {}),
+        ...(readOption(options.title) ? { title: readOption(options.title) } : {}),
+        ...(readOption(options.status) ? { status: readOption(options.status) } : {}),
+        ...(tags.length > 0 ? { tags } : {}),
+        ...(readOption(options.summary) ? { summary: readOption(options.summary) } : {}),
+        ...(readOption(options.body) ? { body: readOption(options.body) } : {}),
+        ...(options.dataJson ? { data: parseJsonObject(options.dataJson) } : {}),
+        ...(options.default ? { is_default: true } : {}),
+    };
+}
+export function registerContextFamily(program, handleAsyncAction) {
+    program
+        .command("context")
+        .description("Workspace-level GTM context commands.")
+        .addCommand(new Command("resolve")
+        .description("Resolve task-scoped workspace GTM context with readiness and revision provenance.")
+        .option("--purpose <purpose>", "onboarding, general, lead_sourcing, qualification, outbound_copy, or workflow_design.")
+        .option("--asset-type <csv>", "Comma-separated context asset types to include.")
+        .option("--asset-status <status>", "draft, active, archived, or all. Defaults to active.")
+        .option("--tags <csv>", "Comma-separated asset tags that must be present.")
+        .option("--include-archived", "Include archived assets when no asset status is set.")
+        .option("--max-assets <n>", "Maximum assets to include. Defaults to 10, max 50.")
+        .option("--require-ready", "Exit with a conflict error when required context sections are missing.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("context resolve", options, () => requestOxygen("/api/cli/context/resolve", {
+            method: "POST",
+            body: buildContextResolveBody(options),
+        }));
+    }))
+        .addCommand(new Command("profile")
+        .description("Company profile and ICP memory.")
+        .addCommand(new Command("get")
+        .description("Read the current workspace company profile.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("context profile get", options, () => requestOxygen("/api/cli/context/profile"));
+    }))
+        .addCommand(new Command("update")
+        .description("Merge one or more profile sections into workspace GTM memory.")
+        .requiredOption("--data-json <json>", "JSON object with company, offering, icp, market, gtm_stack, or custom sections.")
+        .option("--summary <text>", "Optional concise summary for the profile.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("context profile update", options, () => requestOxygen("/api/cli/context/profile/update", {
+            method: "POST",
+            body: {
+                data: parseJsonObject(options.dataJson ?? "{}"),
+                ...(readOption(options.summary) ? { summary: readOption(options.summary) } : {}),
+            },
+        }));
+    })))
+        .addCommand(new Command("assets")
+        .description("Playbooks, strategies, campaigns, personas, and research notes.")
+        .addCommand(new Command("list")
+        .description("List workspace context assets.")
+        .option("--type <type>", "Filter by playbook, strategy, campaign, positioning, brand, voice, persona, competitor, research_note, message_playbook, or other.")
+        .option("--status <status>", "Filter by draft, active, or archived.")
+        .option("--tags <csv>", "Comma-separated tags that must be present.")
+        .option("--include-archived", "Include archived assets when no status filter is set.")
+        .option("--limit <n>", "Maximum assets to return. Defaults to 100; hard cap is 500.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("context assets list", options, () => requestOxygen(`/api/cli/context/assets${contextAssetsQuery(options)}`));
+    }))
+        .addCommand(new Command("search")
+        .description("Full-text 'second brain' search across context assets, ranked by relevance.")
+        .requiredOption("--query <text>", "Search text. Supports quoted phrases, OR, and -exclude.")
+        .option("--type <type>", "Filter by playbook, strategy, campaign, positioning, brand, voice, persona, competitor, research_note, message_playbook, or other.")
+        .option("--status <status>", "Filter by draft, active, or archived.")
+        .option("--tags <csv>", "Comma-separated tags that must be present.")
+        .option("--include-archived", "Include archived assets when no status filter is set.")
+        .option("--limit <n>", "Maximum assets to return. Defaults to 100; hard cap is 500.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("context assets search", options, () => requestOxygen("/api/cli/context/assets/search", {
+            method: "POST",
+            body: buildContextAssetSearchBody(options),
+        }));
+    }))
+        .addCommand(new Command("get")
+        .description("Read one context asset.")
+        .argument("<asset_id>", "Context asset UUID.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (assetId, options) => {
+        await handleAsyncAction("context asset get", options, () => requestOxygen("/api/cli/context/assets/get", {
+            method: "POST",
+            body: { id: assetId },
+        }));
+    }))
+        .addCommand(new Command("upsert")
+        .description("Create or update a context asset.")
+        .option("--id <asset_id>", "Existing asset UUID to update. Omit to create.")
+        .option("--type <type>", "Asset type (positioning, brand, voice, persona, competitor, message_playbook, playbook, strategy, campaign, research_note, other). Defaults to other on create.")
+        .option("--title <title>", "Asset title. Required on create.")
+        .option("--status <status>", "draft, active, or archived.")
+        .option("--tags <csv>", "Comma-separated asset tags.")
+        .option("--summary <text>", "Short asset summary.")
+        .option("--body <text>", "Asset body text.")
+        .option("--data-json <json>", "Flexible JSON object for structured asset data.")
+        .option("--asset-json <json>", "Full asset JSON object. CLI flags override matching fields.")
+        .option("--default", "Ask to pin as the canonical default for its type (auto-applied to copy generation). For brand, voice, positioning and playbooks the asset saves unpinned and the pin waits for approval of a proposal (pin.ok false; oxygen knowledge proposals approve <id>); other types pin at once.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        await handleAsyncAction("context asset upsert", options, () => requestOxygen("/api/cli/context/assets/upsert", {
+            method: "POST",
+            body: buildContextAssetUpsertBody(options),
+        }));
+    }))
+        .addCommand(new Command("set-default")
+        .description("Pin a context asset as the canonical default for its type. The canonical brand/voice/positioning docs are auto-applied to AI copy generation. For brand, voice, positioning and playbooks a pin or unpin files a proposal a human approves (oxygen knowledge proposals approve <id>) and fails with knowledge_approval_required; other types pin at once.")
+        .argument("<asset_id>", "Context asset UUID.")
+        .option("--off", "Unpin instead of pin (clears the canonical default for this type).")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (assetId, options) => {
+        await handleAsyncAction("context asset set-default", options, () => requestOxygen("/api/cli/context/assets/set-default", {
+            method: "POST",
+            body: { id: assetId, is_default: options.off ? false : true },
+        }));
+    }))
+        .addCommand(new Command("archive")
+        .description("Archive a context asset. Archiving the canonical brand, voice, positioning or playbook files an approval proposal and fails with knowledge_approval_required.")
+        .argument("<asset_id>", "Context asset UUID.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (assetId, options) => {
+        await handleAsyncAction("context asset archive", options, () => requestOxygen("/api/cli/context/assets/archive", {
+            method: "POST",
+            body: { id: assetId },
+        }));
+    })));
+}

package/dist/commands/copilot.d.ts

@@ -0,0 +1,3 @@
+import { ExtractedCommandActionHandler } from "../command-support.js";
+import { Command } from "commander";
+export declare function registerCopilotFamily(program: Command, handleAsyncAction: ExtractedCommandActionHandler): void;