@productbrain/cli 0.1.0-beta.14 → 0.1.0-beta.14010

package/dist/registerEntryCommands.js

@@ -0,0 +1,146 @@
+import { runCapture } from './commands/capture.js';
+import { runEntryAccept } from './commands/entryAccept.js';
+import { runEntryDiscard, runEntryResolve } from './commands/entryDiscardResolve.js';
+import { runEntryOwn } from './commands/entryOwn.js';
+import { runEntryReplace } from './commands/entryReplace.js';
+import { runEntryPreflight } from './commands/entryPreflight.js';
+import { runEntryTick } from './commands/entryTick.js';
+import { runRelate, runUnrelate } from './commands/relate.js';
+import { SPINE_RUNG_LINES } from './lib/checklist.js';
+import { ENTRY_BODY_HELP, ENTRY_NAME_HELP } from './lib/limits.js';
+/** TASK-1026 (WP-862, RULE-664): the spine's links, worded once by rungLine, printed under relate and preflight help. */
+const SPINE_LINKS_HELP = `\nEach level links to the one above:\n${SPINE_RUNG_LINES.map((line) => `  ${line}`).join('\n')}\n`;
+export function registerEntryCommands(program) {
+    const entryCmd = program
+        .command('entry')
+        .description('Entry-lifecycle commands (propose | accept | replace | discard | resolve | tick)');
+    entryCmd
+        .command('preflight')
+        .description('Read structural requirements before composing an entry; saves nothing')
+        .requiredOption('-c, --collection <slug>', 'Collection to inspect')
+        .option('--canonical-key <key>', 'Explicit semantic type')
+        .option('-l, --link <type:entry-id>', 'Selected context (repeatable); e.g. validates:<entry-id>', (value, previous) => [...previous, value], [])
+        .option('-t, --link-type <type>', 'Type for any --link supplied as a bare entry ID')
+        .addHelpText('after', SPINE_LINKS_HELP)
+        .action(runEntryPreflight);
+    entryCmd
+        .command('propose [text...]')
+        .description('Propose (capture) a new draft entry — same draft door as `pb capture`')
+        .option('-n, --name <name>', `${ENTRY_NAME_HELP} Left out, it is the first sentence of the text.`)
+        .option('-d, --description <desc>', `${ENTRY_BODY_HELP} Left out, it is the whole text.`)
+        .option('-c, --collection <slug>', 'Explicit collection (skip auto-classification)')
+        .option('-f, --field <key=value>', 'Set a data field (repeatable; checklist: -f doneWhen="a" -f doneWhen="b", one item per flag)', (val, prev) => [...prev, val], [])
+        .option('-l, --link <entry-id>', 'Link to an existing entry by id or name (repeatable; pairs with the -t in the same position)', (val, prev) => [...prev, val], [])
+        .option('-t, --link-type <relation-type>', 'Relation type for the -l in the same position; one per --link, no default', (val, prev) => [...prev, val], [])
+        .option('--source-ref <ref>', 'Source reference URI')
+        .option('--source-excerpt <text>', 'Verbatim source excerpt')
+        .option('--draft', 'Force the entry to draft regardless of workspace governance mode')
+        .option('--json', 'Output machine-readable JSON (deprecated: use global --json flag)')
+        // WP-640 SWEEP (#653 review): `propose` is advertised as the same draft door as
+        // `pb capture` (DEC-1583), but this rung-2 ownership option was never registered or
+        // forwarded here — an ownership-scoped propose hit "unknown option" instead of reaching
+        // runCapture. Mirrors index.ts's `capture` registration exactly.
+        // WP-753 O1b (DEC-1715): --owner-team is deleted — an unnamed create resolves a default
+        // owner itself (the session's acting role, else the nearest Team Lead); --owner-role
+        // survives as the explicit override, its team the one you hold the role in (root first, else the shallowest).
+        .option('--owner-role <entry-id>', 'Existing Role entry ID to create AS OWNER of (you must hold it, and its team is the one you hold it in: root first, else the shallowest)')
+        .option('--team <team-ref>', 'For a role: the team it is born in. For a team: its parent. Defaults to the root team')
+        .action(async (textParts = [], opts) => {
+        const text = textParts.join(' ').trim();
+        if (!text && !opts.name) {
+            entryCmd.commands.find((c) => c.name() === 'propose')?.help();
+            return;
+        }
+        await runCapture({
+            text: text || opts.name || '', name: opts.name, description: opts.description, collection: opts.collection,
+            field: opts.field, link: opts.link, linkType: opts.linkType, sourceRef: opts.sourceRef, sourceExcerpt: opts.sourceExcerpt,
+            draft: opts.draft, json: opts.json,
+            ownerRole: opts.ownerRole, team: opts.team,
+        });
+    });
+    entryCmd
+        .command('accept <entry-ids...>')
+        .description('Accept one or more draft entries onto the Chain. Batch: a single failure does not abort the rest.')
+        .option('-m, --message <text>', 'Note recorded with the accept (applied to every entry in the batch)')
+        .option('--override-reason <text>', 'Why it stands alone, at least 12 characters, or why a text passes after its checklist failed. Your name is kept with it.')
+        .option('--acknowledge <response>', 'Answer why it stands alone: linked | accepted-fix | diverged')
+        .option('--ack-entry <entry-id>', 'Authorizing entry for --acknowledge linked / accepted-fix')
+        .option('--ack-reason <text>', 'Why you diverge, at least 12 characters; required with --acknowledge diverged')
+        .option('--replaces <entry-id>', 'The accepted entry this one replaces: it is archived and what hangs on it moves here')
+        .option('--reason <text>', 'With --replaces: why it is replaced, one line of at most 200 characters (required)')
+        .action(async (entryIds, opts) => {
+        const { message, overrideReason, acknowledge, ackEntry, ackReason, replaces, reason } = opts;
+        await runEntryAccept({ entryIds, message, overrideReason, acknowledge, ackEntry, ackReason, replaces, reason });
+    });
+    // TASK-1095 (DEC-2006): the agent's replace door; the reason is required and the kernel refuses without one.
+    entryCmd
+        .command('replace <old-id> <new-id>')
+        .description('Replace an accepted entry with another accepted one of its kind: the old one is archived and reads Replaced by the new one')
+        .option('--reason <text>', 'Why it is replaced, in one sentence (required)')
+        .action(async (oldEntryId, newEntryId, opts) => {
+        await runEntryReplace({ oldEntryId, newEntryId, reason: opts.reason });
+    });
+    entryCmd
+        .command('discard <entry-id>')
+        .description('Discard a draft or current entry: it moves to the collection\'s Discarded word')
+        .option('--reason <text>', 'Free text recorded in the history note')
+        .option('--note <text>', 'Change note for history')
+        .action(async (entryId, opts) => {
+        await runEntryDiscard({ entryId, reason: opts.reason, note: opts.note });
+    });
+    entryCmd
+        .command('resolve <entry-id>')
+        .description('Resolve a current entry: it moves to the collection\'s Past archive word')
+        .option('--reason <text>', 'Why, recorded in the history note; required to resolve an accepted decision or rule')
+        .option('--note <text>', 'Change note for history')
+        .action(async (entryId, opts) => {
+        await runEntryResolve({ entryId, reason: opts.reason, note: opts.note });
+    });
+    // TASK-382 (WP-770 K4): ticking a Done-when item records who/when and mints no version.
+    entryCmd
+        .command('tick <entry-id> <item-id>')
+        .description('Tick a Done-when item — records who and when, not an edit (the role that owns the record; the Team Lead only when it has no owner)')
+        .option('--undo', 'Untick the item instead')
+        .action(async (entryId, itemId, opts) => {
+        await runEntryTick({ entryId, itemId, undo: opts.undo });
+    });
+    // DEC-1710: the retired `pb organisation work own` re-homed under the entry noun — same
+    // judged door (organisation.setOwnership), no `own`'s `unown` sibling (an entry is never
+    // unowned; reassignment is the only way ownership changes).
+    entryCmd
+        .command('own [entry-id]')
+        .description('Assign an entry to one exact team and role, or move every open item a role owns to another role\n'
+        + 'Example: pb entry own --from-role <role-id> --to-role <role-id> --dry-run')
+        .option('--team <team-id>', 'With an entry id: the team')
+        .option('--role <role-id>', 'With an entry id: the role')
+        .option('--from-role <role-id>', 'Move every open item this role owns, each checked; past items stay as history')
+        .option('--to-role <role-id>', 'With --from-role: the receiving role; without it, the nearest Team Lead of the role\'s home team')
+        .option('--dry-run', 'With --from-role: list the role\'s open items, 200 a page, and change nothing')
+        .option('--page <n>', 'With --dry-run: the page to list, from 1')
+        .action(async (entryId, opts) => {
+        await runEntryOwn(entryId, opts);
+    });
+}
+// --- Relate / Unrelate commands (TEN-704) — moved from index.ts (WP-688 S2a): index.ts is
+// grandfathered shrink-only (STD-2/DEC-1504), and this file already owns the "own every command
+// group in its own file" registrar pattern. `relate`/`unrelate` stay TOP-LEVEL commands (not
+// nested under `entry`) — this is a file-location move for LOC budget, not a DEC-1574 rename.
+export function registerRelateCommands(program) {
+    program
+        .command('relate <from-id> <type> <to-id>')
+        .description('Add a typed relation between two entries (requires active session)')
+        .option('--if-missing', 'Only create relation if it does not already exist')
+        .option('--dry-run', 'Preview the write (advisories, wouldBlock) without creating the relation')
+        .option('--move', 'Move the entry: the new part_of replaces the one it already hangs on, in one write')
+        .addHelpText('after', SPINE_LINKS_HELP)
+        .action(async (fromId, type, toId, opts) => {
+        await runRelate({ fromId, type, toId, ifMissing: opts.ifMissing, dryRun: opts.dryRun, move: opts.move });
+    });
+    program
+        .command('unrelate <from-id> <type> <to-id>')
+        .description('Remove a typed relation between two entries (requires active session)')
+        .action(async (fromId, type, toId) => {
+        await runUnrelate({ fromId, type, toId });
+    });
+}
+//# sourceMappingURL=registerEntryCommands.js.map

package/dist/registerEntryCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerEntryCommands.js","sourceRoot":"","sources":["../src/registerEntryCommands.ts"],"names":[],"mappings":"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"}

package/dist/registerHistoryCommand.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `pb history <entry-id>` — WP-753 V2 (TASK-203). Split out of index.ts (STD-2/DEC-1504:
+ * index.ts is grandfathered over-budget and shrink-only) — same "own every command group in
+ * its own file" split registerEntryCommands.ts already documents.
+ */
+import type { Command } from 'commander';
+export declare function registerHistoryCommand(program: Command): void;
+//# sourceMappingURL=registerHistoryCommand.d.ts.map

package/dist/registerHistoryCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerHistoryCommand.d.ts","sourceRoot":"","sources":["../src/registerHistoryCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAW7D"}

package/dist/registerHistoryCommand.js

@@ -0,0 +1,14 @@
+import { runHistory } from './commands/history.js';
+export function registerHistoryCommand(program) {
+    program
+        .command('history <entry-id>')
+        .description('Published version history (person, role, change note)')
+        .action(async (entryId) => {
+        if (!entryId?.trim()) {
+            program.commands.find((c) => c.name() === 'history')?.help();
+            return;
+        }
+        await runHistory({ entryId: entryId.trim() });
+    });
+}
+//# sourceMappingURL=registerHistoryCommand.js.map

package/dist/registerHistoryCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerHistoryCommand.js","sourceRoot":"","sources":["../src/registerHistoryCommand.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,UAAU,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CAAC,KAAK,EAAE,OAAe,EAAE,EAAE;QAChC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC;YACtE,OAAO;QACT,CAAC;QACD,MAAM,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/registerOutcomeCommands.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `pb outcome record | list` — registration (WP-722 S2).
+ *
+ * Its own file rather than more lines in `packages/cli/src/index.ts`, which is 1,069 LOC and
+ * shrink-only — the same `register*Commands.ts` split `registerEntryCommands.ts` and
+ * `registerProposalCommands.ts` already use, and for the same stated reason.
+ *
+ * **`show` arrives now, with the derivation it reads (S3).** It was deliberately absent in S2:
+ * every field it prints — direction, progress, pace, next due, state, recorded completion and its
+ * provenance, weakest tier, resolved role names, `readyToClose` and its instruction — is produced
+ * by the derivation slice, and shipping the verb before that would have meant a `show` that
+ * printed what `list` prints and stayed silent about the rest. Nothing was renamed to add it,
+ * which is the whole reason the noun is `outcome` rather than `reading`.
+ *
+ * **Door-parity consequence, and it is the registration** (historical — the WP-639 door
+ * registry, including `kernel/doors/rows/surfaceSets.ts`, was deleted in WP-756 B1/TASK-227/
+ * DEC-1724; the shape below predates that and the reasoning stays accurate as history).
+ * `kernel/doors/rows/surfaceSets.ts`'s S6 CLI class row recorded a `count` that had to equal
+ * the live `[E7]` enumerator output, and the enumerator counted raw `.command(` occurrences
+ * across `packages/cli/src`. In THIS registration shape the noun is itself a `.command(` call
+ * (`program.command('outcome')`, matching `registerEntryCommands.ts`), so a noun plus two verbs
+ * is THREE calls, not two. The count was re-derived by running the gate rather than taken from
+ * any written number.
+ */
+import type { Command } from 'commander';
+export declare function registerOutcomeCommands(program: Command): void;
+//# sourceMappingURL=registerOutcomeCommands.d.ts.map

package/dist/registerOutcomeCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerOutcomeCommands.d.ts","sourceRoot":"","sources":["../src/registerOutcomeCommands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2B9D"}

package/dist/registerOutcomeCommands.js

@@ -0,0 +1,27 @@
+import { runOutcomeRecord, runOutcomeList, runOutcomeShow } from './commands/outcome.js';
+export function registerOutcomeCommands(program) {
+    const outcomeCmd = program
+        .command('outcome')
+        .description('Key-result outcomes — record and read the measured readings behind a number');
+    outcomeCmd
+        .command('record <entry-id> <value>')
+        .description('Record a reading — evidence, not a verdict; any connector may record one')
+        .option('--as-of <date>', 'When the world was in this state (default: now). Back-dating a backfill is legitimate and stays visible')
+        .option('--kind <kind>', 'measurement | estimate | correction (default: measurement)')
+        .option('--corrects <reading-id>', 'Required with --kind correction — the reading this replaces. Refused if that row is already superseded')
+        .option('--by-role <role-id>', "The accountable role (default: the key result's reporterRoleId, then its owning role)")
+        .option('--note <text>', 'Free-text note recorded with the reading')
+        .option('--source <text>', 'Where the number came from — a dashboard name, a query, a URL')
+        .option('--value-text <text>', 'Verbatim as-reported form when the source was not clean ("~62%", "62 of 100"). Display only')
+        .action(runOutcomeRecord);
+    outcomeCmd
+        .command('list <entry-id>')
+        .description('List readings, newest first; superseded rows are shown and marked with their replacement')
+        .option('--limit <n>', 'Max rows to return (default and maximum 200)')
+        .action(runOutcomeList);
+    outcomeCmd
+        .command('show <entry-id>')
+        .description('The derived view — current, progress, pace, staleness, recorded completion and its provenance, and any close proposal')
+        .action(runOutcomeShow);
+}
+//# sourceMappingURL=registerOutcomeCommands.js.map

package/dist/registerOutcomeCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerOutcomeCommands.js","sourceRoot":"","sources":["../src/registerOutcomeCommands.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEzF,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACvD,MAAM,UAAU,GAAG,OAAO;SACxB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,6EAA6E,CAAC,CAAC;IAE7F,UAAU;SACR,OAAO,CAAC,2BAA2B,CAAC;SACpC,WAAW,CAAC,0EAA0E,CAAC;SACvF,MAAM,CAAC,gBAAgB,EAAE,yGAAyG,CAAC;SACnI,MAAM,CAAC,eAAe,EAAE,4DAA4D,CAAC;SACrF,MAAM,CAAC,yBAAyB,EAAE,wGAAwG,CAAC;SAC3I,MAAM,CAAC,qBAAqB,EAAE,uFAAuF,CAAC;SACtH,MAAM,CAAC,eAAe,EAAE,0CAA0C,CAAC;SACnE,MAAM,CAAC,iBAAiB,EAAE,+DAA+D,CAAC;SAC1F,MAAM,CAAC,qBAAqB,EAAE,6FAA6F,CAAC;SAC5H,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAE3B,UAAU;SACR,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,0FAA0F,CAAC;SACvG,MAAM,CAAC,aAAa,EAAE,8CAA8C,CAAC;SACrE,MAAM,CAAC,cAAc,CAAC,CAAC;IAEzB,UAAU;SACR,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,uHAAuH,CAAC;SACpI,MAAM,CAAC,cAAc,CAAC,CAAC;AAC1B,CAAC"}

package/dist/registerRoleCommands.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `pb role list` (TEN-4847); `pb role accountable` — registration (WP-730 S2); `pb role seat` / `pb role unseat` (TASK-633 S3c, DEC-1954);
+ * `pb people invite` (TASK-637, DEC-1953): the organisation's two nouns share this file so index.ts does not grow.
+ *
+ * Its own file rather than more lines in `packages/cli/src/index.ts` (1,069 LOC and
+ * shrink-only) — the same `register*Commands.ts` split `registerOutcomeCommands.ts` already
+ * uses, and for the same stated reason.
+ */
+import type { Command } from 'commander';
+export declare function registerRoleCommands(program: Command): void;
+//# sourceMappingURL=registerRoleCommands.d.ts.map

package/dist/registerRoleCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerRoleCommands.d.ts","sourceRoot":"","sources":["../src/registerRoleCommands.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4C3D"}

package/dist/registerRoleCommands.js

@@ -0,0 +1,43 @@
+import { runRoleAccountable, runRoleList, runRoleSeat, runRoleUnseat } from './commands/role.js';
+import { runPeopleInvite } from './commands/people.js';
+export function registerRoleCommands(program) {
+    const roleCmd = program
+        .command('role')
+        .description('Roles — who is accountable for what, and who holds them');
+    roleCmd
+        .command('list')
+        .description('Every seat (a role in a team) with who holds it, and how many seats AI agents hold; draft roles are not listed')
+        .action(runRoleList);
+    roleCmd
+        .command('accountable <role-id>')
+        .description('What this role is accountable for — explicit ownership, reporting duty, and Team-Lead vacancy coverage (not yet computed)')
+        .option('--canonical-key <key>', 'Narrow to one kind (e.g. objective, key_result, tension)')
+        .option('--limit <n>', 'Max explicit-list rows per page (default and maximum 200)')
+        .option('--cursor <n>', 'Continue the explicit list from an earlier truncated page')
+        .action(runRoleAccountable);
+    roleCmd
+        .command('seat <role-id>')
+        .description('Put a person in this role, in its home team; their other roles there stay\n'
+        + 'Example: pb role seat <role-id> --new-person "Jan Jansen"')
+        .option('--person <id-or-email>', 'An existing person, by person id or exact email')
+        .option('--new-person <name>', 'A person with no login yet: the same exact name twice is one placeholder; a name that belongs to someone with an account is refused')
+        .option('--team <team-id>', 'Only for Team Lead, which is held in every team')
+        .option('--on-my-authority', 'Team Lead only, as the team\'s Team Lead: they hold the seat on your authority until you unseat them')
+        .action(runRoleSeat);
+    roleCmd
+        .command('unseat <role-id>')
+        .description('Take this role from a person; their other roles in the team stay. The last active Team Lead of a team is refused')
+        .requiredOption('--person <id-or-email>', 'The holder, by person id or exact email')
+        .option('--team <team-id>', 'Only for Team Lead, which is held in every team')
+        .action(runRoleUnseat);
+    program
+        .command('people')
+        .description('People in this workspace')
+        .command('invite [person-id]')
+        .description('Invite a person by email. Give a placeholder\'s person id to invite them in place: they keep every role they hold\n'
+        + 'Example: pb people invite <person-id> --email jan@example.com')
+        .requiredOption('--email <email>', 'Where the login link goes')
+        .option('--name <name>', 'Only for a new person; a placeholder keeps its own name')
+        .action(runPeopleInvite);
+}
+//# sourceMappingURL=registerRoleCommands.js.map

package/dist/registerRoleCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerRoleCommands.js","sourceRoot":"","sources":["../src/registerRoleCommands.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACpD,MAAM,OAAO,GAAG,OAAO;SACrB,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,yDAAyD,CAAC,CAAC;IAEzE,OAAO;SACL,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gHAAgH,CAAC;SAC7H,MAAM,CAAC,WAAW,CAAC,CAAC;IAEtB,OAAO;SACL,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,2HAA2H,CAAC;SACxI,MAAM,CAAC,uBAAuB,EAAE,0DAA0D,CAAC;SAC3F,MAAM,CAAC,aAAa,EAAE,2DAA2D,CAAC;SAClF,MAAM,CAAC,cAAc,EAAE,2DAA2D,CAAC;SACnF,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAE7B,OAAO;SACL,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,6EAA6E;UACvF,2DAA2D,CAAC;SAC9D,MAAM,CAAC,wBAAwB,EAAE,iDAAiD,CAAC;SACnF,MAAM,CAAC,qBAAqB,EAAE,qIAAqI,CAAC;SACpK,MAAM,CAAC,kBAAkB,EAAE,iDAAiD,CAAC;SAC7E,MAAM,CAAC,mBAAmB,EAAE,sGAAsG,CAAC;SACnI,MAAM,CAAC,WAAW,CAAC,CAAC;IAEtB,OAAO;SACL,OAAO,CAAC,kBAAkB,CAAC;SAC3B,WAAW,CAAC,kHAAkH,CAAC;SAC/H,cAAc,CAAC,wBAAwB,EAAE,yCAAyC,CAAC;SACnF,MAAM,CAAC,kBAAkB,EAAE,iDAAiD,CAAC;SAC7E,MAAM,CAAC,aAAa,CAAC,CAAC;IAExB,OAAO;SACL,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,0BAA0B,CAAC;SACvC,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,qHAAqH;UAC/H,+DAA+D,CAAC;SAClE,cAAc,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;SAC9D,MAAM,CAAC,eAAe,EAAE,yDAAyD,CAAC;SAClF,MAAM,CAAC,eAAe,CAAC,CAAC;AAC3B,CAAC"}

package/dist/registerTensionsCommands.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `pb tensions list` — noun-scoped per DEC-1574's pattern (registerEntryCommands.ts): a
+ * collection-scoped, status-filtered, cursor-paged list generalisable to any collection slug.
+ * WP-768 L0 (TASK-281). Split into its own file for the same reason registerEntryCommands.ts
+ * was split out of index.ts (STD-2/DEC-1504: index.ts is grandfathered over-budget and
+ * shrink-only). Beside it, `pb tasks list` (DEC-2459): the collection-list shape's second use, not shared yet (RULE-657).
+ */
+import type { Command } from 'commander';
+export declare function registerTasksCommands(program: Command): void;
+export declare function registerTensionsCommands(program: Command): void;
+//# sourceMappingURL=registerTensionsCommands.d.ts.map

package/dist/registerTensionsCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerTensionsCommands.d.ts","sourceRoot":"","sources":["../src/registerTensionsCommands.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAW5D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAa/D"}

package/dist/registerTensionsCommands.js

@@ -0,0 +1,28 @@
+import { runTasksList } from './commands/tasksList.js';
+import { runTensionsList } from './commands/tensionsList.js';
+export function registerTasksCommands(program) {
+    program
+        .command('tasks')
+        .description('Task-scoped commands')
+        .command('list')
+        .description("List a role's open tasks outside a live work package, Urgent first; orient shows five of them")
+        .option('--role <ROL-n>', "Another role's tasks (default: the role your session acts in); the Team Lead's list adds tasks no role owns")
+        .option('--cursor <n>', 'Page cursor returned by a previous call')
+        .action(async (opts) => {
+        await runTasksList(opts);
+    });
+}
+export function registerTensionsCommands(program) {
+    const tensionsCmd = program
+        .command('tensions')
+        .description('Tension-scoped commands');
+    tensionsCmd
+        .command('list')
+        .description('List tensions — collection-scoped, status-filtered, cursor-paged (replaces the always-zero tensionCount in `pb brief confidence`)')
+        .option('-s, --status <workflowStatus>', 'Filter by workflow status (e.g. open, processing, decided, closed)')
+        .option('--cursor <token>', 'Page cursor returned by a previous call (pages to the end)')
+        .action(async (opts) => {
+        await runTensionsList(opts);
+    });
+}
+//# sourceMappingURL=registerTensionsCommands.js.map

package/dist/registerTensionsCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerTensionsCommands.js","sourceRoot":"","sources":["../src/registerTensionsCommands.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE7D,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,sBAAsB,CAAC;SACnC,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,+FAA+F,CAAC;SAC5G,MAAM,CAAC,gBAAgB,EAAE,6GAA6G,CAAC;SACvI,MAAM,CAAC,cAAc,EAAE,yCAAyC,CAAC;SACjE,MAAM,CAAC,KAAK,EAAE,IAAwC,EAAE,EAAE;QACzD,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,MAAM,WAAW,GAAG,OAAO;SACxB,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAE1C,WAAW;SACR,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mIAAmI,CAAC;SAChJ,MAAM,CAAC,+BAA+B,EAAE,oEAAoE,CAAC;SAC7G,MAAM,CAAC,kBAAkB,EAAE,4DAA4D,CAAC;SACxF,MAAM,CAAC,KAAK,EAAE,IAA0C,EAAE,EAAE;QAC3D,MAAM,eAAe,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/scoreboard/diagnose.d.ts

@@ -0,0 +1,133 @@
+/** A metric's diagnosis status. */
+export type DiagnosisStatus = 'ok' | 'degraded' | 'awaiting' | 'unmeasured';
+export interface MetricDiagnosis {
+    /** The metric id (M3, M4, MOAT) + a short human label. M1 is retired (DEC-1829). */
+    metric: string;
+    label: string;
+    status: DiagnosisStatus;
+    /** The raw reading, ALWAYS shown — never replaced by a verdict. */
+    reading: string;
+    /** Named cause of a degraded/awaiting/unmeasured reading (or the steady-state note). */
+    cause: string;
+    /** The concrete next action that closes the loop (empty string when status === 'ok'). */
+    nextAction: string;
+}
+export interface M3Payload {
+    capturedCount: number;
+    everRatifiedCount: number;
+    inSessionRatifiedCount: number;
+    everRatifiedRate: number | null;
+    inSessionRatifiedRate: number | null;
+    sessionWindow: number;
+    sessionsConsidered: number;
+}
+/**
+ * WP-487 Slice 2 (FEAT-1374): the organic rework meter, filling the reserved M4 slot. Mirrors
+ * `convex/scoreboard/aggregates.ts`'s `M4Result` structurally (not imported — packages/* has no
+ * import path into convex/, same convention as the other *Payload shapes above).
+ */
+export interface M4Payload {
+    reworkJoinWindowMs: number;
+    lookbackWindowMs: number;
+    now: number;
+    servedCount: number;
+    unattributableServedCount: number;
+    pendingObservationCount: number;
+    decidedCount: number;
+    firstTimeGoodCount: number;
+    reworkedCount: number;
+    firstTimeGoodShare: number | null;
+    signalCount: number;
+    joinedSignalCount: number;
+    unjoinedSignalCount: number;
+    falseAttributionRate: number | null;
+    byClassification: {
+        revision: number;
+        ci_review_correction: number;
+        user_override: number;
+    };
+    ciReviewCorrectionAttribution: {
+        attributable: number;
+        notAttributable: number;
+        unspecified: number;
+    };
+    cohort: {
+        workspaceId: string;
+        taskProvidedCount: number;
+        taskAbsentCount: number;
+    };
+}
+/** WP-499 Slice B (TEN-2743, §2.5): advisories/verdicts/detection-coverage/override-rate.
+ *  Mirrors aggregates.ts's CoherenceResult structurally (DEC-1282: no thresholds baked in). */
+export interface CoherencePayload {
+    openConflictCount: number;
+    openConflictsTruncated: boolean;
+    reviewed: number;
+    real: number;
+    falseAlarm: number;
+    /** PR #422 (P2): reviewed/real/falseAlarm/humanBar above are a SAMPLE when true — never present as complete. */
+    reviewedTruncated: boolean;
+    humanBar: {
+        meets: boolean;
+        lowerBound: number | null;
+        reviewed: number;
+    };
+    /** Review fix (PR #528 P1): OBSERVED precision (real/reviewed) — distinct from
+     *  humanBar.lowerBound (the Wilson bound on the same ratio). Optional: predates C2. */
+    precision?: number | null;
+    /** C2 (WP-468), all OPTIONAL (an older deployment predates every field below, PR #528 P1 —
+     *  never dereference unguarded). Actionable queue, verdicted-open (`real`, staying open),
+     *  snoozed sub-count (each with its own truncation flag), total open, dial (scope-doc F10). */
+    openUnverdicted?: number;
+    openUnverdictedTruncated?: boolean;
+    /** Third totalOpen partition: currently-snoozed unverdicted rows (see coherenceDial.ts). */
+    snoozedUnverdicted?: number;
+    verdictedOpenCount?: number;
+    verdictedOpenTruncated?: boolean;
+    snoozedCount?: number;
+    snoozedCountTruncated?: boolean;
+    totalOpen?: number;
+    totalOpenTruncated?: boolean;
+    totalOpenAlarm?: boolean;
+    dial?: {
+        coherencyMode: string;
+    };
+    detectionCoverage: {
+        bySurface: Record<string, Record<string, number>>;
+        scanned: number;
+        truncated: boolean;
+    };
+}
+export interface ScoreboardPayload {
+    workspaceId: string;
+    generatedAt: number;
+    m3: M3Payload;
+    m4: M4Payload;
+    coherence: CoherencePayload;
+}
+/**
+ * M3 — draft-to-SSOT rate. The in-session-ratify floor (ASM-45 rolling-20 window) is PINNED
+ * per DEC-1513 (`M3_IN_SESSION_FLOOR`) — a determinable reading renders a real `ok`/`degraded`
+ * verdict. Zero captures → `unmeasured`. An undeterminable rate (null) fails soft to `awaiting`.
+ */
+export declare function diagnoseM3(m3: M3Payload): MetricDiagnosis;
+/**
+ * M4 — organic rework meter (WP-487 Slice 2, FEAT-1374). Joins served governance against
+ * later-reported rework signals in a frozen 72h window (TEN-2728); RAW distribution + a
+ * false-attribution counter, never a verdict (DEC-1282) and never causality (association only).
+ * `unmeasured` with nothing served; `awaiting` otherwise (no floor pinned yet).
+ */
+export declare function diagnoseM4(m4: M4Payload): MetricDiagnosis;
+/** The STANDING coaching/moat-quality `unmeasured` line (TEN-2377) — a permanent honesty marker
+ *  so four green tiles are never read as "the moat is healthy". */
+export declare function diagnoseCoachingMoat(): MetricDiagnosis;
+/** The full diagnosis bundle the CLI renders + emits in --json. */
+export interface ScoreboardDiagnosis {
+    m3: MetricDiagnosis;
+    m4: MetricDiagnosis;
+    /** Standing honesty marker — coaching/moat quality is unmeasured. */
+    moat: MetricDiagnosis;
+}
+/** diagnose — data-layer payload → per-metric diagnoses. Pure. */
+export declare function diagnose(payload: ScoreboardPayload): ScoreboardDiagnosis;
+//# sourceMappingURL=diagnose.d.ts.map

package/dist/scoreboard/diagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/scoreboard/diagnose.ts"],"names":[],"mappings":"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"}