drafted 1.25.2 → 1.25.3

package/cli/drafted.mjs

@@ -2244,6 +2244,79 @@ async function minionSetEnabled(id, enabled, format) {
   emitMinionResult(format, { status: 'ok', id: c.id, slug: c.slug, name: c.name });
 }
 
+// ── Actions: propose an outward effect and read its decision ─────────────
+// The seam a Causeway automation's approval@1 step uses (Approvals inbox, A5/C4):
+// propose, then poll status until a person decides in the org's Approvals inbox.
+// Approving stays a browser-only act in Drafted; nothing here can approve.
+const actionCmd = program.command('action').description('Propose an outward effect for a person to approve, and read its decision');
+
+function actionState(actions) {
+  const st = (actions || []).map((a) => a.status);
+  if (!st.length) return 'unknown';
+  if (st.every((s) => s === 'proposed')) return 'waiting';
+  if (st.includes('rejected')) return 'rejected';
+  if (st.includes('failed')) return 'failed';
+  if (st.every((s) => s === 'executed')) return 'executed';
+  return 'approved';
+}
+
+async function actionApi(method, apiPath, org, body) {
+  requireLogin();
+  const server = getServerUrl().replace(/\/$/, '');
+  const headers = { ...(org ? { 'X-Drafted-Org': org } : {}), ...(body ? { 'Content-Type': 'application/json' } : {}) };
+  const res = await authFetch(`${server}${apiPath}`, { method, headers, body: body ? JSON.stringify(body) : undefined });
+  const data = await res.json().catch(() => ({}));
+  return { ok: res.ok, status: res.status, data };
+}
+
+actionCmd
+  .command('propose')
+  .description('Propose from JSON {type,payload} or {actions:[{type,payload}...]}, plus optional reason and assignee (an org member email or user id; default you). Reads --file or stdin.')
+  .option('--file <path>', 'JSON file (default: stdin)')
+  .option('--org <org>', 'org (id or slug) to propose in')
+  .option('--format <fmt>', 'output format: json or text', 'text')
+  .action(async (opts) => {
+    let req;
+    try { req = opts.file ? JSON.parse(readFileSync(opts.file, 'utf8')) : readStdinJSON(); }
+    catch { console.error('invalid JSON request'); process.exit(1); }
+    const body = Array.isArray(req.actions) ? { actions: req.actions } : { actions: [{ type: req.type, payload: req.payload || {} }] };
+    if (req.reason) body.reason = String(req.reason);
+    if (req.assignee) body.assignee = String(req.assignee);
+    const r = await actionApi('POST', '/api/actions', opts.org, body);
+    const out = r.ok
+      ? { status: 'ok', groupId: r.data.groupId, url: r.data.receipt && r.data.receipt.url, assignee: r.data.assignee || null }
+      : { status: 'error', error: r.data.detail || r.data.error || `HTTP ${r.status}`, code: r.data.error || null };
+    if (opts.format === 'json') console.log(JSON.stringify(out));
+    else console.log(r.ok ? `${out.groupId}\t${out.url || ''}` : `error\t${out.error}`);
+    if (!r.ok) process.exit(1);
+  });
+
+actionCmd
+  .command('status <groupId>')
+  .description('A proposal\'s decision: waiting, approved, executed, failed or rejected, with who decided and why')
+  .option('--org <org>', 'org (id or slug) it was proposed in')
+  .option('--format <fmt>', 'output format: json or text', 'text')
+  .action(async (groupId, opts) => {
+    const r = await actionApi('GET', `/api/actions/groups/${encodeURIComponent(groupId)}`, opts.org);
+    if (!r.ok) {
+      const out = { status: 'error', error: r.data.detail || r.data.error || `HTTP ${r.status}`, code: r.data.error || null };
+      if (opts.format === 'json') console.log(JSON.stringify(out)); else console.log(`error\t${out.error}`);
+      process.exit(1);
+    }
+    const acts = r.data.actions || [];
+    const out = {
+      status: 'ok',
+      groupId,
+      state: actionState(acts),
+      decidedBy: r.data.decidedBy ? r.data.decidedBy.name : null,
+      note: r.data.decisionNote || null,
+      assignee: r.data.assignee ? r.data.assignee.name : null,
+      steps: acts.map((a) => ({ seq: a.seq, type: a.type, status: a.status, error: (a.result && a.result.error) || null })),
+    };
+    if (opts.format === 'json') console.log(JSON.stringify(out));
+    else console.log(`${out.state}\t${out.decidedBy || ''}\t${out.note || ''}`);
+  });
+
 const minionCmd = program.command('minion').description('Minion management (checklist-driven intake surfaces). Requires the agent allowlist.');
 
 minionCmd

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drafted",
-  "version": "1.25.2",
+  "version": "1.25.3",
   "description": "Drafted — visual thinking surface for humans and AI agents. Renders HTML, markdown, images, and code as frames on a zoomable canvas, with MCP tools for AI agents and real-time sync for humans.",
   "type": "module",
   "bin": {