@spira-lab/cli 0.0.4 → 0.0.5

package/README.md

@@ -1,21 +1,22 @@
-# Spira CLI
-
-Command line client for Spira.
-
-## Install
-
-```bash
-npm install -g @spira-lab/cli
-```
-
-## Usage
-
-```bash
-spira --help
-spira auth login
-spira ai models list
-spira workflows create --name "Product launch workflow"
-spira workflows update <workflowId> --workflow-definition-json '{"nodes":[],"edges":[]}'
-```
-
-Use `spira --json` when you need machine-readable output.
+# Spira CLI
+
+Command line client for Spira.
+
+## Install
+
+```bash
+npm install -g @spira-lab/cli
+```
+
+## Usage
+
+```bash
+spira --help
+spira auth login
+spira ai models list
+spira workflows node-catalog --json
+spira workflows create --name "Product launch workflow"
+spira workflows update <workflowId> --workflow-definition-json '{"nodes":[],"edges":[]}'
+```
+
+Use `spira --json` when you need machine-readable output.

package/dist/index.cjs

@@ -18049,6 +18049,7 @@ var cliResultTypeSchema = external_exports.enum([
   "aiModelList",
   "aiModelDetail",
   "workflowList",
+  "workflowNodeCatalog",
   "workflowDetail",
   "workflowRunList",
   "workflowRunDetail",
@@ -18058,6 +18059,10 @@ var cliResultTypeSchema = external_exports.enum([
   "scheduleOccurrenceList",
   "scheduleExecutionList",
   "scheduleAction",
+  "dataBaseGlob",
+  "dataBaseRead",
+  "dataBaseGrep",
+  "dataBaseSearch",
   "generic"
 ]);
 var cliResultSchema = external_exports.object({
@@ -20592,6 +20597,36 @@ var commandDefinitions = [
       "spira workflows runs list <workflowId>"
     ]
   },
+  {
+    path: ["workflows", "node-catalog"],
+    purpose: "Show the current server workflow node catalog.",
+    options: [
+      {
+        name: "surface",
+        flag: "--surface <surface>",
+        description: "Workflow access surface.",
+        type: "string",
+        enumValues: ["dashboard", "admin"],
+        defaultValue: "dashboard"
+      }
+    ],
+    http: {
+      method: "GET",
+      path: "/api/cli/v1/workflows/node-catalog",
+      authRequired: true,
+      query: [{ name: "surface", source: "option", from: "surface" }]
+    },
+    resultType: "workflowNodeCatalog",
+    examples: [
+      "spira workflows node-catalog --json",
+      "spira workflows node-catalog --surface admin --json"
+    ],
+    relatedCommands: [
+      "spira workflows create --name <name>",
+      "spira workflows update <workflowId>",
+      "spira workflows get <workflowId>"
+    ]
+  },
   {
     path: ["workflows", "create"],
     purpose: "Create a canvas workflow.",
@@ -20869,6 +20904,105 @@ var commandDefinitions = [
     resultType: "scheduleOccurrenceList",
     examples: ["spira schedules calendar --from 1781884800000 --to 1782490000000"],
     relatedCommands: ["spira schedules get <scheduleId>"]
+  },
+  {
+    path: ["dataBase", "glob"],
+    purpose: "List files and folders in your Brand database matching a glob pattern.",
+    arguments: [{ name: "pattern", description: "Glob pattern (default: /**).", required: false }],
+    http: {
+      method: "GET",
+      path: "/api/cli/v1/data-base/glob",
+      authRequired: true,
+      query: [{ name: "pattern", source: "argument", from: "pattern" }]
+    },
+    resultType: "dataBaseGlob",
+    examples: ["spira dataBase glob", "spira dataBase glob '/docs/**'", "spira dataBase glob '/**/*.md'"],
+    relatedCommands: ["spira dataBase read <path>", 'spira dataBase search "<query>"']
+  },
+  {
+    path: ["dataBase", "read"],
+    purpose: "Read file content at a Brand database path with optional line/page slicing.",
+    arguments: [{ name: "path", description: "Brand database path (e.g. /docs/style-guide.md).", required: true }],
+    options: [
+      { name: "line", flag: "--line <number>", description: "Start line (1-based).", type: "number" },
+      { name: "lineEnd", flag: "--line-end <number>", description: "End line (inclusive).", type: "number" },
+      { name: "page", flag: "--page <number>", description: "Start page (1-based, PDFs).", type: "number" },
+      { name: "pageEnd", flag: "--page-end <number>", description: "End page (inclusive).", type: "number" },
+      { name: "expand", flag: "--expand <number>", description: "Extra lines of context around the range.", type: "number" }
+    ],
+    http: {
+      method: "GET",
+      path: "/api/cli/v1/data-base/read",
+      authRequired: true,
+      query: [
+        { name: "path", source: "argument", from: "path" },
+        { name: "line", source: "option", from: "line" },
+        { name: "lineEnd", source: "option", from: "lineEnd" },
+        { name: "page", source: "option", from: "page" },
+        { name: "pageEnd", source: "option", from: "pageEnd" },
+        { name: "expand", source: "option", from: "expand" }
+      ]
+    },
+    resultType: "dataBaseRead",
+    examples: [
+      "spira dataBase read /README.md",
+      "spira dataBase read /docs/style-guide.md --line 40 --line-end 120",
+      "spira dataBase read /decks/pitch.pdf --page 2 --page-end 3"
+    ],
+    relatedCommands: ["spira dataBase glob", 'spira dataBase search "<query>"']
+  },
+  {
+    path: ["dataBase", "grep"],
+    purpose: "Lexical (FTS + exact) search across your Brand database. Fast and deterministic.",
+    arguments: [{ name: "query", description: "Search query.", required: true }],
+    options: [
+      { name: "scope", flag: "--scope <path>", description: "Restrict to a folder path.", type: "string" },
+      { name: "limit", flag: "--limit <number>", description: "Max matches (default 20, max 100).", type: "number" },
+      { name: "debug", flag: "--debug", description: "Include candidate scoring breakdown (JSON mode).", type: "boolean" }
+    ],
+    http: {
+      method: "POST",
+      path: "/api/cli/v1/data-base/grep",
+      authRequired: true,
+      body: [
+        { name: "query", source: "argument", from: "query" },
+        { name: "scope", source: "option", from: "scope" },
+        { name: "limit", source: "option", from: "limit" },
+        { name: "debug", source: "option", from: "debug" }
+      ]
+    },
+    resultType: "dataBaseGrep",
+    examples: ['spira dataBase grep "brand voice"', 'spira dataBase grep "tone" --scope /docs --limit 10'],
+    relatedCommands: ["spira dataBase read <path>", 'spira dataBase search "<query>"']
+  },
+  {
+    path: ["dataBase", "search"],
+    purpose: "Semantic search (pgvector + RRF + MMR) across your Brand database.",
+    arguments: [{ name: "query", description: "Natural-language query.", required: true }],
+    options: [
+      { name: "scope", flag: "--scope <path>", description: "Restrict to a folder path.", type: "string" },
+      { name: "limit", flag: "--limit <number>", description: "Max matches (default 20, max 100).", type: "number" },
+      { name: "rerank", flag: "--rerank", description: "Enable LLM reranking (slower, higher quality).", type: "boolean" },
+      { name: "debug", flag: "--debug", description: "Include candidate scoring breakdown (JSON mode).", type: "boolean" }
+    ],
+    http: {
+      method: "POST",
+      path: "/api/cli/v1/data-base/search",
+      authRequired: true,
+      body: [
+        { name: "query", source: "argument", from: "query" },
+        { name: "scope", source: "option", from: "scope" },
+        { name: "limit", source: "option", from: "limit" },
+        { name: "rerank", source: "option", from: "rerank" },
+        { name: "debug", source: "option", from: "debug" }
+      ]
+    },
+    resultType: "dataBaseSearch",
+    examples: [
+      'spira dataBase search "what is our stance on price anchoring"',
+      'spira dataBase search "founder biography" --scope /about --rerank'
+    ],
+    relatedCommands: ["spira dataBase read <path>", 'spira dataBase grep "<query>"']
   }
 ];
 function findCommandDefinition(path) {
@@ -21512,6 +21646,29 @@ function formatCreditOption(option) {
   const when = formatWhen(option.when ?? option.conditions);
   return `  ${key}: ${label} - ${credits} credits ${unit}${when ? ` (${when})` : ""}`;
 }
+function portSummary(ports) {
+  if (!Array.isArray(ports) || ports.length === 0) return "-";
+  return ports.map((port) => {
+    const record2 = objectRecord(port);
+    const suffix = record2.multiple ? "[]" : "";
+    return `${valueToText(record2.id)}:${valueToText(record2.valueType)}${suffix}`;
+  }).join(", ");
+}
+function renderWorkflowNodeCatalog(data) {
+  const record2 = objectRecord(data);
+  const nodes = Array.isArray(record2.nodes) ? record2.nodes : [];
+  const rows = nodes.map((node) => {
+    const nodeRecord = objectRecord(node);
+    const ports = objectRecord(nodeRecord.ports);
+    return {
+      type: nodeRecord.type,
+      inputs: portSummary(ports.inputs),
+      outputs: portSummary(ports.outputs),
+      requiredPermission: nodeRecord.requiredPermission
+    };
+  });
+  return renderRows(rows, ["type", "inputs", "outputs", "requiredPermission"]);
+}
 function renderAccountList(data) {
   const channels = data && typeof data === "object" ? data.publishChannels : null;
   if (Array.isArray(channels)) {
@@ -21703,6 +21860,112 @@ function renderScheduleDetail(data) {
     `scheduledAt: ${valueToText(currentPattern.scheduledAt)}`
   ].join("\n").concat("\n");
 }
+function formatByteSize(value) {
+  const n = typeof value === "number" && Number.isFinite(value) ? value : NaN;
+  if (!Number.isFinite(n) || n < 0) return "-";
+  if (n < 1024) return `${n} B`;
+  if (n < 1024 * 1024) return `${(n / 1024).toFixed(n < 10 * 1024 ? 1 : 0)} KB`;
+  if (n < 1024 * 1024 * 1024) return `${(n / (1024 * 1024)).toFixed(1)} MB`;
+  return `${(n / (1024 * 1024 * 1024)).toFixed(2)} GB`;
+}
+function formatAnchor(anchor) {
+  const parts = [];
+  const line = anchor.line;
+  const lineEnd = anchor.lineEnd;
+  const page = anchor.page;
+  const pageEnd = anchor.pageEnd;
+  const timeStart = anchor.timeStartMs;
+  const timeEnd = anchor.timeEndMs;
+  if (typeof line === "number") {
+    parts.push(typeof lineEnd === "number" ? `L${line}-${lineEnd}` : `L${line}`);
+  }
+  if (typeof page === "number") {
+    parts.push(typeof pageEnd === "number" ? `p${page}-${pageEnd}` : `p${page}`);
+  }
+  if (typeof timeStart === "number") {
+    parts.push(typeof timeEnd === "number" ? `t${timeStart}-${timeEnd}ms` : `t${timeStart}ms`);
+  }
+  return parts.join(", ") || "-";
+}
+function renderDataBaseGlob(data) {
+  const record2 = objectRecord(data);
+  const pattern = valueToText(record2.pattern);
+  const entries = Array.isArray(record2.entries) ? record2.entries.map(objectRecord) : [];
+  if (entries.length === 0) return `pattern: ${pattern}
+No entries.
+`;
+  const rows = entries.map((entry) => {
+    const isFolder = entry.type === "folder";
+    const isVirtual = entry.virtual === true;
+    return {
+      type: isFolder ? "dir" : isVirtual ? "file*" : "file",
+      path: entry.path,
+      fileType: isFolder ? "-" : valueToText(entry.fileType),
+      size: isFolder ? `${valueToText(entry.fileCount)} files` : formatByteSize(entry.size),
+      status: isFolder ? "-" : valueToText(entry.processingStatus),
+      updatedAt: entry.updatedAt
+    };
+  });
+  return `pattern: ${pattern}  (${entries.length} entries)
+${renderRows(rows, ["type", "path", "fileType", "size", "status", "updatedAt"])}`;
+}
+function renderDataBaseRead(data) {
+  const record2 = objectRecord(data);
+  const path = valueToText(record2.path);
+  const fileType = valueToText(record2.fileType);
+  const mimeType = valueToText(record2.mimeType);
+  const rangeObj = objectRecord(record2.range);
+  let rangeStr = "-";
+  if (Array.isArray(rangeObj.line) && rangeObj.line.length === 2) {
+    rangeStr = `lines ${rangeObj.line[0]}-${rangeObj.line[1]}`;
+  } else if (Array.isArray(rangeObj.page) && rangeObj.page.length === 2) {
+    rangeStr = `pages ${rangeObj.page[0]}-${rangeObj.page[1]}`;
+  }
+  const totalLines = record2.totalLines !== void 0 ? valueToText(record2.totalLines) : "-";
+  const truncated = valueToText(record2.truncated);
+  const lines = [
+    `path: ${path}`,
+    `fileType: ${fileType}`,
+    `mimeType: ${mimeType}`,
+    `range: ${rangeStr}`,
+    `totalLines: ${totalLines}`,
+    `truncated: ${truncated}`
+  ];
+  if (record2.virtual === true) lines.push("virtual: true");
+  if (record2.processingStatus) lines.push(`processingStatus: ${valueToText(record2.processingStatus)}`);
+  if (record2.storageUrl) lines.push(`storageUrl: ${valueToText(record2.storageUrl)}`);
+  const content = typeof record2.content === "string" ? record2.content : "";
+  const header = `${lines.join("\n")}
+`;
+  const nextLine = typeof record2.nextLine === "number" ? record2.nextLine : void 0;
+  const footer = record2.truncated === true && nextLine ? `
+--
+(truncated; continue with: spira dataBase read ${path} --line ${nextLine})
+` : "";
+  return `${header}
+${content}${footer}`;
+}
+function renderDataBaseMatches(data) {
+  const record2 = objectRecord(data);
+  const query = valueToText(record2.query);
+  const matches = Array.isArray(record2.matches) ? record2.matches.map(objectRecord) : [];
+  if (matches.length === 0) return `query: ${query}
+No matches.
+`;
+  const blocks = matches.map((match) => {
+    const anchor = formatAnchor(objectRecord(match.anchor));
+    const score = typeof match.score === "number" ? match.score.toFixed(3) : valueToText(match.score);
+    const fields = Array.isArray(match.matchedFields) ? match.matchedFields.join(",") : "";
+    const header = `${valueToText(match.path)}(${anchor})  [score=${score}${fields ? ` fields=${fields}` : ""}]`;
+    const snippet = typeof match.snippet === "string" ? match.snippet : valueToText(match.snippet);
+    const indented = snippet.split("\n").map((line) => `  ${line}`).join("\n");
+    return `${header}
+${indented}`;
+  });
+  return `query: ${query}  (${matches.length} matches)
+${blocks.join("\n\n")}
+`;
+}
 function renderSuccess(result) {
   switch (result.resultType) {
     case "authLogin":
@@ -21745,6 +22008,8 @@ function renderSuccess(result) {
       return renderAiModelDetail(result.data);
     case "workflowList":
       return renderRows(dataArray(result.data), ["id", "name", "creatorName", "nodeTypes", "updatedAt"]);
+    case "workflowNodeCatalog":
+      return renderWorkflowNodeCatalog(result.data);
     case "workflowDetail":
       return renderWorkflowDetail(result.data);
     case "workflowRunList":
@@ -21757,6 +22022,13 @@ function renderSuccess(result) {
       return renderRows(dataArray(result.data), ["id", "scheduleId", "scheduledAt", "status", "executorType"]);
     case "scheduleExecutionList":
       return renderRows(dataArray(result.data), ["id", "scheduleId", "status", "originalScheduledAt", "startedAt", "finishedAt"]);
+    case "dataBaseGlob":
+      return renderDataBaseGlob(result.data);
+    case "dataBaseRead":
+      return renderDataBaseRead(result.data);
+    case "dataBaseGrep":
+    case "dataBaseSearch":
+      return renderDataBaseMatches(result.data);
     default:
       return renderKeyValues(result.data);
   }
@@ -22066,8 +22338,8 @@ function renderCommandIndex() {
 `;
 }
 async function packageVersion() {
-  if ("0.0.4".length > 0) {
-    return "0.0.4";
+  if ("0.0.5".length > 0) {
+    return "0.0.5";
   }
   try {
     const packageUrl = new URL("../package.json", import_meta.url);
@@ -22258,7 +22530,7 @@ function addLeafCommand(root, definition, output) {
   for (const option of definition.options ?? []) addOption(leaf, option);
   leaf.action(async (...values) => {
     const command = values[values.length - 1];
-    const positional = values.slice(0, -1).map((value) => String(value));
+    const positional = values.slice(0, -1).map((value) => value === void 0 ? "" : String(value));
     const args = Object.fromEntries((definition.arguments ?? []).map((argument, index) => [argument.name, positional[index] ?? ""]));
     const options = command.optsWithGlobals();
     const validationResult2 = validateCommandInput(definition, args, options);

package/package.json

@@ -1,17 +1,40 @@
 {
   "name": "@spira-lab/cli",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Command line client for Spira.",
   "type": "module",
+  "main": "./dist/index.cjs",
   "bin": {
     "spira": "dist/index.cjs"
   },
-  "main": "./dist/index.cjs",
   "engines": {
     "node": ">=20.0.0"
   },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "pnpm --filter @spira-ai/contracts build && node scripts/build.mjs && node scripts/fix-bin-mode.mjs",
+    "dev": "tsx src/index.ts",
+    "publish:public": "node scripts/publish.mjs",
+    "typecheck": "tsgo --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@typescript/native-preview": "catalog:",
+    "@spira-ai/contracts": "workspace:*",
+    "@types/node": "catalog:",
+    "commander": "^14.0.2",
+    "esbuild": "^0.27.1",
+    "tsx": "^4.22.4",
+    "typescript": "catalog:",
+    "vitest": "catalog:",
+    "zod": "catalog:"
   }
 }