orbit-code-ai 0.1.38 → 0.1.39

package/dist/cli.mjs

@@ -83792,7 +83792,7 @@ async function printStartupScreen() {
   const sLen = ` ● ${sL}    Ready — type /help to begin`.length;
   out.push(boxRow(sRow, W2, sLen));
   out.push(`${rgb(...BORDER)}╚${"═".repeat(W2 - 2)}╝${RESET}`);
-  out.push(`  ${DIM}${rgb(...DIMCOL)}orbit-code ${RESET}${rgb(...ACCENT)}v${"0.1.38"}${RESET}`);
+  out.push(`  ${DIM}${rgb(...DIMCOL)}orbit-code ${RESET}${rgb(...ACCENT)}v${"0.1.39"}${RESET}`);
   out.push("");
   process.stdout.write(out.join(`
 `) + `
@@ -334299,7 +334299,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-07-09T12:17:41.680Z").getTime();
+  const buildTime = new Date("2026-07-16T10:32:35.333Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -358716,7 +358716,7 @@ function buildPrimarySection() {
   }, undefined, false, undefined, this);
   return [{
     label: "Version",
-    value: "0.1.38"
+    value: "0.1.39"
   }, {
     label: "Session name",
     value: nameValue
@@ -471025,7 +471025,7 @@ function WelcomeV2() {
             dimColor: true,
             children: [
               "v",
-              "0.1.38",
+              "0.1.39",
               " "
             ]
           }, undefined, true, undefined, this)
@@ -471225,7 +471225,7 @@ function WelcomeV2() {
           dimColor: true,
           children: [
             "v",
-            "0.1.38",
+            "0.1.39",
             " "
           ]
         }, undefined, true, undefined, this)
@@ -471451,7 +471451,7 @@ function AppleTerminalWelcomeV2(t0) {
         dimColor: true,
         children: [
           "v",
-          "0.1.38",
+          "0.1.39",
           " "
         ]
       }, undefined, true, undefined, this);
@@ -471705,7 +471705,7 @@ function AppleTerminalWelcomeV2(t0) {
       dimColor: true,
       children: [
         "v",
-        "0.1.38",
+        "0.1.39",
         " "
       ]
     }, undefined, true, undefined, this);
@@ -475730,6 +475730,294 @@ var init_aceSkills = __esm(() => {
   init_bundledSkills();
 });
 
+// src/utils/docx.ts
+import { readFileSync as readFileSync10 } from "fs";
+function escapeReg(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function decodeEntities(s) {
+  return s.replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&apos;/g, "'").replace(/&#x([0-9a-fA-F]+);/g, (_m, h2) => String.fromCodePoint(parseInt(h2, 16))).replace(/&#(\d+);/g, (_m, d) => String.fromCodePoint(parseInt(d, 10))).replace(/&amp;/g, "&");
+}
+function firstTag(xml, name, from) {
+  const re = new RegExp(`<${escapeReg(name)}(?=[\\s/>])`, "g");
+  re.lastIndex = from;
+  const m = re.exec(xml);
+  return m ? m.index : -1;
+}
+function findElementEnd(xml, openIdx, name) {
+  const openRe = new RegExp(`<${escapeReg(name)}(?=[\\s/>])`, "g");
+  const closeStr = `</${name}>`;
+  let depth = 0;
+  let i3 = openIdx;
+  while (i3 < xml.length) {
+    openRe.lastIndex = i3;
+    const om = openRe.exec(xml);
+    const openPos = om ? om.index : -1;
+    const closePos = xml.indexOf(closeStr, i3);
+    if (closePos === -1)
+      return xml.length;
+    if (openPos !== -1 && openPos < closePos) {
+      const gt2 = xml.indexOf(">", openPos);
+      const selfClosing = gt2 > 0 && xml[gt2 - 1] === "/";
+      if (!selfClosing)
+        depth++;
+      i3 = gt2 + 1;
+    } else {
+      depth--;
+      i3 = closePos + closeStr.length;
+      if (depth === 0)
+        return i3;
+    }
+  }
+  return xml.length;
+}
+function runText(xml) {
+  let s = "";
+  const re = /<w:t(?:\s[^>]*)?>([\s\S]*?)<\/w:t>/g;
+  let m;
+  while ((m = re.exec(xml)) !== null)
+    s += m[1];
+  return decodeEntities(s);
+}
+function inner(xml, name) {
+  const start = xml.indexOf(">");
+  const end = xml.lastIndexOf(`</${name}>`);
+  return start === -1 || end === -1 ? xml : xml.slice(start + 1, end);
+}
+function cellText(tcXml) {
+  const body = inner(tcXml, "w:tc");
+  const parts = [];
+  let i3 = 0;
+  while (i3 < body.length) {
+    const pPos = firstTag(body, "w:p", i3);
+    if (pPos === -1)
+      break;
+    const pEnd = findElementEnd(body, pPos, "w:p");
+    const t = runText(body.slice(pPos, pEnd)).trim();
+    if (t)
+      parts.push(t);
+    i3 = pEnd;
+  }
+  return parts.join(" ").replace(/\s+/g, " ").trim().replace(/\|/g, "\\|");
+}
+function rowCells(trXml) {
+  const body = inner(trXml, "w:tr");
+  const cells = [];
+  let i3 = 0;
+  while (i3 < body.length) {
+    const nested = firstTag(body, "w:tbl", i3);
+    const tc = firstTag(body, "w:tc", i3);
+    if (tc === -1)
+      break;
+    if (nested !== -1 && nested < tc) {
+      i3 = findElementEnd(body, nested, "w:tbl");
+      continue;
+    }
+    const tcEnd = findElementEnd(body, tc, "w:tc");
+    cells.push(cellText(body.slice(tc, tcEnd)));
+    i3 = tcEnd;
+  }
+  return cells;
+}
+function renderTable(tblXml) {
+  const body = inner(tblXml, "w:tbl");
+  const rows = [];
+  let i3 = 0;
+  while (i3 < body.length) {
+    const nested = firstTag(body, "w:tbl", i3);
+    const tr = firstTag(body, "w:tr", i3);
+    if (tr === -1)
+      break;
+    if (nested !== -1 && nested < tr) {
+      i3 = findElementEnd(body, nested, "w:tbl");
+      continue;
+    }
+    const trEnd = findElementEnd(body, tr, "w:tr");
+    rows.push(rowCells(body.slice(tr, trEnd)));
+    i3 = trEnd;
+  }
+  if (rows.length === 0)
+    return "";
+  const width = Math.max(...rows.map((r) => r.length));
+  const pad = (r) => "| " + Array.from({ length: width }, (_, k) => r[k] ?? "").join(" | ") + " |";
+  const md = [pad(rows[0]), "| " + Array(width).fill("---").join(" | ") + " |"];
+  for (const r of rows.slice(1))
+    md.push(pad(r));
+  return md.join(`
+`);
+}
+function renderBody(bodyXml) {
+  const out = [];
+  let i3 = 0;
+  while (i3 < bodyXml.length) {
+    const p = firstTag(bodyXml, "w:p", i3);
+    const tbl = firstTag(bodyXml, "w:tbl", i3);
+    if (p === -1 && tbl === -1)
+      break;
+    if (tbl !== -1 && (p === -1 || tbl < p)) {
+      const end = findElementEnd(bodyXml, tbl, "w:tbl");
+      const t = renderTable(bodyXml.slice(tbl, end));
+      if (t)
+        out.push(t);
+      i3 = end;
+    } else {
+      const end = findElementEnd(bodyXml, p, "w:p");
+      const t = runText(bodyXml.slice(p, end)).trim();
+      if (t)
+        out.push(t);
+      i3 = end;
+    }
+  }
+  return out.join(`
+
+`);
+}
+async function extractDocxText(filePath, maxChars = 60000) {
+  const { unzipSync: unzipSync2 } = await Promise.resolve().then(() => (init_esm3(), exports_esm));
+  const data = readFileSync10(filePath);
+  let files2;
+  try {
+    files2 = unzipSync2(new Uint8Array(data), {
+      filter: (f) => f.name === "word/document.xml"
+    });
+  } catch (e2) {
+    throw new Error(`Not a readable .docx (unzip failed): ${e2.message}`);
+  }
+  const bytes = files2["word/document.xml"];
+  if (!bytes) {
+    throw new Error("word/document.xml not found — the file is not a valid .docx (a .doc or renamed file?).");
+  }
+  const xml = new TextDecoder("utf-8").decode(bytes);
+  const bodyMatch = xml.match(/<w:body[^>]*>([\s\S]*)<\/w:body>/);
+  const text = renderBody(bodyMatch ? bodyMatch[1] : xml).trim();
+  if (text.length > maxChars) {
+    return `${text.slice(0, maxChars)}
+
+…[truncated; ${text.length} chars total]…`;
+  }
+  return text;
+}
+var init_docx = () => {};
+
+// src/skills/bundled/lld.ts
+function textBlock(text) {
+  return [{ type: "text", text }];
+}
+function parseArgs(args) {
+  const trimmed = args.trim();
+  let path20 = "";
+  let rest = "";
+  const quoted = trimmed.match(/^["']([^"']+)["']\s*(.*)$/);
+  if (quoted) {
+    path20 = quoted[1];
+    rest = quoted[2];
+  } else {
+    const dotdocx = trimmed.match(/^(.*?\.docx)\s*(.*)$/i);
+    if (dotdocx) {
+      path20 = dotdocx[1].trim();
+      rest = dotdocx[2];
+    } else {
+      rest = trimmed;
+    }
+  }
+  const t = rest.match(/\b(contract|api|both)\b/i)?.[1]?.toLowerCase();
+  const target = t === "contract" || t === "api" ? t : "both";
+  return { path: path20.replace(/[.,;]$/, ""), target };
+}
+function buildPrompt(path20, content, target) {
+  const gen = target === "contract" ? "the CONTRACT only (invoke /api-contract)" : target === "api" ? "the GATEWAY API only (invoke /apic-api)" : "BOTH the contract (/api-contract) and the gateway API (/apic-api)";
+  return `You are turning an LLD (Low-Level Design) Word document into APIC artifacts. The full LLD text
+below was extracted from ${path20} (paragraphs as text, tables as markdown). Requested output: ${gen}.
+
+════════════════════ EXTRACTED LLD ════════════════════
+${content}
+════════════════════ END LLD ════════════════════
+
+Do this, in order:
+
+1. EXTRACT the API spec from the LLD above, using this house-template map (sections/tables → fields):
+   - Introduction (Purpose / Scope) → API title + description.
+   - "Integration flow (<op>)" → its "API Gateway endpoint" and "Method" → the operation path + verb.
+   - "<op> Request" table → request model. Columns are typically Field | Type | Occurrence | Length |
+     Description | Validation. Convert: Occurrence M → required; O/C → optional (put the C rule in
+     description); Length N → maxLength; allowed-values → enum; "1..*" → array (minItems 1 when ≥1).
+   - "<op> Response" table + any "<type>" tables (e.g. commodity_type) → response model (nested/arrays).
+   - "Error Codes" table + any sample error bodies → error responses (HTTP codes + error schema).
+   - "Transformation Specifications" tables → how request fields map to the backend + any defaulting.
+   - "Annex / Provider" (endpoints, auth) → the backend/provider endpoint(s) and their auth.
+   - Integration pattern: if the middleware is an existing ACE/webMethods service that already returns
+     the response envelope, it is a **wrapper**; if APIC calls a raw backend and must build the
+     envelope, it is **backend**. State which and why.
+
+2. ECHO a concise EXTRACTION SUMMARY to the user FIRST (do NOT generate yet): API name, pattern,
+   each operation (verb + path), request/response field lists, error codes, backend endpoint, and the
+   fields you could NOT determine. Then ask for the unguessables only: OpenAPI 2.0 vs 3.0; inbound
+   consumer auth (basic/apikey/oauth2); host; and (for /apic-api) JWT on/off + crypto object and the
+   backend target-url variable. NEVER fabricate hosts, crypto objects, scopes, or business fields — ask
+   or use clearly-marked CHANGEME placeholders and list them.
+
+3. After the user confirms/corrects, GENERATE ${gen}:
+   - Contract → invoke the /api-contract skill, passing the API name, host, security, and the full
+     request/response/error models you extracted.
+   - Gateway API → invoke the /apic-api skill, passing the operation (name, verb, basePath, explicit
+     path), the chosen --pattern (wrapper vs backend), the backend target-url, and the flags. One
+     /apic-api call per operation.
+   Reuse the values from the extraction summary verbatim — do not re-derive or drop fields.
+
+Ground everything in the extracted LLD above; if the LLD does not state something, say so rather than
+inventing it.`;
+}
+async function handle(args) {
+  const { path: path20, target } = parseArgs(args);
+  if (!path20)
+    return HELP;
+  let content;
+  try {
+    content = await extractDocxText(path20);
+  } catch (e2) {
+    return `Could not read the LLD at "${path20}": ${e2.message}
+
+Give the full path to a .docx file, e.g.
+/lld "C:\\\\path\\\\to\\\\LLD.docx" both`;
+  }
+  if (!content.trim()) {
+    return `The LLD at "${path20}" extracted no text (it may be image-only or empty). I can't generate from it — confirm the file, or paste the request/response models directly.`;
+  }
+  return buildPrompt(path20, content, target);
+}
+function registerLldSkill() {
+  registerBundledSkill({
+    name: "lld",
+    description: "Read an LLD (.docx) Word document — paragraphs and tables — extract the API spec against the house template, confirm it, then generate the contract-only OpenAPI (/api-contract) and/or the APIC gateway API (/apic-api) from it.",
+    whenToUse: "When the user points at an LLD .docx and wants the APIC contract and/or gateway API generated from it (LLD → YAML).",
+    argumentHint: '"<path-to-LLD.docx>" [contract|api|both]',
+    userInvocable: true,
+    allowedTools: ["Read", "Glob", "Grep"],
+    async getPromptForCommand(args) {
+      try {
+        return textBlock(await handle(args));
+      } catch (e2) {
+        return textBlock(`/lld error: ${e2.message}`);
+      }
+    }
+  });
+}
+var HELP = `# /lld — read an LLD (.docx) and generate the APIC contract and/or gateway API
+
+Usage:
+  /lld "<path-to-LLD.docx>" [contract|api|both]
+
+- contract → generate the contract-only OpenAPI via /api-contract
+- api      → generate the gateway implementation via /apic-api
+- both     → generate both (default)
+
+Reads the Word LLD (paragraphs + tables), extracts the API spec against the house template,
+shows you an extraction summary to confirm, then hands off to the generator skill(s).`;
+var init_lld = __esm(() => {
+  init_bundledSkills();
+  init_docx();
+});
+
 // src/skills/bundled/orbitInChrome.ts
 function registerOrbitInChromeSkill() {
   registerBundledSkill({
@@ -477312,7 +477600,7 @@ var require_tslib = __commonJS((exports, module) => {
       if (value !== null && value !== undefined) {
         if (typeof value !== "object" && typeof value !== "function")
           throw new TypeError("Object expected.");
-        var dispose4, inner;
+        var dispose4, inner2;
         if (async) {
           if (!Symbol.asyncDispose)
             throw new TypeError("Symbol.asyncDispose is not defined.");
@@ -477323,14 +477611,14 @@ var require_tslib = __commonJS((exports, module) => {
             throw new TypeError("Symbol.dispose is not defined.");
           dispose4 = value[Symbol.dispose];
           if (async)
-            inner = dispose4;
+            inner2 = dispose4;
         }
         if (typeof dispose4 !== "function")
           throw new TypeError("Object not disposable.");
-        if (inner)
+        if (inner2)
           dispose4 = function() {
             try {
-              inner.call(this);
+              inner2.call(this);
             } catch (e2) {
               return Promise.reject(e2);
             }
@@ -510361,7 +510649,7 @@ ${declareVars || "  -- (no parameters)"}${resultHandling}`;
 }
 
 // src/skills/bundled/sql.ts
-function textBlock(text) {
+function textBlock2(text) {
   return [{ type: "text", text }];
 }
 function parseConnectArgs(args) {
@@ -510600,22 +510888,22 @@ Do this, in order:
 
 Data-handling notice (state once): these are REAL values from the connected database and may include personal/production data. Return them as-is; never fabricate. If a SELECT returns no rows, say so plainly — for a happy case it means no qualifying data exists; do not invent a row. If the app calls no stored procedures at all, build the input body from the XSD types alone and clearly mark those values as synthetic (no DB row backs them).`;
 }
-async function handle(args) {
+async function handle2(args) {
   const trimmed = args.trim();
   if (!trimmed)
-    return HELP;
+    return HELP2;
   const firstTok = trimmed.split(/\s+/)[0].toLowerCase();
   const restStr = trimmed.slice(trimmed.split(/\s+/)[0].length).trim();
   switch (firstTok) {
     case "help":
-      return HELP;
+      return HELP2;
     case "connect": {
       const parsed = parseConnectArgs(restStr);
       const missing = ["server", "database", "user", "password"].filter((k) => !parsed[k]);
       if (missing.length > 0)
         return `Missing required field(s): ${missing.join(", ")}.
 
-${HELP}`;
+${HELP2}`;
       const conn2 = parsed;
       const saved = saveSqlConnection(conn2);
       let testMsg;
@@ -510743,14 +511031,14 @@ function registerSqlSkill() {
     allowedTools: ["Read", "Glob", "Grep"],
     async getPromptForCommand(args) {
       try {
-        return textBlock(await handle(args));
+        return textBlock2(await handle2(args));
       } catch (e2) {
-        return textBlock(`/sql error: ${e2.message}`);
+        return textBlock2(`/sql error: ${e2.message}`);
       }
     }
   });
 }
-var HELP, GROUND = `
+var HELP2, GROUND = `
 
 IMPORTANT: The metadata above is the ONLY database information you have — you cannot query the DB yourself. State only what appears above; never invent, guess, or "fill in" parameters, columns, types, or procedures. If something is not shown, say it is not shown.`, STOPWORDS;
 var init_sql = __esm(() => {
@@ -510758,7 +511046,7 @@ var init_sql = __esm(() => {
   init_connectionStore();
   init_mssqlClient();
   init_spMetadata();
-  HELP = `# /sql — SQL Server helper (native connection)
+  HELP2 = `# /sql — SQL Server helper (native connection)
 
 Subcommands (also understands plain English, e.g. "/sql details of the SP Get_UserInformation"):
 - \`/sql connect server=HOST database=DB user=USER password=PASS [port=1433] [encrypt=false]\` — save the connection once (OS secure vault; password never written to disk in plaintext).
@@ -511321,6 +511609,7 @@ If a hook isn't running:
 function initBundledSkills() {
   registerAceSkills();
   registerSqlSkill();
+  registerLldSkill();
   registerUpdateConfigSkill();
   if (false) {}
   if (false) {}
@@ -511335,6 +511624,7 @@ function initBundledSkills() {
 var init_bundled = __esm(() => {
   init_setup2();
   init_aceSkills();
+  init_lld();
   init_orbitInChrome();
   init_sql();
   init_updateConfig();
@@ -522792,7 +523082,7 @@ ${m.text}
               let bridgeFailureDetail;
               try {
                 const { initReplBridge: initReplBridge2 } = await Promise.resolve().then(() => (init_initReplBridge(), exports_initReplBridge));
-                const handle2 = await initReplBridge2({
+                const handle3 = await initReplBridge2({
                   onInboundMessage(msg) {
                     const fields = extractInboundMessageFields(msg);
                     if (!fields)
@@ -522845,21 +523135,21 @@ ${m.text}
                   },
                   initialMessages: mutableMessages.length > 0 ? mutableMessages : undefined
                 });
-                if (!handle2) {
+                if (!handle3) {
                   sendControlResponseError(message, bridgeFailureDetail ?? "Remote Control initialization failed");
                 } else {
-                  bridgeHandle = handle2;
+                  bridgeHandle = handle3;
                   bridgeLastForwardedIndex = mutableMessages.length;
                   structuredIO.setOnControlRequestSent((request) => {
-                    handle2.sendControlRequest(request);
+                    handle3.sendControlRequest(request);
                   });
                   structuredIO.setOnControlRequestResolved((requestId) => {
-                    handle2.sendControlCancelRequest(requestId);
+                    handle3.sendControlCancelRequest(requestId);
                   });
                   sendControlResponseSuccess(message, {
-                    session_url: getRemoteSessionUrl(handle2.bridgeSessionId, handle2.sessionIngressUrl),
-                    connect_url: buildBridgeConnectUrl(handle2.environmentId, handle2.sessionIngressUrl),
-                    environment_id: handle2.environmentId
+                    session_url: getRemoteSessionUrl(handle3.bridgeSessionId, handle3.sessionIngressUrl),
+                    connect_url: buildBridgeConnectUrl(handle3.environmentId, handle3.sessionIngressUrl),
+                    environment_id: handle3.environmentId
                   });
                 }
               } catch (err2) {
@@ -525467,7 +525757,7 @@ __export(exports_main, {
   startDeferredPrefetches: () => startDeferredPrefetches,
   main: () => main
 });
-import { readFileSync as readFileSync10 } from "fs";
+import { readFileSync as readFileSync11 } from "fs";
 import { resolve as resolve40 } from "path";
 function logManagedSettings() {
   try {
@@ -525623,7 +525913,7 @@ function loadSettingsFromFlag(settingsFile) {
         resolvedPath: resolvedSettingsPath
       } = safeResolvePath(getFsImplementation(), settingsFile);
       try {
-        readFileSync10(resolvedSettingsPath, "utf8");
+        readFileSync11(resolvedSettingsPath, "utf8");
       } catch (e2) {
         if (isENOENT(e2)) {
           process.stderr.write(source_default.red(`Error: Settings file not found: ${resolvedSettingsPath}
@@ -526026,7 +526316,7 @@ ${getTmuxInstallInstructions2()}
       }
       try {
         const filePath = resolve40(options2.systemPromptFile);
-        systemPrompt = readFileSync10(filePath, "utf8");
+        systemPrompt = readFileSync11(filePath, "utf8");
       } catch (error41) {
         const code = getErrnoCode(error41);
         if (code === "ENOENT") {
@@ -526048,7 +526338,7 @@ ${getTmuxInstallInstructions2()}
       }
       try {
         const filePath = resolve40(options2.appendSystemPromptFile);
-        appendSystemPrompt = readFileSync10(filePath, "utf8");
+        appendSystemPrompt = readFileSync11(filePath, "utf8");
       } catch (error41) {
         const code = getErrnoCode(error41);
         if (code === "ENOENT") {
@@ -527424,7 +527714,7 @@ Usage: orbit --remote "your task description"`, () => gracefulShutdown(1));
         pendingHookMessages
       }, renderAndRun);
     }
-  }).version("0.1.38 (Orbit AI)", "-v, --version", "Output the version number");
+  }).version("0.1.39 (Orbit AI)", "-v, --version", "Output the version number");
   program2.option("-w, --worktree [name]", "Create a new git worktree for this session (optionally specify a name)");
   program2.option("--tmux", "Create a tmux session for the worktree (requires --worktree). Uses iTerm2 native panes when available; use --tmux=classic for traditional tmux.");
   if (canUserConfigureAdvisor()) {
@@ -527946,7 +528236,7 @@ if (false) {}
 async function main2() {
   const args = process.argv.slice(2);
   if (args.length === 1 && (args[0] === "--version" || args[0] === "-v" || args[0] === "-V")) {
-    console.log(`${"0.1.38"} (Orbit AI)`);
+    console.log(`${"0.1.39"} (Orbit AI)`);
     return;
   }
   if (args.includes("--provider")) {
@@ -528054,4 +528344,4 @@ async function main2() {
 }
 main2();
 
-//# debugId=915C704C919EC95E64756E2164756E21
+//# debugId=3DB19D92C131358564756E2164756E21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orbit-code-ai",
-  "version": "0.1.38",
+  "version": "0.1.39",
   "description": "Orbit AI – Your AI-powered IBM ACE coding companion",
   "type": "module",
   "author": "moenawaf",