agcel 1.0.4 → 2.0.0

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

@@ -0,0 +1,12 @@
+import { describe, expect, it } from 'vitest';
+import { recencyScoreMultiplier } from './rag-metadata.js';
+describe('recencyScoreMultiplier', () => {
+    it('Given recent updatedAt when scoring then multiplier is above one', () => {
+        const recent = new Date().toISOString();
+        expect(recencyScoreMultiplier(recent)).toBeGreaterThan(1);
+    });
+    it('Given invalid date when scoring then multiplier is one', () => {
+        expect(recencyScoreMultiplier('not-a-date')).toBe(1);
+    });
+});
+//# sourceMappingURL=rag-metadata.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rag-metadata.test.js","sourceRoot":"","sources":["../../src/core/rag-metadata.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,sBAAsB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,18 @@
+export interface RagSearchResult {
+    id: string;
+    content: string;
+    score: number;
+    /** Present when the backend returns document metadata. */
+    metadata?: Record<string, string>;
+}
+/**
+ * Pluggable retrieval backend used by {@link ContextManager}.
+ */
+export interface IRagEngine {
+    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>;
+}
+//# sourceMappingURL=rag-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rag-types.d.ts","sourceRoot":"","sources":["../../src/core/rag-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtC,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC9B,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACrC"}

package/dist/core/rag-types.js

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

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

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

package/dist/core/read-agcel-config.d.ts

@@ -0,0 +1,3 @@
+import type { AgcelConfig } from './agcel-config.js';
+export declare function readAgcelConfig(basePath: string): Promise<AgcelConfig>;
+//# sourceMappingURL=read-agcel-config.d.ts.map

package/dist/core/read-agcel-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-agcel-config.d.ts","sourceRoot":"","sources":["../../src/core/read-agcel-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQ5E"}

package/dist/core/read-agcel-config.js

@@ -0,0 +1,13 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+export async function readAgcelConfig(basePath) {
+    try {
+        const configPath = path.join(basePath, '.agcel', 'config.json');
+        const raw = await fs.readFile(configPath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=read-agcel-config.js.map

package/dist/core/read-agcel-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-agcel-config.js","sourceRoot":"","sources":["../../src/core/read-agcel-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/core/registry.d.ts

@@ -0,0 +1,9 @@
+import type { Agent, Skill } from './schema.js';
+export declare class Registry {
+    private basePath;
+    constructor(basePath?: string);
+    loadAgents(): Promise<Agent[]>;
+    loadSkills(): Promise<Skill[]>;
+    private loadFiles;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAqBhD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,CAAC,EAAE,MAAM;IAIvB,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAK9B,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAKtB,SAAS;CAoCxB"}

package/dist/core/registry.js

@@ -0,0 +1,75 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { parse as parseYaml } from 'yaml';
+import { AgentSchema, SkillSchema } from './schema.js';
+/**
+ * Extract YAML frontmatter from a Markdown file.
+ * Expects: ---\n<yaml>\n---\n<body>
+ * Returns the parsed YAML object with `systemPrompt` set to the markdown body.
+ */
+function parseMarkdownFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match)
+        return null;
+    const frontmatter = match[1];
+    const body = match[2].trim();
+    const data = parseYaml(frontmatter);
+    if (body) {
+        data['systemPrompt'] = body;
+    }
+    return data;
+}
+const SUPPORTED_EXTENSIONS = ['.json', '.yaml', '.yml', '.md'];
+export class Registry {
+    basePath;
+    constructor(basePath) {
+        this.basePath = basePath || path.join(process.cwd(), '.agcel', 'registry');
+    }
+    async loadAgents() {
+        const agentsPath = path.join(this.basePath, 'agents');
+        return this.loadFiles(agentsPath, AgentSchema);
+    }
+    async loadSkills() {
+        const skillsPath = path.join(this.basePath, 'skills');
+        return this.loadFiles(skillsPath, SkillSchema);
+    }
+    async loadFiles(dirPath, schema) {
+        try {
+            const files = await fs.readdir(dirPath);
+            const results = [];
+            for (const file of files) {
+                const ext = path.extname(file).toLowerCase();
+                if (!SUPPORTED_EXTENSIONS.includes(ext))
+                    continue;
+                const content = await fs.readFile(path.join(dirPath, file), 'utf-8');
+                let parsed;
+                if (ext === '.json') {
+                    parsed = JSON.parse(content);
+                }
+                else if (ext === '.yaml' || ext === '.yml') {
+                    parsed = parseYaml(content);
+                }
+                else if (ext === '.md') {
+                    parsed = parseMarkdownFrontmatter(content);
+                    if (!parsed)
+                        continue; // Skip markdown without valid frontmatter
+                }
+                try {
+                    const validated = schema.parse(parsed);
+                    results.push(validated);
+                }
+                catch {
+                    // Skip files that don't match the schema
+                }
+            }
+            return results;
+        }
+        catch (e) {
+            if (e.code === 'ENOENT') {
+                return [];
+            }
+            throw e;
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

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

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

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

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

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

package/dist/core/registry.test.js

@@ -0,0 +1,128 @@
+import * as path from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { Registry } from './registry.js';
+describe('Registry', () => {
+    it('Given repo sample registry when loading skills then python testing debugging exist', async () => {
+        const root = path.join(process.cwd(), '.agcel', 'registry');
+        const registry = new Registry(root);
+        const skills = await registry.loadSkills();
+        const names = skills.map((s) => s.name);
+        expect(names).toEqual(expect.arrayContaining([
+            'python',
+            'testing',
+            'debugging',
+            'react-skill',
+            'product-discovery',
+            'requirements-clarity',
+            'backlog-roadmap',
+            'ux-product-design',
+            'design-systems',
+            'accessibility-design',
+            'web-ui-patterns',
+            'mobile-platform-design',
+            'flutter',
+            'java',
+            'nodejs-typescript',
+            'api-security',
+            'observability',
+            'technical-writing',
+            'system-architecture'
+        ]));
+    });
+    it('Given repo sample registry when loading agents then backend-developer resolves with multi-runtime skills', async () => {
+        const root = path.join(process.cwd(), '.agcel', 'registry');
+        const registry = new Registry(root);
+        const agents = await registry.loadAgents();
+        const dev = agents.find((a) => a.name === 'backend-developer');
+        expect(dev).toBeDefined();
+        expect(dev?.skills).toEqual(expect.arrayContaining(['python', 'java', 'nodejs-typescript', 'testing', 'debugging']));
+        expect(dev?.guardrails?.some((g) => g.id === 'backend-dev-soft-certainty')).toBe(true);
+    });
+    it('Given repo sample registry when loading agents then product-owner resolves with PM skills', async () => {
+        const root = path.join(process.cwd(), '.agcel', 'registry');
+        const registry = new Registry(root);
+        const agents = await registry.loadAgents();
+        const po = agents.find((a) => a.name === 'product-owner');
+        expect(po).toBeDefined();
+        expect(po?.skills).toEqual(expect.arrayContaining(['product-discovery', 'requirements-clarity', 'backlog-roadmap']));
+        expect(po?.guardrails?.some((g) => g.id === 'po-soft-certainty')).toBe(true);
+    });
+    it('Given repo sample registry when loading agents then product-designer resolves with full design skill stack', async () => {
+        const root = path.join(process.cwd(), '.agcel', 'registry');
+        const registry = new Registry(root);
+        const agents = await registry.loadAgents();
+        const designer = agents.find((a) => a.name === 'product-designer');
+        expect(designer).toBeDefined();
+        expect(designer?.skills).toEqual(expect.arrayContaining([
+            'ux-product-design',
+            'design-systems',
+            'accessibility-design',
+            'web-ui-patterns',
+            'mobile-platform-design'
+        ]));
+        expect(designer?.guardrails?.some((g) => g.id === 'product-design-soft-certainty')).toBe(true);
+    });
+    it('Given repo sample registry when loading agents then react-frontend-developer resolves with React stack', async () => {
+        const root = path.join(process.cwd(), '.agcel', 'registry');
+        const registry = new Registry(root);
+        const agents = await registry.loadAgents();
+        const fe = agents.find((a) => a.name === 'react-frontend-developer');
+        expect(fe).toBeDefined();
+        expect(fe?.skills).toEqual(expect.arrayContaining([
+            'react-skill',
+            'testing',
+            'debugging',
+            'accessibility-design',
+            'web-ui-patterns'
+        ]));
+        expect(fe?.guardrails?.some((g) => g.id === 'react-fe-soft-certainty')).toBe(true);
+    });
+    it('Given repo sample registry when loading agents then flutter-developer resolves with Flutter stack', async () => {
+        const root = path.join(process.cwd(), '.agcel', 'registry');
+        const registry = new Registry(root);
+        const agents = await registry.loadAgents();
+        const flutter = agents.find((a) => a.name === 'flutter-developer');
+        expect(flutter).toBeDefined();
+        expect(flutter?.skills).toEqual(expect.arrayContaining([
+            'flutter',
+            'testing',
+            'debugging',
+            'accessibility-design',
+            'mobile-platform-design'
+        ]));
+        expect(flutter?.guardrails?.some((g) => g.id === 'flutter-dev-soft-certainty')).toBe(true);
+    });
+    it('Given repo sample registry when loading agents then security-engineer uses api-security stack', async () => {
+        const root = path.join(process.cwd(), '.agcel', 'registry');
+        const registry = new Registry(root);
+        const agents = await registry.loadAgents();
+        const sec = agents.find((a) => a.name === 'security-engineer');
+        expect(sec?.skills).toEqual(expect.arrayContaining(['api-security', 'testing', 'debugging']));
+        expect(sec?.guardrails?.some((g) => g.id === 'sec-eng-soft-certainty')).toBe(true);
+    });
+    it('Given repo sample registry when loading agents then sre-engineer uses observability stack', async () => {
+        const root = path.join(process.cwd(), '.agcel', 'registry');
+        const registry = new Registry(root);
+        const agents = await registry.loadAgents();
+        const sre = agents.find((a) => a.name === 'sre-engineer');
+        expect(sre?.skills).toEqual(expect.arrayContaining(['observability', 'debugging', 'testing']));
+        expect(sre?.guardrails?.some((g) => g.id === 'sre-soft-certainty')).toBe(true);
+    });
+    it('Given repo sample registry when loading agents then technical-writer pairs writing with requirements', async () => {
+        const root = path.join(process.cwd(), '.agcel', 'registry');
+        const registry = new Registry(root);
+        const agents = await registry.loadAgents();
+        const tw = agents.find((a) => a.name === 'technical-writer');
+        expect(tw?.skills).toEqual(expect.arrayContaining(['technical-writing', 'requirements-clarity']));
+        expect(tw?.guardrails?.some((g) => g.id === 'tech-writer-soft-certainty')).toBe(true);
+    });
+    it('Given repo sample registry when loading agents then solution-architect uses architecture and ADR-oriented writing', async () => {
+        const root = path.join(process.cwd(), '.agcel', 'registry');
+        const registry = new Registry(root);
+        const agents = await registry.loadAgents();
+        const sa = agents.find((a) => a.name === 'solution-architect');
+        expect(sa?.skills).toEqual(expect.arrayContaining(['system-architecture', 'technical-writing']));
+        expect(sa?.guardrails?.some((g) => g.id === 'solution-arch-soft-certainty')).toBe(true);
+    });
+});
+//# sourceMappingURL=registry.test.js.map

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

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

package/dist/core/schema.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+export declare const GuardrailSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodString;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+    pattern: z.ZodOptional<z.ZodString>;
+    forbiddenTerms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    maxLength: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const SkillSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    systemPrompt: z.ZodString;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    guardrails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        pattern: z.ZodOptional<z.ZodString>;
+        forbiddenTerms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const AgentSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    role: z.ZodString;
+    skills: z.ZodArray<z.ZodString>;
+    fallbackAgent: z.ZodOptional<z.ZodString>;
+    guardrails: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+        }>;
+        pattern: z.ZodOptional<z.ZodString>;
+        forbiddenTerms: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type Guardrail = z.infer<typeof GuardrailSchema>;
+export type Skill = z.infer<typeof SkillSchema>;
+export type Agent = z.infer<typeof AgentSchema>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,eAAe;;;;;;;;;;iBAa1B,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;iBAMtB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;iBAOtB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACxD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC"}

package/dist/core/schema.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export const GuardrailSchema = z.object({
+    /** Rule identifier */
+    id: z.string(),
+    /** Human-readable description */
+    description: z.string(),
+    /** Severity: 'error' blocks the output, 'warning' flags but passes */
+    severity: z.enum(['error', 'warning']),
+    /** Regex pattern or keyword to detect violations in agent output */
+    pattern: z.string().optional(),
+    /** List of forbidden terms/phrases */
+    forbiddenTerms: z.array(z.string()).optional(),
+    /** Maximum allowed output length (chars) */
+    maxLength: z.number().optional()
+});
+export const SkillSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    systemPrompt: z.string(),
+    tools: z.array(z.string()).optional(),
+    guardrails: z.array(GuardrailSchema).optional()
+});
+export const AgentSchema = z.object({
+    name: z.string(),
+    description: z.string(),
+    role: z.string(),
+    skills: z.array(z.string()),
+    fallbackAgent: z.string().optional(),
+    guardrails: z.array(GuardrailSchema).optional()
+});
+//# sourceMappingURL=schema.js.map

package/dist/core/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,sBAAsB;IACtB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,iCAAiC;IACjC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,sEAAsE;IACtE,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACtC,oEAAoE;IACpE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,sCAAsC;IACtC,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9C,4CAA4C;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC"}

package/dist/core/summarizer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Summarization Service.
+ * Provides context compression by extracting key sentences
+ * and trimming content to fit token budgets.
+ */
+export declare class SummarizationService {
+    private maxTokens;
+    constructor(maxTokens?: number);
+    /**
+     * Summarize a long text by extracting the most important sentences.
+     * Uses a basic extractive approach: scores sentences by keyword density.
+     */
+    summarize(text: string): string;
+    /**
+     * Check if text exceeds the token budget.
+     */
+    exceedsBudget(text: string): boolean;
+    /**
+     * Rough token estimation (1 token ≈ 4 characters for English text).
+     */
+    estimateTokens(text: string): number;
+}
+//# sourceMappingURL=summarizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../src/core/summarizer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,GAAE,MAAa;IAIpC;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IA6C/B;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGrC"}

package/dist/core/summarizer.js

@@ -0,0 +1,66 @@
+/**
+ * Summarization Service.
+ * Provides context compression by extracting key sentences
+ * and trimming content to fit token budgets.
+ */
+export class SummarizationService {
+    maxTokens;
+    constructor(maxTokens = 4000) {
+        this.maxTokens = maxTokens;
+    }
+    /**
+     * Summarize a long text by extracting the most important sentences.
+     * Uses a basic extractive approach: scores sentences by keyword density.
+     */
+    summarize(text) {
+        const sentences = text.match(/[^.!?]+[.!?]+/g) || [text];
+        if (sentences.length <= 3)
+            return text;
+        const wordFreq = new Map();
+        const words = text.toLowerCase().replace(/[^\w\s]/g, '').split(/\s+/);
+        for (const w of words) {
+            if (w.length > 2) {
+                wordFreq.set(w, (wordFreq.get(w) || 0) + 1);
+            }
+        }
+        const scored = sentences.map((sentence, index) => {
+            const sWords = sentence.toLowerCase().replace(/[^\w\s]/g, '').split(/\s+/);
+            let score = 0;
+            for (const w of sWords) {
+                score += wordFreq.get(w) || 0;
+            }
+            // Boost early sentences (likely more important)
+            score *= (1 + 1 / (index + 1));
+            return { sentence: sentence.trim(), score };
+        });
+        scored.sort((a, b) => b.score - a.score);
+        const topCount = Math.max(3, Math.ceil(sentences.length * 0.3));
+        const selected = scored.slice(0, topCount);
+        // Re-sort by original order
+        selected.sort((a, b) => {
+            const aIdx = sentences.indexOf(a.sentence);
+            const bIdx = sentences.indexOf(b.sentence);
+            return aIdx - bIdx;
+        });
+        let summary = selected.map(s => s.sentence).join(' ');
+        // Trim to token budget (rough estimate: 1 token ≈ 4 chars)
+        const charLimit = this.maxTokens * 4;
+        if (summary.length > charLimit) {
+            summary = summary.substring(0, charLimit) + '...';
+        }
+        return summary;
+    }
+    /**
+     * Check if text exceeds the token budget.
+     */
+    exceedsBudget(text) {
+        return this.estimateTokens(text) > this.maxTokens;
+    }
+    /**
+     * Rough token estimation (1 token ≈ 4 characters for English text).
+     */
+    estimateTokens(text) {
+        return Math.ceil(text.length / 4);
+    }
+}
+//# sourceMappingURL=summarizer.js.map

package/dist/core/summarizer.js.map

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

package/dist/core/text-similarity.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Token overlap / cosine similarity for short texts (intent routing, local RAG).
+ */
+export declare function tokenizeForSimilarity(text: string): Map<string, number>;
+export declare function cosineSimilarityMaps(a: Map<string, number>, b: Map<string, number>): number;
+export declare function textCosineSimilarity(a: string, b: string): number;
+//# sourceMappingURL=text-similarity.d.ts.map

package/dist/core/text-similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-similarity.d.ts","sourceRoot":"","sources":["../../src/core/text-similarity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CASvE;AAED,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACtB,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACrB,MAAM,CAmBR;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAKjE"}

package/dist/core/text-similarity.js

@@ -0,0 +1,35 @@
+/**
+ * Token overlap / cosine similarity for short texts (intent routing, local RAG).
+ */
+export function tokenizeForSimilarity(text) {
+    const terms = new Map();
+    const words = text.toLowerCase().replace(/[^\w\s]/g, '').split(/\s+/);
+    for (const word of words) {
+        if (word.length > 1) {
+            terms.set(word, (terms.get(word) || 0) + 1);
+        }
+    }
+    return terms;
+}
+export function cosineSimilarityMaps(a, b) {
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (const [term, freq] of a) {
+        normA += freq * freq;
+        const bFreq = b.get(term);
+        if (bFreq !== undefined) {
+            dotProduct += freq * bFreq;
+        }
+    }
+    for (const [, freq] of b) {
+        normB += freq * freq;
+    }
+    if (normA === 0 || normB === 0)
+        return 0;
+    return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+export function textCosineSimilarity(a, b) {
+    return cosineSimilarityMaps(tokenizeForSimilarity(a), tokenizeForSimilarity(b));
+}
+//# sourceMappingURL=text-similarity.js.map

package/dist/core/text-similarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-similarity.js","sourceRoot":"","sources":["../../src/core/text-similarity.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,CAAsB,EACtB,CAAsB;IAEtB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,KAAK,IAAI,IAAI,GAAG,IAAI,CAAC;QACrB,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,UAAU,IAAI,IAAI,GAAG,KAAK,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,KAAK,IAAI,IAAI,GAAG,IAAI,CAAC;IACvB,CAAC;IAED,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACzC,OAAO,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,CAAS,EAAE,CAAS;IACvD,OAAO,oBAAoB,CACzB,qBAAqB,CAAC,CAAC,CAAC,EACxB,qBAAqB,CAAC,CAAC,CAAC,CACzB,CAAC;AACJ,CAAC"}

package/dist/core/text-similarity.test.d.ts

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

package/dist/core/text-similarity.test.d.ts.map

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

package/dist/core/text-similarity.test.js

@@ -0,0 +1,11 @@
+import { describe, expect, it } from 'vitest';
+import { textCosineSimilarity } from './text-similarity.js';
+describe('textCosineSimilarity', () => {
+    it('Given paraphrased phrases when comparing then score is higher than unrelated text', () => {
+        const q = 'debug asyncio task cancellation';
+        const near = 'fix asyncio cancel scope bug';
+        const far = 'design figma dashboard layout';
+        expect(textCosineSimilarity(q, near)).toBeGreaterThan(textCosineSimilarity(q, far));
+    });
+});
+//# sourceMappingURL=text-similarity.test.js.map

package/dist/core/text-similarity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-similarity.test.js","sourceRoot":"","sources":["../../src/core/text-similarity.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,mFAAmF,EAAE,GAAG,EAAE;QAC3F,MAAM,CAAC,GAAG,iCAAiC,CAAC;QAC5C,MAAM,IAAI,GAAG,8BAA8B,CAAC;QAC5C,MAAM,GAAG,GAAG,+BAA+B,CAAC;QAC5C,MAAM,CAAC,oBAAoB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,eAAe,CACnD,oBAAoB,CAAC,CAAC,EAAE,GAAG,CAAC,CAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/docs-site.test.d.ts

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

package/dist/docs-site.test.d.ts.map

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

package/dist/docs-site.test.js

@@ -0,0 +1,19 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { describe, expect, it } from 'vitest';
+describe('AgCEL docs site (Starlight)', () => {
+    const docsRoot = path.join(process.cwd(), 'docs');
+    it('Given docs package when reading name then it is agcel-docs', () => {
+        const pkg = JSON.parse(fs.readFileSync(path.join(docsRoot, 'package.json'), 'utf8'));
+        expect(pkg.name).toBe('agcel-docs');
+    });
+    it('Given astro config when reading title then it identifies AgCEL', () => {
+        const cfg = fs.readFileSync(path.join(docsRoot, 'astro.config.mjs'), 'utf8');
+        expect(cfg).toContain("title: 'AgCEL'");
+    });
+    it('Given overview page when reading file then it describes the library', () => {
+        const md = fs.readFileSync(path.join(docsRoot, 'src/content/docs/guides/overview.md'), 'utf8');
+        expect(md).toContain('Agentic Context Engineering Library');
+    });
+});
+//# sourceMappingURL=docs-site.test.js.map

package/dist/docs-site.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-site.test.js","sourceRoot":"","sources":["../src/docs-site.test.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;IAElD,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAElF,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7E,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,MAAM,EAAE,GAAG,EAAE,CAAC,YAAY,CACxB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,qCAAqC,CAAC,EAC1D,MAAM,CACP,CAAC;QACF,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}