fullstackgtm 0.17.0 → 0.19.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

@@ -335,7 +335,7 @@ export async function startMcpServer() {
       },
     },
     async ({ vendorId, configPath, captureRun }) => {
-      const config = loadMarketConfig(resolve(process.cwd(), configPath ?? "market.config.json"));
+      const config = loadMarketConfigOrHint(resolve(process.cwd(), configPath ?? "market.config.json"));
       return content(buildWorksheet(config, vendorId, { captureRun }));
     },
   );
@@ -355,7 +355,7 @@ export async function startMcpServer() {
       },
     },
     async ({ observationsPath, configPath }) => {
-      const config = loadMarketConfig(resolve(process.cwd(), configPath ?? "market.config.json"));
+      const config = loadMarketConfigOrHint(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);
@@ -375,3 +375,16 @@ export async function startMcpServer() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
+
+function loadMarketConfigOrHint(path: string): ReturnType<typeof loadMarketConfig> {
+  try {
+    return loadMarketConfig(path);
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code === "ENOENT") {
+      throw new Error(
+        `No market config at ${path} — run \`fullstackgtm market init --category <name>\` in that directory first, or pass configPath.`,
+      );
+    }
+    throw error;
+  }
+}

package/src/types.ts

@@ -289,6 +289,20 @@ export type PatchOperation = {
   evidenceIds?: string[];
   findingIds?: string[];
   verification?: PatchVerification;
+  /**
+   * Compare-and-set guards beyond the written field: each precondition is
+   * re-read at apply time and a mismatch turns the operation into a
+   * conflict instead of a write. Guards against a record drifting on a
+   * DIFFERENT field than the one being written (e.g. stage changed while
+   * an owner write was pending).
+   */
+  preconditions?: Array<{ field: string; expectedValue: unknown }>;
+  /**
+   * Operations sharing a groupId are all-or-nothing at apply time: a
+   * conflict (beforeValue or precondition) on any member skips every
+   * member of the group.
+   */
+  groupId?: string;
 };
 
 /**
@@ -306,6 +320,31 @@ export type PatchPlan = {
   pipelineFindings?: PipelineFinding[];
   evidence?: GtmEvidence[];
   operations: PatchOperation[];
+  /**
+   * The filter this plan's operations were selected by. Re-evaluated per
+   * record against a FRESH snapshot at apply time: any operation whose
+   * record no longer matches is reported as a conflict instead of applied.
+   * Unlike per-operation preconditions, this enforces the FULL filter —
+   * negations and relational pseudo-fields included.
+   */
+  filter?: { objectType: "account" | "contact" | "deal"; where: string[] };
+  /**
+   * Plan-level guards re-evaluated against a FRESH snapshot at apply time.
+   * If any guard fails, NO operation in the plan is applied. This is how a
+   * plan expresses cross-record eligibility ("apply only while the account
+   * still has no open deal in contractsent") that per-operation
+   * preconditions cannot reach.
+   */
+  guards?: PlanGuard[];
+};
+
+export type PlanGuard = {
+  objectType: "account" | "contact" | "deal";
+  /** filter expressions in bulk-update --where grammar, AND-ed */
+  where: string[];
+  /** none: guard passes when ZERO records match; some: when at least one matches */
+  expect: "none" | "some";
+  description?: string;
 };
 
 // ── Audit rule engine ──────────────────────────────────────────