@balpal4495/quorum 3.0.4 → 3.1.1

package/dist/compass/create.js

@@ -0,0 +1,289 @@
+import { defaultSources } from "./sources/index.js";
+import { collectBearings, collectTerrain, formatBearingsForPrompt, formatTerrainForPrompt } from "./evidence/collect.js";
+import { mapBehaviorsFromFindings } from "./behavior.js";
+import { computeScore, scoreToRecommendation } from "./score.js";
+import { stageProposal, stageOutcome } from "./propose.js";
+import { COMPASS_SYSTEM_PROMPT } from "./prompts/system.js";
+import { buildBriefPrompt, buildPathwaysPrompt, buildBetsPrompt, buildScorePrompt, } from "./prompts/index.js";
+import { CompassBriefLLMSchema, PathwaysLLMSchema, BetsLLMSchema, ProductIdeaScoreSchema, } from "./schemas.js";
+function parseLLMJson(raw) {
+    const cleaned = raw.replace(/^```(?:json)?\s*/m, "").replace(/\s*```$/m, "").trim();
+    return JSON.parse(cleaned);
+}
+async function callLLM(llm, userPrompt, model) {
+    if (!llm)
+        throw new Error("Compass: LLM provider is required for this command. Set ANTHROPIC_API_KEY, OPENAI_API_KEY, or pass llm to setup().");
+    return llm([
+        { role: "system", content: COMPASS_SYSTEM_PROMPT },
+        { role: "user", content: userPrompt },
+    ], model);
+}
+export function createCompass(options) {
+    const { oracle, llm, rootDir = process.cwd(), chronicleDir = ".chronicle", sources = defaultSources(), models = {}, minimumEvidence = "balanced", } = options;
+    // ── Shared context helpers ─────────────────────────────────────────────────
+    async function getContext(area) {
+        const [bearings, terrain] = await Promise.all([
+            collectBearings(oracle, area),
+            collectTerrain(sources, rootDir, area),
+        ]);
+        const chronicleContext = formatBearingsForPrompt(bearings);
+        const behaviorContext = formatTerrainForPrompt(terrain.findings);
+        const behaviorMap = mapBehaviorsFromFindings(terrain.findings, { area });
+        return { bearings, terrain, chronicleContext, behaviorContext, behaviorMap };
+    }
+    // ── brief ──────────────────────────────────────────────────────────────────
+    async function brief(input) {
+        const { chronicleContext, behaviorContext, terrain, behaviorMap } = await getContext(input?.area);
+        if (!llm) {
+            // Deterministic fallback
+            return {
+                generated_at: new Date().toISOString(),
+                area: input?.area,
+                product_direction: "Unable to synthesize direction — no LLM configured. See Chronicle and behaviour map for raw evidence.",
+                known_from_chronicle: [],
+                known_from_behavior: behaviorMap.behaviors.slice(0, 5).map(b => b.current_behavior),
+                inferred: [],
+                assumptions: [],
+                unknowns: ["LLM not configured — full synthesis unavailable."],
+                opportunities: [],
+                missing_evidence: ["LLM provider required for synthesis"],
+                recommended_next_step: "Run: quorum advisor brief",
+                confidence: 0.4,
+            };
+        }
+        const raw = await callLLM(llm, buildBriefPrompt({ chronicleContext, behaviorContext, area: input?.area }), models.brief);
+        let parsed;
+        try {
+            parsed = parseLLMJson(raw);
+        }
+        catch {
+            throw new Error(`Compass brief: LLM returned non-JSON. Raw (first 300): ${raw.slice(0, 300)}`);
+        }
+        const result = CompassBriefLLMSchema.safeParse(parsed);
+        if (!result.success)
+            throw new Error(`Compass brief: LLM output failed validation: ${JSON.stringify(result.error.issues)}`);
+        const d = result.data;
+        // Build opportunity items from behavior map gaps
+        const opportunities = behaviorMap.gaps.slice(0, 3).map((g, i) => ({
+            id: `opp-gap-${i}`,
+            title: g.gap,
+            area: g.area,
+            why_it_matters: g.why_it_matters,
+            evidence_strength: "inferred",
+            suggested_next_step: "Run: quorum compass map",
+            evidence: g.evidence,
+            confidence: g.confidence,
+        }));
+        return {
+            generated_at: new Date().toISOString(),
+            area: input?.area,
+            ...d,
+            opportunities,
+        };
+    }
+    // ── mapBehaviors ────────────────────────────────────────────────────────────
+    async function mapBehaviors(input) {
+        const terrain = await collectTerrain(sources, rootDir, input?.area);
+        return mapBehaviorsFromFindings(terrain.findings, input);
+    }
+    // ── behavior (single question) ──────────────────────────────────────────────
+    async function behavior(input) {
+        const terrain = await collectTerrain(sources, rootDir, input.area);
+        const map = mapBehaviorsFromFindings(terrain.findings, { area: input.area });
+        const relevant = terrain.findings.filter(f => f.summary.toLowerCase().includes(input.question.toLowerCase().split(" ").slice(0, 3).join(" ")) ||
+            f.tags.some(t => input.question.toLowerCase().includes(t))).slice(0, 10);
+        if (!llm || input.deterministic) {
+            // Deterministic answer from behaviour map
+            const what_exists = map.behaviors.slice(0, 6).map(b => b.current_behavior);
+            const what_missing = map.gaps.slice(0, 4).map(g => g.gap);
+            return {
+                question: input.question,
+                what_exists,
+                what_appears_missing: what_missing,
+                product_implication: map.gaps.length > 0
+                    ? `The area has ${map.behaviors.length} documented behaviours but ${map.gaps.length} notable gaps.`
+                    : `The area appears well-covered with ${map.behaviors.length} documented behaviours.`,
+                evidence: relevant.map(f => ({ id: f.id, kind: f.kind, source: f.source, path: f.path, summary: f.summary, confidence: f.confidence })),
+                confidence: map.confidence,
+            };
+        }
+        // LLM-backed synthesis
+        const contextLines = [
+            "## Behaviours found",
+            ...map.behaviors.slice(0, 10).map(b => `  ✓ ${b.current_behavior}`),
+            "## Gaps found",
+            ...map.gaps.slice(0, 5).map(g => `  ? ${g.gap}`),
+        ].join("\n");
+        const prompt = `Answer this product-behaviour question by combining repo evidence with known behaviours.
+
+Question: ${input.question}
+
+${contextLines}
+
+Return JSON:
+{
+  "question": "${input.question}",
+  "what_exists": ["<existing behaviour>"],
+  "what_appears_missing": ["<missing capability>"],
+  "product_implication": "<one sentence product implication>",
+  "evidence": [{ "id": "<id>", "kind": "<kind>", "source": "<source>", "summary": "<summary>", "confidence": <0–1> }],
+  "confidence": <0–1>
+}`;
+        const raw = await callLLM(llm, prompt, models.brief);
+        try {
+            const parsed = parseLLMJson(raw);
+            return { ...parsed, question: input.question };
+        }
+        catch {
+            // Fall back to deterministic
+            return behavior({ ...input, deterministic: true });
+        }
+    }
+    // ── opportunities ───────────────────────────────────────────────────────────
+    async function opportunities(input) {
+        const terrain = await collectTerrain(sources, rootDir, input?.area);
+        const map = mapBehaviorsFromFindings(terrain.findings, { area: input?.area });
+        const opps = map.gaps.map((g, i) => ({
+            id: `opp-${i}`,
+            title: g.gap,
+            area: g.area,
+            why_it_matters: g.why_it_matters,
+            evidence_strength: g.confidence >= 0.7 ? "strong"
+                : g.confidence >= 0.5 ? "medium"
+                    : "inferred",
+            suggested_next_step: `quorum compass pathways --goal "${g.gap.slice(0, 50)}"`,
+            evidence: g.evidence,
+            confidence: g.confidence,
+        }));
+        const limited = input?.limit ? opps.slice(0, input.limit) : opps;
+        return input?.goal
+            ? limited.filter(o => o.title.toLowerCase().includes(input.goal.toLowerCase()) || o.area.toLowerCase().includes(input.goal.toLowerCase()))
+            : limited;
+    }
+    // ── pathways ────────────────────────────────────────────────────────────────
+    async function pathways(input) {
+        const { chronicleContext, behaviorContext } = await getContext(input.area);
+        const raw = await callLLM(llm, buildPathwaysPrompt({ ...input, chronicleContext, behaviorContext, limit: input.limit ?? 5 }), models.pathways);
+        let parsed;
+        try {
+            parsed = parseLLMJson(raw);
+        }
+        catch {
+            throw new Error(`Compass pathways: LLM returned non-JSON. Raw (first 300): ${raw.slice(0, 300)}`);
+        }
+        const result = PathwaysLLMSchema.safeParse(parsed);
+        if (!result.success)
+            throw new Error(`Compass pathways: LLM output failed validation: ${JSON.stringify(result.error.issues)}`);
+        // Recompute scores deterministically
+        return result.data.pathways.map(p => ({
+            ...p,
+            scores: computeScore(p.scores),
+        }));
+    }
+    // ── bigBets ─────────────────────────────────────────────────────────────────
+    async function bigBets(input) {
+        const { chronicleContext, behaviorContext } = await getContext();
+        const raw = await callLLM(llm, buildBetsPrompt({ ...input, chronicleContext, behaviorContext }), models.bets);
+        let parsed;
+        try {
+            parsed = parseLLMJson(raw);
+        }
+        catch {
+            throw new Error(`Compass bets: LLM returned non-JSON. Raw (first 300): ${raw.slice(0, 300)}`);
+        }
+        const result = BetsLLMSchema.safeParse(parsed);
+        if (!result.success)
+            throw new Error(`Compass bets: LLM output failed validation: ${JSON.stringify(result.error.issues)}`);
+        return result.data.bets.map(b => ({
+            ...b,
+            scores: computeScore(b.scores),
+        }));
+    }
+    // ── scoreIdea ───────────────────────────────────────────────────────────────
+    async function scoreIdea(input) {
+        const { chronicleContext, behaviorContext } = await getContext();
+        const raw = await callLLM(llm, buildScorePrompt({ ...input, chronicleContext, behaviorContext }), models.score);
+        let parsed;
+        try {
+            parsed = parseLLMJson(raw);
+        }
+        catch {
+            throw new Error(`Compass score: LLM returned non-JSON. Raw (first 300): ${raw.slice(0, 300)}`);
+        }
+        const result = ProductIdeaScoreSchema.safeParse(parsed);
+        if (!result.success)
+            throw new Error(`Compass score: LLM output failed validation: ${JSON.stringify(result.error.issues)}`);
+        const d = result.data;
+        return {
+            ...d,
+            scores: computeScore(d.scores),
+            recommendation: scoreToRecommendation(d.scores.total),
+        };
+    }
+    // ── productBrief ─────────────────────────────────────────────────────────────
+    async function productBrief(input) {
+        const { chronicleContext, behaviorContext, terrain } = await getContext();
+        const prompt = `Generate a product brief for implementation planning.
+
+Title: ${input.title}
+${input.idea ? `Idea: ${input.idea}` : ""}
+${input.context ? `Context: ${input.context}` : ""}
+
+## Chronicle evidence
+${chronicleContext}
+
+## Current behaviour
+${behaviorContext}
+
+Return JSON:
+{
+  "title": "${input.title}",
+  "problem": "<problem being solved>",
+  "target_user": "<who>",
+  "current_behavior": ["<relevant current behaviour>"],
+  "product_opportunity": "<gap or need>",
+  "recommended_solution": "<recommended approach>",
+  "smallest_useful_version": "<minimum useful version>",
+  "non_goals": ["<explicit non-goal>"],
+  "user_flow": ["<step in user flow>"],
+  "implementation_notes": ["<implementation note>"],
+  "dependencies": ["<dependency>"],
+  "risks": ["<risk>"],
+  "open_questions": ["<open question>"],
+  "assumptions": ["<assumption>"],
+  "validation_signals": ["<signal>"],
+  "invalidation_signals": ["<signal>"],
+  "evidence": [{ "id": "<id>", "kind": "<kind>", "source": "<source>", "summary": "<summary>", "confidence": <0–1> }],
+  "suggested_quorum_checks": ["<quorum check command>"]
+}`;
+        const raw = await callLLM(llm, prompt, models.brief);
+        try {
+            const parsed = parseLLMJson(raw);
+            return parsed;
+        }
+        catch {
+            throw new Error(`Compass productBrief: LLM returned non-JSON. Raw (first 300): ${raw.slice(0, 300)}`);
+        }
+    }
+    // ── propose ──────────────────────────────────────────────────────────────────
+    async function propose(input) {
+        return stageProposal(input, oracle);
+    }
+    // ── outcome ──────────────────────────────────────────────────────────────────
+    async function outcome(input) {
+        return stageOutcome(input, oracle);
+    }
+    return {
+        brief,
+        mapBehaviors,
+        behavior,
+        opportunities,
+        pathways,
+        bigBets,
+        scoreIdea,
+        productBrief,
+        propose,
+        outcome,
+    };
+}
+//# sourceMappingURL=create.js.map

package/dist/compass/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../modules/compass/create.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACxH,OAAO,EAAE,wBAAwB,EAAwB,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAgB,MAAM,YAAY,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EACL,gBAAgB,EAAE,mBAAmB,EACrC,eAAe,EAAE,gBAAgB,GAClC,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,qBAAqB,EAAE,iBAAiB,EACxC,aAAa,EAAE,sBAAsB,GACtC,MAAM,cAAc,CAAA;AAErB,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACnF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;AAC5B,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,GAA4B,EAC5B,UAAkB,EAClB,KAAc;IAEd,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,oHAAoH,CAAC,CAAA;IAC/I,OAAO,GAAG,CACR;QACE,EAAE,IAAI,EAAE,QAAiB,EAAE,OAAO,EAAE,qBAAqB,EAAE;QAC3D,EAAE,IAAI,EAAE,MAAe,EAAE,OAAO,EAAE,UAAU,EAAE;KAC/C,EACD,KAAK,CACN,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA6B;IACzD,MAAM,EACJ,MAAM,EACN,GAAG,EACH,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,EACvB,YAAY,GAAG,YAAY,EAC3B,OAAO,GAAG,cAAc,EAAE,EAC1B,MAAM,GAAG,EAAE,EACX,eAAe,GAAG,UAAU,GAC7B,GAAG,OAAO,CAAA;IAEX,8EAA8E;IAE9E,KAAK,UAAU,UAAU,CAAC,IAAa;QACrC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5C,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC;YAC7B,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;SACvC,CAAC,CAAA;QACF,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAA;QAC1D,MAAM,eAAe,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAChE,MAAM,WAAW,GAAG,wBAAwB,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QACxE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,CAAA;IAC9E,CAAC;IAED,8EAA8E;IAE9E,KAAK,UAAU,KAAK,CAAC,KAAyB;QAC5C,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAEjG,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,yBAAyB;YACzB,OAAO;gBACL,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACtC,IAAI,EAAE,KAAK,EAAE,IAAI;gBACjB,iBAAiB,EAAE,uGAAuG;gBAC1H,oBAAoB,EAAE,EAAE;gBACxB,mBAAmB,EAAE,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC;gBACnF,QAAQ,EAAE,EAAE;gBACZ,WAAW,EAAE,EAAE;gBACf,QAAQ,EAAE,CAAC,kDAAkD,CAAC;gBAC9D,aAAa,EAAE,EAAE;gBACjB,gBAAgB,EAAE,CAAC,qCAAqC,CAAC;gBACzD,qBAAqB,EAAE,2BAA2B;gBAClD,UAAU,EAAE,GAAG;aAChB,CAAA;QACH,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,gBAAgB,CAAC,EAAE,gBAAgB,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACxH,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YAAC,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,0DAA0D,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QAChG,CAAC;QAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACtD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAE3H,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAA;QACrB,iDAAiD;QACjD,MAAM,aAAa,GAAyB,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACtF,EAAE,EAAE,WAAW,CAAC,EAAE;YAClB,KAAK,EAAE,CAAC,CAAC,GAAG;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,iBAAiB,EAAE,UAAmB;YACtC,mBAAmB,EAAE,yBAAyB;YAC9C,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CAAC,CAAA;QAEH,OAAO;YACL,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,IAAI,EAAE,KAAK,EAAE,IAAI;YACjB,GAAG,CAAC;YACJ,aAAa;SACd,CAAA;IACH,CAAC;IAED,+EAA+E;IAE/E,KAAK,UAAU,YAAY,CAAC,KAAwB;QAClD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;QACnE,OAAO,wBAAwB,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC1D,CAAC;IAED,+EAA+E;IAE/E,KAAK,UAAU,QAAQ,CAAC,KAA4B;QAClD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QAClE,MAAM,GAAG,GAAG,wBAAwB,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;QAE5E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAC3C,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/F,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAC3D,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;QAEd,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YAChC,0CAA0C;YAC1C,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAA;YAC1E,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YACzD,OAAO;gBACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,WAAW;gBACX,oBAAoB,EAAE,YAAY;gBAClC,mBAAmB,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;oBACtC,CAAC,CAAC,gBAAgB,GAAG,CAAC,SAAS,CAAC,MAAM,8BAA8B,GAAG,CAAC,IAAI,CAAC,MAAM,gBAAgB;oBACnG,CAAC,CAAC,sCAAsC,GAAG,CAAC,SAAS,CAAC,MAAM,yBAAyB;gBACvF,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;gBACvI,UAAU,EAAE,GAAG,CAAC,UAAU;aAC3B,CAAA;QACH,CAAC;QAED,uBAAuB;QACvB,MAAM,YAAY,GAAG;YACnB,qBAAqB;YACrB,GAAG,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,CAAC;YACnE,eAAe;YACf,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC;SACjD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,MAAM,MAAM,GAAG;;YAEP,KAAK,CAAC,QAAQ;;EAExB,YAAY;;;;iBAIG,KAAK,CAAC,QAAQ;;;;;;EAM7B,CAAA;QAEE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAmB,CAAA;YAClD,OAAO,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAA;QAChD,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;YAC7B,OAAO,QAAQ,CAAC,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAA;QACpD,CAAC;IACH,CAAC;IAED,+EAA+E;IAE/E,KAAK,UAAU,aAAa,CAAC,KAA0B;QACrD,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;QACnE,MAAM,GAAG,GAAG,wBAAwB,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAE7E,MAAM,IAAI,GAAyB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACzD,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,KAAK,EAAE,CAAC,CAAC,GAAG;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,cAAc,EAAE,CAAC,CAAC,cAAc;YAChC,iBAAiB,EAAE,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,QAAiB;gBACxD,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,QAAiB;oBACzC,CAAC,CAAC,UAAmB;YACvB,mBAAmB,EAAE,mCAAmC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG;YAC7E,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CAAC,CAAA;QAEH,MAAM,OAAO,GAAG,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QAChE,OAAO,KAAK,EAAE,IAAI;YAChB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAK,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAC5I,CAAC,CAAC,OAAO,CAAA;IACb,CAAC;IAED,+EAA+E;IAE/E,KAAK,UAAU,QAAQ,CAAC,KAAoB;QAC1C,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC1E,MAAM,GAAG,GAAG,MAAM,OAAO,CACvB,GAAG,EACH,mBAAmB,CAAC,EAAE,GAAG,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,EAC7F,MAAM,CAAC,QAAQ,CAChB,CAAA;QAED,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YAAC,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,6DAA6D,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QACnG,CAAC;QACD,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAClD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAE9H,qCAAqC;QACrC,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACpC,GAAG,CAAC;YACJ,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;SAC/B,CAAC,CAAC,CAAA;IACL,CAAC;IAED,+EAA+E;IAE/E,KAAK,UAAU,OAAO,CAAC,KAAmB;QACxC,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,MAAM,UAAU,EAAE,CAAA;QAChE,MAAM,GAAG,GAAG,MAAM,OAAO,CACvB,GAAG,EACH,eAAe,CAAC,EAAE,GAAG,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC,EAChE,MAAM,CAAC,IAAI,CACZ,CAAA;QAED,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YAAC,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,yDAAyD,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QAC/F,CAAC;QACD,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAC9C,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAE1H,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAChC,GAAG,CAAC;YACJ,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;SAC/B,CAAC,CAAC,CAAA;IACL,CAAC;IAED,+EAA+E;IAE/E,KAAK,UAAU,SAAS,CAAC,KAAqB;QAC5C,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,MAAM,UAAU,EAAE,CAAA;QAChE,MAAM,GAAG,GAAG,MAAM,OAAO,CACvB,GAAG,EACH,gBAAgB,CAAC,EAAE,GAAG,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC,EACjE,MAAM,CAAC,KAAK,CACb,CAAA;QAED,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YAAC,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,0DAA0D,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QAChG,CAAC;QACD,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QACvD,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAE3H,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAA;QACrB,OAAO;YACL,GAAG,CAAC;YACJ,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;YAC9B,cAAc,EAAE,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SACtD,CAAA;IACH,CAAC;IAED,gFAAgF;IAEhF,KAAK,UAAU,YAAY,CAAC,KAAwB;QAClD,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,MAAM,UAAU,EAAE,CAAA;QAEzE,MAAM,MAAM,GAAG;;SAEV,KAAK,CAAC,KAAK;EAClB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;EACvC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;;;EAGhD,gBAAgB;;;EAGhB,eAAe;;;;cAIH,KAAK,CAAC,KAAK;;;;;;;;;;;;;;;;;;EAkBvB,CAAA;QAEE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;QACpD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAiB,CAAA;YAChD,OAAO,MAAM,CAAA;QACf,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,iEAAiE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QACvG,CAAC;IACH,CAAC;IAED,gFAAgF;IAEhF,KAAK,UAAU,OAAO,CAAC,KAA2B;QAChD,OAAO,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,gFAAgF;IAEhF,KAAK,UAAU,OAAO,CAAC,KAA0B;QAC/C,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;IAED,OAAO;QACL,KAAK;QACL,YAAY;QACZ,QAAQ;QACR,aAAa;QACb,QAAQ;QACR,OAAO;QACP,SAAS;QACT,YAAY;QACZ,OAAO;QACP,OAAO;KACR,CAAA;AACH,CAAC"}

package/dist/compass/evidence/collect.d.ts

@@ -0,0 +1,11 @@
+import type { OracleClient } from "../../shared/types.js";
+import type { CompassEvidenceRef, ProductBearing, ProductSource, ProductSourceFinding } from "../types.js";
+export declare function collectBearings(oracle: OracleClient, area?: string): Promise<ProductBearing[]>;
+export interface TerrainResult {
+    findings: ProductSourceFinding[];
+    evidenceRefs: CompassEvidenceRef[];
+}
+export declare function collectTerrain(sources: ProductSource[], rootDir: string, area?: string): Promise<TerrainResult>;
+export declare function formatBearingsForPrompt(bearings: ProductBearing[]): string;
+export declare function formatTerrainForPrompt(findings: ProductSourceFinding[], limit?: number): string;
+//# sourceMappingURL=collect.d.ts.map

package/dist/compass/evidence/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../../modules/compass/evidence/collect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,uBAAuB,CAAA;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAK1G,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,EAAE,CAAC,CAwC3B;AAID,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,oBAAoB,EAAE,CAAA;IAChC,YAAY,EAAE,kBAAkB,EAAE,CAAA;CACnC;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,aAAa,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,aAAa,CAAC,CAmBxB;AAID,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAK1E;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,KAAK,SAAK,GAAG,MAAM,CAgB3F"}

package/dist/compass/evidence/collect.js

@@ -0,0 +1,86 @@
+import { randomUUID } from "crypto";
+// ── Bearings from Chronicle ───────────────────────────────────────────────────
+export async function collectBearings(oracle, area) {
+    const queries = [
+        area ?? "product direction goals decisions",
+        "rejected approaches refuted alternatives",
+        "constraints scope out-of-scope",
+    ];
+    const seen = new Set();
+    const bearings = [];
+    for (const q of queries) {
+        let results;
+        try {
+            results = await oracle.query(q, { limit: 8 });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of results) {
+            if (seen.has(entry.id))
+                continue;
+            seen.add(entry.id);
+            const text = entry.decision ?? entry.key_insight;
+            bearings.push({
+                id: `bearing-${entry.id.slice(0, 8)}`,
+                title: entry.topic ?? text.slice(0, 60),
+                summary: text,
+                area: entry.scope?.[0],
+                evidence: [
+                    {
+                        id: randomUUID().slice(0, 8),
+                        kind: "chronicle",
+                        source: ".chronicle/committed",
+                        entry_id: entry.id,
+                        summary: text,
+                        confidence: entry.confidence,
+                    },
+                ],
+                confidence: entry.confidence,
+            });
+        }
+    }
+    return bearings;
+}
+export async function collectTerrain(sources, rootDir, area) {
+    const allFindings = [];
+    for (const source of sources) {
+        const found = await source.scan({ rootDir, area });
+        allFindings.push(...found);
+    }
+    const evidenceRefs = allFindings.map(f => ({
+        id: f.id,
+        kind: f.kind,
+        source: f.source,
+        path: f.path,
+        line: f.line,
+        summary: f.summary,
+        confidence: f.confidence,
+    }));
+    return { findings: allFindings, evidenceRefs };
+}
+// ── Format helpers for LLM prompts ───────────────────────────────────────────
+export function formatBearingsForPrompt(bearings) {
+    if (bearings.length === 0)
+        return "No Chronicle entries found.";
+    return bearings
+        .map(b => `[${b.id}] (confidence: ${b.confidence.toFixed(2)}) ${b.summary}`)
+        .join("\n");
+}
+export function formatTerrainForPrompt(findings, limit = 40) {
+    if (findings.length === 0)
+        return "No product behaviour found in sources.";
+    // Group by kind
+    const groups = {};
+    for (const f of findings.slice(0, limit)) {
+        groups[f.kind] = groups[f.kind] ?? [];
+        groups[f.kind].push(f);
+    }
+    return Object.entries(groups)
+        .map(([kind, items]) => {
+        const lines = items.slice(0, 10).map(i => `  - ${i.title}: ${i.summary.slice(0, 100)}`);
+        return `${kind.toUpperCase()}:\n${lines.join("\n")}`;
+    })
+        .join("\n\n");
+}
+//# sourceMappingURL=collect.js.map

package/dist/compass/evidence/collect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../../../modules/compass/evidence/collect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAEnC,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAoB,EACpB,IAAa;IAEb,MAAM,OAAO,GAAG;QACd,IAAI,IAAI,mCAAmC;QAC3C,0CAA0C;QAC1C,gCAAgC;KACjC,CAAA;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,QAAQ,GAAqB,EAAE,CAAA;IAErC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,OAAuB,CAAA;QAC3B,IAAI,CAAC;YAAC,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,SAAQ;QAAC,CAAC;QAExE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAAE,SAAQ;YAChC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAElB,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAW,CAAA;YAChD,QAAQ,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,WAAW,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBACrC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;gBACvC,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBACtB,QAAQ,EAAE;oBACR;wBACE,EAAE,EAAE,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;wBAC5B,IAAI,EAAE,WAAW;wBACjB,MAAM,EAAE,sBAAsB;wBAC9B,QAAQ,EAAE,KAAK,CAAC,EAAE;wBAClB,OAAO,EAAE,IAAI;wBACb,UAAU,EAAE,KAAK,CAAC,UAAU;qBAC7B;iBACF;gBACD,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAA;AACjB,CAAC;AASD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAwB,EACxB,OAAe,EACf,IAAa;IAEb,MAAM,WAAW,GAA2B,EAAE,CAAA;IAE9C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QAClD,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;IAC5B,CAAC;IAED,MAAM,YAAY,GAAyB,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/D,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,UAAU,EAAE,CAAC,CAAC,UAAU;KACzB,CAAC,CAAC,CAAA;IAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,CAAA;AAChD,CAAC;AAED,gFAAgF;AAEhF,MAAM,UAAU,uBAAuB,CAAC,QAA0B;IAChE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,6BAA6B,CAAA;IAC/D,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;SAC3E,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAgC,EAAE,KAAK,GAAG,EAAE;IACjF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,wCAAwC,CAAA;IAE1E,gBAAgB;IAChB,MAAM,MAAM,GAA2C,EAAE,CAAA;IACzD,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QACrC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;SAC1B,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QACrB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAA;QACvF,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;IACtD,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAA;AACjB,CAAC"}

package/dist/compass/index.d.ts

@@ -0,0 +1,8 @@
+export { createCompass } from "./create.js";
+export { defaultSources, docsSource, packageSource, cliSource, repoSource, testsSource, configSource } from "./sources/index.js";
+export { mapBehaviorsFromFindings, summarizeBehaviorMap } from "./behavior.js";
+export { computeScore, scoreToRecommendation, scoreToLabel, explainScore } from "./score.js";
+export { collectBearings, collectTerrain, formatBearingsForPrompt, formatTerrainForPrompt } from "./evidence/collect.js";
+export { stageProposal, stageOutcome } from "./propose.js";
+export * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/compass/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../modules/compass/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAChI,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5F,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACxH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC1D,cAAc,YAAY,CAAA"}

package/dist/compass/index.js

@@ -0,0 +1,8 @@
+export { createCompass } from "./create.js";
+export { defaultSources, docsSource, packageSource, cliSource, repoSource, testsSource, configSource } from "./sources/index.js";
+export { mapBehaviorsFromFindings, summarizeBehaviorMap } from "./behavior.js";
+export { computeScore, scoreToRecommendation, scoreToLabel, explainScore } from "./score.js";
+export { collectBearings, collectTerrain, formatBearingsForPrompt, formatTerrainForPrompt } from "./evidence/collect.js";
+export { stageProposal, stageOutcome } from "./propose.js";
+export * from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/compass/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../modules/compass/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAChI,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5F,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACxH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAC1D,cAAc,YAAY,CAAA"}

package/dist/compass/prompts/index.d.ts

@@ -0,0 +1,28 @@
+export declare function buildBriefPrompt(params: {
+    chronicleContext: string;
+    behaviorContext: string;
+    area?: string;
+}): string;
+export declare function buildPathwaysPrompt(params: {
+    goal: string;
+    horizon?: string;
+    appetite?: string;
+    chronicleContext: string;
+    behaviorContext: string;
+    area?: string;
+    limit?: number;
+}): string;
+export declare function buildBetsPrompt(params: {
+    horizon?: string;
+    goal?: string;
+    appetite?: string;
+    chronicleContext: string;
+    behaviorContext: string;
+}): string;
+export declare function buildScorePrompt(params: {
+    idea: string;
+    context?: string;
+    chronicleContext: string;
+    behaviorContext: string;
+}): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/compass/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../modules/compass/prompts/index.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,GAAG,MAAM,CA4BT;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,MAAM,CAiFT;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;CACxB,GAAG,MAAM,CAmDT;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,eAAe,EAAE,MAAM,CAAA;CACxB,GAAG,MAAM,CAwCT"}

package/{modules/compass/prompts/index.ts → dist/compass/prompts/index.js}

@@ -1,9 +1,5 @@
-export function buildBriefPrompt(params: {
-  chronicleContext: string
-  behaviorContext: string
-  area?: string
-}): string {
-  return `Produce a Compass Brief — a summary of current product direction.
+export function buildBriefPrompt(params) {
+    return `Produce a Compass Brief — a summary of current product direction.
 
 ${params.area ? `Focus area: ${params.area}\n` : ""}
 
@@ -29,19 +25,10 @@ Return ONLY valid JSON with this exact schema (no markdown fences, no explanatio
 Rules:
 - known_from_chronicle must cite specific decisions, not paraphrase
 - unknowns must include "No analytics or support evidence connected" if no user data provided
-- confidence reflects how strongly the direction can be stated from available evidence`
+- confidence reflects how strongly the direction can be stated from available evidence`;
 }
-
-export function buildPathwaysPrompt(params: {
-  goal: string
-  horizon?: string
-  appetite?: string
-  chronicleContext: string
-  behaviorContext: string
-  area?: string
-  limit?: number
-}): string {
-  return `Generate ${params.limit ?? 5} product pathways toward the following goal.
+export function buildPathwaysPrompt(params) {
+    return `Generate ${params.limit ?? 5} product pathways toward the following goal.
 
 Goal: ${params.goal}
 ${params.horizon ? `Horizon: ${params.horizon}` : ""}
@@ -120,17 +107,10 @@ Rules:
 - Clamp total to 0–100
 - Assumptions must always be present (minimum 1)
 - unknowns must note if no user evidence is connected
-- Sort by scores.total descending`
+- Sort by scores.total descending`;
 }
-
-export function buildBetsPrompt(params: {
-  horizon?: string
-  goal?: string
-  appetite?: string
-  chronicleContext: string
-  behaviorContext: string
-}): string {
-  return `Generate 2–3 strategic product bets.
+export function buildBetsPrompt(params) {
+    return `Generate 2–3 strategic product bets.
 
 ${params.horizon ? `Horizon: ${params.horizon}` : ""}
 ${params.goal ? `Goal: ${params.goal}` : ""}
@@ -179,16 +159,10 @@ Rules:
 - A bet is a falsifiable hypothesis, not a feature list
 - Kill criteria must be present
 - Invalidation signals must be present
-- If no user evidence is available, evidence_strength should be ≤ 0.4`
+- If no user evidence is available, evidence_strength should be ≤ 0.4`;
 }
-
-export function buildScorePrompt(params: {
-  idea: string
-  context?: string
-  chronicleContext: string
-  behaviorContext: string
-}): string {
-  return `Evaluate this product idea.
+export function buildScorePrompt(params) {
+    return `Evaluate this product idea.
 
 Idea: ${params.idea}
 ${params.context ? `Context: ${params.context}` : ""}
@@ -226,5 +200,6 @@ Penalise:
 - high infrastructure/hosting/auth burden
 - unclear user problem
 - long time-to-signal
-- low reversibility`
+- low reversibility`;
 }
+//# sourceMappingURL=index.js.map

package/dist/compass/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../modules/compass/prompts/index.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,MAIhC;IACC,OAAO;;EAEP,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE;;;EAGjD,MAAM,CAAC,gBAAgB;;;EAGvB,MAAM,CAAC,eAAe;;;;;;;;;;;;;;;;;;uFAkB+D,CAAA;AACvF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAQnC;IACC,OAAO,YAAY,MAAM,CAAC,KAAK,IAAI,CAAC;;QAE9B,MAAM,CAAC,IAAI;EACjB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;EAClD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;EACrD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;;;EAG/C,MAAM,CAAC,gBAAgB;;;EAGvB,MAAM,CAAC,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAoEU,CAAA;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAM/B;IACC,OAAO;;EAEP,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;EAClD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;EACzC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;;;EAGrD,MAAM,CAAC,gBAAgB;;;EAGvB,MAAM,CAAC,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sEAuC8C,CAAA;AACtE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAKhC;IACC,OAAO;;QAED,MAAM,CAAC,IAAI;EACjB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;;;EAGlD,MAAM,CAAC,gBAAgB;;;EAGvB,MAAM,CAAC,eAAe;;;;aAIX,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;oBAyBJ,CAAA;AACpB,CAAC"}

package/dist/compass/prompts/system.d.ts

@@ -0,0 +1,2 @@
+export declare const COMPASS_SYSTEM_PROMPT = "You are Quorum Compass, the product-direction module for an AI-assisted software team.\n\nYour job is to help decide where the product should go next.\n\nYou are not a generic brainstormer.\nYou must ground every recommendation in provided evidence.\n\nEvidence may come from:\n- Chronicle memory (human-approved past decisions)\n- current code behaviour\n- docs\n- tests\n- package metadata\n- CLI commands\n\nRules:\n1. Separate known facts from inferences and assumptions.\n2. Never claim user demand unless user evidence (analytics, support, issues) is provided.\n3. Prefer small, reversible next moves unless asked for big bets.\n4. Identify contradictions with Chronicle or current product behaviour.\n5. Include assumptions, invalidation signals, and open questions.\n6. Do not recommend implementation details beyond product-level guidance.\n7. Return only valid JSON matching the requested schema.\n8. When no analytics/support data is connected, always state: \"No direct user signal connected.\"";
+//# sourceMappingURL=system.d.ts.map

package/dist/compass/prompts/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../modules/compass/prompts/system.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,m/BAuB+D,CAAA"}

package/{modules/compass/prompts/system.ts → dist/compass/prompts/system.js}

@@ -21,4 +21,5 @@ Rules:
 5. Include assumptions, invalidation signals, and open questions.
 6. Do not recommend implementation details beyond product-level guidance.
 7. Return only valid JSON matching the requested schema.
-8. When no analytics/support data is connected, always state: "No direct user signal connected."`
+8. When no analytics/support data is connected, always state: "No direct user signal connected."`;
+//# sourceMappingURL=system.js.map

package/dist/compass/prompts/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../../modules/compass/prompts/system.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;iGAuB4D,CAAA"}

package/dist/compass/propose.d.ts

@@ -0,0 +1,15 @@
+import type { OracleClient } from "../shared/types.js";
+import type { CompassProposalInput, CompassProposalResult, CompassOutcomeInput, CompassOutcomeResultPayload } from "./types.js";
+/**
+ * Stage a Compass-generated artifact as a Chronicle proposal.
+ *
+ * Writes to .chronicle/proposals/ ONLY via oracle.propose().
+ * Never calls oracle.commit(). Human must approve.
+ */
+export declare function stageProposal(input: CompassProposalInput, oracle: OracleClient): Promise<CompassProposalResult>;
+/**
+ * Stage an outcome update for a prior product bet or pathway.
+ * Creates a new proposal that supersedes the original entry.
+ */
+export declare function stageOutcome(input: CompassOutcomeInput, oracle: OracleClient): Promise<CompassOutcomeResultPayload>;
+//# sourceMappingURL=propose.d.ts.map

package/dist/compass/propose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../modules/compass/propose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EACV,oBAAoB,EAAE,qBAAqB,EAC3C,mBAAmB,EAAE,2BAA2B,EAEjD,MAAM,YAAY,CAAA;AAEnB;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,qBAAqB,CAAC,CA6BhC;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,2BAA2B,CAAC,CAwCtC"}