@productbrain/cli 0.1.0-beta.1431 → 0.1.0-beta.14316

package/dist/lib/boundScope.js

@@ -0,0 +1,205 @@
+/**
+ * TASK-1638 (WP-862; TEN-5003, DEC-2095): what a bound lane is working on, read again after every compaction. The lane's bind
+ * receipt (`.productbrain/.local/workspace-scope.json`, written by scripts/workspace-bind.ts) names its package and owned tasks;
+ * pb orient and the MCP orient print them after the served rules as one Bound scope block: the package with its stage and
+ * priority, each owned task with its done-when ticks, and the lane's open PRs. Outside a bound lane the block is absent.
+ * The receipt's one parser is here, so the lane scripts (scripts/lib/workspace-completion.ts) read it alike, and every word
+ * the block prints is in BOUND_SCOPE_WORDS (RULE-664). The MCP copy is generated from this file by
+ * scripts/generate-mcp-embedded-copies.mjs, since the isolated MCP build cannot import it.
+ */
+import { execFile } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { NO_PRIORITY, PRIORITY_LEVELS, priorityOf } from './priority.js';
+import { readInChunks } from './limits.js';
+export const WORKSPACE_SCOPE_BINDING_VERSION = 1;
+export const WORKSPACE_SCOPE_RELATIVE_PATH = '.productbrain/.local/workspace-scope.json';
+/** The id a lane may be bound to: a work package, or a legacy bet. The binding and the retirement receipt both read it. */
+export const BOUND_PACKAGE_ID = /^(?:WP|BET)-\d+$/;
+/** The refusal every workspace lifecycle rule throws, the receipt parser's included. */
+export class WorkspaceCompletionError extends Error {
+    name = 'WorkspaceCompletionError';
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function requiredString(value, label) {
+    if (typeof value !== 'string' || value.trim().length === 0)
+        throw new WorkspaceCompletionError(`Workspace scope binding has no valid ${label}.`);
+    return value;
+}
+/** TASK-673: owned ids are TASK-NNN, at least one, deduped in first-seen order. */
+export function normalizeOwnedSliceIds(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        throw new WorkspaceCompletionError('Workspace scope binding ownedSliceIds must be a non-empty list of TASK-NNN ids.');
+    const bad = value.findIndex((id) => typeof id !== 'string' || !/^TASK-\d+$/.test(id));
+    if (bad >= 0)
+        throw new WorkspaceCompletionError(`${String(value[bad])} is not a TASK-NNN id; a workspace owns tasks only (ownedSliceIds).`);
+    return [...new Set(value)];
+}
+export function parseWorkspaceScopeBinding(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new WorkspaceCompletionError('Workspace scope binding is malformed JSON.');
+    }
+    if (!isRecord(parsed))
+        throw new WorkspaceCompletionError('Workspace scope binding must be a JSON object.');
+    if (parsed['version'] !== WORKSPACE_SCOPE_BINDING_VERSION)
+        throw new WorkspaceCompletionError(`Unsupported workspace scope binding version: ${String(parsed['version'])}.`);
+    const scopeEntryId = requiredString(parsed['scopeEntryId'], 'scopeEntryId');
+    if (!BOUND_PACKAGE_ID.test(scopeEntryId))
+        throw new WorkspaceCompletionError(`Workspace scope binding entry must be a WP-NNN or legacy BET-NNN ID; got ${scopeEntryId}.`);
+    const boundAt = requiredString(parsed['boundAt'], 'boundAt');
+    if (Number.isNaN(Date.parse(boundAt)))
+        throw new WorkspaceCompletionError('Workspace scope binding has an invalid boundAt timestamp.');
+    return {
+        version: WORKSPACE_SCOPE_BINDING_VERSION, scopeEntryId, scopeName: requiredString(parsed['scopeName'], 'scopeName'),
+        chainWorkspaceId: requiredString(parsed['chainWorkspaceId'], 'chainWorkspaceId'), boundAt,
+        ...('ownedSliceIds' in parsed ? { ownedSliceIds: normalizeOwnedSliceIds(parsed['ownedSliceIds']) } : {}),
+    };
+}
+const BIND_AGAIN = 'npm run workspace:bind -- <WP-ID> [TASK-ID ...]';
+export const BOUND_SCOPE_WORDS = {
+    heading: '## Bound scope',
+    /** RULE-17: ticks are counted against the task's whole done-when list. */
+    ticks: (ticked, total) => (total === 0 ? 'no done-when' : `${ticked} of ${total} done-when ticked`),
+    noStage: 'no stage',
+    notFound: 'not found in this workspace; check the id in the bind file, or bind again',
+    /** The credential reads another workspace than the lane was bound in (as assertParentIdentity refuses in the lane scripts). */
+    otherWorkspace: (ids) => `Read from another workspace than this lane's bind: ${ids.join(', ')}. Run \`pb profile use <name>\` for the lane's workspace, or bind again: ${BIND_AGAIN}`,
+    notRead: (entryId, reason) => `${entryId} not read: ${reason}`,
+    wholePackage: 'No tasks named at bind: the lane owns the whole package.',
+    pr: (branch, pr) => `Open PR on ${branch}: #${pr.number} at ${pr.headSha.slice(0, 9)} · ${pr.labels.join(', ') || 'no labels'}`,
+    noPr: (branch) => `No open PR on ${branch}.`,
+    prsNotRead: (reason) => `PRs not read: ${reason}.`,
+    ghMissing: 'gh is not installed; install gh, or read the PRs on GitHub',
+    /** gh's own first line; the auth step only when that line is about signing in. */
+    ghFailed: (detail) => `gh failed (${detail})${/auth|log ?in|token|credential/i.test(detail) ? '; gh auth status says whether it is signed in' : ''}`,
+    noBranch: 'this worktree is on no branch; check out the lane branch',
+    fileError: (message) => `The bind file could not be read. ${WORKSPACE_SCOPE_RELATIVE_PATH}: ${message} Fix it, or remove it and bind again: ${BIND_AGAIN}`,
+};
+/** git answers in milliseconds; gh asks GitHub, so it gets longer, and a slow answer becomes a "PRs not read" line. */
+const TIMEOUT_MS = { git: 3_000, gh: 8_000 };
+/** The file, git and gh reads on this machine; pb orient hands in kernelCall for the Chain read, the MCP orient kernelQuery. */
+export function nodeBoundScopeIo(cwd, readEntries) {
+    const run = (command, args, dir) => new Promise((resolve) => {
+        execFile(command, args, { cwd: dir, timeout: TIMEOUT_MS[command], encoding: 'utf8', windowsHide: true }, (error, stdout, stderr) => {
+            if (!error)
+                return resolve({ ok: true, stdout });
+            const detail = (stderr.trim().split('\n')[0] || (error.killed ? 'no answer in time' : error.message)).trim();
+            resolve({ ok: false, detail, ...(error.code === 'ENOENT' ? { missing: true } : {}) });
+        });
+    });
+    const readText = (path) => {
+        try {
+            return readFileSync(path, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return null;
+            throw error;
+        }
+    };
+    return { cwd, readText, run, readEntries };
+}
+const messageOf = (error) => (error instanceof Error ? error.message : String(error));
+function rowOf(entryId, answer, isTask, workspaceId) {
+    const entry = answer?.entry;
+    if (!isRecord(entry))
+        return { entryId, notRead: BOUND_SCOPE_WORDS.notFound };
+    if (entry['workspaceId'] !== workspaceId)
+        return { entryId, otherWorkspace: true }; // never print another workspace's names as this lane's
+    const data = isRecord(entry['data']) ? entry['data'] : {};
+    const items = Array.isArray(data['doneWhen']) ? data['doneWhen'] : [];
+    return {
+        entryId,
+        ...(typeof entry['name'] === 'string' ? { name: entry['name'] } : {}),
+        ...(typeof entry['workflowStatus'] === 'string' ? { workflowStatus: entry['workflowStatus'] } : {}),
+        ...(isTask ? { doneWhen: { ticked: items.filter((item) => isRecord(item) && item['done'] === true).length, total: items.length } } : { priority: data['priority'] }),
+    };
+}
+async function readRows(io, ids, workspaceId) {
+    try {
+        const answers = await readInChunks(ids, io.readEntries);
+        return ids.map((id, i) => rowOf(id, answers[i], i > 0, workspaceId));
+    }
+    catch (error) {
+        return ids.map((entryId) => ({ entryId, notRead: messageOf(error) }));
+    }
+}
+async function readPrs(io, root, branch) {
+    if (!branch)
+        return { prsNotRead: BOUND_SCOPE_WORDS.noBranch };
+    const result = await io.run('gh', ['pr', 'list', '--head', branch, '--state', 'open', '--json', 'number,headRefOid,labels'], root);
+    if (!result.ok)
+        return { prsNotRead: result.missing ? BOUND_SCOPE_WORDS.ghMissing : BOUND_SCOPE_WORDS.ghFailed(result.detail) };
+    try {
+        const parsed = JSON.parse(result.stdout);
+        if (!Array.isArray(parsed))
+            throw new Error('not a list');
+        return {
+            prs: parsed.filter(isRecord).map((pr) => ({
+                number: Number(pr['number']),
+                headSha: typeof pr['headRefOid'] === 'string' ? pr['headRefOid'] : '',
+                labels: (Array.isArray(pr['labels']) ? pr['labels'] : []).flatMap((label) => (isRecord(label) && typeof label['name'] === 'string' ? [label['name']] : [])),
+            })),
+        };
+    }
+    catch (error) {
+        return { prsNotRead: BOUND_SCOPE_WORDS.ghFailed(`its answer was not a PR list: ${messageOf(error)}`) };
+    }
+}
+/** The lane the working directory sits in: null in no git worktree or one with no bind file. Never throws; a failed read is a line. */
+export async function readBoundScope(io) {
+    const top = await io.run('git', ['rev-parse', '--show-toplevel', '--abbrev-ref', 'HEAD'], io.cwd);
+    if (!top.ok)
+        return null;
+    const [root = '', head = ''] = top.stdout.trim().split('\n').map((line) => line.trim());
+    let binding;
+    try {
+        const raw = root ? io.readText(`${root}/${WORKSPACE_SCOPE_RELATIVE_PATH}`) : null;
+        if (raw === null)
+            return null;
+        binding = parseWorkspaceScopeBinding(raw);
+    }
+    catch (error) {
+        return { fileError: messageOf(error) };
+    }
+    const branch = head && head !== 'HEAD' ? head : null;
+    const [rows, prs] = await Promise.all([readRows(io, [binding.scopeEntryId, ...(binding.ownedSliceIds ?? [])], binding.chainWorkspaceId), readPrs(io, root, branch)]);
+    return { scopeEntryId: binding.scopeEntryId, rows, ownsWholePackage: !binding.ownedSliceIds, branch, ...prs };
+}
+function rowLine(row, isTask) {
+    if (row.notRead)
+        return BOUND_SCOPE_WORDS.notRead(row.entryId, row.notRead);
+    const token = priorityOf(row.priority);
+    const tail = isTask ? BOUND_SCOPE_WORDS.ticks(row.doneWhen?.ticked ?? 0, row.doneWhen?.total ?? 0) : token ? PRIORITY_LEVELS[token].word : NO_PRIORITY.word;
+    return `${row.entryId}${row.name ? ` — ${row.name}` : ''} · ${row.workflowStatus ?? BOUND_SCOPE_WORDS.noStage} · ${tail}`;
+}
+/** The block's lines, heading first, items indented as orient's other lists; no trailing blank line. */
+export function boundScopeLines(view) {
+    const lines = [BOUND_SCOPE_WORDS.heading, ''];
+    const item = (line) => lines.push(`  • ${line}`);
+    if ('fileError' in view)
+        item(BOUND_SCOPE_WORDS.fileError(view.fileError));
+    else {
+        view.rows.forEach((row, i) => { if (!row.otherWorkspace)
+            item(rowLine(row, i > 0)); });
+        const elsewhere = view.rows.filter((row) => row.otherWorkspace).map((row) => row.entryId);
+        if (elsewhere.length > 0)
+            item(BOUND_SCOPE_WORDS.otherWorkspace(elsewhere));
+        if (view.ownsWholePackage)
+            item(BOUND_SCOPE_WORDS.wholePackage);
+        if (view.prsNotRead !== undefined)
+            item(BOUND_SCOPE_WORDS.prsNotRead(view.prsNotRead));
+        else if (view.branch && view.prs?.length)
+            for (const pr of view.prs)
+                item(BOUND_SCOPE_WORDS.pr(view.branch, pr));
+        else if (view.branch)
+            item(BOUND_SCOPE_WORDS.noPr(view.branch));
+    }
+    return lines;
+}
+//# sourceMappingURL=boundScope.js.map

package/dist/lib/boundScope.js.map

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

package/dist/lib/canonicalRefs.d.ts

@@ -1,14 +1,28 @@
-/**
- * Synced from convex/lib/canonicalRefs.ts (WP-345: canonical refs, NG4: CLI import boundary).
- */
 /**
  * Canonical Refs — pure parser for semantic ref syntax.
  *
- * Zero Convex imports. This file is drift-synced to:
+ * WP-640 S2 (TASK-63): THIS FILE IS THE SINGLE SOURCE. `packages/cli/src/lib/canonicalRefs.ts`
+ * and `packages/mcp-server/src/lib/canonicalRefs.ts` are GENERATED mirrors
+ * (scripts/generate-mcp-embedded-copies.mjs) — never hand-edit them. Edit here, then
+ * `npm run mcp:embedded-copies` (writes both copies); `npm run mcp:embedded-copies:check` fails
+ * CI on drift. Folding all three into a real
+ * shared package (e.g. `kernel`, which already declares "ZERO Convex imports" and is already a
+ * `cli` devDependency) was considered and DECLINED: `scripts/check-mcp-boundaries.mjs` (RULE-49,
+ * TEN-174) unconditionally fails any `packages/mcp-server/src` file importing from outside the
+ * package — a live `kernel` import there is structurally blocked, not just risky — and a new
+ * kernel/ folder also needs a WP-537 kind-manifest row. The generator is the one
+ * "copy-free at the source-editing level, physically-copied at the build level" mechanism the
+ * connectors use for exactly this MCP-boundary reason. It collapses
+ * the "3 independently hand-copy-pasted files" problem the doneWhen names (a human previously had
+ * to remember to edit three files identically) down to ONE edited source with caught drift. NG4
+ * (WP-345) is UNCHANGED: CLI/MCP still must not import the resolver (deleted, no
+ * `lib/`) — only this pure parser.
+ *
+ * Zero Convex imports. This file is generated into:
  *   - packages/cli/src/lib/canonicalRefs.ts (CLI copy — identical logic)
  *   - packages/mcp-server/src/lib/canonicalRefs.ts (MCP copy — identical logic)
  *
- * NG4 (WP-345): CLI/MCP MUST NOT import the resolver (convex/canonicalRefs.ts).
+ * NG4 (WP-345): CLI/MCP MUST NOT import the resolver (deleted).
  * They import only this pure parser module.
  *
  * DEC-A/WP-354: semantic refs syntax is {{ref:canonicalKey}},
@@ -16,18 +30,18 @@
  * {{ref:entry:DEC-123}}.
  * Chain: WP-345 E4, DEC-K (projection hash trailer)
  *
- * WP-436 S1 — Axis 2 vocabulary resolver (DEC-1021, STD-253):
+ * WP-436 S1 — Axis 2 vocabulary resolver (DEC-1021, RULE-525):
  * {{vocab:<canonicalKey>.<form>}} tokens + getCollectionLabel resolver.
  * PAT-230: resolver is pure — no Convex import, workspace context passed as arg.
  */
 /**
  * WP-354 Build-Order #6: Setup-ref resolver return shape.
  *
- * All consumers (CLI, MCP, handshake, editor health) must read
+ * All consumers (CLI, MCP, editor health) must read
  * the discriminated kind+status fields instead of an optional resolved object.
  *
- * Spec: docs/system/design/authority-domains-design-spec.md §632
- * Chain: WP-354 Slice H, STD-101 (single source of truth)
+ * Chain: WP-354 Slice H, RULE-372 (single source of truth — the design spec this cited is
+ * deleted, R3/TASK-411, WP-781; RULE-372 is the surviving authority)
  *
  * drift-synced to:
  *   - packages/cli/src/lib/canonicalRefs.ts
@@ -58,9 +72,9 @@ export declare function parseSemanticRefs(body: string): string[];
  * Falls back to the raw key wrapped in brackets if no resolved name is available.
  *
  * Examples:
- *   renderSemanticRef('bet', 'Active Bets')  → 'Active Bets'
- *   renderSemanticRef('bet')                 → '[bet]'
- *   renderSemanticRef('bet', undefined)      → '[bet]'
+ *   renderSemanticRef(bet, 'Active Bets')  → 'Active Bets'
+ *   renderSemanticRef(bet)                 → '[bet]'
+ *   renderSemanticRef(bet, undefined)      → '[bet]'
  */
 export declare function renderSemanticRef(key: string, resolvedName?: string): string;
 /**
@@ -110,7 +124,7 @@ export type CollectionVocabCtx = {
 };
 /**
  * Regex for matching vocab tokens: {{vocab:<canonicalKey>.<form>}}
- * STD-253: canonicalKey + form are both lowercase snake_case.
+ * RULE-525: canonicalKey + form are both lowercase snake_case.
  * Captures: [1] canonicalKey, [2] form.
  */
 export declare const VOCAB_TOKEN_REGEX: RegExp;
@@ -135,7 +149,7 @@ export declare function getCollectionLabel(canonicalKey: string, form: string, w
  * Replace all {{vocab:<canonicalKey>.<form>}} tokens in a string.
  *
  * For each token, calls getCollectionLabel with the provided contexts.
- * STD-253.
+ * RULE-525.
  */
 export declare function replaceVocabTokens(body: string, workspaceCtx?: WorkspaceVocabCtx, collectionCtxMap?: Map<string, CollectionVocabCtx>): string;
 //# sourceMappingURL=canonicalRefs.d.ts.map

package/dist/lib/canonicalRefs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canonicalRefs.d.ts","sourceRoot":"","sources":["../../src/lib/canonicalRefs.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,MAAM,EACH,UAAU,GACV,YAAY,GACZ,oBAAoB,GACpB,SAAS,CACV;IACF,sGAAsG;IACtG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAOF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAgB1F;AAOD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IACxD;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;CAC1D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,mFAAmF;IACnF,MAAM,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAwC,CAAC;AAEvE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CACjC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,iBAAiB,EAChC,aAAa,CAAC,EAAE,kBAAkB,GAChC,MAAM,CAyBR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,iBAAiB,EAChC,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAChD,MAAM,CASR"}
+{"version":3,"file":"canonicalRefs.d.ts","sourceRoot":"","sources":["../../src/lib/canonicalRefs.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9C,MAAM,EACH,UAAU,GACV,YAAY,GACZ,oBAAoB,GACpB,SAAS,CACV;IACF,sGAAsG;IACtG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAOF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAK5E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAgB1F;AAOD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,uCAAuC;AACvC,MAAM,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC;AAEvC;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC/B,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;IACxD;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC;CAC1D,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAChC,mFAAmF;IACnF,MAAM,CAAC,EAAE,QAAQ,CAAC;CAClB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,QAAwC,CAAC;AAEvE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CACjC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,iBAAiB,EAChC,aAAa,CAAC,EAAE,kBAAkB,GAChC,MAAM,CAyBR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,iBAAiB,EAChC,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAChD,MAAM,CASR"}

package/dist/lib/canonicalRefs.js

@@ -1,25 +1,6 @@
-/**
- * Synced from convex/lib/canonicalRefs.ts (WP-345: canonical refs, NG4: CLI import boundary).
- */
-/**
- * Canonical Refs — pure parser for semantic ref syntax.
- *
- * Zero Convex imports. This file is drift-synced to:
- *   - packages/cli/src/lib/canonicalRefs.ts (CLI copy — identical logic)
- *   - packages/mcp-server/src/lib/canonicalRefs.ts (MCP copy — identical logic)
- *
- * NG4 (WP-345): CLI/MCP MUST NOT import the resolver (convex/canonicalRefs.ts).
- * They import only this pure parser module.
- *
- * DEC-A/WP-354: semantic refs syntax is {{ref:canonicalKey}},
- * {{ref:canonicalKey:display}}, {{ref:domain:data/analytics}}, or
- * {{ref:entry:DEC-123}}.
- * Chain: WP-345 E4, DEC-K (projection hash trailer)
- *
- * WP-436 S1 — Axis 2 vocabulary resolver (DEC-1021, STD-253):
- * {{vocab:<canonicalKey>.<form>}} tokens + getCollectionLabel resolver.
- * PAT-230: resolver is pure — no Convex import, workspace context passed as arg.
- */
+// GENERATED by scripts/generate-mcp-embedded-copies.mjs from convex/lib/canonicalRefs.ts.
+// DO NOT EDIT. Run `npm run mcp:embedded-copies` to regenerate.
+// Local runtime copy for the isolated connector build.
 /**
  * Regex for matching semantic refs. Captures: [1] ref key/path, [2] optional display label.
  */
@@ -52,9 +33,9 @@ export function parseSemanticRefs(body) {
  * Falls back to the raw key wrapped in brackets if no resolved name is available.
  *
  * Examples:
- *   renderSemanticRef('bet', 'Active Bets')  → 'Active Bets'
- *   renderSemanticRef('bet')                 → '[bet]'
- *   renderSemanticRef('bet', undefined)      → '[bet]'
+ *   renderSemanticRef(bet, 'Active Bets')  → 'Active Bets'
+ *   renderSemanticRef(bet)                 → '[bet]'
+ *   renderSemanticRef(bet, undefined)      → '[bet]'
  */
 export function renderSemanticRef(key, resolvedName) {
     if (resolvedName && resolvedName.trim().length > 0) {
@@ -86,7 +67,7 @@ export function replaceSemanticRefs(body, resolvedMap) {
 }
 /**
  * Regex for matching vocab tokens: {{vocab:<canonicalKey>.<form>}}
- * STD-253: canonicalKey + form are both lowercase snake_case.
+ * RULE-525: canonicalKey + form are both lowercase snake_case.
  * Captures: [1] canonicalKey, [2] form.
  */
 export const VOCAB_TOKEN_REGEX = /\{\{vocab:([a-z_]+)\.([a-z_]+)\}\}/g;
@@ -114,7 +95,7 @@ export function getCollectionLabel(canonicalKey, form, workspaceCtx, collectionC
         if (wsVal !== undefined && wsVal.length > 0)
             return wsVal;
     }
-    // Layer 2: explicit collection ctx (granular call sites — handshake projector)
+    // Layer 2: explicit collection ctx (granular call sites; the handshake projector that used it is deleted)
     const colLabels = collectionCtx?.labels;
     if (colLabels) {
         const colVal = colLabels[form];
@@ -136,7 +117,7 @@ export function getCollectionLabel(canonicalKey, form, workspaceCtx, collectionC
  * Replace all {{vocab:<canonicalKey>.<form>}} tokens in a string.
  *
  * For each token, calls getCollectionLabel with the provided contexts.
- * STD-253.
+ * RULE-525.
  */
 export function replaceVocabTokens(body, workspaceCtx, collectionCtxMap) {
     if (!body || body.length === 0)

package/dist/lib/canonicalRefs.js.map

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

package/dist/lib/captureLink.d.ts

@@ -0,0 +1,7 @@
+export type CaptureLinkArg = {
+    toEntryId: string;
+    type: string;
+};
+/** Pairs each --link with the --link-type given in the same position; a bare or empty flag is refused up front. */
+export declare function pairCaptureLinks(links: readonly string[], types: readonly string[]): CaptureLinkArg[];
+//# sourceMappingURL=captureLink.d.ts.map

package/dist/lib/captureLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureLink.d.ts","sourceRoot":"","sources":["../../src/lib/captureLink.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,mHAAmH;AACnH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,cAAc,EAAE,CAoBrG"}

package/dist/lib/captureLink.js

@@ -0,0 +1,29 @@
+/**
+ * `pb capture --link`: the flag pairs become the `links[]` the one chain.createEntry request carries (TASK-897,
+ * DEC-2113). The kernel resolves each target, judges the verb and answers per link; this file only pairs the flags
+ * and refuses, before anything is sent, a pair the kernel could never judge. No default verb, ever (WP-688 S4).
+ */
+import { CLIError, ErrorCode } from './errors.js';
+/** Pairs each --link with the --link-type given in the same position; a bare or empty flag is refused up front. */
+export function pairCaptureLinks(links, types) {
+    if (types.length > links.length) {
+        throw new CLIError(`${types.length} --link-type for ${links.length} --link; each --link-type belongs to one --link.`, {
+            code: ErrorCode.VALIDATION_FAILED, category: 'validation', guidance: 'Nothing was captured. Re-run with one --link <entry-id> --link-type <type> per link.',
+        });
+    }
+    return links.map((raw, i) => {
+        const toEntryId = raw.trim();
+        if (!toEntryId) {
+            throw new CLIError('--link requires a non-empty entry ID.', { code: ErrorCode.VALIDATION_FAILED, category: 'validation', guidance: 'Nothing was captured. Re-run with --link <entry-id> --link-type <type>.' });
+        }
+        const type = types[i]?.trim();
+        if (!type) {
+            throw new CLIError(`--link ${toEntryId} requires --link-type; no default is written.`, {
+                code: ErrorCode.VALIDATION_FAILED, category: 'validation',
+                guidance: `Nothing was captured. Re-run with --link ${toEntryId} --link-type <type>; a verb the kernel refuses comes back with the legal ones.`,
+            });
+        }
+        return { toEntryId, type };
+    });
+}
+//# sourceMappingURL=captureLink.js.map

package/dist/lib/captureLink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"captureLink.js","sourceRoot":"","sources":["../../src/lib/captureLink.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIlD,mHAAmH;AACnH,MAAM,UAAU,gBAAgB,CAAC,KAAwB,EAAE,KAAwB;IACjF,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,IAAI,QAAQ,CAAC,GAAG,KAAK,CAAC,MAAM,oBAAoB,KAAK,CAAC,MAAM,kDAAkD,EAAE;YACpH,IAAI,EAAE,SAAS,CAAC,iBAAiB,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,sFAAsF;SAC5J,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CAAC,uCAAuC,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,iBAAiB,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,yEAAyE,EAAE,CAAC,CAAC;QAClN,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,QAAQ,CAAC,UAAU,SAAS,+CAA+C,EAAE;gBACrF,IAAI,EAAE,SAAS,CAAC,iBAAiB,EAAE,QAAQ,EAAE,YAAY;gBACzD,QAAQ,EAAE,4CAA4C,SAAS,gFAAgF;aAChJ,CAAC,CAAC;QACL,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/checklist.d.ts

@@ -0,0 +1,151 @@
+/**
+ * TASK-1026 (WP-862, RULE-664): THE sentence for the link that reaches a spine rung, built from
+ * SPINE_RUNG_SEQUENCE. `rung` is the level the link reaches: rungLine('vision') is "A strategy hangs on
+ * an accepted vision with part_of." and rungLine('key_result') is "A work package validates an accepted key result."
+ * Null for a kind that is no rung. It names kinds and the verb only (DEC-1994); each surface appends
+ * its own Next line. The checklist rung lines, SPINE_LINKS_LINES, the capture reply, relate and
+ * preflight help and the MCP relations and capture descriptions all print it; one test pins it.
+ * `label` words a kind (TASK-1027: preflight passes the workspace's own labels; default the kind's own words).
+ */
+export declare function rungLine(rung: string, label?: (kind: string) => string): string | null;
+/** TASK-1164 (DEC-2295): a spine link that skips the rung it owes, in rungLine's words. skippedRungLine('key_result',
+ *  'objective') is "A work package validates an accepted key result, never an objective." */
+export declare function skippedRungLine(owed: string, skippedTo: string): string | null;
+/** TASK-1164 (DEC-2295): how many accepted entries on the rung above a create receipt names, and how long each name runs. */
+export declare const SPINE_CANDIDATES_NAMED = 3;
+/**
+ * TASK-1164 (DEC-2295, RULE-662): what a spine create's receipt says about the accepted entries on the rung above it, names
+ * first. The one link written: "Linked to Ship invoicing (KR-2), the only accepted key result." Otherwise the ones to choose
+ * from, at most three by name: "Needs a key result: Ship invoicing (KR-2), Ten founders (KR-3), Renewals (KR-6) and 4 more."
+ * `complete` false (the read hit its bound) never counts the rest: "and more". Null with none, so the receipt keeps rungLine.
+ */
+export declare function spineCandidatesLine(parentKind: string, candidates: ReadonlyArray<{
+    entryId: string;
+    name: string;
+}>, { linked, complete }: {
+    linked: boolean;
+    complete: boolean;
+}): string | null;
+/** TASK-1164 (DEC-2295 addendum, DEC-1994): a second part_of to the rung above, names only; each surface adds its move door. */
+export declare function heldParentLine(childKind: string, parentName: string): string;
+/** TASK-1233 (TEN-5878): a move asked for an entry that hangs on no parent yet; each surface adds the plain relate as its Next. */
+export declare function nothingToMoveLine(childKind: string): string;
+/** TASK-1233 (TEN-5878): a move asked for an entry on two or more parents; a person keeps one, so no surface adds a Next. */
+export declare function manyParentsLine(childKind: string, parents: ReadonlyArray<{
+    entryId?: string;
+    name: string;
+}>): string;
+/** TASK-1164 (DEC-2295 addendum): the history row and receipt of an explicit move to a new parent. */
+export declare function movedParentLine(newParentName: string, oldParentName: string): string;
+/** Every rung's sentence, child to parent: what help and tool descriptions list. */
+export declare const SPINE_RUNG_LINES: readonly string[];
+/** The one direction line (TASK-1214): the rungs top first, how they link and the plan under them, from the rung sequence. The agent
+ *  block prints it and the MCP connector instructions read it, so it is worded once for every surface. */
+export declare const DIRECTION_LINE: string;
+/**
+ * TASK-1026 (WP-862): the spine-grammar lines the session start prints after the direction line,
+ * at most 11 words each and no command, kept beside rungLine so the start text adds no wording of its own.
+ */
+export declare const SPINE_LINKS_LINES: readonly string[];
+/**
+ * TASK-1038 (WP-863, RULE-664): the one refusal an entry that links to nothing it serves meets, and the refusal of an accept
+ * that is not verified yet. The kernel names the fix in words (DEC-1994); the CLI and the MCP add their own command. The
+ * telemetry (kernel/telemetry/coherencyEvent.ts) sorts a thrown refusal by these sentences, so a change here moves both.
+ */
+export declare const LINK_REFUSAL_WORDS: {
+    readonly unlinked: "This entry links to nothing it serves.";
+    readonly linkOrReason: "Link it to what it serves, or say why it stands alone.";
+    readonly linkOrAnswer: "Link it to what it serves, or answer why it stands alone.";
+    readonly linkThenSave: "Link it to what it serves, then save it again.";
+    readonly orientFirst: "Orient this session first, then save it again.";
+    readonly savedAnyway: "This entry links to nothing it serves yet; it was saved anyway.";
+    readonly reasonTooShort: (chars: number) => string;
+    readonly linkRoute: "Link it to the work package, goal or principle it serves, then try again; a linked entry needs no answer.";
+    readonly answerRoute: "Pick the answer that fits; a reason is needed only if you diverge.";
+    readonly reasonRoute: "Say why it stands alone; your name is kept with it.";
+    readonly notVerified: "This entry is not verified yet. Verify it, then accept it again.";
+    readonly verifyRoute: "Verify the entry, then accept it again.";
+    readonly personAccepts: "Only a person can accept this entry; a person accepts it in Product Brain.";
+    readonly notAccepted: (entryId: string) => string;
+    readonly notChanged: (entryId: string) => string;
+    /** The accept preview's label for an accept that would not go through (signed row 31). */
+    readonly wouldBeRefused: "Would be refused";
+    /** The accept preview's label for an accept that would go through, beside wouldBeRefused. */
+    readonly wouldBeAccepted: "Would be accepted";
+    /** The refusal steps: each step's title and its retry button, carried on the payload for the CLI and MCP accept refusal. */
+    readonly steps: {
+        readonly link: {
+            readonly title: "Link the authorizing entry";
+            readonly cta: "I've linked it — retry";
+        };
+        readonly answer: {
+            readonly title: "Answer it";
+            readonly cta: "Record my answer, then retry";
+            readonly legend: "Your answer";
+        };
+        readonly reason: {
+            readonly title: "Override with a typed reason";
+            readonly cta: "Override & retry";
+            readonly label: "Typed override reason";
+        };
+        readonly verify: {
+            readonly title: "Verify the entry";
+            readonly cta: "I've verified it — retry";
+        };
+        readonly person: {
+            readonly title: "A human must accept it directly";
+            readonly cta: "I've had a human accept it — retry";
+        };
+    };
+    readonly heldBundle: (count: number) => string;
+};
+/** The fix a thrown accept refusal names, from the row its error data carries (`details`, the field that crosses the gateway). */
+export declare function refusalFixOf(details: readonly unknown[] | undefined): 'verify' | 'person' | null;
+/** The words no line a person or agent reads may use (RULE-705 check 2); a method draft naming one is refused. */
+export declare const VOICE_BANNED_WORDS: readonly string[];
+/** The first banned word a line uses as a word (its plural too), or undefined: the one test a method line and a served line meet. */
+export declare const bannedWordIn: (line: string) => string | undefined;
+/** One instruction per criterion id, per gated rubric. A kernel test pins it to the rubrics. */
+export declare const CHECKLIST_LINES: Readonly<Record<string, Readonly<Record<string, string>>>>;
+/** TASK-1161 (DEC-2292): the criteria that block an accept, per spine kind, each measured to the block bar by X6; the rest coach.
+ *  The set moves only through the weekly blind read (DEC-2275); a kind with no row here keeps every criterion required. */
+export declare const BLOCKING_CRITERIA: Readonly<Record<string, readonly string[]>>;
+/** A criterion holds an accept when it is in its kind's set, its kind has none, or a structural fact (no judge) failed it. */
+export declare function isRequiredCriterion(kind: string, c: {
+    id: string;
+    passed: boolean;
+    failedBy?: string;
+}): boolean;
+export interface ChecklistCriterion {
+    id: string;
+    passed: boolean;
+    /** What the AI judge named as concretely absent, on a fail. */
+    missing?: string;
+    failedBy?: string;
+    questionTemplate?: string;
+    /** This verdict's own instruction in place of the rubric line: the spine gate's failing rung names its blocking entry (TASK-1027). */
+    line?: string;
+}
+/** The checklist's three states as words, one constant: every row a refusal or a prompt prints opens with one. */
+export declare const CHECKLIST_STATE_WORDS: {
+    readonly met: "Met";
+    readonly not_yet: "Not yet";
+    readonly judging: "Still judging";
+};
+/** The one line over a refused accept's rows, on every surface that shows them. */
+export declare const ACCEPT_REFUSAL_HEADLINE = "Not accepted yet";
+/** The one line over a refused or held save (DEC-2334, RULE-664): the entry panel's foot, the held edit's lines, the daily limit. */
+export declare const SAVE_REFUSAL_HEADLINE = "Not saved yet";
+/** The kind a part_of_any entry (a task) hangs on: the work package below the first rung. */
+export declare const PART_OF_ANY_PARENT_KIND = "work_package";
+/** A refused accept's row for an entry with no parent link, on every surface that shows the rows: the parent kind in the
+ *  workspace's own lower-case words, or what it belongs to when the kind is unknown (Voice signed both, 2026-10-25). */
+export declare function missingParentLine(parentWord?: string | null): string;
+/** TASK-1161: the header over the questions a failed coaching criterion asks; they never block. */
+export declare const COACHING_HEADER = "Worth asking (does not block):";
+/**
+ * The checklist lines for an entry's verdict, or null when its type has no checklist.
+ * `judging` is true while the AI verdict has not settled; a failed non-blocking criterion prints "? <its question>".
+ */
+export declare function renderChecklist(canonicalKey: string, criteria: readonly ChecklistCriterion[], judging: boolean): string[] | null;
+//# sourceMappingURL=checklist.d.ts.map

package/dist/lib/checklist.d.ts.map

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