@productbrain/mcp 0.0.1-beta.8560 → 0.0.1-beta.8563

package/dist/{chunk-SOVY6GZS.js → chunk-6OMZMXSM.js}

@@ -38,7 +38,7 @@ import {
   trackQualityVerdict,
   trackSessionCaptureRate,
   trackZeroCaptureAuditFired
-} from "./chunk-UPQW54GN.js";
+} from "./chunk-FB2VAQOX.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -144,8 +144,8 @@ var GATE_PATTERNS = [
   {
     pattern: /orientation required|call.*orient/i,
     code: "ORIENTATION_REQUIRED",
-    recovery: "Orient before writing.",
-    action: { tool: "orient", description: "Orient session", parameters: {} }
+    recovery: "Run orient with a task, then retry.",
+    action: { tool: "orient", description: "Orient with a task", parameters: { action: "task" } }
   },
   {
     pattern: /read.?only.*scope/i,
@@ -154,6 +154,13 @@ var GATE_PATTERNS = [
     action: { tool: "workspace", description: "Check key scope", parameters: { action: "whoami" } }
   }
 ];
+function orientationRefusal(err) {
+  const gate = GATE_PATTERNS.find((g) => g.code === "ORIENTATION_REQUIRED");
+  const mcpErr = asKernelCallError(err);
+  const message = mcpErr?.cleanMessage ?? (err instanceof Error ? err.message : String(err));
+  if (!gate || !gate.pattern.test(message)) return null;
+  return { code: gate.code, message, recovery: gate.recovery, availableActions: [gate.action] };
+}
 function classifyError(err) {
   const message = err instanceof Error ? err.message : String(err);
   if (err instanceof GateError) {
@@ -361,6 +368,13 @@ function thinWrapper(handler) {
     }
   };
 }
+function orientationRefusalResult(err, lines) {
+  const refused = orientationRefusal(err);
+  if (!refused) return null;
+  const text = [...lines, `**${refused.message}**`, "", refused.recovery ?? ""].join("\n");
+  return { content: textContent(text), structuredContent: failure(refused.code, refused.message, refused.recovery, refused.availableActions) };
+}
+var ORIENT_REQUIRED_NOTE = "workflow checkpoints and organisation-structure writes (membership, ownership, parent) still require an oriented session.";
 
 // src/tools/knowledge-helpers.ts
 import { z as z2 } from "zod/v3";
@@ -8318,7 +8332,7 @@ function taskGroundingWarningLines(task, hasTaskGrounding = false) {
   if (task) {
     return [
       "## Task grounding incomplete",
-      "_A task was provided, but task-scoped governance/context did not load. nothing in the Chain matched it._",
+      "_A task was provided, but task-scoped governance/context did not load. Nothing in the Chain matched it._",
       "",
       'Refine the task and rerun `orient task="describe the work"` or use `context action="gather"` for deeper task context.',
       ""
@@ -8351,7 +8365,7 @@ function registerOrientTool(server) {
     "orient",
     {
       title: "Orient",
-      description: "Workspace orientation and session bootstrapping. Two actions:\n\n- **start**: Universal opener (absorbs `start_pb`) \u2014 say 'Start PB' to begin every session. Returns a standup briefing for every workspace state, fresh or active. Orients the CURRENT session \u2014 it does not create one; for writes, call `session action=start` first.\n- **task**: Task-grounded context loader (the original `orient` behavior). Use after `action=start` to load governance and context for a specific task. Completing orientation unlocks write tools.\n\n**tier** (action=task): Controls payload depth.\n- `summary` (~10 KB) \u2014 compact, calibrated for task-scoped retrieval.\n- `standard` (~256 KB) \u2014 rich, suited to workspace standups.\n- `full` \u2014 complete payload, no cap. Use with deliberation.\n\nThe spine (vision, purpose, strategy highlights) is served in full and a grounding status flags when context was reduced.\n\nDefaults: `summary` when `task` is provided; `standard` when `task` is absent. Explicit `tier` always wins.\n\n**mode** (action=task): `full` (default) returns full context. `brief` returns compact summary \u2014 mapped to tier=summary internally.",
+      description: "Workspace orientation and session bootstrapping. Two actions:\n\n- **start**: Universal opener (absorbs `start_pb`) \u2014 say 'Start PB' to begin every session. Returns a standup briefing for every workspace state, fresh or active. Orients the CURRENT session \u2014 it does not create one; for writes, call `session action=start` first.\n- **task**: Task-grounded context loader (the original `orient` behavior). Use after `action=start` to load governance and context for a specific task. Orient is advice for captures, relations, accepts, ticks and questions; " + ORIENT_REQUIRED_NOTE + "\n\n**tier** (action=task): Controls payload depth.\n- `summary` (~10 KB) \u2014 compact, calibrated for task-scoped retrieval.\n- `standard` (~256 KB) \u2014 rich, suited to workspace standups.\n- `full` \u2014 complete payload, no cap. Use with deliberation.\n\nThe spine (vision, purpose, strategy highlights) is served in full and a grounding status flags when context was reduced.\n\nDefaults: `summary` when `task` is provided; `standard` when `task` is absent. Explicit `tier` always wins.\n\n**mode** (action=task): `full` (default) returns full context. `brief` returns compact summary \u2014 mapped to tier=summary internally.",
       inputSchema: orientSchema,
       // Mixed read/write noun (§3 R3): 'start' writes session state.
       annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: false }
@@ -8589,7 +8603,7 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
     } else if (agentSessionId) {
       orientationStatus2 = "task_required";
       lines.push("---");
-      lines.push('Workspace orientation loaded. Write tools stay locked until you run `orient task="describe the work"`.');
+      lines.push('Workspace orientation loaded. Run `orient task="describe the work"` for task-shaped governance before substantive work; ' + ORIENT_REQUIRED_NOTE);
     } else {
       lines.push("---");
       lines.push("_No active agent session. Call `session action=start` to begin._");
@@ -8974,7 +8988,7 @@ async function _handleOrient({ mode = "full", tier, task, startupSignals, invoca
   } else if (agentSessionId) {
     orientationStatus = "task_required";
     lines.push("---");
-    lines.push('Workspace orientation loaded. Write tools stay locked until you run `orient task="describe the work"`.');
+    lines.push('Workspace orientation loaded. Run `orient task="describe the work"` for task-shaped governance before substantive work; ' + ORIENT_REQUIRED_NOTE);
   } else {
     lines.push("---");
     lines.push("_No active agent session. Call `session action=start` to begin a tracked session._");
@@ -10454,6 +10468,8 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
         )
       };
     } catch (err) {
+      const refusal = orientationRefusalResult(err, lines);
+      if (refusal) return refusal;
       const msg = err instanceof Error ? err.message : String(err);
       lines.push(
         `**Chain accept failed**: ${msg}`,
@@ -10553,12 +10569,10 @@ This checkpoint was NOT saved. The conversation context is preserved \u2014 cont
         )
       };
     } catch (err) {
+      const refusal = orientationRefusalResult(err, lines);
+      if (refusal) return refusal;
       const msg = err instanceof Error ? err.message : String(err);
-      lines.push(
-        `**Checkpoint persistence failed**: ${msg}`,
-        "",
-        `The conversation context is preserved, but this round was not saved as a durable workflow checkpoint.`
-      );
+      lines.push(`**Checkpoint persistence failed**: ${msg}`, "", "The conversation context is preserved, but this round was not saved as a durable workflow checkpoint.");
       return {
         content: [{ type: "text", text: lines.join("\n") }],
         structuredContent: failure(
@@ -10630,12 +10644,10 @@ async function handleFacilitatedFinalization(wf, descriptor, roundId, normalized
       )
     };
   } catch (err) {
+    const refusal = orientationRefusalResult(err, lines);
+    if (refusal) return refusal;
     const msg = err instanceof Error ? err.message : String(err);
-    lines.push(
-      `**Finalization failed**: ${msg}`,
-      "",
-      `The workflow output is preserved in this conversation.`
-    );
+    lines.push(`**Finalization failed**: ${msg}`, "", "The workflow output is preserved in this conversation.");
     return {
       content: [{ type: "text", text: lines.join("\n") }],
       structuredContent: failure(
@@ -11994,7 +12006,7 @@ async function handleStart2(data) {
   const result2 = await startAgentSession(data?.role);
   const lines = [];
   lines.push(
-    `Session ${result2.sessionId} active. Initiated by ${result2.initiatedBy}. Workspace ${result2.workspaceName}. Scope: ${result2.toolsScope}. Write tools available after orient.`
+    `Session ${result2.sessionId} active. Initiated by ${result2.initiatedBy}. Workspace ${result2.workspaceName}. Scope: ${result2.toolsScope}. Orient with a task before substantive work: it is advice for captures, relations, accepts, ticks and questions; workflow checkpoints and organisation-structure writes still require it.`
   );
   if (result2.roleEntryId) {
     lines.push(`Acting as role: ${result2.roleName ?? result2.roleEntryId}.`);
@@ -12006,7 +12018,7 @@ async function handleStart2(data) {
   }
   const ruleLines = formatRuleListsLines(result2.ruleLists);
   if (ruleLines.length > 0) lines.push("", "Rules:", ...ruleLines);
-  const summary = `Session ${result2.sessionId} active. Workspace ${result2.workspaceName}. Write tools available after orient.`;
+  const summary = `Session ${result2.sessionId} active. Workspace ${result2.workspaceName}. Orient with a task first; workflow checkpoints and organisation-structure writes still require it.`;
   return {
     content: [{ type: "text", text: lines.join("\n") }],
     structuredContent: success(summary, {
@@ -14527,4 +14539,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-SOVY6GZS.js.map
+//# sourceMappingURL=chunk-6OMZMXSM.js.map