figjam-context-mcp 0.0.0-stage → 0.4.0

package/dist/lib/docStructureMapper.js

@@ -0,0 +1,121 @@
+const FRAMEWORKS = {
+    double_diamond: [
+        {
+            name: "discover",
+            keywords: [
+                "research", "interview", "insight", "observation", "survey", "persona",
+                "user need", "pain point", "quote", "empathy", "explore", "discovery",
+                "finding", "field study", "competitor", "benchmark", "umfrage", "zitat",
+            ],
+        },
+        {
+            name: "define",
+            keywords: [
+                "problem", "define", "how might we", "hmw", "scope", "goal", "requirement",
+                "constraint", "framing", "point of view", "synthesis", "target group",
+                "hypothesis", "opportunity", "priorit", "ziel", "anforderung", "zielgruppe",
+            ],
+        },
+        {
+            name: "develop",
+            keywords: [
+                "idea", "ideation", "brainstorm", "sketch", "concept", "prototype",
+                "solution", "wireframe", "variant", "experiment", "crazy 8", "mockup",
+                "design option", "storyboard", "idee", "konzept", "entwurf", "skizze",
+            ],
+        },
+        {
+            name: "deliver",
+            keywords: [
+                "deliver", "launch", "ship", "roadmap", "next step", "action item",
+                "timeline", "implementation", "rollout", "release", "mvp", "milestone",
+                "test plan", "handoff", "todo", "owner", "umsetzung", "nächste schritte",
+            ],
+        },
+    ],
+    lean_canvas: [
+        { name: "problem", keywords: ["problem", "pain", "need", "frustration", "existing alternative"] },
+        { name: "solution", keywords: ["solution", "feature", "lösung", "approach", "fix"] },
+        { name: "value_proposition", keywords: ["value", "unique", "proposition", "promise", "benefit", "nutzen"] },
+        { name: "customer_segments", keywords: ["customer", "segment", "target", "audience", "persona", "user group", "zielgruppe"] },
+        { name: "channels", keywords: ["channel", "marketing", "reach", "distribution", "social media", "kanal"] },
+        { name: "revenue_costs", keywords: ["revenue", "cost", "price", "pricing", "budget", "monetiz", "umsatz", "kosten"] },
+        { name: "metrics", keywords: ["metric", "kpi", "measure", "analytics", "retention", "conversion", "messung"] },
+        { name: "advantage", keywords: ["advantage", "moat", "unfair", "differentiat", "alleinstellung"] },
+    ],
+    retro: [
+        {
+            name: "went_well",
+            keywords: ["went well", "good", "success", "win", "proud", "liked", "lief gut", "positiv", "gut gelaufen", "kudos", "danke"],
+        },
+        {
+            name: "needs_improvement",
+            keywords: ["improve", "didn't go well", "problem", "issue", "friction", "frustrat", "blocker", "verbessern", "schlecht", "ärger", "hindernis"],
+        },
+        {
+            name: "action_items",
+            keywords: ["action", "next step", "todo", "try", "experiment", "owner", "commit", "maßnahme", "nächste schritte", "ausprobieren"],
+        },
+    ],
+    user_journey: [
+        { name: "awareness", keywords: ["awareness", "discover", "first contact", "ad", "hears about", "aufmerksam"] },
+        { name: "consideration", keywords: ["consider", "compare", "evaluate", "research", "alternative", "vergleich"] },
+        { name: "onboarding", keywords: ["onboard", "sign up", "signup", "register", "first use", "setup", "registrier"] },
+        { name: "usage", keywords: ["use", "usage", "daily", "task", "workflow", "habit", "interaction", "nutzung", "alltag"] },
+        { name: "retention", keywords: ["retention", "return", "churn", "loyal", "recommend", "advocate", "bindung", "empfehl"] },
+    ],
+};
+/**
+ * Assigns each cluster a phase from the active framework. Order of
+ * precedence: customPhases (free-form names) > built-in framework for the
+ * hint > no-op for "freeform". Clusters with no keyword hits — or a tie
+ * between phases — get "unclear".
+ */
+export function mapClustersToPhases(clusters, hint, customPhases) {
+    const phases = customPhases && customPhases.length > 0
+        ? customPhases.map(toCustomPhase)
+        : hint !== "freeform"
+            ? FRAMEWORKS[hint]
+            : undefined;
+    if (!phases) {
+        return clusters;
+    }
+    return clusters.map((cluster) => ({
+        ...cluster,
+        phase: classify(cluster, phases),
+    }));
+}
+/**
+ * Custom phases arrive as bare names ("Ideen sammeln"), so their keywords
+ * are the name itself plus its individual significant words.
+ */
+function toCustomPhase(name) {
+    const normalized = name.trim().toLowerCase();
+    const words = normalized.split(/[^\p{L}\p{N}]+/u).filter((word) => word.length > 2);
+    return { name: name.trim(), keywords: [...new Set([normalized, ...words])] };
+}
+/** Scores one cluster against all phases and picks the unambiguous winner. */
+function classify(cluster, phases) {
+    const label = cluster.label.toLowerCase();
+    const summary = cluster.summary.toLowerCase();
+    let best = "unclear";
+    let bestScore = 0;
+    let tied = false;
+    for (const phase of phases) {
+        const score = phase.keywords.reduce((total, keyword) => {
+            const inLabel = label.includes(keyword) ? 2 : 0;
+            const inSummary = summary.includes(keyword) ? 1 : 0;
+            return total + inLabel + inSummary;
+        }, 0);
+        if (score > bestScore) {
+            best = phase.name;
+            bestScore = score;
+            tied = false;
+        }
+        else if (score === bestScore && score > 0) {
+            tied = true;
+        }
+    }
+    return bestScore === 0 || tied ? "unclear" : best;
+}
+//# sourceMappingURL=docStructureMapper.js.map

package/dist/lib/docStructureMapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docStructureMapper.js","sourceRoot":"","sources":["../../src/lib/docStructureMapper.ts"],"names":[],"mappings":"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"}

package/dist/lib/env.d.ts

@@ -0,0 +1,2 @@
+export declare function readIntEnv(name: string, fallback: number, min: number): number;
+export declare function readBoolEnv(name: string, fallback: boolean): boolean;

package/dist/lib/env.js

@@ -0,0 +1,25 @@
+export function readIntEnv(name, fallback, min) {
+    const raw = process.env[name]?.trim();
+    if (!raw) {
+        return fallback;
+    }
+    const parsed = Number(raw);
+    if (!Number.isInteger(parsed) || parsed < min) {
+        throw new Error(`${name} must be an integer >= ${min}`);
+    }
+    return parsed;
+}
+export function readBoolEnv(name, fallback) {
+    const raw = process.env[name]?.trim().toLowerCase();
+    if (!raw) {
+        return fallback;
+    }
+    if (["1", "true", "yes", "on"].includes(raw)) {
+        return true;
+    }
+    if (["0", "false", "no", "off"].includes(raw)) {
+        return false;
+    }
+    throw new Error(`${name} must be a boolean`);
+}
+//# sourceMappingURL=env.js.map

package/dist/lib/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAAgB,EAAE,GAAW;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,0BAA0B,GAAG,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,QAAiB;IACzD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAC;AAC/C,CAAC"}

package/dist/lib/evidence.d.ts

@@ -0,0 +1,63 @@
+import type { BoardData, ConnectorEdge } from "../types.js";
+export declare const EVIDENCE_CHUNK_CHARS = 1200;
+export declare const MAX_CONTEXT_RESPONSE_BYTES: number;
+/** Original board text and model interpretations remain distinguishable at every boundary. */
+export interface Evidence {
+    evidenceId: string;
+    snapshotId: string;
+    nodeId: string;
+    text: string;
+    sourceType: "board_text" | "table_cell" | "board_metadata" | "model_interpretation" | "cluster_summary";
+    modelDerived: boolean;
+    clusterId?: string;
+    clusterLabel?: string;
+    nodeName?: string;
+    pageName?: string;
+    sectionNames?: string[];
+    pageId?: string;
+    sectionIds?: string[];
+    renderNodeId?: string;
+    row?: number;
+    column?: number;
+    chunkIndex: number;
+    url: string;
+    truncated: boolean;
+}
+export interface EvidenceConnection {
+    connectorId: string;
+    fromNodeId: string;
+    toNodeId: string;
+    direction: NonNullable<ConnectorEdge["direction"]>;
+    label?: string;
+    url: string;
+}
+export interface EvidenceQuery {
+    query?: string;
+    nodeIds?: string[];
+    /** Restricts primary matches before bounded one-hop expansion (Q&A). */
+    limit?: number;
+    includeNeighbors?: boolean;
+    neighborLimit?: number;
+    /** Bounded cell context for lexical table matches, separate from graph neighbors. */
+    tableNeighborLimit?: number;
+}
+export interface EvidenceResult {
+    snapshotId: string;
+    evidence: Evidence[];
+    /** Internal selection boundary; never serialized as an MCP response field. */
+    primaryEvidenceIds: string[];
+    connections: EvidenceConnection[];
+    totalMatched: number;
+}
+/** Unicode word segmentation supports accented words and scripts without whitespace. */
+export declare function evidenceTokens(text: string): string[];
+export declare function snapshotIdForBoard(board: BoardData): string;
+export declare function nodeLink(board: BoardData, nodeId: string): string;
+/** Deterministic field-weighted BM25 over original chunks and source metadata. */
+export declare function retrieveEvidence(board: BoardData, options?: EvidenceQuery): EvidenceResult;
+/** Only connections between displayed source nodes are evidence for the current response. */
+export declare function connectionsForEvidence(board: BoardData, evidence: Evidence[]): EvidenceConnection[];
+export declare function countConnectionsForEvidence(board: BoardData, evidence: Evidence[]): number;
+export declare function formatEvidenceConnection(connection: EvidenceConnection): string;
+export declare function formatEvidence(item: Evidence): string;
+export declare function boundedText(value: string, maxChars: number): string;