@sage-protocol/cli 0.4.0 → 0.4.2

package/dist/cli/commands/prompt.js

@@ -1,2531 +0,0 @@
-const { Command } = require("commander");
-const PromptManager = require("../prompt-manager");
-const fs = require("fs");
-const path = require("path");
-const IPFSManager = require("../ipfs-manager");
-const { spawn, spawnSync } = require("child_process");
-const LibraryManager = require("../library-manager");
-const { PromptCommerceClient } = require("../services/commerce/prompt-client");
-const { DEFAULT_WORKER_BASE } = require("../services/ipfs/onboarding");
-const { WorkerClient } = require("../services/ipfs/worker-client");
-const { SandboxDiscoveryClient } = require("../services/ipfs/discovery-client");
-const sandboxCache = require("../services/ipfs/sandbox-cache");
-const { copyToClipboard } = require("../utils/clipboard");
-const metapromptDesigner = require("../utils/metaprompt-designer");
-const manifestSelector = require("../utils/manifest-selector");
-const cliConfig = require("../config");
-const os = require("os");
-const { resolveArtifact } = require("../utils/artifacts");
-const promptTestCommand = require("./prompt-test");
-
-const libraryManager = new LibraryManager();
-
-function slugifyKey(value) {
-  return (
-    String(value || "")
-      .toLowerCase()
-      .replace(/[^a-z0-9]+/g, "-")
-      .replace(/^-+|-+$/g, "")
-      .slice(0, 120) || `prompt-${Date.now()}`
-  );
-}
-
-function parseTags(input) {
-  if (!input) return [];
-  if (Array.isArray(input))
-    return input.map((t) => String(t).trim()).filter(Boolean);
-  return String(input)
-    .split(/[,\s]+/)
-    .map((t) => t.trim())
-    .filter(Boolean);
-}
-
-function resolveWorkerSettings(opts = {}) {
-  const ipfsConfig =
-    typeof cliConfig.readIpfsConfig === "function"
-      ? cliConfig.readIpfsConfig() || {}
-      : {};
-  const workerProfile = ipfsConfig.worker || {};
-  const baseUrl =
-    (opts.workerUrl ||
-      process.env.SAGE_IPFS_WORKER_URL ||
-      process.env.SAGE_IPFS_UPLOAD_URL ||
-      workerProfile.baseUrl ||
-      DEFAULT_WORKER_BASE || "")
-      .trim()
-      .replace(/\/$/, "");
-  if (!baseUrl) {
-    throw new Error(
-      "Worker base URL not configured. Run `sage ipfs setup` or set SAGE_IPFS_WORKER_URL.",
-    );
-  }
-  return {
-    baseUrl,
-    token:
-      opts.workerToken ||
-      process.env.SAGE_IPFS_UPLOAD_TOKEN ||
-      workerProfile.token ||
-      "",
-    address:
-      opts.address ||
-      process.env.SAGE_SANDBOX_ADDRESS ||
-      workerProfile.address ||
-      "",
-  };
-}
-
-function getDefaultEditor() {
-  if (process.env.EDITOR && process.env.EDITOR.trim())
-    return process.env.EDITOR.trim();
-  if (process.env.VISUAL && process.env.VISUAL.trim())
-    return process.env.VISUAL.trim();
-  return process.platform === "win32" ? "notepad" : "nano";
-}
-
-function openEditorWithContent(initialContent = "", extension = ".md") {
-  const tmpFile = path.join(
-    os.tmpdir(),
-    `sage-prompt-${Date.now()}${extension}`,
-  );
-  fs.writeFileSync(tmpFile, initialContent, "utf8");
-  const editor = getDefaultEditor();
-  const result = spawnSync(editor, [tmpFile], {
-    stdio: "inherit",
-    shell: process.platform === "win32",
-  });
-  if (result.error) {
-    fs.rmSync(tmpFile, { force: true });
-    throw new Error(
-      `Failed to launch editor '${editor}': ${result.error.message}`,
-    );
-  }
-  const edited = fs.readFileSync(tmpFile, "utf8");
-  fs.rmSync(tmpFile, { force: true });
-  return edited;
-}
-
-function ensureManifestWritable(entry) {
-  if (entry.path && fs.existsSync(entry.path)) {
-    return { manifest: entry.manifest, path: entry.path };
-  }
-  const dir = libraryManager.ensureLibrariesDir();
-  const filename = entry.cid
-    ? `${entry.cid}.json`
-    : `manifest-${Date.now()}.json`;
-  const file = path.join(dir, filename);
-  fs.writeFileSync(file, JSON.stringify(entry.manifest, null, 2));
-  entry.path = file;
-  entry.id = entry.id || `path:${file}`;
-  return { manifest: entry.manifest, path: file };
-}
-
-function writeManifest(manifest, filePath) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  fs.writeFileSync(filePath, JSON.stringify(manifest, null, 2));
-}
-
-function ensurePromptFile(manifestPath, key, content) {
-  const baseDir = path.dirname(manifestPath);
-  const promptsDir = path.join(baseDir, "prompts");
-  fs.mkdirSync(promptsDir, { recursive: true });
-  const filename = `${key}.md`;
-  const outPath = path.join(promptsDir, filename);
-  fs.writeFileSync(outPath, content, "utf8");
-  return { absolute: outPath, relative: path.relative(baseDir, outPath) };
-}
-
-function readStdin() {
-  return new Promise((resolve, reject) => {
-    let data = "";
-    process.stdin.setEncoding("utf8");
-    process.stdin.on("data", (chunk) => {
-      data += chunk;
-    });
-    process.stdin.on("end", () => resolve(data));
-    process.stdin.on("error", (err) => reject(err));
-  });
-}
-
-function archivePrompt(manifestPath, prompt) {
-  const projectDir = cliConfig.getProjectDir
-    ? cliConfig.getProjectDir()
-    : process.cwd();
-  const archiveDir = path.join(projectDir, ".sage", "archives", "prompts");
-  fs.mkdirSync(archiveDir, { recursive: true });
-  const safeKey = slugifyKey(prompt?.key || "prompt");
-  const filename = `${safeKey}-${Date.now()}.json`;
-  const out = path.join(archiveDir, filename);
-  const payload = {
-    removedAt: new Date().toISOString(),
-    manifestPath,
-    prompt,
-  };
-  fs.writeFileSync(out, JSON.stringify(payload, null, 2));
-  return out;
-}
-
-async function resolveManifests({
-  manifest: manifestInput,
-  manifestCid,
-  subdao,
-}) {
-  const candidates = await manifestSelector.gatherManifestCandidates({
-    manifest: manifestInput,
-    manifestCid,
-    subdao,
-  });
-  return candidates
-    .filter((entry) => entry && entry.manifest)
-    .map((entry) => ({
-      manifest: entry.manifest,
-      source: entry.source,
-      path: entry.path || null,
-      cid: entry.cid || null,
-    }));
-}
-
-function findPromptInManifest(manifest, key) {
-  const prompts = Array.isArray(manifest?.prompts) ? manifest.prompts : [];
-  return prompts.find((p) => p.key === key || p.key === `${key}`);
-}
-
-async function locatePrompt(key, options) {
-  const targetKey = options.prompt || key;
-  if (!targetKey) throw new Error("Prompt key required.");
-
-  if (options.promptCid) {
-    const ipfs = new IPFSManager();
-    await ipfs.initialize();
-    const promptJson = await ipfs
-      .downloadJson(options.promptCid)
-      .catch(() => null);
-    if (promptJson && promptJson.content) {
-      return {
-        prompt: {
-          key: targetKey,
-          name: promptJson.name || targetKey,
-          description: promptJson.description || "",
-          tags: promptJson.tags || [],
-          cid: options.promptCid,
-          content: promptJson.content,
-        },
-        manifestMeta: { source: "ipfs", cid: options.promptCid },
-      };
-    }
-    // Fallback to raw text download
-    const tmp = path.join(os.tmpdir(), `sage-prompt-${Date.now()}.txt`);
-    const filePath = await ipfs.downloadPrompt(options.promptCid, tmp);
-    const content = fs.readFileSync(filePath, "utf8");
-    return {
-      prompt: {
-        key: targetKey,
-        name: targetKey,
-        description: "",
-        tags: [],
-        cid: options.promptCid,
-        content,
-      },
-      manifestMeta: { source: "ipfs", cid: options.promptCid },
-    };
-  }
-
-  const manifests = await resolveManifests({
-    manifest: options.manifest,
-    manifestCid: options.manifestCid,
-    subdao: options.subdao,
-  });
-  for (const entry of manifests) {
-    const prompt = findPromptInManifest(entry.manifest, targetKey);
-    if (prompt) {
-      return { prompt, manifestMeta: entry };
-    }
-  }
-
-  throw new Error(`Prompt '${targetKey}' not found in manifest sources.`);
-}
-
-function ensureDirectoryForFile(filePath) {
-  try {
-    fs.mkdirSync(path.dirname(filePath), { recursive: true });
-  } catch (_) {}
-}
-
-function appendToFile(filePath, content) {
-  ensureDirectoryForFile(filePath);
-  fs.appendFileSync(filePath, `${content}\n`, "utf8");
-}
-
-function openExternal(url) {
-  const platform = process.platform;
-  let command;
-  let args;
-  if (platform === "win32") {
-    command = "cmd";
-    args = ["/c", "start", '""', url];
-  } else if (platform === "darwin") {
-    command = "open";
-    args = [url];
-  } else {
-    command = "xdg-open";
-    args = [url];
-  }
-  try {
-    const child = spawn(command, args, { stdio: "ignore", detached: true });
-    child.unref();
-    return { ok: true, command };
-  } catch (error) {
-    return { ok: false, error: error.message };
-  }
-}
-
-function buildTemplate(prompt, manifestMeta) {
-  return {
-    key: prompt.key,
-    name: prompt.name,
-    description: prompt.description,
-    tags: prompt.tags || [],
-    cid: prompt.cid || null,
-    files: prompt.files || [],
-    manifest: {
-      cid: manifestMeta?.cid || null,
-      source: manifestMeta?.source || null,
-      path: manifestMeta?.path || null,
-    },
-    content: prompt.content || null,
-  };
-}
-
-async function resolvePromptContent(prompt, manifestMeta) {
-  if (prompt.content && String(prompt.content).trim()) {
-    return String(prompt.content);
-  }
-
-  if (Array.isArray(prompt.files)) {
-    for (const file of prompt.files) {
-      const candidate = path.isAbsolute(file)
-        ? file
-        : manifestMeta?.path
-          ? path.join(path.dirname(manifestMeta.path), file)
-          : path.join(process.cwd(), file);
-      try {
-        if (fs.existsSync(candidate)) {
-          return fs.readFileSync(candidate, "utf8");
-        }
-      } catch (_) {
-        continue;
-      }
-    }
-  }
-
-  if (prompt.cid) {
-    const ipfs = new IPFSManager();
-    await ipfs.initialize();
-    const json = await ipfs.downloadJson(prompt.cid).catch(() => null);
-    if (json && json.content) {
-      return String(json.content);
-    }
-    try {
-      const tmp = path.join(os.tmpdir(), `sage-prompt-${Date.now()}.txt`);
-      const filePath = await ipfs.downloadPrompt(prompt.cid, tmp);
-      return fs.readFileSync(filePath, "utf8");
-    } catch (_) {}
-  }
-
-  return "";
-}
-
-function register(program) {
-  const promptCommand = new Command("prompt")
-    .description("Prompt management commands")
-    .addCommand(
-      new Command("create")
-        .description(
-          "Generate a new prompt via OpenAI and add it to a manifest",
-        )
-        .option("--from-template", "Skip AI and start from a template", false)
-        .option("--manifest <path>", "Path to manifest.json to update")
-        .option("--manifest-cid <cid>", "Manifest CID to fetch before updating")
-        .option("--subdao <address>", "Filter selection to a SubDAO")
-        .option("--name <name>", "Prompt display name")
-        .option("--key <key>", "Prompt key override")
-        .option("--description <text>", "Prompt description")
-        .option("--tags <tags>", "Comma or space separated tags")
-        .option("--no-tag-prompt", "Do not show interactive tag suggestions", false)
-        .option("--topic <text>", "High-level goal for the prompt")
-        .option("--model <id>", "OpenAI model (default: gpt-4o-mini)")
-        .option("--skip-pin", "Do not upload the prompt to IPFS", false)
-        .action(async (opts) => {
-          try {
-            const inquirer = require("inquirer");
-            const axios = require("axios");
-            const ai = cliConfig.readAIConfig();
-            const apiKey =
-              process.env.OPENAI_API_KEY ||
-              process.env.SAGE_OPENAI_API_KEY ||
-              ai.openaiApiKey;
-            const useTemplate = !!opts.fromTemplate || !apiKey;
-            if (!apiKey && !opts.fromTemplate) {
-              console.log("ℹ️  No OpenAI API key found. Falling back to template flow. Use --from-template to skip AI explicitly.");
-            }
-
-            const manifestEntry =
-              await manifestSelector.selectManifestInteractive({
-                manifest: opts.manifest,
-                manifestCid: opts.manifestCid,
-                subdao: opts.subdao,
-                message: "Select a manifest to update",
-              });
-            const { manifest, path: manifestPath } =
-              ensureManifestWritable(manifestEntry);
-            manifest.prompts = Array.isArray(manifest.prompts)
-              ? manifest.prompts
-              : [];
-
-            const questions = [];
-            if (!opts.topic) {
-              questions.push({
-                name: "topic",
-                message: "What should this prompt help accomplish?",
-                type: "input",
-                validate: (v) => (v.trim() ? true : "Topic is required."),
-              });
-            }
-            if (!opts.name) {
-              questions.push({
-                name: "name",
-                message: "Prompt name",
-                type: "input",
-                default: "New Prompt",
-              });
-            }
-            if (!opts.description) {
-              questions.push({
-                name: "description",
-                message: "Short description (optional)",
-                type: "input",
-                default: "",
-              });
-            }
-            if (!opts.tags) {
-              questions.push({
-                name: "tags",
-                message: "Tags (comma or space separated, optional)",
-                type: "input",
-                default: "",
-              });
-            }
-            const answers = questions.length
-              ? await inquirer.prompt(questions)
-              : {};
-
-            const topic = opts.topic || answers.topic;
-            const name = opts.name || answers.name || "New Prompt";
-            const description = opts.description || answers.description || "";
-            let tags = parseTags(opts.tags || answers.tags || []);
-            const key = slugifyKey(opts.key || name);
-
-            const existingIndex = manifest.prompts.findIndex(
-              (p) => p.key === key,
-            );
-            if (existingIndex !== -1) {
-              const { confirmOverwrite } = await inquirer.prompt([
-                {
-                  type: "confirm",
-                  name: "confirmOverwrite",
-                  message: `Prompt key '${key}' exists. Overwrite?`,
-                  default: false,
-                },
-              ]);
-              if (!confirmOverwrite) {
-                console.log("❌ Aborted by user (prompt key already exists).");
-                return;
-              }
-            }
-
-            let contentCandidate = '';
-            if (useTemplate) {
-              const template = [
-                "You are a helpful, precise assistant.",
-                "- Follow user instructions carefully.",
-                "- Ask for clarification when needed.",
-                "- Avoid revealing chain-of-thought; summarize when explaining.",
-                "",
-                "# Variables",
-                "- {{goal}}: High-level objective",
-                "- {{constraints}}: Any constraints",
-                "",
-                "# Instructions",
-                "1. Clarify the task",
-                "2. Plan briefly",
-                "3. Provide the result",
-              ].join("\n");
-              contentCandidate = template;
-            } else {
-              const systemPrompt =
-                "You are an elite prompt engineer. Generate a production-ready system prompt in Markdown with clear structure, guardrails, variables, and usage guidance. Focus on clarity and practical alignment. Output only the prompt content.";
-              const userPrompt = [
-                `Goal: ${topic}`,
-                description ? `Context: ${description}` : null,
-                tags.length ? `Keywords: ${tags.join(", ")}` : null,
-                "Deliver a single Markdown prompt ready for use.",
-              ]
-                .filter(Boolean)
-                .join("\n");
-
-              const model = opts.model || "gpt-4o-mini";
-              const response = await axios.post(
-                "https://api.openai.com/v1/chat/completions",
-                {
-                  model,
-                  messages: [
-                    { role: "system", content: systemPrompt },
-                    { role: "user", content: userPrompt },
-                  ],
-                  temperature: 0.7,
-                },
-                {
-                  headers: {
-                    Authorization: `Bearer ${apiKey}`,
-                    "Content-Type": "application/json",
-                  },
-                },
-              );
-              contentCandidate = response.data?.choices?.[0]?.message?.content || "";
-              if (!contentCandidate.trim()) {
-                throw new Error("OpenAI response was empty.");
-              }
-            }
-
-            console.log("\n📝 Review and edit the prompt. Save and exit the editor to continue.");
-            const editedContent = openEditorWithContent(
-              String(contentCandidate || '').trim() + "\n",
-            );
-            const finalContent = editedContent.trim();
-            if (!finalContent) {
-              console.log(
-                "⚠️  Prompt content is empty after editing. Aborting.",
-              );
-              return;
-            }
-
-            // Suggest tags (TTY only) if none were provided
-            if (!opts.tags && !opts.noTagPrompt) {
-              const { isTTY } = require('../utils/output-mode');
-              if (isTTY()) {
-                const { suggestTags } = require('../utils/tags');
-                const suggestions = suggestTags({ filename: `${key}.md`, content: finalContent });
-                if (suggestions.length) {
-                  const inquirer = require('inquirer');
-                  const { picked, custom } = await inquirer.prompt([
-                    { type: 'checkbox', name: 'picked', message: 'Select tags (optional)', choices: suggestions.map((t)=>({ name: t, value: t })) },
-                    { type: 'input', name: 'custom', message: 'Add custom tag (optional)', default: '' }
-                  ]);
-                  const extra = (custom || '').split(/[,\s]+/).filter(Boolean);
-                  tags = Array.from(new Set([...(tags||[]), ...picked, ...extra])).slice(0, 10);
-                }
-              }
-            }
-
-            const { absolute, relative } = ensurePromptFile(
-              manifestPath,
-              key,
-              finalContent + "\n",
-            );
-            let cid = null;
-            // Default: when using template fallback, do not pin unless explicitly requested
-            const shouldPin = !opts.skipPin && !useTemplate;
-            if (shouldPin) {
-              const ipfs = new IPFSManager();
-              await ipfs.initialize();
-              cid = await ipfs.uploadPrompt(absolute, name, description);
-            }
-
-            const promptEntry = {
-              key,
-              name,
-              description: description || undefined,
-              tags: tags.length ? tags : undefined,
-              files: [relative],
-            };
-            if (cid) promptEntry.cid = cid;
-
-            if (existingIndex !== -1) {
-              manifest.prompts[existingIndex] = Object.assign(
-                {},
-                manifest.prompts[existingIndex],
-                promptEntry,
-              );
-            } else {
-              manifest.prompts.push(promptEntry);
-            }
-
-            writeManifest(manifest, manifestPath);
-            console.log(`✅ Prompt '${key}' saved to ${manifestPath}`);
-            if (cid) console.log(`🔗 CID: ${cid}`);
-            console.log(`📁 Local file: ${absolute}`);
-          } catch (error) {
-            console.error("❌ prompt create failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      (() => {
-        const sandbox = new Command("sandbox")
-          .description(
-            "Ephemeral sandbox helpers (Sage infrastructure is used by default)",
-          );
-
-        sandbox
-          .command("push")
-          .description(
-            "Push a prompt reference to the sandbox (defaults to Sage managed worker)",
-          )
-          .requiredOption(
-            "--content-ref <ref>",
-            "Reference to prompt content (CID or storage path)",
-          )
-          .option(
-            "--visibility <tier>",
-            "Visibility tier: public, share, or private",
-            "public",
-          )
-          .option(
-            "--expires-in <hours>",
-            "Override expiry window in hours",
-            (value) => Number(value),
-          )
-          .option("--title <text>", "Optional title metadata")
-          .option("--tags <tags>", "Comma or space separated tags")
-          .option("--worker-url <url>", "Custom worker URL (optional)")
-          .option("--worker-token <token>", "Worker bearer token (optional)")
-          .option("--address <address>", "Wallet address for sandbox accounting")
-          .option("--json", "Output JSON", false)
-          .action(async (opts) => {
-            try {
-              const settings = resolveWorkerSettings(opts);
-              const client = new WorkerClient(settings);
-              const visibility = String(opts.visibility || "public").toLowerCase();
-              const payload = {
-                contentRef: opts.contentRef,
-                visibility,
-                title: opts.title,
-                tags: parseTags(opts.tags),
-                expiresInHours: Number.isFinite(opts.expiresIn)
-                  ? Number(opts.expiresIn)
-                  : undefined,
-              };
-              const result = await client.sandboxPush(payload);
-              try {
-                sandboxCache.recordPrompt({
-                  prompt: result.prompt,
-                  contentRef: opts.contentRef,
-                  manifest: opts.contentRef,
-                });
-              } catch (cacheError) {
-                if (process.env.SAGE_DEBUG_DISCOVERY === "1") {
-                  console.warn(
-                    "⚠️  sandbox cache write failed:",
-                    cacheError.message,
-                  );
-                }
-              }
-              if (opts.json || process.env.SAGE_QUIET_JSON) {
-                console.log(JSON.stringify(result, null, 2));
-                return;
-              }
-              console.log(
-                `✅ Sandbox prompt stored (${result.prompt.visibility}) via ${settings.baseUrl}`,
-              );
-              console.log(`   id: ${result.prompt.id}`);
-              console.log(`   expires: ${result.prompt.expiresAt}`);
-              if (result.prompt.shareToken) {
-                console.log(`   share token: ${result.prompt.shareToken}`);
-              }
-              if (result.quota) {
-                console.log(
-                  `   quota: ${result.quota.activeCount} active, ${result.quota.dailyRemaining} remaining today`,
-                );
-              }
-            } catch (error) {
-              console.error(`❌ sandbox push failed: ${error.message}`);
-              process.exit(1);
-            }
-          });
-
-        sandbox
-          .command("list")
-          .description("List sandbox prompts for your configured address")
-          .option("--visibility <tier>", "Filter by visibility tier")
-          .option("--worker-url <url>")
-          .option("--worker-token <token>")
-          .option("--address <address>")
-          .option("--json", "Output JSON", false)
-          .action(async (opts) => {
-            try {
-              const settings = resolveWorkerSettings(opts);
-              const client = new WorkerClient(settings);
-              const body = await client.sandboxList({ visibility: opts.visibility });
-              const prompts = Array.isArray(body.prompts) ? body.prompts : [];
-              if (opts.json || process.env.SAGE_QUIET_JSON) {
-                console.log(JSON.stringify(prompts, null, 2));
-                return;
-              }
-              if (!prompts.length) {
-                console.log("ℹ️  No sandbox prompts found for this address.");
-                return;
-              }
-              console.log(
-                `🔎 Sandbox prompts (${prompts.length}) using ${settings.baseUrl}`,
-              );
-              for (const prompt of prompts) {
-                console.log(
-                  `— ${prompt.id} [${prompt.visibility}] expires ${prompt.expiresAt}`,
-                );
-                if (prompt.shareToken) console.log(`    share token: ${prompt.shareToken}`);
-                if (prompt.title) console.log(`    title: ${prompt.title}`);
-                if (Array.isArray(prompt.tags) && prompt.tags.length)
-                  console.log(`    tags: ${prompt.tags.join(", ")}`);
-              }
-            } catch (error) {
-              console.error(`❌ sandbox list failed: ${error.message}`);
-              process.exit(1);
-            }
-          });
-
-        sandbox
-          .command("share <id>")
-          .description("Rotate a share token for a sandbox prompt (requires ENS)")
-          .option("--worker-url <url>")
-          .option("--worker-token <token>")
-          .option("--address <address>")
-          .option("--json", "Output JSON", false)
-          .action(async (id, opts) => {
-            try {
-              const settings = resolveWorkerSettings(opts);
-              const client = new WorkerClient(settings);
-              const body = await client.sandboxShare(id, {
-                address: settings.address,
-              });
-              if (body?.prompt?.id) {
-                try {
-                  const discovery = new SandboxDiscoveryClient(settings);
-                  await discovery.recordEvent({
-                    promptId: body.prompt.id,
-                    type: 'save',
-                    source: 'cli_share',
-                  });
-                  sandboxCache.recordPrompt({
-                    prompt: body.prompt,
-                    contentRef: body.prompt.contentRef || undefined,
-                  });
-                } catch (error) {
-                  if (process.env.SAGE_DEBUG_DISCOVERY === '1') {
-                    console.warn('⚠️  failed to record discovery save event:', error.message);
-                  }
-                }
-              }
-              if (opts.json || process.env.SAGE_QUIET_JSON) {
-                console.log(JSON.stringify(body, null, 2));
-                return;
-              }
-              console.log(`🔗 Share token: ${body.prompt?.shareToken || "(none)"}`);
-            } catch (error) {
-              console.error(`❌ sandbox share failed: ${error.message}`);
-              process.exit(1);
-            }
-          });
-
-        sandbox
-          .command("status")
-          .description("Show sandbox eligibility (ENS + governance participation)")
-          .option("--worker-url <url>")
-          .option("--worker-token <token>")
-          .option("--address <address>")
-          .option("--json", "Output JSON", false)
-          .action(async (opts) => {
-            try {
-              const settings = resolveWorkerSettings(opts);
-              const address = (opts.address || settings.address || '').trim();
-              if (!address) throw new Error('address required (set --address or configure profile/env)');
-              const discovery = new SandboxDiscoveryClient(settings);
-              const participation = await discovery.participation(address);
-              const payload = {
-                address,
-                ensVerified: Boolean(participation.ensVerified),
-                ensName: participation.ensName || null,
-                stakeThresholdMet: Boolean(participation.stakeThresholdMet),
-                actions30d: Number(participation.actions30d || 0),
-                allowed: Boolean(participation.allowed),
-                reason: participation.reason || null,
-              };
-              if (opts.json || process.env.SAGE_QUIET_JSON) {
-                console.log(JSON.stringify(payload, null, 2));
-                return;
-              }
-              console.log(`📮 Sandbox eligibility for ${address}`);
-              console.log(`   ENS verified : ${payload.ensVerified ? '✅ yes' : '❌ no'}`);
-              if (payload.ensName) console.log(`     ↳ ENS name : ${payload.ensName}`);
-              console.log(`   Stake met    : ${payload.stakeThresholdMet ? '✅ yes' : '❌ no'}`);
-              console.log(`   Actions (30d): ${payload.actions30d}`);
-              console.log(
-                `   Access result : ${payload.allowed ? '✅ allowed' : '🚫 blocked'}${payload.reason ? ` (${payload.reason})` : ''}`,
-              );
-            } catch (error) {
-              console.error(`❌ sandbox status failed: ${error.message}`);
-              process.exit(1);
-            }
-          });
-
-        sandbox
-          .command("discover")
-          .description("Show sandbox discovery feed (trending by default)")
-          .option("--filter <name>", "Filter: trending, fresh, needs-review", "trending")
-          .option("--limit <number>", "Maximum prompts to display", (value) => Number(value))
-          .option("--worker-url <url>")
-          .option("--worker-token <token>")
-          .option("--json", "Output JSON", false)
-          .action(async (opts) => {
-            try {
-              const settings = resolveWorkerSettings(opts);
-              const discovery = new SandboxDiscoveryClient(settings);
-              const body = await discovery.discover({
-                filter: opts.filter,
-                limit: Number.isFinite(opts.limit) ? Number(opts.limit) : undefined,
-              });
-              const prompts = Array.isArray(body.prompts) ? body.prompts : [];
-              if (opts.json || process.env.SAGE_QUIET_JSON) {
-                console.log(JSON.stringify(body, null, 2));
-                return;
-              }
-              if (!prompts.length) {
-                console.log(
-                  "ℹ️  Discovery feed empty (publish public prompts to populate this view).",
-                );
-                return;
-              }
-              if (!opts.json && !process.env.SAGE_QUIET_JSON) {
-                const discovery = new SandboxDiscoveryClient(settings);
-                await Promise.allSettled(
-                  prompts.map((prompt) =>
-                    discovery.recordEvent({
-                      promptId: prompt.id,
-                      type: 'view',
-                      source: 'cli_discover',
-                    }),
-                  ),
-                );
-              }
-              console.log(
-                `🔥 ${body.filter || "trending"} prompts (${prompts.length}) via ${settings.baseUrl}`,
-              );
-              for (const prompt of prompts) {
-                console.log(
-                  `— ${prompt.id} by ${prompt.ensName || prompt.owner || "unknown"} [${prompt.visibility}] created ${prompt.createdAt}`,
-                );
-                if (prompt.title) console.log(`    title: ${prompt.title}`);
-                if (Array.isArray(prompt.tags) && prompt.tags.length)
-                  console.log(`    tags: ${prompt.tags.join(", ")}`);
-              }
-            } catch (error) {
-              console.error(`❌ sandbox discover failed: ${error.message}`);
-              process.exit(1);
-            }
-          });
-
-        sandbox
-          .command("report <id>")
-          .description("Submit a governance report/flag for a sandbox prompt")
-          .option("--reason <text>", "Short reason code, e.g. policy, abuse")
-          .option("--note <text>", "Optional additional context (stored off-chain)")
-          .option("--weight <number>", "Relative severity weight (default 1)")
-          .option("--worker-url <url>")
-          .option("--worker-token <token>")
-          .option("--address <address>")
-          .option("--json", "Output JSON response", false)
-          .action(async (id, opts) => {
-            try {
-              const settings = resolveWorkerSettings(opts);
-              const client = new WorkerClient(settings);
-              const response = await client.submitGovernanceReport({
-                promptId: id,
-                reason: opts.reason,
-                note: opts.note,
-                weight: opts.weight,
-                address: opts.address || settings.address,
-              });
-              if (opts.json || process.env.SAGE_QUIET_JSON) {
-                console.log(JSON.stringify(response, null, 2));
-                return;
-              }
-              if (response?.throttled) {
-                console.log("⚠️  Report received recently; throttled duplicate within cooldown window.");
-              } else {
-                console.log("✅ Governance report submitted for review.");
-              }
-            } catch (error) {
-              console.error(`❌ sandbox report failed: ${error.message}`);
-              process.exit(1);
-            }
-          });
-
-        const reports = new Command("reports")
-          .description("Review sandbox governance reports");
-
-        reports
-          .command("list")
-          .description("List sandbox governance reports")
-          .option("--status <status>", "Status filter", "open")
-          .option("--limit <number>", "Maximum reports to fetch", (value) => Number(value), 25)
-          .option("--cursor <number>", "Cursor for pagination", (value) => Number(value))
-          .option("--worker-url <url>")
-          .option("--worker-token <token>")
-          .option("--json", "Output JSON response", false)
-          .action(async (opts) => {
-            try {
-              const settings = resolveWorkerSettings(opts);
-              const client = new WorkerClient(settings);
-              const response = await client.listGovernanceReports({
-                status: opts.status,
-                limit: opts.limit,
-                cursor: opts.cursor,
-              });
-              if (opts.json || process.env.SAGE_QUIET_JSON) {
-                console.log(JSON.stringify(response, null, 2));
-                return;
-              }
-              const reports = Array.isArray(response.reports) ? response.reports : [];
-              if (!reports.length) {
-                console.log("ℹ️  No reports found for the selected filters.");
-                return;
-              }
-              console.log(`🛡️  ${reports.length} ${response.status} report(s)`);
-              for (const report of reports) {
-                console.log(
-                  `• ${report.id} prompt=${report.promptId} actor=${report.actor} status=${report.status} weight=${report.weight} received=${report.receivedAt}`,
-                );
-                if (report.reason) console.log(`    reason: ${report.reason}`);
-                if (report.note) console.log(`    note: ${report.note}`);
-              }
-              if (response.cursor !== null && response.cursor !== undefined) {
-                console.log(`→ more available (cursor=${response.cursor})`);
-              }
-            } catch (error) {
-              console.error(`❌ sandbox reports list failed: ${error.message}`);
-              process.exit(1);
-            }
-          });
-
-        reports
-          .command("review <id>")
-          .description("Resolve or quarantine a sandbox governance report")
-          .requiredOption("--status <status>", "Resolution status (resolved|quarantined|rejected)")
-          .option("--note <text>", "Resolution note")
-          .option("--action <text>", "Optional action tag (e.g., hide, warn)")
-          .option("--worker-url <url>")
-          .option("--worker-token <token>")
-          .option("--json", "Output JSON response", false)
-          .action(async (id, opts) => {
-            try {
-              const settings = resolveWorkerSettings(opts);
-              const client = new WorkerClient(settings);
-              const response = await client.reviewGovernanceReport({
-                id,
-                status: opts.status,
-                note: opts.note,
-                action: opts.action,
-              });
-              if (opts.json || process.env.SAGE_QUIET_JSON) {
-                console.log(JSON.stringify(response, null, 2));
-                return;
-              }
-              console.log(
-                `✅ report ${response.report.id} marked ${response.report.status}; unresolved=${response.summary.open}`,
-              );
-            } catch (error) {
-              console.error(`❌ sandbox reports review failed: ${error.message}`);
-              process.exit(1);
-            }
-          });
-
-        sandbox.addCommand(reports);
-
-        return sandbox;
-      })(),
-    )
-    .addCommand(
-      new Command("sell")
-        .description("Register or update an off-chain prompt listing")
-        .requiredOption("--prompt-id <id>", "Listing identifier")
-        .requiredOption("--cid <cid>", "Prompt CID for gated content")
-        .requiredOption("--price-usd <number>", "Price in USD")
-        .option("--title <text>", "Listing title")
-        .option("--description <text>", "Listing description")
-        .option(
-          "--worker-url <url>",
-          "Worker base URL",
-          process.env.SAGE_IPFS_WORKER_URL ||
-            process.env.SAGE_IPFS_UPLOAD_URL ||
-            DEFAULT_WORKER_BASE,
-        )
-        .option(
-          "--worker-token <token>",
-          "Worker bearer token (optional)",
-          process.env.SAGE_IPFS_UPLOAD_TOKEN,
-        )
-        .option(
-          "--worker-address <address>",
-          "Listing address when using bearer token",
-          process.env.SAGE_PAY_TO_PIN_ADDRESS,
-        )
-        .action(async (opts) => {
-          try {
-            const price = Number(opts.priceUsd);
-            if (!Number.isFinite(price) || price <= 0)
-              throw new Error("price-usd must be positive");
-            const baseUrl = (opts.workerUrl || "").trim();
-            if (!baseUrl) throw new Error("worker-url required");
-            const client = new PromptCommerceClient({
-              baseUrl,
-              token: opts.workerToken,
-              address: opts.workerAddress,
-            });
-            const listing = await client.createListing({
-              promptId: opts.promptId,
-              cid: opts.cid,
-              priceUsd: price,
-              title: opts.title,
-              description: opts.description,
-              seller: opts.workerAddress,
-            });
-            console.log("✅ Prompt listing updated");
-            console.log(JSON.stringify(listing, null, 2));
-          } catch (error) {
-            console.error("❌ prompt sell failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("buy")
-        .description("Initiate checkout for an off-chain prompt listing")
-        .requiredOption("--prompt-id <id>", "Listing identifier")
-        .option(
-          "--worker-url <url>",
-          "Worker base URL",
-          process.env.SAGE_IPFS_WORKER_URL ||
-            process.env.SAGE_IPFS_UPLOAD_URL ||
-            DEFAULT_WORKER_BASE,
-        )
-        .option(
-          "--worker-token <token>",
-          "Worker bearer token (optional)",
-          process.env.SAGE_IPFS_UPLOAD_TOKEN,
-        )
-        .option(
-          "--worker-address <address>",
-          "Buyer address when using bearer token",
-          process.env.SAGE_PAY_TO_PIN_ADDRESS,
-        )
-        .option("--json", "Print raw JSON output", false)
-        .action(async (opts) => {
-          try {
-            const baseUrl = (opts.workerUrl || "").trim();
-            if (!baseUrl) throw new Error("worker-url required");
-            const client = new PromptCommerceClient({
-              baseUrl,
-              token: opts.workerToken,
-              address: opts.workerAddress,
-            });
-            const listing = await client.getListing(opts.promptId);
-            if (!listing) {
-              console.error("❌ Listing not found");
-              process.exit(1);
-            }
-            const session = await client.initiateCheckout(opts.promptId);
-            if (opts.json || process.env.SAGE_QUIET_JSON) {
-              console.log(JSON.stringify({ listing, session }, null, 2));
-            } else {
-              console.log(
-                `🛒 Listing: ${listing.title || opts.promptId} (${listing.priceUsd} USD)`,
-              );
-              console.log(`📦 Prompt CID: ${listing.cid}`);
-              console.log(`✅ Buyer: ${session.buyer}`);
-              if (session.checkoutUrl) {
-                console.log(`🔗 Checkout URL:\n${session.checkoutUrl}`);
-              }
-            }
-          } catch (error) {
-            console.error("❌ prompt buy failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("entitlements")
-        .description("Check prompt entitlements after purchase")
-        .requiredOption("--prompt-id <id>", "Listing identifier")
-        .option(
-          "--worker-url <url>",
-          "Worker base URL",
-          process.env.SAGE_IPFS_WORKER_URL ||
-            process.env.SAGE_IPFS_UPLOAD_URL ||
-            DEFAULT_WORKER_BASE,
-        )
-        .option(
-          "--worker-token <token>",
-          "Worker bearer token (optional)",
-          process.env.SAGE_IPFS_UPLOAD_TOKEN,
-        )
-        .option(
-          "--worker-address <address>",
-          "Buyer address when using bearer token",
-          process.env.SAGE_PAY_TO_PIN_ADDRESS,
-        )
-        .option("--json", "Print raw JSON output", false)
-        .action(async (opts) => {
-          try {
-            const baseUrl = (opts.workerUrl || "").trim();
-            if (!baseUrl) throw new Error("worker-url required");
-            const client = new PromptCommerceClient({
-              baseUrl,
-              token: opts.workerToken,
-              address: opts.workerAddress,
-            });
-            const entitlement = await client.getEntitlement(opts.promptId);
-            if (!entitlement) {
-              console.error(
-                "ℹ️  Entitlement not found (purchase may still be pending).",
-              );
-              process.exit(2);
-            }
-            if (opts.json || process.env.SAGE_QUIET_JSON) {
-              console.log(JSON.stringify(entitlement, null, 2));
-            } else {
-              console.log("🎟️  Entitlement granted");
-              console.log(JSON.stringify(entitlement, null, 2));
-            }
-          } catch (error) {
-            console.error("❌ prompt entitlements failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("add")
-        .description(
-          "Add an existing or manually authored prompt to a manifest",
-        )
-        .option("--manifest <path>", "Path to manifest.json to update")
-        .option("--manifest-cid <cid>", "Manifest CID to fetch before updating")
-        .option("--subdao <address>", "Filter selection to a SubDAO")
-        .option("--file <path>", "Use prompt content from a file")
-        .option("--stdin", "Read prompt content from STDIN", false)
-        .option("--name <name>", "Prompt display name")
-        .option("--key <key>", "Prompt key override")
-        .option("--description <text>", "Prompt description")
-        .option("--tags <tags>", "Comma or space separated tags")
-        .option("--no-pin", "Skip uploading the prompt to IPFS")
-        .action(async (opts) => {
-          try {
-            const inquirer = require("inquirer");
-            const manifestEntry =
-              await manifestSelector.selectManifestInteractive({
-                manifest: opts.manifest,
-                manifestCid: opts.manifestCid,
-                subdao: opts.subdao,
-                message: "Select a manifest to update",
-              });
-            const { manifest, path: manifestPath } =
-              ensureManifestWritable(manifestEntry);
-            manifest.prompts = Array.isArray(manifest.prompts)
-              ? manifest.prompts
-              : [];
-
-            let content = "";
-            let absoluteFile = null;
-            if (opts.file) {
-              const candidate = path.isAbsolute(opts.file)
-                ? opts.file
-                : path.join(process.cwd(), opts.file);
-              if (!fs.existsSync(candidate)) {
-                throw new Error(`Prompt file not found: ${candidate}`);
-              }
-              absoluteFile = candidate;
-              content = fs.readFileSync(candidate, "utf8");
-            } else if (opts.stdin) {
-              if (process.stdin.isTTY) {
-                console.log("⌨️  Waiting for STDIN (Ctrl+D to finish)...");
-              }
-              content = await readStdin();
-            } else {
-              console.log(
-                "\n📝 Provide prompt content via editor. Save and exit to continue.",
-              );
-              content = openEditorWithContent("");
-            }
-
-            const trimmedContent = String(content || "").trim();
-            if (!trimmedContent) {
-              console.log("⚠️  Prompt content is empty. Aborting.");
-              return;
-            }
-
-            const questions = [];
-            if (!opts.name) {
-              const defaultName = absoluteFile
-                ? path.basename(absoluteFile, path.extname(absoluteFile))
-                : "New Prompt";
-              questions.push({
-                name: "name",
-                message: "Prompt name",
-                type: "input",
-                default: defaultName,
-              });
-            }
-            if (!opts.description) {
-              questions.push({
-                name: "description",
-                message: "Short description (optional)",
-                type: "input",
-                default: "",
-              });
-            }
-            if (!opts.tags) {
-              questions.push({
-                name: "tags",
-                message: "Tags (comma or space separated, optional)",
-                type: "input",
-                default: "",
-              });
-            }
-            const answers = questions.length
-              ? await inquirer.prompt(questions)
-              : {};
-
-            const name = opts.name || answers.name || "New Prompt";
-            const description = opts.description || answers.description || "";
-            const tags = parseTags(opts.tags || answers.tags || []);
-            const key = slugifyKey(opts.key || name);
-
-            const existingIndex = manifest.prompts.findIndex(
-              (p) => p.key === key,
-            );
-            if (existingIndex !== -1) {
-              const { confirmOverwrite } = await inquirer.prompt([
-                {
-                  type: "confirm",
-                  name: "confirmOverwrite",
-                  message: `Prompt key '${key}' exists. Overwrite?`,
-                  default: false,
-                },
-              ]);
-              if (!confirmOverwrite) {
-                console.log("❌ Aborted by user (prompt key already exists).");
-                return;
-              }
-            }
-
-            let relativePath;
-            if (absoluteFile) {
-              relativePath = path.relative(
-                path.dirname(manifestPath),
-                absoluteFile,
-              );
-            } else {
-              const fileResult = ensurePromptFile(
-                manifestPath,
-                key,
-                trimmedContent + "\n",
-              );
-              absoluteFile = fileResult.absolute;
-              relativePath = fileResult.relative;
-            }
-
-            let cid = null;
-            if (!opts.noPin) {
-              const ipfs = new IPFSManager();
-              await ipfs.initialize();
-              cid = await ipfs.uploadPrompt(absoluteFile, name, description);
-            }
-
-            const promptEntry = {
-              key,
-              name,
-              description: description || undefined,
-              tags: tags.length ? tags : undefined,
-              files: [relativePath],
-            };
-            if (cid) promptEntry.cid = cid;
-
-            if (existingIndex !== -1) {
-              manifest.prompts[existingIndex] = Object.assign(
-                {},
-                manifest.prompts[existingIndex],
-                promptEntry,
-              );
-            } else {
-              manifest.prompts.push(promptEntry);
-            }
-
-            writeManifest(manifest, manifestPath);
-            console.log(`✅ Prompt '${key}' saved to ${manifestPath}`);
-            if (cid) console.log(`🔗 CID: ${cid}`);
-            console.log(`📁 Local file: ${absoluteFile}`);
-          } catch (error) {
-            console.error("❌ prompt add failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("delete")
-        .description("Remove a prompt entry from a manifest")
-        .argument("<key>", "Prompt key to delete")
-        .option("--manifest <path>", "Path to manifest.json to update")
-        .option("--manifest-cid <cid>", "Manifest CID to fetch before updating")
-        .option("--subdao <address>", "Filter selection to a SubDAO")
-        .option(
-          "--archive",
-          "Archive removed prompt to .sage/archives/prompts",
-          false,
-        )
-        .option("-y, --yes", "Skip confirmation prompt")
-        .action(async (key, opts) => {
-          try {
-            const inquirer = require("inquirer");
-            const manifestEntry =
-              await manifestSelector.selectManifestInteractive({
-                manifest: opts.manifest,
-                manifestCid: opts.manifestCid,
-                subdao: opts.subdao,
-                message: "Select a manifest to modify",
-              });
-            const { manifest, path: manifestPath } =
-              ensureManifestWritable(manifestEntry);
-            manifest.prompts = Array.isArray(manifest.prompts)
-              ? manifest.prompts
-              : [];
-            const idx = manifest.prompts.findIndex((p) => p.key === key);
-            if (idx === -1) {
-              throw new Error(`Prompt '${key}' not found in manifest.`);
-            }
-
-            if (!opts.yes) {
-              const { confirm } = await inquirer.prompt([
-                {
-                  type: "confirm",
-                  name: "confirm",
-                  message: `Remove prompt '${key}' from manifest?`,
-                  default: false,
-                },
-              ]);
-              if (!confirm) {
-                console.log("❌ Aborted by user.");
-                return;
-              }
-            }
-
-            const [removed] = manifest.prompts.splice(idx, 1);
-            writeManifest(manifest, manifestPath);
-            console.log(`✅ Removed prompt '${key}' from ${manifestPath}`);
-
-            if (opts.archive) {
-              const archivePath = archivePrompt(manifestPath, removed);
-              console.log(`🗄️  Archived entry at ${archivePath}`);
-            }
-          } catch (error) {
-            console.error("❌ prompt delete failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("batch-upload")
-        .description(
-          "Upload all .md prompts in a directory and add to a manifest",
-        )
-        .requiredOption("--dir <path>", "Directory containing prompt files")
-        .requiredOption("--manifest <path>", "Path to manifest.json to update")
-        .action(async (opts) => {
-          try {
-            const root = path.isAbsolute(opts.dir)
-              ? opts.dir
-              : path.join(process.cwd(), opts.dir);
-            const mf = path.isAbsolute(opts.manifest)
-              ? opts.manifest
-              : path.join(process.cwd(), opts.manifest);
-            if (!fs.existsSync(root))
-              throw new Error(`Directory not found: ${root}`);
-            if (!fs.existsSync(mf))
-              throw new Error(`Manifest not found: ${mf}`);
-            const walk = (dir) =>
-              fs.readdirSync(dir).flatMap((f) => {
-                const p = path.join(dir, f);
-                const st = fs.statSync(p);
-                if (st.isDirectory()) return walk(p);
-                return [p];
-              });
-            const files = walk(root).filter((p) => p.endsWith(".md"));
-            if (!files.length) throw new Error("No .md files found");
-            const ipfs = new IPFSManager();
-            await ipfs.initialize();
-            const raw = fs.readFileSync(mf, "utf8");
-            const manifest = JSON.parse(raw);
-            manifest.prompts = Array.isArray(manifest.prompts)
-              ? manifest.prompts
-              : [];
-            const taken = new Set(manifest.prompts.map((p) => p.key));
-            let added = 0;
-            for (const f of files) {
-              const key = path.basename(f, path.extname(f));
-              if (taken.has(key)) continue;
-              const name = key.replace(/[-_]/g, " ");
-              const cid = await ipfs.uploadPrompt(f, name, "Batch upload");
-              const rel = path.relative(path.dirname(mf), f);
-              manifest.prompts.push({ key, name, files: [rel], cid });
-              taken.add(key);
-              added += 1;
-            }
-            fs.writeFileSync(mf, JSON.stringify(manifest, null, 2));
-            console.log(`✅ Uploaded ${added} prompts and updated ${mf}`);
-          } catch (e) {
-            console.error("❌ batch-upload failed:", e.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("list")
-        .description("List prompts from a manifest, CID, or pinned libraries")
-        .option("--manifest <path>", "Manifest JSON to read from")
-        .option("--manifest-cid <cid>", "Manifest CID to fetch from IPFS")
-        .option(
-          "--subdao <address>",
-          "Filter pinned manifests by SubDAO address",
-        )
-        .option("--json", "Emit JSON output", false)
-        .action(async (opts) => {
-          try {
-            const manifests = await resolveManifests({
-              manifest: opts.manifest,
-              manifestCid: opts.manifestCid,
-              subdao: opts.subdao,
-            });
-            if (!manifests.length) {
-              console.log(
-                "⚠️  No manifests discovered. Pin a library or supply --manifest/--cid.",
-              );
-              return;
-            }
-            const rows = manifests.map((entry) => {
-              const prompts = Array.isArray(entry.manifest?.prompts)
-                ? entry.manifest.prompts
-                : [];
-              return {
-                library: entry.manifest?.library?.name || "(unnamed library)",
-                description: entry.manifest?.library?.description || "",
-                cid: entry.cid || null,
-                path: entry.path || null,
-                promptCount: prompts.length,
-                prompts: prompts.map((p) => ({
-                  key: p.key,
-                  name: p.name,
-                  description: p.description || "",
-                })),
-              };
-            });
-            if (opts.json) {
-              console.log(JSON.stringify({ manifests: rows }, null, 2));
-              return;
-            }
-            rows.forEach((row, index) => {
-              console.log(`${index + 1}. 📚 ${row.library}`);
-              if (row.description) console.log(`   📄 ${row.description}`);
-              if (row.cid) console.log(`   🔗 CID: ${row.cid}`);
-              if (row.path) console.log(`   📁 ${row.path}`);
-              console.log(`   📝 Prompts (${row.promptCount}):`);
-              row.prompts.forEach((p, i) => {
-                console.log(
-                  `      ${i + 1}. ${p.key} — ${p.name || "Untitled"}`,
-                );
-              });
-              console.log("");
-            });
-          } catch (error) {
-            console.error("❌ prompt list failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("info")
-        .description("Show metadata for a specific prompt key")
-        .argument("<key>", "Prompt key to inspect")
-        .option(
-          "--prompt <key>",
-          "Override prompt key when argument is omitted or ambiguous",
-        )
-        .option("--manifest <path>", "Manifest JSON to read from")
-        .option("--manifest-cid <cid>", "Manifest CID to fetch from IPFS")
-        .option(
-          "--prompt-cid <cid>",
-          "Direct prompt CID (skips manifest lookup)",
-        )
-        .option(
-          "--subdao <address>",
-          "Filter pinned manifests by SubDAO address",
-        )
-        .option("--json", "Emit JSON output", false)
-        .action(async (key, opts) => {
-          try {
-            const { prompt, manifestMeta } = await locatePrompt(key, {
-              prompt: opts.prompt,
-              manifest: opts.manifest,
-              manifestCid: opts.manifestCid,
-              subdao: opts.subdao,
-              promptCid: opts.promptCid,
-            });
-            const template = buildTemplate(prompt, manifestMeta);
-            if (opts.json) {
-              console.log(JSON.stringify(template, null, 2));
-              return;
-            }
-            console.log(`🔑 Key: ${template.key}`);
-            console.log(`📛 Name: ${template.name || "Untitled"}`);
-            console.log(`📄 Description: ${template.description || "None"}`);
-            console.log(
-              `🔖 Tags: ${template.tags.length ? template.tags.join(", ") : "None"}`,
-            );
-            if (template.cid) console.log(`🔗 Prompt CID: ${template.cid}`);
-            if (template.files?.length)
-              console.log(`📂 Files: ${template.files.join(", ")}`);
-            if (template.manifest?.cid)
-              console.log(`🗂️ Manifest CID: ${template.manifest.cid}`);
-            if (template.manifest?.path)
-              console.log(`📁 Manifest Path: ${template.manifest.path}`);
-          } catch (error) {
-            console.error("❌ prompt info failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("use")
-        .description("Print a prompt from manifests, pinned libraries, or IPFS")
-        .argument("<key>", "Prompt key to use")
-        .option(
-          "--prompt <key>",
-          "Override prompt key when argument contains shell-sensitive characters",
-        )
-        .option("--manifest <path>", "Manifest JSON to read from")
-        .option("--manifest-cid <cid>", "Manifest CID to fetch from IPFS")
-        .option(
-          "--prompt-cid <cid>",
-          "Direct prompt CID (skips manifest lookup)",
-        )
-        .option(
-          "--subdao <address>",
-          "Filter pinned manifests by SubDAO address",
-        )
-        .option("--copy", "Copy prompt content to clipboard", false)
-        .option("--file <path>", "Append prompt content to a file")
-        .option("--chatgpt", "Open prompt in ChatGPT", false)
-        .option("--claude", "Open prompt in Claude (best-effort)", false)
-        .option("--template", "Output JSON template alongside text", false)
-        .option(
-          "--quiet",
-          "Suppress raw prompt output (useful with --template)",
-          false,
-        )
-        .action(async (key, opts) => {
-          try {
-            const { prompt, manifestMeta } = await locatePrompt(key, {
-              prompt: opts.prompt,
-              manifest: opts.manifest,
-              cid: opts.cid,
-              subdao: opts.subdao,
-              promptCid: opts.promptCid,
-            });
-            prompt.content = await resolvePromptContent(prompt, manifestMeta);
-            if (!prompt.content) {
-              throw new Error(
-                "Prompt content unavailable. Provide --prompt-cid or ensure local files are reachable.",
-              );
-            }
-
-            if (!opts.quiet) {
-              const headerLines = [];
-              if (prompt.name) headerLines.push(`🧠 ${prompt.name}`);
-              if (prompt.description)
-                headerLines.push(`📄 ${prompt.description}`);
-              if (prompt.tags?.length)
-                headerLines.push(`🔖 Tags: ${prompt.tags.join(", ")}`);
-              if (manifestMeta?.cid)
-                headerLines.push(`🗂️ Manifest CID: ${manifestMeta.cid}`);
-              if (manifestMeta?.path)
-                headerLines.push(`📁 Source: ${manifestMeta.path}`);
-              console.log(headerLines.join("\n"));
-              if (headerLines.length) console.log("");
-              console.log(prompt.content);
-            }
-
-            if (opts.template) {
-              const template = buildTemplate(prompt, manifestMeta);
-              template.content = prompt.content;
-              console.log("\n" + JSON.stringify(template, null, 2));
-            }
-
-            if (opts.copy) {
-              const copied = copyToClipboard(prompt.content);
-              if (copied.ok) {
-                console.log(`📋 Copied to clipboard using ${copied.command}`);
-              } else {
-                console.log(`⚠️  Clipboard copy failed: ${copied.reason}`);
-              }
-            }
-
-            if (opts.file) {
-              appendToFile(opts.file, prompt.content);
-              console.log(`📝 Appended prompt to ${opts.file}`);
-            }
-
-            if (opts.chatgpt) {
-              const link = metapromptDesigner.generateChatGPTLink(
-                prompt.content,
-              );
-              if (link) {
-                const opened = openExternal(link);
-                if (opened.ok) {
-                  console.log(
-                    `🌐 Opened ChatGPT with generated link (${link}).`,
-                  );
-                } else {
-                  console.log(
-                    `⚠️  Failed to open ChatGPT automatically: ${opened.error || "unknown error"}. Link: ${link}`,
-                  );
-                }
-              } else {
-                console.log(
-                  "ℹ️  Prompt too long to generate a ChatGPT launch link. Copy the prompt manually.",
-                );
-              }
-            }
-
-            if (opts.claude) {
-              const link = `https://claude.ai/new?initialText=${encodeURIComponent(prompt.content)}`;
-              const opened = openExternal(link);
-              if (opened.ok) {
-                console.log(`🌐 Opened Claude with generated link (${link}).`);
-              } else {
-                console.log(
-                  `⚠️  Failed to open Claude automatically: ${opened.error}. Link: ${link}`,
-                );
-              }
-            }
-          } catch (error) {
-            console.error("❌ prompt use failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("set-rake")
-        .description(
-          "Admin: set protocol rake for PremiumPrompts (max 10% = 1000 bps)",
-        )
-        .requiredOption("--bps <bps>", "Basis points (0-1000)")
-        .requiredOption("--treasury <address>", "Protocol treasury address")
-        .option(
-          "--prompts <address>",
-          "PremiumPrompts contract (defaults to PREMIUM_PROMPTS_ADDRESS)",
-        )
-        .action(async (opts) => {
-          try {
-            const WM = require("@sage-protocol/wallet-manager");
-            const { ethers } = require("ethers");
-            const wm = new WM();
-            await wm.connect();
-            const signer = wm.getSigner();
-            const promAddr =
-              opts.prompts || process.env.PREMIUM_PROMPTS_ADDRESS;
-            if (!promAddr) throw new Error("Missing PREMIUM_PROMPTS_ADDRESS");
-            const bps = Number(opts.bps);
-            if (!Number.isFinite(bps) || bps < 0 || bps > 1000)
-              throw new Error("bps must be 0-1000");
-            const iface = new ethers.Interface([
-              "function setProtocolRake(uint96,address)",
-            ]);
-            const tx = await signer.sendTransaction({
-              to: promAddr,
-              data: iface.encodeFunctionData("setProtocolRake", [
-                bps,
-                opts.treasury,
-              ]),
-            });
-            console.log("tx:", tx.hash);
-          } catch (e) {
-            console.error("❌ set-rake failed:", e.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("generate")
-        .description("Generate a new prompt file using an LLM")
-        .requiredOption("--topic <text>", "What the prompt should be for")
-        .option("--out <file>", "Output path", "prompts/generated-prompt.md")
-        .option("--provider <name>", "openai|anthropic (auto-detect by key)")
-        .option(
-          "--model <id>",
-          "Model id (default: gpt-4o-mini or claude-3.5-sonnet)",
-        )
-        .option(
-          "--key <value>",
-          "API key override (env/config used if omitted)",
-        )
-        .option(
-          "--manifest <path>",
-          "If set, add the new file to this manifest and upload to IPFS",
-        )
-        .action(async (opts) => {
-          try {
-            const fs = require("fs");
-            const path = require("path");
-            const axios = require("axios");
-            const cliConfig = require("../config");
-            const ai = cliConfig.readAIConfig();
-            const provider =
-              opts.provider ||
-              (opts.key
-                ? "openai"
-                : ai.openaiApiKey
-                  ? "openai"
-                  : ai.anthropicApiKey
-                    ? "anthropic"
-                    : null);
-            if (!provider)
-              throw new Error(
-                "No API key. Use: sage config ai set --provider openai --key sk-...",
-              );
-            const isOpenAI = provider === "openai";
-            const apiKey =
-              opts.key || (isOpenAI ? ai.openaiApiKey : ai.anthropicApiKey);
-            if (!apiKey) throw new Error(`${provider} API key not configured`);
-
-            const sys =
-              "You are an expert prompt engineer. Generate a robust, reusable system prompt. Include: goals, role, constraints, style, variables, and example instructions. Output as Markdown.";
-            const user = `Topic: ${opts.topic}`;
-
-            let content;
-            if (isOpenAI) {
-              const model = opts.model || "gpt-4o-mini";
-              const resp = await axios.post(
-                "https://api.openai.com/v1/chat/completions",
-                {
-                  model,
-                  messages: [
-                    { role: "system", content: sys },
-                    { role: "user", content: user },
-                  ],
-                  temperature: 0.7,
-                },
-                {
-                  headers: {
-                    Authorization: `Bearer ${apiKey}`,
-                    "Content-Type": "application/json",
-                  },
-                },
-              );
-              content = resp.data?.choices?.[0]?.message?.content || "";
-            } else {
-              const model = opts.model || "claude-3.5-sonnet-20240620";
-              const resp = await axios.post(
-                "https://api.anthropic.com/v1/messages",
-                {
-                  model,
-                  max_tokens: 1024,
-                  system: sys,
-                  messages: [{ role: "user", content: user }],
-                },
-                {
-                  headers: {
-                    "x-api-key": apiKey,
-                    "anthropic-version": "2023-06-01",
-                    "content-type": "application/json",
-                  },
-                },
-              );
-              content =
-                resp.data?.content && Array.isArray(resp.data.content)
-                  ? resp.data.content[0].text || ""
-                  : "";
-            }
-
-            // Write to file
-            const outPath = path.isAbsolute(opts.out)
-              ? opts.out
-              : path.join(process.cwd(), opts.out);
-            fs.mkdirSync(path.dirname(outPath), { recursive: true });
-            fs.writeFileSync(outPath, String(content || "").trim() + "\n");
-            console.log(`✅ Wrote prompt to ${outPath}`);
-
-            if (opts.manifest) {
-              const mf = path.isAbsolute(opts.manifest)
-                ? opts.manifest
-                : path.join(process.cwd(), opts.manifest);
-              if (!fs.existsSync(mf))
-                throw new Error(`Manifest not found: ${mf}`);
-              const IPFSManager = require("../ipfs-manager");
-              const ipfs = new IPFSManager();
-              await ipfs.initialize();
-              const key = path.basename(outPath, path.extname(outPath));
-              const name = key.replace(/[-_]/g, " ");
-              const cid = await ipfs.uploadPrompt(
-                outPath,
-                name,
-                `AI-generated prompt for ${opts.topic}`,
-              );
-              const raw = fs.readFileSync(mf, "utf8");
-              const manifest = JSON.parse(raw);
-              manifest.prompts = Array.isArray(manifest.prompts)
-                ? manifest.prompts
-                : [];
-              manifest.prompts.push({
-                key,
-                name,
-                description: `AI-generated prompt for ${opts.topic}`,
-                cid,
-                files: [path.relative(path.dirname(mf), outPath)],
-              });
-              fs.writeFileSync(mf, JSON.stringify(manifest, null, 2));
-              console.log(`📦 Added to manifest: ${mf}`);
-              console.log(`🔗 CID: ${cid}`);
-            }
-          } catch (error) {
-            console.error("❌ prompt generate failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("run")
-        .description("Run a prompt with an LLM via Echo or direct provider")
-        .option("--cid <cid>", "Prompt CID (JSON with content field)")
-        .option("--file <path>", "Local prompt file path")
-        .option("--input <text>", "User input to send alongside the prompt")
-        .option(
-          "--provider <name>",
-          "echo|openai|anthropic (auto-detect if omitted)",
-        )
-        .option(
-          "--model <id>",
-          "Model id (default: gpt-4o-mini or claude-3.5-sonnet)",
-        )
-        .option(
-          "--key <value>",
-          "API key override (env/config used if omitted)",
-        )
-        .option("--json", "Print raw JSON response", false)
-        .action(async (opts) => {
-          try {
-            const axios = require("axios");
-            const cliConfig = require("../config");
-            const ai =
-              typeof cliConfig.readAIConfig === "function"
-                ? cliConfig.readAIConfig()
-                : { openaiApiKey: null, anthropicApiKey: null };
-            const normalize = (value) =>
-              typeof value === "string" ? value.toLowerCase() : null;
-            const envEchoKey =
-              process.env.ECHO_API_KEY ||
-              process.env.NEXT_PUBLIC_ECHO_API_KEY ||
-              null;
-            let provider = normalize(opts.provider);
-            if (!provider) {
-              if (envEchoKey && !opts.key) {
-                provider = "echo";
-              } else if (opts.key) {
-                provider = "openai";
-              } else if (ai.openaiApiKey) {
-                provider = "openai";
-              } else if (ai.anthropicApiKey) {
-                provider = "anthropic";
-              } else {
-                provider = null;
-              }
-            }
-
-            if (!provider) {
-              console.log(
-                "❌ No provider configured. Set ECHO_API_KEY (Echo), OPENAI_API_KEY, or ANTHROPIC_API_KEY.",
-              );
-              console.log("   Echo example: export ECHO_API_KEY=echo_sk_...");
-              console.log(
-                "   OpenAI example: sage config ai set --provider openai --key sk-...",
-              );
-              console.log(
-                "   Anthropic example: sage config ai set --provider anthropic --key sk-ant-...",
-              );
-              process.exit(1);
-            }
-
-            const isEcho = provider === "echo";
-            const isOpenAI = provider === "openai";
-            const apiKey =
-              opts.key ||
-              (isEcho
-                ? envEchoKey
-                : isOpenAI
-                  ? ai.openaiApiKey
-                  : ai.anthropicApiKey);
-            if (!apiKey) {
-              throw new Error(`${provider} API key not configured`);
-            }
-
-            // Resolve prompt content
-            let systemPrompt = "";
-            if (opts.file) {
-              const fs = require("fs");
-              const path = require("path");
-              const p = path.isAbsolute(opts.file)
-                ? opts.file
-                : path.join(process.cwd(), opts.file);
-              systemPrompt = fs.readFileSync(p, "utf8");
-            } else if (opts.cid) {
-              const IPFSManager = require("../ipfs-manager");
-              const ipfs = new IPFSManager();
-              await ipfs.initialize();
-              try {
-                const j = await ipfs.downloadJson(opts.cid);
-                systemPrompt = j && (j.content || j.prompt || j.text || "");
-                if (!systemPrompt)
-                  throw new Error("No content field in CID JSON");
-              } catch (e) {
-                // Fallback: try file download flow
-                const os = require("os");
-                const path = require("path");
-                const tmp = path.join(
-                  os.tmpdir(),
-                  `sage-prompt-${Date.now()}.txt`,
-                );
-                const out = await ipfs.downloadPrompt(opts.cid, tmp);
-                systemPrompt = require("fs").readFileSync(out, "utf8");
-              }
-            } else {
-              throw new Error("Provide --file or --cid");
-            }
-
-            const userInput =
-              opts.input || "Respond to the prompt instructions.";
-
-            if (isEcho) {
-              const {
-                createEchoOpenAI,
-              } = require("@merit-systems/echo-typescript-sdk");
-              const { generateText } = require("ai");
-              const model =
-                opts.model || process.env.ECHO_MODEL || "gpt-4o-mini";
-              const echoConfig = {
-                appId:
-                  process.env.ECHO_APP_ID ||
-                  process.env.NEXT_PUBLIC_ECHO_APP_ID ||
-                  undefined,
-                baseRouterUrl: process.env.ECHO_ROUTER_URL || undefined,
-              };
-              const openai = createEchoOpenAI(echoConfig, async () => apiKey);
-              const prompt = `${systemPrompt.trim()}
-
-User:
-${userInput}`;
-              const result = await generateText({
-                model: openai(model),
-                prompt,
-              });
-              if (opts.json) {
-                console.log(JSON.stringify(result, null, 2));
-                return;
-              }
-              console.log("\n🧠 Echo (OpenAI-compatible) Output:\n");
-              console.log(result.text || "(no text in response)");
-              if (result.usage) {
-                console.log(
-                  `\nTokens — prompt: ${result.usage.promptTokens ?? "n/a"}, completion: ${result.usage.completionTokens ?? "n/a"}, total: ${result.usage.totalTokens ?? "n/a"}`,
-                );
-              }
-            } else if (isOpenAI) {
-              const model = opts.model || "gpt-4o-mini";
-              const resp = await axios.post(
-                "https://api.openai.com/v1/chat/completions",
-                {
-                  model,
-                  messages: [
-                    { role: "system", content: systemPrompt },
-                    { role: "user", content: userInput },
-                  ],
-                  temperature: 0.7,
-                },
-                {
-                  headers: {
-                    Authorization: `Bearer ${apiKey}`,
-                    "Content-Type": "application/json",
-                  },
-                },
-              );
-              if (opts.json) {
-                console.log(JSON.stringify(resp.data, null, 2));
-                return;
-              }
-              const text = resp.data?.choices?.[0]?.message?.content || "";
-              console.log("\n🧠 LLM Output:\n");
-              console.log(text);
-            } else {
-              // Anthropic
-              const model = opts.model || "claude-3.5-sonnet-20240620";
-              const resp = await axios.post(
-                "https://api.anthropic.com/v1/messages",
-                {
-                  model,
-                  max_tokens: 1024,
-                  system: systemPrompt,
-                  messages: [{ role: "user", content: userInput }],
-                },
-                {
-                  headers: {
-                    "x-api-key": apiKey,
-                    "anthropic-version": "2023-06-01",
-                    "content-type": "application/json",
-                  },
-                },
-              );
-              if (opts.json) {
-                console.log(JSON.stringify(resp.data, null, 2));
-                return;
-              }
-              const text =
-                resp.data?.content && Array.isArray(resp.data.content)
-                  ? resp.data.content[0].text || ""
-                  : "";
-              console.log("\n🧠 LLM Output:\n");
-              console.log(text);
-            }
-          } catch (error) {
-            console.error("❌ prompt run failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("publish")
-        .description("(Deprecated) Single-file prompt publish. Prefer `sage prompts publish` for workspace-aware flows.")
-        .addHelpText('beforeAll', '\nDeprecated: Use `sage prompts publish` for build→validate→push→propose. This command will be removed in a future release.')
-        .argument("<file>", "Path to prompt file")
-        .option("--name <name>", "Prompt name override")
-        .option("--description <text>", "Prompt description override")
-        .option("--no-pin", "Skip IPFS pinning")
-        .option(
-          "--sync-subdao <address>",
-          "Sync to on-chain registry via governance (SubDAO address)",
-        )
-        .option("--key <key>", "Optional prompt key (defaults to CID)")
-        .option(
-          "--build-payload",
-          "Print governance payload JSON for addPrompt (no submit)",
-        )
-        .action(async (file, options) => {
-          try {
-            console.log('⚠️  Deprecated: Use `sage prompts publish` for workspace-aware publishing. This command will be removed.');
-            const filePath = path.isAbsolute(file)
-              ? file
-              : path.join(process.cwd(), file);
-            if (!fs.existsSync(filePath))
-              throw new Error(`File not found: ${filePath}`);
-
-            const ipfs = new IPFSManager();
-            await ipfs.initialize();
-            const cid = await ipfs.uploadPrompt(
-              filePath,
-              options.name,
-              options.description,
-            );
-
-            if (options.pin !== false) {
-              // Pinning is handled by upload when using Pinata. For simulation/local, nothing to do.
-              console.log(
-                "📌 Pin requested: upload step handled pin where applicable",
-              );
-            }
-
-            if (options.buildPayload) {
-              // Build addPrompt(title, tags, contentCID, metadataCID, category)
-              const title =
-                options.name || path.basename(filePath, path.extname(filePath));
-              const tags = [];
-              const metadata = {
-                name: title,
-                description: options.description || "",
-                tags,
-              };
-              const metaCid = await ipfs.uploadJson(
-                metadata,
-                `${title}-metadata`,
-              );
-              const { ethers } = require("ethers");
-              const abi = [
-                "function addPrompt(string title, bytes32[] tags, string contentCID, string metadataCID, uint8 category)",
-              ];
-              const iface = new ethers.Interface(abi);
-              const calldata = iface.encodeFunctionData("addPrompt", [
-                title,
-                [],
-                cid,
-                metaCid,
-                0,
-              ]);
-              // Resolve registry if subdao provided
-              let registry = process.env.PROMPT_REGISTRY_ADDRESS;
-              if (
-                options.syncSubdao &&
-                /^0x[0-9a-fA-F]{40}$/.test(String(options.syncSubdao))
-              ) {
-                try {
-                  const { execSync } = require("child_process");
-                  const rpc = process.env.RPC_URL || "https://sepolia.base.org";
-                  registry = execSync(
-                    `cast call ${options.syncSubdao} "promptRegistry()" --rpc-url ${rpc} | cat`,
-                    { encoding: "utf8" },
-                  ).trim();
-                } catch (_) {}
-              }
-              if (!registry) {
-                console.log(
-                  "ℹ️  Set PROMPT_REGISTRY_ADDRESS or pass --sync-subdao to include target",
-                );
-              }
-              const payload = {
-                targets: registry ? [registry] : [],
-                values: registry ? [0] : [],
-                calldatas: [calldata],
-                description: `Add prompt ${title} (${cid})`,
-              };
-              console.log(JSON.stringify(payload, null, 2));
-            }
-
-            if (options.syncSubdao) {
-              const mgr = new PromptManager();
-              await mgr.initialize();
-              const subdao = options.syncSubdao;
-              const key = options.key || cid;
-              console.log(
-                "🔄 Syncing to on-chain registry requires a proposal via library flow.",
-              );
-              console.log(
-                "ℹ️  Use `sage project propose` with a manifest, or your governance workflow.",
-              );
-              console.log(`CID: ${cid} Key: ${key} SubDAO: ${subdao}`);
-            }
-
-            console.log(`✅ Published: ${cid}`);
-          } catch (error) {
-            console.error(`❌ Failed: ${error.message}`);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("preview")
-        .description("Preview prompt content from IPFS")
-        .argument("<cid>", "IPFS CID of the prompt")
-        .action(async (cid) => {
-          try {
-            const manager = new PromptManager();
-            await manager.initialize();
-            await manager.previewPrompt(cid);
-          } catch (error) {
-            console.error("❌ Failed to preview prompt:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("compare")
-        .description("Compare two prompts from IPFS")
-        .argument("<cid1>", "First IPFS CID")
-        .argument("<cid2>", "Second IPFS CID")
-        .action(async (cid1, cid2) => {
-          try {
-            const manager = new PromptManager();
-            await manager.initialize();
-            await manager.comparePrompts(cid1, cid2);
-          } catch (error) {
-            console.error("❌ Failed to compare prompts:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("resolve-key")
-        .description(
-          "Resolve the prompt key for a given CID within a SubDAO registry",
-        )
-        .requiredOption("-s, --subdao <address>", "SubDAO address")
-        .requiredOption("-c, --cid <cid>", "Prompt CID to resolve")
-        .option("--from <block>", "Start block (default: last 100000)", "")
-        .option(
-          "--window <n>",
-          "Block window size (max 50000; default 20000)",
-          "20000",
-        )
-        .option("--json", "Output JSON", false)
-        .action(async (options) => {
-          try {
-            const { ethers } = require("ethers");
-            const WalletManager = require("@sage-protocol/wallet-manager");
-            const wm = new WalletManager();
-            await wm.connect();
-            const provider = wm.getProvider();
-            const subdao = ethers.getAddress(options.subdao);
-            const targetCid = String(options.cid).trim();
-
-            // Resolve registry from SubDAO
-            const SubDAOABI = resolveArtifact(
-              "contracts/SubDAO.sol/SubDAO.json",
-            ).abi;
-            const subDAO = new ethers.Contract(subdao, SubDAOABI, provider);
-            const registryAddr = await subDAO.promptRegistry();
-            if (!registryAddr || registryAddr === ethers.ZeroAddress)
-              throw new Error("SubDAO has no PromptRegistry configured");
-
-            const PromptRegistryABI = resolveArtifact(
-              "contracts/PromptRegistry.sol/PromptRegistry.json",
-            ).abi;
-            const iface = new ethers.Interface(PromptRegistryABI);
-
-            // Determine scan range
-            const latest = await provider.getBlockNumber();
-            const fromBlock = options.from
-              ? String(options.from).startsWith("0x")
-                ? Number(options.from)
-                : Number(options.from)
-              : Math.max(0, latest - 100000);
-            let window = parseInt(String(options.window || "20000"), 10);
-            if (!Number.isFinite(window) || window <= 0) window = 20000;
-            if (window > 50000) window = 50000;
-
-            let found = null;
-            let start = fromBlock;
-            while (start <= latest) {
-              const end = Math.min(start + window - 1, latest);
-              let logs;
-              try {
-                logs = await provider.getLogs({
-                  address: registryAddr,
-                  fromBlock: start,
-                  toBlock: end,
-                });
-              } catch (err) {
-                const msg = String(err?.message || "");
-                if (
-                  (msg.includes("exceed maximum block range") ||
-                    msg.includes("block range")) &&
-                  window > 2000
-                ) {
-                  window = Math.max(2000, Math.floor(window / 2));
-                  continue;
-                }
-                throw err;
-              }
-              // Walk newest-first within the chunk
-              for (let i = logs.length - 1; i >= 0; i--) {
-                let parsed;
-                try {
-                  parsed = iface.parseLog(logs[i]);
-                } catch {
-                  continue;
-                }
-                if (parsed && parsed.name === "PromptUpdated") {
-                  const key = parsed.args[0];
-                  const cid = parsed.args[1];
-                  if (String(cid) === targetCid) {
-                    const block = await provider
-                      .getBlock(logs[i].blockNumber)
-                      .catch(() => null);
-                    found = {
-                      subdao,
-                      registry: registryAddr,
-                      key,
-                      cid,
-                      blockNumber: logs[i].blockNumber,
-                      tx: logs[i].transactionHash,
-                      timestamp: block ? Number(block.timestamp) : null,
-                    };
-                    break;
-                  }
-                }
-              }
-              if (found) break;
-              start = end + 1;
-            }
-
-            if (options.json) {
-              console.log(
-                JSON.stringify(
-                  found || {
-                    subdao,
-                    registry: registryAddr,
-                    key: null,
-                    cid: targetCid,
-                    blockNumber: null,
-                    tx: null,
-                    timestamp: null,
-                  },
-                  null,
-                  2,
-                ),
-              );
-            } else {
-              if (found) {
-                console.log(`SubDAO        : ${found.subdao}`);
-                console.log(`Registry      : ${found.registry}`);
-                console.log(`Key           : ${found.key}`);
-                console.log(`CID           : ${found.cid}`);
-                console.log(`Block         : ${found.blockNumber}`);
-                if (found.timestamp)
-                  console.log(
-                    `Timestamp     : ${new Date(found.timestamp * 1000).toISOString()}`,
-                  );
-                console.log(`Tx            : ${found.tx}`);
-              } else {
-                console.log("No key found for CID in the recent scan window.");
-                console.log(`SubDAO   : ${subdao}`);
-                console.log(`Registry : ${registryAddr}`);
-                console.log(`CID      : ${targetCid}`);
-                console.log(
-                  "Tip: pass a larger --from block (earlier) to widen the scan.",
-                );
-              }
-            }
-          } catch (error) {
-            console.error("❌ resolve-key failed:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("validate")
-        .description("Validate prompt content for quality")
-        .argument("<file>", "Path to prompt file")
-        .action(async (file) => {
-          try {
-            const content = fs.readFileSync(file, "utf8");
-            const manager = new PromptManager();
-            await manager.initialize();
-            await manager.validatePrompt(content);
-          } catch (error) {
-            console.error("❌ Failed to validate prompt:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("fork")
-        .description("Fork a prompt to create a new version")
-        .requiredOption("-s, --subdao <address>", "SubDAO address")
-        .requiredOption("-o, --old-cid <cid>", "Old prompt IPFS CID")
-        .requiredOption("-n, --new-cid <cid>", "New prompt IPFS CID")
-        .requiredOption(
-          "-d, --description <description>",
-          "New prompt description",
-        )
-        .option(
-          "--name <name>",
-          "New prompt name (defaults to derived from CID)",
-        )
-        .option(
-          "--fee",
-          "Pay stable fee instead of SXXX burn (requires factory stable prompt fork config)",
-          false,
-        )
-        .option(
-          "--permit [json]",
-          "Optional EIP-2612 permit payload (JSON) for stable fee fork",
-        )
-        .action(async (options) => {
-          try {
-            const manager = new PromptManager();
-            await manager.initialize();
-            await manager.forkPrompt(
-              options.subdao,
-              options.oldCid,
-              options.newCid,
-              options.description,
-              {
-                name: options.name,
-                fee: !!options.fee,
-                permit: options.permit || null,
-              },
-            );
-          } catch (error) {
-            console.error("❌ Failed to fork prompt:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("get-prompt")
-        .description("Get prompts from a SubDAO (alias for list)")
-        .requiredOption("-s, --subdao <address>", "SubDAO address")
-        .action(async (options) => {
-          try {
-            const manager = new PromptManager();
-            await manager.initialize();
-            await manager.listPrompts(options.subdao);
-          } catch (error) {
-            console.error("❌ Failed to get prompts:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(
-      new Command("onchain-list")
-        .description("List prompts from on-chain registry events")
-        .requiredOption("-s, --subdao <address>", "SubDAO address")
-        .option(
-          "--from <block>",
-          "From block number (hex or decimal) to start scanning",
-        )
-        .option("--rpc <url>", "Override RPC URL for this call")
-        .action(async (options) => {
-          try {
-            if (options.rpc) process.env.RPC_URL = options.rpc;
-            const manager = new PromptManager();
-            await manager.initialize();
-            await manager.listOnchainPrompts(
-              options.subdao,
-              options.from || null,
-            );
-          } catch (error) {
-            console.error("❌ Failed to list on-chain prompts:", error.message);
-            process.exit(1);
-          }
-        }),
-    )
-    .addCommand(promptTestCommand);
-
-  program.addCommand(promptCommand);
-
-  // Alias for get-prompt
-  const getPromptCommand = new Command("get-prompt")
-    .description("Get prompts from a SubDAO (alias for prompt list)")
-    .requiredOption("-s, --subdao <address>", "SubDAO address")
-    .action(async (options) => {
-      try {
-        const manager = new PromptManager();
-        await manager.initialize();
-        await manager.listPrompts(options.subdao);
-      } catch (error) {
-        console.error("❌ Failed to get prompts:", error.message);
-        process.exit(1);
-      }
-    });
-  program.addCommand(getPromptCommand);
-
-  // Alias for prompt-new
-  const promptNewCommand = new Command("prompt-new")
-    .description(
-      "Scaffold a system prompt template into prompts/ (alias: prompt new)",
-    )
-    .option(
-      "-o, --out <file>",
-      "Output file path under prompts/",
-      "prompts/system-template.txt",
-    )
-    .option("--manifest <path>", "Also add to a manifest.json at path")
-    .option(
-      "--key <key>",
-      "Manifest key (e.g. folder/name) when adding to manifest",
-    )
-    .option("--upload", "Upload created file to IPFS and print CID")
-    .option(
-      "--push",
-      "If --manifest is set, also push the manifest to IPFS and print CID",
-    )
-    .action(async (options) => {
-      try {
-        const outRel = options.out || "prompts/system-template.txt";
-        const out = path.isAbsolute(outRel)
-          ? outRel
-          : path.join(process.cwd(), outRel);
-        const dir = path.dirname(out);
-        if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-        const content = [
-          "You are a helpful, precise assistant. Follow the user's instructions carefully.",
-          "Ask for clarification when needed. Avoid revealing chain-of-thought;",
-          "provide concise final answers.",
-        ].join("\n");
-        fs.writeFileSync(out, content, { flag: "wx" });
-        console.log(`✅ Created ${out}`);
-        console.log(
-          "Next: add this file to your manifest and run `sage project validate` then `sage project push`/`propose`.",
-        );
-
-        let createdCid = null;
-        if (options.upload) {
-          const IPFSManager = require("../ipfs-manager");
-          const ipfs = new IPFSManager();
-          await ipfs.initialize();
-          createdCid = await ipfs.uploadPrompt(
-            out,
-            path.basename(out),
-            "Scaffolded by sage prompt-new",
-          );
-          console.log(`🔗 CID: ${createdCid}`);
-        }
-
-        if (options.manifest) {
-          try {
-            const manifestPath = path.isAbsolute(options.manifest)
-              ? options.manifest
-              : path.join(process.cwd(), options.manifest);
-            const raw = fs.readFileSync(manifestPath, "utf8");
-            const manifest = JSON.parse(raw);
-            manifest.prompts = Array.isArray(manifest.prompts)
-              ? manifest.prompts
-              : [];
-            const key = options.key || path.basename(out, path.extname(out));
-            const entry = {
-              key,
-              name: key,
-              files: [path.relative(path.dirname(manifestPath), out)],
-            };
-            if (createdCid) entry.cid = createdCid;
-            manifest.prompts.push(entry);
-            fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
-            console.log(`📝 Added prompt entry '${key}' to ${manifestPath}`);
-            if (options.push) {
-              const LibraryManager = require("../library-manager");
-              const lm = new LibraryManager();
-              lm.loadManifest(manifestPath);
-              const mcid = await lm.push();
-              console.log(`📦 Manifest pushed. CID: ${mcid}`);
-            }
-          } catch (e) {
-            console.error("❌ Failed to update/push manifest:", e.message);
-            process.exit(1);
-          }
-        }
-      } catch (err) {
-        if (err && err.code === "EEXIST") {
-          console.log(
-            "ℹ️  File already exists; choose a different --out path.",
-          );
-        } else {
-          console.error("❌ Failed to create prompt template:", err.message);
-          process.exit(1);
-        }
-      }
-    });
-  program.addCommand(promptNewCommand);
-}
-
-module.exports = { register, resolveWorkerSettings };