octwin-cli 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -5,6 +5,35 @@ Format: [Keep a Changelog](https://keepachangelog.com/) — newest first, bucket
 **Added · Changed · Deprecated · Removed · Fixed · Security**. The platform-wide view lives in the
 repo root [`CHANGELOG.md`](../../CHANGELOG.md); this file is the CLI-only cut that ships with the package.
 
+## [0.7.2] - 2026-08-20
+
+### Fixed
+- **`octwin feedback` now tells you what is already waiting, on stdout.** It discarded the submit
+  response entirely — destructuring `{ status, json }`, checking the status and never reading the
+  body — then printed *"a reply arrives as a memo, this CLI will tell you when one is waiting"*. The
+  platform started returning the unread counts on that response (2026-08-20), so the answer was
+  there to print and was being thrown away.
+  **Why it matters more than it sounds:** `notifyIfMemosWaiting` already covers this command and was
+  firing correctly — but it writes to **stderr**, and the authors driving this CLI are agents reading
+  stdout. The one signal that mattered was addressed to a channel nobody was listening on. On
+  2026-08-19 an author submitted two reports two hours after three replies were published and
+  re-reported five findings those replies had already closed. Now the count prints in the same block
+  as the acknowledgement, naming the command, and says outright when a reply may already answer what
+  you just sent. Against an older platform the field is absent and the previous line stands.
+
+## [0.7.1] - 2026-08-19
+
+### Fixed
+- **`work decide` now says when an action moves nothing.** `to_stage` is optional — an action may
+  record a decision without a transition — but both outputs communicated that by omission: `--dry-run`
+  left `to_stage: null` sitting among twenty other keys, and a real apply printed a bare
+  `✓ Applied '<action>'`. An author read both, shipped `request_more_info` with no `to_stage`, and
+  lost the `awaiting_customer` their whole customer-reply capture branched on — their words: *"Nothing
+  about this failed loudly; it just quietly never did the one thing the whole feature depends on."*
+  The preview now states `→ does NOT change the status (this action only records a decision)` and the
+  apply says `status unchanged (the action declares no to_stage)`. The console's decision panel got the
+  same sentence in the same change.
+
 ## [0.7.0] - 2026-08-18
 
 ### Added

package/dist/index.js

@@ -1959,11 +1959,11 @@ async function cmdRecordsWrite(flags) {
         if (json?.has_xrm === false)
             die('this pack declares no XRM entities');
         const rec = json?.record ?? {};
-        // 200 = the dedupe key matched an existing row; 201 = genuinely new. Saying
-        // "created" for a match would misreport what the pack's `dedupe_by` did.
+        // 200 = the entity's identity matched an existing row; 201 = genuinely new.
+        // Saying "created" for a match would misreport what the save actually did.
         console.log(status === 201
             ? `✓ Created #${rec.record_number ?? '?'}  ${rec.id ?? ''}`
-            : `✓ Matched an EXISTING record (the entity's dedupe key hit) — #${rec.record_number ?? '?'}  ${rec.id ?? ''}`);
+            : `✓ Matched an EXISTING record (its unique constraint identified it) — #${rec.record_number ?? '?'}  ${rec.id ?? ''}`);
         if (rec.id)
             readBack(rec.id);
         return;
@@ -2109,7 +2109,33 @@ async function cmdFeedback(flags) {
         console.log('  ⓘ no local capability reference found, so the report carries no KB version.');
         console.log('    Pull it before your next session: octwin platform-kb');
     }
-    console.log('  A reply arrives as a memo — this CLI will tell you when one is waiting.');
+    // WHAT IS ALREADY WAITING, said here rather than promised for later.
+    //
+    // The submit response carries the same counts `notifyIfMemosWaiting` polls. That nudge
+    // fires on this command too — but it writes to STDERR, and the authors driving this CLI
+    // are agents reading stdout, so the one signal that mattered was addressed to a channel
+    // nobody was listening on. On 2026-08-19 an author sent two reports two hours after
+    // three replies were published and re-reported five already-fixed findings; the nudge
+    // had run correctly both times.
+    //
+    // So it goes on STDOUT, at the moment they are certainly reading, in the same block as
+    // the acknowledgement. `memos` is absent against an older platform — then the old line
+    // stands, which is the honest thing to say when we cannot know.
+    const memos = json?.memos;
+    const unread = Number(memos?.unread ?? 0);
+    const actionable = Number(memos?.unread_actionable ?? 0);
+    if (Number.isFinite(unread) && unread > 0) {
+        const what = unread === 1 ? '1 reply is' : `${unread} replies are`;
+        const tail = Number.isFinite(actionable) && actionable > 0 ? ` (${actionable} needing action)` : '';
+        console.log(`  ✉ ${what} already waiting for you${tail} — read them BEFORE your next change: octwin memos`);
+        if (actionable > 0) {
+            // The severity axis exists so an agent mid-build stops instead of finishing first.
+            console.log('    One or more may already answer what you just reported.');
+        }
+    }
+    else {
+        console.log('  A reply arrives as a memo — this CLI will tell you when one is waiting.');
+    }
 }
 /**
  * `octwin memos [--json] [--all]` — read what the platform has told you.
@@ -2747,10 +2773,17 @@ async function cmdWorkWrite(flags) {
     }
     if (dryRun) {
         console.log('Preview (nothing was committed):');
+        // Stated in words BEFORE the dump. `to_stage: null` is already in the JSON below, but a null
+        // among twenty keys is not an answer anyone reads — a pack author previewed exactly this,
+        // shipped an action with no `to_stage`, and lost the `awaiting_customer` their whole
+        // reply-capture branched on. Same reason the console preview now says it too.
+        console.log(json?.to_stage
+            ? `  → moves the record to '${json.to_stage}'.`
+            : '  → does NOT change the status (this action only records a decision).');
         console.log(JSON.stringify(json, null, 2));
         return;
     }
-    console.log(`✓ Applied '${action}'${json?.to_stage ? ` — record is now '${json.to_stage}'` : ''}.`);
+    console.log(`✓ Applied '${action}'${json?.to_stage ? ` — record is now '${json.to_stage}'` : ' — status unchanged (the action declares no to_stage)'}.`);
     // `relayed`/`notified` are the customer-facing half; silence here usually means
     // the action had no message template, which is easy to mistake for a failure.
     const reached = json?.relayed || json?.notified;

package/package.json

@@ -1,37 +1,46 @@
-{
-  "name": "octwin-cli",
-  "version": "0.7.0",
-  "description": "Octwin external-pack developer CLI (by CEQUENS) — scaffold, validate, deploy, and check pure-YAML packs on your tenant.",
-  "type": "module",
-  "bin": {
-    "octwin": "dist/index.js"
-  },
-  "files": [
-    "dist",
-    "templates",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "engines": {
-    "node": ">=22"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepublishOnly": "npm run build"
-  },
-  "dependencies": {
-    "yaml": "^2.6.0"
-  },
-  "devDependencies": {
-    "@types/node": "^22.0.0",
-    "typescript": "^5.7.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": ["octwin", "cequens", "cli", "whatsapp", "chatbot", "pack", "conversational-ai", "yaml"],
-  "author": "CEQUENS",
-  "homepage": "https://www.npmjs.com/package/octwin-cli",
-  "license": "MIT"
-}
+{
+  "name": "octwin-cli",
+  "version": "0.7.2",
+  "description": "Octwin external-pack developer CLI (by CEQUENS) — scaffold, validate, deploy, and check pure-YAML packs on your tenant.",
+  "type": "module",
+  "bin": {
+    "octwin": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "yaml": "^2.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "octwin",
+    "cequens",
+    "cli",
+    "whatsapp",
+    "chatbot",
+    "pack",
+    "conversational-ai",
+    "yaml"
+  ],
+  "author": "CEQUENS",
+  "homepage": "https://www.npmjs.com/package/octwin-cli",
+  "license": "MIT"
+}