@sudosandwich/limps 2.12.0 → 2.13.0

package/dist/graph/extractor.js

@@ -0,0 +1,266 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import { basename, dirname, join } from 'path';
+import { PATTERNS } from './patterns.js';
+import { parseFrontmatter } from './parser.js';
+function withGlobal(pattern) {
+    return new RegExp(pattern.source, pattern.flags.includes('g') ? pattern.flags : `${pattern.flags}g`);
+}
+const TAG_STOP_LIST = new Set([
+    'gap',
+    'wip',
+    'pass',
+    'blocked',
+    'draft',
+    'todo',
+    'fixme',
+    'hack',
+    'note',
+]);
+function normalizeTag(value) {
+    const cleaned = value.trim().toLowerCase();
+    if (!cleaned || !/^[a-z][\w-]*$/.test(cleaned)) {
+        return null;
+    }
+    if (TAG_STOP_LIST.has(cleaned)) {
+        return null;
+    }
+    return cleaned;
+}
+function toAgentCanonicalId(planId, ref) {
+    const trimmed = ref.trim();
+    if (/^\d{4}#\d{3}$/.test(trimmed)) {
+        return `agent:${trimmed}`;
+    }
+    if (/^\d{3}$/.test(trimmed)) {
+        return `agent:${planId}#${trimmed}`;
+    }
+    if (trimmed.startsWith('agent:')) {
+        return trimmed;
+    }
+    return `agent:${planId}#${trimmed.padStart(3, '0')}`;
+}
+function inferPlanRoot(inputPath) {
+    const stats = statSync(inputPath);
+    if (stats.isDirectory()) {
+        return inputPath;
+    }
+    return dirname(inputPath);
+}
+function findPlanMarkdown(planRoot) {
+    const candidates = readdirSync(planRoot).filter((name) => name.toLowerCase().endsWith('.md'));
+    const preferred = candidates.find((name) => /-plan\.md$/i.test(name));
+    if (preferred) {
+        return join(planRoot, preferred);
+    }
+    return candidates.length > 0 ? join(planRoot, candidates[0]) : null;
+}
+function getMatches(content, pattern, captureIndex = 1) {
+    const values = [];
+    for (const match of content.matchAll(withGlobal(pattern))) {
+        const value = match[captureIndex]?.trim();
+        if (value) {
+            values.push(value);
+        }
+    }
+    return values;
+}
+export class EntityExtractor {
+    extractPlan(planPath) {
+        const result = { entities: [], relationships: [], warnings: [] };
+        const now = new Date().toISOString();
+        if (!existsSync(planPath)) {
+            result.warnings.push(`Plan path does not exist: ${planPath}`);
+            return result;
+        }
+        const planRoot = inferPlanRoot(planPath);
+        const folderName = basename(planRoot);
+        const planIdMatch = folderName.match(/^(\d{4})/);
+        if (!planIdMatch?.[1]) {
+            result.warnings.push(`Could not infer plan ID from folder: ${folderName}`);
+            return result;
+        }
+        const planId = planIdMatch[1];
+        const entitiesByCanonical = new Map();
+        const relationshipKeys = new Set();
+        let nextEntityId = 1;
+        let nextRelationshipId = 1;
+        const upsertEntity = (type, canonicalId, name, sourcePath, metadata = {}) => {
+            const existing = entitiesByCanonical.get(canonicalId);
+            if (existing) {
+                if (Object.keys(metadata).length > 0) {
+                    existing.metadata = { ...existing.metadata, ...metadata };
+                }
+                return existing;
+            }
+            const entity = {
+                id: nextEntityId++,
+                type,
+                canonicalId,
+                name,
+                sourcePath,
+                metadata,
+                createdAt: now,
+                updatedAt: now,
+            };
+            entitiesByCanonical.set(canonicalId, entity);
+            return entity;
+        };
+        const upsertRelationship = (sourceCanonicalId, targetCanonicalId, relationType, metadata = {}) => {
+            if (sourceCanonicalId === targetCanonicalId) {
+                return;
+            }
+            const source = entitiesByCanonical.get(sourceCanonicalId);
+            const target = entitiesByCanonical.get(targetCanonicalId);
+            if (!source || !target) {
+                return;
+            }
+            const key = `${source.canonicalId}|${target.canonicalId}|${relationType}`;
+            if (relationshipKeys.has(key)) {
+                return;
+            }
+            relationshipKeys.add(key);
+            result.relationships.push({
+                id: nextRelationshipId++,
+                sourceId: source.id,
+                targetId: target.id,
+                relationType,
+                confidence: 1,
+                metadata,
+                createdAt: now,
+            });
+        };
+        const ensureFileEntity = (filePath) => {
+            const fileCanonical = `file:${filePath}`;
+            upsertEntity('file', fileCanonical, filePath, filePath, {});
+            return fileCanonical;
+        };
+        const ensureTagEntity = (tag, sourcePath) => {
+            const normalized = normalizeTag(tag);
+            if (!normalized) {
+                return null;
+            }
+            const tagCanonical = `tag:${normalized}`;
+            upsertEntity('tag', tagCanonical, normalized, sourcePath, {});
+            return tagCanonical;
+        };
+        const ensureAgentEntity = (agentCanonical) => {
+            upsertEntity('agent', agentCanonical, agentCanonical.replace(/^agent:/, 'Agent '), undefined, {});
+            return agentCanonical;
+        };
+        const linkFileReferences = (sourceCanonicalId, filePaths) => {
+            for (const filePath of filePaths) {
+                const fileCanonical = ensureFileEntity(filePath);
+                upsertRelationship(sourceCanonicalId, fileCanonical, 'MODIFIES');
+            }
+        };
+        const linkTagReferences = (sourceCanonicalId, tags, sourcePath) => {
+            for (const tag of tags) {
+                const tagCanonical = ensureTagEntity(tag, sourcePath);
+                if (tagCanonical) {
+                    upsertRelationship(sourceCanonicalId, tagCanonical, 'TAGGED_WITH');
+                }
+            }
+        };
+        const linkDependencyReferences = (sourceCanonicalId, content) => {
+            for (const dep of getMatches(content, PATTERNS.inlineDepends)) {
+                const depCanonical = ensureAgentEntity(toAgentCanonicalId(planId, dep));
+                upsertRelationship(sourceCanonicalId, depCanonical, 'DEPENDS_ON');
+            }
+            for (const agentMatch of content.matchAll(withGlobal(PATTERNS.agentId))) {
+                const refPlanId = agentMatch[1];
+                const refAgentId = agentMatch[2];
+                if (!refPlanId || !refAgentId) {
+                    continue;
+                }
+                const depCanonical = ensureAgentEntity(`agent:${refPlanId}#${refAgentId}`);
+                upsertRelationship(sourceCanonicalId, depCanonical, 'DEPENDS_ON');
+            }
+            for (const planMatch of content.matchAll(withGlobal(PATTERNS.planRef))) {
+                const refPlanId = planMatch[1];
+                const refAgentId = planMatch[2];
+                if (!refPlanId) {
+                    continue;
+                }
+                if (refAgentId) {
+                    const depCanonical = ensureAgentEntity(`agent:${refPlanId}#${refAgentId}`);
+                    upsertRelationship(sourceCanonicalId, depCanonical, 'DEPENDS_ON');
+                    continue;
+                }
+                const refCanonical = `plan:${refPlanId}`;
+                upsertEntity('plan', refCanonical, `Plan ${refPlanId}`, undefined, {});
+                upsertRelationship(sourceCanonicalId, refCanonical, 'DEPENDS_ON');
+            }
+        };
+        const extractInlineReferences = (sourceCanonicalId, content) => {
+            linkFileReferences(sourceCanonicalId, getMatches(content, PATTERNS.inlineFile));
+            linkDependencyReferences(sourceCanonicalId, content);
+            linkTagReferences(sourceCanonicalId, getMatches(content, PATTERNS.inlineTag));
+        };
+        const planMarkdownPath = findPlanMarkdown(planRoot);
+        if (!planMarkdownPath || !existsSync(planMarkdownPath)) {
+            result.warnings.push(`Could not locate plan markdown file in ${planRoot}`);
+            return result;
+        }
+        if (!/-plan\.md$/i.test(planMarkdownPath)) {
+            result.warnings.push(`No *-plan.md file found in ${planRoot}; falling back to non-plan file: ${planMarkdownPath}`);
+        }
+        const planContent = readFileSync(planMarkdownPath, 'utf8');
+        const planFrontmatter = parseFrontmatter(planContent);
+        const planCanonicalId = `plan:${planId}`;
+        const planName = planFrontmatter.title ?? planContent.match(/^#\s+(.+)$/m)?.[1]?.trim() ?? `Plan ${planId}`;
+        upsertEntity('plan', planCanonicalId, planName, planMarkdownPath, {
+            status: planFrontmatter.status,
+        });
+        linkTagReferences(planCanonicalId, planFrontmatter.tags ?? [], planMarkdownPath);
+        let featureIndex = 0;
+        for (const featureMatch of planContent.matchAll(withGlobal(PATTERNS.featureHeader))) {
+            const featureNumber = featureMatch[1] ?? String(++featureIndex);
+            const featureName = featureMatch[2]?.trim();
+            if (!featureName) {
+                continue;
+            }
+            const featureCanonical = `feature:${planId}#${featureNumber}`;
+            upsertEntity('feature', featureCanonical, featureName, planMarkdownPath, {});
+            upsertRelationship(planCanonicalId, featureCanonical, 'CONTAINS');
+        }
+        extractInlineReferences(planCanonicalId, planContent);
+        const agentsDir = join(planRoot, 'agents');
+        if (!existsSync(agentsDir)) {
+            result.warnings.push(`Agents directory not found at ${agentsDir}`);
+        }
+        else {
+            const agentFiles = readdirSync(agentsDir)
+                .filter((file) => file.endsWith('.agent.md'))
+                .sort();
+            for (const filename of agentFiles) {
+                const agentPath = join(agentsDir, filename);
+                const content = readFileSync(agentPath, 'utf8');
+                const frontmatter = parseFrontmatter(content);
+                const agentNumber = filename.match(/^(\d{3})/)?.[1];
+                if (!agentNumber) {
+                    result.warnings.push(`Could not infer agent number from ${filename}`);
+                    continue;
+                }
+                const agentCanonical = `agent:${planId}#${agentNumber}`;
+                const agentName = frontmatter.title ??
+                    content.match(/^#\s*Agent\s+\d{3}:\s*(.+)$/m)?.[1]?.trim() ??
+                    `Agent ${agentNumber}`;
+                upsertEntity('agent', agentCanonical, agentName, agentPath, {
+                    status: frontmatter.status,
+                    persona: frontmatter.persona,
+                });
+                upsertRelationship(planCanonicalId, agentCanonical, 'CONTAINS');
+                for (const dep of frontmatter.depends ?? []) {
+                    const depCanonical = ensureAgentEntity(toAgentCanonicalId(planId, dep));
+                    upsertRelationship(agentCanonical, depCanonical, 'DEPENDS_ON');
+                }
+                linkFileReferences(agentCanonical, (frontmatter.files ?? []).map((file) => file.trim()).filter(Boolean));
+                linkTagReferences(agentCanonical, frontmatter.tags ?? []);
+                extractInlineReferences(agentCanonical, content);
+            }
+        }
+        result.entities = Array.from(entitiesByCanonical.values());
+        return result;
+    }
+}
+//# sourceMappingURL=extractor.js.map

package/dist/graph/extractor.js.map

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

package/dist/graph/notifier.d.ts

@@ -0,0 +1,16 @@
+import type { ConflictReport } from './conflict-detector.js';
+export type NotificationChannel = 'log' | 'file' | 'webhook';
+export interface NotifierConfig {
+    channels: NotificationChannel[];
+    filePath?: string;
+    webhookUrl?: string;
+}
+export declare class Notifier {
+    private readonly config;
+    constructor(config: NotifierConfig);
+    notify(reports: ConflictReport[]): Promise<void>;
+    private notifyLog;
+    private notifyFile;
+    private notifyWebhook;
+}
+//# sourceMappingURL=notifier.d.ts.map

package/dist/graph/notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.d.ts","sourceRoot":"","sources":["../../src/graph/notifier.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE7C,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBtD,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,UAAU;YAYJ,aAAa;CAkB5B"}

package/dist/graph/notifier.js

@@ -0,0 +1,61 @@
+import { appendFileSync } from 'fs';
+export class Notifier {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async notify(reports) {
+        if (reports.length === 0)
+            return;
+        for (const channel of this.config.channels) {
+            switch (channel) {
+                case 'log':
+                    this.notifyLog(reports);
+                    break;
+                case 'file':
+                    this.notifyFile(reports);
+                    break;
+                case 'webhook':
+                    await this.notifyWebhook(reports);
+                    break;
+            }
+        }
+    }
+    notifyLog(reports) {
+        for (const report of reports) {
+            const prefix = report.severity === 'error' ? '[ERROR]' : '[WARN]';
+            console.error(`${prefix} ${report.type}: ${report.message}`);
+        }
+    }
+    notifyFile(reports) {
+        if (!this.config.filePath)
+            return;
+        for (const report of reports) {
+            const line = JSON.stringify({
+                timestamp: new Date().toISOString(),
+                ...report,
+            });
+            appendFileSync(this.config.filePath, line + '\n', 'utf-8');
+        }
+    }
+    async notifyWebhook(reports) {
+        if (!this.config.webhookUrl)
+            return;
+        try {
+            await fetch(this.config.webhookUrl, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    timestamp: new Date().toISOString(),
+                    conflicts: reports,
+                    count: reports.length,
+                }),
+            });
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            console.error(`Webhook notification failed: ${msg}`);
+        }
+    }
+}
+//# sourceMappingURL=notifier.js.map

package/dist/graph/notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifier.js","sourceRoot":"","sources":["../../src/graph/notifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAWpC,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAEvD,KAAK,CAAC,MAAM,CAAC,OAAyB;QACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEjC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC3C,QAAQ,OAAO,EAAE,CAAC;gBAChB,KAAK,KAAK;oBACR,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;oBACxB,MAAM;gBACR,KAAK,MAAM;oBACT,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;oBACzB,MAAM;gBACR,KAAK,SAAS;oBACZ,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;oBAClC,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAEO,SAAS,CAAC,OAAyB;QACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;YAClE,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,OAAyB;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,OAAO;QAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,MAAM;aACV,CAAC,CAAC;YACH,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,OAAyB;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO;QAEpC,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE;gBAClC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,SAAS,EAAE,OAAO;oBAClB,KAAK,EAAE,OAAO,CAAC,MAAM;iBACtB,CAAC;aACH,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,OAAO,CAAC,KAAK,CAAC,gCAAgC,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;CACF"}

package/dist/graph/parser.d.ts

@@ -0,0 +1,10 @@
+export interface ParsedFrontmatter {
+    title?: string;
+    status?: 'GAP' | 'WIP' | 'PASS' | 'BLOCKED' | 'draft';
+    depends?: string[];
+    files?: string[];
+    tags?: string[];
+    persona?: string;
+}
+export declare function parseFrontmatter(content: string): ParsedFrontmatter;
+//# sourceMappingURL=parser.d.ts.map

package/dist/graph/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/graph/parser.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA2CnE"}

package/dist/graph/parser.js

@@ -0,0 +1,54 @@
+function parseArray(str) {
+    return str
+        .split(',')
+        .map((part) => part.trim().replace(/^['"]|['"]$/g, ''))
+        .filter((part) => part.length > 0);
+}
+function normalizeStatus(value) {
+    const normalized = value.trim();
+    if (normalized === 'draft') {
+        return 'draft';
+    }
+    const upper = normalized.toUpperCase();
+    if (upper === 'GAP' || upper === 'WIP' || upper === 'PASS' || upper === 'BLOCKED') {
+        return upper;
+    }
+    return undefined;
+}
+export function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+    if (!match || !match[1]) {
+        return {};
+    }
+    const yaml = match[1];
+    const result = {};
+    const titleMatch = yaml.match(/^title:\s*(.+)$/m);
+    if (titleMatch?.[1]) {
+        result.title = titleMatch[1].trim();
+    }
+    const statusMatch = yaml.match(/^status:\s*(\w+)$/m);
+    if (statusMatch?.[1]) {
+        const normalized = normalizeStatus(statusMatch[1]);
+        if (normalized) {
+            result.status = normalized;
+        }
+    }
+    const personaMatch = yaml.match(/^persona:\s*(\w+)$/m);
+    if (personaMatch?.[1]) {
+        result.persona = personaMatch[1].trim();
+    }
+    const dependsMatch = yaml.match(/^(?:depends|depends_on):\s*\[([^\]]*)\]/m);
+    if (dependsMatch?.[1]) {
+        result.depends = parseArray(dependsMatch[1]);
+    }
+    const filesMatch = yaml.match(/^files:\s*\[([^\]]*)\]/m);
+    if (filesMatch?.[1]) {
+        result.files = parseArray(filesMatch[1]);
+    }
+    const tagsMatch = yaml.match(/^tags:\s*\[([^\]]*)\]/m);
+    if (tagsMatch?.[1]) {
+        result.tags = parseArray(tagsMatch[1]);
+    }
+    return result;
+}
+//# sourceMappingURL=parser.js.map

package/dist/graph/parser.js.map

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

package/dist/graph/patterns.d.ts

@@ -0,0 +1,16 @@
+export declare const PATTERNS: {
+    readonly planId: RegExp;
+    readonly planRef: RegExp;
+    readonly agentId: RegExp;
+    readonly agentHeader: RegExp;
+    readonly featureHeader: RegExp;
+    readonly featureStatus: RegExp;
+    readonly frontmatterFiles: RegExp;
+    readonly inlineFile: RegExp;
+    readonly frontmatterDepends: RegExp;
+    readonly inlineDepends: RegExp;
+    readonly frontmatterTags: RegExp;
+    readonly inlineTag: RegExp;
+    readonly frontmatterStatus: RegExp;
+};
+//# sourceMappingURL=patterns.d.ts.map

package/dist/graph/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../src/graph/patterns.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;CA2BX,CAAC"}

package/dist/graph/patterns.js

@@ -0,0 +1,23 @@
+export const PATTERNS = {
+    // Plan references
+    planId: /(?:plan\s*)?(\d{4})(?:[-\s]+([\w-]+))?/gi,
+    planRef: /\bplan\s+(\d{4})(?:#(\d{3}))?/gi,
+    // Agent references
+    agentId: /(\d{4})#(\d{3})/g,
+    agentHeader: /^#\s*Agent\s+(\d{3}):\s*(.+)$/gm,
+    // Features
+    featureHeader: /^###\s*#(\d+):?\s+(.+)$/gm,
+    featureStatus: /Status:\s*`?(GAP|WIP|PASS|BLOCKED)`?/gi,
+    // Files (in frontmatter or inline)
+    frontmatterFiles: /^files:\s*\[([^\]]+)\]/m,
+    inlineFile: /`([\w/.-]+\.(?:ts|js|tsx|jsx|md|json|py|rs|go|sql))`/g,
+    // Dependencies
+    frontmatterDepends: /^(?:depends|depends_on):\s*\[([^\]]+)\]/m,
+    inlineDepends: /depends\s+(?:on\s+)?(?:agent\s+)?(\d{4}#\d{3}|\d{3})/gi,
+    // Tags
+    frontmatterTags: /^tags:\s*\[([^\]]+)\]/m,
+    inlineTag: /#([\w-]+)/g,
+    // Status
+    frontmatterStatus: /^status:\s*(\w+)/m,
+};
+//# sourceMappingURL=patterns.js.map

package/dist/graph/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../src/graph/patterns.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,kBAAkB;IAClB,MAAM,EAAE,0CAA0C;IAClD,OAAO,EAAE,iCAAiC;IAE1C,mBAAmB;IACnB,OAAO,EAAE,kBAAkB;IAC3B,WAAW,EAAE,iCAAiC;IAE9C,WAAW;IACX,aAAa,EAAE,2BAA2B;IAC1C,aAAa,EAAE,wCAAwC;IAEvD,mCAAmC;IACnC,gBAAgB,EAAE,yBAAyB;IAC3C,UAAU,EAAE,uDAAuD;IAEnE,eAAe;IACf,kBAAkB,EAAE,0CAA0C;IAC9D,aAAa,EAAE,wDAAwD;IAEvE,OAAO;IACP,eAAe,EAAE,wBAAwB;IACzC,SAAS,EAAE,YAAY;IAEvB,SAAS;IACT,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC"}

package/dist/graph/resolver.d.ts

@@ -0,0 +1,23 @@
+import type { Entity } from './types.js';
+import type { GraphStorage } from './storage.js';
+import { type EmbeddingStore, type SimilarityScore } from './similarity.js';
+export interface ResolutionMatch {
+    a: Entity;
+    b: Entity;
+    score: SimilarityScore;
+}
+export interface ResolutionResult {
+    duplicates: ResolutionMatch[];
+    similar: ResolutionMatch[];
+    suggestions: string[];
+}
+export declare class EntityResolver {
+    private readonly storage;
+    private readonly embeddings;
+    constructor(storage: GraphStorage, embeddings: EmbeddingStore);
+    resolveAll(): ResolutionResult;
+    checkNewFeature(name: string, description: string): Entity[];
+    private getNeighborCanonicalIds;
+    private addSimilarityRelationship;
+}
+//# sourceMappingURL=resolver.d.ts.map

package/dist/graph/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/graph/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAeD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBADV,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,cAAc;IAG7C,UAAU,IAAI,gBAAgB;IAiD9B,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE;IAiC5D,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,yBAAyB;CAclC"}

package/dist/graph/resolver.js

@@ -0,0 +1,98 @@
+import { THRESHOLDS, computeSimilarity, computeStructuralSimilarityFromNeighbors, } from './similarity.js';
+function isDuplicate(score) {
+    if (score.combined >= THRESHOLDS.duplicate) {
+        return true;
+    }
+    // Different canonical IDs can still be duplicates when lexical + semantic signals are near-identical.
+    return (score.lexical >= THRESHOLDS.duplicateLexical &&
+        score.semantic >= THRESHOLDS.duplicateSemantic &&
+        score.structural >= THRESHOLDS.duplicateStructural);
+}
+export class EntityResolver {
+    storage;
+    embeddings;
+    constructor(storage, embeddings) {
+        this.storage = storage;
+        this.embeddings = embeddings;
+    }
+    resolveAll() {
+        const result = { duplicates: [], similar: [], suggestions: [] };
+        const features = this.storage.getEntitiesByType('feature');
+        for (let i = 0; i < features.length; i++) {
+            const featureA = features[i];
+            if (!featureA) {
+                continue;
+            }
+            for (let j = i + 1; j < features.length; j++) {
+                const featureB = features[j];
+                if (!featureB) {
+                    continue;
+                }
+                const structural = computeStructuralSimilarityFromNeighbors(this.getNeighborCanonicalIds(featureA), this.getNeighborCanonicalIds(featureB));
+                const score = computeSimilarity(featureA, featureB, this.embeddings, { structural });
+                if (isDuplicate(score)) {
+                    result.duplicates.push({ a: featureA, b: featureB, score });
+                    this.addSimilarityRelationship(featureA, featureB, score);
+                    continue;
+                }
+                if (score.combined >= THRESHOLDS.similar) {
+                    result.similar.push({ a: featureA, b: featureB, score });
+                    this.addSimilarityRelationship(featureA, featureB, score);
+                }
+            }
+        }
+        for (const match of result.duplicates) {
+            result.suggestions.push(`DUPLICATE: "${match.a.name}" (${match.a.canonicalId}) and "${match.b.name}" (${match.b.canonicalId}) are ${(match.score.combined * 100).toFixed(0)}% similar. Consider consolidating.`);
+        }
+        for (const match of result.similar) {
+            result.suggestions.push(`SIMILAR: "${match.a.name}" (${match.a.canonicalId}) and "${match.b.name}" (${match.b.canonicalId}) are ${(match.score.combined * 100).toFixed(0)}% similar. Consider linking or clarifying scope.`);
+        }
+        return result;
+    }
+    checkNewFeature(name, description) {
+        const queryText = `${name} ${description}`.trim();
+        if (this.embeddings.embed && this.embeddings.findSimilar) {
+            const embedding = this.embeddings.embed(queryText);
+            const candidates = this.embeddings.findSimilar(embedding, 10);
+            return candidates
+                .filter((candidate) => candidate.score >= THRESHOLDS.similar)
+                .map((candidate) => this.storage.getEntity(candidate.canonicalId))
+                .filter((entity) => entity?.type === 'feature');
+        }
+        const probe = {
+            id: 0,
+            type: 'feature',
+            canonicalId: 'feature:new',
+            name: name.trim(),
+            metadata: {},
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+        };
+        return this.storage
+            .getEntitiesByType('feature')
+            .map((entity) => ({
+            entity,
+            score: computeSimilarity(probe, entity, this.embeddings, { structural: 0 }),
+        }))
+            .filter((entry) => entry.score.combined >= THRESHOLDS.similar)
+            .map((entry) => entry.entity);
+    }
+    getNeighborCanonicalIds(entity) {
+        return new Set(this.storage.getNeighbors(entity.id).map((neighbor) => neighbor.canonicalId));
+    }
+    addSimilarityRelationship(a, b, score) {
+        this.storage.upsertRelationship({
+            sourceId: a.id,
+            targetId: b.id,
+            relationType: 'SIMILAR_TO',
+            confidence: score.combined,
+            metadata: {
+                lexical: score.lexical,
+                semantic: score.semantic,
+                structural: score.structural,
+                detectedAt: new Date().toISOString(),
+            },
+        });
+    }
+}
+//# sourceMappingURL=resolver.js.map

package/dist/graph/resolver.js.map

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