@balpal4495/quorum 3.0.4 → 3.1.1

package/bin/commands/compass.js

@@ -270,18 +270,19 @@ function summarizeBehaviorMap(map) {
 
 function computeScore(dims) {
   const d = dims ?? {}
+  const n = (v) => { const f = parseFloat(v); return isNaN(f) ? 0 : f }
   const raw =
-    (d.strategic_fit         ?? 0) * 20 +
-    (d.user_problem_clarity  ?? 0) * 15 +
-    (d.evidence_strength     ?? 0) * 20 +
-    (d.leverage              ?? 0) * 10 +
-    (d.feasibility           ?? 0) * 15 +
-    (d.time_to_signal        ?? 0) * 10 +
-    (d.reversibility         ?? 0) * 10 -
-    (d.complexity_penalty    ?? 0) * 10 -
-    (d.dependency_penalty    ?? 0) *  8 -
-    (d.contradiction_penalty ?? 0) * 15 -
-    (d.evidence_gap_penalty  ?? 0) * 12
+    n(d.strategic_fit)         * 20 +
+    n(d.user_problem_clarity)  * 15 +
+    n(d.evidence_strength)     * 20 +
+    n(d.leverage)              * 10 +
+    n(d.feasibility)           * 15 +
+    n(d.time_to_signal)        * 10 +
+    n(d.reversibility)         * 10 -
+    n(d.complexity_penalty)    * 10 -
+    n(d.dependency_penalty)    *  8 -
+    n(d.contradiction_penalty) * 15 -
+    n(d.evidence_gap_penalty)  * 12
   return { ...d, total: Math.max(0, Math.min(100, Math.round(raw))) }
 }
 
@@ -393,7 +394,25 @@ Score total = strategic_fit*20 + user_problem_clarity*15 + evidence_strength*20
 
 function parseLLMJson(raw) {
   const cleaned = raw.replace(/^```(?:json)?\s*/m, "").replace(/\s*```$/m, "").trim()
-  return JSON.parse(cleaned)
+  try {
+    return JSON.parse(cleaned)
+  } catch (firstErr) {
+    // Salvage truncated responses: trim to last complete object boundary
+    const lastBrace = cleaned.lastIndexOf('},')
+    if (lastBrace !== -1) {
+      const salvaged = cleaned.slice(0, lastBrace + 1)
+      // Find the outermost container and close it
+      const openBracket = salvaged.indexOf('[')
+      const openBrace = salvaged.indexOf('{')
+      try {
+        if (openBracket !== -1 && (openBrace === -1 || openBracket < openBrace)) {
+          return JSON.parse(salvaged + ']}')
+        }
+        return JSON.parse(salvaged + '}')
+      } catch { /* fall through to original error */ }
+    }
+    throw firstErr
+  }
 }
 
 async function callLLM(llm, userPrompt) {

package/dist/advisor/ask.d.ts

@@ -0,0 +1,13 @@
+import type { AdvisorInput, AdvisorOutput, AdvisorDeps } from "./types.js";
+/**
+ * Ask the Advisor a plain-language question.
+ *
+ * Internally calls the LLM and validates the answer against a satisfaction
+ * threshold (confidence ≥ 0.7, no blockers). Retries up to MAX_RETRIES times
+ * with the previous answer included as context. Returns the best answer found
+ * within the retry budget regardless of whether the threshold was met.
+ *
+ * Throws if the LLM returns non-JSON or output that fails schema validation.
+ */
+export declare function ask(input: AdvisorInput, deps: AdvisorDeps): Promise<AdvisorOutput>;
+//# sourceMappingURL=ask.d.ts.map

package/dist/advisor/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../modules/advisor/ask.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAiB,WAAW,EAAE,MAAM,YAAY,CAAA;AA6DzF;;;;;;;;;GASG;AACH,wBAAsB,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAcxF"}

package/dist/advisor/ask.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { SYSTEM_PROMPT, buildUserPrompt } from "./prompt.js";
+const SATISFACTION_THRESHOLD = 0.7;
+const MAX_RETRIES = 2;
+const AdvisorAnswerSchema = z.object({
+    confidence: z.number().min(0).max(1),
+    what_we_know: z.string().min(1),
+    risks: z.array(z.string()),
+    blockers: z.array(z.string()),
+    recommendation: z.string().min(1),
+    next_step: z.string().min(1),
+});
+async function callLLM(input, deps, attempt, previous) {
+    const { llm, model } = deps;
+    let userPrompt = buildUserPrompt(input.question, input.evidence);
+    if (attempt > 0 && previous) {
+        userPrompt += [
+            "",
+            `## Previous Answer (attempt ${attempt} — did not meet quality threshold)`,
+            `Confidence: ${previous.confidence.toFixed(2)} (need ≥ ${SATISFACTION_THRESHOLD})`,
+            previous.blockers.length > 0
+                ? `Unresolved blockers: ${previous.blockers.join("; ")}`
+                : "",
+            "Please produce a more specific and concrete answer.",
+        ].filter(Boolean).join("\n");
+    }
+    const raw = await llm([
+        { role: "system", content: SYSTEM_PROMPT },
+        { role: "user", content: userPrompt },
+    ], model);
+    let parsed;
+    try {
+        const cleaned = raw.replace(/^```(?:json)?\s*/m, "").replace(/\s*```$/m, "").trim();
+        parsed = JSON.parse(cleaned);
+    }
+    catch {
+        throw new Error(`Advisor: LLM returned non-JSON. Raw (first 300 chars): ${raw.slice(0, 300)}`);
+    }
+    const result = AdvisorAnswerSchema.safeParse(parsed);
+    if (!result.success) {
+        throw new Error(`Advisor: LLM output failed validation. Issues: ${JSON.stringify(result.error.issues)}`);
+    }
+    return result.data;
+}
+/**
+ * Ask the Advisor a plain-language question.
+ *
+ * Internally calls the LLM and validates the answer against a satisfaction
+ * threshold (confidence ≥ 0.7, no blockers). Retries up to MAX_RETRIES times
+ * with the previous answer included as context. Returns the best answer found
+ * within the retry budget regardless of whether the threshold was met.
+ *
+ * Throws if the LLM returns non-JSON or output that fails schema validation.
+ */
+export async function ask(input, deps) {
+    let last = null;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        const answer = await callLLM(input, deps, attempt, last);
+        last = answer;
+        const satisfied = answer.confidence >= SATISFACTION_THRESHOLD && answer.blockers.length === 0;
+        if (satisfied || attempt === MAX_RETRIES) {
+            return { ...answer, question: input.question, retries: attempt };
+        }
+    }
+    return { ...last, question: input.question, retries: MAX_RETRIES };
+}
+//# sourceMappingURL=ask.js.map

package/dist/advisor/ask.js.map

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

package/dist/advisor/index.d.ts

@@ -0,0 +1,3 @@
+export { ask } from "./ask.js";
+export type { AdvisorInput, AdvisorOutput, AdvisorDeps } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../modules/advisor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/advisor/index.js

@@ -0,0 +1,2 @@
+export { ask } from "./ask.js";
+//# sourceMappingURL=index.js.map

package/dist/advisor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../modules/advisor/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA"}

package/dist/advisor/prompt.d.ts

@@ -0,0 +1,5 @@
+import type { OracleResult } from "../shared/types.js";
+export declare const SYSTEM_PROMPT = "You are the Quorum Advisor \u2014 the plain-language interface to a team's collective knowledge.\n\nYou receive a question from a developer or engineering manager, along with relevant Chronicle evidence.\nSynthesise that evidence into a clear, concise answer a human can act on.\n\nRules:\n- Write for a human who does not know what \"Chronicle entries\" or \"vector search\" mean.\n- Be direct. One clear recommendation, not a list of options unless genuinely necessary.\n- If Chronicle has relevant evidence, reference it plainly: \"the team already decided X\".\n- If Chronicle has no evidence, say so honestly \u2014 do not invent history.\n- Blockers are hard blockers only \u2014 things that MUST be resolved before moving forward.\n- risks are real concerns worth knowing, not theoretical edge cases.\n\nReturn ONLY valid JSON matching this schema (no markdown fences, no explanation):\n{\n  \"confidence\": <number 0\u20131 \u2014 how confident are you given the available evidence>,\n  \"what_we_know\": <string \u2014 what Chronicle knows about this topic. Plain English, 1\u20133 sentences.>,\n  \"risks\": [<string \u2014 each real risk, plain English, one per item. Empty array if none.>],\n  \"blockers\": [<string \u2014 hard blockers only. Empty array if none.>],\n  \"recommendation\": <string \u2014 one clear recommended action>,\n  \"next_step\": <string \u2014 the specific next thing to do, e.g. a quorum command or a decision>\n}";
+export declare function formatEvidence(evidence: OracleResult[]): string;
+export declare function buildUserPrompt(question: string, evidence: OracleResult[]): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/advisor/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../modules/advisor/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGtD,eAAO,MAAM,aAAa,i7CAqBxB,CAAA;AAEF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAa/D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAQlF"}

package/{modules/advisor/prompt.ts → dist/advisor/prompt.js}

@@ -1,6 +1,4 @@
-import type { OracleResult } from "../shared/types"
-import { entryText } from "../shared/types"
-
+import { entryText } from "../shared/types.js";
 export const SYSTEM_PROMPT = `You are the Quorum Advisor — the plain-language interface to a team's collective knowledge.
 
 You receive a question from a developer or engineering manager, along with relevant Chronicle evidence.
@@ -22,29 +20,27 @@ Return ONLY valid JSON matching this schema (no markdown fences, no explanation)
   "blockers": [<string — hard blockers only. Empty array if none.>],
   "recommendation": <string — one clear recommended action>,
   "next_step": <string — the specific next thing to do, e.g. a quorum command or a decision>
-}`
-
-export function formatEvidence(evidence: OracleResult[]): string {
-  if (evidence.length === 0) {
-    return "Chronicle has no prior entries on this topic."
-  }
-  return evidence
-    .map(e => {
-      const text = entryText(e)
-      const statusTag =
-        e.status === "refuted"   ? " [REJECTED]"  :
-        e.status === "validated" ? " [VALIDATED]" : ""
-      return `[${e.id.slice(0, 8)}]${statusTag} ${text}\n  Areas: ${e.affected_areas.join(", ")}`
+}`;
+export function formatEvidence(evidence) {
+    if (evidence.length === 0) {
+        return "Chronicle has no prior entries on this topic.";
+    }
+    return evidence
+        .map(e => {
+        const text = entryText(e);
+        const statusTag = e.status === "refuted" ? " [REJECTED]" :
+            e.status === "validated" ? " [VALIDATED]" : "";
+        return `[${e.id.slice(0, 8)}]${statusTag} ${text}\n  Areas: ${e.affected_areas.join(", ")}`;
     })
-    .join("\n\n")
+        .join("\n\n");
 }
-
-export function buildUserPrompt(question: string, evidence: OracleResult[]): string {
-  return [
-    "## Question",
-    question,
-    "",
-    "## Chronicle Evidence",
-    formatEvidence(evidence),
-  ].join("\n")
+export function buildUserPrompt(question, evidence) {
+    return [
+        "## Question",
+        question,
+        "",
+        "## Chronicle Evidence",
+        formatEvidence(evidence),
+    ].join("\n");
 }
+//# sourceMappingURL=prompt.js.map

package/dist/advisor/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../modules/advisor/prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAE9C,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;EAqB3B,CAAA;AAEF,MAAM,UAAU,cAAc,CAAC,QAAwB;IACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,+CAA+C,CAAA;IACxD,CAAC;IACD,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE;QACP,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAA;QACzB,MAAM,SAAS,GACb,CAAC,CAAC,MAAM,KAAK,SAAS,CAAG,CAAC,CAAC,aAAa,CAAE,CAAC;YAC3C,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAA;QAChD,OAAO,IAAI,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,SAAS,IAAI,IAAI,cAAc,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;IAC7F,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,QAAwB;IACxE,OAAO;QACL,aAAa;QACb,QAAQ;QACR,EAAE;QACF,uBAAuB;QACvB,cAAc,CAAC,QAAQ,CAAC;KACzB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/advisor/types.d.ts

@@ -0,0 +1,23 @@
+import type { OracleResult, LLMProvider } from "../shared/types.js";
+export interface AdvisorInput {
+    question: string;
+    evidence: OracleResult[];
+}
+export interface AdvisorAnswer {
+    confidence: number;
+    what_we_know: string;
+    risks: string[];
+    blockers: string[];
+    recommendation: string;
+    next_step: string;
+}
+export interface AdvisorOutput extends AdvisorAnswer {
+    question: string;
+    /** Number of retries taken before the answer met the satisfaction threshold. */
+    retries: number;
+}
+export interface AdvisorDeps {
+    llm: LLMProvider;
+    model?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/advisor/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../modules/advisor/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEnE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,YAAY,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,QAAQ,EAAE,MAAM,CAAA;IAChB,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,WAAW,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/advisor/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/advisor/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../modules/advisor/types.ts"],"names":[],"mappings":""}

package/dist/compass/behavior.d.ts

@@ -0,0 +1,4 @@
+import type { BehaviorMap, BehaviorMapInput, ProductSourceFinding } from "./types.js";
+export declare function mapBehaviorsFromFindings(findings: ProductSourceFinding[], input?: BehaviorMapInput): BehaviorMap;
+export declare function summarizeBehaviorMap(map: BehaviorMap): string;
+//# sourceMappingURL=behavior.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"behavior.d.ts","sourceRoot":"","sources":["../../modules/compass/behavior.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACyD,WAAW,EAC9E,gBAAgB,EAAE,oBAAoB,EACvC,MAAM,YAAY,CAAA;AAInB,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,oBAAoB,EAAE,EAChC,KAAK,GAAE,gBAAqB,GAC3B,WAAW,CAkGb;AAID,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAkB7D"}

package/dist/compass/behavior.js

@@ -0,0 +1,138 @@
+// ── Deterministic behaviour mapping from source findings ─────────────────────
+export function mapBehaviorsFromFindings(findings, input = {}) {
+    const behaviors = [];
+    const gaps = [];
+    const contradictions = [];
+    // Group CLI commands into behaviours
+    const cliFindings = findings.filter(f => f.kind === "cli");
+    for (const f of cliFindings) {
+        behaviors.push({
+            id: `behavior-cli-${f.id}`,
+            area: inferArea(f),
+            name: f.title,
+            description: f.summary,
+            current_behavior: f.summary,
+            evidence: [findingToRef(f)],
+            basis: ["implemented"],
+            confidence: f.confidence,
+        });
+    }
+    // Extract documented user flows from docs findings
+    const docsFindings = findings.filter(f => f.kind === "docs" && f.tags.includes("cli"));
+    for (const f of docsFindings) {
+        // Only add if not already covered by a CLI finding
+        const alreadyPresent = behaviors.some(b => b.current_behavior.toLowerCase().includes(extractCommand(f.summary).toLowerCase()) &&
+            extractCommand(f.summary).length > 3);
+        if (!alreadyPresent && extractCommand(f.summary)) {
+            behaviors.push({
+                id: `behavior-docs-${f.id}`,
+                area: inferArea(f),
+                name: `Documented: ${f.title}`,
+                description: f.summary,
+                current_behavior: f.summary,
+                evidence: [findingToRef(f)],
+                basis: ["documented"],
+                confidence: f.confidence * 0.9,
+            });
+        }
+    }
+    // Cross-reference: documented claims without implementation
+    const docsHeadings = findings.filter(f => f.kind === "docs" && !f.tags.includes("cli"));
+    const implementedAreas = new Set(behaviors.map(b => b.area));
+    // Detect gaps: central product promises with no CLI surface
+    const EXPECTED_AREAS = ["onboarding", "chronicle", "advisor", "review"];
+    for (const expected of EXPECTED_AREAS) {
+        const hasBehavior = behaviors.some(b => b.area === expected || b.name.toLowerCase().includes(expected));
+        if (!hasBehavior) {
+            const docRef = docsHeadings.find(f => f.summary.toLowerCase().includes(expected));
+            gaps.push({
+                id: `gap-${expected}`,
+                area: expected,
+                gap: `No first-class CLI command found for '${expected}'.`,
+                why_it_matters: `'${expected}' appears in product docs but has no dedicated CLI surface.`,
+                evidence: docRef ? [findingToRef(docRef)] : [],
+                confidence: 0.7,
+            });
+        }
+    }
+    // Gap: no product-direction module (Compass itself)
+    const hasCompass = behaviors.some(b => b.name.toLowerCase().includes("compass"));
+    if (!hasCompass) {
+        gaps.push({
+            id: "gap-product-direction",
+            area: "product direction",
+            gap: "No product behaviour mapping or direction module currently exists.",
+            why_it_matters: "Quorum helps agents avoid repeating engineering mistakes, but has no module to help avoid repeating product-direction mistakes.",
+            evidence: [],
+            confidence: 0.93,
+        });
+    }
+    // Filter by area if provided
+    const filteredBehaviors = input.area
+        ? behaviors.filter(b => b.area.toLowerCase().includes(input.area.toLowerCase()) ||
+            b.name.toLowerCase().includes(input.area.toLowerCase()))
+        : behaviors;
+    const overallConfidence = filteredBehaviors.length === 0
+        ? 0.5
+        : filteredBehaviors.reduce((s, b) => s + b.confidence, 0) / filteredBehaviors.length;
+    return {
+        generated_at: new Date().toISOString(),
+        area: input.area,
+        behaviors: filteredBehaviors,
+        gaps: input.area
+            ? gaps.filter(g => g.area.toLowerCase().includes(input.area.toLowerCase()))
+            : gaps,
+        contradictions,
+        confidence: Math.round(overallConfidence * 100) / 100,
+    };
+}
+// ── Extract documented behaviors for LLM context ─────────────────────────────
+export function summarizeBehaviorMap(map) {
+    const lines = [];
+    if (map.behaviors.length > 0) {
+        lines.push("## Current behaviours");
+        for (const b of map.behaviors.slice(0, 20)) {
+            lines.push(`  ✓ ${b.current_behavior.slice(0, 100)}`);
+        }
+    }
+    if (map.gaps.length > 0) {
+        lines.push("\n## Gaps");
+        for (const g of map.gaps) {
+            lines.push(`  ? ${g.gap}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function findingToRef(f) {
+    return {
+        id: f.id,
+        kind: f.kind,
+        source: f.source,
+        path: f.path,
+        summary: f.summary,
+        confidence: f.confidence,
+    };
+}
+function inferArea(f) {
+    if (f.tags.includes("onboarding") || f.tags.includes("init"))
+        return "onboarding";
+    if (f.tags.includes("chronicle") || f.tags.includes("commit") || f.tags.includes("proposal"))
+        return "chronicle review";
+    if (f.tags.includes("advisor"))
+        return "memory retrieval";
+    if (f.tags.includes("sentinel"))
+        return "coverage";
+    if (f.tags.includes("compass"))
+        return "product direction";
+    if (f.tags.includes("auth"))
+        return "auth";
+    if (f.tags.includes("cli"))
+        return "cli";
+    return "general";
+}
+function extractCommand(text) {
+    const match = text.match(/`(quorum [^`]+)`/);
+    return match?.[1] ?? "";
+}
+//# sourceMappingURL=behavior.js.map

package/dist/compass/behavior.js.map

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

package/dist/compass/create.d.ts

@@ -0,0 +1,3 @@
+import type { Compass, CreateCompassOptions } from "./types.js";
+export declare function createCompass(options: CreateCompassOptions): Compass;
+//# sourceMappingURL=create.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../modules/compass/create.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,OAAO,EAAE,oBAAoB,EAW9B,MAAM,YAAY,CAAA;AAoCnB,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CA0TpE"}