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

package/dist/{chunk-AC5PU57Y.js → chunk-BBK5IO4R.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 }
     },
@@ -10706,7 +10706,7 @@ function checkDocCompleteness(collections, checkedAt) {
   };
 }
 function renderDocCompletenessLines(report) {
-  const lines = ["## Classification Doc-Completeness"];
+  const lines = ["## Collection Documentation Gaps"];
   if (report.summary.total === 0) {
     lines.push(`All ${report.totalChecked} collection docs have required fields populated.`);
     lines.push("");
@@ -10718,21 +10718,23 @@ function renderDocCompletenessLines(report) {
   lines.push(`**${report.summary.total} gap${report.summary.total === 1 ? "" : "s"}** across ${report.totalChecked} collections (${parts.join(", ")})`);
   const errors = report.violations.filter((v) => v.severity === "error");
   const warnings = report.violations.filter((v) => v.severity === "warning");
+  const ERROR_INLINE = 10;
+  const WARNING_INLINE = 10;
   if (errors.length > 0) {
     lines.push("");
     lines.push("**Errors** (must fix):");
-    for (const v of errors.slice(0, 5)) {
+    for (const v of errors.slice(0, ERROR_INLINE)) {
       lines.push(`- ${v.message} \u2014 ${v.fix}`);
     }
-    if (errors.length > 5) lines.push(`- ...and ${errors.length - 5} more`);
+    if (errors.length > ERROR_INLINE) lines.push(`- ...and ${errors.length - ERROR_INLINE} more`);
   }
   if (warnings.length > 0) {
     lines.push("");
     lines.push("**Warnings**:");
-    for (const v of warnings.slice(0, 3)) {
+    for (const v of warnings.slice(0, WARNING_INLINE)) {
       lines.push(`- ${v.message}`);
     }
-    if (warnings.length > 3) lines.push(`- ...and ${warnings.length - 3} more`);
+    if (warnings.length > WARNING_INLINE) lines.push(`- ...and ${warnings.length - WARNING_INLINE} more`);
   }
   lines.push("");
   return lines;
@@ -13175,8 +13177,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 +15676,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-AC5PU57Y.js.map
+//# sourceMappingURL=chunk-BBK5IO4R.js.map