@manya-os/council 1.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../../src/analysis/analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAmCzD;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAE5D;;;OAGG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAchC,8DAA8D;IAC9D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIrC,uEAAuE;IACvE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE;IAKrC,yEAAyE;IACzE,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,EAAE;IAKjD,gDAAgD;IAChD,IAAI,IAAI,QAAQ,EAAE;IAIlB,6CAA6C;IAC7C,IAAI,IAAI,MAAM;CAGf"}

package/dist/types/analysis/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @manya-os/council — analysis barrel.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+export { validateAnalysis, AnalysisCollector } from './analysis.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/analysis/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analysis/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/conflict/conflict.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @manya-os/council — conflict detection.
+ *
+ * The {@link ConflictDetector} scans a set of {@link Analysis} objects (grouped
+ * by `problemId`) and detects three kinds of pairwise conflict:
+ *
+ *   1. `opposing_conclusion`  — both analyses have confidence > 0.6 and
+ *      opposite polarities (positive vs negative) inferred from their
+ *      `content` text.
+ *   2. `factual_contradiction` — analyses whose `content` overlaps
+ *      substantially (Jaccard ≥ 0.3) AND have opposite polarities, regardless
+ *      of confidence.
+ *   3. `divergent_reasoning`  — analyses with the SAME polarity but whose
+ *      `reasoning` texts overlap very little (Jaccard < 0.2), suggesting the
+ *      same conclusion was reached via different paths.
+ *
+ * Severity is `high` when 3+ analyses are involved or the confidence gap is
+ * ≥ 0.5; `medium` when the confidence gap is ≥ 0.2; `low` otherwise. Pairwise
+ * conflicts always involve exactly 2 analyses, so the 3+ rule is reserved for
+ * future expansion.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+import type { Analysis, Conflict, ConflictSeverity, ConflictType } from '../types.js';
+/** All valid conflict types. */
+export declare const CONFLICT_TYPES: ReadonlyArray<ConflictType>;
+/** All valid conflict severities, least-to-most severe. */
+export declare const CONFLICT_SEVERITIES: ReadonlyArray<ConflictSeverity>;
+/** Minimum confidence (exclusive) for both analyses in an `opposing_conclusion` conflict. */
+export declare const OPPOSING_CONFIDENCE_THRESHOLD = 0.6;
+/** Minimum content-overlap Jaccard for a `factual_contradiction` conflict. */
+export declare const FACTUAL_OVERLAP_THRESHOLD = 0.3;
+/** Maximum reasoning-overlap Jaccard for a `divergent_reasoning` conflict. */
+export declare const DIVERGENT_REASONING_MAX_OVERLAP = 0.2;
+/** Minimum content-overlap Jaccard for a `divergent_reasoning` conflict. */
+export declare const DIVERGENT_CONTENT_MIN_OVERLAP = 0.1;
+/** Confidence-gap thresholds used to compute severity. */
+export declare const SEVERITY_HIGH_GAP = 0.5;
+export declare const SEVERITY_MEDIUM_GAP = 0.2;
+/**
+ * Computes the severity of a conflict based on the number of analyses involved
+ * and the confidence gap between them.
+ */
+export declare function severityFor(numAnalyses: number, confidenceGap: number): ConflictSeverity;
+/**
+ * Conflict detector. Stateless; safe to reuse across many `detect` calls.
+ *
+ * Usage:
+ * ```ts
+ * const detector = new ConflictDetector();
+ * const conflicts = detector.detect(analyses);
+ * ```
+ */
+export declare class ConflictDetector {
+    /**
+     * Scans `analyses` and returns every detected conflict. Conflicts are
+     * pairwise and tagged by `type`. The returned array is sorted by type then
+     * by the ids of the analyses involved for deterministic output.
+     */
+    detect(analyses: Analysis[]): Conflict[];
+}
+//# sourceMappingURL=conflict.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../../src/conflict/conflict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAItF,gCAAgC;AAChC,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,YAAY,CAEtD,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,gBAAgB,CAE/D,CAAC;AAEF,6FAA6F;AAC7F,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,8EAA8E;AAC9E,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,MAAM,CAAC;AACrC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,gBAAgB,CAIxF;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAC3B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE;CAgGzC"}

package/dist/types/conflict/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @manya-os/council — conflict barrel.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+export { ConflictDetector, severityFor, CONFLICT_TYPES, CONFLICT_SEVERITIES, OPPOSING_CONFIDENCE_THRESHOLD, FACTUAL_OVERLAP_THRESHOLD, DIVERGENT_REASONING_MAX_OVERLAP, DIVERGENT_CONTENT_MIN_OVERLAP, SEVERITY_HIGH_GAP, SEVERITY_MEDIUM_GAP, } from './conflict.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/conflict/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/conflict/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,gBAAgB,EAAE,WAAW,EAC7B,cAAc,EAAE,mBAAmB,EACnC,6BAA6B,EAAE,yBAAyB,EACxD,+BAA+B,EAAE,6BAA6B,EAC9D,iBAAiB,EAAE,mBAAmB,GACvC,MAAM,eAAe,CAAC"}

package/dist/types/consensus/consensus.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @manya-os/council — consensus building.
+ *
+ * The {@link ConsensusBuilder} aggregates a set of analyses (each carrying a
+ * polarity inferred from its `content` text and a `confidence` in `[0, 1]`)
+ * into a {@link Consensus} decision via weighted voting:
+ *
+ *   - Each analysis contributes `specialistWeight × confidence` to its
+ *     polarity's tally.
+ *   - The polarity with the largest tally wins.
+ *   - The weighted support ratio is `winnerTally / totalTally`.
+ *   - When the ratio is `≥ threshold` (default `0.6`), a {@link Consensus} is
+ *     returned; otherwise `null` (no consensus).
+ *
+ * `conflictsResolved` lists the ids of all conflicts pertaining to the
+ * problem; `openIssues` lists high-severity conflicts that remain unresolved.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+import type { Analysis, Conflict, Consensus } from '../types.js';
+/** Default weighted-support threshold for consensus. */
+export declare const DEFAULT_CONSENSUS_THRESHOLD = 0.6;
+/** Options accepted by `ConsensusBuilder.build`. */
+export interface ConsensusBuildOptions {
+    /**
+     * Map of `specialistId → weight`. When a specialist's id is not present,
+     * weight defaults to `1`. When omitted entirely, every specialist gets
+     * weight `1`.
+     */
+    weights?: Record<string, number>;
+    /**
+     * Optional list of analyst ids who recorded a minority opinion. These are
+     * added to `dissentingAnalystIds` (de-duplicated) so that dissent is
+     * reflected even when the analyst's analysis was not strictly opposite in
+     * polarity.
+     */
+    minorityAnalystIds?: string[];
+}
+/**
+ * Consensus builder. Stateless aside from its configured threshold. Safe to
+ * reuse across many `build` calls.
+ *
+ * Usage:
+ * ```ts
+ * const builder = new ConsensusBuilder(0.6);
+ * const consensus = builder.build('p1', analyses, conflicts, {
+ *   weights: { sec: 2, fin: 1 },
+ * });
+ * if (!consensus) console.log('no consensus');
+ * ```
+ */
+export declare class ConsensusBuilder {
+    private readonly threshold;
+    /**
+     * @param threshold Weighted support ratio in `[0, 1]` required to reach
+     * consensus. Defaults to {@link DEFAULT_CONSENSUS_THRESHOLD}.
+     */
+    constructor(threshold?: number);
+    /** Returns the configured threshold. */
+    getThreshold(): number;
+    /**
+     * Builds a {@link Consensus} for `problemId` from `analyses` and any
+     * detected `conflicts`. Returns `null` when:
+     *   - there are no analyses,
+     *   - no analysis has a non-`neutral` polarity,
+     *   - the weighted support ratio of the winning polarity is below the
+     *     configured threshold.
+     */
+    build(problemId: string, analyses: Analysis[], conflicts?: Conflict[], options?: ConsensusBuildOptions): Consensus | null;
+}
+//# sourceMappingURL=consensus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consensus.d.ts","sourceRoot":"","sources":["../../../src/consensus/consensus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIjE,wDAAwD;AACxD,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;OAGG;gBACS,SAAS,GAAE,MAAoC;IAQ3D,wCAAwC;IACxC,YAAY,IAAI,MAAM;IAItB;;;;;;;OAOG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAAE,EACpB,SAAS,GAAE,QAAQ,EAAO,EAC1B,OAAO,GAAE,qBAA0B,GAClC,SAAS,GAAG,IAAI;CAyFpB"}

package/dist/types/consensus/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @manya-os/council — consensus barrel.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+export { ConsensusBuilder, DEFAULT_CONSENSUS_THRESHOLD } from './consensus.js';
+export type { ConsensusBuildOptions } from './consensus.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/consensus/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/consensus/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC/E,YAAY,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/debate/debate.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @manya-os/council — structured debate.
+ *
+ * The {@link DebateFacilitator} opens a debate over a set of conflicts, accepts
+ * debate rounds (each a claim + evidence, optionally rebutting a prior round),
+ * and concludes the debate. Rounds are validated and rebuttals must reference
+ * an existing round id.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+import type { Debate, DebateRound } from '../types.js';
+/** Default maximum number of rounds per debate. */
+export declare const DEFAULT_MAX_DEBATE_ROUNDS = 10;
+/**
+ * Validates a debate round structurally. Throws `DebateError` on invalid
+ * fields. Does NOT check `rebuttalTo` against existing rounds (that requires
+ * debate context).
+ */
+export declare function validateRound(round: DebateRound): void;
+/**
+ * Stateful debate facilitator. Owns a map of debate id → {@link Debate}.
+ *
+ * Usage:
+ * ```ts
+ * const facilitator = new DebateFacilitator();
+ * const debate = facilitator.open('p1', ['c1']);
+ * facilitator.submitRound(debate.id, {
+ *   id: 'r1', analystId: 'sec', claim: 'The proposal is sound.',
+ *   evidence: 'Tests pass and risks are low.',
+ * });
+ * facilitator.conclude(debate.id);
+ * ```
+ */
+export declare class DebateFacilitator {
+    private readonly debates;
+    private readonly maxRounds;
+    private counter;
+    /**
+     * @param maxRounds Maximum rounds per debate. Defaults to
+     * {@link DEFAULT_MAX_DEBATE_ROUNDS}.
+     */
+    constructor(maxRounds?: number);
+    /**
+     * Opens a new debate over `problemId` triggered by the given conflict ids.
+     * Returns the newly created (empty, status `'open'`) debate.
+     */
+    open(problemId: string, conflictIds?: string[]): Debate;
+    /**
+     * Appends `round` to the debate with id `debateId`. Throws `DebateError`
+     * when:
+     *   - the debate does not exist,
+     *   - the debate is already concluded,
+     *   - the round is malformed,
+     *   - the round's `rebuttalTo` does not reference an existing round,
+     *   - a round with the same id already exists in the debate,
+     *   - the maximum number of rounds has been reached.
+     *
+     * Returns the (mutated) debate.
+     */
+    submitRound(debateId: string, round: DebateRound): Debate;
+    /**
+     * Concludes the debate with id `debateId`. Sets `status` to `'concluded'`
+     * and stamps `concludedAt`. Throws `DebateError` if the debate does not
+     * exist or is already concluded. Returns the (mutated) debate.
+     */
+    conclude(debateId: string): Debate;
+    /** Returns the debate with the given id, or `undefined`. */
+    get(debateId: string): Debate | undefined;
+    /** Returns all debates, in opening order. */
+    list(): Debate[];
+    /** Returns the configured maximum number of rounds per debate. */
+    getMaxRounds(): number;
+}
+//# sourceMappingURL=debate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debate.d.ts","sourceRoot":"","sources":["../../../src/debate/debate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGvD,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAqBtD;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,OAAO,CAAK;IAEpB;;;OAGG;gBACS,SAAS,GAAE,MAAkC;IAOzD;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,GAAE,MAAM,EAAO,GAAG,MAAM;IA0B3D;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,MAAM;IA6BzD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAalC,4DAA4D;IAC5D,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzC,6CAA6C;IAC7C,IAAI,IAAI,MAAM,EAAE;IAIhB,kEAAkE;IAClE,YAAY,IAAI,MAAM;CAGvB"}

package/dist/types/debate/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @manya-os/council — debate barrel.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+export { DebateFacilitator, validateRound, DEFAULT_MAX_DEBATE_ROUNDS } from './debate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/debate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/debate/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/errors.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @manya-os/council — typed error hierarchy.
+ *
+ * Every public @manya-os/council API throws a subclass of `CouncilError`. Errors
+ * carry a stable `code` string for programmatic discrimination.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+/** Base class for all @manya-os/council errors. */
+export declare class CouncilError extends Error {
+    readonly code: string;
+    readonly cause?: unknown;
+    constructor(message: string, code?: string, cause?: unknown);
+}
+/** Raised when specialist routing fails or a specialist is malformed. */
+export declare class RoutingError extends CouncilError {
+    constructor(message: string, cause?: unknown);
+}
+/** Raised when an analysis is malformed or cannot be submitted. */
+export declare class AnalysisError extends CouncilError {
+    constructor(message: string, cause?: unknown);
+}
+/** Raised when confidence scoring fails (e.g. invalid weights or inputs). */
+export declare class ScoringError extends CouncilError {
+    constructor(message: string, cause?: unknown);
+}
+/** Raised when conflict detection fails or encounters malformed input. */
+export declare class ConflictError extends CouncilError {
+    constructor(message: string, cause?: unknown);
+}
+/** Raised when a debate cannot be opened, advanced, or concluded. */
+export declare class DebateError extends CouncilError {
+    constructor(message: string, cause?: unknown);
+}
+/** Raised when consensus cannot be built (e.g. invalid threshold). */
+export declare class ConsensusError extends CouncilError {
+    constructor(message: string, cause?: unknown);
+}
+/** Raised when decision synthesis fails (e.g. invalid inputs). */
+export declare class SynthesisError extends CouncilError {
+    constructor(message: string, cause?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,mDAAmD;AACnD,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAyB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAC7B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAO5D;AAED,yEAAyE;AACzE,qBAAa,YAAa,SAAQ,YAAY;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAC7C;AAED,mEAAmE;AACnE,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAC7C;AAED,6EAA6E;AAC7E,qBAAa,YAAa,SAAQ,YAAY;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAC7C;AAED,0EAA0E;AAC1E,qBAAa,aAAc,SAAQ,YAAY;gBACjC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAC7C;AAED,qEAAqE;AACrE,qBAAa,WAAY,SAAQ,YAAY;gBAC/B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAC7C;AAED,sEAAsE;AACtE,qBAAa,cAAe,SAAQ,YAAY;gBAClC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAC7C;AAED,kEAAkE;AAClE,qBAAa,cAAe,SAAQ,YAAY;gBAClC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAC7C"}

package/dist/types/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @manya-os/council — multi-agent consensus engine for the MANYA Intelligence OS.
+ *
+ * Public API surface for @manya-os/council. Everything exported here is part of
+ * the stable, semver-bound public API.
+ *
+ * Capabilities:
+ *   - Specialist routing (`SpecialistRegistry`, `route`, `routeAll`).
+ *   - Independent analysis collection (`AnalysisCollector`).
+ *   - Weighted confidence scoring (`scoreAnalysis`, `aggregateScores`,
+ *     `detectOutliers`).
+ *   - Conflict detection (`ConflictDetector`).
+ *   - Structured debate (`DebateFacilitator`).
+ *   - Minority opinion tracking (`MinorityOpinionTracker`).
+ *   - Consensus building (`ConsensusBuilder`).
+ *   - Review reports (`buildReport`, `serializeReport`, `summarizeReport`).
+ *   - Decision synthesis (`synthesize`, `classifyConsensus`).
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Conceived, directed, and owned by Uviwe Menyiwe (Azura Daemon), founder
+ * of the Manya Hael Foundation.
+ *
+ * Licensed under the Apache License, Version 2.0.
+ */
+export * from './types.js';
+export * from './errors.js';
+export { Logger, LogLevel, ConsoleLogger, SilentLogger, scrubMetadata, shouldScrubField, SCRUBBED_FIELD_NAMES, } from './logging.js';
+export { validateSpecialist, matchScore, route, routeAll, SpecialistRegistry, } from './router/router.js';
+export type { SpecialistMatch } from './router/router.js';
+export { validateAnalysis, AnalysisCollector } from './analysis/analysis.js';
+export { scoreAnalysis, aggregateScores, detectOutliers, DEFAULT_OUTLIER_THRESHOLD, } from './scoring/scoring.js';
+export type { WeightedScore, AggregatedScore } from './scoring/scoring.js';
+export { ConflictDetector, severityFor, CONFLICT_TYPES, CONFLICT_SEVERITIES, OPPOSING_CONFIDENCE_THRESHOLD, FACTUAL_OVERLAP_THRESHOLD, DIVERGENT_REASONING_MAX_OVERLAP, DIVERGENT_CONTENT_MIN_OVERLAP, SEVERITY_HIGH_GAP, SEVERITY_MEDIUM_GAP, } from './conflict/conflict.js';
+export { DebateFacilitator, validateRound, DEFAULT_MAX_DEBATE_ROUNDS } from './debate/debate.js';
+export { validateMinorityOpinion, MinorityOpinionTracker } from './minority/minority.js';
+export { ConsensusBuilder, DEFAULT_CONSENSUS_THRESHOLD } from './consensus/consensus.js';
+export type { ConsensusBuildOptions } from './consensus/consensus.js';
+export { buildReport, serializeReport, summarizeReport } from './reports/reports.js';
+export type { BuildReportInput } from './reports/reports.js';
+export { synthesize, classifyConsensus, DEFAULT_SYNTHESIS_THRESHOLD, STRONG_CONSENSUS_RATIO, } from './synthesizer/synthesizer.js';
+export type { SynthesizeOptions } from './synthesizer/synthesizer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAG5B,OAAO,EACL,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAC7C,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,GACtD,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,GACpE,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG7E,OAAO,EACL,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,yBAAyB,GAC1E,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG3E,OAAO,EACL,gBAAgB,EAAE,WAAW,EAC7B,cAAc,EAAE,mBAAmB,EACnC,6BAA6B,EAAE,yBAAyB,EACxD,+BAA+B,EAAE,6BAA6B,EAC9D,iBAAiB,EAAE,mBAAmB,GACvC,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGjG,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGzF,OAAO,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AACzF,YAAY,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACrF,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,EACL,UAAU,EAAE,iBAAiB,EAC7B,2BAA2B,EAAE,sBAAsB,GACpD,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/types/logging.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @manya-os/council — structured logging (mirrors @manya-os/keyring pattern).
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+/** Logger interface used throughout @manya-os/council. */
+export interface Logger {
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+/** Severity levels supported by the logger. `'silent'` emits nothing. */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/** Field names that are always redacted when scrubbing log metadata. */
+export declare const SCRUBBED_FIELD_NAMES: readonly ["taxId", "secret", "token", "apiKey", "password"];
+/** Returns true when `name` matches a scrubbed field (case-insensitive, suffix-aware). */
+export declare function shouldScrubField(name: string): boolean;
+/** Recursively scrubs sensitive fields from `meta`, returning a safe copy. */
+export declare function scrubMetadata(meta: unknown): unknown;
+/** Logger that writes JSON lines to stdout/stderr. */
+export declare class ConsoleLogger implements Logger {
+    private readonly level;
+    private readonly levelRank;
+    constructor(level?: LogLevel);
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+    private emit;
+}
+/** Logger that discards everything. */
+export declare class SilentLogger implements Logger {
+    debug(): void;
+    info(): void;
+    warn(): void;
+    error(): void;
+}
+//# sourceMappingURL=logging.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0DAA0D;AAC1D,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,yEAAyE;AACzE,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAMtE,wEAAwE;AACxE,eAAO,MAAM,oBAAoB,6DAEvB,CAAC;AAEX,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQtD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAWpD;AAED,sDAAsD;AACtD,qBAAa,aAAc,YAAW,MAAM;IAE9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IADlC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBACN,KAAK,GAAE,QAAiB;IAGrD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IACvD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IACvD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IACxD,OAAO,CAAC,IAAI;CASb;AAED,uCAAuC;AACvC,qBAAa,YAAa,YAAW,MAAM;IACzC,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IACZ,IAAI,IAAI,IAAI;IACZ,KAAK,IAAI,IAAI;CACd"}

package/dist/types/minority/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @manya-os/council — minority opinion barrel.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+export { validateMinorityOpinion, MinorityOpinionTracker } from './minority.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/minority/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/minority/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/minority/minority.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @manya-os/council — minority opinion tracking.
+ *
+ * The {@link MinorityOpinionTracker} is a stateful store for
+ * {@link MinorityOpinion} records. Analysts who disagree with the consensus
+ * can record a minority opinion (with a position, reasoning, and explicit
+ * dissent reason) so that dissent is preserved alongside the decision.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+import type { MinorityOpinion } from '../types.js';
+/**
+ * Validates a minority opinion structurally. Throws `CouncilError` on invalid
+ * fields.
+ */
+export declare function validateMinorityOpinion(opinion: MinorityOpinion): void;
+/**
+ * Stateful minority opinion tracker. Records are indexed by problem id and
+ * analyst id for fast lookup.
+ *
+ * Usage:
+ * ```ts
+ * const tracker = new MinorityOpinionTracker();
+ * tracker.record({
+ *   id: 'mo1', problemId: 'p1', analystId: 'fin',
+ *   position: 'Reject the proposal.', reasoning: 'Cost is too high.',
+ *   dissentReason: 'The consensus ignored the budget impact.',
+ * });
+ * tracker.getForProblem('p1');  // [opinion]
+ * ```
+ */
+export declare class MinorityOpinionTracker {
+    private readonly opinions;
+    private readonly order;
+    private readonly byProblem;
+    private readonly byAnalyst;
+    /**
+     * Validates and stores `opinion`. Throws `CouncilError` when the opinion is
+     * malformed or an opinion with the same id has already been recorded.
+     */
+    record(opinion: MinorityOpinion): this;
+    /** Returns the opinion with the given id, or `undefined`. */
+    get(id: string): MinorityOpinion | undefined;
+    /** Returns all minority opinions for the given problem, in record order. */
+    getForProblem(problemId: string): MinorityOpinion[];
+    /** Returns all minority opinions by the given analyst, in record order. */
+    getByAnalyst(analystId: string): MinorityOpinion[];
+    /** Returns all minority opinions in record order. */
+    list(): MinorityOpinion[];
+    /** Returns the number of opinions stored. */
+    size(): number;
+}
+//# sourceMappingURL=minority.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"minority.d.ts","sourceRoot":"","sources":["../../../src/minority/minority.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAsBtE;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IAEzD;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IActC,6DAA6D;IAC7D,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI5C,4EAA4E;IAC5E,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;IAKnD,2EAA2E;IAC3E,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;IAKlD,qDAAqD;IACrD,IAAI,IAAI,eAAe,EAAE;IAIzB,6CAA6C;IAC7C,IAAI,IAAI,MAAM;CAGf"}

package/dist/types/reports/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @manya-os/council — reports barrel.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+export { buildReport, serializeReport, summarizeReport } from './reports.js';
+export type { BuildReportInput } from './reports.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/reports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/reports/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC7E,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/reports/reports.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @manya-os/council — review reports.
+ *
+ * The reports module aggregates everything the council produced for a single
+ * problem — analyses, conflicts, debates, minority opinions, the consensus
+ * (if any), and recommendations — into a single {@link ReviewReport}. The
+ * report can be serialized to JSON (`serializeReport`) or summarized into a
+ * single human-readable paragraph (`summarizeReport`).
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+import type { Analysis, Conflict, Consensus, Debate, MinorityOpinion, ReviewReport } from '../types.js';
+/** Inputs to `buildReport`. */
+export interface BuildReportInput {
+    /** The problem id the report covers. */
+    problemId: string;
+    /** All analyses included in the review. */
+    analyses: Analysis[];
+    /** All conflicts detected. Defaults to `[]`. */
+    conflicts?: Conflict[];
+    /** All debates held. Defaults to `[]`. */
+    debates?: Debate[];
+    /** All minority opinions recorded. Defaults to `[]`. */
+    minorityOpinions?: MinorityOpinion[];
+    /** The consensus reached, if any. Defaults to `null`. */
+    consensus?: Consensus | null;
+    /** Actionable recommendations. Defaults to `[]`. */
+    recommendations?: string[];
+    /** Optional explicit report id. Auto-generated when omitted. */
+    reportId?: string;
+    /** Optional explicit generation timestamp (ISO 8601). Defaults to now. */
+    generatedAt?: string;
+}
+/**
+ * Builds a {@link ReviewReport} from the given inputs. Defensively copies all
+ * array inputs and computes a short summary.
+ *
+ * Throws `CouncilError` when `problemId` is missing or `analyses` is not an
+ * array.
+ */
+export declare function buildReport(input: BuildReportInput): ReviewReport;
+/**
+ * Serializes a {@link ReviewReport} to a pretty-printed JSON string. Throws
+ * `CouncilError` when serialization fails (e.g. circular references).
+ */
+export declare function serializeReport(report: ReviewReport): string;
+/**
+ * Summarizes a {@link ReviewReport} into a single human-readable paragraph.
+ */
+export declare function summarizeReport(report: ReviewReport): string;
+//# sourceMappingURL=reports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reports.d.ts","sourceRoot":"","sources":["../../../src/reports/reports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,YAAY,EACrE,MAAM,aAAa,CAAC;AAGrB,+BAA+B;AAC/B,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,gDAAgD;IAChD,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;IACrC,yDAAyD;IACzD,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAkCjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAS5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAuB5D"}

package/dist/types/router/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @manya-os/council — router barrel.
+ *
+ * Copyright 2024 Manya Hael Foundation. All rights reserved.
+ * Licensed under the Apache License, Version 2.0.
+ */
+export { validateSpecialist, matchScore, route, routeAll, SpecialistRegistry, } from './router.js';
+export type { SpecialistMatch } from './router.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,kBAAkB,GACpE,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}