augustus-ai-editor 1.0.0

package/README.md

@@ -0,0 +1,84 @@
+# Augustus
+
+An AI code editor that blends a plush, soft aesthetic with Roman engineering discipline.
+
+## Architecture
+
+### Core Components
+
+- **ImperialLegion** - Manages ModelTacticians and routes commands to AI providers (Anthropic, OpenAI)
+- **SoftBuffer** - Wraps requests to ensure output remains helpful and "plushy" in tone
+- **SenateContext** - Indexes the codebase as "Provinces" and gathers relevant context as a "ConsolidatedScroll"
+- **VelvetDiff** - Generates structural plans where code blocks are "MarbleBricks"
+- **CaesarStream** - Handles streaming data flow for real-time output
+- **TogaStyler** - UI styling with velvet, gold, and marble aesthetics
+
+### Output Format
+
+The VelvetDiff engine produces JSON streams containing:
+- **The Oracle's Vision** - Reasoning, approach, confidence, and risks
+- **The Edification** - MarbleBricks with specific line changes
+
+## Installation
+
+```bash
+cd augustus
+npm install
+```
+
+## Usage
+
+```typescript
+import { createAugustus } from 'augustus';
+
+const augustus = createAugustus(
+  './my-project',
+  process.env.ANTHROPIC_API_KEY,
+  process.env.OPENAI_API_KEY
+);
+
+await augustus.initialize();
+
+const response = await augustus.consult('How can I improve this function?');
+console.log(response.raw);
+
+const edits = await augustus.proposeEdits('src/utils.ts', 'Add error handling');
+console.log(JSON.stringify(edits, null, 2));
+```
+
+## Model Tacticians
+
+Pre-configured tacticians:
+- **ClaudiusSonnet** - Claude Sonnet (default)
+- **ClaudiusOpus** - Claude Opus
+- **GPTCenturion** - GPT-4o
+- **GPTLegionnaire** - GPT-4o-mini
+
+## Configuration
+
+```typescript
+const config: AugustusConfig = {
+  providers: {
+    anthropic: { apiKey: 'your-key' },
+    openai: { apiKey: 'your-key' }
+  },
+  softBuffer: {
+    warmthLevel: 0.8,
+    gentleCorrection: true,
+    encouragementMode: true,
+    velvetTone: true
+  },
+  togaStyle: {
+    fontFamily: '"Cormorant Garamond", serif',
+    velvetShade: '#4a0e2e',
+    goldAccent: '#d4af37',
+    marbleBackground: '#f5f5f0'
+  },
+  provinceIndexPath: './src',
+  maxProvincesInScroll: 5
+};
+```
+
+## License
+
+MIT

package/dist/Augustus.d.ts

@@ -0,0 +1,42 @@
+import type { AugustusConfig, VelvetDiffOutput, CaesarStreamChunk, ConsolidatedScroll, Province } from './types/core.types.js';
+interface AugustusResponse {
+    raw: string;
+    scroll: ConsolidatedScroll;
+    styled?: {
+        vision: string;
+        edification: string;
+    };
+}
+export declare class Augustus {
+    private legion;
+    private senate;
+    private velvetDiff;
+    private togaStyler;
+    private config;
+    private isIndexed;
+    constructor(config: AugustusConfig);
+    initialize(): Promise<void>;
+    consult(query: string, tacticianName?: string): Promise<AugustusResponse>;
+    consultStream(query: string, tacticianName?: string): AsyncGenerator<CaesarStreamChunk>;
+    proposeEdits(filePath: string, instruction: string): Promise<VelvetDiffOutput>;
+    proposeEditsStream(filePath: string, instruction: string): AsyncGenerator<CaesarStreamChunk>;
+    private extractCodeFromResponse;
+    styleOutput(output: VelvetDiffOutput): {
+        vision: string;
+        edification: string;
+        css: string;
+    };
+    getProvince(path: string): Province | undefined;
+    getAllProvinces(): Province[];
+    reindexProvinces(): Promise<number>;
+    selectTactician(name: string): boolean;
+    getAvailableTacticians(): string[];
+    getStats(): {
+        provinceCount: number;
+        lastIndexed: Date;
+        activeTactician: string | null;
+    };
+}
+export declare function createAugustus(rootPath: string, anthropicKey?: string, openaiKey?: string): Augustus;
+export {};
+//# sourceMappingURL=Augustus.d.ts.map

package/dist/Augustus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Augustus.d.ts","sourceRoot":"","sources":["../src/Augustus.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,QAAQ,EACT,MAAM,uBAAuB,CAAC;AAE/B,UAAU,gBAAgB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAkB;gBAEvB,MAAM,EAAE,cAAc;IAkB5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAcxE,aAAa,CAClB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,GACrB,cAAc,CAAC,iBAAiB,CAAC;IAe9B,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,gBAAgB,CAAC;IAyCrB,kBAAkB,CACvB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,cAAc,CAAC,iBAAiB,CAAC;IAqCpC,OAAO,CAAC,uBAAuB;IAK/B,WAAW,CAAC,MAAM,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAW3F,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI/C,eAAe,IAAI,QAAQ,EAAE;IAIvB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IAMzC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAItC,sBAAsB,IAAI,MAAM,EAAE;IAIlC,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,IAAI,CAAC;QAClB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC;CAUF;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GACjB,QAAQ,CAgCV"}

package/dist/Augustus.js

@@ -0,0 +1,174 @@
+import { ImperialLegion } from './core/ImperialLegion.js';
+import { SenateContext } from './context/SenateContext.js';
+import { VelvetDiff } from './diff/VelvetDiff.js';
+import { CaesarStream } from './stream/CaesarStream.js';
+import { TogaStyler } from './ui/TogaStyler.js';
+export class Augustus {
+    legion;
+    senate;
+    velvetDiff;
+    togaStyler;
+    config;
+    isIndexed = false;
+    constructor(config) {
+        this.config = config;
+        this.legion = new ImperialLegion(config.providers, config.softBuffer);
+        this.senate = new SenateContext(config.provinceIndexPath, config.maxProvincesInScroll);
+        this.velvetDiff = new VelvetDiff();
+        this.togaStyler = new TogaStyler(config.togaStyle);
+        if (config.defaultTactician) {
+            this.legion.selectTactician(config.defaultTactician.name);
+        }
+    }
+    async initialize() {
+        const provinceCount = await this.senate.indexCodebase();
+        this.isIndexed = true;
+        console.log(`Augustus awakens. ${provinceCount} provinces mapped.`);
+    }
+    async consult(query, tacticianName) {
+        if (!this.isIndexed) {
+            await this.initialize();
+        }
+        const scroll = await this.senate.gatherScroll(query);
+        const response = await this.legion.dispatchCommand(query, tacticianName, scroll);
+        return {
+            raw: response,
+            scroll
+        };
+    }
+    async *consultStream(query, tacticianName) {
+        if (!this.isIndexed) {
+            await this.initialize();
+        }
+        const scroll = await this.senate.gatherScroll(query);
+        const stream = new CaesarStream();
+        const source = this.legion.dispatchCommandStream(query, tacticianName, scroll);
+        for await (const chunk of stream.consume(source)) {
+            yield chunk;
+        }
+    }
+    async proposeEdits(filePath, instruction) {
+        const province = this.senate.getProvinceByPath(filePath);
+        if (!province) {
+            throw new Error(`Province not found: ${filePath}`);
+        }
+        const prompt = `Given the following code from ${province.name}:
+
+\`\`\`${province.language}
+${province.content}
+\`\`\`
+
+Please suggest improvements based on this instruction: ${instruction}
+
+Provide the modified code in a code block.`;
+        const response = await this.legion.dispatchCommand(prompt);
+        const modifiedContent = this.extractCodeFromResponse(response);
+        this.velvetDiff.reset();
+        const vision = this.velvetDiff.buildOracleVision([
+            `Analyzing ${province.name} for potential refinements`,
+            instruction,
+            'Applying gentle transformations while preserving structure'
+        ], 'Methodical enhancement with velvet precision');
+        const bricks = this.velvetDiff.analyzeChanges(province.content, modifiedContent, filePath);
+        const edification = this.velvetDiff.buildEdification(bricks);
+        return this.velvetDiff.composeOutput(vision, edification);
+    }
+    async *proposeEditsStream(filePath, instruction) {
+        const province = this.senate.getProvinceByPath(filePath);
+        if (!province) {
+            throw new Error(`Province not found: ${filePath}`);
+        }
+        const prompt = `Given the following code from ${province.name}:
+
+\`\`\`${province.language}
+${province.content}
+\`\`\`
+
+Please suggest improvements based on this instruction: ${instruction}
+
+Provide the modified code in a code block.`;
+        const response = await this.legion.dispatchCommand(prompt);
+        const modifiedContent = this.extractCodeFromResponse(response);
+        this.velvetDiff.reset();
+        const reasoning = [
+            `Analyzing ${province.name} for potential refinements`,
+            instruction,
+            'Applying gentle transformations while preserving structure'
+        ];
+        for await (const chunk of this.velvetDiff.streamOutput(province.content, modifiedContent, filePath, reasoning)) {
+            yield chunk;
+        }
+    }
+    extractCodeFromResponse(response) {
+        const codeBlockMatch = response.match(/```[\w]*\n([\s\S]*?)```/);
+        return codeBlockMatch ? codeBlockMatch[1].trim() : response;
+    }
+    styleOutput(output) {
+        const visionStyled = this.togaStyler.styleOracleVision(output.oracleVision);
+        const edificationStyled = this.togaStyler.styleEdification(output.edification);
+        return {
+            vision: visionStyled.html,
+            edification: edificationStyled.html,
+            css: this.togaStyler.generateFullStylesheet()
+        };
+    }
+    getProvince(path) {
+        return this.senate.getProvinceByPath(path);
+    }
+    getAllProvinces() {
+        return this.senate.getAllProvinces();
+    }
+    async reindexProvinces() {
+        const count = await this.senate.indexCodebase();
+        this.isIndexed = true;
+        return count;
+    }
+    selectTactician(name) {
+        return this.legion.selectTactician(name) !== null;
+    }
+    getAvailableTacticians() {
+        return this.legion.getTacticians().map((t) => t.name);
+    }
+    getStats() {
+        const indexStats = this.senate.getIndexStats();
+        const activeTactician = this.legion.getActiveTactician();
+        return {
+            provinceCount: indexStats.provinceCount,
+            lastIndexed: indexStats.lastIndexed,
+            activeTactician: activeTactician?.name ?? null
+        };
+    }
+}
+export function createAugustus(rootPath, anthropicKey, openaiKey) {
+    const config = {
+        providers: {
+            anthropic: { apiKey: anthropicKey ?? '' },
+            openai: { apiKey: openaiKey ?? '' }
+        },
+        defaultTactician: {
+            name: 'ClaudiusSonnet',
+            provider: 'anthropic',
+            modelId: 'claude-sonnet-4-20250514',
+            maxTokens: 8192,
+            temperature: 0.7
+        },
+        softBuffer: {
+            warmthLevel: 0.8,
+            gentleCorrection: true,
+            encouragementMode: true,
+            velvetTone: true
+        },
+        togaStyle: {
+            fontFamily: '"Cormorant Garamond", serif',
+            primaryHue: 45,
+            velvetShade: '#4a0e2e',
+            goldAccent: '#d4af37',
+            marbleBackground: '#f5f5f0',
+            softShadowIntensity: 0.15
+        },
+        provinceIndexPath: rootPath,
+        maxProvincesInScroll: 5
+    };
+    return new Augustus(config);
+}
+//# sourceMappingURL=Augustus.js.map

package/dist/Augustus.js.map

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

package/dist/context/SenateContext.d.ts

@@ -0,0 +1,31 @@
+import type { Province, ConsolidatedScroll } from '../types/core.types.js';
+export declare class SenateContext {
+    private index;
+    private rootPath;
+    private maxProvincesInScroll;
+    private ignoredPatterns;
+    constructor(rootPath: string, maxProvinces?: number);
+    indexCodebase(): Promise<number>;
+    private traverseAndIndex;
+    private shouldIgnore;
+    private isCodeFile;
+    private indexProvince;
+    private generateProvinceId;
+    private deriveProvinceName;
+    private detectLanguage;
+    private generateSimpleEmbedding;
+    private simpleHash;
+    gatherScroll(query: string): Promise<ConsolidatedScroll>;
+    private cosineSimilarity;
+    private calculateKeywordBoost;
+    getProvince(id: string): Province | undefined;
+    getProvinceByPath(relativePath: string): Province | undefined;
+    getAllProvinces(): Province[];
+    getIndexStats(): {
+        provinceCount: number;
+        lastIndexed: Date;
+    };
+    addIgnorePattern(pattern: RegExp): void;
+    setMaxProvincesInScroll(max: number): void;
+}
+//# sourceMappingURL=SenateContext.d.ts.map

package/dist/context/SenateContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SenateContext.d.ts","sourceRoot":"","sources":["../../src/context/SenateContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAQ3E,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,eAAe,CAAW;gBAEtB,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAE,MAAU;IAoBhD,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;YAUxB,gBAAgB;IAmB9B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,UAAU;YAUJ,aAAa;IAwB3B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,cAAc;IA8BtB,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,UAAU;IAUZ,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAyB9D,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,qBAAqB;IAc7B,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI7C,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAK7D,eAAe,IAAI,QAAQ,EAAE;IAI7B,aAAa,IAAI;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,IAAI,CAAA;KAAE;IAO7D,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIvC,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAG3C"}

package/dist/context/SenateContext.js

@@ -0,0 +1,209 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+export class SenateContext {
+    index;
+    rootPath;
+    maxProvincesInScroll;
+    ignoredPatterns;
+    constructor(rootPath, maxProvinces = 5) {
+        this.rootPath = rootPath;
+        this.maxProvincesInScroll = maxProvinces;
+        this.index = {
+            provinces: new Map(),
+            embeddings: new Map(),
+            lastIndexed: new Date(0)
+        };
+        this.ignoredPatterns = [
+            /node_modules/,
+            /\.git/,
+            /dist/,
+            /build/,
+            /\.next/,
+            /\.cache/,
+            /coverage/,
+            /\.env/
+        ];
+    }
+    async indexCodebase() {
+        this.index.provinces.clear();
+        this.index.embeddings.clear();
+        await this.traverseAndIndex(this.rootPath);
+        this.index.lastIndexed = new Date();
+        return this.index.provinces.size;
+    }
+    async traverseAndIndex(dirPath) {
+        const entries = await fs.readdir(dirPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dirPath, entry.name);
+            const relativePath = path.relative(this.rootPath, fullPath);
+            if (this.shouldIgnore(relativePath)) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                await this.traverseAndIndex(fullPath);
+            }
+            else if (entry.isFile() && this.isCodeFile(entry.name)) {
+                await this.indexProvince(fullPath, relativePath);
+            }
+        }
+    }
+    shouldIgnore(filePath) {
+        return this.ignoredPatterns.some((pattern) => pattern.test(filePath));
+    }
+    isCodeFile(fileName) {
+        const codeExtensions = [
+            '.ts', '.tsx', '.js', '.jsx', '.py', '.rs', '.go',
+            '.java', '.kt', '.swift', '.c', '.cpp', '.h', '.hpp',
+            '.cs', '.rb', '.php', '.vue', '.svelte', '.astro',
+            '.json', '.yaml', '.yml', '.toml', '.md', '.sql'
+        ];
+        return codeExtensions.some((ext) => fileName.endsWith(ext));
+    }
+    async indexProvince(fullPath, relativePath) {
+        try {
+            const content = await fs.readFile(fullPath, 'utf-8');
+            const stats = await fs.stat(fullPath);
+            const lines = content.split('\n');
+            const province = {
+                id: this.generateProvinceId(relativePath),
+                path: relativePath,
+                name: this.deriveProvinceName(relativePath),
+                content,
+                relevanceScore: 0,
+                lastModified: stats.mtime,
+                language: this.detectLanguage(relativePath),
+                lineCount: lines.length
+            };
+            this.index.provinces.set(province.id, province);
+            this.index.embeddings.set(province.id, this.generateSimpleEmbedding(content));
+        }
+        catch {
+            // Skip files that cannot be read
+        }
+    }
+    generateProvinceId(relativePath) {
+        return `province_${relativePath.replace(/[^a-zA-Z0-9]/g, '_')}`;
+    }
+    deriveProvinceName(relativePath) {
+        const parts = relativePath.split(path.sep);
+        const fileName = parts[parts.length - 1];
+        const dirContext = parts.length > 1 ? parts[parts.length - 2] : '';
+        return dirContext ? `${dirContext}/${fileName}` : fileName;
+    }
+    detectLanguage(filePath) {
+        const extensionMap = {
+            '.ts': 'typescript',
+            '.tsx': 'typescript-react',
+            '.js': 'javascript',
+            '.jsx': 'javascript-react',
+            '.py': 'python',
+            '.rs': 'rust',
+            '.go': 'go',
+            '.java': 'java',
+            '.kt': 'kotlin',
+            '.swift': 'swift',
+            '.c': 'c',
+            '.cpp': 'cpp',
+            '.cs': 'csharp',
+            '.rb': 'ruby',
+            '.php': 'php',
+            '.vue': 'vue',
+            '.svelte': 'svelte',
+            '.json': 'json',
+            '.yaml': 'yaml',
+            '.yml': 'yaml',
+            '.md': 'markdown',
+            '.sql': 'sql'
+        };
+        const ext = path.extname(filePath).toLowerCase();
+        return extensionMap[ext] ?? 'plaintext';
+    }
+    generateSimpleEmbedding(content) {
+        const tokens = content.toLowerCase().split(/\W+/).filter(Boolean);
+        const embedding = new Array(128).fill(0);
+        for (const token of tokens) {
+            const hash = this.simpleHash(token);
+            embedding[hash % 128] += 1;
+        }
+        const magnitude = Math.sqrt(embedding.reduce((sum, val) => sum + val * val, 0));
+        return magnitude > 0 ? embedding.map((v) => v / magnitude) : embedding;
+    }
+    simpleHash(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = (hash << 5) - hash + char;
+            hash = hash & hash;
+        }
+        return Math.abs(hash);
+    }
+    async gatherScroll(query) {
+        const queryEmbedding = this.generateSimpleEmbedding(query);
+        const scoredProvinces = [];
+        for (const [id, province] of this.index.provinces) {
+            const embedding = this.index.embeddings.get(id);
+            if (embedding) {
+                const similarity = this.cosineSimilarity(queryEmbedding, embedding);
+                const keywordBoost = this.calculateKeywordBoost(query, province);
+                province.relevanceScore = similarity * 0.6 + keywordBoost * 0.4;
+                scoredProvinces.push({ ...province });
+            }
+        }
+        scoredProvinces.sort((a, b) => b.relevanceScore - a.relevanceScore);
+        const topProvinces = scoredProvinces.slice(0, this.maxProvincesInScroll);
+        return {
+            provinces: topProvinces,
+            totalRelevance: topProvinces.reduce((sum, p) => sum + p.relevanceScore, 0),
+            queryEmbedding,
+            timestamp: new Date()
+        };
+    }
+    cosineSimilarity(a, b) {
+        let dotProduct = 0;
+        let magnitudeA = 0;
+        let magnitudeB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dotProduct += a[i] * b[i];
+            magnitudeA += a[i] * a[i];
+            magnitudeB += b[i] * b[i];
+        }
+        const magnitude = Math.sqrt(magnitudeA) * Math.sqrt(magnitudeB);
+        return magnitude > 0 ? dotProduct / magnitude : 0;
+    }
+    calculateKeywordBoost(query, province) {
+        const queryTerms = query.toLowerCase().split(/\W+/).filter(Boolean);
+        const contentLower = province.content.toLowerCase();
+        const pathLower = province.path.toLowerCase();
+        let matches = 0;
+        for (const term of queryTerms) {
+            if (contentLower.includes(term))
+                matches += 1;
+            if (pathLower.includes(term))
+                matches += 2;
+        }
+        return Math.min(matches / (queryTerms.length * 3), 1);
+    }
+    getProvince(id) {
+        return this.index.provinces.get(id);
+    }
+    getProvinceByPath(relativePath) {
+        const id = this.generateProvinceId(relativePath);
+        return this.index.provinces.get(id);
+    }
+    getAllProvinces() {
+        return Array.from(this.index.provinces.values());
+    }
+    getIndexStats() {
+        return {
+            provinceCount: this.index.provinces.size,
+            lastIndexed: this.index.lastIndexed
+        };
+    }
+    addIgnorePattern(pattern) {
+        this.ignoredPatterns.push(pattern);
+    }
+    setMaxProvincesInScroll(max) {
+        this.maxProvincesInScroll = max;
+    }
+}
+//# sourceMappingURL=SenateContext.js.map

package/dist/context/SenateContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SenateContext.js","sourceRoot":"","sources":["../../src/context/SenateContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAS7B,MAAM,OAAO,aAAa;IAChB,KAAK,CAAgB;IACrB,QAAQ,CAAS;IACjB,oBAAoB,CAAS;IAC7B,eAAe,CAAW;IAElC,YAAY,QAAgB,EAAE,eAAuB,CAAC;QACpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,oBAAoB,GAAG,YAAY,CAAC;QACzC,IAAI,CAAC,KAAK,GAAG;YACX,SAAS,EAAE,IAAI,GAAG,EAAE;YACpB,UAAU,EAAE,IAAI,GAAG,EAAE;YACrB,WAAW,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;SACzB,CAAC;QACF,IAAI,CAAC,eAAe,GAAG;YACrB,cAAc;YACd,OAAO;YACP,MAAM;YACN,OAAO;YACP,QAAQ;YACR,SAAS;YACT,UAAU;YACV,OAAO;SACR,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QAE9B,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QAEpC,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;IACnC,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,OAAe;QAC5C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAChD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAE5D,IAAI,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpC,SAAS;YACX,CAAC;YAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YACxC,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzD,MAAM,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,QAAgB;QACnC,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,CAAC;IAEO,UAAU,CAAC,QAAgB;QACjC,MAAM,cAAc,GAAG;YACrB,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK;YACjD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;YACpD,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ;YACjD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;SACjD,CAAC;QACF,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,YAAoB;QAChE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAElC,MAAM,QAAQ,GAAa;gBACzB,EAAE,EAAE,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC;gBACzC,IAAI,EAAE,YAAY;gBAClB,IAAI,EAAE,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC;gBAC3C,OAAO;gBACP,cAAc,EAAE,CAAC;gBACjB,YAAY,EAAE,KAAK,CAAC,KAAK;gBACzB,QAAQ,EAAE,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC;gBAC3C,SAAS,EAAE,KAAK,CAAC,MAAM;aACxB,CAAC;YAEF,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAChD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;QAChF,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,YAAoB;QAC7C,OAAO,YAAY,YAAY,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,EAAE,CAAC;IAClE,CAAC;IAEO,kBAAkB,CAAC,YAAoB;QAC7C,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEnE,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,UAAU,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7D,CAAC;IAEO,cAAc,CAAC,QAAgB;QACrC,MAAM,YAAY,GAA2B;YAC3C,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,kBAAkB;YAC1B,KAAK,EAAE,YAAY;YACnB,MAAM,EAAE,kBAAkB;YAC1B,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,MAAM;YACb,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,GAAG;YACT,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,QAAQ;YACf,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,QAAQ;YACnB,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,MAAM;YACf,MAAM,EAAE,MAAM;YACd,KAAK,EAAE,UAAU;YACjB,MAAM,EAAE,KAAK;SACd,CAAC;QAEF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACjD,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC;IAC1C,CAAC;IAEO,uBAAuB,CAAC,OAAe;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClE,MAAM,SAAS,GAAa,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEnD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACpC,SAAS,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAChF,OAAO,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,CAAC;IAEO,UAAU,CAAC,GAAW;QAC5B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAC/B,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;YACjC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,MAAM,cAAc,GAAG,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAC3D,MAAM,eAAe,GAAe,EAAE,CAAC;QAEvC,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YAClD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChD,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;gBACpE,MAAM,YAAY,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;gBACjE,QAAQ,CAAC,cAAc,GAAG,UAAU,GAAG,GAAG,GAAG,YAAY,GAAG,GAAG,CAAC;gBAChE,eAAe,CAAC,IAAI,CAAC,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC;QACpE,MAAM,YAAY,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAEzE,OAAO;YACL,SAAS,EAAE,YAAY;YACvB,cAAc,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC;YAC1E,cAAc;YACd,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,CAAW,EAAE,CAAW;QAC/C,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1B,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1B,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAChE,OAAO,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAEO,qBAAqB,CAAC,KAAa,EAAE,QAAkB;QAC7D,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAE9C,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC;YAC9C,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,iBAAiB,CAAC,YAAoB;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,aAAa;QACX,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI;YACxC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;SACpC,CAAC;IACJ,CAAC;IAED,gBAAgB,CAAC,OAAe;QAC9B,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,uBAAuB,CAAC,GAAW;QACjC,IAAI,CAAC,oBAAoB,GAAG,GAAG,CAAC;IAClC,CAAC;CACF"}

package/dist/core/ImperialLegion.d.ts

@@ -0,0 +1,27 @@
+import type { ModelTactician, ProviderName, SoftBufferConfig, ConsolidatedScroll, CaesarStreamChunk } from '../types/core.types.js';
+export declare class ImperialLegion {
+    private tacticians;
+    private clients;
+    private softBuffer;
+    private activeTactician;
+    constructor(providerConfigs: Record<ProviderName, {
+        apiKey: string;
+        baseUrl?: string;
+    }>, bufferConfig: SoftBufferConfig);
+    private initializeProviders;
+    private registerDefaultTacticians;
+    registerTactician(tactician: ModelTactician): void;
+    selectTactician(name: string): ModelTactician | null;
+    dispatchCommand(prompt: string, tacticianName?: string, context?: ConsolidatedScroll): Promise<string>;
+    dispatchCommandStream(prompt: string, tacticianName?: string, context?: ConsolidatedScroll): AsyncGenerator<CaesarStreamChunk>;
+    private weaveScrollIntoPrompt;
+    private executeCommand;
+    private executeAnthropicCommand;
+    private executeOpenAICommand;
+    private executeStreamingCommand;
+    private generateStreamId;
+    getTacticians(): ModelTactician[];
+    getActiveTactician(): ModelTactician | null;
+    updateSoftBuffer(config: Partial<SoftBufferConfig>): void;
+}
+//# sourceMappingURL=ImperialLegion.d.ts.map

package/dist/core/ImperialLegion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImperialLegion.d.ts","sourceRoot":"","sources":["../../src/core/ImperialLegion.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EAEhB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAOhC,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAA0C;IAC5D,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAA+B;gBAGpD,eAAe,EAAE,MAAM,CAAC,YAAY,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAC3E,YAAY,EAAE,gBAAgB;IAOhC,OAAO,CAAC,mBAAmB;IAiB3B,OAAO,CAAC,yBAAyB;IAqCjC,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;IAIlD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAQ9C,eAAe,CACnB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC;IAyBX,qBAAqB,CAC1B,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,cAAc,CAAC,iBAAiB,CAAC;IAuDpC,OAAO,CAAC,qBAAqB;YAiBf,cAAc;YAad,uBAAuB;YAqBvB,oBAAoB;YAkBpB,uBAAuB;IASrC,OAAO,CAAC,gBAAgB;IAIxB,aAAa,IAAI,cAAc,EAAE;IAIjC,kBAAkB,IAAI,cAAc,GAAG,IAAI;IAI3C,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;CAG1D"}