magi-ai 0.1.0

package/dist/src/parsers/unstructured-parser.js

@@ -0,0 +1,122 @@
+const VOTE_PATTERNS = [
+    // --- Negation + approve → REJECT (core bug fix) ---
+    { id: 'N1', regex: /\b(?:don'?t|do\s+not|cannot|can'?t|won'?t|will\s+not|would\s+not|wouldn'?t|never)\s+approve\b/i, weight: 3.0, target: 'REJECT' },
+    { id: 'N2', regex: /\bnot\s+approved?\b/i, weight: 3.0, target: 'REJECT' },
+    { id: 'N3', regex: /\bdisapprov(?:e[ds]?|al|ing)\b/i, weight: 2.5, target: 'REJECT' },
+    { id: 'N4', regex: /\bunapproved?\b/i, weight: 2.0, target: 'REJECT' },
+    // --- Negation + reject → APPROVE ---
+    { id: 'N5', regex: /\b(?:don'?t|do\s+not|cannot|can'?t|won'?t|will\s+not|would\s+not|wouldn'?t|never)\s+reject\b/i, weight: 3.0, target: 'APPROVE' },
+    { id: 'N6', regex: /\bnot\s+rejected?\b/i, weight: 2.5, target: 'APPROVE' },
+    // --- Instruction echo guard ---
+    { id: 'G1', regex: /\b(?:APPROVE|REJECT|ABSTAIN)\s*(?:\/|\sor\s)\s*(?:APPROVE|REJECT|ABSTAIN)\b/i, weight: 0.0, target: null },
+    // --- Explicit vote (highest priority) ---
+    { id: 'E1', regex: /\bmy\s+vote\s*(?:is\s*:?\s*|:\s*)approve\b/i, weight: 4.0, target: 'APPROVE' },
+    { id: 'E2', regex: /\bmy\s+vote\s*(?:is\s*:?\s*|:\s*)reject\b/i, weight: 4.0, target: 'REJECT' },
+    { id: 'E3', regex: /\bmy\s+vote\s*(?:is\s*:?\s*|:\s*)abstain\b/i, weight: 4.0, target: 'ABSTAIN' },
+    { id: 'E4', regex: /\bvote\s*:\s*approve\b/i, weight: 3.5, target: 'APPROVE' },
+    { id: 'E5', regex: /\bvote\s*:\s*reject\b/i, weight: 3.5, target: 'REJECT' },
+    { id: 'E6', regex: /\bvote\s*:\s*abstain\b/i, weight: 3.5, target: 'ABSTAIN' },
+    // --- Emphasis ---
+    { id: 'S1', regex: /\bstrongly\s+approve\b/i, weight: 3.0, target: 'APPROVE' },
+    { id: 'S2', regex: /\bstrongly\s+reject\b/i, weight: 3.0, target: 'REJECT' },
+    // --- Standard keywords ---
+    { id: 'K1', regex: /\bapprove[ds]?\b/i, weight: 1.5, target: 'APPROVE' },
+    { id: 'K2', regex: /\breject(?:ed|s|ing)?\b/i, weight: 1.5, target: 'REJECT' },
+    { id: 'K3', regex: /\babstain(?:ed|s|ing)?\b/i, weight: 2.0, target: 'ABSTAIN' },
+    // --- Informal expressions ---
+    { id: 'I1', regex: /\bLGTM\b/, weight: 2.0, target: 'APPROVE' },
+    { id: 'I2', regex: /\bship\s+it\b/i, weight: 1.5, target: 'APPROVE' },
+    { id: 'I3', regex: /\bneeds?\s+(?:major\s+)?(?:changes?|rework|revision)\b/i, weight: 1.5, target: 'REJECT' },
+    { id: 'I4', regex: /\bdo\s+not\s+(?:merge|ship|deploy)\b/i, weight: 2.0, target: 'REJECT' },
+    { id: 'I5', regex: /\bneed\s+more\s+(?:info|information|context|discussion)\b/i, weight: 1.5, target: 'ABSTAIN' },
+];
+const CONFIDENCE_PATTERNS = [
+    { id: 'C1', regex: /\bconfidence\s*[:=]\s*(0(?:\.\d+)?|1(?:\.0+)?)\b/i, extract: (m) => parseFloat(m[1]) },
+    { id: 'C2', regex: /\b(\d{1,3})%\s*confident\b/i, extract: (m) => parseInt(m[1], 10) / 100 },
+    { id: 'C3', regex: /\bconfidence\s*[:=]?\s*(\d{1,3})%/i, extract: (m) => parseInt(m[1], 10) / 100 },
+    { id: 'C4', regex: /\b(?:very|highly|extremely)\s+confident\b/i, extract: () => 0.9 },
+    { id: 'C5', regex: /\b(?:fairly|reasonably|quite)\s+confident\b/i, extract: () => 0.7 },
+    { id: 'C6', regex: /\b(?:somewhat|moderately)\s+confident\b/i, extract: () => 0.5 },
+    { id: 'C7', regex: /\bnot\s+(?:very\s+)?confident\b/i, extract: () => 0.25 },
+];
+// ============================================================
+// Scoring engine
+// ============================================================
+export function scoreText(raw) {
+    let approveScore = 0;
+    let rejectScore = 0;
+    let abstainScore = 0;
+    const matchedPatterns = [];
+    // Evaluate all 22 patterns (each counts once)
+    for (const pattern of VOTE_PATTERNS) {
+        if (pattern.regex.test(raw)) {
+            matchedPatterns.push(pattern.id);
+            if (pattern.target === 'APPROVE')
+                approveScore += pattern.weight;
+            else if (pattern.target === 'REJECT')
+                rejectScore += pattern.weight;
+            else if (pattern.target === 'ABSTAIN')
+                abstainScore += pattern.weight;
+            // target === null (G1): record only, no score
+        }
+    }
+    // Determine vote
+    const maxScore = Math.max(approveScore, rejectScore, abstainScore);
+    let vote;
+    if (maxScore === 0) {
+        vote = 'ABSTAIN';
+    }
+    else {
+        const atMax = [
+            approveScore === maxScore,
+            rejectScore === maxScore,
+            abstainScore === maxScore,
+        ].filter(Boolean).length;
+        if (atMax > 1) {
+            vote = 'ABSTAIN'; // tie → safe side
+        }
+        else if (approveScore === maxScore) {
+            vote = 'APPROVE';
+        }
+        else if (rejectScore === maxScore) {
+            vote = 'REJECT';
+        }
+        else {
+            vote = 'ABSTAIN';
+        }
+    }
+    // Extract confidence from text
+    let extractedConfidence = null;
+    for (const cp of CONFIDENCE_PATTERNS) {
+        const match = raw.match(cp.regex);
+        if (match) {
+            extractedConfidence = Math.max(0, Math.min(1, cp.extract(match)));
+            break; // first match wins
+        }
+    }
+    // Determine final confidence
+    let confidence;
+    if (extractedConfidence !== null) {
+        confidence = extractedConfidence;
+    }
+    else if (maxScore === 0) {
+        confidence = 0.1;
+    }
+    else {
+        const scores = [approveScore, rejectScore, abstainScore].sort((a, b) => b - a);
+        const scoreDiff = scores[0] - scores[1];
+        const scoreRatio = scoreDiff / (scores[0] + 0.001);
+        confidence = Math.min(0.7, 0.2 + scoreRatio * 0.5);
+    }
+    return {
+        vote,
+        confidence,
+        _debug: {
+            approveScore,
+            rejectScore,
+            abstainScore,
+            extractedConfidence,
+            matchedPatterns,
+        },
+    };
+}

package/dist/src/pipelines/architecture.d.ts

@@ -0,0 +1,10 @@
+import { CustomPipeline } from './custom.js';
+import type { TaskType } from '../types/core.js';
+/**
+ * Architecture Decision pipeline.
+ * Inherits from CustomPipeline with adjusted defaults.
+ */
+export declare class ArchitecturePipeline extends CustomPipeline {
+    readonly taskType: TaskType;
+    readonly name = "Architecture Decision";
+}

package/dist/src/pipelines/architecture.js

@@ -0,0 +1,9 @@
+import { CustomPipeline } from './custom.js';
+/**
+ * Architecture Decision pipeline.
+ * Inherits from CustomPipeline with adjusted defaults.
+ */
+export class ArchitecturePipeline extends CustomPipeline {
+    taskType = 'architecture-decision';
+    name = 'Architecture Decision';
+}

package/dist/src/pipelines/bug-analysis.d.ts

@@ -0,0 +1,9 @@
+import { CustomPipeline } from './custom.js';
+import type { TaskType } from '../types/core.js';
+/**
+ * Bug Analysis pipeline.
+ */
+export declare class BugAnalysisPipeline extends CustomPipeline {
+    readonly taskType: TaskType;
+    readonly name = "Bug Analysis";
+}

package/dist/src/pipelines/bug-analysis.js

@@ -0,0 +1,8 @@
+import { CustomPipeline } from './custom.js';
+/**
+ * Bug Analysis pipeline.
+ */
+export class BugAnalysisPipeline extends CustomPipeline {
+    taskType = 'bug-analysis';
+    name = 'Bug Analysis';
+}

package/dist/src/pipelines/code-review.d.ts

@@ -0,0 +1,10 @@
+import type { IPipeline, PipelineConfig } from '../types/pipeline.js';
+import type { MagiTask, MagiOpinion, DeliberationPhase, MagiUnit } from '../types/core.js';
+export declare class CodeReviewPipeline implements IPipeline {
+    readonly taskType: "code-review";
+    readonly name = "Code Review";
+    readonly defaultConfig: PipelineConfig;
+    buildSystemPrompt(_task: MagiTask, _unit: MagiUnit, _phase: DeliberationPhase): string;
+    buildUserPrompt(_task: MagiTask, _phase: DeliberationPhase, _previousOpinions?: MagiOpinion[]): string;
+    parseOpinion(raw: string, structured: Record<string, unknown> | null, unit: MagiUnit, _phase: DeliberationPhase): Omit<MagiOpinion, 'rawOutput' | 'meta'>;
+}

package/dist/src/pipelines/code-review.js

@@ -0,0 +1,30 @@
+import { parseOpinionFromResponse } from '../parsers/opinion-schema.js';
+export class CodeReviewPipeline {
+    taskType = 'code-review';
+    name = 'Code Review';
+    defaultConfig = {
+        phases: ['initial-opinion', 'cross-examination', 'final-vote'],
+        maxRounds: 3,
+        parallelInitialOpinions: true,
+        earlyConsensusExit: true,
+        earlyExitThresholds: { unanimous: 0.6, majority: 0.8 },
+        consensus: {
+            minConfidenceThreshold: 0.3,
+            useWeightedVoting: false,
+            deadlockStrategy: 'melchior-tiebreak',
+            quorum: 2,
+        },
+        phaseTimeoutMs: 300_000,
+        adapterTimeoutMs: 120_000,
+        deliberationTimeoutMs: 1_800_000,
+    };
+    buildSystemPrompt(_task, _unit, _phase) {
+        return '';
+    }
+    buildUserPrompt(_task, _phase, _previousOpinions) {
+        return '';
+    }
+    parseOpinion(raw, structured, unit, _phase) {
+        return parseOpinionFromResponse(raw, structured, unit);
+    }
+}

package/dist/src/pipelines/custom.d.ts

@@ -0,0 +1,14 @@
+import type { IPipeline, PipelineConfig } from '../types/pipeline.js';
+import type { MagiOpinion, DeliberationPhase, MagiUnit, TaskType } from '../types/core.js';
+/**
+ * Generic pipeline for custom deliberation tasks.
+ * Works for any task type that doesn't have a specialized pipeline.
+ */
+export declare class CustomPipeline implements IPipeline {
+    readonly taskType: TaskType;
+    readonly name: string;
+    readonly defaultConfig: PipelineConfig;
+    buildSystemPrompt(): string;
+    buildUserPrompt(): string;
+    parseOpinion(raw: string, structured: Record<string, unknown> | null, unit: MagiUnit, _phase: DeliberationPhase): Omit<MagiOpinion, 'rawOutput' | 'meta'>;
+}

package/dist/src/pipelines/custom.js

@@ -0,0 +1,29 @@
+import { parseOpinionFromResponse } from '../parsers/opinion-schema.js';
+/**
+ * Generic pipeline for custom deliberation tasks.
+ * Works for any task type that doesn't have a specialized pipeline.
+ */
+export class CustomPipeline {
+    taskType = 'custom';
+    name = 'Custom Deliberation';
+    defaultConfig = {
+        phases: ['initial-opinion', 'cross-examination', 'final-vote'],
+        maxRounds: 3,
+        parallelInitialOpinions: true,
+        earlyConsensusExit: true,
+        consensus: {
+            minConfidenceThreshold: 0.3,
+            useWeightedVoting: false,
+            deadlockStrategy: 'melchior-tiebreak',
+            quorum: 2,
+        },
+        phaseTimeoutMs: 300_000,
+        adapterTimeoutMs: 120_000,
+        deliberationTimeoutMs: 1_800_000,
+    };
+    buildSystemPrompt() { return ''; }
+    buildUserPrompt() { return ''; }
+    parseOpinion(raw, structured, unit, _phase) {
+        return parseOpinionFromResponse(raw, structured, unit);
+    }
+}

package/dist/src/pipelines/registry.d.ts

@@ -0,0 +1,9 @@
+import type { IPipeline } from '../types/pipeline.js';
+import type { TaskType } from '../types/core.js';
+export declare class PipelineRegistry {
+    private pipelines;
+    register(pipeline: IPipeline): void;
+    get(taskType: TaskType): IPipeline;
+    has(taskType: TaskType): boolean;
+    listTypes(): TaskType[];
+}

package/dist/src/pipelines/registry.js

@@ -0,0 +1,20 @@
+import { PipelineNotFoundError } from '../utils/errors.js';
+export class PipelineRegistry {
+    pipelines = new Map();
+    register(pipeline) {
+        this.pipelines.set(pipeline.taskType, pipeline);
+    }
+    get(taskType) {
+        const pipeline = this.pipelines.get(taskType);
+        if (!pipeline) {
+            throw new PipelineNotFoundError(taskType);
+        }
+        return pipeline;
+    }
+    has(taskType) {
+        return this.pipelines.has(taskType);
+    }
+    listTypes() {
+        return Array.from(this.pipelines.keys());
+    }
+}

package/dist/src/prompts/personas.d.ts

@@ -0,0 +1,6 @@
+import type { MagiUnit, DeliberationPhase, MagiUnitDefinition } from '../types/core.js';
+/**
+ * Build the system prompt (persona) for a MAGI unit.
+ * Supports both built-in units and custom N-body units.
+ */
+export declare function buildPersonaPrompt(unit: MagiUnit, phase: DeliberationPhase, definition?: MagiUnitDefinition): string;

package/dist/src/prompts/personas.js

@@ -0,0 +1,44 @@
+import { MAGI_PERSONAS, BUILTIN_UNITS } from '../types/core.js';
+function isBuiltinUnit(unit) {
+    return unit in BUILTIN_UNITS;
+}
+/**
+ * Build the system prompt (persona) for a MAGI unit.
+ * Supports both built-in units and custom N-body units.
+ */
+export function buildPersonaPrompt(unit, phase, definition) {
+    let name;
+    let role;
+    let focus;
+    if (definition) {
+        name = definition.displayName;
+        role = definition.role;
+        focus = definition.focus;
+    }
+    else if (isBuiltinUnit(unit)) {
+        const persona = MAGI_PERSONAS[unit];
+        name = persona.name;
+        role = persona.role;
+        focus = persona.focus;
+    }
+    else {
+        // Generic persona for custom units
+        name = unit;
+        role = 'Analyst';
+        focus = 'Comprehensive analysis from your unique perspective';
+    }
+    const unitCount = 'multiple';
+    const base = `You are ${name}, one of ${unitCount} MAGI supercomputers deliberating on this matter.
+Your role: ${role}
+Your focus: ${focus}
+
+You are part of the MAGI System, inspired by the supercomputers from Neon Genesis Evangelion.
+Multiple independent AI systems analyze each problem from different angles
+and reach consensus through deliberation.`;
+    const phaseInstructions = {
+        'initial-opinion': `\n\nThis is the INITIAL OPINION phase. Form your own independent opinion without knowledge of what the other MAGI units think. Be thorough and decisive.`,
+        'cross-examination': `\n\nThis is the CROSS-EXAMINATION phase. You have seen the other MAGI units' opinions. Review their reasoning critically. Identify points of agreement and disagreement. Challenge weak arguments. Acknowledge strong points you may have missed. You may update your vote if persuaded.`,
+        'final-vote': `\n\nThis is the FINAL VOTE phase. You have seen all previous discussion. Cast your definitive vote with full awareness of all perspectives. Be decisive. This is your final position.`,
+    };
+    return base + phaseInstructions[phase];
+}

package/dist/src/prompts/schemas.d.ts

@@ -0,0 +1,4 @@
+/**
+ * JSON output instruction appended to prompts for CLIs that don't support --json-schema.
+ */
+export declare const JSON_OUTPUT_INSTRUCTION = "\n\nYou MUST respond with ONLY a valid JSON object in the following exact format.\nNo markdown code blocks. No explanation before or after. Just pure JSON:\n\n{\n  \"vote\": \"APPROVE\",\n  \"confidence\": 0.72,\n  \"reasoning\": \"Your detailed reasoning here\",\n  \"keyPoints\": [\"Key point 1\", \"Key point 2\"],\n  \"suggestions\": [\"Optional suggestion 1\"]\n}\n\nNote: \"confidence\" should reflect your genuine certainty (0.45 = uncertain, 0.72 = moderate, 0.91 = highly confident). Do not default to any single value.\n\nRules:\n- \"vote\" must be exactly one of: \"APPROVE\", \"REJECT\", \"ABSTAIN\"\n- \"confidence\" must be a number between 0.0 and 1.0\n- \"reasoning\" must be a detailed string explaining your vote\n- \"keyPoints\" must be an array of strings\n- \"suggestions\" is optional, array of strings";

package/dist/src/prompts/schemas.js

@@ -0,0 +1,24 @@
+/**
+ * JSON output instruction appended to prompts for CLIs that don't support --json-schema.
+ */
+export const JSON_OUTPUT_INSTRUCTION = `
+
+You MUST respond with ONLY a valid JSON object in the following exact format.
+No markdown code blocks. No explanation before or after. Just pure JSON:
+
+{
+  "vote": "APPROVE",
+  "confidence": 0.72,
+  "reasoning": "Your detailed reasoning here",
+  "keyPoints": ["Key point 1", "Key point 2"],
+  "suggestions": ["Optional suggestion 1"]
+}
+
+Note: "confidence" should reflect your genuine certainty (0.45 = uncertain, 0.72 = moderate, 0.91 = highly confident). Do not default to any single value.
+
+Rules:
+- "vote" must be exactly one of: "APPROVE", "REJECT", "ABSTAIN"
+- "confidence" must be a number between 0.0 and 1.0
+- "reasoning" must be a detailed string explaining your vote
+- "keyPoints" must be an array of strings
+- "suggestions" is optional, array of strings`;

package/dist/src/prompts/templates.d.ts

@@ -0,0 +1,6 @@
+import type { MagiTask, MagiOpinion, DeliberationPhase, MagiUnit } from '../types/core.js';
+import type { DeliberationRound } from '../types/core.js';
+/**
+ * Build the user prompt for a specific deliberation phase.
+ */
+export declare function buildUserPrompt(task: MagiTask, _unit: MagiUnit, phase: DeliberationPhase, previousRounds: DeliberationRound[], otherOpinions?: MagiOpinion[], objectiveSummary?: string): string;

package/dist/src/prompts/templates.js

@@ -0,0 +1,91 @@
+import { serializeOpinionCompact, serializeRoundsCompact } from '../context/serializer.js';
+import { quoteForEmbedding } from '../utils/sanitize.js';
+/**
+ * Build the user prompt for a specific deliberation phase.
+ */
+export function buildUserPrompt(task, _unit, phase, previousRounds, otherOpinions, objectiveSummary) {
+    const artifactsSection = buildArtifactsSection(task);
+    switch (phase) {
+        case 'initial-opinion':
+            return buildInitialOpinionPrompt(task, artifactsSection);
+        case 'cross-examination':
+            return buildCrossExaminationPrompt(task, artifactsSection, otherOpinions ?? [], objectiveSummary);
+        case 'final-vote':
+            return buildFinalVotePrompt(task, previousRounds, objectiveSummary);
+    }
+}
+function buildInitialOpinionPrompt(task, artifacts) {
+    return `## Task: ${task.title}
+Type: ${task.type}
+
+## Description
+${task.description}
+${artifacts}
+${task.context ? `\n## Additional Context\n${task.context}` : ''}
+
+## Instructions
+Analyze this ${task.type} independently. Form your own opinion.
+Provide your vote (APPROVE/REJECT/ABSTAIN), confidence level, detailed reasoning, and key points.`;
+}
+function buildCrossExaminationPrompt(task, artifacts, otherOpinions, objectiveSummary) {
+    const othersText = otherOpinions
+        .map((o) => {
+        const serialized = serializeOpinionCompact(o);
+        return quoteForEmbedding(serialized, `${o.unit} Opinion`);
+    })
+        .join('\n\n');
+    const objectiveSection = objectiveSummary
+        ? `\n## Objective Analysis Results\n${objectiveSummary}\n`
+        : '';
+    return `## Task: ${task.title}
+Type: ${task.type}
+
+## Description
+${task.description}
+${artifacts}
+
+## Other MAGI Units' Opinions
+
+${othersText}
+${objectiveSection}
+## Instructions
+Review the other units' opinions critically. Your role is to stress-test their reasoning.
+
+REQUIRED:
+1. For EACH other unit's opinion, identify at least ONE specific weakness, unstated assumption, or missing consideration
+2. Evaluate whether their key points are supported by evidence or merely asserted
+3. If you agree with their conclusion, provide your OWN independent reasoning — do not simply defer
+4. If any unit voted differently from you, engage directly with their strongest argument
+
+You MAY update your vote and confidence if genuinely persuaded, but explain what specifically changed your mind.
+Do NOT rubber-stamp or agree without substantive independent analysis.
+
+Provide your updated vote, confidence, reasoning, and key points.`;
+}
+function buildFinalVotePrompt(task, previousRounds, objectiveSummary) {
+    const history = serializeRoundsCompact(previousRounds);
+    const objectiveSection = objectiveSummary
+        ? `\n## Objective Analysis Results\n${objectiveSummary}\n`
+        : '';
+    return `## Task: ${task.title}
+Type: ${task.type}
+
+## Full Deliberation History
+${history}
+${objectiveSection}
+## Instructions
+This is the FINAL VOTE. You have seen all perspectives and arguments.
+Cast your definitive vote with full awareness of the deliberation.
+Be decisive. This is your final position.`;
+}
+function buildArtifactsSection(task) {
+    if (!task.artifacts || task.artifacts.length === 0)
+        return '';
+    const sections = task.artifacts.map((a) => {
+        const label = a.label ?? a.path ?? 'Artifact';
+        const lang = a.language ?? '';
+        const content = a.content ?? '(content not provided)';
+        return `### ${label}\n\`\`\`${lang}\n${content}\n\`\`\``;
+    });
+    return `\n## Artifacts\n${sections.join('\n\n')}`;
+}

package/dist/src/repl/accessibility.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Accessibility utilities for MAGI REPL.
+ *
+ * Provides centralized helpers for:
+ * - NO_COLOR compliance (no-color.org)
+ * - Animation skip detection (CI, non-TTY, REDUCE_MOTION)
+ * - Unicode vote/decision symbols with text fallbacks
+ */
+import type { Vote } from '../types/core.js';
+import type { ConsensusDecision } from '../types/consensus.js';
+/**
+ * Whether animations should be skipped.
+ * True when: non-TTY, CI, MAGI_NO_ANIMATION=1, or REDUCE_MOTION=1.
+ */
+export declare function shouldSkipAnimation(): boolean;
+/**
+ * Returns a symbol for a vote: ✓ APPROVE, ✗ REJECT, ― ABSTAIN.
+ */
+export declare function voteSymbol(vote: Vote | string): string;
+/**
+ * Returns a symbol for a consensus decision.
+ */
+export declare function decisionSymbol(decision: ConsensusDecision | string): string;

package/dist/src/repl/accessibility.js

@@ -0,0 +1,46 @@
+/**
+ * Accessibility utilities for MAGI REPL.
+ *
+ * Provides centralized helpers for:
+ * - NO_COLOR compliance (no-color.org)
+ * - Animation skip detection (CI, non-TTY, REDUCE_MOTION)
+ * - Unicode vote/decision symbols with text fallbacks
+ */
+/**
+ * Whether animations should be skipped.
+ * True when: non-TTY, CI, MAGI_NO_ANIMATION=1, or REDUCE_MOTION=1.
+ */
+export function shouldSkipAnimation() {
+    if (!process.stdout.isTTY)
+        return true;
+    if (process.env.CI === 'true')
+        return true;
+    if (process.env.MAGI_NO_ANIMATION === '1')
+        return true;
+    if (process.env.REDUCE_MOTION === '1')
+        return true;
+    return false;
+}
+/**
+ * Returns a symbol for a vote: ✓ APPROVE, ✗ REJECT, ― ABSTAIN.
+ */
+export function voteSymbol(vote) {
+    switch (vote) {
+        case 'APPROVE': return '✓';
+        case 'REJECT': return '✗';
+        case 'ABSTAIN': return '―';
+        default: return '?';
+    }
+}
+/**
+ * Returns a symbol for a consensus decision.
+ */
+export function decisionSymbol(decision) {
+    if (decision.endsWith('_APPROVE'))
+        return '✓';
+    if (decision.endsWith('_REJECT'))
+        return '✗';
+    if (decision === 'DEADLOCK' || decision === 'INSUFFICIENT')
+        return '⚠';
+    return '?';
+}

package/dist/src/repl/banner.d.ts

@@ -0,0 +1,4 @@
+/**
+ * NERV-themed welcome banner for MAGI REPL.
+ */
+export declare function printBanner(): void;

package/dist/src/repl/banner.js

@@ -0,0 +1,28 @@
+/**
+ * NERV-themed welcome banner for MAGI REPL.
+ */
+import chalk from 'chalk';
+import { EVA_PALETTE } from '../tui/colors.js';
+import { centerVisible, frameLines, getResponsiveBoxWidth, truncateVisible, wrapDisplayText } from './display-utils.js';
+const { frame, textPrimary, abstain } = EVA_PALETTE;
+const FRAME = chalk.rgb(frame.r, frame.g, frame.b);
+const TEXT = chalk.rgb(textPrimary.r, textPrimary.g, textPrimary.b);
+const DIM = chalk.rgb(abstain.r, abstain.g, abstain.b);
+export function printBanner() {
+    const width = getResponsiveBoxWidth(44, 24);
+    const innerWidth = Math.max(1, width - 4);
+    const title = width >= 32 ? 'M A G I  S Y S T E M' : 'MAGI SYSTEM';
+    const subtitle = width >= 32 ? 'Interactive Session Mode' : 'REPL READY';
+    const unitStatus = truncateVisible('MELCHIOR-1 / BALTHASAR-2 / CASPER-3 ONLINE', innerWidth);
+    const helpLines = wrapDisplayText('Type a question to deliberate. /help for commands.', innerWidth);
+    console.log('');
+    for (const line of frameLines([centerVisible(title, innerWidth), centerVisible(subtitle, innerWidth)], { width, borderColor: (text) => FRAME.bold(text) })) {
+        console.log(line);
+    }
+    console.log('');
+    console.log(TEXT(`  ${unitStatus}`));
+    for (const line of helpLines) {
+        console.log(DIM(`  ${line}`));
+    }
+    console.log('');
+}

package/dist/src/repl/boot-animation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * NERV-style boot animation for MAGI REPL.
+ *
+ * Displays a typewriter-style boot sequence (0.8-1.2s total).
+ * Skips on: non-TTY, CI, MAGI_NO_ANIMATION=1, or any keypress.
+ * Does NOT use alt screen — output stays in normal scrollback.
+ */
+export interface BootAnimationOptions {
+    write: (s: string) => void;
+    skipCondition?: boolean;
+    delayFn?: (ms: number) => Promise<void>;
+}
+export declare function runReplBoot(options: BootAnimationOptions): Promise<void>;