@balpal4495/quorum 3.0.3 → 3.1.0

package/dist/council/deliberate.js

@@ -0,0 +1,99 @@
+import { DEFAULT_PERSONAS } from "./personas.js";
+import { frameQuestion } from "./frame.js";
+import { fanOutAdvisors } from "./advisors.js";
+import { fanOutReviewers } from "./reviewers.js";
+import { chairman } from "./chairman.js";
+import { classifyRisk } from "./risk.js";
+const DEFAULT_ADVISOR_COUNT = 5;
+const DEFAULT_REVIEWER_COUNT = 5;
+const LITE_ADVISOR_COUNT = 1;
+const LITE_REVIEWER_COUNT = 2;
+/**
+ * Run the Council deliberation pipeline.
+ *
+ * Pipeline:
+ *   1. frameQuestion     — reframe outcome + design into a deliberation brief
+ *   2. fanOutAdvisors    — N advisors reason in parallel from Oracle evidence
+ *   3. fanOutReviewers   — N reviewers critique anonymised advisor responses in parallel
+ *   4. chairman          — synthesises verdict, cites Oracle entry IDs
+ *   5. oracle.propose()  — proposes verdict to Chronicle (human approval required to commit)
+ *
+ * The council_brief from jury_output determines framing tone:
+ *   "challenge"      → find what is wrong (Jury confidence < 0.6)
+ *   "pressure-test"  → try to break what looks solid (Jury confidence ≥ 0.6)
+ *
+ * Routing on output:
+ *   satisfied: true                           → proceed to human gate → Executor
+ *   satisfied: false, recommendation: redesign         → return to Designer
+ *   satisfied: false, recommendation: investigate-more → return to Detective with gaps list
+ */
+export async function deliberate(input, deps) {
+    const { llm, oracle, models = {}, } = deps;
+    // Classify risk to determine Council mode and advisor/reviewer counts
+    const risk = classifyRisk(input.outcome, input.design, input.evidence);
+    if (risk.council_mode === "jury-only") {
+        return {
+            satisfied: true,
+            verdict: "Skipped — low-risk design passed by Jury without Council review.",
+            blockers: [],
+            warnings: [],
+            challenges: [],
+            evidence_cited: [],
+            citation_validation: { valid_ids: [], hallucinated_ids: [] },
+            advisor_split: { proceed: 0, redesign: 0, "investigate-more": 0 },
+            recommendation: "proceed",
+        };
+    }
+    let defaultAdvisors = DEFAULT_ADVISOR_COUNT;
+    let defaultReviewers = DEFAULT_REVIEWER_COUNT;
+    if (risk.council_mode === "lite") {
+        defaultAdvisors = LITE_ADVISOR_COUNT;
+        defaultReviewers = LITE_REVIEWER_COUNT;
+    }
+    const advisorCount = deps.advisorCount ?? defaultAdvisors;
+    const reviewerCount = deps.reviewerCount ?? defaultReviewers;
+    // Select personas — cycle DEFAULT_PERSONAS if advisorCount > 5
+    const personas = Array.from({ length: advisorCount }, (_, i) => DEFAULT_PERSONAS[i % DEFAULT_PERSONAS.length]);
+    // 1. Frame the deliberation question
+    const framedQuestion = await frameQuestion(input, llm, models.frame);
+    // 2. Advisors reason in parallel
+    const advisorResponses = await fanOutAdvisors(framedQuestion, input.evidence, personas, llm, models.advisors);
+    // 3. Reviewers critique in parallel (advisor responses anonymised inside fanOutReviewers)
+    const reviewerResponses = await fanOutReviewers(advisorResponses, input.evidence, reviewerCount, llm, models.reviewers);
+    // 4. Chairman synthesises verdict
+    const verdict = await chairman(advisorResponses, reviewerResponses, input.evidence, llm, models.chairman);
+    // 5. Propose verdict to Oracle — human must call oracle.commit() to index it
+    // Truncate to 200 chars so it passes propose()'s schema validation.
+    const firstSentence = verdict.verdict.split(/[.!?]/)[0]?.trim() ?? "";
+    const keyInsight = (firstSentence.length >= 20 ? firstSentence : verdict.verdict)
+        .slice(0, 200);
+    await oracle.propose({
+        schema_version: 2,
+        topic: input.outcome.slice(0, 80),
+        decision: keyInsight,
+        key_insight: keyInsight,
+        affected_areas: extractAffectedAreas(input.outcome, input.design),
+        alternatives_considered: verdict.challenges,
+        rejected_reason: verdict.satisfied
+            ? []
+            : verdict.blockers.map(b => b.issue).slice(0, 3),
+        status: "open",
+        confidence: input.jury_output.confidence,
+        source_module: "council",
+        evidence_cited: verdict.citation_validation.valid_ids,
+        scope: risk.reasons.slice(0, 3),
+    });
+    return verdict;
+}
+/**
+ * Extract candidate affected areas from the outcome and design text.
+ * Looks for capitalised noun phrases as a simple heuristic.
+ * The host application may override by post-processing CouncilOutput.
+ */
+function extractAffectedAreas(outcome, design) {
+    const text = `${outcome} ${design}`;
+    const phrases = text.match(/\b[A-Z][a-zA-Z]+(?:\s[A-Z][a-zA-Z]+)*\b/g) ?? [];
+    const unique = [...new Set(phrases)];
+    return unique.length > 0 ? unique.slice(0, 5) : ["general"];
+}
+//# sourceMappingURL=deliberate.js.map

package/dist/council/deliberate.js.map

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

package/dist/council/frame.d.ts

@@ -0,0 +1,8 @@
+import type { LLMProvider } from "../shared/types.js";
+import type { CouncilInput } from "./types.js";
+/**
+ * Reframe the outcome + design into a clear deliberation brief for the advisor panel.
+ * Tone and scope are set by the Jury's council_brief value.
+ */
+export declare function frameQuestion(input: CouncilInput, llm: LLMProvider, model?: string): Promise<string>;
+//# sourceMappingURL=frame.d.ts.map

package/dist/council/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../modules/council/frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,WAAW,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CA0CjB"}

package/dist/council/frame.js

@@ -0,0 +1,40 @@
+/**
+ * Reframe the outcome + design into a clear deliberation brief for the advisor panel.
+ * Tone and scope are set by the Jury's council_brief value.
+ */
+export async function frameQuestion(input, llm, model) {
+    const { outcome, design, jury_output } = input;
+    const briefInstruction = jury_output.council_brief === "challenge"
+        ? `The Jury has LOW confidence (score: ${jury_output.confidence.toFixed(2)}). ` +
+            "Find what is WRONG with this design. Look for fundamental flaws, not just edge cases."
+        : `The Jury has HIGH confidence (score: ${jury_output.confidence.toFixed(2)}). ` +
+            "PRESSURE-TEST this design. Assume it is broadly correct — try to break it. " +
+            "Find edge cases, scaling failures, and hidden assumptions.";
+    const systemPrompt = [
+        "You are the Council Framer. You write the deliberation brief that a panel of expert advisors will work from.",
+        "",
+        "Write a clear, precise brief that:",
+        "1. States what needs to be achieved (the outcome)",
+        "2. States what is being proposed (the design)",
+        "3. States the Jury's assessment and the gaps it identified",
+        "4. Sets the council directive — challenge or pressure-test",
+        "",
+        "Keep it under 300 words. Be direct. Advisors must know exactly what to evaluate.",
+    ].join("\n");
+    const userPrompt = [
+        `Outcome: ${outcome}`,
+        "",
+        `Design: ${design}`,
+        "",
+        `Jury assessment: ${jury_output.assessment}`,
+        `Jury confidence: ${jury_output.confidence.toFixed(2)}`,
+        `Jury gaps: ${jury_output.gaps.join("; ") || "none identified"}`,
+        "",
+        briefInstruction,
+    ].join("\n");
+    return llm([
+        { role: "system", content: systemPrompt },
+        { role: "user", content: userPrompt },
+    ], model);
+}
+//# sourceMappingURL=frame.js.map

package/dist/council/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../modules/council/frame.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAAmB,EACnB,GAAgB,EAChB,KAAc;IAEd,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAA;IAE9C,MAAM,gBAAgB,GACpB,WAAW,CAAC,aAAa,KAAK,WAAW;QACvC,CAAC,CAAC,uCAAuC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YAC7E,uFAAuF;QACzF,CAAC,CAAC,wCAAwC,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YAC9E,6EAA6E;YAC7E,4DAA4D,CAAA;IAElE,MAAM,YAAY,GAAG;QACnB,8GAA8G;QAC9G,EAAE;QACF,oCAAoC;QACpC,mDAAmD;QACnD,+CAA+C;QAC/C,4DAA4D;QAC5D,4DAA4D;QAC5D,EAAE;QACF,kFAAkF;KACnF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEZ,MAAM,UAAU,GAAG;QACjB,YAAY,OAAO,EAAE;QACrB,EAAE;QACF,WAAW,MAAM,EAAE;QACnB,EAAE;QACF,oBAAoB,WAAW,CAAC,UAAU,EAAE;QAC5C,oBAAoB,WAAW,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QACvD,cAAc,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,iBAAiB,EAAE;QAChE,EAAE;QACF,gBAAgB;KACjB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEZ,OAAO,GAAG,CACR;QACE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;QACzC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;KACtC,EACD,KAAK,CACN,CAAA;AACH,CAAC"}

package/dist/council/index.d.ts

@@ -0,0 +1,6 @@
+export { deliberate } from "./deliberate.js";
+export type { CouncilInput, CouncilOutput, CouncilDeps, CouncilModels, BlockerItem, WarningItem, CitationValidation, AdvisorSplit, RiskLevel, CouncilMode, RiskAssessment, } from "./types.js";
+export { DEFAULT_PERSONAS } from "./personas.js";
+export type { AdvisorPersona } from "./personas.js";
+export { classifyRisk } from "./risk.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../modules/council/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,YAAY,EACV,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EACvD,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAC1D,SAAS,EAAE,WAAW,EAAE,cAAc,GACvC,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA"}

package/dist/council/index.js

@@ -0,0 +1,4 @@
+export { deliberate } from "./deliberate.js";
+export { DEFAULT_PERSONAS } from "./personas.js";
+export { classifyRisk } from "./risk.js";
+//# sourceMappingURL=index.js.map

package/dist/council/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../modules/council/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAM5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA"}

package/dist/council/personas.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Default advisor personas for the Council.
+ *
+ * Personas are interpretive lenses, not knowledge sources.
+ * All advisors receive the same Oracle evidence pack — their persona
+ * determines which entries they weight and how they read them.
+ *
+ * Add or replace personas in CouncilDeps to specialise for your domain.
+ */
+export interface AdvisorPersona {
+    name: string;
+    /** One-line description of this persona's evidence focus. */
+    lens: string;
+    /** System prompt fragment injected into the advisor's prompt. */
+    systemFragment: string;
+}
+export declare const DEFAULT_PERSONAS: readonly AdvisorPersona[];
+//# sourceMappingURL=personas.d.ts.map

package/dist/council/personas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../../modules/council/personas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAsCrD,CAAA"}

package/dist/council/personas.js

@@ -0,0 +1,44 @@
+/**
+ * Default advisor personas for the Council.
+ *
+ * Personas are interpretive lenses, not knowledge sources.
+ * All advisors receive the same Oracle evidence pack — their persona
+ * determines which entries they weight and how they read them.
+ *
+ * Add or replace personas in CouncilDeps to specialise for your domain.
+ */
+export const DEFAULT_PERSONAS = [
+    {
+        name: "Pragmatist",
+        lens: "Weights validated entries — what has worked in this codebase",
+        systemFragment: "Focus on `validated` Oracle entries. What has already worked in this codebase? " +
+            "Weight evidence that confirms the design will succeed based on prior outcomes.",
+    },
+    {
+        name: "Sceptic",
+        lens: "Weights refuted entries — what has failed and why",
+        systemFragment: "Focus on `refuted` Oracle entries. What has already failed in this codebase and why? " +
+            "Look for signs this design repeats past mistakes. Surface failure modes explicitly.",
+    },
+    {
+        name: "Systems thinker",
+        lens: "Looks for patterns across all entries — second-order effects",
+        systemFragment: "Read all Oracle entries as a system. Look for patterns, dependencies, and second-order " +
+            "effects. What does the design miss about how the system as a whole behaves?",
+    },
+    {
+        name: "Risk analyst",
+        lens: "Weights open entries — unresolved questions and unknowns",
+        systemFragment: "Focus on `open` Oracle entries — unresolved questions and unknowns. " +
+            "What has not been confirmed? What uncertainty does this design carry? " +
+            "Flag every assumption that has not been validated by an outcome.",
+    },
+    {
+        name: "Evidence auditor",
+        lens: "Focuses on gaps — what Oracle does NOT contain",
+        systemFragment: "Look for what is ABSENT from the Oracle evidence. What decisions is this design making " +
+            "without any codebase evidence to support them? " +
+            "Name every gap — a gap is not a reason to reject, but it must be surfaced.",
+    },
+];
+//# sourceMappingURL=personas.js.map

package/dist/council/personas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas.js","sourceRoot":"","sources":["../../modules/council/personas.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,8DAA8D;QACpE,cAAc,EACZ,iFAAiF;YACjF,gFAAgF;KACnF;IACD;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,mDAAmD;QACzD,cAAc,EACZ,uFAAuF;YACvF,qFAAqF;KACxF;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,8DAA8D;QACpE,cAAc,EACZ,yFAAyF;YACzF,6EAA6E;KAChF;IACD;QACE,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,0DAA0D;QAChE,cAAc,EACZ,sEAAsE;YACtE,wEAAwE;YACxE,kEAAkE;KACrE;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,gDAAgD;QACtD,cAAc,EACZ,yFAAyF;YACzF,iDAAiD;YACjD,4EAA4E;KAC/E;CACF,CAAA"}

package/dist/council/reviewers.d.ts

@@ -0,0 +1,13 @@
+import type { LLMProvider, OracleResult } from "../shared/types.js";
+import type { AdvisorResponse } from "./advisors.js";
+export interface ReviewerResponse {
+    reviewerId: string;
+    review: string;
+}
+/**
+ * Run all reviewers in parallel.
+ * Each reviewer receives the anonymised advisor responses and the original evidence pack.
+ * Anonymisation prevents position bias and persona deference.
+ */
+export declare function fanOutReviewers(advisorResponses: AdvisorResponse[], evidence: OracleResult[], reviewerCount: number, llm: LLMProvider, model?: string): Promise<ReviewerResponse[]>;
+//# sourceMappingURL=reviewers.d.ts.map

package/dist/council/reviewers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewers.d.ts","sourceRoot":"","sources":["../../modules/council/reviewers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;CACf;AAoCD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,gBAAgB,EAAE,eAAe,EAAE,EACnC,QAAQ,EAAE,YAAY,EAAE,EACxB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,WAAW,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,EAAE,CAAC,CA2B7B"}

package/dist/council/reviewers.js

@@ -0,0 +1,59 @@
+import { entryText } from "../shared/types.js";
+/**
+ * Shuffle advisor responses and label them A–Z.
+ * Prevents reviewers deferring to confident responses by position or persona name.
+ */
+function anonymise(responses) {
+    const shuffled = [...responses].sort(() => Math.random() - 0.5);
+    return shuffled
+        .map((r, i) => `## Advisor ${String.fromCharCode(65 + i)}\n${r.response}`)
+        .join("\n\n---\n\n");
+}
+function formatEvidenceSummary(evidence) {
+    if (evidence.length === 0)
+        return "No Oracle evidence available.";
+    return evidence
+        .map(e => `[${e.id}] (${e.status}) ${entryText(e)}`)
+        .join("\n");
+}
+const REVIEWER_SYSTEM_PROMPT = [
+    "You are a Council reviewer. You evaluate the quality of advisor responses.",
+    "",
+    "You are NOT deciding whether the design is correct.",
+    "You are assessing the reasoning quality of each advisor response:",
+    "",
+    "1. Does the advisor actually use the Oracle evidence, or reason from general knowledge?",
+    "2. Are Oracle entry IDs cited? Do those citations match the evidence provided?",
+    "3. Is the response internally consistent?",
+    "4. Which responses provide the strongest evidence-backed reasoning?",
+    "5. Which responses make unsupported claims?",
+    "",
+    "Be critical. Evidence quality matters more than conclusion confidence.",
+    "Keep your review under 400 words.",
+].join("\n");
+/**
+ * Run all reviewers in parallel.
+ * Each reviewer receives the anonymised advisor responses and the original evidence pack.
+ * Anonymisation prevents position bias and persona deference.
+ */
+export async function fanOutReviewers(advisorResponses, evidence, reviewerCount, llm, model) {
+    const anonymisedResponses = anonymise(advisorResponses);
+    const evidenceSummary = formatEvidenceSummary(evidence);
+    return Promise.all(Array.from({ length: reviewerCount }, async (_, i) => {
+        const userPrompt = [
+            "## Advisor Responses (anonymised)",
+            anonymisedResponses,
+            "",
+            "## Oracle Evidence (for cross-referencing citations)",
+            evidenceSummary,
+            "",
+            "Review each advisor response for evidence quality.",
+        ].join("\n");
+        const review = await llm([
+            { role: "system", content: REVIEWER_SYSTEM_PROMPT },
+            { role: "user", content: userPrompt },
+        ], model);
+        return { reviewerId: `reviewer-${i + 1}`, review };
+    }));
+}
+//# sourceMappingURL=reviewers.js.map

package/dist/council/reviewers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewers.js","sourceRoot":"","sources":["../../modules/council/reviewers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAQ9C;;;GAGG;AACH,SAAS,SAAS,CAAC,SAA4B;IAC7C,MAAM,QAAQ,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAA;IAC/D,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,cAAc,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;SACzE,IAAI,CAAC,aAAa,CAAC,CAAA;AACxB,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAwB;IACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,+BAA+B,CAAA;IACjE,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,IAAI,CAAC,IAAI,CAAC,CAAA;AACf,CAAC;AAED,MAAM,sBAAsB,GAAG;IAC7B,4EAA4E;IAC5E,EAAE;IACF,qDAAqD;IACrD,mEAAmE;IACnE,EAAE;IACF,yFAAyF;IACzF,gFAAgF;IAChF,2CAA2C;IAC3C,qEAAqE;IACrE,6CAA6C;IAC7C,EAAE;IACF,wEAAwE;IACxE,mCAAmC;CACpC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,gBAAmC,EACnC,QAAwB,EACxB,aAAqB,EACrB,GAAgB,EAChB,KAAc;IAEd,MAAM,mBAAmB,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAA;IACvD,MAAM,eAAe,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAA;IAEvD,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAA6B,EAAE;QAC9E,MAAM,UAAU,GAAG;YACjB,mCAAmC;YACnC,mBAAmB;YACnB,EAAE;YACF,sDAAsD;YACtD,eAAe;YACf,EAAE;YACF,oDAAoD;SACrD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAEZ,MAAM,MAAM,GAAG,MAAM,GAAG,CACtB;YACE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,sBAAsB,EAAE;YACnD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE;SACtC,EACD,KAAK,CACN,CAAA;QAED,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CAAA;IACpD,CAAC,CAAC,CACH,CAAA;AACH,CAAC"}

package/dist/council/risk.d.ts

@@ -0,0 +1,16 @@
+import type { OracleResult } from "../shared/types.js";
+import type { RiskAssessment } from "./types.js";
+/**
+ * Classify the risk level of a proposed change from its text and evidence.
+ *
+ * Risk determines Council mode — avoid running full fan-out on low-risk changes:
+ *   low      → jury-only  (no advisor/reviewer fan-out)
+ *   medium   → lite       (Jury + 2 reviewers)
+ *   high     → full       (standard 5 advisors + 5 reviewers)
+ *   critical → full       (same as high, but Chronicle entry flags for human architecture review)
+ *
+ * Refuted Oracle entries also elevate risk — a known failure mode in the evidence pack
+ * means the design is repeating something that already went wrong.
+ */
+export declare function classifyRisk(outcome: string, design: string, evidence: OracleResult[]): RiskAssessment;
+//# sourceMappingURL=risk.d.ts.map

package/dist/council/risk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risk.d.ts","sourceRoot":"","sources":["../../modules/council/risk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAA0B,cAAc,EAAE,MAAM,YAAY,CAAA;AAyCxE;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,YAAY,EAAE,GACvB,cAAc,CA8BhB"}

package/dist/council/risk.js

@@ -0,0 +1,74 @@
+/**
+ * Patterns that trigger risk escalation.
+ * Each entry has a level (the minimum risk level it triggers) and a reason label.
+ */
+const RISK_RULES = [
+    // Critical — always run full Council + flag for human architecture review
+    { pattern: /\b(auth(?:entication|orization)?|jwt|token|session|password|oauth|credential|bearer)\b/i, level: "critical", reason: "authentication or authorisation logic" },
+    { pattern: /\b(payment|stripe|charge|billing|checkout|refund|subscription)\b/i, level: "critical", reason: "payment or billing logic" },
+    { pattern: /\b(encrypt|decrypt|private\s+key|certificate|tls|ssl|hmac|cipher)\b/i, level: "critical", reason: "cryptography or key management" },
+    { pattern: /\b(delete\s+all|drop\s+table|truncate|wipe|destroy.*data|hard\s+delete)\b/i, level: "critical", reason: "irreversible data deletion" },
+    // High — full Council
+    { pattern: /\b(migrat(?:ion|e)|alter\s+table|schema\s+change|not\s+null|backfill|pg_repack|shadow\s+column)\b/i, level: "high", reason: "database schema migration" },
+    { pattern: /\b(permission|role(?:s)?|acl|rbac|access\s+control|entitlement)\b/i, level: "high", reason: "permissions or access control" },
+    { pattern: /\b(pii|personal\s+data|gdpr|ccpa|email(?:\s+address)?|phone(?:\s+number)?|ssn|passport)\b/i, level: "high", reason: "PII or compliance-regulated data" },
+    { pattern: /\b(api\s+key|secret(?:s)?|private\s+key|credentials?)\b/i, level: "high", reason: "secrets or credentials handling" },
+    // Medium — Jury + lite Council
+    { pattern: /\b(cache|redis|memcached|invalidat(?:e|ion))\b/i, level: "medium", reason: "cache strategy" },
+    { pattern: /\b(rate\s*limit|throttl(?:e|ing)|quota)\b/i, level: "medium", reason: "rate limiting or throttling" },
+    { pattern: /\b(webhook|event|queue|pubsub|kafka|rabbitmq|sns|sqs)\b/i, level: "medium", reason: "async event or messaging" },
+    { pattern: /\b(deploy(?:ment)?|ci(?:\/cd)?|docker|kubernetes|infra(?:structure)?)\b/i, level: "medium", reason: "deployment or infrastructure" },
+];
+const RISK_ORDER = ["low", "medium", "high", "critical"];
+function maxLevel(a, b) {
+    return RISK_ORDER.indexOf(a) >= RISK_ORDER.indexOf(b) ? a : b;
+}
+function councilModeForLevel(level) {
+    switch (level) {
+        case "low": return "jury-only";
+        case "medium": return "lite";
+        case "high": return "full";
+        case "critical": return "full";
+    }
+}
+/**
+ * Classify the risk level of a proposed change from its text and evidence.
+ *
+ * Risk determines Council mode — avoid running full fan-out on low-risk changes:
+ *   low      → jury-only  (no advisor/reviewer fan-out)
+ *   medium   → lite       (Jury + 2 reviewers)
+ *   high     → full       (standard 5 advisors + 5 reviewers)
+ *   critical → full       (same as high, but Chronicle entry flags for human architecture review)
+ *
+ * Refuted Oracle entries also elevate risk — a known failure mode in the evidence pack
+ * means the design is repeating something that already went wrong.
+ */
+export function classifyRisk(outcome, design, evidence) {
+    const text = `${outcome} ${design}`;
+    let level = "low";
+    const reasons = [];
+    for (const rule of RISK_RULES) {
+        if (rule.pattern.test(text)) {
+            const matched = maxLevel(level, rule.level);
+            if (matched !== level || !reasons.includes(rule.reason)) {
+                level = matched;
+                reasons.push(rule.reason);
+            }
+        }
+    }
+    // Refuted entries in the evidence pack are a direct risk signal
+    const refutedCount = evidence.filter(e => e.status === "refuted").length;
+    if (refutedCount > 0) {
+        const refutedRisk = refutedCount >= 2 ? "high" : "medium";
+        if (RISK_ORDER.indexOf(refutedRisk) > RISK_ORDER.indexOf(level)) {
+            level = maxLevel(level, refutedRisk);
+        }
+        reasons.push(`${refutedCount} refuted Chronicle ${refutedCount === 1 ? "entry" : "entries"} in evidence pack`);
+    }
+    return {
+        level,
+        reasons: reasons.length > 0 ? reasons : ["no sensitive patterns detected"],
+        council_mode: councilModeForLevel(level),
+    };
+}
+//# sourceMappingURL=risk.js.map

package/dist/council/risk.js.map

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

package/dist/council/types.d.ts

@@ -0,0 +1,95 @@
+import type { OracleResult, LLMProvider, OracleClient } from "../shared/types.js";
+import type { JuryOutput } from "../jury/types.js";
+export interface CouncilInput {
+    /** What needs to be achieved. */
+    outcome: string;
+    /** Proposed approach from the Designer. */
+    design: string;
+    /** Same evidence pack the Jury received. */
+    evidence: OracleResult[];
+    /** Jury output — drives the council brief and confidence. */
+    jury_output: JuryOutput;
+}
+/** A finding that must be resolved before the design can proceed. */
+export interface BlockerItem {
+    issue: string;
+    /** Oracle entry IDs that evidence this blocker. */
+    evidence: string[];
+    /** What must change in the design to resolve this. */
+    required_fix: string;
+}
+/** A finding that should be addressed but does not block proceeding. */
+export interface WarningItem {
+    issue: string;
+    suggested_fix?: string;
+}
+/** Validates that cited Oracle IDs actually appeared in the evidence pack. */
+export interface CitationValidation {
+    /** IDs that were cited and exist in the evidence pack. */
+    valid_ids: string[];
+    /** IDs that were cited but were NOT in the evidence pack — likely hallucinated. */
+    hallucinated_ids: string[];
+}
+/** How advisors split on their recommendation. Signals disagreement level. */
+export interface AdvisorSplit {
+    proceed: number;
+    redesign: number;
+    "investigate-more": number;
+}
+export interface CouncilOutput {
+    satisfied: boolean;
+    /** Chairman synthesis — every material conclusion cites Oracle entry IDs. */
+    verdict: string;
+    /**
+     * Findings that MUST be resolved before the design proceeds.
+     * Each blocker names the issue, the Oracle evidence behind it, and the required fix.
+     */
+    blockers: BlockerItem[];
+    /**
+     * Findings that SHOULD be addressed but don't block execution.
+     */
+    warnings: WarningItem[];
+    /** Flat list of all issues raised — backwards compatible with existing consumers. */
+    challenges: string[];
+    /** Oracle entry IDs referenced in the verdict. */
+    evidence_cited: string[];
+    /** Validation of whether cited IDs exist in the evidence pack. */
+    citation_validation: CitationValidation;
+    /** How advisors split on recommendation — high disagreement = escalate. */
+    advisor_split: AdvisorSplit;
+    recommendation: "proceed" | "redesign" | "investigate-more";
+}
+export interface CouncilModels {
+    /** Model for the framer step. */
+    frame?: string;
+    /** Model for advisors. High volume — cheaper model appropriate here. */
+    advisors?: string;
+    /** Model for reviewers. Critical analysis — stronger model recommended. */
+    reviewers?: string;
+    /** Model for the chairman. Synthesis — best available model recommended. */
+    chairman?: string;
+}
+export interface CouncilDeps {
+    llm: LLMProvider;
+    oracle: OracleClient;
+    /** Number of advisors to run in parallel. Default: 5. */
+    advisorCount?: number;
+    /** Number of reviewers to run in parallel. Default: 5. */
+    reviewerCount?: number;
+    models?: CouncilModels;
+}
+export type RiskLevel = "low" | "medium" | "high" | "critical";
+/**
+ * Determines which Council mode to use.
+ *   skip        → Oracle query only, no LLM validation
+ *   jury-only   → Jury scores, Council skipped entirely (low-risk fast path)
+ *   lite        → Jury + 1–2 reviewers (no full advisor fan-out)
+ *   full        → Full Council (default 5 advisors + 5 reviewers + Chairman)
+ */
+export type CouncilMode = "skip" | "jury-only" | "lite" | "full";
+export interface RiskAssessment {
+    level: RiskLevel;
+    reasons: string[];
+    council_mode: CouncilMode;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../modules/council/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,4CAA4C;IAC5C,QAAQ,EAAE,YAAY,EAAE,CAAA;IACxB,6DAA6D;IAC7D,WAAW,EAAE,UAAU,CAAA;CACxB;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,mDAAmD;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,mFAAmF;IACnF,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAA;IAClB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB;;OAEG;IACH,QAAQ,EAAE,WAAW,EAAE,CAAA;IACvB,qFAAqF;IACrF,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,kDAAkD;IAClD,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,kEAAkE;IAClE,mBAAmB,EAAE,kBAAkB,CAAA;IACvC,2EAA2E;IAC3E,aAAa,EAAE,YAAY,CAAA;IAC3B,cAAc,EAAE,SAAS,GAAG,UAAU,GAAG,kBAAkB,CAAA;CAC5D;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,WAAW,CAAA;IAChB,MAAM,EAAE,YAAY,CAAA;IACpB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,aAAa,CAAA;CACvB;AAID,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAAA;AAEhE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAA;IAChB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,YAAY,EAAE,WAAW,CAAA;CAC1B"}

package/dist/council/types.js

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

package/dist/council/types.js.map

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

package/dist/jury/evaluate.d.ts

@@ -0,0 +1,13 @@
+import type { JuryInput, JuryOutput, JuryDeps } from "./types.js";
+/**
+ * Evaluate a proposed design against Oracle evidence.
+ *
+ * Scores across four dimensions (evidence support, feasibility, risk, completeness)
+ * and returns a structured JuryOutput. The council_brief is always derived from the
+ * confidence score — the LLM value is overridden to ensure deterministic routing.
+ *
+ * Throws if the LLM returns non-JSON or a response that fails schema validation.
+ * Never silently defaults to a passing score.
+ */
+export declare function evaluate(input: JuryInput, deps: JuryDeps): Promise<JuryOutput>;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/jury/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../modules/jury/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAgEjE;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,UAAU,CAAC,CA2DrB"}