agent-bober 0.17.1 → 0.19.0

package/dist/hub/judge.js

@@ -0,0 +1,177 @@
+import { applyFilter } from "./scope.js";
+import { HUB_LENS_NAMES, resolveHubLensFocus, validateRelevanceVerdict, validateLensScore, } from "./lenses.js";
+// ── Prompt helper ─────────────────────────────────────────────────────
+function buildFindingSummary(finding) {
+    const dueStr = finding.dueBy !== undefined ? `\nDue by: ${finding.dueBy}` : "";
+    const tagsStr = finding.tags.length > 0 ? `\nTags: ${finding.tags.join(", ")}` : "";
+    return (`ID: ${finding.id}\n` +
+        `Title: ${finding.title}\n` +
+        `Domain: ${finding.domain}\n` +
+        `Kind: ${finding.kind}\n` +
+        `Urgency: ${finding.urgency}/5\n` +
+        `Severity: ${finding.severity}/5\n` +
+        `Evidence: ${finding.evidence.join("; ")}` +
+        dueStr +
+        tagsStr);
+}
+// ── Pass 1: LLM relevance (general and decision scopes only) ──────────
+/**
+ * Ask the injected LLM for a per-finding relevance verdict.
+ * Returns null on parse failure (fail-closed: caller treats null as "drop").
+ * For filtered scope this function is never called (caller fast-paths).
+ */
+async function askRelevance(finding, scope, llm) {
+    const summary = buildFindingSummary(finding);
+    let system;
+    let userContent;
+    if (scope.mode === "decision") {
+        system =
+            "You are a relevance filter for a personal priority hub helping evaluate a decision. " +
+                "Determine which named option (if any) this finding informs. " +
+                'Respond ONLY with a JSON object: ' +
+                '{ "relevant": boolean, "relevantTo": "optionA" | "optionB" | "both" | "neither", "reason": string }';
+        userContent =
+            `Decision:\nOption A: ${scope.optionA}\nOption B: ${scope.optionB}\n\n` +
+                `Finding:\n${summary}\n\n` +
+                "Which option does this finding inform, if any? Respond with JSON only.";
+    }
+    else {
+        // general (filtered is handled by caller fast path and never reaches here)
+        system =
+            "You are a relevance filter for a personal priority hub. " +
+                "Evaluate whether this finding deserves attention in a general priority review. " +
+                'Respond ONLY with a JSON object: { "relevant": boolean, "reason": string }';
+        userContent =
+            `Finding:\n${summary}\n\n` +
+                "Is this finding relevant for a general priority review? Respond with JSON only.";
+    }
+    const messages = [{ role: "user", content: userContent }];
+    const response = await llm.chat({
+        model: "hub-relevance",
+        system,
+        messages,
+        jsonObjectMode: true,
+    });
+    return validateRelevanceVerdict(response.text);
+}
+// ── Pass 2: hub lens fan-out ──────────────────────────────────────────
+/**
+ * Fan out all hub prioritization lenses for a single finding.
+ * Aggregate score = SUM of per-lens scores (range 0–40 across 4 lenses).
+ * Null lens response → {include:false, score:0} (fail-closed, contributes to failVotes).
+ */
+async function scoreFindingWithLenses(finding, llm) {
+    const summary = buildFindingSummary(finding);
+    let passVotes = 0;
+    let failVotes = 0;
+    let aggregateScore = 0;
+    for (const lens of HUB_LENS_NAMES) {
+        const lensFocus = resolveHubLensFocus(lens);
+        const system = `${lensFocus} ` +
+            "You are evaluating a finding for a personal priority hub. " +
+            'Respond ONLY with a JSON object: { "include": boolean, "score": number, "reason": string } ' +
+            "where score is an integer 0–10 (0 = lowest priority, 10 = highest priority).";
+        const userContent = `Finding:\n${summary}\n\n` +
+            "Should this finding be prioritized? Provide a score and reason. Respond with JSON only.";
+        const messages = [{ role: "user", content: userContent }];
+        const response = await llm.chat({
+            model: "hub-lens",
+            system,
+            messages,
+            jsonObjectMode: true,
+        });
+        // null → fail-closed default: contribute to failVotes, add 0 to aggregate
+        const lensScore = validateLensScore(response.text) ?? { include: false, score: 0 };
+        aggregateScore += lensScore.score;
+        if (lensScore.include) {
+            passVotes += 1;
+        }
+        else {
+            failVotes += 1;
+        }
+    }
+    return { passVotes, failVotes, aggregateScore };
+}
+// ── Deterministic sort comparator ──────────────────────────────────────
+/**
+ * Deterministic comparator for the final sort step.
+ * Order: aggregateScore DESC → urgency DESC → severity DESC →
+ *        dueBy ASC (undefined treated as +Infinity → LAST) → id ASC.
+ */
+function compareFindings(a, b) {
+    // 1. aggregateScore DESC
+    if (b.aggregateScore !== a.aggregateScore)
+        return b.aggregateScore - a.aggregateScore;
+    // 2. urgency DESC
+    if (b.finding.urgency !== a.finding.urgency)
+        return b.finding.urgency - a.finding.urgency;
+    // 3. severity DESC
+    if (b.finding.severity !== a.finding.severity)
+        return b.finding.severity - a.finding.severity;
+    // 4. dueBy ASC; undefined → +Infinity → sorts LAST
+    const dueA = a.finding.dueBy !== undefined ? Date.parse(a.finding.dueBy) : Infinity;
+    const dueB = b.finding.dueBy !== undefined ? Date.parse(b.finding.dueBy) : Infinity;
+    if (dueA !== dueB)
+        return dueA - dueB;
+    // 5. id ASC (lexicographic)
+    if (a.finding.id < b.finding.id)
+        return -1;
+    if (a.finding.id > b.finding.id)
+        return 1;
+    return 0;
+}
+// ── rankFindings ───────────────────────────────────────────────────────
+/**
+ * Two-pass hub prioritization judge.
+ *
+ * @param findings  Pool of Finding[] to rank (input array and Finding objects are never mutated).
+ * @param scope     Ephemeral query scope — not persisted anywhere.
+ * @param llm       Injected LLMClient. Tests pass a ScriptedClient fake; Sprint 4 passes a real client.
+ * @param now       Injected clock for dueWithinDays math in filtered mode. Never call Date.now() here.
+ * @returns         Ranked Finding[]; tie-voted findings carry the "flagged-for-review" tag.
+ */
+export async function rankFindings(findings, scope, llm, now) {
+    // ── Filtered fast path: pure JS, ZERO LLM calls ────────────────────
+    if (scope.mode === "filtered") {
+        const filtered = applyFilter(findings, scope, now);
+        // Sort deterministically without aggregate score (no lens pass for filtered mode)
+        return [...filtered].sort((a, b) => compareFindings({ finding: a, aggregateScore: 0 }, { finding: b, aggregateScore: 0 }));
+    }
+    // ── Pass 1: LLM relevance filter (general / decision) ─────────────
+    const survivors = [];
+    for (const finding of findings) {
+        const verdict = await askRelevance(finding, scope, llm);
+        // null → fail-closed: drop the finding
+        if (verdict === null || !verdict.relevant)
+            continue;
+        // Decision scope: drop "neither" and undefined relevantTo
+        if (scope.mode === "decision") {
+            const rt = verdict.relevantTo;
+            if (rt !== "optionA" && rt !== "optionB" && rt !== "both")
+                continue;
+        }
+        survivors.push(finding);
+    }
+    // ── Pass 2: lens scoring + strict-majority reconcile ──────────────
+    const scored = [];
+    for (const finding of survivors) {
+        const { passVotes, failVotes, aggregateScore } = await scoreFindingWithLenses(finding, llm);
+        // Reconcile: strict majority, fail-closed on tie.
+        // bober: hub inverts the eval/medical panel DROP: a tie/fail-majority keeps the finding
+        //        and tags it "flagged-for-review" rather than dropping it (lens-panel.md:80-84).
+        let out;
+        if (passVotes > failVotes) {
+            out = finding; // strict majority → normal ranking, no tag change
+        }
+        else {
+            // Tie or fail-majority → keep but tag; append to a COPY to avoid mutating input
+            out = finding.tags.includes("flagged-for-review")
+                ? finding
+                : { ...finding, tags: [...finding.tags, "flagged-for-review"] };
+        }
+        scored.push({ finding: out, aggregateScore });
+    }
+    // ── Deterministic sort: LLM never emits the final order ───────────
+    return [...scored].sort(compareFindings).map((s) => s.finding);
+}
+//# sourceMappingURL=judge.js.map

package/dist/hub/judge.js.map

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

package/dist/hub/lenses.d.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+export declare const HUB_LENS_NAMES: readonly ["urgency", "impact", "effort", "deadline-risk"];
+export type HubLensName = (typeof HUB_LENS_NAMES)[number];
+/**
+ * Resolve a hub lens name to its focus fragment.
+ * Returns the catalog entry for a known lens, or a generic non-empty
+ * fallback for any unknown custom string — never throws.
+ */
+export declare function resolveHubLensFocus(lens: string): string;
+/**
+ * Schema for pass-1 relevance verdict (general and decision scopes).
+ * For decision scope: relevantTo disambiguates which option the finding supports.
+ */
+export declare const RelevanceVerdictSchema: z.ZodObject<{
+    relevant: z.ZodBoolean;
+    relevantTo: z.ZodOptional<z.ZodEnum<["optionA", "optionB", "both", "neither"]>>;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    relevant: boolean;
+    relevantTo?: "optionA" | "optionB" | "both" | "neither" | undefined;
+    reason?: string | undefined;
+}, {
+    relevant: boolean;
+    relevantTo?: "optionA" | "optionB" | "both" | "neither" | undefined;
+    reason?: string | undefined;
+}>;
+export type RelevanceVerdict = z.infer<typeof RelevanceVerdictSchema>;
+/**
+ * Schema for pass-2 per-lens score/vote.
+ * include=true counts as a pass-vote; include=false counts as fail-vote.
+ * score (0-10) contributes to aggregate score for final ordering.
+ * An unparseable lens response is treated as { include: false, score: 0 } (fail-closed).
+ */
+export declare const LensScoreSchema: z.ZodObject<{
+    include: z.ZodBoolean;
+    score: z.ZodNumber;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    include: boolean;
+    score: number;
+    reason?: string | undefined;
+}, {
+    include: boolean;
+    score: number;
+    reason?: string | undefined;
+}>;
+export type LensScore = z.infer<typeof LensScoreSchema>;
+/**
+ * Parse a raw LLM text into a RelevanceVerdict.
+ * Returns null on parse failure (fail-closed: treated as irrelevant / no-vote).
+ * NEVER throws.
+ */
+export declare function validateRelevanceVerdict(rawText: string): RelevanceVerdict | null;
+/**
+ * Parse a raw LLM text into a LensScore.
+ * Returns null on parse failure (fail-closed: contributes to failCount, score=0).
+ * NEVER throws.
+ */
+export declare function validateLensScore(rawText: string): LensScore | null;
+//# sourceMappingURL=lenses.d.ts.map

package/dist/hub/lenses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lenses.d.ts","sourceRoot":"","sources":["../../src/hub/lenses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyBxB,eAAO,MAAM,cAAc,2DAKjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAI1D;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD;AAID;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAIjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AA4CxD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAQjF;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAQnE"}

package/dist/hub/lenses.js

@@ -0,0 +1,123 @@
+import { z } from "zod";
+// ── Hub lens catalog ─────────────────────────────────────────────────
+/**
+ * Hub prioritization lens focus fragments.
+ *
+ * Each lens evaluates a Finding through a distinct prioritization axis.
+ * These are hub-specific lenses — do NOT reuse the eval-lenses catalog
+ * (correctness/security/regression/quality/simplicity), which is pinned
+ * by a drift gate at src/orchestrator/lens-panel-parity.test.ts.
+ */
+const HUB_LENS_CATALOG = {
+    urgency: "Focus on how time-sensitive this finding is. Evaluate the immediacy of required action: whether delay causes irreversible harm, significant cost increase, or missed opportunity. A finding requiring action within hours scores higher than one that can wait weeks.",
+    impact: "Focus on the magnitude of effect this finding has on the person's goals, health, finances, or productivity. Evaluate how many downstream decisions or outcomes depend on resolving this finding. High-impact findings affect multiple domains or have compounding consequences.",
+    effort: "Focus on the effort-to-ROI ratio for addressing this finding. Evaluate whether the required action is proportionate to the benefit gained. Low-effort high-benefit findings score highest; high-effort low-benefit findings score lowest. Include complexity, time, and resource cost.",
+    "deadline-risk": "Focus on whether this finding is at risk of becoming unactionable due to an approaching deadline, time-sensitive window, or compounding delay penalty. Evaluate explicit due dates, implicit time constraints, and whether missing the window closes off future options.",
+};
+// ── Hub lens names ────────────────────────────────────────────────────
+export const HUB_LENS_NAMES = [
+    "urgency",
+    "impact",
+    "effort",
+    "deadline-risk",
+];
+// ── Resolver ──────────────────────────────────────────────────────────
+/**
+ * Resolve a hub lens name to its focus fragment.
+ * Returns the catalog entry for a known lens, or a generic non-empty
+ * fallback for any unknown custom string — never throws.
+ */
+export function resolveHubLensFocus(lens) {
+    return (HUB_LENS_CATALOG[lens] ??
+        `Evaluate this finding specifically through the '${lens}' lens.`);
+}
+// ── Zod schemas ───────────────────────────────────────────────────────
+/**
+ * Schema for pass-1 relevance verdict (general and decision scopes).
+ * For decision scope: relevantTo disambiguates which option the finding supports.
+ */
+export const RelevanceVerdictSchema = z.object({
+    relevant: z.boolean(),
+    relevantTo: z.enum(["optionA", "optionB", "both", "neither"]).optional(),
+    reason: z.string().optional(),
+});
+/**
+ * Schema for pass-2 per-lens score/vote.
+ * include=true counts as a pass-vote; include=false counts as fail-vote.
+ * score (0-10) contributes to aggregate score for final ordering.
+ * An unparseable lens response is treated as { include: false, score: 0 } (fail-closed).
+ */
+export const LensScoreSchema = z.object({
+    include: z.boolean(),
+    score: z.number().min(0).max(10),
+    reason: z.string().optional(),
+});
+// ── Four-tier JSON extraction (NEVER throws) ──────────────────────────
+/**
+ * Shared four-tier JSON extraction strategy: direct parse → fenced JSON →
+ * first { } block → fail. Mirrors validateLensVerdict (medical/recommend/lenses.ts:65-113).
+ * NEVER throws. Returns the parsed unknown on success, null on failure.
+ */
+function extractJson(rawText) {
+    // Tier 1: direct parse
+    try {
+        return JSON.parse(rawText.trim());
+    }
+    catch {
+        // fall through to tier 2
+    }
+    // Tier 2: extract from markdown code fences
+    const fenceMatch = /```(?:json)?\s*\n?([\s\S]*?)\n?\s*```/.exec(rawText);
+    if (fenceMatch) {
+        try {
+            return JSON.parse(fenceMatch[1].trim());
+        }
+        catch {
+            // fall through to tier 3
+        }
+    }
+    // Tier 3: find first { ... } block
+    const braceStart = rawText.indexOf("{");
+    const braceEnd = rawText.lastIndexOf("}");
+    if (braceStart !== -1 && braceEnd > braceStart) {
+        try {
+            return JSON.parse(rawText.slice(braceStart, braceEnd + 1));
+        }
+        catch {
+            // fall through to tier 4
+        }
+    }
+    // Tier 4: unparseable
+    return null;
+}
+// ── validateRelevanceVerdict ──────────────────────────────────────────
+/**
+ * Parse a raw LLM text into a RelevanceVerdict.
+ * Returns null on parse failure (fail-closed: treated as irrelevant / no-vote).
+ * NEVER throws.
+ */
+export function validateRelevanceVerdict(rawText) {
+    const parsed = extractJson(rawText);
+    if (parsed === null)
+        return null;
+    const result = RelevanceVerdictSchema.safeParse(parsed);
+    if (!result.success)
+        return null;
+    return result.data;
+}
+// ── validateLensScore ─────────────────────────────────────────────────
+/**
+ * Parse a raw LLM text into a LensScore.
+ * Returns null on parse failure (fail-closed: contributes to failCount, score=0).
+ * NEVER throws.
+ */
+export function validateLensScore(rawText) {
+    const parsed = extractJson(rawText);
+    if (parsed === null)
+        return null;
+    const result = LensScoreSchema.safeParse(parsed);
+    if (!result.success)
+        return null;
+    return result.data;
+}
+//# sourceMappingURL=lenses.js.map

package/dist/hub/lenses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lenses.js","sourceRoot":"","sources":["../../src/hub/lenses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,wEAAwE;AAExE;;;;;;;GAOG;AACH,MAAM,gBAAgB,GAA2B;IAC/C,OAAO,EACL,uQAAuQ;IACzQ,MAAM,EACJ,iRAAiR;IACnR,MAAM,EACJ,wRAAwR;IAC1R,eAAe,EACb,0QAA0Q;CAC7Q,CAAC;AAEF,yEAAyE;AAEzE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,eAAe;CACP,CAAC;AAIX,yEAAyE;AAEzE;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,CACL,gBAAgB,CAAC,IAAI,CAAC;QACtB,mDAAmD,IAAI,SAAS,CACjE,CAAC;AACJ,CAAC;AAED,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAIH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC;AAIH,yEAAyE;AAEzE;;;;GAIG;AACH,SAAS,WAAW,CAAC,OAAe;IAClC,uBAAuB;IACvB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;IAED,4CAA4C;IAC5C,MAAM,UAAU,GAAG,uCAAuC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzE,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,UAAU,KAAK,CAAC,CAAC,IAAI,QAAQ,GAAG,UAAU,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yEAAyE;AAEzE;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAEjC,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,yEAAyE;AAEzE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAEjC,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/hub/priority-md.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pure priority.md renderer — produces a Dataview-friendly markdown note.
+ *
+ * PURE: no IO, no re-ranking, no side effects. The judge's array order is
+ * consumed verbatim — rank = index + 1.
+ *
+ * bober: hand-rolled YAML-frontmatter subset (flat scalars only).
+ *        Mirror of lab-note.ts approach — never import that module.
+ *        Swap for a vetted YAML library if quoted strings or nested objects are required.
+ */
+import type { Finding } from "./finding.js";
+/**
+ * Render a ranked Finding[] into a Dataview-friendly priority.md string.
+ *
+ * @param ranked     Ordered findings from rankFindings() — order is preserved verbatim (no re-sort).
+ * @param scopeLabel Human-readable scope label for the frontmatter (e.g. "general", "decide: X vs Y").
+ * @param now        Injected clock — used for generatedAt. Never call new Date() here.
+ * @returns          Markdown string: YAML frontmatter + Dataview table + per-finding rationale.
+ */
+export declare function renderPriorityMd(ranked: Finding[], scopeLabel: string, now: Date): string;
+//# sourceMappingURL=priority-md.d.ts.map

package/dist/hub/priority-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-md.d.ts","sourceRoot":"","sources":["../../src/hub/priority-md.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAc5C;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,OAAO,EAAE,EACjB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,IAAI,GACR,MAAM,CAyCR"}

package/dist/hub/priority-md.js

@@ -0,0 +1,64 @@
+/**
+ * Pure priority.md renderer — produces a Dataview-friendly markdown note.
+ *
+ * PURE: no IO, no re-ranking, no side effects. The judge's array order is
+ * consumed verbatim — rank = index + 1.
+ *
+ * bober: hand-rolled YAML-frontmatter subset (flat scalars only).
+ *        Mirror of lab-note.ts approach — never import that module.
+ *        Swap for a vetted YAML library if quoted strings or nested objects are required.
+ */
+// ── Cell helpers ──────────────────────────────────────────────────────
+/**
+ * Escape pipe characters and strip embedded newlines from a table cell value
+ * so the Markdown table stays valid for Dataview readers.
+ */
+function cellValue(s) {
+    return s.replace(/\|/g, "\\|").replace(/[\r\n]+/g, " ");
+}
+// ── renderPriorityMd ──────────────────────────────────────────────────
+/**
+ * Render a ranked Finding[] into a Dataview-friendly priority.md string.
+ *
+ * @param ranked     Ordered findings from rankFindings() — order is preserved verbatim (no re-sort).
+ * @param scopeLabel Human-readable scope label for the frontmatter (e.g. "general", "decide: X vs Y").
+ * @param now        Injected clock — used for generatedAt. Never call new Date() here.
+ * @returns          Markdown string: YAML frontmatter + Dataview table + per-finding rationale.
+ */
+export function renderPriorityMd(ranked, scopeLabel, now) {
+    // ── Hand-rolled YAML frontmatter ──────────────────────────────────
+    const lines = ["---"];
+    lines.push(`generatedAt: ${now.toISOString()}`);
+    lines.push(`scope: ${scopeLabel}`);
+    lines.push(`count: ${ranked.length}`);
+    lines.push("---");
+    lines.push("");
+    // ── Dataview-friendly markdown table ─────────────────────────────
+    lines.push("| rank | title | domain | kind | urgency | severity | dueBy |");
+    lines.push("| --- | --- | --- | --- | --- | --- | --- |");
+    for (let i = 0; i < ranked.length; i++) {
+        const f = ranked[i];
+        const rank = i + 1;
+        const dueBy = f.dueBy !== undefined ? f.dueBy : "";
+        lines.push(`| ${rank} | ${cellValue(f.title)} | ${cellValue(f.domain)} | ${f.kind} | ${f.urgency} | ${f.severity} | ${dueBy} |`);
+    }
+    lines.push("");
+    // ── Per-finding rationale / evidence ─────────────────────────────
+    for (let i = 0; i < ranked.length; i++) {
+        const f = ranked[i];
+        const rank = i + 1;
+        lines.push(`### ${rank}. ${f.title}`);
+        lines.push("");
+        if (f.evidence.length > 0) {
+            for (const ev of f.evidence) {
+                lines.push(`- ${ev}`);
+            }
+        }
+        else {
+            lines.push("- (no evidence recorded)");
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=priority-md.js.map

package/dist/hub/priority-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority-md.js","sourceRoot":"","sources":["../../src/hub/priority-md.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,yEAAyE;AAEzE;;;GAGG;AACH,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,yEAAyE;AAEzE;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAiB,EACjB,UAAkB,EAClB,GAAS;IAET,qEAAqE;IACrE,MAAM,KAAK,GAAa,CAAC,KAAK,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,UAAU,UAAU,EAAE,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,oEAAoE;IACpE,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC5E,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAE1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACrB,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACnD,KAAK,CAAC,IAAI,CACR,KAAK,IAAI,MAAM,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,QAAQ,MAAM,KAAK,IAAI,CACrH,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,oEAAoE;IACpE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACrB,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/hub/repo-resolver.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Turn configured hub.repos (if any) OR discovered `kb-*` siblings into
+ * absolute repo-root paths whose derived facts.db actually exists.
+ * Never throws: a configured path that does not exist is skipped.
+ *
+ * @param projectRoot  Absolute path to the current project root.
+ * @param configuredRepos  Optional list from config hub.repos; pass undefined
+ *   to fall through to kb-* sibling discovery.
+ */
+export declare function resolveSiblingRepos(projectRoot: string, configuredRepos?: string[]): Promise<string[]>;
+//# sourceMappingURL=repo-resolver.d.ts.map

package/dist/hub/repo-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-resolver.d.ts","sourceRoot":"","sources":["../../src/hub/repo-resolver.ts"],"names":[],"mappings":"AAQA;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,eAAe,CAAC,EAAE,MAAM,EAAE,GACzB,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB"}

package/dist/hub/repo-resolver.js

@@ -0,0 +1,39 @@
+import { resolve, dirname } from "node:path";
+import { readdir } from "node:fs/promises";
+import { fileExists } from "../utils/fs.js";
+import { factsDbPath } from "../state/facts.js";
+// ── resolveSiblingRepos ───────────────────────────────────────────────
+/**
+ * Turn configured hub.repos (if any) OR discovered `kb-*` siblings into
+ * absolute repo-root paths whose derived facts.db actually exists.
+ * Never throws: a configured path that does not exist is skipped.
+ *
+ * @param projectRoot  Absolute path to the current project root.
+ * @param configuredRepos  Optional list from config hub.repos; pass undefined
+ *   to fall through to kb-* sibling discovery.
+ */
+export async function resolveSiblingRepos(projectRoot, configuredRepos) {
+    const candidates = configuredRepos && configuredRepos.length > 0
+        ? configuredRepos.map((r) => resolve(projectRoot, r))
+        : await discoverKbSiblings(projectRoot);
+    const out = [];
+    for (const repo of candidates) {
+        if (await fileExists(factsDbPath(repo)))
+            out.push(repo);
+    }
+    return out;
+}
+// ── discoverKbSiblings ────────────────────────────────────────────────
+async function discoverKbSiblings(projectRoot) {
+    const parent = dirname(projectRoot);
+    try {
+        const entries = await readdir(parent, { withFileTypes: true });
+        return entries
+            .filter((e) => e.isDirectory() && /^kb-/.test(e.name))
+            .map((e) => resolve(parent, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=repo-resolver.js.map

package/dist/hub/repo-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-resolver.js","sourceRoot":"","sources":["../../src/hub/repo-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAE3C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,yEAAyE;AAEzE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,eAA0B;IAE1B,MAAM,UAAU,GACd,eAAe,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC;QAC3C,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAE5C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,MAAM,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,yEAAyE;AAEzE,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;aACrD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/hub/scope.d.ts

@@ -0,0 +1,39 @@
+import type { Finding } from "./finding.js";
+/**
+ * Discriminated union representing the query scope for hub prioritization.
+ *
+ * - general: no constraint; LLM relevance-filters the full pool.
+ * - decision: keep findings relevant to either named option (drop "neither").
+ * - filtered: pure JS structural filter on domain, tag, and/or dueWithinDays.
+ */
+export type Scope = {
+    mode: "general";
+} | {
+    mode: "decision";
+    optionA: string;
+    optionB: string;
+} | {
+    mode: "filtered";
+    domain?: string;
+    dueWithinDays?: number;
+    tag?: string;
+};
+/**
+ * Parse an unknown value into a Scope discriminated union.
+ * Falls back to { mode: "general" } on any parse failure — never throws.
+ */
+export declare function parseScope(raw: unknown): Scope;
+/**
+ * Pure structural filter — NO LLM, NO async, NO side effects.
+ *
+ * For filtered scope: returns findings matching ALL specified constraints
+ * (domain AND tag AND dueBy within dueWithinDays of now).
+ * A finding with no dueBy does NOT satisfy a dueWithinDays constraint.
+ * For non-filtered scopes: returns findings unchanged (the LLM pass-1 handles those).
+ *
+ * @param findings  Pool of findings to filter.
+ * @param scope     The parsed query scope.
+ * @param now       Injected clock — used for dueWithinDays calculation.
+ */
+export declare function applyFilter(findings: Finding[], scope: Scope, now: Date): Finding[];
+//# sourceMappingURL=scope.d.ts.map

package/dist/hub/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/hub/scope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GACb;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAmBhF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAI9C;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,EAAE,CAqBnF"}

package/dist/hub/scope.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+// ── parseScope ────────────────────────────────────────────────────────
+const ScopeInputSchema = z.discriminatedUnion("mode", [
+    z.object({ mode: z.literal("general") }),
+    z.object({
+        mode: z.literal("decision"),
+        optionA: z.string(),
+        optionB: z.string(),
+    }),
+    z.object({
+        mode: z.literal("filtered"),
+        domain: z.string().optional(),
+        dueWithinDays: z.number().int().optional(),
+        tag: z.string().optional(),
+    }),
+]);
+/**
+ * Parse an unknown value into a Scope discriminated union.
+ * Falls back to { mode: "general" } on any parse failure — never throws.
+ */
+export function parseScope(raw) {
+    const result = ScopeInputSchema.safeParse(raw);
+    if (result.success)
+        return result.data;
+    return { mode: "general" };
+}
+// ── applyFilter ───────────────────────────────────────────────────────
+/**
+ * Pure structural filter — NO LLM, NO async, NO side effects.
+ *
+ * For filtered scope: returns findings matching ALL specified constraints
+ * (domain AND tag AND dueBy within dueWithinDays of now).
+ * A finding with no dueBy does NOT satisfy a dueWithinDays constraint.
+ * For non-filtered scopes: returns findings unchanged (the LLM pass-1 handles those).
+ *
+ * @param findings  Pool of findings to filter.
+ * @param scope     The parsed query scope.
+ * @param now       Injected clock — used for dueWithinDays calculation.
+ */
+export function applyFilter(findings, scope, now) {
+    if (scope.mode !== "filtered")
+        return findings;
+    const { domain, tag, dueWithinDays } = scope;
+    return findings.filter((f) => {
+        // Domain constraint: finding.domain must match if specified
+        if (domain !== undefined && f.domain !== domain)
+            return false;
+        // Tag constraint: finding.tags must include the tag if specified
+        if (tag !== undefined && !f.tags.includes(tag))
+            return false;
+        // dueWithinDays constraint: finding.dueBy must exist and be within N days of now
+        if (dueWithinDays !== undefined) {
+            if (!f.dueBy)
+                return false; // no dueBy → does NOT satisfy dueWithinDays
+            const deadline = new Date(now.getTime() + dueWithinDays * 24 * 60 * 60 * 1000);
+            if (Date.parse(f.dueBy) > deadline.getTime())
+                return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=scope.js.map