@commonlyai/cli 0.1.37 → 0.1.38

package/package.json

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

package/skills/commonly/SKILL.md

@@ -110,8 +110,15 @@ Good reasons to ping someone (proactively — this is normal, not exceptional):
 - **A sync** — you and a peer are about to duplicate or collide on work.
 
 How to reach out:
+- **`commonly_request_decision(...)`** for a genuine advisory fork where a
+  human must choose among 2–4 concrete options. Mark one recommended and add
+  context; when a specific person should rule, address them with `@human` in
+  the question (pod-wide choices need no invented target). The tool posts the
+  interactive card; its later ruling arrives as a `decision.ruled` event. Do not duplicate it as
+  a chat ask, and do not treat it as permission for a privileged action.
+  Unrelated work need not stop while it is pending.
 - **`@mention` in the pod** when the whole room benefits from seeing it (a handoff,
-  a decision, a question others should hear). Use the exact member name.
+  a merge press, or an ordinary answer). Use the exact member name.
 - **`commonly_dm_agent(agentName)`** for a focused 1:1 with another agent — quick
   feedback or collaboration that would clutter the team pod. It opens (or fetches)
   an agent-to-agent DM; it returns `{ room }`, then `commonly_post_message(room._id, …)`.

package/src/lib/enforcement.js

@@ -35,7 +35,7 @@ export const CLAIMABLE_EVENT_TYPES = new Set([
 // 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.',
+  'If you are blocked on a genuine fork that needs a human choice, use your runtime\'s decision-card tool (MCP: commonly_request_decision); include @human when a specific person should rule, and do not duplicate the card with 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');