orbit-code-ai 0.1.5 → 0.1.7

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.7"}${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:59:11.696Z").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.7"
   }, {
     label: "Session name",
     value: nameValue
@@ -470842,7 +470842,7 @@ function WelcomeV2() {
             dimColor: true,
             children: [
               "v",
-              "0.1.5",
+              "0.1.7",
               " "
             ]
           }, undefined, true, undefined, this)
@@ -471042,7 +471042,7 @@ function WelcomeV2() {
           dimColor: true,
           children: [
             "v",
-            "0.1.5",
+            "0.1.7",
             " "
           ]
         }, undefined, true, undefined, this)
@@ -471268,7 +471268,7 @@ function AppleTerminalWelcomeV2(t0) {
         dimColor: true,
         children: [
           "v",
-          "0.1.5",
+          "0.1.7",
           " "
         ]
       }, undefined, true, undefined, this);
@@ -471522,7 +471522,7 @@ function AppleTerminalWelcomeV2(t0) {
       dimColor: true,
       children: [
         "v",
-        "0.1.5",
+        "0.1.7",
         " "
       ]
     }, undefined, true, undefined, this);
@@ -474944,12 +474944,12 @@ ${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
@@ -474958,25 +474958,49 @@ ${readInstructions([
         "components/common-utils.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 APPLICATION to a developer unfamiliar with it. The target may be a
+single file OR a single application/service folder.
+
+## Scope — read ONLY this application's own files
+
+1. **Enumerate files in the TARGET ONLY.** List just the target app folder
+   (e.g. \`Glob\` \`<target>/**/*\`, or \`ls -R <target>\`). **Never \`ls -R\` the whole workspace**
+   and never traverse into sibling projects.
+2. **Read EVERY artifact that belongs to THIS app** — its \`.msgflow\`, \`.esql\`, \`.subflow\`,
+   \`.xsd\`, \`.json\`/Swagger, \`.descriptor\`, and \`.properties\` files. Read them in full.
+3. **Do NOT read shared libraries or other projects — they are OUT OF SCOPE.** Anything under a
+   \`Framework/\`, \`Utils/\`, \`Qiwa/Framework/Lib\`, \`lib/\`, or any sibling application folder is
+   shared infrastructure, NOT part of this app. Do not open those files. When this app references a
+   framework subflow (e.g. \`HTTPRequestAdapter\`, \`InternalServiceCaller\`, \`ErrorHandler\`,
+   \`PropertyReader\`), name it and describe its role from how THIS app wires/uses it plus the
+   common-utils reference above — do not go read the library's source. (This keeps the read small
+   and cheap; the framework is the same across every app.)
+4. Only AFTER reading this app's files, 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 this app's
+**\`.msgflow\`** files (node wiring, routing, which subflows run) and **\`.esql\`** files (the
+transformation and business logic). An explanation derived only from the \`.json\` is incomplete
+and wrong. If you have not read this app's msgflows and ESQL, you have not done the task.
 
 ## 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 +492100,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.7 (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 +492622,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.7"} (Orbit AI)`);
     return;
   }
   if (args.includes("--provider")) {
@@ -492702,4 +492726,4 @@ async function main2() {
 }
 main2();
 
-//# debugId=DE134726E7DCEFCE64756E2164756E21
+//# debugId=AC86378101EC318F64756E2164756E21

package/package.json

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