@productbrain/cli 0.1.0-beta.96 → 0.1.0-beta.9616

package/dist/generators/context-md.js

@@ -1,7 +1,13 @@
 /**
  * Generates .productbrain/context.md — workspace briefing snapshot.
- * Pure function: orient view in, markdown string out.
+ * Pure function: orient view and the workspace briefing lines in, markdown string out.
+ *
+ * TASK-554 (WP-777, DEC-1888): the briefing (spine and the Everyone rule list, each rule one
+ * sentence with its why) comes from the one kernel builder (`formatWorkspaceBriefingLines`), the
+ * same lines everyone-rules.md and chain.mdc carry. This file is shared by every session in the
+ * worktree, so team and role lists never enter it; session start and orient serve those.
  */
+import { cutNote } from '../formatters/plannedWorkCounts.js'; // TEN-4562
 function entryLine(e, maxPreview = 100) {
     const id = e.entryId ?? e.name;
     if (e.preview) {
@@ -10,7 +16,7 @@ function entryLine(e, maxPreview = 100) {
     }
     return `- **${id}** — ${e.name}`;
 }
-export function generateContextMd(view, repo, timestamp, stage) {
+export function generateContextMd(view, briefingLines, 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,39 +27,18 @@ 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('## Briefing');
+    lines.push(...briefingLines);
     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');
-    if (sc.vision)
-        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}`);
+    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,30 +48,6 @@ 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('');
-        }
-    }
     // Architecture notes
     if (view.architectureNotes && view.architectureNotes.length > 0) {
         lines.push('## Architecture');
@@ -109,17 +70,17 @@ export function generateContextMd(view, repo, timestamp, stage) {
         if (hasPlanned) {
             lines.push('## Planned Work');
             if (pw.uncommittedDrafts.length > 0) {
-                lines.push('### Drafts');
+                lines.push(`### Drafts${cutNote(pw.uncommittedDrafts.length, pw.draftsTruncated)}`);
                 for (const d of pw.uncommittedDrafts.slice(0, 5))
                     lines.push(`- ${d.name} [${d.collection}]`);
             }
             if (pw.inProgressEntries.length > 0) {
-                lines.push('### In Progress');
+                lines.push(`### In Progress${cutNote(pw.inProgressEntries.length, pw.inProgressTruncated)}`);
                 for (const e of pw.inProgressEntries.slice(0, 5))
                     lines.push(`- ${e.name} [${e.collection}]`);
             }
             if (pw.openTensions.length > 0) {
-                lines.push('### Open Tensions');
+                lines.push(`### Open Tensions${cutNote(pw.openTensions.length, pw.openTensionsTruncated)}`);
                 for (const t of pw.openTensions.slice(0, 5))
                     lines.push(`- ${t.name}`);
             }

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/everyone-rules-md.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generates .productbrain/generated/everyone-rules.md — the workspace briefing every session in a
+ * worktree shares: the spine and the Everyone rule list, each rule one sentence with its why
+ * (TASK-554, WP-777, DEC-1888). The lines come from the one kernel briefing builder
+ * (`formatWorkspaceBriefingLines`), the same lines context.md and chain.mdc carry.
+ * Pure function: rendered lines in, markdown string out.
+ */
+export declare function generateEveryoneRulesMd(briefingLines: 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;;;;;;GAMG;AAEH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAY1F"}

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

@@ -0,0 +1,21 @@
+/**
+ * Generates .productbrain/generated/everyone-rules.md — the workspace briefing every session in a
+ * worktree shares: the spine and the Everyone rule list, each rule one sentence with its why
+ * (TASK-554, WP-777, DEC-1888). The lines come from the one kernel briefing builder
+ * (`formatWorkspaceBriefingLines`), the same lines context.md and chain.mdc carry.
+ * Pure function: rendered lines in, markdown string out.
+ */
+export function generateEveryoneRulesMd(briefingLines, timestamp) {
+    return [
+        '<!-- auto-generated by pb handshake — ' + timestamp + ' -->',
+        '<!-- Re-run `pb handshake` to refresh. Do not edit manually. -->',
+        '',
+        '# Everyone Rules',
+        '',
+        `_Generated: ${timestamp}_`,
+        '',
+        ...briefingLines,
+        '',
+    ].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;;;;;;GAMG;AAEH,MAAM,UAAU,uBAAuB,CAAC,aAAuB,EAAE,SAAiB;IAChF,OAAO;QACL,wCAAwC,GAAG,SAAS,GAAG,MAAM;QAC7D,kEAAkE;QAClE,EAAE;QACF,kBAAkB;QAClB,EAAE;QACF,eAAe,SAAS,GAAG;QAC3B,EAAE;QACF,GAAG,aAAa;QAChB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/generators/manifest.d.ts

@@ -1,10 +1,20 @@
 /**
  * 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';
@@ -18,12 +28,78 @@ export interface Manifest {
         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.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/generators/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,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;CACH;AA4GD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAmBrE;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"}
+{"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"}

package/dist/generators/manifest.js

@@ -1,6 +1,10 @@
 /**
  * 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.
@@ -110,9 +114,75 @@ function parseScalar(val) {
     return stripped;
 }
 // ── Public API ─────────────────────────────────────────────────────────
+/** Valid AuthorityMode values, derived once for runtime guards. */
+const VALID_AUTHORITY_MODES = new Set([
+    'off',
+    'observe',
+    'project',
+    'govern',
+]);
+/** Valid LockLevel values. */
+const VALID_LOCK_LEVELS = new Set([
+    'platform',
+    'workspace',
+    'personal',
+]);
+/**
+ * Validate a parsed manifest object against the union schema.
+ * Returns the typed Manifest on success, null on any shape violation.
+ *
+ * Shared between `readManifest()` and `readManifestStatus()` so legacy
+ * callers and the WP-421 typed reader agree on what counts as parseable.
+ */
+function validateManifestShape(parsed) {
+    // Require version to be a string; reject missing or non-string values
+    if (typeof parsed.version !== 'string')
+        return null;
+    // Validate array fields — scalar values (e.g. adopted: "rule-a") must be rejected
+    if (parsed.adopted !== undefined && !Array.isArray(parsed.adopted))
+        return null;
+    if (parsed.rejected !== undefined && !Array.isArray(parsed.rejected))
+        return null;
+    // Validate method_source if present — only 'chain' | 'bundled' are valid
+    if (parsed.method_source !== undefined &&
+        parsed.method_source !== 'chain' &&
+        parsed.method_source !== 'bundled')
+        return null;
+    // ── WP-421 S1 — DEC-951 keys ─────────────────────────────────────────
+    // materialize: optional; if present, must be a known AuthorityMode.
+    if (parsed.materialize !== undefined &&
+        !(typeof parsed.materialize === 'string' && VALID_AUTHORITY_MODES.has(parsed.materialize))) {
+        return null;
+    }
+    // surfaces: optional; if present, must be an array of strings.
+    if (parsed.surfaces !== undefined) {
+        if (!Array.isArray(parsed.surfaces))
+            return null;
+        if (!parsed.surfaces.every((s) => typeof s === 'string'))
+            return null;
+    }
+    // lock: optional; if present, must be a plain object whose values are valid LockLevels.
+    if (parsed.lock !== undefined) {
+        if (parsed.lock === null ||
+            typeof parsed.lock !== 'object' ||
+            Array.isArray(parsed.lock)) {
+            return null;
+        }
+        for (const value of Object.values(parsed.lock)) {
+            if (typeof value !== 'string' || !VALID_LOCK_LEVELS.has(value)) {
+                return null;
+            }
+        }
+    }
+    return parsed;
+}
 /**
  * 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 function readManifest(productbrainDir) {
     const manifestPath = join(productbrainDir, 'manifest.yaml');
@@ -121,25 +191,66 @@ export function readManifest(productbrainDir) {
     try {
         const raw = readFileSync(manifestPath, 'utf8');
         const parsed = parseManifestYaml(raw);
-        // Require version to be a string; reject missing or non-string values
-        if (typeof parsed.version !== 'string')
-            return null;
-        // Validate array fields — scalar values (e.g. adopted: "rule-a") must be rejected
-        if (parsed.adopted !== undefined && !Array.isArray(parsed.adopted))
-            return null;
-        if (parsed.rejected !== undefined && !Array.isArray(parsed.rejected))
-            return null;
-        // Validate method_source if present — only 'chain' | 'bundled' are valid
-        if (parsed.method_source !== undefined &&
-            parsed.method_source !== 'chain' &&
-            parsed.method_source !== 'bundled')
-            return null;
-        return parsed;
+        return validateManifestShape(parsed);
     }
     catch {
         return null; // malformed manifest = treat as absent
     }
 }
+/**
+ * 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 function readManifestStatus(productbrainDir) {
+    // No `.productbrain/` directory at all → mode 'off' (DEC-955).
+    if (!existsSync(productbrainDir)) {
+        return { mode: 'off', surfaces: [], lock: {}, parseStatus: 'absent', manifest: null };
+    }
+    const manifestPath = join(productbrainDir, 'manifest.yaml');
+    // Directory present but no manifest file → mode 'observe', absent.
+    if (!existsSync(manifestPath)) {
+        return { mode: 'observe', surfaces: [], lock: {}, parseStatus: 'absent', manifest: null };
+    }
+    let raw;
+    try {
+        raw = readFileSync(manifestPath, 'utf8');
+    }
+    catch {
+        // I/O failure — treat as unparseable, fail closed to observe (DEC-963).
+        return { mode: 'observe', surfaces: [], lock: {}, parseStatus: 'unparseable', manifest: null };
+    }
+    let parsed;
+    try {
+        parsed = parseManifestYaml(raw);
+    }
+    catch {
+        return { mode: 'observe', surfaces: [], lock: {}, parseStatus: 'unparseable', manifest: null };
+    }
+    const validated = validateManifestShape(parsed);
+    if (validated === null) {
+        // Shape violation (e.g. invalid materialize value, malformed lock map).
+        // Fail closed to observe per DEC-963 — NEVER project/govern.
+        return { mode: 'observe', surfaces: [], lock: {}, parseStatus: 'unparseable', manifest: null };
+    }
+    return {
+        mode: validated.materialize ?? 'observe',
+        surfaces: validated.surfaces ?? [],
+        lock: validated.lock ?? {},
+        parseStatus: 'ok',
+        manifest: validated,
+    };
+}
 /**
  * Filter a list of items by the manifest's adopted/rejected lists.
  *

package/dist/generators/manifest.js.map

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

package/dist/generators/noProjectionAssets.d.ts

@@ -0,0 +1,15 @@
+/**
+ * findNoProjectionAssets — extracted to its own file (STD-2/DEC-1504/DEC-1724 module-health
+ * ratchet: both handshake.ts and portable-knowledge.ts are grandfathered, over-budget,
+ * shrink-only files; this single-purpose function was extracted rather than added in place).
+ *
+ * REPORT-ONLY (WP-759/TASK-234, DEC-1736): entries whose `targets` names only `claude` — the
+ * one surface with no surviving rule/skill projection. Not re-targeted or dropped here; the
+ * caller reports them so a human re-targets in Cortex.
+ */
+import type { CanonicalRule, CanonicalSkill } from './portable-knowledge.js';
+export declare function findNoProjectionAssets(skills: CanonicalSkill[], rules: CanonicalRule[]): Array<{
+    name: string;
+    targets: string[];
+}>;
+//# sourceMappingURL=noProjectionAssets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"noProjectionAssets.d.ts","sourceRoot":"","sources":["../../src/generators/noProjectionAssets.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE7E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,aAAa,EAAE,GACrB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAI5C"}

package/dist/generators/noProjectionAssets.js

@@ -0,0 +1,6 @@
+export function findNoProjectionAssets(skills, rules) {
+    return [...skills, ...rules]
+        .filter((entry) => entry.targets && entry.targets.length > 0 && entry.targets.every((t) => t === 'claude'))
+        .map((entry) => ({ name: entry.name, targets: entry.targets }));
+}
+//# sourceMappingURL=noProjectionAssets.js.map

package/dist/generators/noProjectionAssets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noProjectionAssets.js","sourceRoot":"","sources":["../../src/generators/noProjectionAssets.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,sBAAsB,CACpC,MAAwB,EACxB,KAAsB;IAEtB,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;SACzB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC;SAC1G,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAmB,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/generators/portable-knowledge.d.ts

@@ -2,10 +2,10 @@
  * Portable knowledge — reads canonical skills/rules from .productbrain/
  * and generates tool-specific copies for Cursor, Claude Code, etc.
  */
-import type { SurfaceProfile } from './surface-profiles.js';
+import type { SurfaceProfile, TargetName } from './surface-profiles.js';
+export type { TargetName };
 export interface WhenConditions {
     when_stack?: string;
-    when_minStage?: string;
     when_minGovernance?: string;
 }
 export interface CanonicalSkill {
@@ -17,51 +17,39 @@ export interface CanonicalSkill {
     targets?: string[];
     level?: string;
     conditions?: WhenConditions;
-    /** 'team' = default (projected to committed adapter files); 'local' = local surface files only, never committed. */
+    /** 'team' = default; 'local' = local surface files only, never committed. */
     persist?: 'local' | 'team';
 }
 export interface CanonicalRule {
     name: string;
     description: string;
     scope?: string;
+    /**
+     * Path-scope glob for path-aware surfaces (e.g. "convex/**\/*.ts"). Drives the
+     * GitHub Copilot `.github/instructions/<name>.instructions.md` fan-out (applyTo frontmatter)
+     * and, in principle, nested CLAUDE.md/AGENTS.md placement. Absent = repo-wide only.
+     */
+    applyTo?: string;
     autoApply: boolean;
     body: string;
     sourcePath: string;
     targets?: string[];
     level?: string;
     conditions?: WhenConditions;
-    /** 'team' = default (projected to committed adapter files); 'local' = local surface files only, never committed. */
+    /** 'team' = default; 'local' = local surface files only, never committed. */
     persist?: 'local' | 'team';
 }
-export type TargetName = 'cursor' | 'claude' | 'copilot' | 'codex';
-/**
- * Returns true if the rule has persist: 'local'.
- * Local rules are written to local surface files (.claude/rules/, .cursor/rules/)
- * but must never be projected to committed adapter files (CLAUDE.md, AGENTS.md, etc.).
- */
-export declare function isPersistLocal(rule: CanonicalRule): boolean;
 /** Returns true if the entry should be emitted to the given target. */
 export declare function shouldEmitToTarget(entry: CanonicalRule | CanonicalSkill, target: TargetName): boolean;
 export type HandshakeLevel = 'beginner' | 'intermediate' | 'expert';
 /**
- * Maps workspace stage to the maximum allowed HandshakeLevel.
- * Stages not listed here apply no cap (fail-open for unknown stages).
- * Note: 'beginner' level allows only 'core' items; 'intermediate' allows core + intermediate.
- */
-export declare const STAGE_TO_MAX_LEVEL: Record<string, HandshakeLevel>;
-/** Level ordering used to pick the more restrictive of two levels. */
-export declare const LEVEL_ORDER: HandshakeLevel[];
-/**
- * Filter items by graduated level, with optional workspace stage-gating.
- * - If requestedLevel is undefined/null AND stage provides no cap: return ALL items (backward compat).
+ * Filter items by graduated level.
+ * - If requestedLevel is undefined/null: return ALL items (backward compat).
  * - Items with no `level` field: always included (backward compat).
- * - Stage caps the effective level: blank→beginner, seed→intermediate, grounded/connected/critical→expert.
- * - If stage is unknown or null: no cap applied (fail-open).
- * - The effective level is min(requestedLevel, stageCap) — most restrictive wins.
  */
 export declare function filterByLevel<T extends {
     level?: string;
-}>(items: T[], requestedLevel?: string, stage?: string): T[];
+}>(items: T[], requestedLevel?: string): T[];
 /**
  * Evaluate when_* conditions against the workspace profile and repo context.
  * Returns { included, reasons }.
@@ -70,7 +58,6 @@ export declare function filterByLevel<T extends {
  * the item is included (preserves current behavior when Chain is unavailable).
  */
 export declare function evaluateConditions(conditions: WhenConditions, profile: {
-    stage: string;
     totalRelations: number;
 } | null, repoContext: {
     detectedStack: string[];
@@ -83,13 +70,13 @@ export declare function readCanonicalRules(productbrainDir: string): CanonicalRu
 /**
  * Read machine-local personal rules from .productbrain/.local/rules/.
  * Returns [] when the directory is absent — no-op when personal layer is not set up.
- * Every returned rule has persist: 'local' set, preventing projection to committed adapter files.
+ * Every returned rule has persist: 'local' set, marking it as part of the personal layer.
  */
 export declare function readPersonalLayer(productbrainDir: string): CanonicalRule[];
 /**
  * Read machine-local personal skills from .productbrain/.local/skills/.
  * Returns [] when the directory is absent — no-op when personal layer is not set up.
- * Every returned skill has persist: 'local' set, preventing projection to committed adapter files.
+ * Every returned skill has persist: 'local' set, marking it as part of the personal layer.
  */
 export declare function readPersonalSkillsLayer(productbrainDir: string): CanonicalSkill[];
 /**
@@ -152,14 +139,4 @@ export interface CodexValidationWarning {
  * Scans the transport-stripped body (so claude-only blocks don't false-positive).
  */
 export declare function validateCodexSkills(skills: CanonicalSkill[]): CodexValidationWarning[];
-/**
- * Generate a Claude Code .md rule from a canonical rule.
- * Claude Code expects: description, optional paths (array).
- */
-export declare function generateClaudeRule(rule: CanonicalRule, profile?: SurfaceProfile): string;
-/**
- * Generate a Claude Code skill-router.md — imperative skill activation rule.
- * Loaded automatically by Claude Code via .claude/rules/ with no paths (always active).
- */
-export declare function generateClaudeSkillRouter(skills: CanonicalSkill[], profile?: SurfaceProfile): string;
 //# sourceMappingURL=portable-knowledge.d.ts.map