octwin-cli 0.1.11 → 0.1.12

package/CHANGELOG.md

@@ -5,6 +5,22 @@ 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.1.12] - 2026-07-22
+
+### Fixed
+- **The KB-drift nudge now fires after `chat` too.** `chat` — the command a debugging session runs most —
+  was missing from the networked-command list, so a chat-heavy session never noticed the platform's
+  capability reference had moved. The nudge also now shows the concrete drift
+  (`old-hash → new-hash`) so you can see it's real, not a heuristic.
+
+### Changed
+- **Every networked command announces what it's doing before it does it.** `chat` prints
+  `→ Connecting to <tenant>/<project> as '<handle>' …` before opening the stream and
+  `… delivered — waiting for the reply (up to Ns)` after the send; `status` / `whoami` /
+  `platform-kb` / `records` / `logs` / `cases` each print a one-line `→ …` header naming the
+  action and target before the first network call — no more silent seconds followed by a result
+  (or a hang with no clue what was being attempted). JSON modes (`--json`) stay clean for piping.
+
 ## [0.1.11] - 2026-07-21
 
 ### Fixed

package/dist/index.js

@@ -282,20 +282,22 @@ async function notifyIfKbStale(flags) {
             return;
         const meta = await res.json();
         if (meta.content_hash && meta.content_hash !== localHash) {
-            console.error('\n⬆ the platform capability reference changed since you last pulled it.');
-            console.error('  Refresh it: octwin platform-kb pull');
+            console.error(`\n⬆ the platform capability reference changed since you last pulled it (${localHash} → ${meta.content_hash}).`);
+            console.error('  Refresh it: octwin platform-kb');
         }
     }
     catch { /* a KB check must never break the CLI */ }
 }
-/** Which commands already made an authed platform call, so the trailing KB-drift
- *  poll rides on existing network work (never on offline `validate` / `init`). */
+/** Which commands already made a platform call, so the trailing KB-drift poll
+ *  rides on existing network work (never on offline `validate` / `init`;
+ *  `platform-kb` refreshes the reference itself, so it needs no nudge). */
 function commandTouchesPlatform(command, flags) {
     switch (command) {
         case 'validate': return flags.remote === true; // offline validate stays offline
         case 'deploy':
         case 'status':
         case 'test':
+        case 'chat':
         case 'records':
         case 'cases':
         case 'logs':
@@ -448,6 +450,7 @@ function resolveTargetOrNull(flags, packDir) {
 async function cmdWhoami(flags) {
     const packDir = resolve(flags.dir ?? '.');
     const { url, tenant, token } = resolveTarget(flags, packDir);
+    console.log(`→ Checking the saved token against '${tenant}' @ ${url} …`);
     const res = await fetchOrDie(`${url}/api/admin/tenants/${tenant}/packs`, { headers: { authorization: `Bearer ${token}` } }, 'token check');
     if (res.ok) {
         console.log(`✓ Token valid for tenant '${tenant}' at ${url} (${token.startsWith('oct_') ? 'deploy token' : 'session token'})`);
@@ -570,6 +573,7 @@ async function cmdStatus(flags) {
         die('manifest.yaml must declare a string `id`');
     const id = doc.id;
     const localVersion = typeof doc?.version === 'string' ? doc.version : '?';
+    console.log(`→ Checking ${id}@${localVersion} on ${tenant}/${project} @ ${url} …`);
     const res = await fetchOrDie(`${url}/api/admin/tenants/${tenant}/projects/${project}/packs/${id}/runtime`, {
         headers: { authorization: `Bearer ${token}` },
     }, 'status check');
@@ -609,6 +613,7 @@ async function cmdStatus(flags) {
 async function cmdPlatformKb(flags) {
     const packDir = resolve(flags.dir ?? '.');
     const { url, tenant, token } = resolveTarget(flags, packDir);
+    console.log(`→ Pulling the platform capability reference from '${tenant}' @ ${url} …`);
     const res = await fetchOrDie(`${url}/api/admin/tenants/${tenant}/octwin-platform-kb`, {
         headers: { authorization: `Bearer ${token}` },
     }, 'platform-kb pull');
@@ -674,6 +679,7 @@ async function cmdRecords(flags) {
     const base = `${url}/api/admin/tenants/${tenant}/projects/${project}`;
     const entity = flags._[0];
     const recordId = flags._[1];
+    console.log(`→ Reading ${recordId ? `${entity} record ${recordId}` : entity ? `${entity} records` : 'the entity catalog'} from ${tenant}/${project} …`);
     if (!entity) {
         const { status, json } = await apiGet(`${base}/xrm/entities`, token);
         if (status !== 200)
@@ -734,6 +740,8 @@ async function cmdLogs(flags) {
     const convId = flags._[0];
     const asJson = flags.json === true;
     const asHandle = typeof flags.as === 'string' ? flags.as : undefined;
+    if (!asJson)
+        console.log(`→ Reading ${convId ? `conversation ${convId}` : 'recent conversations'} from ${tenant}/${project} …`);
     if (!convId) {
         const { status, json } = await apiGet(`${base}/conversations?limit=50`, token);
         if (status !== 200)
@@ -928,6 +936,8 @@ async function cmdChat(flags) {
         die('usage: octwin chat "your message" [--as <handle>] [--tap <tap-id>] [--json]');
     // Fresh idempotency key per call (see the command doc above).
     const localId = `cli-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+    if (!asJson)
+        console.log(`→ Connecting to ${tenant}/${project} as '${from}' …`);
     const evRes = await fetchOrDie(`${url}/api/web/events/${tenant}/${project}/${encodeURIComponent(from)}`, { headers: { accept: 'text/event-stream' } }, 'open chat stream');
     if (!evRes.ok || !evRes.body)
         die(`could not open chat stream (HTTP ${evRes.status})`);
@@ -961,6 +971,8 @@ async function cmdChat(flags) {
         await cancel();
         die(`send rejected (HTTP ${postRes.status}): ${await postRes.text()}`);
     }
+    if (!asJson)
+        console.log(`  … delivered — waiting for the reply (up to ${Math.round(REPLY_TIMEOUT_MS / 1000)}s)`);
     // Phase 3 — collect THIS turn's renders (id > boundary). A turn can send
     // several messages, so keep reading until a quiet gap after the last render.
     const deadline = Date.now() + REPLY_TIMEOUT_MS;
@@ -1007,6 +1019,8 @@ async function cmdCases(flags) {
     const base = `${url}/api/admin/tenants/${tenant}/projects/${project}`;
     const caseId = flags._[0];
     const asJson = flags.json === true;
+    if (!asJson)
+        console.log(`→ Reading ${flags.queues === true ? 'case queues' : caseId ? `case ${caseId}` : 'the case inbox'} from ${tenant}/${project} …`);
     const caseFail = (what, status, json) => {
         if (status === 403)
             die(`forbidden — casework needs the 'cases' plan feature on this tenant, and a role whose grants reach the queue`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octwin-cli",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "Octwin external-pack developer CLI (by CEQUENS) — scaffold, validate, deploy, and check pure-YAML packs on your tenant.",
   "type": "module",
   "bin": {