orbit-code-ai 0.1.5 → 0.1.6

package/dist/cli.mjs

@@ -83712,7 +83712,7 @@ 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-ai ${RESET}${rgb(...ACCENT)}v${"0.1.5"}${RESET}`);
+  out.push(`  ${DIM}${rgb(...DIMCOL)}orbit-ai ${RESET}${rgb(...ACCENT)}v${"0.1.6"}${RESET}`);
   out.push("");
   process.stdout.write(out.join(`
 `) + `
@@ -334183,7 +334183,7 @@ function getAnthropicEnvMetadata() {
 function getBuildAgeMinutes() {
   if (false)
     ;
-  const buildTime = new Date("2026-06-23T09:09:31.460Z").getTime();
+  const buildTime = new Date("2026-06-23T11:43:54.224Z").getTime();
   if (isNaN(buildTime))
     return;
   return Math.floor((Date.now() - buildTime) / 60000);
@@ -358600,7 +358600,7 @@ function buildPrimarySection() {
   }, undefined, false, undefined, this);
   return [{
     label: "Version",
-    value: "0.1.5"
+    value: "0.1.6"
   }, {
     label: "Session name",
     value: nameValue
@@ -470842,7 +470842,7 @@ function WelcomeV2() {
             dimColor: true,
             children: [
               "v",
-              "0.1.5",
+              "0.1.6",
               " "
             ]
           }, undefined, true, undefined, this)
@@ -471042,7 +471042,7 @@ function WelcomeV2() {
           dimColor: true,
           children: [
             "v",
-            "0.1.5",
+            "0.1.6",
             " "
           ]
         }, undefined, true, undefined, this)
@@ -471268,7 +471268,7 @@ function AppleTerminalWelcomeV2(t0) {
         dimColor: true,
         children: [
           "v",
-          "0.1.5",
+          "0.1.6",
           " "
         ]
       }, undefined, true, undefined, this);
@@ -471522,7 +471522,7 @@ function AppleTerminalWelcomeV2(t0) {
       dimColor: true,
       children: [
         "v",
-        "0.1.5",
+        "0.1.6",
         " "
       ]
     }, undefined, true, undefined, this);
@@ -474944,39 +474944,57 @@ ${args || "Review the entire ACE project in the current working directory only.
   });
   registerBundledSkill({
     name: "ace-explain",
-    description: "Explain an IBM ACE flow or ESQL module in plain language — what it does, how it works, its role in the integration flow",
+    description: "Explain an IBM ACE flow, ESQL module, OR an entire application/service in plain language — what it does, how it works, and its role in the integration. Reads ALL artifacts (msgflows, ESQL, XSD, Swagger) before explaining, never just the Swagger.",
     aliases: ["ace-doc"],
-    model: "gemini-3.1-flash-lite",
-    whenToUse: "When the user wants to understand what an ACE flow or ESQL module does, needs documentation, or wants an end-to-end walkthrough",
-    argumentHint: "<file to explain>",
-    allowedTools: ["Read", "Glob", "Grep"],
+    model: "gemini-3.5-flash",
+    whenToUse: 'When the user wants to understand, summarize, document, or walk through what an ACE flow, ESQL module, application, service, or project does — including requests like "what does this app do" or "explain this service"',
+    argumentHint: "<file, app folder, or service to explain>",
+    allowedTools: ["Read", "Glob", "Grep", "Bash"],
     userInvocable: true,
     async getPromptForCommand(args) {
       const prompt = `# ACE Code Explanation
 
 ${readInstructions([
-        "components/common-utils.md"
+        "components/common-utils.md",
+        "msgflow-xml-reference.md"
       ])}
 
-Read the relevant file(s) and explain the code clearly to a developer who is unfamiliar with it. Use the common-utils reference to identify framework function calls and constants. Cover its role in the overall integration flow.
+You must explain the target to a developer unfamiliar with it. The target may be a single
+file OR an entire application/service folder.
+
+## MANDATORY procedure — do this before writing ANY explanation
+
+1. **Enumerate every file** in the target. If it is a folder, list the whole tree
+   (e.g. \`Glob\` with \`**/*\` under the target, or \`ls -R\`). Do not assume the file set.
+2. **Read EVERY artifact** — every \`.msgflow\`, \`.esql\`, \`.xsd\`, \`.json\`/Swagger,
+   \`.subflow\`, \`.descriptor\`, and \`.properties\` file. Read them in full, not just one.
+3. Only AFTER you have read all of them, write the explanation.
+
+⚠️ **The Swagger/JSON is NOT enough.** It only describes the request/response *contract* —
+it tells you nothing about what the service actually does. The real behavior lives in the
+**\`.msgflow\`** files (node wiring, routing, which subflows run) and the **\`.esql\`** files
+(the transformation and business logic). An explanation derived only from the \`.json\` is
+incomplete and wrong. If you have not read the msgflows and ESQL, you have not done the task.
+Use the msgflow XML reference above to decode the \`.msgflow\` node/connection structure.
 
 ## What to Cover
 
-1. **Purpose:** What does this flow/module do in one sentence?
-2. **End-to-end walkthrough:** Trace the message path from input to output, including all nodes and connections
+1. **Purpose:** What does this app/flow/module do, in one sentence?
+2. **End-to-end walkthrough:** Trace the message path from input to output across the flows —
+   every node, subflow, and connection (read from the .msgflow files, not inferred).
 3. **Message domains:** What parser domains are used (XMLNSC, JSON, SOAP, etc.)?
-4. **Key transformations:** What does the ESQL do to the message tree? What fields are mapped?
-5. **Error handling:** How are errors caught and routed? Which terminals are wired to error handlers?
-6. **External dependencies:** Database calls (stored procedures), SOAP/REST backend calls, queue names
-7. **Framework usage:** Which Qiwa framework subflows are used and why?
-8. **State management:** How is Environment.Variables used for intermediate state?
-9. **Non-obvious design decisions:** Anything a new developer might find confusing
+4. **Key transformations:** What the ESQL does to the message tree; which fields are mapped.
+5. **Error handling:** How errors are caught and routed; which terminals wire to error handlers.
+6. **External dependencies:** DB calls (stored procedures), SOAP/REST backends, queue names.
+7. **Framework usage:** Which Qiwa framework subflows are used and why.
+8. **State management:** How Environment.Variables carries intermediate state.
+9. **Non-obvious design decisions:** Anything a new developer might find confusing.
 
-Use plain language. Assume the reader knows basic integration concepts but not this specific service.
+Use plain language. Assume the reader knows basic integration concepts but not this service.
 
 ## Target
 
-${args || "The user did not specify a file. Ask them which flow or ESQL module they want explained, or offer to give an overview of the entire project."}`;
+${args || "The user did not specify a target. Ask which file, application folder, or service they want explained."}`;
       return [{ type: "text", text: prompt }];
     }
   });
@@ -492076,7 +492094,7 @@ Usage: orbitcode --remote "your task description"`, () => gracefulShutdown(1));
         pendingHookMessages
       }, renderAndRun);
     }
-  }).version("0.1.5 (Orbit AI)", "-v, --version", "Output the version number");
+  }).version("0.1.6 (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()) {
@@ -492598,7 +492616,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.5"} (Orbit AI)`);
+    console.log(`${"0.1.6"} (Orbit AI)`);
     return;
   }
   if (args.includes("--provider")) {
@@ -492702,4 +492720,4 @@ async function main2() {
 }
 main2();
 
-//# debugId=DE134726E7DCEFCE64756E2164756E21
+//# debugId=412536CBF4AF9C5064756E2164756E21

package/package.json

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