fullstackgtm 0.16.0 → 0.18.0

package/src/marketReport.ts

@@ -6,6 +6,7 @@ import type {
   ObservationSet,
 } from "./market.ts";
 import { computeFrontStates } from "./market.ts";
+import { assessAxes, messageBreadth, type AxesReport } from "./marketAxes.ts";
 
 /**
  * Render a market map as a client-ready deliverable: markdown for terminals
@@ -104,6 +105,127 @@ export function marketMapToMarkdown(config: MarketConfig, set: ObservationSet):
   return `${lines.join("\n")}\n`;
 }
 
+type ScatterPoint = { vendorId: string; name: string; x: number; y: number; loud: number };
+type ScatterAxis = { label: string; negativePole: string; positivePole: string; signed: boolean };
+
+function svgScatter(
+  points: ScatterPoint[],
+  ax: ScatterAxis,
+  ay: ScatterAxis,
+  anchor: string | undefined,
+  mini: boolean,
+): string {
+  const W = mini ? 330 : 700;
+  const H = mini ? 250 : 460;
+  const PAD = mini ? 34 : 56;
+  const range = (axis: ScatterAxis, values: number[]): [number, number] => {
+    if (axis.signed) return [-1.1, 1.1];
+    if (values.length === 0) return [0, 1];
+    return [Math.min(0, Math.min(...values) - 0.05), Math.max(...values) + 0.08];
+  };
+  const [xLo, xHi] = range(ax, points.map((p) => p.x));
+  const [yLo, yHi] = range(ay, points.map((p) => p.y));
+  const sx = (x: number) => PAD + ((x - xLo) / (xHi - xLo)) * (W - 2 * PAD);
+  const sy = (y: number) => H - PAD - ((y - yLo) / (yHi - yLo)) * (H - 2 * PAD);
+  const fsLabel = mini ? 8.5 : 10.5;
+  const fsAx = mini ? 8 : 10;
+  const e = escapeHtml;
+  const dots = points
+    .map((p) => {
+      const r = mini ? 3 + p.loud * 0.8 : 6 + p.loud * 1.6;
+      const cls = p.vendorId === anchor ? "dot-anchor" : "dot";
+      return (
+        `<circle class="${cls}" cx="${sx(p.x).toFixed(1)}" cy="${sy(p.y).toFixed(1)}" r="${r.toFixed(1)}"/>` +
+        `<text class="dot-label" style="font-size:${fsLabel}px" x="${sx(p.x).toFixed(1)}" y="${(sy(p.y) - r - 4).toFixed(1)}">${e(p.name)}</text>`
+      );
+    })
+    .join("");
+  const midX = ax.signed ? `<line class="axis-mid" x1="${sx(0).toFixed(0)}" y1="${PAD}" x2="${sx(0).toFixed(0)}" y2="${H - PAD}"/>` : "";
+  const midY = ay.signed ? `<line class="axis-mid" x1="${PAD}" y1="${sy(0).toFixed(0)}" x2="${W - PAD}" y2="${sy(0).toFixed(0)}"/>` : "";
+  return `<svg viewBox="0 0 ${W} ${H}" role="img" aria-label="${e(ax.label)} vs ${e(ay.label)}">
+    <line class="axis" x1="${PAD}" y1="${H - PAD}" x2="${W - PAD}" y2="${H - PAD}"/>
+    <line class="axis" x1="${PAD}" y1="${PAD}" x2="${PAD}" y2="${H - PAD}"/>${midX}${midY}
+    <text class="ax-label" style="font-size:${fsAx}px" x="${PAD}" y="${H - 14}">&#8592; ${e(ax.negativePole)}</text>
+    <text class="ax-label" style="font-size:${fsAx}px" x="${W - PAD}" y="${H - 14}" text-anchor="end">${e(ax.positivePole)} &#8594;</text>
+    <text class="ax-label" style="font-size:${fsAx}px" x="${PAD}" y="${PAD - 10}">&#8593; ${e(ay.positivePole)}${ay.signed ? ` &#183; &#8595; ${e(ay.negativePole)}` : ""}</text>
+    ${dots}</svg>`;
+}
+
+function axisSectionsHtml(
+  config: MarketConfig,
+  set: ObservationSet,
+): { strategicMap: string; report: AxesReport | null } {
+  const axes = config.axes ?? [];
+  if (axes.length === 0) return { strategicMap: "", report: null };
+  const e = escapeHtml;
+  const report = assessAxes(config, set);
+  const vendorNames = new Map(config.vendors.map((vendor) => [vendor.id, vendor.name]));
+  const loudCounts = new Map(report.vendors.map((vendorId) => [vendorId, messageBreadth(vendorId, set.observations).loudCount]));
+
+  const breadthAxis: ScatterAxis & { id: string } = {
+    id: "breadth",
+    label: "Message breadth",
+    negativePole: "FOCUSED",
+    positivePole: "BROAD (share of claims voiced)",
+    signed: false,
+  };
+  const axisInfo = new Map<string, ScatterAxis & { id: string }>([
+    ...axes.map((axis) => [axis.id, { id: axis.id, label: axis.label, negativePole: axis.negativePole, positivePole: axis.positivePole, signed: true }] as const),
+    [breadthAxis.id, breadthAxis],
+  ]);
+  const positions = new Map<string, Map<string, number>>();
+  for (const assessment of report.assessments) {
+    positions.set(
+      assessment.axis.id,
+      new Map(
+        assessment.positions
+          .filter((entry): entry is { vendorId: string; position: number } => entry.position !== null)
+          .map((entry) => [entry.vendorId, entry.position]),
+      ),
+    );
+  }
+  const breadthMap = new Map<string, number>();
+  for (const vendorId of report.vendors) {
+    const { breadth } = messageBreadth(vendorId, set.observations);
+    if (breadth !== null) breadthMap.set(vendorId, breadth);
+  }
+  positions.set("breadth", breadthMap);
+
+  const pointsFor = (xId: string, yId: string): ScatterPoint[] => {
+    const xs = positions.get(xId);
+    const ys = positions.get(yId);
+    if (!xs || !ys) return [];
+    return report.vendors
+      .filter((vendorId) => xs.has(vendorId) && ys.has(vendorId))
+      .map((vendorId) => ({
+        vendorId,
+        name: vendorNames.get(vendorId) ?? vendorId,
+        x: xs.get(vendorId) as number,
+        y: ys.get(vendorId) as number,
+        loud: loudCounts.get(vendorId) ?? 0,
+      }));
+  };
+
+  const [px, py] = config.primaryAxes ?? [axes[0].id, axes[1]?.id ?? "breadth"];
+  const axInfo = axisInfo.get(px) as ScatterAxis & { id: string };
+  const ayInfo = axisInfo.get(py) as ScatterAxis & { id: string };
+  const statusOf = (id: string) => axes.find((axis) => axis.id === id)?.status ?? (id === "breadth" ? "derived" : "");
+  const strategicMap = `<section>
+  <h2><span class="no">03</span> Strategic map — ${e(axInfo.label)} &#215; ${e(ayInfo.label)}</h2>
+  <figure>${svgScatter(pointsFor(px, py), axInfo, ayInfo, config.anchorVendor, false)}
+  <figcaption>Positions computed from run ${e(set.runLabel)} observations: each axis is a per-claim scoring rubric
+  in the market config; a vendor sits at the intensity-weighted mean (loud=1, quiet=&#189;) of the claims it
+  voices. Dot size = LOUD count. Axis status — ${e(axInfo.label)}: ${e(statusOf(px))}; ${e(ayInfo.label)}: ${e(statusOf(py))}.</figcaption>
+  </figure>
+</section>`;
+
+  // Deliberately no axis-pairing gallery here: the report is the client-facing
+  // artifact, best foot forward — one earned 2x2. Axis exploration (PCA,
+  // triangulation, the orthogonality screen over every pairing) lives in
+  // `market axes` for the analyst or agent doing the iterating.
+  return { strategicMap, report };
+}
+
 export function marketMapToHtml(config: MarketConfig, set: ObservationSet): string {
   const model = buildModel(config, set);
   const stateByClaim = new Map(model.fronts.map((front) => [front.claimId, front.state]));
@@ -113,6 +235,8 @@ export function marketMapToHtml(config: MarketConfig, set: ObservationSet): stri
   const unobservable = set.observations.filter((obs) => obs.intensity === "unobservable").length;
   const anchor = config.anchorVendor;
   const e = escapeHtml;
+  const axisHtml = axisSectionsHtml(config, set);
+  const appendixNo = axisHtml.report ? "04" : "03";
 
   const matrixRows = model.orderedClaimIds
     .map((claimId) => {
@@ -223,6 +347,14 @@ tr.front-open th .claim-cap { color:var(--accent); font-weight:600; }
 .ev-head { font-size:10.5px; letter-spacing:.1em; color:var(--accent); }
 .ev blockquote { font-style:italic; margin:6px 0; font-size:13.5px; line-height:1.5; }
 .ev-src { font-size:10px; color:var(--ink-soft); word-break:break-all; }
+figure { margin-top:22px; border:1px solid var(--line); background:rgba(255,255,255,.35); }
+.axis { stroke:var(--ink); stroke-width:1.5; }
+.axis-mid { stroke:var(--line); stroke-dasharray:3 5; }
+.ax-label { letter-spacing:.16em; fill:var(--ink-soft); font-family:"SF Mono",Menlo,Consolas,monospace; }
+.dot { fill:rgba(33,29,22,.78); }
+.dot-anchor { fill:var(--green); stroke:var(--ink); stroke-width:1.5; }
+.dot-label { fill:var(--ink); text-anchor:middle; letter-spacing:.04em; font-family:"SF Mono",Menlo,Consolas,monospace; }
+figcaption { font-size:12px; color:var(--ink-soft); padding:12px 16px 14px; font-style:italic; border-top:1px solid var(--line); line-height:1.5; }
 footer { margin-top:72px; border-top:3px double var(--ink); padding-top:14px; font-size:11px; color:var(--ink-soft);
   display:flex; justify-content:space-between; gap:20px; flex-wrap:wrap; }
 @media print { body { max-width:none; padding:0 8mm; background:white; } section { break-inside:avoid-page; } tr { break-inside:avoid; } }
@@ -260,8 +392,9 @@ footer { margin-top:72px; border-top:3px double var(--ink); padding-top:14px; fo
     <tbody>${matrixRows}</tbody>
   </table>
 </section>
+${axisHtml.strategicMap}
 <section>
-  <h2><span class="no">03</span> Evidence appendix</h2>
+  <h2><span class="no">${appendixNo}</span> Evidence appendix</h2>
   ${appendix}
 </section>
 <footer>

package/src/mcp.ts

@@ -48,6 +48,16 @@ import { builtinAuditRules } from "./rules.ts";
 import { sampleSnapshot } from "./sampleData.ts";
 import { normalizeTranscript, parseCall } from "./calls.ts";
 import { extractInsightsLlm, resolveLlmCredential } from "./llm.ts";
+import {
+  computeFrontStates,
+  createFileObservationStore,
+  loadCaptureTexts,
+  loadMarketConfig,
+  validateObservationSet,
+  verifyEvidenceSpans,
+  type ObservationSet,
+} from "./market.ts";
+import { buildWorksheet } from "./marketClassify.ts";
 import { resolveRecord } from "./resolve.ts";
 import { suggestValues } from "./suggest.ts";
 import type { CanonicalGtmSnapshot, GtmConnector, PatchPlan } from "./types.ts";
@@ -307,6 +317,61 @@ export async function startMcpServer() {
     },
   );
 
+  server.registerTool(
+    "fullstackgtm_market_worksheet",
+    {
+      title: "Market Map Classification Worksheet",
+      description:
+        "Get everything needed to classify ONE vendor's messaging intensity for a market map: " +
+        "the claim taxonomy with judging definitions, the surface rule, and the captured page " +
+        "texts. Read each claim's definition, judge loud/quiet/absent from the page texts only, " +
+        "and quote verbatim spans (≤300 chars) for every loud/quiet reading. Submit the full " +
+        "ObservationSet via fullstackgtm_market_observe — quotes are verified character-for-" +
+        "character against the captures, so never paraphrase.",
+      inputSchema: {
+        vendorId: z.string(),
+        configPath: z.string().optional().describe("Path to market.config.json (default ./market.config.json)"),
+        captureRun: z.string().optional(),
+      },
+    },
+    async ({ vendorId, configPath, captureRun }) => {
+      const config = loadMarketConfig(resolve(process.cwd(), configPath ?? "market.config.json"));
+      return content(buildWorksheet(config, vendorId, { captureRun }));
+    },
+  );
+
+  server.registerTool(
+    "fullstackgtm_market_observe",
+    {
+      title: "Submit Market Map Observations",
+      description:
+        "Submit a complete ObservationSet (every vendor × claim cell) for a market map run. " +
+        "Validates coverage, the verbatim-evidence rule, and mechanically verifies every quoted " +
+        "span against the stored capture it cites. Returns problems if rejected; nothing is " +
+        "stored unless the whole set passes. Observations are append-only — use a new runLabel.",
+      inputSchema: {
+        observationsPath: z.string().describe("Path to the ObservationSet JSON file"),
+        configPath: z.string().optional().describe("Path to market.config.json (default ./market.config.json)"),
+      },
+    },
+    async ({ observationsPath, configPath }) => {
+      const config = loadMarketConfig(resolve(process.cwd(), configPath ?? "market.config.json"));
+      const set = JSON.parse(readFileSync(resolve(process.cwd(), observationsPath), "utf8")) as ObservationSet;
+      const problems = validateObservationSet(config, set);
+      const failures = verifyEvidenceSpans(set.observations, loadCaptureTexts(config.category).textByHash);
+      if (problems.length > 0 || failures.length > 0) {
+        return content({
+          accepted: false,
+          problems,
+          spanFailures: failures.map((failure) => `${failure.vendorId} × ${failure.claimId}: ${failure.problem}`),
+        });
+      }
+      await createFileObservationStore(config.category).append(set);
+      const fronts = computeFrontStates(config, set);
+      return content({ accepted: true, runLabel: set.runLabel, observations: set.observations.length, fronts });
+    },
+  );
+
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }