@productbrain/mcp 0.0.1-beta.29 → 0.0.1-beta.30

package/dist/{chunk-ILOHGZZC.js → chunk-IUSCWY4O.js}

@@ -15,7 +15,10 @@ import {
   requireWriteAccess,
   setSessionOriented,
   startAgentSession
-} from "./chunk-CKXLZBWQ.js";
+} from "./chunk-P5KVCIYN.js";
+import {
+  trackQualityVerdict
+} from "./chunk-SJ2ODB3Y.js";
 
 // src/server.ts
 import { McpServer as McpServer2 } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -1001,7 +1004,7 @@ Use \`list-collections\` to verify the result.`
     },
     async ({ entryId }) => {
       requireWriteAccess();
-      const { runContradictionCheck } = await import("./smart-capture-J27LOWAP.js");
+      const { runContradictionCheck } = await import("./smart-capture-TLGJDCEQ.js");
       const entry = await mcpQuery("chain.getEntry", { entryId });
       if (!entry) {
         return {
@@ -1015,10 +1018,10 @@ Use \`list-collections\` to verify the result.`
       }
       let coachingResult = null;
       try {
-        coachingResult = await Promise.race([
-          mcpMutation("quality.evaluateAtCommit", { entryId }),
-          new Promise((resolve3) => setTimeout(() => resolve3(null), 6e3))
-        ]);
+        coachingResult = await mcpMutation("quality.evaluateHeuristicAndSchedule", {
+          entryId,
+          context: "commit"
+        });
       } catch {
       }
       const result = await mcpMutation("chain.commitEntry", {
@@ -1053,6 +1056,24 @@ Use \`list-collections\` to verify the result.`
         }
         lines.push("Run gather-context on these entries before committing.");
       }
+      if (coachingResult?.verdict) {
+        try {
+          const v = coachingResult.verdict;
+          const failedCount = (v.criteria ?? []).filter((c) => !c.passed).length;
+          trackQualityVerdict(wsCtx.workspaceId, {
+            entry_id: entryId,
+            entry_type: v.canonicalKey ?? entry.canonicalKey ?? "",
+            tier: v.tier,
+            context: "commit",
+            passed: v.passed,
+            source: coachingResult.source ?? "heuristic",
+            criteria_total: v.criteria?.length ?? 0,
+            criteria_failed: failedCount,
+            llm_scheduled: v.tier !== "passive"
+          });
+        } catch {
+        }
+      }
       if (coachingResult?.verdict && coachingResult.verdict.tier !== "passive" && coachingResult.verdict.criteria.length > 0) {
         const coaching = formatRubricCoaching(coachingResult);
         if (coaching) {
@@ -1064,7 +1085,10 @@ Use \`list-collections\` to verify the result.`
           }
         }
       }
-      return { content: [{ type: "text", text: lines.join("\n") }] };
+      return {
+        content: [{ type: "text", text: lines.join("\n") }],
+        structuredContent: coachingResult?.verdict ? { qualityVerdict: coachingResult.verdict, source: coachingResult.source ?? "heuristic" } : void 0
+      };
     }
   );
 }
@@ -4006,7 +4030,7 @@ var COLLECTION_PRESETS = [
     name: "Software Product",
     description: "For teams building software products \u2014 glossary, features, architecture, tech debt, and API endpoints",
     collections: [
-      { slug: "glossary", name: "Glossary", description: "Canonical terminology for the product domain", idPrefix: "GT", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "select", options: ["Platform & Architecture", "Knowledge Management", "AI & Developer Tools", "Governance & Process"] }, { key: "confusedWith", label: "Confused With", type: "array" }] },
+      { slug: "glossary", name: "Glossary", description: "Canonical terminology for the product domain", idPrefix: "GLO", fields: [{ key: "canonical", label: "Canonical", type: "string", required: true, searchable: true }, { key: "category", label: "Category", type: "select", options: ["Platform & Architecture", "Knowledge Management", "AI & Developer Tools", "Governance & Process"] }, { key: "confusedWith", label: "Confused With", type: "array" }] },
       { slug: "features", name: "Features", description: "Product features and capabilities", idPrefix: "FEAT", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "scope", label: "Scope", type: "string" }, { key: "area", label: "Area", type: "string" }, { key: "status", label: "Status", type: "select", options: ["proposed", "in-progress", "shipped", "deprecated"] }] },
       { slug: "architecture", name: "Architecture", description: "System architecture layers and components", idPrefix: "ARCH", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "layer", label: "Layer", type: "string" }, { key: "dependencies", label: "Dependencies", type: "array" }] },
       { slug: "tech-debt", name: "Tech Debt", description: "Technical debt items to track and address", fields: [{ key: "description", label: "Description", type: "string", required: true, searchable: true }, { key: "severity", label: "Severity", type: "select", options: ["low", "medium", "high", "critical"] }, { key: "area", label: "Area", type: "string" }, { key: "effort", label: "Effort", type: "select", options: ["small", "medium", "large"] }] },
@@ -4360,6 +4384,72 @@ async function buildOrientResponse(wsCtx, agentSessionId, errors) {
   return lines.join("\n");
 }
 
+// src/tools/usage.ts
+import { z as z10 } from "zod";
+function registerUsageTools(server) {
+  server.registerTool(
+    "get-usage-summary",
+    {
+      title: "Get Usage Summary",
+      description: "Returns LLM usage and cost summary for the current workspace. Includes total spend, token counts, model breakdown, and feature breakdown for the specified period. If called within an agent session, also includes the current session's cost. Use this to understand AI spend, check budgets, or analyze which features and models drive cost.",
+      inputSchema: {
+        periodDays: z10.number().min(1).max(90).optional().describe("Number of days to look back (default 30, max 90)")
+      },
+      annotations: {
+        readOnlyHint: true
+      }
+    },
+    async ({ periodDays }) => {
+      const ws = await getWorkspaceContext();
+      const sessionId = getAgentSessionId();
+      const summary = await mcpQuery("usage.getWorkspaceSummary", {
+        periodDays: periodDays ?? 30
+      });
+      if (!summary) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: "No usage data available yet. LLM tracking may not be active or no calls have been made in this period."
+            }
+          ]
+        };
+      }
+      const lines = [
+        `## Usage Summary \u2014 ${ws.workspaceName}`,
+        `Period: last ${summary.periodDays} days`,
+        "",
+        `**Total spend:** $${summary.totalCostUsd.toFixed(4)} USD (${summary.totalRequests} requests)`,
+        `**Total tokens:** ${summary.totalTokens.toLocaleString()} (cached: ${summary.cachedTokens.toLocaleString()}, reasoning: ${summary.reasoningTokens.toLocaleString()})`,
+        `**Cache hit rate:** ${(summary.cacheHitRate * 100).toFixed(1)}%`
+      ];
+      if (summary.modelBreakdown.length > 0) {
+        lines.push("", "### Model Breakdown");
+        for (const m of summary.modelBreakdown) {
+          lines.push(`- **${m.model}**: $${m.costUsd.toFixed(4)} (${m.requests} requests)`);
+        }
+      }
+      if (summary.featureBreakdown.length > 0) {
+        lines.push("", "### Feature Breakdown");
+        for (const f of summary.featureBreakdown) {
+          lines.push(`- **${f.feature}**: $${f.costUsd.toFixed(4)} (${f.requests} requests)`);
+        }
+      }
+      if (sessionId) {
+        lines.push("", `_Current agent session: ${sessionId}_`);
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: lines.join("\n")
+          }
+        ]
+      };
+    }
+  );
+}
+
 // src/resources/index.ts
 import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 function formatEntryMarkdown(entry) {
@@ -4572,12 +4662,12 @@ ${lines.join("\n")}`, mimeType: "text/markdown" }]
 }
 
 // src/prompts/index.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 function registerPrompts(server) {
   server.prompt(
     "review-against-rules",
     "Review code or a design decision against all business rules for a given domain. Fetches the rules and asks you to do a structured compliance review.",
-    { domain: z10.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
+    { domain: z11.string().describe("Business rule domain (e.g. 'Identity & Access', 'Governance & Decision-Making')") },
     async ({ domain }) => {
       const entries = await mcpQuery("chain.listEntries", { collectionSlug: "business-rules" });
       const rules = entries.filter((e) => e.data?.domain === domain);
@@ -4630,7 +4720,7 @@ Provide a structured review with a compliance status for each rule (COMPLIANT /
   server.prompt(
     "name-check",
     "Check variable names, field names, or API names against the glossary for terminology alignment. Flags drift from canonical terms.",
-    { names: z10.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
+    { names: z11.string().describe("Comma-separated list of names to check (e.g. 'vendor_id, compliance_level, formulator_type')") },
     async ({ names }) => {
       const terms = await mcpQuery("chain.listEntries", { collectionSlug: "glossary" });
       const glossaryContext = terms.map(
@@ -4666,7 +4756,7 @@ Format as a table: Name | Status | Canonical Form | Action Needed`
   server.prompt(
     "draft-decision-record",
     "Draft a structured decision record from a description of what was decided. Includes context from recent decisions and relevant rules.",
-    { context: z10.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
+    { context: z11.string().describe("Description of the decision (e.g. 'We decided to use MRSL v3.1 as the conformance baseline because...')") },
     async ({ context }) => {
       const recentDecisions = await mcpQuery("chain.listEntries", { collectionSlug: "decisions" });
       const sorted = [...recentDecisions].sort((a, b) => (b.data?.date ?? "") > (a.data?.date ?? "") ? 1 : -1).slice(0, 5);
@@ -4704,8 +4794,8 @@ After drafting, I can log it using the capture tool with collection "decisions".
     "draft-rule-from-context",
     "Draft a new business rule from an observation or discovery made while coding. Fetches existing rules for the domain to ensure consistency.",
     {
-      observation: z10.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
-      domain: z10.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
+      observation: z11.string().describe("What you observed or discovered (e.g. 'Suppliers can have multiple org types in Gateway')"),
+      domain: z11.string().describe("Which domain this rule belongs to (e.g. 'Governance & Decision-Making')")
     },
     async ({ observation, domain }) => {
       const allRules = await mcpQuery("chain.listEntries", { collectionSlug: "business-rules" });
@@ -4746,10 +4836,10 @@ Make sure the rule is consistent with existing rules and doesn't contradict them
     "run-workflow",
     "Launch a Chainwork workflow (retro, shape, IDM) in Facilitator Mode. Returns the full workflow definition, facilitation instructions, and round structure. The agent enters Facilitator Mode and guides the participant through each round.",
     {
-      workflow: z10.string().describe(
+      workflow: z11.string().describe(
         "Workflow ID to run. Available: " + listWorkflows().map((w) => `'${w.id}' (${w.name})`).join(", ")
       ),
-      context: z10.string().optional().describe(
+      context: z11.string().optional().describe(
         "Optional context from the participant (e.g., 'retro on last sprint', 'shape the Chainwork API bet')"
       )
     },
@@ -4904,6 +4994,7 @@ function createProductBrainServer() {
   if (enabledModules.has("gitchain")) registerMapTools(server);
   if (enabledModules.has("arch")) registerArchitectureTools(server);
   registerStartTools(server);
+  registerUsageTools(server);
   registerResources(server);
   registerPrompts(server);
   return server;
@@ -4913,4 +5004,4 @@ export {
   SERVER_VERSION,
   createProductBrainServer
 };
-//# sourceMappingURL=chunk-ILOHGZZC.js.map
+//# sourceMappingURL=chunk-IUSCWY4O.js.map