agcel 1.0.4 → 2.0.0

package/dist/core/local-rag.d.ts

@@ -0,0 +1,17 @@
+import type { IRagEngine, RagSearchResult } from './rag-types.js';
+/**
+ * Local JSON-backed RAG: TF-IDF-like token overlap scoring (no external services).
+ */
+export declare class LocalRagEngine implements IRagEngine {
+    private documents;
+    private readonly indexPath;
+    constructor(basePath?: string);
+    initialize(): Promise<void>;
+    addDocument(id: string, content: string, metadata?: Record<string, string>): Promise<void>;
+    query(queryText: string, topK?: number, metadataFilter?: Record<string, string>): Promise<RagSearchResult[]>;
+    removeDocument(id: string): Promise<void>;
+    getDocumentCount(): Promise<number>;
+    private loadIndex;
+    private saveIndex;
+}
+//# sourceMappingURL=local-rag.d.ts.map

package/dist/core/local-rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-rag.d.ts","sourceRoot":"","sources":["../../src/core/local-rag.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIlE;;GAEG;AACH,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,SAAS,CAAgF;IACjG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,QAAQ,CAAC,EAAE,MAAM;IAIvB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9F,KAAK,CACT,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,MAAU,EAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,OAAO,CAAC,eAAe,EAAE,CAAC;IA6BvB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;YAI3B,SAAS;YAUT,SAAS;CAIxB"}

package/dist/core/local-rag.js

@@ -0,0 +1,74 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { cosineSimilarityMaps, tokenizeForSimilarity } from './text-similarity.js';
+import { recencyScoreMultiplier } from './rag-metadata.js';
+/**
+ * Local JSON-backed RAG: TF-IDF-like token overlap scoring (no external services).
+ */
+export class LocalRagEngine {
+    documents = [];
+    indexPath;
+    constructor(basePath) {
+        this.indexPath = basePath || path.join(process.cwd(), '.agcel', 'rag');
+    }
+    async initialize() {
+        await fs.mkdir(this.indexPath, { recursive: true });
+        await this.loadIndex();
+    }
+    async addDocument(id, content, metadata = {}) {
+        const existing = this.documents.findIndex(d => d.id === id);
+        if (existing >= 0) {
+            this.documents[existing] = { id, content, metadata };
+        }
+        else {
+            this.documents.push({ id, content, metadata });
+        }
+        await this.saveIndex();
+    }
+    async query(queryText, topK = 5, metadataFilter) {
+        const queryTerms = tokenizeForSimilarity(queryText);
+        let pool = this.documents;
+        if (metadataFilter && Object.keys(metadataFilter).length > 0) {
+            pool = pool.filter((d) => Object.entries(metadataFilter).every(([k, v]) => d.metadata[k] === v));
+        }
+        const scored = pool.map((doc) => {
+            const metaBlob = Object.entries(doc.metadata)
+                .map(([k, v]) => `${k} ${v}`)
+                .join(' ');
+            const blob = `${doc.content}\n${metaBlob}`;
+            const docTerms = tokenizeForSimilarity(blob);
+            let score = cosineSimilarityMaps(queryTerms, docTerms);
+            score *= recencyScoreMultiplier(doc.metadata.updatedAt);
+            return {
+                id: doc.id,
+                content: doc.content,
+                score,
+                metadata: { ...doc.metadata }
+            };
+        });
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, topK);
+    }
+    async removeDocument(id) {
+        this.documents = this.documents.filter(d => d.id !== id);
+        await this.saveIndex();
+    }
+    async getDocumentCount() {
+        return this.documents.length;
+    }
+    async loadIndex() {
+        try {
+            const indexFile = path.join(this.indexPath, 'index.json');
+            const data = await fs.readFile(indexFile, 'utf-8');
+            this.documents = JSON.parse(data);
+        }
+        catch {
+            this.documents = [];
+        }
+    }
+    async saveIndex() {
+        const indexFile = path.join(this.indexPath, 'index.json');
+        await fs.writeFile(indexFile, JSON.stringify(this.documents, null, 2));
+    }
+}
+//# sourceMappingURL=local-rag.js.map

package/dist/core/local-rag.js.map

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

package/dist/core/local-rag.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=local-rag.test.d.ts.map

package/dist/core/local-rag.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-rag.test.d.ts","sourceRoot":"","sources":["../../src/core/local-rag.test.ts"],"names":[],"mappings":""}

package/dist/core/local-rag.test.js

@@ -0,0 +1,47 @@
+import * as fs from 'node:fs/promises';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { LocalRagEngine } from './local-rag.js';
+describe('LocalRagEngine', () => {
+    let tmpDir;
+    afterEach(async () => {
+        if (tmpDir) {
+            await fs.rm(tmpDir, { recursive: true, force: true });
+        }
+    });
+    it('Given indexed docs about Python when querying python topic then higher-scoring doc is first', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'agcel-rag-'));
+        const ragPath = path.join(tmpDir, 'rag');
+        const engine = new LocalRagEngine(ragPath);
+        await engine.initialize();
+        await engine.addDocument('a', 'Notes about cooking pasta and sauces.');
+        await engine.addDocument('b', 'Python testing with pytest and fixtures.');
+        const results = await engine.query('python testing pytest', 2);
+        expect(results.length).toBeGreaterThanOrEqual(1);
+        expect(results[0]?.id).toBe('b');
+        expect(results[0]?.score).toBeGreaterThan(0);
+    });
+    it('Given same id when adding again then document is replaced', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'agcel-rag-'));
+        const engine = new LocalRagEngine(path.join(tmpDir, 'rag'));
+        await engine.initialize();
+        await engine.addDocument('x', 'first');
+        await engine.addDocument('x', 'second version');
+        const count = await engine.getDocumentCount();
+        expect(count).toBe(1);
+        const q = await engine.query('second version', 1);
+        expect(q[0]?.content).toBe('second version');
+    });
+    it('Given metadata filter when querying then only matching documents are returned', async () => {
+        tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'agcel-rag-'));
+        const engine = new LocalRagEngine(path.join(tmpDir, 'rag'));
+        await engine.initialize();
+        await engine.addDocument('a', 'alpha project notes', { source: 'a' });
+        await engine.addDocument('b', 'beta project notes', { source: 'b' });
+        const filtered = await engine.query('project', 5, { source: 'b' });
+        expect(filtered).toHaveLength(1);
+        expect(filtered[0]?.id).toBe('b');
+    });
+});
+//# sourceMappingURL=local-rag.test.js.map

package/dist/core/local-rag.test.js.map

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

package/dist/core/orchestrator.d.ts

@@ -0,0 +1,47 @@
+import type { Agent, Guardrail } from './schema.js';
+import { Registry } from './registry.js';
+import { IntentEngine } from './intent.js';
+import { ContextManager } from './context.js';
+import { type ConversationTurn } from './conversation-routing.js';
+import { GuardrailValidator, type ValidationResult } from './guardrails.js';
+export interface RouteQueryOptions {
+    /** Prior turns (oldest first). Combined with the current query for intent and context. */
+    conversationHistory?: ConversationTurn[];
+    /** Name of the agent used on the previous turn; used to report `agentSwitched`. */
+    previousAgentName?: string | null;
+    /** When set, validate this text against the resolved agent guardrails. */
+    draftOutput?: string;
+    /** When true, failed validation (error-severity rules) sets `guardrailsBlocked`. */
+    strictGuardrailsOnDraft?: boolean;
+}
+export interface RouteQueryResult {
+    agent: Agent | null;
+    confidence: number;
+    suggestion: string | null;
+    context: string;
+    assembledPrompt: string;
+    guardrails: Guardrail[];
+    /** True when `previousAgentName` was set and differs from the selected agent name (including null). */
+    agentSwitched: boolean;
+    /** Text passed to intent detection (may include conversation history). */
+    routingQuery: string;
+    /** Agent skill names with no matching registry entry. */
+    missingSkills: string[];
+    /** Human-readable issues (for example missing skills). */
+    warnings: string[];
+    guardrailValidation?: ValidationResult;
+    guardrailReport?: string;
+    guardrailRevisionHint?: string;
+    /** True when strict guardrail mode is on and the draft failed validation. */
+    guardrailsBlocked?: boolean;
+}
+export declare class Orchestrator {
+    private registry;
+    private intentEngine;
+    private contextManager;
+    private guardrailValidator;
+    constructor(registry?: Registry, intentEngine?: IntentEngine, contextManager?: ContextManager, guardrailValidator?: GuardrailValidator);
+    initialize(): Promise<void>;
+    routeQuery(query: string, options?: RouteQueryOptions): Promise<RouteQueryResult>;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAS,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE5E,MAAM,WAAW,iBAAiB;IAChC,0FAA0F;IAC1F,mBAAmB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACzC,mFAAmF;IACnF,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,uGAAuG;IACvG,aAAa,EAAE,OAAO,CAAC;IACvB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mBAAmB,CAAC,EAAE,gBAAgB,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAkED,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,kBAAkB;gBAHlB,QAAQ,GAAE,QAAyB,EACnC,YAAY,GAAE,YAAiC,EAC/C,cAAc,GAAE,cAAqC,EACrD,kBAAkB,GAAE,kBAA6C;IAGrE,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,UAAU,CACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;CAmF7B"}

package/dist/core/orchestrator.js

@@ -0,0 +1,138 @@
+import { Registry } from './registry.js';
+import { IntentEngine } from './intent.js';
+import { ContextManager } from './context.js';
+import { buildRoutingQuery } from './conversation-routing.js';
+import { GuardrailValidator } from './guardrails.js';
+function buildRevisionHint(result) {
+    const errs = result.violations.filter((v) => v.severity === 'error');
+    if (errs.length === 0)
+        return undefined;
+    return ('Address these guardrail errors and revise the draft: ' +
+        errs.map((e) => `${e.description} (${e.detail})`).join('; '));
+}
+function collectGuardrails(agent, skills) {
+    if (!agent)
+        return [];
+    const all = [...(agent.guardrails ?? [])];
+    for (const skillName of agent.skills) {
+        const skill = skills.find(s => s.name === skillName);
+        if (skill?.guardrails)
+            all.push(...skill.guardrails);
+    }
+    return all;
+}
+function assemblePrompt(parts) {
+    const lines = [];
+    if (!parts.agent) {
+        if (parts.context.trim()) {
+            lines.push('Context:\n' + parts.context.trim());
+        }
+        if (parts.warnings?.length) {
+            lines.push(`Warnings:\n${parts.warnings.map(w => `- ${w}`).join('\n')}`.trim());
+        }
+        return lines.join('\n\n').trim();
+    }
+    lines.push(`Agent: ${parts.agent.name}`);
+    lines.push(`Role:\n${parts.agent.role}`.trim());
+    if (parts.skills.length > 0) {
+        const skillsText = parts.skills
+            .map(s => `Skill: ${s.name}\n${s.systemPrompt}`.trim())
+            .join('\n\n');
+        lines.push(`Skills:\n${skillsText}`.trim());
+    }
+    if (parts.context.trim()) {
+        lines.push(`Context:\n${parts.context.trim()}`.trim());
+    }
+    if (parts.missingSkills && parts.missingSkills.length > 0) {
+        lines.push(`Notes:\nMissing registry skills (listed on the agent but no skill file matched): ${parts.missingSkills.join(', ')}. Add markdown or JSON under .agcel/registry/skills/ or run \`agcel create-skill\`.`.trim());
+    }
+    if (parts.warnings?.length) {
+        lines.push(`Warnings:\n${parts.warnings.map(w => `- ${w}`).join('\n')}`.trim());
+    }
+    return lines.join('\n\n').trim();
+}
+export class Orchestrator {
+    registry;
+    intentEngine;
+    contextManager;
+    guardrailValidator;
+    constructor(registry = new Registry(), intentEngine = new IntentEngine(), contextManager = new ContextManager(), guardrailValidator = new GuardrailValidator()) {
+        this.registry = registry;
+        this.intentEngine = intentEngine;
+        this.contextManager = contextManager;
+        this.guardrailValidator = guardrailValidator;
+    }
+    async initialize() {
+        await this.contextManager.initialize();
+    }
+    async routeQuery(query, options) {
+        const [agents, allSkills] = await Promise.all([
+            this.registry.loadAgents(),
+            this.registry.loadSkills()
+        ]);
+        const routingQuery = buildRoutingQuery(query, options?.conversationHistory);
+        const intent = this.intentEngine.detectIntent(routingQuery, agents, {
+            latestUserTurn: query.trim()
+        });
+        const agent = intent.bestAgent;
+        const resolvedSkills = agent
+            ? agent.skills.map(name => allSkills.find(s => s.name === name)).filter((s) => s !== undefined)
+            : [];
+        const missingSkills = agent
+            ? agent.skills.filter((name) => !allSkills.some((s) => s.name === name))
+            : [];
+        const warnings = [];
+        if (missingSkills.length > 0) {
+            warnings.push(`Skills not loaded from registry: ${missingSkills.join(', ')}`);
+        }
+        const context = (await this.contextManager.getContext(routingQuery)) || '';
+        const guardrails = collectGuardrails(agent, allSkills);
+        const assembledPrompt = assemblePrompt({
+            agent,
+            skills: resolvedSkills,
+            context,
+            missingSkills,
+            warnings
+        });
+        const prev = options?.previousAgentName ?? null;
+        const currentName = agent?.name ?? null;
+        const agentSwitched = prev !== null &&
+            prev !== '' &&
+            (currentName === null ? true : currentName !== prev);
+        const draft = options?.draftOutput?.trim();
+        let guardrailValidation;
+        let guardrailReport;
+        let guardrailRevisionHint;
+        if (draft && agent && guardrails.length > 0) {
+            guardrailValidation = this.guardrailValidator.validate(draft, guardrails);
+            guardrailReport = this.guardrailValidator.formatReport(guardrailValidation);
+            guardrailRevisionHint = buildRevisionHint(guardrailValidation);
+        }
+        const guardrailsBlocked = guardrailValidation !== undefined &&
+            Boolean(options?.strictGuardrailsOnDraft) &&
+            !guardrailValidation.passed;
+        return {
+            agent,
+            confidence: intent.confidence,
+            suggestion: intent.suggestion,
+            context,
+            assembledPrompt,
+            guardrails,
+            agentSwitched,
+            routingQuery,
+            missingSkills,
+            warnings,
+            ...(guardrailValidation !== undefined
+                ? {
+                    guardrailValidation,
+                    guardrailReport: guardrailReport,
+                    ...(guardrailRevisionHint !== undefined
+                        ? { guardrailRevisionHint }
+                        : {}),
+                    guardrailsBlocked
+                }
+                : {})
+        };
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/core/orchestrator.js.map

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

package/dist/core/orchestrator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=orchestrator.test.d.ts.map

package/dist/core/orchestrator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.test.d.ts","sourceRoot":"","sources":["../../src/core/orchestrator.test.ts"],"names":[],"mappings":""}

package/dist/core/orchestrator.test.js

@@ -0,0 +1,118 @@
+import { describe, expect, it } from 'vitest';
+import { Orchestrator } from './orchestrator.js';
+import { IntentEngine } from './intent.js';
+import { GuardrailValidator } from './guardrails.js';
+class FakeIntentEngine {
+    detectIntent(query, agents) {
+        const lower = query.toLowerCase();
+        const best = agents.find(a => lower.includes('python') &&
+            (a.name === 'backend-developer' || a.name.includes('python'))) ?? agents[0] ?? null;
+        return { bestAgent: best, confidence: best ? 1 : 0, suggestion: null };
+    }
+}
+class FakeRegistry {
+    agents;
+    skills;
+    constructor(agents, skills) {
+        this.agents = agents;
+        this.skills = skills;
+    }
+    async loadAgents() {
+        return this.agents;
+    }
+    async loadSkills() {
+        return this.skills;
+    }
+}
+class FakeContextManager {
+    async initialize() {
+        return;
+    }
+    async getContext(_query) {
+        return 'Some relevant context.';
+    }
+}
+describe('Orchestrator', () => {
+    it('Given matching query when routing then returns agent, context, and assembled prompt', async () => {
+        const agents = [
+            { name: 'backend-developer', description: 'Python Java Node backend', role: 'Be a backend dev', skills: ['python'] },
+            { name: 'web-designer', description: 'Web designer', role: 'Be a designer', skills: ['design'] }
+        ];
+        const skills = [
+            { name: 'python', description: 'Python skill', systemPrompt: 'Use Python.', tools: [] }
+        ];
+        const orchestrator = new Orchestrator(new FakeRegistry(agents, skills), new FakeIntentEngine(), new FakeContextManager());
+        const result = await orchestrator.routeQuery('Need help with python testing');
+        expect(result.agent?.name).toBe('backend-developer');
+        expect(result.context).toContain('relevant context');
+        expect(result.assembledPrompt).toContain('Agent: backend-developer');
+        expect(result.assembledPrompt).toContain('Skill: python');
+        expect(result.assembledPrompt).toContain('Context:');
+        expect(result.agentSwitched).toBe(false);
+        expect(result.routingQuery).toBe('Need help with python testing');
+        expect(result.missingSkills).toEqual([]);
+        expect(result.warnings).toEqual([]);
+    });
+    it('Given evolving conversation toward Python when routing with history then selects python agent and reports switch', async () => {
+        const agents = [
+            {
+                name: 'python-expert',
+                description: 'Python backend asyncio django debugging',
+                role: 'Senior Python engineer for APIs and tracebacks',
+                skills: ['python']
+            },
+            {
+                name: 'ui-expert',
+                description: 'Figma mockups React frontend layout design',
+                role: 'Product designer for UI and visual design',
+                skills: ['design']
+            }
+        ];
+        const skills = [
+            { name: 'python', description: 'Py', systemPrompt: 'Use Python.', tools: [] },
+            { name: 'design', description: 'UI', systemPrompt: 'Use design.', tools: [] }
+        ];
+        const orchestrator = new Orchestrator(new FakeRegistry(agents, skills), new IntentEngine(0.25), new FakeContextManager());
+        const first = await orchestrator.routeQuery('Create a Figma mockup for the dashboard');
+        expect(first.agent?.name).toBe('ui-expert');
+        expect(first.agentSwitched).toBe(false);
+        const second = await orchestrator.routeQuery('Ignore that, the Django view is throwing a traceback', {
+            conversationHistory: [
+                { role: 'user', content: 'Create a Figma mockup for the dashboard' },
+                { role: 'assistant', content: 'Here is a layout concept.' }
+            ],
+            previousAgentName: first.agent?.name ?? null
+        });
+        expect(second.agent?.name).toBe('python-expert');
+        expect(second.agentSwitched).toBe(true);
+        expect(second.routingQuery).toContain('Django');
+        expect(second.routingQuery).toContain('Figma');
+    });
+    it('Given draft breaking guardrails when strict validation then guardrailsBlocked is true', async () => {
+        const agents = [
+            {
+                name: 'safe-agent',
+                description: 'Safe',
+                role: 'Be safe',
+                skills: [],
+                guardrails: [
+                    {
+                        id: 'no-secret',
+                        description: 'Do not leak secret marker',
+                        severity: 'error',
+                        forbiddenTerms: ['TOPSECRET']
+                    }
+                ]
+            }
+        ];
+        const orchestrator = new Orchestrator(new FakeRegistry(agents, []), new FakeIntentEngine(), new FakeContextManager(), new GuardrailValidator());
+        const result = await orchestrator.routeQuery('hello', {
+            draftOutput: 'This contains TOPSECRET',
+            strictGuardrailsOnDraft: true
+        });
+        expect(result.guardrailValidation?.passed).toBe(false);
+        expect(result.guardrailsBlocked).toBe(true);
+        expect(result.guardrailRevisionHint).toBeDefined();
+    });
+});
+//# sourceMappingURL=orchestrator.test.js.map

package/dist/core/orchestrator.test.js.map

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

package/dist/core/pulse.d.ts

@@ -0,0 +1,13 @@
+import { SummarizationService } from './summarizer.js';
+export interface PulseInput {
+    timestampIso: string;
+    changedFiles: string[];
+    diffStat: string;
+    gitHead?: string;
+}
+export declare class PulseService {
+    private readonly summarizer;
+    constructor(summarizer?: SummarizationService);
+    buildMemo(input: PulseInput): string;
+}
+//# sourceMappingURL=pulse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.d.ts","sourceRoot":"","sources":["../../src/core/pulse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,GAAE,oBAAoD;IAE7F,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;CAqBrC"}

package/dist/core/pulse.js

@@ -0,0 +1,29 @@
+import { SummarizationService } from './summarizer.js';
+export class PulseService {
+    summarizer;
+    constructor(summarizer = new SummarizationService(800)) {
+        this.summarizer = summarizer;
+    }
+    buildMemo(input) {
+        const lines = [
+            'Project Pulse',
+            `Time: ${input.timestampIso}`,
+            ...(input.gitHead ? [`HEAD: ${input.gitHead}`] : [])
+        ];
+        if (input.changedFiles.length > 0) {
+            lines.push('', 'Changed files:');
+            for (const f of input.changedFiles.slice(0, 200))
+                lines.push(`- ${f}`);
+            if (input.changedFiles.length > 200)
+                lines.push(`- ...and ${input.changedFiles.length - 200} more`);
+        }
+        if (input.diffStat.trim()) {
+            lines.push('', 'Diff stat:', input.diffStat.trim());
+        }
+        const memo = lines.join('\n');
+        if (this.summarizer.exceedsBudget(memo))
+            return this.summarizer.summarize(memo);
+        return memo;
+    }
+}
+//# sourceMappingURL=pulse.js.map

package/dist/core/pulse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.js","sourceRoot":"","sources":["../../src/core/pulse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AASvD,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,aAAmC,IAAI,oBAAoB,CAAC,GAAG,CAAC;QAAhE,eAAU,GAAV,UAAU,CAAsD;IAAG,CAAC;IAEjG,SAAS,CAAC,KAAiB;QACzB,MAAM,KAAK,GAAa;YACtB,eAAe;YACf,SAAS,KAAK,CAAC,YAAY,EAAE;YAC7B,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC;QAEF,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;YACjC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvE,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC;QACtG,CAAC;QAED,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/core/pulse.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=pulse.test.d.ts.map

package/dist/core/pulse.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.test.d.ts","sourceRoot":"","sources":["../../src/core/pulse.test.ts"],"names":[],"mappings":""}

package/dist/core/pulse.test.js

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+import { PulseService } from './pulse.js';
+describe('PulseService', () => {
+    it('Given changes when building memo then includes timestamp and file list', () => {
+        const svc = new PulseService();
+        const memo = svc.buildMemo({
+            timestampIso: '2026-03-27T00:00:00.000Z',
+            changedFiles: ['src/a.ts', 'src/b.ts'],
+            diffStat: '2 files changed, 10 insertions(+), 1 deletion(-)',
+            gitHead: 'abc123 test'
+        });
+        expect(memo).toContain('Project Pulse');
+        expect(memo).toContain('Time: 2026-03-27T00:00:00.000Z');
+        expect(memo).toContain('- src/a.ts');
+        expect(memo).toContain('Diff stat:');
+    });
+});
+//# sourceMappingURL=pulse.test.js.map

package/dist/core/pulse.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.test.js","sourceRoot":"","sources":["../../src/core/pulse.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,GAAG,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,SAAS,CAAC;YACzB,YAAY,EAAE,0BAA0B;YACxC,YAAY,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;YACtC,QAAQ,EAAE,kDAAkD;YAC5D,OAAO,EAAE,aAAa;SACvB,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/core/rag-metadata.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Optional recency boost for RAG hits using ISO metadata `updatedAt`.
+ */
+export declare function recencyScoreMultiplier(updatedAt?: string): number;
+//# sourceMappingURL=rag-metadata.d.ts.map

package/dist/core/rag-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-metadata.d.ts","sourceRoot":"","sources":["../../src/core/rag-metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAMjE"}

package/dist/core/rag-metadata.js

@@ -0,0 +1,13 @@
+/**
+ * Optional recency boost for RAG hits using ISO metadata `updatedAt`.
+ */
+export function recencyScoreMultiplier(updatedAt) {
+    if (!updatedAt)
+        return 1;
+    const t = Date.parse(updatedAt);
+    if (Number.isNaN(t))
+        return 1;
+    const days = (Date.now() - t) / (86400 * 1000);
+    return 1 + 0.15 * Math.exp(-Math.max(0, days) / 14);
+}
+//# sourceMappingURL=rag-metadata.js.map

package/dist/core/rag-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-metadata.js","sourceRoot":"","sources":["../../src/core/rag-metadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAkB;IACvD,IAAI,CAAC,SAAS;QAAE,OAAO,CAAC,CAAC;IACzB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC9B,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/core/rag-metadata.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rag-metadata.test.d.ts.map

package/dist/core/rag-metadata.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-metadata.test.d.ts","sourceRoot":"","sources":["../../src/core/rag-metadata.test.ts"],"names":[],"mappings":""}