@productbrain/mcp 0.0.1-beta.11437 → 0.0.1-beta.11441

package/dist/{chunk-W3Y4VS6E.js → chunk-CY37RSBU.js}

@@ -34,7 +34,7 @@ import {
   runWithToolContext,
   setSessionOriented,
   startAgentSession
-} from "./chunk-QUM6WNMF.js";
+} from "./chunk-LELPZ5YE.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -190,6 +190,81 @@ function orientationRefusalResult(err, lines) {
 }
 var ORIENT_REQUIRED_NOTE = "workflow checkpoints and organisation-structure writes (membership, ownership, parent) still require an oriented session.";
 
+// src/lib/spineRungs.ts
+var SPINE_RUNG_SEQUENCE = [
+  { relationType: "validates", targetKey: "key_result", gapIfMissing: "key_result_missing" },
+  { relationType: "part_of", targetKey: "objective", gapIfMissing: "objective_missing" },
+  { relationType: "part_of", targetKey: "strategy", gapIfMissing: "strategy_missing" },
+  { relationType: "part_of", targetKey: "vision", gapIfMissing: "vision_missing" },
+  { relationType: "part_of", targetKey: "purpose", gapIfMissing: "purpose_missing" }
+];
+
+// src/lib/checklist.ts
+var FIRST_SPINE_SUBJECT = "work_package";
+var kindWord = (kind) => kind.replace(/_/g, " ");
+var withArticle = (word) => `${/^[aeiou]/.test(word) ? "an" : "a"} ${word}`;
+var spineSubject = (kind) => {
+  const words = withArticle(kindWord(kind));
+  return words[0].toUpperCase() + words.slice(1);
+};
+function rungLine(rung) {
+  const index = SPINE_RUNG_SEQUENCE.findIndex((spec) => spec.targetKey === rung);
+  if (index < 0) return null;
+  const { relationType: relationType2, targetKey } = SPINE_RUNG_SEQUENCE[index];
+  const parent = `an accepted ${kindWord(targetKey)}`;
+  const subject = spineSubject(index === 0 ? FIRST_SPINE_SUBJECT : SPINE_RUNG_SEQUENCE[index - 1].targetKey);
+  return relationType2 === "part_of" ? `${subject} hangs on ${parent} with ${relationType2}.` : `${subject} ${relationType2} ${parent}.`;
+}
+var SPINE_RUNG_LINES = SPINE_RUNG_SEQUENCE.map((spec) => rungLine(spec.targetKey));
+var SPINE_LINKS_LINES = [
+  `Spine links run child to parent, each ${SPINE_RUNG_SEQUENCE[SPINE_RUNG_SEQUENCE.length - 1].relationType} the level above.`,
+  `${spineSubject(FIRST_SPINE_SUBJECT)} ${SPINE_RUNG_SEQUENCE[0].relationType} ${withArticle(kindWord(SPINE_RUNG_SEQUENCE[0].targetKey))}; informs joins no levels.`,
+  "Before accepting a spine entry, preflight it: it names what blocks."
+];
+var CHECKLIST_LINES = {
+  purpose: {
+    stranger_test: "Explain it so a stranger knows why this company exists",
+    specificity: "Say what would be missing from the world without this company",
+    not_a_platitude: "Say something a reasonable company would not also claim",
+    beneficiary_named: "Name who it is for: people, a community or part of the world, specific enough to say who it is not for",
+    durable_not_dated: "Leave out dates and planning cycles; those belong on goals"
+  },
+  vision: {
+    specificity: "Say what will be different, in words only this product could use",
+    beneficiary: "Name who it is for: people, a community or part of the world, specific enough to say who it is not for",
+    falsifiability: "Choose a direction a reasonable rival would reject",
+    stranger_test: "Explain it so a stranger knows what will be different, and for whom"
+  },
+  strategy: {
+    coherent_narrative: "Connect the diagnosis, the policy and the first actions",
+    decisiveness: "Say what you will not do",
+    time_bounded: "Name a horizon: a date, a duration or a milestone"
+  },
+  objective: {
+    outcome_not_activity: "State what will be true once it is met, not the work to do",
+    serves_strategy: "Say what must be true for the strategy to succeed",
+    observable: "Make it something a reader could see has happened"
+  },
+  key_result: {
+    measurable: "Name a measure and the target value or state",
+    bounded: "Say by when, or how often, the measure is read",
+    moves_the_objective: "Pick a result that shows the objective is happening, not that work was done"
+  },
+  /** One line per spine rung, keyed by the rung it reaches: rungLine, in SPINE_RUNG_SEQUENCE order (TASK-1026). */
+  strategy_link: Object.fromEntries(SPINE_RUNG_SEQUENCE.map((spec) => [spec.targetKey, rungLine(spec.targetKey)]))
+};
+var MARK = { met: "[x]", not_yet: "[ ]", judging: "[~]" };
+function renderChecklist(canonicalKey, criteria, judging) {
+  const lines = CHECKLIST_LINES[canonicalKey];
+  if (!lines) return null;
+  return criteria.filter((c) => lines[c.id] !== void 0).map((c) => {
+    const state = !c.passed ? "not_yet" : judging ? "judging" : "met";
+    const still = state === "judging" ? " (still judging)" : "";
+    const missing = state === "not_yet" && c.missing ? ` \u2014 missing: ${c.missing}` : "";
+    return `${MARK[state]} ${lines[c.id]}${still}${missing}`;
+  });
+}
+
 // src/lib/createEntryPreviewResult.ts
 async function resolvePreviewPreflight(result2, links) {
   if (!links?.length) return result2.preflight;
@@ -729,81 +804,6 @@ function buildCaptureForRealNextAction(payload) {
   }];
 }
 
-// src/lib/spineRungs.ts
-var SPINE_RUNG_SEQUENCE = [
-  { relationType: "validates", targetKey: "key_result", gapIfMissing: "key_result_missing" },
-  { relationType: "part_of", targetKey: "objective", gapIfMissing: "objective_missing" },
-  { relationType: "part_of", targetKey: "strategy", gapIfMissing: "strategy_missing" },
-  { relationType: "part_of", targetKey: "vision", gapIfMissing: "vision_missing" },
-  { relationType: "part_of", targetKey: "purpose", gapIfMissing: "purpose_missing" }
-];
-
-// src/lib/checklist.ts
-var FIRST_SPINE_SUBJECT = "work_package";
-var kindWord = (kind) => kind.replace(/_/g, " ");
-var withArticle = (word) => `${/^[aeiou]/.test(word) ? "an" : "a"} ${word}`;
-var spineSubject = (kind) => {
-  const words = withArticle(kindWord(kind));
-  return words[0].toUpperCase() + words.slice(1);
-};
-function rungLine(rung) {
-  const index = SPINE_RUNG_SEQUENCE.findIndex((spec) => spec.targetKey === rung);
-  if (index < 0) return null;
-  const { relationType: relationType2, targetKey } = SPINE_RUNG_SEQUENCE[index];
-  const parent = `an accepted ${kindWord(targetKey)}`;
-  const subject = spineSubject(index === 0 ? FIRST_SPINE_SUBJECT : SPINE_RUNG_SEQUENCE[index - 1].targetKey);
-  return relationType2 === "part_of" ? `${subject} hangs on ${parent} with ${relationType2}.` : `${subject} ${relationType2} ${parent}.`;
-}
-var SPINE_RUNG_LINES = SPINE_RUNG_SEQUENCE.map((spec) => rungLine(spec.targetKey));
-var SPINE_LINKS_LINES = [
-  `Spine links run child to parent, each ${SPINE_RUNG_SEQUENCE[SPINE_RUNG_SEQUENCE.length - 1].relationType} the level above.`,
-  `${spineSubject(FIRST_SPINE_SUBJECT)} ${SPINE_RUNG_SEQUENCE[0].relationType} ${withArticle(kindWord(SPINE_RUNG_SEQUENCE[0].targetKey))}; informs joins no levels.`,
-  "Before accepting a spine entry, preflight it: it names what blocks."
-];
-var CHECKLIST_LINES = {
-  purpose: {
-    stranger_test: "Explain it so a stranger knows why this company exists",
-    specificity: "Say what would be missing from the world without this company",
-    not_a_platitude: "Say something a reasonable company would not also claim",
-    beneficiary_named: "Name who it is for: people, a community or part of the world, specific enough to say who it is not for",
-    durable_not_dated: "Leave out dates and planning cycles; those belong on goals"
-  },
-  vision: {
-    specificity: "Say what will be different, in words only this product could use",
-    beneficiary: "Name who it is for: people, a community or part of the world, specific enough to say who it is not for",
-    falsifiability: "Choose a direction a reasonable rival would reject",
-    stranger_test: "Explain it so a stranger knows what will be different, and for whom"
-  },
-  strategy: {
-    coherent_narrative: "Connect the diagnosis, the policy and the first actions",
-    decisiveness: "Say what you will not do",
-    time_bounded: "Name a horizon: a date, a duration or a milestone"
-  },
-  objective: {
-    outcome_not_activity: "State what will be true once it is met, not the work to do",
-    serves_strategy: "Say what must be true for the strategy to succeed",
-    observable: "Make it something a reader could see has happened"
-  },
-  key_result: {
-    measurable: "Name a measure and the target value or state",
-    bounded: "Say by when, or how often, the measure is read",
-    moves_the_objective: "Pick a result that shows the objective is happening, not that work was done"
-  },
-  /** One line per spine rung, keyed by the rung it reaches: rungLine, in SPINE_RUNG_SEQUENCE order (TASK-1026). */
-  strategy_link: Object.fromEntries(SPINE_RUNG_SEQUENCE.map((spec) => [spec.targetKey, rungLine(spec.targetKey)]))
-};
-var MARK = { met: "[x]", not_yet: "[ ]", judging: "[~]" };
-function renderChecklist(canonicalKey, criteria, judging) {
-  const lines = CHECKLIST_LINES[canonicalKey];
-  if (!lines) return null;
-  return criteria.filter((c) => lines[c.id] !== void 0).map((c) => {
-    const state = !c.passed ? "not_yet" : judging ? "judging" : "met";
-    const still = state === "judging" ? " (still judging)" : "";
-    const missing = state === "not_yet" && c.missing ? ` \u2014 missing: ${c.missing}` : "";
-    return `${MARK[state]} ${lines[c.id]}${still}${missing}`;
-  });
-}
-
 // src/lib/rubricFormatting.ts
 function verdictQualityPhrase(result2) {
   const v = result2?.verdict;
@@ -10324,6 +10324,7 @@ function formatNoticeLines(notices) {
 }
 
 // src/tools/session.ts
+var START_PREFLIGHT_NEXT = 'Next: context action=preflight collection=<kind> links=[{"type":"part_of","entryId":"<PARENT-ID>"}]';
 var SESSION_ACTIONS = [
   "start",
   "close",
@@ -10458,6 +10459,7 @@ async function handleStart2(data) {
     surface: "mcp",
     sessionStart: true
   }));
+  lines.push("", ...SPINE_LINKS_LINES, ...result2.briefing?.firstReply ? [] : [START_PREFLIGHT_NEXT]);
   const summary = `Session ${result2.sessionId} active. Workspace ${result2.workspaceName}. Pass sessionId="${result2.sessionId}" on every write. Orient with a task first; workflow checkpoints and organisation-structure writes still require it.`;
   return {
     content: [{ type: "text", text: lines.join("\n") }],
@@ -12136,6 +12138,8 @@ var INSTRUCTIONS = [
   "Pass the `sessionId` that `session action=start` returned on every write: the connection does not remember it.",
   "Use `capture` to create an entry and read its reply: it lands as a draft, except a question, which is born open and needs no `entries action=commit`.",
   "Link entries with `relations action=create` \u2014 a relation is written only when you ask, with exactly the verb you send.",
+  ...SPINE_LINKS_LINES,
+  // TASK-1022 (WP-862): the spine grammar session start prints, a backup for the clients that load instructions
   "Finish with `session action=wrapup-review`, then `session action=close`.",
   "If the work falls outside the active work packages, name the gap and ask the user before designing it."
 ].join("\n");
@@ -12208,4 +12212,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-W3Y4VS6E.js.map
+//# sourceMappingURL=chunk-CY37RSBU.js.map