gitmem-mcp 0.2.0

package/dist/services/triple-writer.js

@@ -0,0 +1,338 @@
+/**
+ * Knowledge Triple Writer Service
+ *
+ * Phase 2: Rule-based extraction of knowledge triples from
+ * create_learning and create_decision operations.
+ *
+ * Design principles:
+ * - Fire-and-forget: never blocks the main tool response
+ * - High-confidence only: rule-based, no guessing
+ * - Uses directUpsert pattern from supabase-client.ts
+ */
+import { v4 as uuidv4 } from "uuid";
+import * as supabase from "./supabase-client.js";
+import { hasSupabase } from "./tier.js";
+// --- Constants ---
+/** Half-life profiles (days). Process = structural, never decays. */
+const HALF_LIFE_PROCESS = 9999;
+// --- Helpers ---
+/**
+ * Canonical persona name map.
+ * Raw personas_involved values may contain full names or contextual suffixes.
+ * This ensures consistent node identity in the knowledge graph.
+ */
+const CANONICAL_PERSONA_NAMES = {
+    "elena vos": "Elena",
+    "elena": "Elena",
+    "marcus thorne": "Marcus",
+    "marcus": "Marcus",
+    "reiko tanaka": "Reiko",
+    "reiko": "Reiko",
+    "jax": "Jax",
+    "jax dimitri": "Jax",
+    "jax reed": "Jax",
+    "chris crawford": "Chris Crawford",
+    "chris": "Chris Crawford",
+};
+/**
+ * Normalize a persona label to its canonical form.
+ * Strips contextual suffixes like " - UX navigation clarity" or ": Prefers non-invasive..."
+ * Then maps to canonical short name if known.
+ *
+ * Examples:
+ *   "Elena Vos" → "Elena"
+ *   "Marcus - Architectural pattern" → "Marcus"
+ *   "Elena: Prefers non-invasive instrumentation" → "Elena"
+ *   "Chris Crawford - Process decision" → "Chris Crawford"
+ */
+export function normalizePersonaLabel(raw) {
+    // Strip contextual suffix after " - " or ": "
+    let name = raw.split(" - ")[0].split(": ")[0].trim();
+    // Strip parenthetical role descriptions like "(Integration & Deployment)"
+    name = name.replace(/\s*\(.*?\)\s*$/, "").trim();
+    // Look up canonical name (case-insensitive)
+    const canonical = CANONICAL_PERSONA_NAMES[name.toLowerCase()];
+    return canonical || name;
+}
+/** Set of canonical persona names (Orchestra team members + human). */
+const KNOWN_PERSONAS = new Set(Object.values(CANONICAL_PERSONA_NAMES));
+/**
+ * Determine if a name refers to an Orchestra persona vs an agent.
+ * Returns true for Elena, Marcus, Reiko, Jax, Chris Crawford.
+ */
+function isPersonaName(name) {
+    return KNOWN_PERSONAS.has(normalizePersonaLabel(name));
+}
+/**
+ * Build a prefixed node label: "Persona: X" for known personas, "Agent: X" for agents.
+ * Normalizes persona names to canonical form.
+ */
+export function buildInfluencerLabel(rawName) {
+    const normalized = normalizePersonaLabel(rawName);
+    if (isPersonaName(normalized)) {
+        return `Persona: ${normalized}`;
+    }
+    return `Agent: ${rawName}`;
+}
+/**
+ * Build a human-readable subject label following the existing DB convention:
+ * "Win: Read-side enrichment pattern for denormalization gaps"
+ */
+function buildSubjectLabel(type, title) {
+    const typeLabels = {
+        scar: "Scar",
+        win: "Win",
+        pattern: "Pattern",
+        anti_pattern: "Anti-Pattern",
+        decision: "Decision",
+        thread: "Thread",
+    };
+    const label = typeLabels[type] || type.charAt(0).toUpperCase() + type.slice(1);
+    return `${label}: ${title}`;
+}
+/**
+ * Extract triples from a newly created learning using rule-based logic.
+ * Pure function — no side effects.
+ */
+export function extractLearningTriples(params) {
+    const triples = [];
+    const subjectLabel = buildSubjectLabel(params.learning_type, params.title);
+    const base = {
+        source_type: "learning",
+        source_id: params.id,
+        source_linear_issue: params.source_linear_issue,
+        domain: params.domain,
+        project: params.project,
+        half_life_days: HALF_LIFE_PROCESS,
+        created_by: params.persona_name,
+    };
+    // RULE 1: source_linear_issue -> "created_in"
+    if (params.source_linear_issue) {
+        triples.push({
+            ...base,
+            subject: subjectLabel,
+            predicate: "created_in",
+            object: `Issue: ${params.source_linear_issue}`,
+        });
+    }
+    // RULE 2: persona_name -> "influenced_by"
+    if (params.persona_name && params.persona_name !== "Unknown") {
+        triples.push({
+            ...base,
+            subject: subjectLabel,
+            predicate: "influenced_by",
+            object: buildInfluencerLabel(params.persona_name),
+        });
+    }
+    // RULE 3: Description contains "supersedes" with a reference
+    const supersedesMatch = params.description.match(/supersedes?\s+(?:scar|learning|pattern|win)?\s*[:\-]?\s*["']?([^"'\n.]{10,80})["']?/i);
+    if (supersedesMatch) {
+        triples.push({
+            ...base,
+            subject: subjectLabel,
+            predicate: "supersedes",
+            object: supersedesMatch[1].trim(),
+        });
+    }
+    return triples;
+}
+/**
+ * Extract triples from a newly created decision using rule-based logic.
+ * Pure function — no side effects.
+ */
+export function extractDecisionTriples(params) {
+    const triples = [];
+    const subjectLabel = buildSubjectLabel("decision", params.title);
+    const base = {
+        source_type: "decision",
+        source_id: params.id,
+        source_linear_issue: params.linear_issue,
+        project: params.project,
+        half_life_days: HALF_LIFE_PROCESS,
+        created_by: params.agent,
+    };
+    // RULE 1: linear_issue -> "created_in"
+    if (params.linear_issue) {
+        triples.push({
+            ...base,
+            subject: subjectLabel,
+            predicate: "created_in",
+            object: `Issue: ${params.linear_issue}`,
+        });
+    }
+    // RULE 2: Each persona -> "influenced_by"
+    if (params.personas_involved?.length) {
+        const seen = new Set();
+        for (const persona of params.personas_involved) {
+            const label = buildInfluencerLabel(persona);
+            if (seen.has(label))
+                continue; // dedup after normalization
+            seen.add(label);
+            triples.push({
+                ...base,
+                subject: subjectLabel,
+                predicate: "influenced_by",
+                object: label,
+            });
+        }
+    }
+    // RULE 3: Agent identity -> "influenced_by" (if not already covered by personas)
+    if (params.agent && params.agent !== "Unknown") {
+        const alreadyCovered = params.personas_involved?.some((p) => p.toLowerCase() === params.agent.toLowerCase());
+        if (!alreadyCovered) {
+            triples.push({
+                ...base,
+                subject: subjectLabel,
+                predicate: "influenced_by",
+                object: `Agent: ${params.agent}`,
+            });
+        }
+    }
+    // RULE 4: Each doc in docs_affected -> "affects_doc"
+    if (params.docs_affected?.length) {
+        for (const doc of params.docs_affected) {
+            triples.push({
+                ...base,
+                subject: subjectLabel,
+                predicate: "affects_doc",
+                object: `Doc: ${doc}`,
+            });
+        }
+    }
+    return triples;
+}
+// --- Write ---
+/**
+ * Write triples to knowledge_triples table.
+ * Fire-and-forget: errors logged but never thrown to caller.
+ */
+export async function writeTriples(candidates) {
+    if (candidates.length === 0 || !hasSupabase()) {
+        return 0;
+    }
+    let written = 0;
+    for (const candidate of candidates) {
+        try {
+            await supabase.directUpsert("knowledge_triples", {
+                id: uuidv4(),
+                subject: candidate.subject,
+                predicate: candidate.predicate,
+                object: candidate.object,
+                event_time: new Date().toISOString(),
+                decay_weight: 1.0,
+                half_life_days: candidate.half_life_days,
+                decay_floor: 0.1,
+                source_type: candidate.source_type,
+                source_id: candidate.source_id,
+                source_linear_issue: candidate.source_linear_issue || null,
+                domain: candidate.domain || [],
+                project: candidate.project,
+                created_at: new Date().toISOString(),
+                updated_at: new Date().toISOString(),
+                created_by: candidate.created_by,
+            });
+            written++;
+        }
+        catch (error) {
+            console.error(`[triple-writer] Failed to write triple: ${candidate.subject} ${candidate.predicate} ${candidate.object}`, error instanceof Error ? error.message : error);
+        }
+    }
+    if (written > 0) {
+        console.error(`[triple-writer] Wrote ${written}/${candidates.length} triples`);
+    }
+    return written;
+}
+// --- Public API ---
+/**
+ * Generate and write triples for a newly created learning.
+ * Fire-and-forget — call with .catch(() => {}).
+ */
+export function writeTriplesForLearning(params) {
+    const triples = extractLearningTriples(params);
+    return writeTriples(triples);
+}
+/**
+ * Generate and write triples for a newly created decision.
+ * Fire-and-forget — call with .catch(() => {}).
+ */
+export function writeTriplesForDecision(params) {
+    const triples = extractDecisionTriples(params);
+    return writeTriples(triples);
+}
+/**
+ * Extract triples from a newly created thread.
+ * Pure function — no side effects.
+ */
+export function extractThreadCreationTriples(params) {
+    const triples = [];
+    const threadLabel = buildSubjectLabel("thread", params.text);
+    const base = {
+        source_type: "thread",
+        source_id: params.thread_id,
+        source_linear_issue: params.linear_issue,
+        project: params.project,
+        half_life_days: HALF_LIFE_PROCESS,
+        created_by: params.agent,
+    };
+    // RULE 1: session_id -> "created_thread" (Session created this thread)
+    if (params.session_id) {
+        triples.push({
+            ...base,
+            subject: `Session: ${params.session_id}`,
+            predicate: "created_thread",
+            object: threadLabel,
+        });
+    }
+    // RULE 2: linear_issue -> "relates_to_thread" (Thread relates to issue)
+    if (params.linear_issue) {
+        triples.push({
+            ...base,
+            subject: threadLabel,
+            predicate: "relates_to_thread",
+            object: `Issue: ${params.linear_issue}`,
+        });
+    }
+    return triples;
+}
+/**
+ * Extract triples from a resolved thread.
+ * Pure function — no side effects.
+ */
+export function extractThreadResolutionTriples(params) {
+    const triples = [];
+    const threadLabel = buildSubjectLabel("thread", params.text);
+    const base = {
+        source_type: "thread",
+        source_id: params.thread_id,
+        project: params.project,
+        half_life_days: HALF_LIFE_PROCESS,
+        created_by: params.agent,
+    };
+    // RULE 1: session_id -> "resolves_thread" (Session resolved this thread)
+    if (params.session_id) {
+        triples.push({
+            ...base,
+            subject: `Session: ${params.session_id}`,
+            predicate: "resolves_thread",
+            object: threadLabel,
+        });
+    }
+    return triples;
+}
+/**
+ * Generate and write triples for a newly created thread.
+ * Fire-and-forget — call with .catch(() => {}).
+ */
+export function writeTriplesForThreadCreation(params) {
+    const triples = extractThreadCreationTriples(params);
+    return writeTriples(triples);
+}
+/**
+ * Generate and write triples for a resolved thread.
+ * Fire-and-forget — call with .catch(() => {}).
+ */
+export function writeTriplesForThreadResolution(params) {
+    const triples = extractThreadResolutionTriples(params);
+    return writeTriples(triples);
+}
+//# sourceMappingURL=triple-writer.js.map

package/dist/services/triple-writer.js.map

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

package/dist/services/variant-assignment.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Scar Variant Assignment Service
+ * OD-525: Integrates variant assignment into enforcement engine
+ * OD-547: Switched from issue-keyed to agent-keyed assignment
+ *
+ * Handles:
+ * - Random variant assignment for scars with variants
+ * - Idempotent assignment (same agent+scar always gets same variant)
+ * - Legacy scar fallback (scars without variants use original description)
+ * - Blind testing (agent doesn't know which variant they received)
+ */
+/**
+ * Variant record from database
+ */
+export interface ScarVariant {
+    id: string;
+    variant_name: string;
+    variant_version: string;
+    description: string;
+    enforcement_config: {
+        type: "imperative" | "declarative";
+        show_counter_arguments?: boolean;
+        steps?: string[];
+        success_state?: string;
+        verification_tests?: string[];
+        constraints?: string[];
+    };
+    active: boolean;
+}
+/**
+ * Assignment record
+ * OD-547: Primary key is (agent_id, scar_id), issue_id/session_id are metadata
+ */
+export interface VariantAssignment {
+    id: string;
+    agent_id: string;
+    scar_id: string;
+    variant_id: string;
+    assigned_at: string;
+    issue_id?: string;
+    session_id?: string;
+}
+/**
+ * Result of variant retrieval for a scar
+ */
+export interface ScarWithVariant {
+    scar_id: string;
+    has_variants: boolean;
+    variant?: ScarVariant;
+    assignment?: VariantAssignment;
+}
+/**
+ * Get active variants for a scar
+ */
+export declare function getActiveVariants(scarId: string): Promise<ScarVariant[]>;
+/**
+ * Get existing assignment for an agent + scar pair
+ * OD-547: Changed from issue-keyed to agent-keyed lookup
+ */
+export declare function getExistingAssignment(agentId: string, scarId: string): Promise<VariantAssignment | null>;
+/**
+ * Create random variant assignment
+ * OD-547: Agent-keyed with optional issue/session metadata
+ */
+export declare function createVariantAssignment(agentId: string, scarId: string, variants: ScarVariant[], metadata?: {
+    issueId?: string;
+    sessionId?: string;
+}): Promise<VariantAssignment | null>;
+/**
+ * Get or create variant assignment for a scar
+ * This is the main entry point for enforcement integration
+ *
+ * OD-547: Changed from issue-keyed to agent-keyed assignment.
+ * Agent identity is always available, so variants are always assigned.
+ *
+ * @param agentId - Agent identity (e.g., 'CLI', 'DAC', 'CODA-1')
+ * @param scarId - UUID of the scar
+ * @param metadata - Optional issue_id and session_id for triple traversals
+ * @returns Scar with variant info, or has_variants=false for legacy scars
+ */
+export declare function getOrAssignVariant(agentId: string, scarId: string, metadata?: {
+    issueId?: string;
+    sessionId?: string;
+}): Promise<ScarWithVariant>;
+/**
+ * Format enforcement text based on variant type
+ * Returns formatted description with variant-specific structure
+ *
+ * This is BLIND - agent never sees variant name or type indicator
+ */
+export declare function formatVariantEnforcement(variant: ScarVariant, scarTitle: string): string;
+//# sourceMappingURL=variant-assignment.d.ts.map

package/dist/services/variant-assignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant-assignment.d.ts","sourceRoot":"","sources":["../../src/services/variant-assignment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE;QAClB,IAAI,EAAE,YAAY,GAAG,aAAa,CAAC;QACnC,sBAAsB,CAAC,EAAE,OAAO,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;IACF,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAuB9E;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAwBnC;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAkCnC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC,eAAe,CAAC,CA4C1B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAmDxF"}

package/dist/services/variant-assignment.js

@@ -0,0 +1,196 @@
+/**
+ * Scar Variant Assignment Service
+ * OD-525: Integrates variant assignment into enforcement engine
+ * OD-547: Switched from issue-keyed to agent-keyed assignment
+ *
+ * Handles:
+ * - Random variant assignment for scars with variants
+ * - Idempotent assignment (same agent+scar always gets same variant)
+ * - Legacy scar fallback (scars without variants use original description)
+ * - Blind testing (agent doesn't know which variant they received)
+ */
+import * as supabase from "./supabase-client.js";
+/**
+ * Get active variants for a scar
+ */
+export async function getActiveVariants(scarId) {
+    if (!supabase.isConfigured()) {
+        return [];
+    }
+    try {
+        // Use directQuery to bypass ww-mcp and query Supabase REST API directly
+        const variants = await supabase.directQuery("scar_enforcement_variants", {
+            select: "*",
+            filters: {
+                scar_id: scarId,
+                active: "true",
+            },
+        });
+        return variants;
+    }
+    catch (error) {
+        console.error(`[variant-assignment] Exception fetching variants:`, error);
+        return [];
+    }
+}
+/**
+ * Get existing assignment for an agent + scar pair
+ * OD-547: Changed from issue-keyed to agent-keyed lookup
+ */
+export async function getExistingAssignment(agentId, scarId) {
+    if (!supabase.isConfigured()) {
+        return null;
+    }
+    try {
+        const assignments = await supabase.directQuery("variant_assignments", {
+            select: "*",
+            filters: {
+                agent_id: agentId,
+            },
+            limit: 10,
+        });
+        // Filter by scar_id locally
+        const match = assignments.find(a => a.scar_id === scarId);
+        return match || null;
+    }
+    catch (error) {
+        console.error(`[variant-assignment] Exception fetching assignment:`, error);
+        return null;
+    }
+}
+/**
+ * Create random variant assignment
+ * OD-547: Agent-keyed with optional issue/session metadata
+ */
+export async function createVariantAssignment(agentId, scarId, variants, metadata) {
+    if (!supabase.isConfigured() || variants.length === 0) {
+        return null;
+    }
+    try {
+        // Random selection from active variants
+        const randomIndex = Math.floor(Math.random() * variants.length);
+        const selectedVariant = variants[randomIndex];
+        const result = await supabase.directUpsert("variant_assignments", {
+            agent_id: agentId,
+            scar_id: scarId,
+            variant_id: selectedVariant.id,
+            issue_id: metadata?.issueId || null,
+            session_id: metadata?.sessionId || null,
+        });
+        return result;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        // Handle race condition: unique constraint violation
+        if (errorMessage.includes("23505") || errorMessage.includes("duplicate key")) {
+            console.error(`[variant-assignment] Assignment already exists (race condition), fetching...`);
+            return await getExistingAssignment(agentId, scarId);
+        }
+        console.error(`[variant-assignment] Exception creating assignment:`, error);
+        return null;
+    }
+}
+/**
+ * Get or create variant assignment for a scar
+ * This is the main entry point for enforcement integration
+ *
+ * OD-547: Changed from issue-keyed to agent-keyed assignment.
+ * Agent identity is always available, so variants are always assigned.
+ *
+ * @param agentId - Agent identity (e.g., 'CLI', 'DAC', 'CODA-1')
+ * @param scarId - UUID of the scar
+ * @param metadata - Optional issue_id and session_id for triple traversals
+ * @returns Scar with variant info, or has_variants=false for legacy scars
+ */
+export async function getOrAssignVariant(agentId, scarId, metadata) {
+    // Step 1: Check for active variants
+    const variants = await getActiveVariants(scarId);
+    if (variants.length === 0) {
+        // Legacy scar - no variants available
+        return {
+            scar_id: scarId,
+            has_variants: false,
+        };
+    }
+    // Step 2: Check for existing assignment (idempotent per agent+scar)
+    let assignment = await getExistingAssignment(agentId, scarId);
+    // Step 3: Create assignment if it doesn't exist
+    if (!assignment) {
+        assignment = await createVariantAssignment(agentId, scarId, variants, metadata);
+        if (!assignment) {
+            // Assignment failed, fall back to legacy mode
+            return {
+                scar_id: scarId,
+                has_variants: false,
+            };
+        }
+    }
+    // Step 4: Find the assigned variant
+    const variant = variants.find((v) => v.id === assignment.variant_id);
+    if (!variant) {
+        console.error(`[variant-assignment] Variant ${assignment.variant_id} not found in active variants`);
+        return {
+            scar_id: scarId,
+            has_variants: false,
+        };
+    }
+    return {
+        scar_id: scarId,
+        has_variants: true,
+        variant,
+        assignment,
+    };
+}
+/**
+ * Format enforcement text based on variant type
+ * Returns formatted description with variant-specific structure
+ *
+ * This is BLIND - agent never sees variant name or type indicator
+ */
+export function formatVariantEnforcement(variant, scarTitle) {
+    const config = variant.enforcement_config;
+    if (config.type === "imperative") {
+        // Traditional format: imperative steps
+        const lines = [];
+        if (config.steps && config.steps.length > 0) {
+            for (const step of config.steps) {
+                lines.push(step);
+            }
+        }
+        else {
+            // Fallback to description if no steps
+            lines.push(variant.description);
+        }
+        return lines.join("\n\n");
+    }
+    else if (config.type === "declarative") {
+        // Karpathy format: success state + verification tests + constraints
+        const lines = [];
+        if (config.success_state) {
+            lines.push("## Success State");
+            lines.push("");
+            lines.push(config.success_state);
+            lines.push("");
+        }
+        if (config.verification_tests && config.verification_tests.length > 0) {
+            lines.push("## Verification Tests");
+            lines.push("");
+            for (const test of config.verification_tests) {
+                lines.push(`- ${test}`);
+            }
+            lines.push("");
+        }
+        if (config.constraints && config.constraints.length > 0) {
+            lines.push("## Constraints");
+            lines.push("");
+            for (const constraint of config.constraints) {
+                lines.push(`- ${constraint}`);
+            }
+            lines.push("");
+        }
+        return lines.join("\n");
+    }
+    // Fallback
+    return variant.description;
+}
+//# sourceMappingURL=variant-assignment.js.map

package/dist/services/variant-assignment.js.map

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

package/dist/tools/absorb-observations.d.ts

@@ -0,0 +1,16 @@
+/**
+ * absorb_observations Tool (GitMem v2 Phase 2)
+ *
+ * Captures observations from sub-agents and teammates.
+ * The lead agent parses findings from sub-agent responses,
+ * then calls this tool to persist and analyze them.
+ *
+ * Identifies scar candidates via explicit severity or pattern matching.
+ * Observations are stored in-memory (session state) and optionally
+ * persisted to Supabase as a fire-and-forget upsert.
+ *
+ * Performance target: <500ms (in-memory + optional upsert)
+ */
+import type { AbsorbObservationsParams, AbsorbObservationsResult } from "../types/index.js";
+export declare function absorbObservations(params: AbsorbObservationsParams): Promise<AbsorbObservationsResult>;
+//# sourceMappingURL=absorb-observations.d.ts.map

package/dist/tools/absorb-observations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"absorb-observations.d.ts","sourceRoot":"","sources":["../../src/tools/absorb-observations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAWH,OAAO,KAAK,EAAE,wBAAwB,EAAE,wBAAwB,EAAe,MAAM,mBAAmB,CAAC;AA2BzG,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,OAAO,CAAC,wBAAwB,CAAC,CA+CnC"}