@formigio/fazemos-cli 0.10.15 → 0.10.17

package/dist/index.js

@@ -10,6 +10,7 @@ import { isProjectConnectionUnavailable, renderProjectConnectionUnavailableCopy,
 import { loadYaml, summarize } from './yaml/load.js';
 import { printFindings, printJson } from './yaml/format.js';
 import { validateManifest } from './manifest/checks.js';
+import { findLocalRegistry, resolveRole, buildInboxFile, writeInboxFile, buildNotificationPayload, gitCommitInboxFile, } from './dispatch.js';
 import { execSync } from 'child_process';
 import { readFileSync, readdirSync, writeFileSync, mkdirSync, existsSync, statSync } from 'fs';
 import { fileURLToPath } from 'url';
@@ -5538,14 +5539,57 @@ executions
 // ── My Work ─────────────────────────────────────────────────
 program
     .command('my-work')
-    .description('Show pending work in the active project (or all projects with --all-projects)')
+    .description('Show pending work in the active project (or all projects with --all-projects, or across every org with --all-orgs)')
     .option('--project <slug>', 'Override active project for this call')
     .option('--all-projects', 'Show pending work across every project in the active org', false)
+    .option('-a, --all-orgs', 'Show pending work across every org you are a member of (calls /api/my-work/unified)', false)
+    .option('--json', 'Emit machine-readable JSON', false)
     .action(async (opts) => {
+    // ── F19 — cross-Org unified path ───────────────────────────
+    // When --all-orgs is set, we drop X-Org-Id / X-Fazemos-Project-Id
+    // headers and call the unified endpoint. The endpoint is mounted
+    // BEFORE requireOrgMembership and runs across every Org the caller is
+    // an active member of. See rul_cross_org_auth_no_org_middleware.
+    if (opts.allOrgs) {
+        try {
+            const data = await api('GET', '/api/my-work/unified', undefined, { noProjectHeader: true });
+            if (opts.json) {
+                console.log(JSON.stringify(data, null, 2));
+                return;
+            }
+            // Sage edge case #24: single-Org user with --all-orgs gets a soft
+            // notice + their normal output (no flag-stripping, no error).
+            if (data.meta.orgCount === 1) {
+                console.log(chalk.yellow("--all-orgs has no effect — you're a member of 1 org. Showing your current scope.\n"));
+            }
+            renderUnifiedMyWork(data);
+            return;
+        }
+        catch (err) {
+            // Defensive: 403 NO_ACTIVE_MEMBERSHIP gets a friendly nudge.
+            if (err instanceof ApiError && err.code === 'NO_ACTIVE_MEMBERSHIP') {
+                console.error(chalk.red('No active org memberships.'));
+                console.error(chalk.gray('Ask an admin to add you, or accept a pending invite.'));
+                process.exit(1);
+            }
+            if (err instanceof Error) {
+                console.error(chalk.red(err.message));
+            }
+            else {
+                console.error(chalk.red(String(err)));
+            }
+            process.exit(1);
+        }
+    }
+    // ── Default project-scoped path (unchanged) ─────────────────
     try {
         const data = await api('GET', '/api/my-work', undefined, projectOpts(opts));
         const c = data.commitments;
         const total = c.overdue.length + c.due_today.length + c.due_this_week.length + c.upcoming.length;
+        if (opts.json) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
         console.log(chalk.cyan(`Commitments: ${total}`));
         if (c.overdue.length)
             console.log(chalk.red(`  Overdue: ${c.overdue.length}`));
@@ -5563,6 +5607,81 @@ program
         handleScopedError(err);
     }
 });
+function renderUnifiedMyWork(data) {
+    if (data.items.length === 0) {
+        console.log(chalk.green("Looking good — across every project, in every org, you're caught up."));
+        return;
+    }
+    const today = new Date().toISOString().slice(0, 10);
+    const truncate = (s, n) => s.length > n ? s.slice(0, n - 1) + '…' : s;
+    // Header
+    const header = [
+        pad('STATUS', 10),
+        pad('TYPE', 9),
+        pad('TITLE', 36),
+        pad('ORG', 5),
+        pad('PROJ', 5),
+        'DUE',
+    ].join('  ');
+    console.log(chalk.gray(header));
+    console.log(chalk.gray('-'.repeat(80)));
+    for (const item of data.items) {
+        // Status color rules per manifest.cli.changes.
+        let statusLabel;
+        if (item.dueDate && item.dueDate < today) {
+            statusLabel = chalk.red('overdue');
+        }
+        else if (item.dueDate === today) {
+            statusLabel = chalk.yellow('today');
+        }
+        else {
+            statusLabel = item.status;
+        }
+        const row = [
+            pad(statusLabel, 10),
+            pad(item.type, 9),
+            pad(truncate(item.title, 36), 36),
+            pad(`[${computeAbbreviation(item.org.name)}]`, 5),
+            pad(`[${computeAbbreviation(item.project.name)}]`, 5),
+            item.dueDate ?? '—',
+        ].join('  ');
+        console.log(row);
+    }
+    // Footer
+    const shown = data.items.length;
+    const total = data.meta.typeCounts.commitment +
+        data.meta.typeCounts.action +
+        data.meta.typeCounts.worksheet +
+        data.meta.typeCounts.check_in +
+        data.meta.typeCounts.pipeline_step;
+    console.log('');
+    console.log(chalk.gray(`Showing ${shown} of ${total}.` +
+        (data.nextCursor ? ' More available — re-run with --cursor=<next>.' : '')));
+    console.log(chalk.gray(`Tip: fazemos my-work (no flag) shows just the active project.`));
+}
+/**
+ * 2-letter abbreviation: first letter of first word + first letter of next
+ * word, or first 2 letters of the only word if no second word exists.
+ * Duplicates the helper used in fazemos-web (ProjectBadge.tsx) per
+ * manifest.cli.shared_helpers — "don't block on packaging."
+ */
+function computeAbbreviation(name) {
+    const cleaned = name.trim();
+    if (!cleaned)
+        return '??';
+    const words = cleaned.split(/\s+/);
+    if (words.length === 1) {
+        return words[0].slice(0, 2).toUpperCase();
+    }
+    return (words[0][0] + words[1][0]).toUpperCase();
+}
+function pad(s, width) {
+    // Strip ANSI escape codes for length measurement so colored cells line up.
+    const visible = s.replace(/\u001b\[[0-9;]*m/g, '');
+    if (visible.length >= width)
+        return s;
+    return s + ' '.repeat(width - visible.length);
+}
 // ── Test ────────────────────────────────────────────────────
 program
     .command('test')
@@ -8052,6 +8171,151 @@ Examples:
     if (summary.errors > 0)
         process.exit(1);
 });
+// ── `fazemos dispatch` — role-to-role dispatch ─────────────────────
+//
+// Writes an inbox markdown file in the recipient role's operating dir and
+// calls POST /api/notifications/dispatch so the API can fire any
+// configured human-filler notifications (Slack today).
+//
+// Recipients are resolved via `.fazemos/roles.json` walked up from cwd.
+// Cross-workspace roles are followed via the local registry's
+// `cross_workspace_roles` block.
+//
+// Example:
+//   fazemos dispatch founder question --from business-strategist \
+//     --body "Should we ship F19 before F7?" --priority high --commit
+program
+    .command('dispatch <to> <type>')
+    .description(`Write an inbox markdown file in <to>'s operating dir and (optionally) fire
+notifications via the API.
+
+Recipients are resolved via the nearest .fazemos/roles.json registry, walking
+up from the current directory. Cross-workspace recipients are followed via
+the local registry's cross_workspace_roles block.
+
+Types: question | task | signal | response | flag | decision | direction`)
+    .requiredOption('--from <role>', 'sender role-slug (required)')
+    .option('--body <text>', 'markdown body of the dispatch (or use --body-file)')
+    .option('--body-file <path>', 'read body from a file')
+    .option('--priority <level>', 'low | normal | high', 'normal')
+    .option('--re <ref>', 'optional reference (worksheet id, file path, etc.)')
+    .option('--thread <id>', 'optional prior item id this responds to')
+    .option('--expires-at <iso>', 'optional deadline (ISO 8601)')
+    .option('--commit', 'git add + commit the inbox file after writing')
+    .option('--no-notify', 'skip the API notification call (file-only)')
+    .action(async (to, type, opts) => {
+    try {
+        // Validate type
+        const allowedTypes = ['question', 'task', 'signal', 'response', 'flag', 'decision', 'direction'];
+        if (!allowedTypes.includes(type)) {
+            throw new Error(`Invalid type "${type}". Allowed: ${allowedTypes.join(', ')}`);
+        }
+        // Resolve body
+        let body = opts.body;
+        if (!body && opts.bodyFile) {
+            body = readFileSync(opts.bodyFile, 'utf-8').trim();
+        }
+        if (!body) {
+            throw new Error('--body or --body-file is required');
+        }
+        // Find local registry
+        const localRegistry = findLocalRegistry(process.cwd());
+        if (!localRegistry) {
+            throw new Error(`No .fazemos/roles.json found in cwd or any parent. ` +
+                `Run from inside a Fazemos-aware workspace.`);
+        }
+        // Resolve recipient
+        const resolved = resolveRole(to, localRegistry);
+        if (!resolved) {
+            throw new Error(`Role "${to}" not found in local registry or any cross-workspace ref. ` +
+                `Check .fazemos/roles.json.`);
+        }
+        const { role, registry } = resolved;
+        const input = {
+            to,
+            from: opts.from,
+            type: type,
+            priority: (opts.priority ?? 'normal'),
+            body,
+            re: opts.re,
+            thread: opts.thread,
+            expiresAt: opts.expiresAt,
+        };
+        // Build + write file
+        const { filename, content, summary } = buildInboxFile(input);
+        const fullPath = writeInboxFile(registry._workspaceRoot, role, filename, content);
+        const relPath = fullPath.startsWith(registry._workspaceRoot)
+            ? fullPath.slice(registry._workspaceRoot.length + 1)
+            : fullPath;
+        console.log(chalk.green(`✓ Wrote inbox file:`));
+        console.log(`  ${chalk.cyan(fullPath)}`);
+        console.log(`  Workspace: ${registry.workspace}  Filler: ${role.filler.identity} (${role.filler.type})`);
+        // Notify (unless --no-notify)
+        if (opts.notify !== false) {
+            try {
+                const payload = buildNotificationPayload(input, role, relPath, summary);
+                const resp = await api('POST', '/api/notifications/dispatch', payload);
+                if (resp.notified) {
+                    console.log(chalk.green(`✓ Notification fired: ${resp.channel}`));
+                }
+                else {
+                    console.log(chalk.gray(`  (no notification fired — ${resp.reason ?? 'unknown'})`));
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.log(chalk.yellow(`  warning: notification call failed — ${msg}`));
+                console.log(chalk.yellow(`  (inbox file was still written successfully)`));
+            }
+        }
+        else {
+            console.log(chalk.gray('  (--no-notify; API not called)'));
+        }
+        // Commit if requested
+        if (opts.commit) {
+            try {
+                gitCommitInboxFile(registry._workspaceRoot, relPath, `dispatch(${opts.from} → ${to}): ${type}`);
+                console.log(chalk.green('✓ Committed.'));
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.log(chalk.yellow(`  warning: commit failed — ${msg}`));
+            }
+        }
+    }
+    catch (err) {
+        console.error(chalk.red(err instanceof Error ? err.message : String(err)));
+        process.exit(1);
+    }
+});
+program
+    .command('dispatch-list-roles')
+    .description('List roles available in the nearest .fazemos/roles.json registry')
+    .action(() => {
+    const reg = findLocalRegistry(process.cwd());
+    if (!reg) {
+        console.error(chalk.red('No .fazemos/roles.json found in cwd or any parent.'));
+        process.exit(1);
+    }
+    console.log(chalk.cyan(`Registry: ${reg._registryPath}`));
+    console.log(chalk.cyan(`Workspace: ${reg.workspace}  Org: ${reg.org}${reg.project ? '  Project: ' + reg.project : ''}`));
+    console.log();
+    console.log(chalk.bold('Local roles:'));
+    for (const [slug, role] of Object.entries(reg.roles)) {
+        const fillerTag = role.filler.type === 'human'
+            ? chalk.yellow(`${role.filler.identity} (human)`)
+            : chalk.gray(`${role.filler.identity} (agent)`);
+        const notifyTag = role.notification ? chalk.green(' [notify]') : '';
+        console.log(`  ${chalk.cyan(slug.padEnd(32))} ${fillerTag}${notifyTag}`);
+    }
+    if (reg.cross_workspace_roles) {
+        console.log();
+        console.log(chalk.bold('Cross-workspace roles:'));
+        for (const [slug, xref] of Object.entries(reg.cross_workspace_roles)) {
+            console.log(`  ${chalk.cyan(slug.padEnd(32))} → ${xref.workspace_path}`);
+        }
+    }
+});
 // Skip auto-parse only when running under Vitest (which sets process.env.VITEST).
 // Tests import `program` and drive it via `program.parseAsync(...)` after mocking
 // `./api.js`. In every other context — direct invocation, npx tsx, OR the bin