@productbrain/cli 0.1.0-beta.94 → 0.1.0-beta.9413

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

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

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

package/dist/generators/portable-knowledge.js

@@ -5,25 +5,8 @@
 import { readdirSync, readFileSync, existsSync } from 'fs';
 import { join, basename } from 'path';
 import { MARKER } from './adapters.js';
-/**
- * Committed adapter targets — these correspond to files that are checked into the repo.
- * Rules with persist: 'local' must never be included in arrays that feed these targets.
- */
-const COMMITTED_ADAPTER_TARGETS = new Set(['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 function isPersistLocal(rule) {
-    return rule.persist === 'local';
-}
 /** Returns true if the entry should be emitted to the given target. */
 export function shouldEmitToTarget(entry, target) {
-    // Local rules must not go to committed adapter targets (copilot, codex)
-    if ('persist' in entry && entry.persist === 'local' && COMMITTED_ADAPTER_TARGETS.has(target)) {
-        return false;
-    }
     if (!entry.targets)
         return true;
     return entry.targets.includes(target);
@@ -35,45 +18,11 @@ const LEVEL_HIERARCHY = {
 };
 const VALID_LEVELS = new Set(Object.keys(LEVEL_HIERARCHY));
 /**
- * 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 const STAGE_TO_MAX_LEVEL = {
-    blank: 'beginner',
-    seed: 'intermediate',
-    grounded: 'expert',
-    connected: 'expert',
-    critical: 'expert',
-};
-/** Level ordering used to pick the more restrictive of two levels. */
-export const LEVEL_ORDER = ['beginner', 'intermediate', 'expert'];
-/**
- * Pick the more restrictive of two levels.
- * If either is undefined, returns the other (or undefined if both are).
- */
-function capLevel(requested, cap) {
-    if (!requested && !cap)
-        return undefined;
-    if (!requested)
-        return cap;
-    if (!cap)
-        return requested;
-    const requestedIdx = LEVEL_ORDER.indexOf(requested);
-    const capIdx = LEVEL_ORDER.indexOf(cap);
-    return LEVEL_ORDER[Math.min(requestedIdx, capIdx)];
-}
-/**
- * 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 function filterByLevel(items, requestedLevel, stage) {
-    // Resolve stage cap (fail-open for unknown/undefined stage)
-    const stageCap = stage ? STAGE_TO_MAX_LEVEL[stage] : undefined;
+export function filterByLevel(items, requestedLevel) {
     // Resolve requested level as typed enum (validate if provided)
     let typedRequested;
     if (requestedLevel) {
@@ -82,16 +31,12 @@ export function filterByLevel(items, requestedLevel, stage) {
         }
         typedRequested = requestedLevel;
     }
-    // Determine effective level (most restrictive)
-    const effectiveLevel = capLevel(typedRequested, stageCap);
-    // No effective level — return all items (backward compat)
-    if (!effectiveLevel)
+    // No requested level — return all items (backward compat)
+    if (!typedRequested)
         return items;
-    const allowedLevels = LEVEL_HIERARCHY[effectiveLevel];
+    const allowedLevels = LEVEL_HIERARCHY[typedRequested];
     return items.filter((item) => !item.level || allowedLevels.includes(item.level));
 }
-// ── Stage ordering ────────────────────────────────────────────────────
-const STAGE_ORDER = ['blank', 'seed', 'grounded', 'connected', 'critical'];
 /**
  * Evaluate when_* conditions against the workspace profile and repo context.
  * Returns { included, reasons }.
@@ -100,7 +45,7 @@ const STAGE_ORDER = ['blank', 'seed', 'grounded', 'connected', 'critical'];
  * the item is included (preserves current behavior when Chain is unavailable).
  */
 export function evaluateConditions(conditions, profile, repoContext) {
-    const hasProfileConditions = conditions.when_minStage !== undefined || conditions.when_minGovernance !== undefined;
+    const hasProfileConditions = conditions.when_minGovernance !== undefined;
     const hasStackCondition = conditions.when_stack !== undefined;
     // No when_* keys at all — always include
     if (!hasProfileConditions && !hasStackCondition) {
@@ -124,18 +69,6 @@ export function evaluateConditions(conditions, profile, repoContext) {
             reasons.push(`when_stack=${conditions.when_stack} matched`);
         }
     }
-    // when_minStage: profile guaranteed non-null here when this condition is present
-    if (conditions.when_minStage !== undefined && profile !== null) {
-        const profileIdx = STAGE_ORDER.indexOf(profile.stage);
-        const thresholdIdx = STAGE_ORDER.indexOf(conditions.when_minStage);
-        if (thresholdIdx === -1 || profileIdx === -1 || profileIdx < thresholdIdx) {
-            included = false;
-            reasons.push(`when_minStage=${conditions.when_minStage} but workspace stage=${profile.stage}`);
-        }
-        else {
-            reasons.push(`when_minStage=${conditions.when_minStage} satisfied (stage=${profile.stage})`);
-        }
-    }
     // when_minGovernance: profile guaranteed non-null here when this condition is present
     if (conditions.when_minGovernance !== undefined && profile !== null) {
         const threshold = parseInt(conditions.when_minGovernance, 10);
@@ -213,12 +146,9 @@ export function readCanonicalSkills(productbrainDir) {
         const level = fields.get('level');
         const conditions = {};
         const whenStack = fields.get('when_stack');
-        const whenMinStage = fields.get('when_minStage');
         const whenMinGovernance = fields.get('when_minGovernance');
         if (whenStack)
             conditions.when_stack = whenStack;
-        if (whenMinStage)
-            conditions.when_minStage = whenMinStage;
         if (whenMinGovernance)
             conditions.when_minGovernance = whenMinGovernance;
         const hasConditions = Object.keys(conditions).length > 0;
@@ -239,28 +169,26 @@ export function readCanonicalRules(productbrainDir) {
         const name = fields.get('name') ?? basename(file, '.md');
         const description = fields.get('description') ?? '';
         const scope = fields.get('scope');
+        const applyTo = fields.get('applyTo');
         const autoApply = fields.get('autoApply') === 'true';
         const targets = arrayFields.get('targets');
         const level = fields.get('level');
         const conditions = {};
         const whenStack = fields.get('when_stack');
-        const whenMinStage = fields.get('when_minStage');
         const whenMinGovernance = fields.get('when_minGovernance');
         if (whenStack)
             conditions.when_stack = whenStack;
-        if (whenMinStage)
-            conditions.when_minStage = whenMinStage;
         if (whenMinGovernance)
             conditions.when_minGovernance = whenMinGovernance;
         const hasConditions = Object.keys(conditions).length > 0;
-        rules.push({ name, description, scope, autoApply, body, sourcePath: filePath, targets: targets?.length ? targets : undefined, level: level || undefined, conditions: hasConditions ? conditions : undefined });
+        rules.push({ name, description, scope, applyTo: applyTo || undefined, autoApply, body, sourcePath: filePath, targets: targets?.length ? targets : undefined, level: level || undefined, conditions: hasConditions ? conditions : undefined });
     }
     return rules.sort((a, b) => a.name.localeCompare(b.name));
 }
 /**
  * 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 function readPersonalLayer(productbrainDir) {
     const localRulesDir = join(productbrainDir, '.local', 'rules');
@@ -275,17 +203,15 @@ export function readPersonalLayer(productbrainDir) {
         const name = fields.get('name') ?? basename(file, '.md');
         const description = fields.get('description') ?? '';
         const scope = fields.get('scope');
+        const applyTo = fields.get('applyTo');
         const autoApply = fields.get('autoApply') === 'true';
         const targets = arrayFields.get('targets');
         const level = fields.get('level');
         const conditions = {};
         const whenStack = fields.get('when_stack');
-        const whenMinStage = fields.get('when_minStage');
         const whenMinGovernance = fields.get('when_minGovernance');
         if (whenStack)
             conditions.when_stack = whenStack;
-        if (whenMinStage)
-            conditions.when_minStage = whenMinStage;
         if (whenMinGovernance)
             conditions.when_minGovernance = whenMinGovernance;
         const hasConditions = Object.keys(conditions).length > 0;
@@ -293,6 +219,7 @@ export function readPersonalLayer(productbrainDir) {
             name,
             description,
             scope,
+            applyTo: applyTo || undefined,
             autoApply,
             body,
             sourcePath: filePath,
@@ -307,7 +234,7 @@ export function readPersonalLayer(productbrainDir) {
 /**
  * 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 function readPersonalSkillsLayer(productbrainDir) {
     const localSkillsDir = join(productbrainDir, '.local', 'skills');
@@ -326,12 +253,9 @@ export function readPersonalSkillsLayer(productbrainDir) {
         const level = fields.get('level');
         const conditions = {};
         const whenStack = fields.get('when_stack');
-        const whenMinStage = fields.get('when_minStage');
         const whenMinGovernance = fields.get('when_minGovernance');
         if (whenStack)
             conditions.when_stack = whenStack;
-        if (whenMinStage)
-            conditions.when_minStage = whenMinStage;
         if (whenMinGovernance)
             conditions.when_minGovernance = whenMinGovernance;
         const hasConditions = Object.keys(conditions).length > 0;
@@ -555,59 +479,4 @@ export function validateCodexSkills(skills) {
     }
     return warnings;
 }
-// ── Claude Code generators ────────────────────────────────────────────
-/**
- * Generate a Claude Code .md rule from a canonical rule.
- * Claude Code expects: description, optional paths (array).
- */
-export function generateClaudeRule(rule, profile) {
-    // Replace canonical paths with Claude Code paths in body
-    const body = rule.body
-        .replace(/\.productbrain\/rules\/(\S+)\.md/g, '.claude/rules/$1.md')
-        .replace(/\.productbrain\/skills\/(\S+)\.md/g, '.productbrain/skills/$1.md');
-    // Build frontmatter
-    const fmLines = ['---'];
-    fmLines.push(`description: "${rule.description.replace(/"/g, '\\"')}"`);
-    if (rule.scope) {
-        fmLines.push('paths:');
-        fmLines.push(`  - "${rule.scope}"`);
-    }
-    fmLines.push('---');
-    return `${fmLines.join('\n')}
-<!-- ${MARKER} — source: .productbrain/rules/${rule.name}.md -->
-
-${body}`;
-}
-/**
- * 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 function generateClaudeSkillRouter(skills, profile) {
-    if (skills.length === 0)
-        return '';
-    const triggerBlocks = skills.map((skill) => {
-        const triggerList = skill.triggers.map((t) => `"${t}"`).join(' / ');
-        return `- User says ${triggerList}
-  → READ \`.productbrain/skills/${skill.name}.md\` — follow its full protocol`;
-    });
-    return `---
-description: "Skill activation router — MUST read skill file before responding when triggers match"
----
-<!-- ${MARKER} — source: generated from .productbrain/skills/*.md -->
-
-# Skill Router — Mandatory Activation
-
-BEFORE responding to ANY user message, scan for these triggers.
-If ANY trigger matches: READ the skill file FIRST, then follow its full protocol.
-Do NOT respond with your own approach. The skill IS the approach.
-
-## Triggers
-
-${triggerBlocks.join('\n\n')}
-
-## Why This Matters
-
-Skipping the skill file produces a shallow response that misses governance, blast radius, and Chain context. This is the #1 quality failure in this workspace. The skill files encode the full protocol — including Chain checks, domain identification, and review gates — that a direct response will miss.
-`;
-}
 //# sourceMappingURL=portable-knowledge.js.map