@ai-coders/context 0.3.1 → 0.5.0

package/dist/fragments/compose.js

@@ -0,0 +1,274 @@
+"use strict";
+/**
+ * Fragment Composition - Strategies for combining fragments
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.composeFragments = composeFragments;
+exports.createComposer = createComposer;
+/**
+ * Compose fragments into a coherent context using the specified strategy
+ */
+function composeFragments(fragments, options) {
+    switch (options.strategy) {
+        case 'priority':
+            return composePriority(fragments, options);
+        case 'expand':
+            return composeExpand(fragments, options);
+        case 'task':
+            return composeTask(fragments, options);
+        default:
+            return composePriority(fragments, options);
+    }
+}
+/**
+ * Priority-based composition: sort by priority, limit by tokens
+ */
+function composePriority(fragments, options) {
+    // Sort by priority (highest first)
+    const sorted = [...fragments].sort((a, b) => b.meta.priority - a.meta.priority);
+    if (!options.maxTokens) {
+        return sorted;
+    }
+    // Estimate tokens and cut off
+    return limitByTokens(sorted, options.maxTokens);
+}
+/**
+ * Graph expansion: start from a seed symbol/file, expand to related fragments
+ */
+function composeExpand(fragments, options) {
+    const seed = options.seed;
+    const depth = options.depth || 2;
+    if (!seed) {
+        return composePriority(fragments, options);
+    }
+    const result = [];
+    const visited = new Set();
+    const queue = [];
+    // Find seed fragments
+    const seedFragments = fragments.filter((f) => f.refs.symbols.includes(seed) ||
+        f.refs.files.some((file) => file.includes(seed)) ||
+        f.data &&
+            typeof f.data === 'object' &&
+            'name' in f.data &&
+            f.data.name === seed);
+    for (const fragment of seedFragments) {
+        queue.push({ fragment, level: 0 });
+    }
+    while (queue.length > 0) {
+        const { fragment, level } = queue.shift();
+        if (visited.has(fragment.id))
+            continue;
+        visited.add(fragment.id);
+        result.push(fragment);
+        if (level >= depth)
+            continue;
+        // Find related fragments
+        const related = findRelatedFragments(fragment, fragments, visited);
+        for (const relFragment of related) {
+            queue.push({ fragment: relFragment, level: level + 1 });
+        }
+    }
+    // Sort by priority within result
+    result.sort((a, b) => b.meta.priority - a.meta.priority);
+    if (options.maxTokens) {
+        return limitByTokens(result, options.maxTokens);
+    }
+    return result;
+}
+/**
+ * Task-based composition: select fragments relevant to a task description
+ */
+function composeTask(fragments, options) {
+    const task = options.task;
+    if (!task) {
+        return composePriority(fragments, options);
+    }
+    // Extract keywords from task
+    const keywords = extractKeywords(task);
+    // Score fragments by relevance to task
+    const scored = fragments.map((fragment) => ({
+        fragment,
+        score: scoreRelevance(fragment, keywords),
+    }));
+    // Sort by combined score (relevance + priority)
+    scored.sort((a, b) => {
+        const aTotal = a.score * 0.7 + a.fragment.meta.priority * 0.3;
+        const bTotal = b.score * 0.7 + b.fragment.meta.priority * 0.3;
+        return bTotal - aTotal;
+    });
+    const result = scored.map((s) => s.fragment);
+    if (options.maxTokens) {
+        return limitByTokens(result, options.maxTokens);
+    }
+    return result;
+}
+/**
+ * Find fragments related to a given fragment
+ */
+function findRelatedFragments(fragment, allFragments, visited) {
+    const related = [];
+    // By referenced fragments
+    for (const refId of fragment.refs.fragments) {
+        const refFragment = allFragments.find((f) => f.id === refId && !visited.has(f.id));
+        if (refFragment) {
+            related.push(refFragment);
+        }
+    }
+    // By shared files
+    for (const file of fragment.refs.files) {
+        const fileFragments = allFragments.filter((f) => f.refs.files.includes(file) && !visited.has(f.id));
+        related.push(...fileFragments);
+    }
+    // By shared symbols
+    for (const symbol of fragment.refs.symbols) {
+        const symbolFragments = allFragments.filter((f) => (f.refs.symbols.includes(symbol) ||
+            (f.data &&
+                typeof f.data === 'object' &&
+                'name' in f.data &&
+                f.data.name === symbol)) &&
+            !visited.has(f.id));
+        related.push(...symbolFragments);
+    }
+    // Deduplicate
+    const uniqueIds = new Set();
+    return related.filter((f) => {
+        if (uniqueIds.has(f.id))
+            return false;
+        uniqueIds.add(f.id);
+        return true;
+    });
+}
+/**
+ * Extract keywords from a task description
+ */
+function extractKeywords(task) {
+    const stopWords = new Set([
+        'a', 'an', 'the', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
+        'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would', 'could',
+        'should', 'may', 'might', 'must', 'shall', 'can', 'need', 'to', 'of',
+        'in', 'for', 'on', 'with', 'at', 'by', 'from', 'up', 'about', 'into',
+        'through', 'during', 'before', 'after', 'above', 'below', 'between',
+        'under', 'again', 'further', 'then', 'once', 'here', 'there', 'when',
+        'where', 'why', 'how', 'all', 'each', 'few', 'more', 'most', 'other',
+        'some', 'such', 'no', 'nor', 'not', 'only', 'own', 'same', 'so', 'than',
+        'too', 'very', 'just', 'and', 'but', 'if', 'or', 'because', 'as', 'until',
+        'while', 'this', 'that', 'these', 'those', 'i', 'me', 'my', 'we', 'our',
+        'you', 'your', 'it', 'its', 'add', 'create', 'new', 'implement', 'fix',
+        'update', 'change', 'modify', 'help', 'want', 'make', 'get', 'set',
+    ]);
+    return task
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter((word) => word.length > 2 && !stopWords.has(word));
+}
+/**
+ * Score a fragment's relevance to keywords
+ */
+function scoreRelevance(fragment, keywords) {
+    let score = 0;
+    const textToSearch = [
+        fragment.summary || '',
+        fragment.type,
+        ...fragment.meta.tags,
+        ...fragment.refs.symbols,
+        ...(fragment.data && typeof fragment.data === 'object'
+            ? Object.values(fragment.data)
+                .filter((v) => typeof v === 'string')
+                .map((v) => v)
+            : []),
+    ]
+        .join(' ')
+        .toLowerCase();
+    for (const keyword of keywords) {
+        if (textToSearch.includes(keyword)) {
+            score += 1;
+            // Bonus for exact symbol match
+            if (fragment.refs.symbols.some((s) => s.toLowerCase() === keyword)) {
+                score += 2;
+            }
+            // Bonus for type match
+            if (fragment.type.includes(keyword)) {
+                score += 1;
+            }
+        }
+    }
+    // Normalize by keyword count
+    return keywords.length > 0 ? score / keywords.length : 0;
+}
+/**
+ * Limit fragments by estimated token count
+ */
+function limitByTokens(fragments, maxTokens) {
+    const result = [];
+    let totalTokens = 0;
+    for (const fragment of fragments) {
+        const tokens = estimateTokens(fragment);
+        if (totalTokens + tokens > maxTokens) {
+            break;
+        }
+        result.push(fragment);
+        totalTokens += tokens;
+    }
+    return result;
+}
+/**
+ * Estimate token count for a fragment (rough approximation)
+ */
+function estimateTokens(fragment) {
+    const json = JSON.stringify(fragment);
+    // Rough estimate: ~4 chars per token
+    return Math.ceil(json.length / 4);
+}
+/**
+ * Create a composition pipeline helper
+ */
+function createComposer(store) {
+    return {
+        /**
+         * Compose by priority (default)
+         */
+        byPriority(maxTokens) {
+            return composeFragments(store.all(), {
+                strategy: 'priority',
+                maxTokens,
+            });
+        },
+        /**
+         * Compose by expanding from a seed
+         */
+        expand(seed, depth, maxTokens) {
+            return composeFragments(store.all(), {
+                strategy: 'expand',
+                seed,
+                depth,
+                maxTokens,
+            });
+        },
+        /**
+         * Compose by task relevance
+         */
+        forTask(task, maxTokens) {
+            return composeFragments(store.all(), {
+                strategy: 'task',
+                task,
+                maxTokens,
+            });
+        },
+        /**
+         * Get essential context (project overview + high priority)
+         */
+        essential(maxTokens) {
+            const essential = store
+                .all()
+                .filter((f) => f.type === 'project-overview' ||
+                f.meta.tags.includes('essential') ||
+                f.meta.priority >= 8);
+            return composeFragments(essential, {
+                strategy: 'priority',
+                maxTokens,
+            });
+        },
+    };
+}
+//# sourceMappingURL=compose.js.map

package/dist/fragments/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/fragments/compose.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAYH,4CAcC;AAgRD,wCAqDC;AAtVD;;GAEG;AACH,SAAgB,gBAAgB,CAC9B,SAAqC,EACrC,OAA2B;IAE3B,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,UAAU;YACb,OAAO,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7C,KAAK,QAAQ;YACX,OAAO,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC3C,KAAK,MAAM;YACT,OAAO,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzC;YACE,OAAO,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CACtB,SAAqC,EACrC,OAA2B;IAE3B,mCAAmC;IACnC,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAChC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAC5C,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8BAA8B;IAC9B,OAAO,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,SAAqC,EACrC,OAA2B;IAE3B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAEjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAiE,EAAE,CAAC;IAE/E,sBAAsB;IACtB,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC7B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,IAAI;YACN,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;YAC1B,MAAM,IAAI,CAAC,CAAC,IAAI;YAChB,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CACvB,CAAC;IAEF,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;QAE3C,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,SAAS;QACvC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEtB,IAAI,KAAK,IAAI,KAAK;YAAE,SAAS;QAE7B,yBAAyB;QACzB,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QACnE,KAAK,MAAM,WAAW,IAAI,OAAO,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEzD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAClB,SAAqC,EACrC,OAA2B;IAE3B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAE1B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEvC,uCAAuC;IACvC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1C,QAAQ;QACR,KAAK,EAAE,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC;KAC1C,CAAC,CAAC,CAAC;IAEJ,gDAAgD;IAChD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QAC9D,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;QAC9D,OAAO,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAE7C,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC3B,QAAkC,EAClC,YAAwC,EACxC,OAAoB;IAEpB,MAAM,OAAO,GAA+B,EAAE,CAAC;IAE/C,0BAA0B;IAC1B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5C,MAAM,WAAW,GAAG,YAAY,CAAC,IAAI,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC5C,CAAC;QACF,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACvC,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACzD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC;IACjC,CAAC;IAED,oBAAoB;IACpB,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3C,MAAM,eAAe,GAAG,YAAY,CAAC,MAAM,CACzC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC9B,CAAC,CAAC,CAAC,IAAI;gBACL,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAC1B,MAAM,IAAI,CAAC,CAAC,IAAI;gBAChB,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;YAC5B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACrB,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;IACnC,CAAC;IAED,cAAc;IACd,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1B,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QACtC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;QACxB,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO;QACnE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;QACnE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;QACpE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM;QACpE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS;QACnE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;QACpE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO;QACpE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;QACvE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO;QACzE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK;QACvE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK;QACtE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK;KACnE,CAAC,CAAC;IAEH,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,QAAkC,EAAE,QAAkB;IAC5E,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,MAAM,YAAY,GAAG;QACnB,QAAQ,CAAC,OAAO,IAAI,EAAE;QACtB,QAAQ,CAAC,IAAI;QACb,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI;QACrB,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO;QACxB,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ;YACpD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;iBACzB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;iBACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAW,CAAC;YAC5B,CAAC,CAAC,EAAE,CAAC;KACR;SACE,IAAI,CAAC,GAAG,CAAC;SACT,WAAW,EAAE,CAAC;IAEjB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,KAAK,IAAI,CAAC,CAAC;YAEX,+BAA+B;YAC/B,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC;gBACnE,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;YAED,uBAAuB;YACvB,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpC,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;QACH,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CACpB,SAAqC,EACrC,SAAiB;IAEjB,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QAExC,IAAI,WAAW,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;YACrC,MAAM;QACR,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtB,WAAW,IAAI,MAAM,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,QAAkC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtC,qCAAqC;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAoB;IACjD,OAAO;QACL;;WAEG;QACH,UAAU,CAAC,SAAkB;YAC3B,OAAO,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE;gBACnC,QAAQ,EAAE,UAAU;gBACpB,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAED;;WAEG;QACH,MAAM,CAAC,IAAY,EAAE,KAAc,EAAE,SAAkB;YACrD,OAAO,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE;gBACnC,QAAQ,EAAE,QAAQ;gBAClB,IAAI;gBACJ,KAAK;gBACL,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAED;;WAEG;QACH,OAAO,CAAC,IAAY,EAAE,SAAkB;YACtC,OAAO,gBAAgB,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE;gBACnC,QAAQ,EAAE,MAAM;gBAChB,IAAI;gBACJ,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAED;;WAEG;QACH,SAAS,CAAC,SAAkB;YAC1B,MAAM,SAAS,GAAG,KAAK;iBACpB,GAAG,EAAE;iBACL,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,kBAAkB;gBAC7B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACjC,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CACvB,CAAC;YACJ,OAAO,gBAAgB,CAAC,SAAS,EAAE;gBACjC,QAAQ,EAAE,UAAU;gBACpB,SAAS;aACV,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/fragments/extractors/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Fragment Extractors - Registry and common utilities
+ */
+import type { ContextFragment, FragmentExtractor, FragmentType } from '../types.js';
+import { RepoStructure } from '../../types.js';
+import type { SemanticContext } from '../../services/semantic/types.js';
+export interface ExtractionInput {
+    repoStructure: RepoStructure;
+    semantics?: SemanticContext;
+    packageJson?: Record<string, unknown>;
+    readme?: string;
+}
+type AnyFragment = ContextFragment<unknown>;
+export interface ExtractorRegistry {
+    extractors: FragmentExtractor<ExtractionInput>[];
+    extractAll(input: ExtractionInput): AnyFragment[];
+    getByType(type: FragmentType): FragmentExtractor<ExtractionInput>[];
+}
+/**
+ * Create the default extractor registry with all built-in extractors
+ */
+export declare function createExtractorRegistry(): ExtractorRegistry;
+export { extractProjectFragments } from './project.js';
+export { extractModuleFragments } from './module.js';
+export { extractSemanticFragments } from './semantic.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fragments/extractors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fragments/extractors/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAKxE,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,aAAa,CAAC;IAC7B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,KAAK,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,iBAAiB,CAAC,eAAe,CAAC,EAAE,CAAC;IACjD,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,EAAE,CAAC;IAClD,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,iBAAiB,CAAC,eAAe,CAAC,EAAE,CAAC;CACrE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,CAuC3D;AAGD,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/fragments/extractors/index.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * Fragment Extractors - Registry and common utilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSemanticFragments = exports.extractModuleFragments = exports.extractProjectFragments = void 0;
+exports.createExtractorRegistry = createExtractorRegistry;
+const project_js_1 = require("./project.js");
+const module_js_1 = require("./module.js");
+const semantic_js_1 = require("./semantic.js");
+/**
+ * Create the default extractor registry with all built-in extractors
+ */
+function createExtractorRegistry() {
+    const extractors = [
+        {
+            name: 'project',
+            produces: ['project-overview', 'config', 'command'],
+            extract: project_js_1.extractProjectFragments,
+        },
+        {
+            name: 'module',
+            produces: ['module', 'file-summary'],
+            extract: module_js_1.extractModuleFragments,
+        },
+        {
+            name: 'semantic',
+            produces: [
+                'type-definition',
+                'function',
+                'pattern',
+                'dependency-graph',
+            ],
+            extract: semantic_js_1.extractSemanticFragments,
+        },
+    ];
+    return {
+        extractors,
+        extractAll(input) {
+            const fragments = [];
+            for (const extractor of extractors) {
+                fragments.push(...extractor.extract(input));
+            }
+            return fragments;
+        },
+        getByType(type) {
+            return extractors.filter((e) => e.produces.includes(type));
+        },
+    };
+}
+// Re-export individual extractors
+var project_js_2 = require("./project.js");
+Object.defineProperty(exports, "extractProjectFragments", { enumerable: true, get: function () { return project_js_2.extractProjectFragments; } });
+var module_js_2 = require("./module.js");
+Object.defineProperty(exports, "extractModuleFragments", { enumerable: true, get: function () { return module_js_2.extractModuleFragments; } });
+var semantic_js_2 = require("./semantic.js");
+Object.defineProperty(exports, "extractSemanticFragments", { enumerable: true, get: function () { return semantic_js_2.extractSemanticFragments; } });
+//# sourceMappingURL=index.js.map

package/dist/fragments/extractors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fragments/extractors/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAgCH,0DAuCC;AA9DD,6CAAuD;AACvD,2CAAqD;AACrD,+CAAyD;AAkBzD;;GAEG;AACH,SAAgB,uBAAuB;IACrC,MAAM,UAAU,GAAyC;QACvD;YACE,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,CAAC,kBAAkB,EAAE,QAAQ,EAAE,SAAS,CAAC;YACnD,OAAO,EAAE,oCAAuB;SACjC;QACD;YACE,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC;YACpC,OAAO,EAAE,kCAAsB;SAChC;QACD;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE;gBACR,iBAAiB;gBACjB,UAAU;gBACV,SAAS;gBACT,kBAAkB;aACnB;YACD,OAAO,EAAE,sCAAwB;SAClC;KACF,CAAC;IAEF,OAAO;QACL,UAAU;QAEV,UAAU,CAAC,KAAsB;YAC/B,MAAM,SAAS,GAAkB,EAAE,CAAC;YACpC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,SAAS,CAAC,IAAkB;YAC1B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,kCAAkC;AAClC,2CAAuD;AAA9C,qHAAA,uBAAuB,OAAA;AAChC,yCAAqD;AAA5C,mHAAA,sBAAsB,OAAA;AAC/B,6CAAyD;AAAhD,uHAAA,wBAAwB,OAAA"}

package/dist/fragments/extractors/module.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Module Extractor - Extract module and file-level fragments
+ */
+import type { ContextFragment } from '../types.js';
+import type { ExtractionInput } from './index.js';
+type AnyFragment = ContextFragment<unknown>;
+/**
+ * Extract module and file fragments from repo structure
+ */
+export declare function extractModuleFragments(input: ExtractionInput): AnyFragment[];
+export {};
+//# sourceMappingURL=module.d.ts.map

package/dist/fragments/extractors/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/fragments/extractors/module.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,KAAK,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;AAE5C;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,GACrB,WAAW,EAAE,CAyJf"}