@commonlyai/cli 0.1.34 → 0.1.35

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commonlyai/cli",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "license": "Apache-2.0",
   "description": "The Commonly CLI — connect agents, manage pods, iterate fast",
   "type": "module",

package/src/commands/agent.js

@@ -50,6 +50,7 @@ import {
   createClaimHandicap,
   createClaimKeeper,
   deliverChatReply,
+  frameDecisionForkRule,
   peerHoldsFrame,
   resolveCascadeSettings,
 } from '../lib/enforcement.js';
@@ -694,6 +695,18 @@ const extractPrompt = (event) => {
       'Only post a concise pod update if a human needs it; otherwise return NO_REPLY.',
     ].join('\n');
   }
+  if (event.type === 'decision.ruled') {
+    if (!p.decisionId || !p.pick || !p.ruledAt) return null;
+    const ruler = p.ruledBy?.username || 'A human';
+    return [
+      '[Decision ruled]',
+      `${ruler} chose: ${String(p.pick)}`,
+      `Decision: ${String(p.decisionId)}`,
+      `Ruled at: ${String(p.ruledAt)}`,
+      '',
+      'Continue with this ruling. Post a concise update only if it materially helps the pod; otherwise return NO_REPLY.',
+    ].join('\n');
+  }
   return null;
 };
 
@@ -1050,7 +1063,7 @@ export const performRun = ({
     const memoryLongTerm = await readLongTerm(client, { onError });
 
     log(`[${event.type}] spawning ${adapter.name}`);
-    const result = await adapter.spawn(prompt, {
+    const result = await adapter.spawn(frameDecisionForkRule(prompt), {
       sessionId,
       cwd: agentCwd,
       env: process.env,

package/src/lib/enforcement.js

@@ -28,6 +28,20 @@ export const CLAIMABLE_EVENT_TYPES = new Set([
   'dm.message',
 ]);
 
+// A decision card is the durable path for a real human choice. This lives in
+// wrapper enforcement, rather than only in the MCP tool description, because
+// a task-shaped prompt can otherwise make an agent phrase the same fork as a
+// prose @ask. The rule is framing, not a classifier: the agent still judges
+// whether the work genuinely cannot continue without a human ruling.
+export const DECISION_FORK_FRAME = [
+  '[Decision forks]',
+  'If you are blocked on a genuine fork that needs a human choice, call commonly_request_decision; do not post a prose @ask.',
+  'Use it only when you cannot safely continue before a ruling. Give 2–4 concrete options and mark one recommendation.',
+  'Use ordinary pod messages for status, factual questions, and coordination that do not require a human choice.',
+].join('\n');
+
+export const frameDecisionForkRule = (prompt) => `${DECISION_FORK_FRAME}\n\n${prompt}`;
+
 // ── trigger classification ──────────────────────────────────────────────────
 
 /**