@productbrain/cli 0.1.0-beta.83 → 0.1.0-beta.8304

package/dist/generators/boundary-manifest.real-file.test.js

@@ -0,0 +1,70 @@
+/**
+ * Guard against the #366 session-start regression (PR #380 hotfix): PR #366's rewrite of
+ * `.productbrain/rules/architecture-boundaries.md` shipped `eval-isolation-no-production-import`
+ * (a `kind: policyBoundary, status: active` entry) with `chainRefs: []`. `pb session start` runs
+ * `runHandshake(...)`, which (whenever `boundary_enforcement_mode !== 'advisory'`) calls
+ * `generateBoundaryManifest` on this exact file — its `validateBoundaryRules` throws on any
+ * active policyBoundary with an empty `chainRefs`, so `session start` exited 1 and never
+ * persisted the session marker, taking every downstream `pb` write command down with it
+ * (SESSION_REQUIRED). `boundary-manifest.test.ts` (sibling file) only exercises the parser
+ * against synthetic in-memory fixtures via a mocked `fs` — nothing asserted that the REAL,
+ * COMMITTED file actually validates, which is exactly how #366 shipped a file that broke this
+ * path through CI unnoticed.
+ *
+ * This file does NOT mock `fs` — it reads the real repo-root
+ * `.productbrain/rules/architecture-boundaries.md` and runs it through the exact functions
+ * `pb session start` -> `runHandshake` -> `generateBoundaryManifest` calls, so a future rewrite
+ * that reintroduces an empty-chainRefs active policyBoundary (or any other validation failure)
+ * fails THIS test instead of shipping silently.
+ */
+import { describe, expect, it } from 'vitest';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { generateBoundaryManifest, parseBoundaryRules } from './boundary-manifest.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// repo root: packages/cli/src/generators -> ../../../..
+const REPO_ROOT = join(__dirname, '..', '..', '..', '..');
+const PB_DIR = join(REPO_ROOT, '.productbrain');
+const SOURCE_PATH = join(PB_DIR, 'rules', 'architecture-boundaries.md');
+describe('boundary manifest generator — real committed file (session-start regression guard)', () => {
+    it('the committed architecture-boundaries.md is non-empty and has the expected frontmatter shape', () => {
+        // Sanity floor before the real assertion below — if this fails, REPO_ROOT resolution
+        // itself has drifted (e.g. the test moved), not the boundary data.
+        const raw = readFileSync(SOURCE_PATH, 'utf8');
+        expect(raw.length).toBeGreaterThan(0);
+        expect(raw.startsWith('---\n')).toBe(true);
+    });
+    it('every active policyBoundary in the committed file has a non-empty chainRefs (the exact #366 regression)', () => {
+        const raw = readFileSync(SOURCE_PATH, 'utf8');
+        const rules = parseBoundaryRules(raw);
+        expect(rules.length).toBeGreaterThan(0);
+        // Copilot review (PR #381): `rule.chainRefs` comes from hand-authored markdown parsed by
+        // parseBoundaryRules — a rule entry that omits the `chainRefs:` key entirely never gets
+        // the property set, so `rule.chainRefs` can be `undefined` (not just `[]`) at runtime,
+        // even though BoundaryRule's TS type claims `chainRefs: string[]` unconditionally. A bare
+        // `rule.chainRefs.length === 0` would throw a TypeError on that undefined case instead of
+        // failing with the clear assertion message below — treat "missing or not a non-empty
+        // array" as the SAME violation (this is exactly the #366 regression shape: an active
+        // policyBoundary with no usable chainRefs, however that absence is spelled).
+        const violations = rules.filter((rule) => rule.kind === 'policyBoundary' && rule.status === 'active' && !(Array.isArray(rule.chainRefs) && rule.chainRefs.length > 0));
+        expect(violations.map((rule) => rule.id), 'Every active policyBoundary needs at least one chainRef — an empty chainRefs here is ' +
+            'exactly the #366 regression that made pb session start exit 1 (runHandshake -> ' +
+            'generateBoundaryManifest -> validateBoundaryRules throws), which took every ' +
+            'downstream pb write command down with it (SESSION_REQUIRED, deployed path).').toEqual([]);
+    });
+    it('generateBoundaryManifest does not throw against the real committed file — the exact pb session start -> runHandshake call path', () => {
+        // Calls the SAME function runHandshake calls (packages/cli/src/commands/handshake.ts,
+        // `boundaryManifestContent = ... : generateBoundaryManifest(pbDir)`), against the SAME
+        // real file on disk `pb session start` reads — no mock, no synthetic fixture.
+        expect(() => generateBoundaryManifest(PB_DIR)).not.toThrow();
+        const manifest = generateBoundaryManifest(PB_DIR);
+        expect(manifest).not.toBeNull();
+        // Parses back cleanly as the JSON shape generateBoundaryManifest documents.
+        const parsed = JSON.parse(manifest);
+        expect(parsed.schemaVersion).toBe(1);
+        expect(Array.isArray(parsed.rules)).toBe(true);
+        expect(parsed.rules.length).toBe(parseBoundaryRules(readFileSync(SOURCE_PATH, 'utf8')).length);
+    });
+});
+//# sourceMappingURL=boundary-manifest.real-file.test.js.map

package/dist/generators/boundary-manifest.real-file.test.js.map

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

package/dist/generators/boundary-manifest.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=boundary-manifest.test.d.ts.map

package/dist/generators/boundary-manifest.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-manifest.test.d.ts","sourceRoot":"","sources":["../../src/generators/boundary-manifest.test.ts"],"names":[],"mappings":""}

package/dist/generators/boundary-manifest.test.js

@@ -0,0 +1,91 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { join } from 'path';
+const { vfs, PB_DIR } = vi.hoisted(() => ({
+    vfs: {},
+    PB_DIR: '/tmp/pb-test/.productbrain',
+}));
+vi.mock('fs', () => ({
+    existsSync: vi.fn((path) => path in vfs),
+    readFileSync: vi.fn((path, _enc) => {
+        if (path in vfs)
+            return vfs[path];
+        throw Object.assign(new Error(`ENOENT: no such file '${path}'`), { code: 'ENOENT' });
+    }),
+}));
+import { generateBoundaryManifest, getBoundaryEnforcementMode, parseBoundaryRules, } from './boundary-manifest.js';
+const SOURCE_PATH = join(PB_DIR, 'rules', 'architecture-boundaries.md');
+function boundaryMarkdown(depcruiseRuleName = 'core-no-feature') {
+    return `---
+name: architecture-boundaries
+enforcement:
+  boundaries:
+    - id: core-no-feature
+      kind: policyBoundary
+      status: active
+      scope: convex
+      chainRefs: [BR-19, ARCH-29]
+      description: "Core must not import Feature."
+      from:
+        path: "^convex/gitchain/"
+      to:
+        path: "^convex/chainwork/"
+      severity: error
+      enforcement:
+        depcruiseRuleName: ${depcruiseRuleName}
+    - id: no-circular
+      kind: localOnlyTechnical
+      status: active
+      scope: repo
+      chainRefs: []
+      description: "Technical graph integrity check."
+      enforcement:
+        depcruiseRuleName: no-circular
+---
+
+# Architecture Boundaries
+`;
+}
+describe('boundary manifest generator', () => {
+    beforeEach(() => {
+        Object.keys(vfs).forEach((key) => delete vfs[key]);
+        vi.clearAllMocks();
+    });
+    it('defaults new workspaces to advisory mode', () => {
+        expect(getBoundaryEnforcementMode(null)).toBe('advisory');
+    });
+    it('parses structured Product Brain boundary frontmatter', () => {
+        const rules = parseBoundaryRules(boundaryMarkdown());
+        expect(rules).toHaveLength(2);
+        expect(rules[0]).toMatchObject({
+            id: 'core-no-feature',
+            kind: 'policyBoundary',
+            status: 'active',
+            scope: 'convex',
+            chainRefs: ['BR-19', 'ARCH-29'],
+            from: { path: '^convex/gitchain/' },
+            to: { path: '^convex/chainwork/' },
+            severity: 'error',
+            enforcement: { depcruiseRuleName: 'core-no-feature' },
+        });
+    });
+    it('generates a stable manifest with source and chain metadata', () => {
+        vfs[SOURCE_PATH] = boundaryMarkdown();
+        const content = generateBoundaryManifest(PB_DIR);
+        expect(content).not.toBeNull();
+        const manifest = JSON.parse(content);
+        expect(manifest.sources[0].path).toBe('.productbrain/rules/architecture-boundaries.md');
+        expect(manifest.chainSources.map((source) => source.entryId)).toEqual([
+            'ARCH-29',
+            'BR-19',
+        ]);
+        expect(manifest.rules.map((rule) => rule.id)).toEqual([
+            'core-no-feature',
+            'no-circular',
+        ]);
+    });
+    it('rejects duplicate dependency-cruiser rule names', () => {
+        vfs[SOURCE_PATH] = boundaryMarkdown('no-circular');
+        expect(() => generateBoundaryManifest(PB_DIR)).toThrow('Duplicate dependency-cruiser rule name "no-circular".');
+    });
+});
+//# sourceMappingURL=boundary-manifest.test.js.map

package/dist/generators/boundary-manifest.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary-manifest.test.js","sourceRoot":"","sources":["../../src/generators/boundary-manifest.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACxC,GAAG,EAAE,EAA4B;IACjC,MAAM,EAAE,4BAA4B;CACrC,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACnB,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,IAAI,GAAG,CAAC;IAChD,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAY,EAAE,IAAa,EAAE,EAAE;QAClD,IAAI,IAAI,IAAI,GAAG;YAAE,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,IAAI,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvF,CAAC,CAAC;CACH,CAAC,CAAC,CAAC;AAEJ,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,4BAA4B,CAAC,CAAC;AAExE,SAAS,gBAAgB,CAAC,iBAAiB,GAAG,iBAAiB;IAC7D,OAAO;;;;;;;;;;;;;;;;6BAgBoB,iBAAiB;;;;;;;;;;;;CAY7C,CAAC;AACF,CAAC;AAED,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QACnD,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,KAAK,GAAG,kBAAkB,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAC7B,EAAE,EAAE,iBAAiB;YACrB,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,QAAQ;YAChB,KAAK,EAAE,QAAQ;YACf,SAAS,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC;YAC/B,IAAI,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE;YACnC,EAAE,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE;YAClC,QAAQ,EAAE,OAAO;YACjB,WAAW,EAAE,EAAE,iBAAiB,EAAE,iBAAiB,EAAE;SACtD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,GAAG,CAAC,WAAW,CAAC,GAAG,gBAAgB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAQ,CAAC,CAAC;QACtC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QACxF,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAA2B,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YACzF,SAAS;YACT,OAAO;SACR,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAoB,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACpE,iBAAiB;YACjB,aAAa;SACd,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,GAAG,CAAC,WAAW,CAAC,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,EAAE,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CACpD,uDAAuD,CACxD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/generators/context-md.d.ts

@@ -4,5 +4,5 @@
  */
 import type { OrientViewFromApi } from '../commands/orient.js';
 import type { RepoContext } from '../lib/repo-detect.js';
-export declare function generateContextMd(view: OrientViewFromApi, repo: RepoContext, timestamp: string, stage?: string): string;
+export declare function generateContextMd(view: OrientViewFromApi, repo: RepoContext, timestamp: string): string;
 //# sourceMappingURL=context-md.d.ts.map

package/dist/generators/context-md.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-md.d.ts","sourceRoot":"","sources":["../../src/generators/context-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAWzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAuHvH"}
+{"version":3,"file":"context-md.d.ts","sourceRoot":"","sources":["../../src/generators/context-md.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAYzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA0FvG"}

package/dist/generators/context-md.js

@@ -2,6 +2,7 @@
  * Generates .productbrain/context.md — workspace briefing snapshot.
  * Pure function: orient view in, markdown string out.
  */
+import { formatWorkspaceWideRuleLines } from '../lib/ruleListRender.js';
 function entryLine(e, maxPreview = 100) {
     const id = e.entryId ?? e.name;
     if (e.preview) {
@@ -10,7 +11,7 @@ function entryLine(e, maxPreview = 100) {
     }
     return `- **${id}** — ${e.name}`;
 }
-export function generateContextMd(view, repo, timestamp, stage) {
+export function generateContextMd(view, repo, timestamp) {
     const lines = [];
     lines.push('<!-- auto-generated by pb handshake — ' + timestamp + ' -->');
     lines.push('<!-- Re-run `pb handshake` to refresh. Do not edit manually. -->');
@@ -21,21 +22,6 @@ export function generateContextMd(view, repo, timestamp, stage) {
     if (repo.name)
         lines.push(`_Repo: ${repo.name}${repo.repoSlug ? ` (${repo.repoSlug})` : ''}_`);
     lines.push('');
-    // Stage
-    lines.push('## Stage');
-    lines.push(`**${view.stage}**`);
-    lines.push('');
-    // First-session directive for blank workspaces
-    if (stage === 'blank') {
-        lines.push('## First Session');
-        lines.push('');
-        lines.push('This is a fresh workspace. Help the user make their first capture:');
-        lines.push('1. Ask what they are working on right now');
-        lines.push('2. Run `pb capture "DEC: <what they decided>"` or `pb capture "TEN: <what is unresolved>"`');
-        lines.push('3. Run `pb orient -b` to confirm the entry appeared');
-        lines.push('4. Run `pb handshake` to refresh this context');
-        lines.push('');
-    }
     // Strategic context
     const sc = view.strategicContext;
     lines.push('## Strategic Context');
@@ -43,17 +29,17 @@ export function generateContextMd(view, repo, timestamp, stage) {
         lines.push(`- **Vision**: ${sc.vision}`);
     if (sc.purpose)
         lines.push(`- **Purpose**: ${sc.purpose}`);
-    if (sc.currentBet)
-        lines.push(`- **Current bet**: ${sc.currentBet}`);
-    lines.push(`- **Active bets**: ${sc.activeBetCount}`);
+    if (sc.currentWorkPackage)
+        lines.push(`- **Current work package**: ${sc.currentWorkPackage}`);
+    lines.push(`- **Active work packages**: ${sc.activeWorkPackageCount}`);
     lines.push(`- **Active tensions**: ${sc.activeTensionCount}`);
     if (sc.productAreas.length > 0)
         lines.push(`- **Product areas**: ${sc.productAreas.join(', ')}`);
     lines.push('');
-    // Active bets
-    if (view.activeBets.length > 0) {
-        lines.push('## Active Bets');
-        for (const bet of view.activeBets.slice(0, 10)) {
+    // Active work packages
+    if (view.activeWorkPackages.length > 0) {
+        lines.push('## Active Work Packages');
+        for (const bet of view.activeWorkPackages.slice(0, 10)) {
             lines.push(`- **${bet.entryId ?? bet.name}** — ${bet.name}`);
             if (bet.linkedTensions && bet.linkedTensions.length > 0) {
                 for (const t of bet.linkedTensions.slice(0, 3)) {
@@ -63,29 +49,14 @@ export function generateContextMd(view, repo, timestamp, stage) {
         }
         lines.push('');
     }
-    // Governance
-    const gov = view.governance;
-    if (gov) {
-        const hasGov = gov.principles.length > 0 || gov.standards.length > 0 || gov.businessRules.length > 0;
-        if (hasGov) {
-            lines.push('## Governance');
-            if (gov.principles.length > 0) {
-                lines.push('### Principles');
-                for (const p of gov.principles.slice(0, 5))
-                    lines.push(entryLine(p));
-            }
-            if (gov.standards.length > 0) {
-                lines.push('### Standards');
-                for (const s of gov.standards.slice(0, 5))
-                    lines.push(entryLine(s));
-            }
-            if (gov.businessRules.length > 0) {
-                lines.push('### Business Rules');
-                for (const br of gov.businessRules.slice(0, 5))
-                    lines.push(entryLine(br));
-            }
-            lines.push('');
-        }
+    // This file is shared by every session in the worktree, so only workspace-wide rules belong
+    // in it: the Everyone bucket, never Team or Role. Those two stay session-scoped, served by
+    // `pb session start` / `pb orient` output.
+    const ruleLines = formatWorkspaceWideRuleLines(view.ruleLists);
+    if (ruleLines.length > 0) {
+        lines.push('## Rules');
+        lines.push(...ruleLines);
+        lines.push('');
     }
     // Architecture notes
     if (view.architectureNotes && view.architectureNotes.length > 0) {

package/dist/generators/context-md.js.map

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

package/dist/generators/context-md.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context-md.test.d.ts.map

package/dist/generators/context-md.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-md.test.d.ts","sourceRoot":"","sources":["../../src/generators/context-md.test.ts"],"names":[],"mappings":""}

package/dist/generators/context-md.test.js

@@ -0,0 +1,82 @@
+/**
+ * context.md renders the Everyone rule list only (TASK-436, DEC-1774). `.productbrain/context.md`
+ * is one shared file per worktree, written by whichever session last ran `pb handshake` — Team
+ * and Role rules are session-scoped (an agent's own role, an agent's own team), so writing them
+ * into a file every session in the worktree reads would leak one session's rules into another's.
+ * Team/Role rules reach an agent through `pb session start` / `pb orient` output instead, which
+ * are per-session, not shared.
+ */
+import { describe, expect, it } from 'vitest';
+import { generateContextMd } from './context-md.js';
+const REPO = {
+    name: 'product-os',
+    description: null,
+    gitRemote: null,
+    repoSlug: null,
+    detectedStack: [],
+    isMonorepo: false,
+};
+function makeView(overrides = {}) {
+    return {
+        strategicContext: {
+            vision: null,
+            purpose: null,
+            activeBetCount: 0,
+            activeWorkPackageCount: 0,
+            currentWorkPackage: null,
+            activeTensionCount: 0,
+            productAreas: [],
+            productAreaCount: 0,
+        },
+        activeWorkPackages: [],
+        tensions: [],
+        architectureNotes: [],
+        proposals: [],
+        absenceSignals: [],
+        plannedWork: { uncommittedDrafts: [], inProgressEntries: [], openTensions: [] },
+        priorSessions: [],
+        recoveryBlock: null,
+        ...overrides,
+    };
+}
+describe('generateContextMd — Rules section (view.ruleLists)', () => {
+    it('renders the Everyone rule list under "## Rules", never Team or Role', () => {
+        const view = makeView({
+            ruleLists: {
+                everyone: { rows: [{ entryId: 'RULE-234', bucket: 'everyone' }], overCap: 0 },
+                team: { rows: [{ entryId: 'RULE-99', bucket: 'team', teamId: 'TEAM-1' }], overCap: 0 },
+                role: { rows: [{ entryId: 'RULE-42', bucket: 'role', ownerRoleId: 'ROLE-1' }], overCap: 0 },
+                unassigned: 0,
+                truncated: false,
+            },
+        });
+        const md = generateContextMd(view, REPO, '2026-09-27T00:00:00.000Z');
+        expect(md).toContain('## Rules');
+        expect(md).toContain('Everyone:');
+        expect(md).toContain('RULE-234');
+        // Team and Role are session-scoped — never written to the shared file.
+        expect(md).not.toContain('Team:');
+        expect(md).not.toContain('RULE-99');
+        expect(md).not.toContain('Role:');
+        expect(md).not.toContain('RULE-42');
+    });
+    it('omits the Rules section when only Team/Role are populated (no Everyone rules)', () => {
+        const view = makeView({
+            ruleLists: {
+                everyone: { rows: [], overCap: 0 },
+                team: { rows: [{ entryId: 'RULE-99', bucket: 'team', teamId: 'TEAM-1' }], overCap: 0 },
+                role: { rows: [{ entryId: 'RULE-42', bucket: 'role', ownerRoleId: 'ROLE-1' }], overCap: 0 },
+                unassigned: 0,
+                truncated: false,
+            },
+        });
+        const md = generateContextMd(view, REPO, '2026-09-27T00:00:00.000Z');
+        expect(md).not.toContain('## Rules');
+    });
+    it('omits the Rules section when ruleLists is absent (unseeded/pre-B1 workspace)', () => {
+        const view = makeView();
+        const md = generateContextMd(view, REPO, '2026-09-27T00:00:00.000Z');
+        expect(md).not.toContain('## Rules');
+    });
+});
+//# sourceMappingURL=context-md.test.js.map

package/dist/generators/context-md.test.js.map

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

package/dist/generators/everyone-rules-md.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Generates .productbrain/generated/everyone-rules.md — the workspace's Everyone-applies rule
+ * list (DEC-1774), one entry per served rule.
+ *
+ * TASK-341 (WP-777, round 2b): reuses the SAME `formatWorkspaceWideRuleLines` renderer
+ * `context.md`'s own "## Rules" section uses — one reader, two projections, never a second
+ * re-derivation of "the everyone list". Pure function: rendered lines in, markdown string out.
+ */
+export declare function generateEveryoneRulesMd(ruleLines: string[], timestamp: string): string;
+//# sourceMappingURL=everyone-rules-md.d.ts.map

package/dist/generators/everyone-rules-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"everyone-rules-md.d.ts","sourceRoot":"","sources":["../../src/generators/everyone-rules-md.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAgBtF"}

package/dist/generators/everyone-rules-md.js

@@ -0,0 +1,27 @@
+/**
+ * Generates .productbrain/generated/everyone-rules.md — the workspace's Everyone-applies rule
+ * list (DEC-1774), one entry per served rule.
+ *
+ * TASK-341 (WP-777, round 2b): reuses the SAME `formatWorkspaceWideRuleLines` renderer
+ * `context.md`'s own "## Rules" section uses — one reader, two projections, never a second
+ * re-derivation of "the everyone list". Pure function: rendered lines in, markdown string out.
+ */
+export function generateEveryoneRulesMd(ruleLines, timestamp) {
+    const lines = [];
+    lines.push('<!-- auto-generated by pb handshake — ' + timestamp + ' -->');
+    lines.push('<!-- Re-run `pb handshake` to refresh. Do not edit manually. -->');
+    lines.push('');
+    lines.push('# Everyone Rules');
+    lines.push('');
+    lines.push(`_Generated: ${timestamp}_`);
+    lines.push('');
+    if (ruleLines.length > 0) {
+        lines.push(...ruleLines);
+    }
+    else {
+        lines.push('_No Everyone-applies rules are currently Current and accepted for this workspace._');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=everyone-rules-md.js.map

package/dist/generators/everyone-rules-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"everyone-rules-md.js","sourceRoot":"","sources":["../../src/generators/everyone-rules-md.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,UAAU,uBAAuB,CAAC,SAAmB,EAAE,SAAiB;IAC5E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,wCAAwC,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;IAC1E,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;IAC/E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,eAAe,SAAS,GAAG,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAC;IACnG,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/generators/manifest.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Manifest reader — reads .productbrain/manifest.yaml for adoption state.
+ * WP-310 E1: personal workspace layer — manifest-based filtering.
+ * WP-421 S1 (#35): extends Manifest with DEC-951 authority keys (`materialize`,
+ * `surfaces`, `lock`) and adds `readManifestStatus()` — a typed reader that
+ * returns the FULL UNION of legacy + new fields plus a `parseStatus`
+ * discriminator (DEC-955, DEC-963 "Authority mode parse semantics").
+ *
+ * No external YAML dependency is required; the manifest schema is
+ * simple enough to parse with a minimal line-by-line parser.
+ */
+/** Authority materialize modes per DEC-951. */
+export type AuthorityMode = 'off' | 'observe' | 'project' | 'govern';
+/** Lock levels per DEC-951 — controls who can author a setup asset. */
+export type LockLevel = 'platform' | 'workspace' | 'personal';
+/** Parse status discriminator per DEC-963 (Authority mode parse semantics). */
+export type ManifestParseStatus = 'absent' | 'unparseable' | 'ok';
+export interface Manifest {
+    version: string;
+    method_source?: 'chain' | 'bundled';
+    boundary_enforcement_mode?: string;
+    boundaryEnforcementMode?: string;
+    /** Allowlist — if present and non-empty, ONLY these rule/skill names pass. */
+    adopted?: string[];
+    /** Denylist — always excluded regardless of adopted list. */
+    rejected?: string[];
+    hooks?: {
+        cursor?: boolean;
+        copilot?: boolean;
+    };
+    /**
+     * Authority materialize mode (DEC-951). Optional in the manifest file.
+     * When absent, `readManifestStatus()` defaults to 'observe' per DEC-955.
+     */
+    materialize?: AuthorityMode;
+    /**
+     * Surfaces this workspace allows PB to project to (e.g. `.claude`, `.cursor`).
+     * Per STD-236, disk writes are permitted ONLY within these surfaces (plus
+     * the hard-coded `.productbrain/` root).
+     */
+    surfaces?: string[];
+    /**
+     * Per-asset lock overrides — maps asset id → lock level (DEC-951).
+     * Example: { "RULE-foo": "platform", "SKILL-bar": "workspace" }.
+     */
+    lock?: Record<string, LockLevel>;
+}
+/**
+ * Typed result returned by `readManifestStatus()` (WP-421 S1, #35).
+ *
+ * Shape: full union of legacy + WP-421 keys + parse-status discriminator.
+ * Defaults (DEC-955, DEC-963):
+ *   - No `.productbrain/` directory:      mode='off',     parseStatus='absent'
+ *   - Folder + no manifest:               mode='observe', parseStatus='absent'
+ *   - Manifest present + no `materialize`: mode='observe', parseStatus='ok'
+ *   - Malformed YAML:                     mode='observe', parseStatus='unparseable'
+ *
+ * Critical invariant (DEC-963): when `parseStatus !== 'ok'`, mode is NEVER
+ * 'project' or 'govern'. The reader fails closed to 'observe'.
+ */
+export interface ManifestStatus {
+    /** Effective authority mode after defaults applied. */
+    mode: AuthorityMode;
+    /** Surfaces list; empty array when manifest is absent or `surfaces` key missing. */
+    surfaces: string[];
+    /** Per-asset lock overrides; empty object when absent. */
+    lock: Record<string, LockLevel>;
+    /** Parse-status discriminator. */
+    parseStatus: ManifestParseStatus;
+    /**
+     * The underlying parsed `Manifest` when `parseStatus === 'ok'`, else null.
+     * Callers needing legacy fields (adopted/rejected/hooks/method_source) read
+     * them from this object — keeps the legacy `readManifest()` shape intact
+     * while exposing the WP-421 typed contract through `mode`/`surfaces`/`lock`.
+     */
+    manifest: Manifest | null;
+}
+/**
+ * Read .productbrain/manifest.yaml.
+ * Returns null if the file is absent or unparseable (treat as no-op).
+ *
+ * Legacy reader — kept for callers that only need adoption-state filtering.
+ * WP-421 callers should prefer `readManifestStatus()` for typed authority
+ * mode + parse-status discriminator.
+ */
+export declare function readManifest(productbrainDir: string): Manifest | null;
+/**
+ * Read manifest with full WP-421 authority typing (#35).
+ *
+ * Returns the FULL UNION of legacy + DEC-951 keys plus a `parseStatus`
+ * discriminator. Defaults per DEC-955 / DEC-963:
+ *   - `.productbrain/` directory absent → mode='off', parseStatus='absent'
+ *   - Directory present, manifest absent → mode='observe', parseStatus='absent'
+ *   - Manifest present, no `materialize:` → mode='observe', parseStatus='ok'
+ *   - Manifest unparseable / fails shape validation → mode='observe',
+ *     parseStatus='unparseable' (NEVER 'project'/'govern' — fail closed).
+ *
+ * @param productbrainDir Absolute path to the `.productbrain/` directory.
+ *   The directory itself MAY be absent — caller passes the candidate path
+ *   regardless and this reader infers the mode from filesystem state.
+ */
+export declare function readManifestStatus(productbrainDir: string): ManifestStatus;
+/**
+ * Filter a list of items by the manifest's adopted/rejected lists.
+ *
+ * Rules:
+ * - No manifest → return all items unchanged (no-op, preserves current behaviour).
+ * - rejected denylist applied first — excluded regardless of adopted.
+ * - adopted allowlist applied second — only items in the list pass (only when non-empty).
+ * - Empty adopted array → allowlist is inactive, all non-rejected items pass.
+ */
+export declare function filterByAdoptionState<T extends {
+    name: string;
+}>(items: T[], manifest: Manifest | null): T[];
+//# sourceMappingURL=manifest.d.ts.map

package/dist/generators/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/generators/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErE,uEAAuE;AACvE,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAE9D,+EAA+E;AAC/E,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,aAAa,GAAG,IAAI,CAAC;AAElE,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACpC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IAEF;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,IAAI,EAAE,aAAa,CAAC;IACpB,oFAAoF;IACpF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAChC,kCAAkC;IAClC,WAAW,EAAE,mBAAmB,CAAC;IACjC;;;;;OAKG;IACH,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC3B;AA8KD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAUrE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,cAAc,CAyC1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC9D,KAAK,EAAE,CAAC,EAAE,EACV,QAAQ,EAAE,QAAQ,GAAG,IAAI,GACxB,CAAC,EAAE,CAgBL"}