@productbrain/mcp 0.0.1-beta.3391 → 0.0.1-beta.3399

package/dist/{chunk-KFXZUDFK.js → chunk-CY3YQR26.js}

@@ -11756,11 +11756,87 @@ async function handleAuditRun(entryId, phase) {
   };
 }
 
+// src/tools/spine-check.ts
+async function handleSpineCheck(story, refresh = false) {
+  const scheduleResult = await kernelMutation(
+    "quality.scheduleSpineCheck",
+    { includeStory: story, refresh }
+  );
+  const row = await kernelQuery("quality.getLatestSpineVerdict", {});
+  const stillRunning = scheduleResult.scheduled;
+  if (!row) {
+    const text = stillRunning ? "Spine check started \u2014 no prior result exists yet. It runs asynchronously (LLM calls can take 25s+ each); re-run this in a few seconds to read the result." : "No spine check has been run yet, and none is currently running. Pass refresh:true to start one.";
+    return {
+      content: [{ type: "text", text }],
+      structuredContent: success(text, { hasVerdict: false, checkStarted: stillRunning })
+    };
+  }
+  const { verdict } = row;
+  if (verdict.noSpineEntries) {
+    return {
+      content: [{ type: "text", text: "No spine entries yet \u2014 nothing to check." }],
+      structuredContent: success("No spine entries yet.", { hasVerdict: true, noSpineEntries: true })
+    };
+  }
+  const lines = ["## Spine Check"];
+  if (stillRunning) {
+    lines.push(`> A new check was just triggered and is still running asynchronously \u2014 the result below is from the PREVIOUS run (${new Date(row.createdAt).toISOString()}). Re-run in a few seconds for the fresh result.`, "");
+  } else if (scheduleResult.reason === "already-in-flight") {
+    lines.push(`> A check is already running (started earlier, not by this call) \u2014 showing the best available result (${new Date(row.createdAt).toISOString()}). Re-run in a few seconds.`, "");
+  } else if (row.stale) {
+    lines.push(`> STALE \u2014 ${row.staleMemberIds.length} member entry(ies) changed since this was computed. Pass refresh:true to recompute.`, "");
+  }
+  const s = verdict.structural;
+  lines.push(`Structural completeness: ${s.passed ? "PASS" : "FAIL"}`);
+  if (s.missing.length > 0) lines.push(`Missing: ${s.missing.join(", ")}`);
+  if (s.duplicateSingletons.purpose) lines.push(`Duplicate purpose singletons (which is canonical?): ${s.duplicateSingletons.purpose.join(", ")}`);
+  if (s.duplicateSingletons.vision) lines.push(`Duplicate vision singletons (which is canonical?): ${s.duplicateSingletons.vision.join(", ")}`);
+  if (s.unconnectedStrategyIds.length > 0) lines.push(`Unconnected strategies (no informs edge to any vision): ${s.unconnectedStrategyIds.join(", ")}`);
+  if ((s.strategiesWithUnknownConnectivity ?? []).length > 0) {
+    lines.push(`Connectivity unknown (relation set truncated \u2014 not confirmed disconnected): ${s.strategiesWithUnknownConnectivity.join(", ")}`);
+  }
+  if (s.visionConnectedToPurpose === false) lines.push("No vision informs any purpose.");
+  if (s.visionPurposeConnectivityTruncated) lines.push("Vision\u2192purpose connectivity unknown (relation set truncated).");
+  if (verdict.strategiesTruncated) lines.push("Strategy set truncated \u2014 not every strategy was graded this pass.");
+  if (verdict.perStrategy.length > 0) {
+    lines.push("", `Per-strategy refusal heuristic (${verdict.perStrategy.length}):`);
+    for (const p of verdict.perStrategy) {
+      const refusal = p.refusal.hasRefusalSignal ? "names an explicit alternative it declines" : "no explicit refusal language detected";
+      const rm = p.rogerMartin ? `; Roger Martin test: ${p.rogerMartin.isStrategicChoice ? "genuine strategic choice" : "NOT a genuine strategic choice"}` : "; Roger Martin test: FAILED TO EVALUATE (timeout, budget limit, or malformed response) \u2014 not scored";
+      lines.push(`- ${p.entryId}: ${refusal}${rm}`);
+    }
+  }
+  if (verdict.story) {
+    lines.push("", `One-story judgment [unvalidated, on-demand]: ${verdict.story.passed ? "PASS" : "FAIL"}`);
+    if (!verdict.story.passed && verdict.story.failedCriterion) lines.push(`Failed criterion: ${verdict.story.failedCriterion}`);
+  } else if (row.includesStoryPass) {
+    lines.push("", "One-story judgment: requested, but the LLM pass did not return a usable result (timeout or parse failure). Re-run to retry.");
+  } else {
+    lines.push("", "One-story judgment: not run this pass \u2014 pass story=true to run it.");
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }],
+    structuredContent: success(
+      `Spine check: structural ${s.passed ? "PASS" : "FAIL"}${verdict.story ? `, story ${verdict.story.passed ? "PASS" : "FAIL"} [unvalidated]` : ""}${stillRunning ? " (new run still in progress \u2014 showing previous result)" : ""}.`,
+      {
+        hasVerdict: true,
+        noSpineEntries: false,
+        structuralPassed: s.passed,
+        storyPassed: verdict.story?.passed ?? null,
+        stale: row.stale,
+        stillRunning,
+        scheduled: scheduleResult.scheduled,
+        scheduleReason: scheduleResult.reason
+      }
+    )
+  };
+}
+
 // src/tools/quality.ts
-var QUALITY_ACTIONS = ["check", "re-evaluate", "verify-chain", "audit"];
+var QUALITY_ACTIONS = ["check", "re-evaluate", "verify-chain", "audit", "spine-check"];
 var qualitySchema = z22.object({
   action: z22.enum(QUALITY_ACTIONS).describe(
-    "'check': read the entry's server quality verdict (tier + criteria). 're-evaluate': trigger fresh evaluation. 'verify-chain': verify entries against the codebase (codeMapping drift, cross-references) \u2014 absorbs `verify`. 'audit': hygiene audit for a bet entry \u2014 absorbs `audit`."
+    "'check': read the entry's server quality verdict (tier + criteria). 're-evaluate': trigger fresh evaluation. 'verify-chain': verify entries against the codebase (codeMapping drift, cross-references) \u2014 absorbs `verify`. 'audit': hygiene audit for a bet entry \u2014 absorbs `audit`. 'spine-check': structural completeness of the purpose+vision+strategy spine \u2014 story:true also runs the on-demand one-story judgment."
   ),
   entryId: z22.string().max(200).optional().describe("For 'check'/'re-evaluate'/'audit': entry ID, e.g. 'TEN-graph-db', '<PREFIX>-<n>'."),
   context: z22.enum(["capture", "commit", "review"]).default("review").optional().describe("For re-evaluate: evaluation context"),
@@ -11768,6 +11844,10 @@ var qualitySchema = z22.object({
   mode: z22.enum(["report", "fix"]).optional().describe("For 'verify-chain': 'report' = read-only trust report (default). 'fix' = also update drifted codeMapping statuses."),
   phase: z22.enum(["shaping", "handoff"]).optional().describe(
     "For 'audit': 'shaping' checks shaping-phase fields only (default). 'handoff' checks all required fields including buildContract/buildSequence/exclusions/risks."
+  ),
+  story: z22.boolean().optional().describe("For 'spine-check': also run the on-demand one-story LLM judgment (never scheduled; result labelled [unvalidated])."),
+  refresh: z22.boolean().optional().describe(
+    "For 'spine-check': force a new run even if a fresh verdict already exists. Default false \u2014 a plain call NEVER re-triggers work just to read the last result; it auto-schedules only when no run is already in flight AND the stored verdict is absent/stale/missing the requested story pass."
   )
 });
 var qualityCheckVariant = z22.object({ action: z22.literal("check"), entryId: z22.string().max(200) });
@@ -11786,17 +11866,24 @@ var qualityAuditVariant = z22.object({
   entryId: z22.string().max(200),
   phase: z22.enum(["shaping", "handoff"]).optional().default("shaping")
 });
+var qualitySpineCheckVariant = z22.object({
+  action: z22.literal("spine-check"),
+  story: z22.boolean().optional().default(false),
+  refresh: z22.boolean().optional().default(false)
+});
 var qualityActionUnion = z22.discriminatedUnion("action", [
   qualityCheckVariant,
   qualityReEvaluateVariant,
   qualityVerifyChainVariant,
-  qualityAuditVariant
+  qualityAuditVariant,
+  qualitySpineCheckVariant
 ]);
 var QUALITY_ACTION_SPECS = {
   check: { params: ["entryId"], description: "entryId is required." },
   "re-evaluate": { params: ["entryId", "context"], description: "entryId is required." },
   "verify-chain": { params: ["collection", "mode"], description: "All params optional; collection defaults to 'glossary'." },
-  audit: { params: ["entryId", "phase"], description: "entryId is required." }
+  audit: { params: ["entryId", "phase"], description: "entryId is required." },
+  "spine-check": { params: ["story", "refresh"], description: "All params optional; story and refresh default to false \u2014 a plain call never re-triggers work, it just reads back the latest verdict (auto-refreshing only when stale/absent)." }
 };
 var qualityCheckOutputSchema = z22.object({
   entryId: z22.string(),
@@ -11820,18 +11907,26 @@ var qualityReevaluateOutputSchema = z22.object({
   maxScore: z22.number(),
   improved: z22.boolean()
 });
+var qualitySpineCheckOutputSchema = z22.object({
+  hasVerdict: z22.boolean(),
+  noSpineEntries: z22.boolean().optional(),
+  structuralPassed: z22.boolean().optional(),
+  storyPassed: z22.boolean().nullable().optional(),
+  stale: z22.boolean().optional()
+});
 function registerQualityTools(server) {
   const qualityHandlers = {
     check: (data) => handleCheck(data.entryId),
     "re-evaluate": (data) => handleReEvaluate(data.entryId, data.context ?? "review"),
     "verify-chain": (data) => handleVerifyChain(server, { collection: data.collection ?? "glossary", mode: data.mode ?? "report" }),
-    audit: (data) => handleAuditRun(data.entryId, data.phase ?? "shaping")
+    audit: (data) => handleAuditRun(data.entryId, data.phase ?? "shaping"),
+    "spine-check": (data) => handleSpineCheck(data.story ?? false, data.refresh ?? false)
   };
   server.registerTool(
     "quality",
     {
       title: "Quality",
-      description: "Assess, re-evaluate, and verify entry/bet quality. Four actions:\n\n- **check**: Read the entry's server quality verdict (tier + criteria) \u2014 it does not re-score. Suggests links when the entry has no relations.\n- **re-evaluate**: Trigger a fresh quality evaluation. Returns heuristic verdict immediately, schedules LLM evaluation in background.\n- **verify-chain**: Verify knowledge entries against the actual codebase (codeMapping drift, cross-references) \u2014 absorbs `verify`. Produces a trust report with a trust score.\n- **audit**: Run hygiene audit on a bet entry (13/18 gates) \u2014 absorbs `audit`.",
+      description: "Assess, re-evaluate, and verify entry/bet quality. Five actions:\n\n- **check**: Read the entry's server quality verdict (tier + criteria) \u2014 it does not re-score. Suggests links when the entry has no relations.\n- **re-evaluate**: Trigger a fresh quality evaluation. Returns heuristic verdict immediately, schedules LLM evaluation in background.\n- **verify-chain**: Verify knowledge entries against the actual codebase (codeMapping drift, cross-references) \u2014 absorbs `verify`. Produces a trust report with a trust score.\n- **audit**: Run hygiene audit on a bet entry (13/18 gates) \u2014 absorbs `audit`.\n- **spine-check**: Structural completeness of the purpose+vision+strategy spine \u2014 duplicate singletons, connectedness, per-strategy refusal heuristic; story:true also runs the on-demand one-story LLM judgment (never scheduled, result labelled [unvalidated]). Async: a plain call reads back the latest stored verdict and auto-schedules a new run ONLY when none is already in flight AND the stored one is absent/stale/missing the requested story pass \u2014 repeated polling never re-triggers work. Pass refresh:true to force a fresh run regardless.",
       inputSchema: qualitySchema,
       annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }
     },
@@ -16309,4 +16404,4 @@ export {
   createProductBrainServer,
   initFeatureFlags
 };
-//# sourceMappingURL=chunk-KFXZUDFK.js.map
+//# sourceMappingURL=chunk-CY3YQR26.js.map