@productbrain/mcp 0.0.1-beta.206 → 0.0.1-beta.207

package/dist/{chunk-AC5PU57Y.js → chunk-DNZQANRI.js}

@@ -7919,8 +7919,8 @@ function registerSessionTools(server) {
   server.registerTool(
     "session",
     {
-      title: "Session",
-      description: "Manage agent session lifecycle. Three actions:\n\n- **start**: Begin a tracked session. Creates attribution for this workspace. If a session is already active, it gets superseded. Write tools available after orient.\n- **close**: End the current session. Records structured data (entries created, modified, relations). If uncommitted drafts exist and wrapup hasn't run, shows a review summary. Run session-wrapup before closing.\n- **status**: Check current session \u2014 active or not, oriented, activity counts.",
+      title: "Session \u2014 Low-Level Lifecycle",
+      description: "Low-level session lifecycle management. **For user-facing 'begin a session', call `start_pb` instead** \u2014 it is the canonical opener and handles session start automatically.\n\nThree actions:\n\n- **start**: Low-level \u2014 begin a tracked session for attribution. Most agents should NOT call this directly; use `start_pb` which wraps it with stage-aware context. Use `session start` only for explicit session control (e.g. supersession after CLI work).\n- **close**: End the current session. Records structured data (entries created, modified, relations). If uncommitted drafts exist and wrapup hasn't run, shows a review summary. Run session-wrapup before closing.\n- **status**: Check current session \u2014 active or not, oriented, activity counts.",
       inputSchema: sessionSchema,
       annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: false }
     },
@@ -13175,8 +13175,8 @@ function registerOrientTool(server) {
   server.registerTool(
     "orient",
     {
-      title: "Orient \u2014 Start Here",
-      description: "The single entry point for starting a session. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\nUse this FIRST. One call to orient replaces 3\u20135 individual tool calls.\n\nCompleting orientation unlocks write tools for the active session.\n\n**tier:** Controls payload depth. `standard` (default, ~256 KB) is the recommended default. `summary` (~10 KB) for quick mid-session re-orientation. `full` for complete payload when deep context is needed.\n\n**mode:** `full` (default) returns full context. `brief` returns compact summary \u2014 mapped to tier=summary internally. Prefer `tier` for explicit depth control.\n\n**task:** Optional natural-language task description. When provided, returns task-scoped context (scored, relevant entries) in addition to standard orient sections.\n\n**scope:** Optional domain scope. Filters governance entries to those relevant for the specified domain. Authority roots include strategy, product, product-design, engineering, architecture, data, governance, and go-to-market. Child scopes such as product-design/ux, engineering/frontend, data/analytics, and governance/principles are accepted. Legacy internal scopes remain accepted.",
+      title: "Orient \u2014 Task Grounding",
+      description: "Task-grounded context loader. Use AFTER `start_pb` (the canonical session opener) to load governance and context for a specific task. Returns workspace context with a single recommended next action for low-readiness workspaces, or a standup-style briefing for established workspaces.\n\n**Not the session opener.** For 'how do I begin a session' or 'Start PB', call `start_pb` instead. `orient` is for refreshing or scoping context once a session is already underway.\n\nCompleting orientation unlocks write tools for the active session.\n\n**tier:** Controls payload depth. `standard` (default, ~256 KB) is the recommended default. `summary` (~10 KB) for quick mid-session re-orientation. `full` for complete payload when deep context is needed.\n\n**mode:** `full` (default) returns full context. `brief` returns compact summary \u2014 mapped to tier=summary internally. Prefer `tier` for explicit depth control.\n\n**task:** Optional natural-language task description. When provided, returns task-scoped context (scored, relevant entries) in addition to standard orient sections.\n\n**scope:** Optional domain scope. Filters governance entries to those relevant for the specified domain. Authority roots include strategy, product, product-design, engineering, architecture, data, governance, and go-to-market. Child scopes such as product-design/ux, engineering/frontend, data/analytics, and governance/principles are accepted. Legacy internal scopes remain accepted.",
       inputSchema: orientSchema,
       annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false }
     },
@@ -15674,4 +15674,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-AC5PU57Y.js.map
+//# sourceMappingURL=chunk-DNZQANRI.js.map