@productbrain/cli 0.1.0-beta.77 → 0.1.0-beta.7700

package/dist/generated/routeLatencyBudget.generated.js

@@ -0,0 +1,294 @@
+// GENERATED by scripts/generate-route-latency-budget.mjs from packages/kernel-client/src/routeLatencyBudget.ts
+// and packages/kernel-client/src/generated/routes.generated.ts.
+// DO NOT EDIT. Run `npm run route-budget:codegen` to regenerate.
+//
+// WP-575 (TEN-2917, TEN-1126), commits_to DEC-64. This file is emitted IDENTICALLY into
+// packages/mcp-server and packages/cli so the two connectors cannot disagree about how
+// long a gateway route may take — the defect this work package removes was exactly that
+// disagreement (MCP hardcoded a blanket 10s, the CLI set none at all).
+//
+// The rationale — why route TYPE is the structural predictor of LLM exposure, and how
+// each value is grounded in DEC-64 rather than invented — lives with the declaration in
+// packages/kernel-client/src/routeLatencyBudget.ts. Read that file before changing a
+// number here; changing it HERE does nothing, the next codegen run overwrites it.
+//
+// Why a copy and not an import: both connectors consume @productbrain/kernel-client
+// TYPE-ONLY (mcp-server via a tsconfig paths alias for Railway's isolated Docker build,
+// DEC-701; cli as a devDependency it must not emit into its published dist/). A budget
+// sets an AbortSignal, so it is runtime code and cannot be type-erased. See the
+// generator header for the full constraint.
+/** The budget table, copied verbatim from the SSOT. Milliseconds. */
+export const ROUTE_LATENCY_BUDGET_MS = {
+    query: 10_000,
+    mutation: 10_000,
+    action: 30_000,
+};
+/**
+ * PER-ROUTE OVERRIDES — routes whose OWN server-side deadline exceeds their type's budget
+ * (PR #533 review, Codex P1). Route type predicts LLM EXPOSURE, not LLM COUNT: a flat
+ * action budget assumed every action is one inline LLM call, and shipped actions declare
+ * far longer deadlines. Bounding those at the type budget aborts a call the server is
+ * still legitimately working on. Each value is derived from a deadline the SERVER
+ * declares — see the SSOT for the citation behind every number.
+ */
+export const ROUTE_LATENCY_BUDGET_OVERRIDE_MS = {
+    // convex/intelligence/onboardingChat.ts:333 declares `timeoutMs: 45_000` for the extraction
+    // LLM call — 15s BEYOND the flat action budget. 60s clears it with room for the surrounding
+    // request/response work the 45s covers none of.
+    'onboarding.chat': 60_000,
+    // convex/intelligence/spineCheck.ts:210 sets SPINE_CHECK_WALL_CLOCK_BUDGET_MS = 4 * 60_000
+    // for its SEQUENTIAL strategy probes (:225-239, deliberately not Promise.all), and :215
+    // reserves a tail of one 25s probe + an optional 25s story pass + 10s. The server's own
+    // design ceiling is scheduleSpineCheck's 5-min MAX_RUN_IN_FLIGHT_MS lease (:206-209).
+    // 5.5 min sits above that ceiling and far under Convex's 10-min action cap.
+    'quality.spineCheck': 330_000,
+    // convex/digest/compose.ts declares `timeoutMs: 120_000` (LLM_TIMEOUT_MS) for the digest
+    // composer's callOpenRouter call — but callOpenRouter's own MAX_RETRIES (=1,
+    // convex/lib/llm/openrouter.ts) means a transient-status (408/409/429/5xx) failure gets ONE
+    // retry of the FULL call, so the wrapper's genuine worst-case wall-clock is 2 attempts ×
+    // 120_000ms = 240_000ms, not a single attempt's timeout (PR #1122 round 1 review, P1 — the
+    // prior 150_000 sized for one attempt only). 270s clears the two-attempt worst case with
+    // room for the preceding cohort read (convex/digest/cohort.ts) and the surrounding
+    // request/response work neither the timeout nor the retry budget covers.
+    'chain.runDigest': 270_000,
+};
+/**
+ * The widest declared budget — the fail-safe default for a route name this map does not
+ * know. Derived from the tables rather than restated, so it cannot drift if a value moves.
+ * Spans the overrides too, so the unknown-route default is never TIGHTER than a budget
+ * already granted to a known route.
+ */
+export const WIDEST_ROUTE_LATENCY_BUDGET_MS = Math.max(...Object.values(ROUTE_LATENCY_BUDGET_MS), ...Object.values(ROUTE_LATENCY_BUDGET_OVERRIDE_MS));
+/** Every gateway route's Convex function type, from convex/http.ts's registry. */
+const ROUTE_TYPE_ENTRIES = {
+    "resolveWorkspace": "query",
+    "feedback.submit": "mutation",
+    "feedback.listOwn": "query",
+    "feedback.list": "action",
+    "feedback.note": "action",
+    "feedback.group": "action",
+    "feedback.status": "action",
+    "organisation.status": "query",
+    "organisation.assignMembership": "mutation",
+    "organisation.removeMembership": "mutation",
+    "organisation.setOwnership": "mutation",
+    "organisation.repairTeamShape": "mutation",
+    "organisation.hierarchy.show": "query",
+    "organisation.hierarchy.setParent": "mutation",
+    "organisation.hierarchy.clearParent": "mutation",
+    "acceptPolicy.approve": "mutation",
+    "acceptPolicy.retire": "mutation",
+    "acceptPolicy.list": "query",
+    "chain.seed": "mutation",
+    "chain.listCollections": "query",
+    "chain.getCollection": "query",
+    "chain.getCollectionFields": "query",
+    "chain.auditCollections": "query",
+    "chain.exportDefinitions": "query",
+    "chain.updateCollection": "mutation",
+    "chain.listEntries": "query",
+    "chain.listEntriesPaged": "query",
+    "chain.getEntry": "query",
+    "chain.preflightEntry": "query",
+    "chain.listByRole": "query",
+    "chain.getQualityVerdict": "query",
+    "chain.batchGetEntries": "query",
+    "chain.createEntry": "action",
+    "chain.updateEntry": "mutation",
+    "chain.restoreArchivedEntry": "mutation",
+    "chain.moveToCollection": "mutation",
+    "chain.shapeAdvisories": "query",
+    "chain.shapeAdvisorySummary": "query",
+    "chain.showShapeAdvisory": "query",
+    "chain.dispositionShapeAdvisory": "mutation",
+    "outcomes.recordReading": "mutation",
+    "outcomes.listReadings": "query",
+    "outcomes.showOutcome": "query",
+    "conflicts.list": "query",
+    "conflicts.resolve": "mutation",
+    "conflicts.summary": "query",
+    "conflicts.snooze": "mutation",
+    "conflicts.reverdict": "mutation",
+    "direction.list": "query",
+    "direction.refresh": "action",
+    "direction.defer": "mutation",
+    "question.create": "mutation",
+    "question.assign": "mutation",
+    "question.answer": "mutation",
+    "question.forceClose": "mutation",
+    "question.list": "query",
+    "chain.classifyCollection": "action",
+    "chain.classifyStrategyCategory": "query",
+    "chain.batchClassifyHeuristic": "query",
+    "chain.resolveCollection": "action",
+    "chain.searchEntries": "query",
+    "chain.searchByCanonicalName": "query",
+    "chain.commitEntry": "mutation",
+    "chain.verifyEntry": "mutation",
+    "chain.confirmEntry": "mutation",
+    "chain.batchCommitConstellation": "mutation",
+    "chain.listEntryHistory": "query",
+    "chain.listEntryVersions": "query",
+    "chain.createEntryRelation": "mutation",
+    "chain.createEntryRelations": "mutation",
+    "chain.removeEntryRelation": "mutation",
+    "chain.normalizeEntryDataLLM": "action",
+    "chain.decomposeContent": "action",
+    "chain.normalizeEntryDataPreview": "action",
+    "chain.listEntryRelations": "query",
+    "chain.scoreLinkCandidates": "query",
+    "chain.evaluateCoherence": "query",
+    "chain.listAutoLinkSuggestions": "query",
+    "chain.acceptAutoLinkSuggestion": "mutation",
+    "chain.dismissAutoLinkSuggestion": "mutation",
+    "chain.quarantineAutoLinkSuggestion": "mutation",
+    "chain.resurrectAutoLinkSuggestion": "mutation",
+    "chain.expireAutoLinkSuggestion": "mutation",
+    "chain.clusterAutoLinkSuggestions": "query",
+    "chain.batchApplyAutoLinkSuggestions": "action",
+    "chain.validateCommitConstellation": "query",
+    "chain.getCaptureContract": "query",
+    "chain.gatherContext": "query",
+    "chain.getConstellation": "query",
+    "chain.auditBet": "query",
+    "agentKnowledge.facilitateEnvelope": "action",
+    "agentKnowledge.wrapupEnvelope": "action",
+    "agentKnowledge.captureEnvelope": "action",
+    "chain.graphSuggestLinks": "query",
+    "chain.graphGatherContext": "query",
+    "chain.assembleBuildContext": "query",
+    "chain.qualityCheck": "query",
+    "chain.changeDetection": "query",
+    "chain.structuralAggregation": "query",
+    "chain.detectSemanticConflicts": "action",
+    "chain.taskAwareGatherContext": "query",
+    "chain.journeyAwareGatherContext": "query",
+    "chain.resolveTaskStartup": "query",
+    "chain.getBindingGovernanceView": "query",
+    "chain.resolveTaskStartupHybrid": "action",
+    "chain.taskAwareHybridGatherContext": "action",
+    "chain.gatherFromSeeds": "query",
+    "chain.getEntryNeighborhood": "query",
+    "chain.deepChainWalk": "action",
+    "chain.recordBriefRun": "mutation",
+    "chain.getLastBriefRun": "query",
+    "chain.incrementalChanges": "query",
+    "chain.compoundQuery": "action",
+    "chain.dismissSuggestion": "mutation",
+    "chain.recordSessionSignal": "mutation",
+    "chain.workspaceReadiness": "query",
+    "chain.getCaptureHealth": "query",
+    "chain.getGroundingHealth": "query",
+    "chain.recordGroundingOutcome": "mutation",
+    "chain.capture": "query",
+    "chain.runDigest": "action",
+    "chain.checkCardinalityWarning": "query",
+    "chain.ingestDocument": "action",
+    "chain.getOrientEntries": "query",
+    "chain.getOrientView": "action",
+    "chain.getRitualsSurface": "query",
+    "chain.getGovernanceWithRelations": "action",
+    "chain.classifyGovernance": "query",
+    "chain.getVocabulary": "query",
+    "scoreboard.get": "action",
+    "rework.report": "mutation",
+    "chain.listLabels": "query",
+    "chain.createLabel": "mutation",
+    "chain.updateLabel": "mutation",
+    "chain.deleteLabel": "mutation",
+    "chain.applyLabel": "mutation",
+    "chain.removeLabel": "mutation",
+    "chain.listEntriesByLabel": "query",
+    "gaps.record": "mutation",
+    "gaps.resolve": "mutation",
+    "gaps.top": "query",
+    "gaps.stats": "query",
+    "agent.startSession": "mutation",
+    "agent.resumeSession": "mutation",
+    "agent.closeSession": "mutation",
+    "agent.markOriented": "mutation",
+    "agent.touchSession": "mutation",
+    "agent.recordActivity": "mutation",
+    "agent.getSession": "query",
+    "agent.getActiveSession": "query",
+    "agent.recentSessions": "query",
+    "agent.activityStats": "query",
+    "agent.getActivityByDay": "query",
+    "agent.validateSession": "query",
+    "agent.getSessionWrapup": "query",
+    "agent.recordWrapup": "mutation",
+    "agent.reportOrientMetric": "mutation",
+    "agent.listSessions": "query",
+    "agent.showConversation": "query",
+    "usage.getWorkspaceSummary": "query",
+    "quality.evaluateHeuristicAndSchedule": "mutation",
+    "quality.reEvaluateEntry": "mutation",
+    "quality.evaluateAtCapture": "action",
+    "quality.evaluateAtCommit": "action",
+    "quality.evaluateForReview": "action",
+    "quality.getCachedVerdict": "query",
+    "quality.getLatestVerdictForEntry": "query",
+    "quality.spineCheck": "action",
+    "quality.scheduleSpineCheck": "mutation",
+    "quality.getLatestSpineVerdict": "query",
+    "onboarding.chat": "action",
+    "workspace.health": "query",
+    "workspace.healthAll": "query",
+    "workspace.backfill": "mutation",
+    "workspace.backfillAll": "mutation",
+    "performance.getVitalsSummary": "query",
+    "performance.getApiOverview": "query",
+    "performance.getRouteBreakdown": "query",
+    "performance.getSlowSamples": "query",
+    "performance.getSampleCount": "query",
+    "chainwork.getWorkflowRun": "query",
+    "chainwork.getLatestWorkflowRun": "query",
+    "chainwork.recordWorkflowCheckpoint": "mutation",
+    "chainwork.finalizeWorkflowRun": "action",
+    "chainwork.getLastVerifiedBrief": "query",
+    "staging.getCommittedSourceRefs": "query",
+    "staging.commitStagingEntryWithClassification": "action",
+    "governance.listProposals": "query",
+    "governance.countOpenProposals": "query",
+    "governance.respondToProposal": "mutation",
+};
+/**
+ * NULL-PROTOTYPE, deliberately (PR #533 review, Codex P2).
+ *
+ * A plain object literal inherits Object.prototype, so an unknown route name that
+ * collides with an inherited member — `toString`, `constructor`, `valueOf` — resolves to a
+ * TRUTHY function instead of falling through to the widest-budget default below. That
+ * yielded `AbortSignal.timeout(undefined)`, which THROWS before the call ever reaches the
+ * gateway — turning the fail-safe default into a hard failure.
+ *
+ * The SSOT scans an array (`GATEWAY_ROUTES.find`) and has no such hole, so a plain-object
+ * copy DISAGREED with the source it is generated from — precisely the connector drift this
+ * file exists to end. A null prototype restores parity for every consumer of the map at
+ * once (`latencyBudgetMsForRoute` here, `routeMayMutate` in both connectors' seams) rather
+ * than guarding each lookup and leaving the next one to rediscover it.
+ */
+export const ROUTE_TYPE_BY_NAME = Object.assign(Object.create(null), ROUTE_TYPE_ENTRIES);
+/** Budget for a route TYPE. Total over the three kinds the registry can produce. */
+export function latencyBudgetMsForRouteType(type) {
+    return ROUTE_LATENCY_BUDGET_MS[type];
+}
+/**
+ * Budget for a route by NAME.
+ *
+ * FAILS SAFE, DELIBERATELY: an unknown name gets the WIDEST budget, not the tightest and
+ * not a throw. Guessing low on a route we cannot classify would abort a call still
+ * legitimately in flight and re-create the exact false-failure this work package removes.
+ * Guessing high only delays surfacing a genuinely stuck call — and an unknown name is
+ * almost always a caller bug the gateway rejects in milliseconds anyway.
+ */
+export function latencyBudgetMsForRoute(routeName) {
+    // `Object.hasOwn`, not truthiness: the override table is a plain literal, so a bare
+    // lookup would resolve INHERITED members to a truthy value. Same hole the null
+    // prototype closes above, guarded here because this table stays a plain literal.
+    if (Object.hasOwn(ROUTE_LATENCY_BUDGET_OVERRIDE_MS, routeName)) {
+        return ROUTE_LATENCY_BUDGET_OVERRIDE_MS[routeName];
+    }
+    const type = ROUTE_TYPE_BY_NAME[routeName];
+    return type ? latencyBudgetMsForRouteType(type) : WIDEST_ROUTE_LATENCY_BUDGET_MS;
+}
+//# sourceMappingURL=routeLatencyBudget.generated.js.map

package/dist/generated/routeLatencyBudget.generated.js.map

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

package/dist/generated/sourceSurfaces.generated.d.ts

@@ -0,0 +1,12 @@
+/**
+ * GENERATED — DO NOT EDIT BY HAND.
+ *
+ * Source of truth: `kernel/telemetry/contextServed.ts` (CONTEXT_SERVED_SOURCES).
+ * Regenerate via: `npm run codegen` from `packages/cli`.
+ *
+ * Drift guard: src/__tests__/kernel-value-sets-drift.test.ts re-extracts the
+ * members from the source and fails CI when this file is stale.
+ */
+export declare const STARTUP_RESOLUTION_SIGNAL_SOURCE_SURFACES: readonly ["cli", "mcp", "app", "rest", "internal", "api"];
+export type StartupResolutionSourceSurface = (typeof STARTUP_RESOLUTION_SIGNAL_SOURCE_SURFACES)[number];
+//# sourceMappingURL=sourceSurfaces.generated.d.ts.map

package/dist/generated/sourceSurfaces.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceSurfaces.generated.d.ts","sourceRoot":"","sources":["../../src/generated/sourceSurfaces.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,yCAAyC,2DAA4D,CAAC;AACnH,MAAM,MAAM,8BAA8B,GAAG,CAAC,OAAO,yCAAyC,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/generated/sourceSurfaces.generated.js

@@ -0,0 +1,11 @@
+/**
+ * GENERATED — DO NOT EDIT BY HAND.
+ *
+ * Source of truth: `kernel/telemetry/contextServed.ts` (CONTEXT_SERVED_SOURCES).
+ * Regenerate via: `npm run codegen` from `packages/cli`.
+ *
+ * Drift guard: src/__tests__/kernel-value-sets-drift.test.ts re-extracts the
+ * members from the source and fails CI when this file is stale.
+ */
+export const STARTUP_RESOLUTION_SIGNAL_SOURCE_SURFACES = ['cli', 'mcp', 'app', 'rest', 'internal', 'api'];
+//# sourceMappingURL=sourceSurfaces.generated.js.map

package/dist/generated/sourceSurfaces.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceSurfaces.generated.js","sourceRoot":"","sources":["../../src/generated/sourceSurfaces.generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAU,CAAC"}

package/dist/generators/adapters.d.ts

@@ -8,9 +8,7 @@ export { MARKER };
 export interface AgentsMdOptions {
     profile?: SurfaceProfile;
     workspaceContext?: {
-        stage?: string;
         focus?: string;
-        governanceMode?: string;
         totalEntries?: number;
     };
     skills?: Array<{
@@ -25,9 +23,7 @@ export declare function generateCursorMdc(timestamp: string, profile?: SurfacePr
 export interface CopilotMdOptions {
     profile?: SurfaceProfile;
     workspaceContext?: {
-        stage?: string;
         focus?: string;
-        governanceMode?: string;
         totalEntries?: number;
     };
     skills?: Array<{
@@ -41,4 +37,37 @@ export interface CopilotMdOptions {
     }>;
 }
 export declare function generateCopilotMd(timestamp: string, options?: CopilotMdOptions): string;
+/** Minimal canonical-rule shape needed to project a path-scoped Copilot instruction file. */
+export interface CopilotInstructionRule {
+    name: string;
+    body: string;
+    /** Path-scope glob, e.g. "convex/**\/*.ts". Rules without it are repo-wide, not projected here. */
+    applyTo?: string;
+    /** Provenance (filesystem path or `db:<ENTRY-ID>`) — emitted as a breadcrumb comment only. */
+    sourcePath?: string;
+}
+export interface GeneratedInstructionFile {
+    /** Path relative to repo root, e.g. ".github/instructions/security-boundaries.instructions.md". */
+    relativePath: string;
+    content: string;
+}
+/**
+ * Project path-scoped GitHub Copilot instruction files from canonical rules.
+ *
+ * One `.github/instructions/<slug>.instructions.md` per rule that declares `applyTo`. Each file
+ * carries the `applyTo` frontmatter, the full rule body, and the pb-handshake MARKER.
+ *
+ * DECISION (DEC-1343, as refined): the committed `.github/instructions/*.instructions.md` are
+ * hand-maintained SSOT and carry NO MARKER, so handshake classifies them as user-owned and leaves
+ * them untouched (`shouldWriteAdapter`). This generator therefore only MATERIALIZES a file — with
+ * the MARKER, marking it pb-managed — when a Chain rule declares `applyTo` AND no committed file
+ * already occupies that path. On this repo no Chain rule declares `applyTo`, so it emits nothing
+ * and never dirties the tree; the path-scoped review files are the hand-authored committed ones.
+ *
+ * A provenance breadcrumb records the source entry/path WITHOUT requiring the consumer to resolve
+ * it: Copilot code review is pb-blind, so the body is inlined and the id is reference-only
+ * (DEC-1343 / INS-1969). Basenames are de-duped deterministically so two rules never clobber one
+ * file.
+ */
+export declare function generateCopilotInstructionFiles(rules: CopilotInstructionRule[], timestamp: string): GeneratedInstructionFile[];
 //# sourceMappingURL=adapters.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/generators/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,QAAA,MAAM,MAAM,mCAAmC,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CAgFrF;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAsCpF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAkCrF;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CA0IvF"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/generators/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,QAAA,MAAM,MAAM,mCAAmC,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,CAAC;AAElB,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM,CA8ErF;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAmCpF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CA+BrF;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAuIvF;AAUD,6FAA6F;AAC7F,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACvC,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,sBAAsB,EAAE,EAC/B,SAAS,EAAE,MAAM,GAChB,wBAAwB,EAAE,CAiC5B"}

package/dist/generators/adapters.js

@@ -7,15 +7,13 @@ export { MARKER };
 export function generateAgentsMd(timestamp, options) {
     const { workspaceContext, skills } = options ?? {};
     // Workspace context section (only when data is available)
+    // TASK-435 (C4c): the readiness stage label ("| Stage | ... |") is deleted from every
+    // served surface, including this generated adapter file.
     let workspaceSection = '';
     if (workspaceContext && Object.values(workspaceContext).some((v) => v !== undefined)) {
         const rows = [];
-        if (workspaceContext.stage !== undefined)
-            rows.push(`| Stage | \`${workspaceContext.stage}\` |`);
         if (workspaceContext.focus !== undefined)
             rows.push(`| Current focus | ${workspaceContext.focus} |`);
-        if (workspaceContext.governanceMode !== undefined)
-            rows.push(`| Governance mode | \`${workspaceContext.governanceMode}\` |`);
         if (workspaceContext.totalEntries !== undefined)
             rows.push(`| Chain entries | ${workspaceContext.totalEntries} |`);
         workspaceSection = `
@@ -46,8 +44,6 @@ ${rows.join('\n')}
 
 # Product Brain Context
 
-Read \`.productbrain/context.md\` for full workspace briefing (stage, bets, governance, tensions).
-Read \`.productbrain/briefing.md\` for entries matched to this repo.
 Read \`.productbrain/soul.md\` when identity, working style, or collaboration preferences matter.
 ${workspaceSection}
 ## The Chain is the SSOT. Use \`pb\` before everything.
@@ -66,7 +62,7 @@ ${workspaceSection}
 
 ## Session lifecycle — close the loop
 
-Start every write-heavy session with \`pb session start\`. This opens a tracked write session and refreshes context.
+Start every write-heavy session with \`pb session start\`. This opens a tracked write session.
 
 For reusable Product Brain workflows in Codex, read \`.codex/skills/README.md\` first, then open the matching skill file under \`.codex/skills/\`.
 
@@ -77,9 +73,9 @@ pb capture "DEC: decided X because Y"
 pb capture "INS: learned that X"
 \`\`\`
 
-Close with \`pb session close\` — reviews what was captured, refreshes context for the next session.
+Close with \`pb session close\` — reviews what was captured.
 
-All captures are drafts. The human reviews and commits in Product Brain Studio.
+All captures are drafts. The human reviews and accepts in Cortex.
 ${skillsSection}
 ## Governance Summary
 
@@ -92,9 +88,6 @@ export function generateClaudeMd(timestamp, profile) {
 
 # Product Brain Context
 
-Read \`.productbrain/context.md\` for full workspace briefing (stage, bets, governance, tensions).
-Read \`.productbrain/briefing.md\` for entries matched to this repo.
-
 ## The Chain is the SSOT. Use \`pb\` before everything.
 
 | Command | Purpose |
@@ -111,7 +104,7 @@ Read \`.productbrain/briefing.md\` for entries matched to this repo.
 
 ## Session lifecycle — close the loop
 
-Start every session with \`pb session start\`. This opens a tracked write session and refreshes context.
+Start every session with \`pb session start\`. This opens a tracked write session.
 
 When you make a decision, discover a tension, or learn something during work:
 \`\`\`
@@ -120,9 +113,9 @@ pb capture "DEC: decided X because Y"
 pb capture "INS: learned that X"
 \`\`\`
 
-Close with \`pb session close\` — reviews what was captured, refreshes context for the next session.
+Close with \`pb session close\` — reviews what was captured.
 
-All captures are drafts. The human reviews and commits in Product Brain Studio.
+All captures are drafts. The human reviews and accepts in Cortex.
 `;
 }
 export function generateCursorMdc(timestamp, profile) {
@@ -134,9 +127,6 @@ alwaysApply: true
 
 # Product Brain Context
 
-Read \`.productbrain/context.md\` for full workspace briefing (stage, bets, governance, tensions).
-Read \`.productbrain/briefing.md\` for entries matched to this repo.
-
 ## The Chain is the SSOT. Use \`pb\` before everything.
 
 - \`pb orient -b\` — Current workspace focus
@@ -155,7 +145,7 @@ Start with \`pb session start\`. When you make a decision, discover a tension, o
 - \`pb capture "TEN: description"\` — capture a tension
 - \`pb capture "DEC: decided X because Y"\` — capture a decision
 - \`pb capture "INS: learned that X"\` — capture an insight
-Close with \`pb session close\`. All captures are drafts — human reviews and commits.
+Close with \`pb session close\`. All captures are drafts — human reviews and accepts.
 
 <!-- ${MARKER} — ${timestamp} -->
 `;
@@ -164,15 +154,13 @@ export function generateCopilotMd(timestamp, options) {
     const { profile, workspaceContext, skills, rules } = options ?? {};
     const budget = profile?.tokenBudget ?? 30000;
     // Workspace context section (only when data is available)
+    // TASK-435 (C4c): the readiness stage label ("| Stage | ... |") is deleted from every
+    // served surface, including this generated adapter file.
     let workspaceSection = '';
     if (workspaceContext && Object.values(workspaceContext).some((v) => v !== undefined)) {
         const rows = [];
-        if (workspaceContext.stage !== undefined)
-            rows.push(`| Stage | \`${workspaceContext.stage}\` |`);
         if (workspaceContext.focus !== undefined)
             rows.push(`| Current focus | ${workspaceContext.focus} |`);
-        if (workspaceContext.governanceMode !== undefined)
-            rows.push(`| Governance mode | \`${workspaceContext.governanceMode}\` |`);
         if (workspaceContext.totalEntries !== undefined)
             rows.push(`| Chain entries | ${workspaceContext.totalEntries} |`);
         workspaceSection = `
@@ -188,9 +176,6 @@ ${rows.join('\n')}
 <!-- Re-run \`pb handshake\` to refresh. Do not edit manually. -->
 
 # Product Brain Context
-
-Read \`.productbrain/context.md\` for full workspace briefing (stage, bets, governance, tensions).
-Read \`.productbrain/briefing.md\` for entries matched to this repo.
 ${workspaceSection}
 ## The Chain is the SSOT. Use \`pb\` before everything.
 
@@ -207,7 +192,7 @@ Before substantive implementation, review, diagnosis, or security-sensitive reas
 ## Session lifecycle — close the loop
 
 Start with \`pb session start\`. Capture knowledge during work with \`pb capture "text"\`.
-Close with \`pb session close\`. All captures are drafts — human reviews and commits.
+Close with \`pb session close\`. All captures are drafts — human reviews and accepts.
 `;
     // When no enrichment options provided, return base for backward compat
     if (!skills?.length && !rules?.length) {
@@ -287,4 +272,64 @@ Close with \`pb session close\`. All captures are drafts — human reviews and c
     }
     return accumulated;
 }
+/** Slugify a rule name into a filesystem-safe instruction-file basename. */
+function instructionSlug(name) {
+    return (name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'rule');
+}
+/**
+ * Project path-scoped GitHub Copilot instruction files from canonical rules.
+ *
+ * One `.github/instructions/<slug>.instructions.md` per rule that declares `applyTo`. Each file
+ * carries the `applyTo` frontmatter, the full rule body, and the pb-handshake MARKER.
+ *
+ * DECISION (DEC-1343, as refined): the committed `.github/instructions/*.instructions.md` are
+ * hand-maintained SSOT and carry NO MARKER, so handshake classifies them as user-owned and leaves
+ * them untouched (`shouldWriteAdapter`). This generator therefore only MATERIALIZES a file — with
+ * the MARKER, marking it pb-managed — when a Chain rule declares `applyTo` AND no committed file
+ * already occupies that path. On this repo no Chain rule declares `applyTo`, so it emits nothing
+ * and never dirties the tree; the path-scoped review files are the hand-authored committed ones.
+ *
+ * A provenance breadcrumb records the source entry/path WITHOUT requiring the consumer to resolve
+ * it: Copilot code review is pb-blind, so the body is inlined and the id is reference-only
+ * (DEC-1343 / INS-1969). Basenames are de-duped deterministically so two rules never clobber one
+ * file.
+ */
+export function generateCopilotInstructionFiles(rules, timestamp) {
+    const files = [];
+    const seen = new Set();
+    for (const rule of rules) {
+        if (!rule.applyTo || !rule.applyTo.trim())
+            continue;
+        const slug = instructionSlug(rule.name);
+        let unique = slug;
+        let n = 2;
+        while (seen.has(unique))
+            unique = `${slug}-${n++}`;
+        seen.add(unique);
+        // Portable provenance: keep a `db:<ID>` reference as-is; reduce a filesystem path to its
+        // basename so a committed file never leaks an absolute, machine-specific path. Split on BOTH
+        // separators — a Windows authoring host yields `C:\…\rules\foo.md`, and splitting on '/' alone
+        // would leak the whole backslash path into committed provenance.
+        const src = rule.sourcePath
+            ? rule.sourcePath.startsWith('db:')
+                ? rule.sourcePath
+                : rule.sourcePath.split(/[/\\]/).pop()
+            : undefined;
+        const provenance = src ? `\n<!-- source: ${src} -->` : '';
+        // The rule body conventionally carries its own H1, so no heading is prepended here.
+        const content = `---
+applyTo: ${JSON.stringify(rule.applyTo.trim())}
+---
+<!-- ${MARKER} — ${timestamp} -->
+<!-- Re-run \`pb handshake\` to refresh. Edit the rule in the Chain, not this file. -->${provenance}
+
+${rule.body.trim()}
+`;
+        files.push({ relativePath: `.github/instructions/${unique}.instructions.md`, content });
+    }
+    return files;
+}
 //# sourceMappingURL=adapters.js.map

package/dist/generators/adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/generators/adapters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/generators/adapters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,GAAG,gCAAgC,CAAC;AAEhD,OAAO,EAAE,MAAM,EAAE,CAAC;AAWlB,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,OAAyB;IAC3E,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAEnD,0DAA0D;IAC1D,sFAAsF;IACtF,yDAAyD;IACzD,IAAI,gBAAgB,GAAG,EAAE,CAAC;IAC1B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,gBAAgB,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,KAAK,IAAI,CAAC,CAAC;QACrG,IAAI,gBAAgB,CAAC,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,YAAY,IAAI,CAAC,CAAC;QACnH,gBAAgB,GAAG;;;;;EAKrB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;CAChB,CAAC;IACA,CAAC;IAED,oEAAoE;IACpE,IAAI,aAAa,GAAG,EAAE,CAAC;IACvB,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YAC/F,OAAO,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,WAAW,MAAM,QAAQ,IAAI,CAAC;QAC9D,CAAC,CAAC,CAAC;QACH,aAAa,GAAG;;;;;EAKlB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;CAChB,CAAC;IACA,CAAC;IAED,OAAO,QAAQ,MAAM,MAAM,SAAS;;;;;;EAMpC,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BhB,aAAa;;;;CAId,CAAC;AACF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,OAAwB;IAC1E,OAAO,QAAQ,MAAM,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCrC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,OAAwB;IAC3E,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BF,MAAM,MAAM,SAAS;CAC3B,CAAC;AACF,CAAC;AAYD,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,OAA0B;IAC7E,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,OAAO,EAAE,WAAW,IAAI,KAAK,CAAC;IAE7C,0DAA0D;IAC1D,sFAAsF;IACtF,yDAAyD;IACzD,IAAI,gBAAgB,GAAG,EAAE,CAAC;IAC1B,IAAI,gBAAgB,IAAI,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,gBAAgB,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,KAAK,IAAI,CAAC,CAAC;QACrG,IAAI,gBAAgB,CAAC,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,qBAAqB,gBAAgB,CAAC,YAAY,IAAI,CAAC,CAAC;QACnH,gBAAgB,GAAG;;;;;EAKrB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;CAChB,CAAC;IACA,CAAC;IAED,kFAAkF;IAClF,MAAM,IAAI,GAAG,QAAQ,MAAM,MAAM,SAAS;;;;EAI1C,gBAAgB;;;;;;;;;;;;;;;;;CAiBjB,CAAC;IAEA,uEAAuE;IACvE,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iEAAiE;IACjE,4CAA4C;IAC5C,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,IAAI,KAAK,GAAG,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC;YAClD,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,KAAK,IAAI,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9D,CAAC;YACD,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,+GAA+G;IAC/G,MAAM,SAAS,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC,CAAC;IAElD,qDAAqD;IACrD,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,cAAc,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,qBAAqB,CAAC,yDAAyD,CAAC;IAEtH,qEAAqE;IACrE,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sFAAsF;IACtF,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEzC,IAAI,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;QACjD,yCAAyC;QACzC,OAAO,IAAI,GAAG,aAAa,CAAC;IAC9B,CAAC;IAED,wEAAwE;IACxE,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAE/D,mEAAmE;IACnE,MAAM,gBAAgB,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;IAE1D,IAAI,WAAW,GAAG,IAAI,CAAC;IACvB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAElD,iEAAiE;QACjE,IAAI,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YACnE,WAAW,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC3C,eAAe,GAAG,SAAS,CAAC;YAC5B,MAAM;QACR,CAAC;QAED,mEAAmE;QACnE,IAAI,WAAW,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,gBAAgB,IAAI,MAAM,EAAE,CAAC;YACnE,WAAW,IAAI,KAAK,CAAC;YACrB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,eAAe,EAAE,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;IAED,YAAY,GAAG,SAAS,GAAG,eAAe,CAAC;IAC3C,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;QAC1C,mEAAmE;QACnE,iEAAiE;QACjE,IAAI,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;YAC/C,WAAW,IAAI,IAAI,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC;AA0BD,4EAA4E;AAC5E,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,CACL,IAAI;SACD,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,MAAM,CACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAA+B,EAC/B,SAAiB;IAEjB,MAAM,KAAK,GAA+B,EAAE,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;YAAE,SAAS;QACpD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QACnD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEjB,yFAAyF;QACzF,6FAA6F;QAC7F,+FAA+F;QAC/F,iEAAiE;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU;YACzB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC;gBACjC,CAAC,CAAC,IAAI,CAAC,UAAU;gBACjB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE;YACxC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,CAAC,kBAAkB,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,oFAAoF;QACpF,MAAM,OAAO,GAAG;WACT,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;;OAEvC,MAAM,MAAM,SAAS;yFAC6D,UAAU;;EAEjG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;CACjB,CAAC;QACE,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,wBAAwB,MAAM,kBAAkB,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/generators/adapters.test.js

@@ -4,8 +4,6 @@ describe('generateAgentsMd', () => {
     it('includes Product Brain bootstrap guidance for Codex-style agents', () => {
         const output = generateAgentsMd('2026-04-02T00:00:00.000Z');
         expect(output).toContain('auto-generated by pb handshake');
-        expect(output).toContain('Read `.productbrain/context.md`');
-        expect(output).toContain('Read `.productbrain/briefing.md`');
         expect(output).toContain('Read `.productbrain/soul.md`');
         expect(output).toContain('`.codex/skills/README.md`');
         expect(output).toContain('pb orient -b');