@ai-coders/context 0.4.0 → 0.5.0

package/dist/fragments/store.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Fragment Store - In-memory storage with file persistence
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryFragmentStore = void 0;
+exports.createFragmentStore = createFragmentStore;
+/**
+ * In-memory fragment store with optional file persistence
+ */
+class InMemoryFragmentStore {
+    constructor() {
+        this.fragments = new Map();
+    }
+    add(fragment) {
+        this.fragments.set(fragment.id, fragment);
+    }
+    addAll(fragments) {
+        for (const fragment of fragments) {
+            this.add(fragment);
+        }
+    }
+    get(id) {
+        return this.fragments.get(id);
+    }
+    query(query) {
+        let results = Array.from(this.fragments.values());
+        // Filter by types
+        if (query.types?.length) {
+            results = results.filter((f) => query.types.includes(f.type));
+        }
+        // Filter by scope
+        if (query.scope?.length) {
+            results = results.filter((f) => query.scope.includes(f.meta.scope));
+        }
+        // Filter by tags
+        if (query.tags?.include?.length) {
+            results = results.filter((f) => query.tags.include.some((tag) => f.meta.tags.includes(tag)));
+        }
+        if (query.tags?.exclude?.length) {
+            results = results.filter((f) => !query.tags.exclude.some((tag) => f.meta.tags.includes(tag)));
+        }
+        // Filter by related files
+        if (query.relatedTo?.files?.length) {
+            const patterns = query.relatedTo.files;
+            results = results.filter((f) => f.refs.files.some((file) => patterns.some((pattern) => file.includes(pattern))));
+        }
+        // Filter by related symbols
+        if (query.relatedTo?.symbols?.length) {
+            const symbols = query.relatedTo.symbols;
+            results = results.filter((f) => f.refs.symbols.some((sym) => symbols.includes(sym)));
+        }
+        // Sort by orderBy
+        if (query.orderBy) {
+            results = this.sortFragments(results, query.orderBy);
+        }
+        // Apply limit
+        if (query.limit && query.limit > 0) {
+            results = results.slice(0, query.limit);
+        }
+        return results;
+    }
+    sortFragments(fragments, orderBy) {
+        switch (orderBy) {
+            case 'priority':
+                return [...fragments].sort((a, b) => b.meta.priority - a.meta.priority);
+            case 'freshness':
+                return [...fragments].sort((a, b) => {
+                    const aTime = a.meta.freshness?.getTime() ?? 0;
+                    const bTime = b.meta.freshness?.getTime() ?? 0;
+                    return bTime - aTime;
+                });
+            case 'relevance':
+                // For now, relevance is same as priority
+                // Can be enhanced with scoring based on query context
+                return [...fragments].sort((a, b) => b.meta.priority - a.meta.priority);
+            default:
+                return fragments;
+        }
+    }
+    all() {
+        return Array.from(this.fragments.values());
+    }
+    clear() {
+        this.fragments.clear();
+    }
+    count() {
+        return this.fragments.size;
+    }
+    toJSON() {
+        const data = Array.from(this.fragments.values()).map((f) => ({
+            ...f,
+            meta: {
+                ...f.meta,
+                freshness: f.meta.freshness?.toISOString(),
+            },
+        }));
+        return JSON.stringify(data, null, 2);
+    }
+    fromJSON(json) {
+        const data = JSON.parse(json);
+        this.clear();
+        for (const item of data) {
+            const fragment = {
+                ...item,
+                meta: {
+                    ...item.meta,
+                    freshness: item.meta.freshness
+                        ? new Date(item.meta.freshness)
+                        : undefined,
+                },
+            };
+            this.add(fragment);
+        }
+    }
+    // Additional utility methods
+    /**
+     * Get fragments by type
+     */
+    byType(type) {
+        return this.query({ types: [type] });
+    }
+    /**
+     * Get fragments by scope
+     */
+    byScope(scope) {
+        return this.query({ scope: [scope] });
+    }
+    /**
+     * Get fragments related to a file path
+     */
+    relatedToFile(filePath) {
+        return this.query({ relatedTo: { files: [filePath] } });
+    }
+    /**
+     * Get fragments related to a symbol
+     */
+    relatedToSymbol(symbol) {
+        return this.query({ relatedTo: { symbols: [symbol] } });
+    }
+    /**
+     * Get high priority fragments (priority >= threshold)
+     */
+    highPriority(threshold = 7) {
+        return this.all().filter((f) => f.meta.priority >= threshold);
+    }
+    /**
+     * Get fragments with specific tags
+     */
+    withTags(tags) {
+        return this.query({ tags: { include: tags } });
+    }
+}
+exports.InMemoryFragmentStore = InMemoryFragmentStore;
+/**
+ * Create a new in-memory fragment store
+ */
+function createFragmentStore() {
+    return new InMemoryFragmentStore();
+}
+//# sourceMappingURL=store.js.map

package/dist/fragments/store.js.map

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

package/dist/fragments/types.d.ts

@@ -0,0 +1,241 @@
+/**
+ * Context Fragment System Types
+ *
+ * Atomic, typed pieces of context that AI can query, filter, and compose freely.
+ */
+export type FragmentType = 'project-overview' | 'module' | 'file-summary' | 'type-definition' | 'function' | 'api-endpoint' | 'component' | 'dependency-graph' | 'data-flow' | 'call-graph' | 'pattern' | 'convention' | 'example' | 'config' | 'environment' | 'command';
+export type FragmentScope = 'project' | 'module' | 'file' | 'symbol';
+/**
+ * Core fragment structure - the atomic unit of context
+ */
+export interface ContextFragment<T = Record<string, unknown>> {
+    /** Unique identifier for this fragment */
+    id: string;
+    /** Semantic type of this fragment */
+    type: FragmentType;
+    /** Structured data - machine-readable content */
+    data: T;
+    /** Human-readable summary (optional) */
+    summary?: string;
+    /** Relationships to other artifacts */
+    refs: FragmentRefs;
+    /** Metadata for filtering and ranking */
+    meta: FragmentMeta;
+}
+export interface FragmentRefs {
+    /** Source files this fragment was extracted from */
+    files: string[];
+    /** Related fragment IDs */
+    fragments: string[];
+    /** Code symbols referenced */
+    symbols: string[];
+}
+export interface FragmentMeta {
+    /** Importance ranking (1-10, higher = more important) */
+    priority: number;
+    /** Categorical tags for filtering */
+    tags: string[];
+    /** Scope level of this fragment */
+    scope: FragmentScope;
+    /** When this fragment was extracted */
+    freshness?: Date;
+}
+export interface ProjectOverviewData {
+    name: string;
+    description?: string;
+    languages: string[];
+    entryPoints: string[];
+    packageManager?: string;
+    version?: string;
+    repository?: string;
+}
+export interface ModuleData {
+    name: string;
+    path: string;
+    description?: string;
+    exports: string[];
+    dependencies: string[];
+}
+export interface FileSummaryData {
+    path: string;
+    language: string;
+    lines: number;
+    exports: string[];
+    imports: string[];
+    purpose?: string;
+}
+export interface TypeDefinitionData {
+    name: string;
+    kind: 'interface' | 'type' | 'class' | 'enum';
+    properties?: Array<{
+        name: string;
+        type: string;
+        optional?: boolean;
+    }>;
+    methods?: Array<{
+        name: string;
+        signature: string;
+    }>;
+    extends?: string[];
+    implements?: string[];
+    purpose?: string;
+}
+export interface FunctionData {
+    name: string;
+    signature: string;
+    parameters: Array<{
+        name: string;
+        type: string;
+    }>;
+    returnType: string;
+    async: boolean;
+    exported: boolean;
+    purpose?: string;
+}
+export interface ApiEndpointData {
+    method: string;
+    path: string;
+    handler: string;
+    parameters?: Array<{
+        name: string;
+        in: 'path' | 'query' | 'body';
+        type: string;
+    }>;
+    responses?: Array<{
+        status: number;
+        description: string;
+    }>;
+}
+export interface ComponentData {
+    name: string;
+    path: string;
+    props?: Array<{
+        name: string;
+        type: string;
+        required?: boolean;
+    }>;
+    hooks?: string[];
+    children?: string[];
+}
+export interface DependencyGraphData {
+    nodes: Array<{
+        id: string;
+        type: 'file' | 'module' | 'package';
+    }>;
+    edges: Array<{
+        from: string;
+        to: string;
+        type: 'imports' | 'exports' | 'depends';
+    }>;
+}
+export interface PatternData {
+    name: string;
+    description: string;
+    locations: string[];
+    examples?: string[];
+}
+export interface ConventionData {
+    name: string;
+    description: string;
+    examples: string[];
+    enforcement?: 'strict' | 'recommended' | 'optional';
+}
+export interface ConfigData {
+    name: string;
+    path: string;
+    format: 'json' | 'yaml' | 'toml' | 'env' | 'ts';
+    keys: string[];
+    purpose?: string;
+}
+export interface CommandData {
+    name: string;
+    command: string;
+    description?: string;
+    options?: Array<{
+        flag: string;
+        description: string;
+    }>;
+}
+export type ProjectOverviewFragment = ContextFragment<ProjectOverviewData>;
+export type ModuleFragment = ContextFragment<ModuleData>;
+export type FileSummaryFragment = ContextFragment<FileSummaryData>;
+export type TypeDefinitionFragment = ContextFragment<TypeDefinitionData>;
+export type FunctionFragment = ContextFragment<FunctionData>;
+export type ApiEndpointFragment = ContextFragment<ApiEndpointData>;
+export type ComponentFragment = ContextFragment<ComponentData>;
+export type DependencyGraphFragment = ContextFragment<DependencyGraphData>;
+export type PatternFragment = ContextFragment<PatternData>;
+export type ConventionFragment = ContextFragment<ConventionData>;
+export type ConfigFragment = ContextFragment<ConfigData>;
+export type CommandFragment = ContextFragment<CommandData>;
+export interface FragmentQuery {
+    /** Filter by fragment types */
+    types?: FragmentType[];
+    /** Filter by tags */
+    tags?: {
+        include?: string[];
+        exclude?: string[];
+    };
+    /** Filter by scope */
+    scope?: FragmentScope[];
+    /** Filter by relevance to files or symbols */
+    relatedTo?: {
+        files?: string[];
+        symbols?: string[];
+    };
+    /** Maximum number of results */
+    limit?: number;
+    /** Ordering strategy */
+    orderBy?: 'priority' | 'freshness' | 'relevance';
+}
+export type CompositionStrategy = 'priority' | 'expand' | 'task';
+export interface CompositionOptions {
+    /** Strategy for selecting and ordering fragments */
+    strategy: CompositionStrategy;
+    /** Maximum tokens in output (approximate) */
+    maxTokens?: number;
+    /** For 'expand' strategy: starting symbol or file */
+    seed?: string;
+    /** For 'expand' strategy: depth of graph traversal */
+    depth?: number;
+    /** For 'task' strategy: task description for relevance scoring */
+    task?: string;
+}
+export type RenderFormat = 'json' | 'markdown' | 'compact';
+export interface RenderOptions {
+    /** Output format */
+    format: RenderFormat;
+    /** Include metadata in output */
+    includeMeta?: boolean;
+    /** Include refs in output */
+    includeRefs?: boolean;
+}
+export interface FragmentStore {
+    /** Add a fragment to the store */
+    add(fragment: ContextFragment<unknown>): void;
+    /** Add multiple fragments */
+    addAll(fragments: ContextFragment<unknown>[]): void;
+    /** Get a fragment by ID */
+    get(id: string): ContextFragment<unknown> | undefined;
+    /** Query fragments */
+    query(query: FragmentQuery): ContextFragment<unknown>[];
+    /** Get all fragments */
+    all(): ContextFragment<unknown>[];
+    /** Clear all fragments */
+    clear(): void;
+    /** Get fragment count */
+    count(): number;
+    /** Export to JSON */
+    toJSON(): string;
+    /** Import from JSON */
+    fromJSON(json: string): void;
+}
+export interface FragmentExtractor<TInput = unknown> {
+    /** Unique name for this extractor */
+    name: string;
+    /** Fragment types this extractor produces */
+    produces: FragmentType[];
+    /** Extract fragments from input */
+    extract(input: TInput): ContextFragment<unknown>[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/fragments/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Context Fragment System Types
+ *
+ * Atomic, typed pieces of context that AI can query, filter, and compose freely.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/fragments/types.js.map

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

package/dist/generators/agents/agentGenerator.d.ts

@@ -1,9 +1,16 @@
 import { RepoStructure } from '../../types';
+interface AgentGenerationConfig {
+    selectedAgents?: string[];
+    semantic?: boolean;
+}
 export declare class AgentGenerator {
     private readonly docTouchpoints;
+    private analyzer?;
     constructor(..._legacyArgs: unknown[]);
-    generateAgentPrompts(repoStructure: RepoStructure, outputDir: string, selectedAgentTypes?: string[], verbose?: boolean): Promise<number>;
+    generateAgentPrompts(repoStructure: RepoStructure, outputDir: string, config?: AgentGenerationConfig | string[], verbose?: boolean): Promise<number>;
+    private getRelevantSymbolsForAgent;
     private resolveAgentSelection;
     private buildContext;
 }
+export {};
 //# sourceMappingURL=agentGenerator.d.ts.map

package/dist/generators/agents/agentGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAgB5C,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAW7B;gBAEU,GAAG,WAAW,EAAE,OAAO,EAAE;IAG/B,oBAAoB,CACxB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,kBAAkB,CAAC,EAAE,MAAM,EAAE,EAC7B,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,MAAM,CAAC;IAuBlB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,YAAY;CAerB"}
+{"version":3,"file":"agentGenerator.d.ts","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAa5C,UAAU,qBAAqB;IAC7B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAS7B;IAEF,OAAO,CAAC,QAAQ,CAAC,CAAmB;gBAExB,GAAG,WAAW,EAAE,OAAO,EAAE;IAE/B,oBAAoB,CACxB,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,qBAAqB,GAAG,MAAM,EAAO,EAC7C,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,MAAM,CAAC;IAoDlB,OAAO,CAAC,0BAA0B;IA2FlC,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,YAAY;CAgBrB"}

package/dist/generators/agents/agentGenerator.js

@@ -39,29 +39,46 @@ const shared_1 = require("../shared");
 const agentTypes_1 = require("./agentTypes");
 const templates_1 = require("./templates");
 const guideRegistry_1 = require("../documentation/guideRegistry");
+const semantic_1 = require("../../services/semantic");
 class AgentGenerator {
     constructor(..._legacyArgs) {
         this.docTouchpoints = [
             {
                 title: 'Documentation Index',
-                path: '../docs/README.md',
-                marker: 'agent-update:docs-index'
+                path: '../docs/README.md'
             },
             ...guideRegistry_1.DOCUMENT_GUIDES.map(guide => ({
                 title: guide.title,
-                path: `../docs/${guide.file}`,
-                marker: guide.marker
+                path: `../docs/${guide.file}`
             }))
         ];
     }
-    async generateAgentPrompts(repoStructure, outputDir, selectedAgentTypes, verbose = false) {
+    async generateAgentPrompts(repoStructure, outputDir, config = {}, verbose = false) {
+        // Support legacy API: if config is an array, treat it as selectedAgents
+        const normalizedConfig = Array.isArray(config)
+            ? { selectedAgents: config }
+            : config;
         const agentsDir = path.join(outputDir, 'agents');
         await shared_1.GeneratorUtils.ensureDirectoryAndLog(agentsDir, verbose, 'Generating agent scaffold in');
-        const context = this.buildContext(repoStructure);
-        const agentTypes = this.resolveAgentSelection(selectedAgentTypes);
+        // Perform semantic analysis if enabled
+        let semantics;
+        if (normalizedConfig.semantic) {
+            shared_1.GeneratorUtils.logProgress('Running semantic analysis for agents...', verbose);
+            this.analyzer = new semantic_1.CodebaseAnalyzer();
+            try {
+                semantics = await this.analyzer.analyze(repoStructure.rootPath);
+                shared_1.GeneratorUtils.logProgress(`Analyzed ${semantics.stats.totalFiles} files, found ${semantics.stats.totalSymbols} symbols`, verbose);
+            }
+            catch (error) {
+                shared_1.GeneratorUtils.logError('Semantic analysis failed, continuing without it', error, verbose);
+            }
+        }
+        const context = this.buildContext(repoStructure, semantics);
+        const agentTypes = this.resolveAgentSelection(normalizedConfig.selectedAgents);
         let created = 0;
         for (const agentType of agentTypes) {
-            const content = (0, templates_1.renderAgentPlaybook)(agentType, context.topLevelDirectories, this.docTouchpoints);
+            const relevantSymbols = this.getRelevantSymbolsForAgent(agentType, semantics);
+            const content = (0, templates_1.renderAgentPlaybook)(agentType, context.topLevelDirectories, this.docTouchpoints, semantics, relevantSymbols, repoStructure.rootPath);
             const filePath = path.join(agentsDir, `${agentType}.md`);
             await shared_1.GeneratorUtils.writeFileWithLogging(filePath, content, verbose, `Created ${agentType}.md`);
             created += 1;
@@ -72,6 +89,86 @@ class AgentGenerator {
         created += 1;
         return created;
     }
+    getRelevantSymbolsForAgent(agentType, semantics) {
+        if (!semantics)
+            return [];
+        const { symbols } = semantics;
+        let relevantSymbols = [];
+        // Filter symbols based on agent type
+        switch (agentType) {
+            case 'test-writer':
+                // Test writer needs test-related symbols
+                relevantSymbols = [
+                    ...symbols.functions.filter(s => /test|spec|mock|stub/i.test(s.name)),
+                    ...symbols.classes.filter(s => /test|spec/i.test(s.name)),
+                ];
+                break;
+            case 'code-reviewer':
+            case 'refactoring-specialist':
+                // These need main classes and interfaces
+                relevantSymbols = [
+                    ...symbols.classes.filter(s => s.exported),
+                    ...symbols.interfaces.filter(s => s.exported),
+                ];
+                break;
+            case 'documentation-writer':
+                // Documentation writer needs exported symbols
+                relevantSymbols = [
+                    ...symbols.classes.filter(s => s.exported),
+                    ...symbols.interfaces.filter(s => s.exported),
+                    ...symbols.functions.filter(s => s.exported),
+                    ...symbols.types.filter(s => s.exported),
+                ];
+                break;
+            case 'security-auditor':
+                // Security auditor needs auth-related symbols
+                relevantSymbols = [
+                    ...symbols.functions.filter(s => /auth|security|crypt|token|password|secret/i.test(s.name)),
+                    ...symbols.classes.filter(s => /auth|security|guard|policy/i.test(s.name)),
+                ];
+                break;
+            case 'performance-optimizer':
+                // Performance needs cache, async, and data processing symbols
+                relevantSymbols = [
+                    ...symbols.functions.filter(s => /cache|async|batch|queue|pool/i.test(s.name)),
+                    ...symbols.classes.filter(s => /cache|pool|buffer|queue/i.test(s.name)),
+                ];
+                break;
+            case 'database-specialist':
+                // Database specialist needs repository and model symbols
+                relevantSymbols = [
+                    ...symbols.classes.filter(s => /repository|model|entity|schema|migration/i.test(s.name)),
+                    ...symbols.interfaces.filter(s => /repository|model|entity/i.test(s.name)),
+                ];
+                break;
+            case 'backend-specialist':
+                // Backend needs services, controllers, handlers
+                relevantSymbols = [
+                    ...symbols.classes.filter(s => /service|controller|handler|middleware/i.test(s.name)),
+                ];
+                break;
+            case 'frontend-specialist':
+                // Frontend needs components and hooks
+                relevantSymbols = [
+                    ...symbols.functions.filter(s => /^use[A-Z]/i.test(s.name)), // hooks
+                    ...symbols.classes.filter(s => /component|view|page|screen/i.test(s.name)),
+                ];
+                break;
+            default:
+                // Default: top exported symbols
+                relevantSymbols = [
+                    ...symbols.classes.filter(s => s.exported).slice(0, 5),
+                    ...symbols.interfaces.filter(s => s.exported).slice(0, 5),
+                ];
+        }
+        // Convert to KeySymbolInfo and limit
+        return relevantSymbols.slice(0, 15).map(s => ({
+            name: s.name,
+            kind: s.kind,
+            file: s.location.file,
+            line: s.location.line,
+        }));
+    }
     resolveAgentSelection(selected) {
         if (!selected || selected.length === 0) {
             return agentTypes_1.AGENT_TYPES;
@@ -80,7 +177,7 @@ class AgentGenerator {
         const filtered = selected.filter((agent) => allowed.has(agent));
         return (filtered.length > 0 ? filtered : agentTypes_1.AGENT_TYPES);
     }
-    buildContext(repoStructure) {
+    buildContext(repoStructure, semantics) {
         const directorySet = new Set();
         repoStructure.directories.forEach(dir => {
             const [firstSegment] = dir.relativePath.split(/[\\/]/).filter(Boolean);
@@ -89,7 +186,8 @@ class AgentGenerator {
             }
         });
         return {
-            topLevelDirectories: Array.from(directorySet).sort()
+            topLevelDirectories: Array.from(directorySet).sort(),
+            semantics
         };
     }
 }

package/dist/generators/agents/agentGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentGenerator.js","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2CAA6B;AAE7B,sCAA2C;AAC3C,6CAAsD;AACtD,2CAAoE;AACpE,kEAAiE;AAYjE,MAAa,cAAc;IAczB,YAAY,GAAG,WAAsB;QAbpB,mBAAc,GAAoB;YACjD;gBACE,KAAK,EAAE,qBAAqB;gBAC5B,IAAI,EAAE,mBAAmB;gBACzB,MAAM,EAAE,yBAAyB;aAClC;YACD,GAAG,+BAAe,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC/B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,IAAI,EAAE,WAAW,KAAK,CAAC,IAAI,EAAE;gBAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;SACJ,CAAC;IAEsC,CAAC;IAGzC,KAAK,CAAC,oBAAoB,CACxB,aAA4B,EAC5B,SAAiB,EACjB,kBAA6B,EAC7B,UAAmB,KAAK;QAExB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,uBAAc,CAAC,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,8BAA8B,CAAC,CAAC;QAE/F,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QACjD,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;QAElE,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,IAAA,+BAAmB,EAAC,SAAS,EAAE,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;YACjG,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,SAAS,KAAK,CAAC,CAAC;YACzD,MAAM,uBAAc,CAAC,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,SAAS,KAAK,CAAC,CAAC;YACjG,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACpD,MAAM,YAAY,GAAG,IAAA,4BAAgB,EAAC,UAAU,CAAC,CAAC;QAClD,MAAM,uBAAc,CAAC,oBAAoB,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;QACjG,OAAO,IAAI,CAAC,CAAC;QAEb,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,qBAAqB,CAAC,QAAmB;QAC/C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,wBAAW,CAAC;QACrB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAY,wBAAW,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAsB,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAkB,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,wBAAW,CAAyB,CAAC;IAChF,CAAC;IAEO,YAAY,CAAC,aAA4B;QAC/C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;QAEvC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACtC,MAAM,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACvE,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE;SACrD,CAAC;IACJ,CAAC;CAEF;AAtED,wCAsEC"}
+{"version":3,"file":"agentGenerator.js","sourceRoot":"","sources":["../../../src/generators/agents/agentGenerator.ts"],"names":[],"mappings":"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"}

package/dist/generators/agents/templates/playbookTemplate.d.ts

@@ -1,4 +1,5 @@
 import { AgentType } from '../agentTypes';
-import { DocTouchpoint } from './types';
-export declare function renderAgentPlaybook(agentType: AgentType, topLevelDirectories: string[], touchpoints: DocTouchpoint[]): string;
+import { DocTouchpoint, KeySymbolInfo } from './types';
+import { SemanticContext } from '../../../services/semantic';
+export declare function renderAgentPlaybook(agentType: AgentType, topLevelDirectories: string[], touchpoints: DocTouchpoint[], semantics?: SemanticContext, relevantSymbols?: KeySymbolInfo[], repoRoot?: string): string;
 //# sourceMappingURL=playbookTemplate.d.ts.map

package/dist/generators/agents/templates/playbookTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playbookTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/playbookTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,mBAAmB,EAAE,MAAM,EAAE,EAC7B,WAAW,EAAE,aAAa,EAAE,GAC3B,MAAM,CAkFR"}
+{"version":3,"file":"playbookTemplate.d.ts","sourceRoot":"","sources":["../../../../src/generators/agents/templates/playbookTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAwB,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAgH7D,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,mBAAmB,EAAE,MAAM,EAAE,EAC7B,WAAW,EAAE,aAAa,EAAE,EAC5B,SAAS,CAAC,EAAE,eAAe,EAC3B,eAAe,CAAC,EAAE,aAAa,EAAE,EACjC,QAAQ,GAAE,MAAsB,GAC/B,MAAM,CAoDR"}