@archkit/graph 0.1.0

package/dist/services/indexes.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSymbolsIndex = createSymbolsIndex;
+exports.createFilesIndex = createFilesIndex;
+function createSymbolsIndex(nodes) {
+    const symbolMap = new Map();
+    nodes
+        .filter((node) => node.type !== 'file')
+        .forEach((node) => {
+        const existing = symbolMap.get(node.name);
+        if (existing) {
+            existing.push(node.id);
+        }
+        else {
+            symbolMap.set(node.name, [node.id]);
+        }
+    });
+    const sortedNames = [...symbolMap.keys()].sort((left, right) => left.localeCompare(right));
+    return sortedNames.reduce((accumulator, name) => {
+        const values = symbolMap.get(name) ?? [];
+        accumulator[name] = [...values].sort((left, right) => left.localeCompare(right));
+        return accumulator;
+    }, {});
+}
+function createFilesIndex(nodes) {
+    return nodes
+        .filter((node) => node.type === 'file')
+        .map((node) => node.filePath)
+        .sort((left, right) => left.localeCompare(right));
+}
+//# sourceMappingURL=indexes.js.map

package/dist/services/indexes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexes.js","sourceRoot":"","sources":["../../src/services/indexes.ts"],"names":[],"mappings":";;AAEA,gDAuBC;AAED,4CAKC;AA9BD,SAAgB,kBAAkB,CAAC,KAAiB;IAClD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAA;IAE7C,KAAK;SACF,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SACtC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAChB,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACzC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACxB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;QACrC,CAAC;IACH,CAAC,CAAC,CAAA;IAEJ,MAAM,WAAW,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC7D,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAC1B,CAAA;IAED,OAAO,WAAW,CAAC,MAAM,CAA2B,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE;QACxE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QACxC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;QAChF,OAAO,WAAW,CAAA;IACpB,CAAC,EAAE,EAAE,CAAC,CAAA;AACR,CAAC;AAED,SAAgB,gBAAgB,CAAC,KAAiB;IAChD,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;SAC5B,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;AACrD,CAAC"}

package/dist/services/knowledge-storage.d.ts

@@ -0,0 +1,6 @@
+import type { AddKnowledgeInput, KnowledgeEntry, KnowledgeEntrySummary } from '../models/knowledge-types';
+export declare function addKnowledgeEntry(rootDir: string, input: AddKnowledgeInput): Promise<KnowledgeEntry>;
+export declare function listKnowledgeEntries(rootDir: string): Promise<KnowledgeEntrySummary[]>;
+export declare function getKnowledgeEntry(rootDir: string, id: string): Promise<KnowledgeEntry | undefined>;
+export declare function searchKnowledgeEntries(rootDir: string, query: string): Promise<KnowledgeEntrySummary[]>;
+//# sourceMappingURL=knowledge-storage.d.ts.map

package/dist/services/knowledge-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-storage.d.ts","sourceRoot":"","sources":["../../src/services/knowledge-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAkB,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAoEzH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,cAAc,CAAC,CAkCzB;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAG5F;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAYrC;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAqClC"}

package/dist/services/knowledge-storage.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addKnowledgeEntry = addKnowledgeEntry;
+exports.listKnowledgeEntries = listKnowledgeEntries;
+exports.getKnowledgeEntry = getKnowledgeEntry;
+exports.searchKnowledgeEntries = searchKnowledgeEntries;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const knowledge_utils_1 = require("../utils/knowledge-utils");
+function sortSummaries(entries) {
+    return [...entries].sort((left, right) => {
+        const leftKey = `${left.feature}:${left.id}`;
+        const rightKey = `${right.feature}:${right.id}`;
+        return leftKey.localeCompare(rightKey);
+    });
+}
+function sortEntries(entries) {
+    return [...entries].sort((left, right) => {
+        const leftKey = `${left.feature}:${left.id}`;
+        const rightKey = `${right.feature}:${right.id}`;
+        return leftKey.localeCompare(rightKey);
+    });
+}
+function toKnowledgePaths(rootDir) {
+    const knowledgeDir = node_path_1.default.join(rootDir, '.arch', 'knowledge');
+    return {
+        knowledgeDir,
+        entriesDir: node_path_1.default.join(knowledgeDir, 'entries'),
+        indexPath: node_path_1.default.join(knowledgeDir, 'index.json'),
+    };
+}
+async function readIndexOrEmpty(rootDir) {
+    const { indexPath } = toKnowledgePaths(rootDir);
+    try {
+        const content = await (0, promises_1.readFile)(indexPath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (!Array.isArray(parsed.entries)) {
+            return { entries: [] };
+        }
+        return { entries: sortSummaries(parsed.entries) };
+    }
+    catch (error) {
+        if (!isMissingFileError(error)) {
+            throw error;
+        }
+        return { entries: [] };
+    }
+}
+async function writeIndex(rootDir, index) {
+    const { knowledgeDir, indexPath } = toKnowledgePaths(rootDir);
+    await (0, promises_1.mkdir)(knowledgeDir, { recursive: true });
+    const sorted = {
+        entries: sortSummaries(index.entries),
+    };
+    await (0, promises_1.writeFile)(indexPath, `${JSON.stringify(sorted, null, 2)}\n`, 'utf-8');
+}
+async function addKnowledgeEntry(rootDir, input) {
+    const normalized = (0, knowledge_utils_1.normalizeAddInput)(input);
+    const index = await readIndexOrEmpty(rootDir);
+    if (index.entries.some((entry) => entry.id === normalized.id)) {
+        throw new Error(`Knowledge entry already exists: ${normalized.id}`);
+    }
+    const relativeFile = (0, knowledge_utils_1.toEntryRelativeFile)(normalized.feature, normalized.createdAt, normalized.id);
+    const entry = {
+        ...normalized,
+        file: relativeFile,
+    };
+    const { knowledgeDir, entriesDir } = toKnowledgePaths(rootDir);
+    await (0, promises_1.mkdir)(knowledgeDir, { recursive: true });
+    await (0, promises_1.mkdir)(node_path_1.default.join(entriesDir, normalized.feature), { recursive: true });
+    await (0, promises_1.writeFile)(node_path_1.default.join(knowledgeDir, relativeFile), (0, knowledge_utils_1.serializeKnowledgeEntry)(entry), 'utf-8');
+    await writeIndex(rootDir, {
+        entries: [...index.entries, (0, knowledge_utils_1.toSummary)(entry)],
+    });
+    return entry;
+}
+async function listKnowledgeEntries(rootDir) {
+    const index = await readIndexOrEmpty(rootDir);
+    return sortSummaries(index.entries);
+}
+async function getKnowledgeEntry(rootDir, id) {
+    const normalizedId = id.trim().toLocaleLowerCase();
+    const index = await readIndexOrEmpty(rootDir);
+    const found = index.entries.find((entry) => entry.id === normalizedId);
+    if (!found) {
+        return undefined;
+    }
+    const { knowledgeDir } = toKnowledgePaths(rootDir);
+    const content = await (0, promises_1.readFile)(node_path_1.default.join(knowledgeDir, found.file), 'utf-8');
+    return (0, knowledge_utils_1.parseKnowledgeEntry)(content, found.file);
+}
+async function searchKnowledgeEntries(rootDir, query) {
+    const normalizedQuery = query.trim().toLocaleLowerCase();
+    if (normalizedQuery.length === 0) {
+        return [];
+    }
+    const index = await readIndexOrEmpty(rootDir);
+    const { knowledgeDir } = toKnowledgePaths(rootDir);
+    const loadedEntries = await Promise.all(index.entries.map(async (summary) => {
+        const content = await (0, promises_1.readFile)(node_path_1.default.join(knowledgeDir, summary.file), 'utf-8');
+        return (0, knowledge_utils_1.parseKnowledgeEntry)(content, summary.file);
+    }));
+    const matches = loadedEntries.filter((entry) => {
+        if (entry.id.toLocaleLowerCase().includes(normalizedQuery)) {
+            return true;
+        }
+        if (entry.title.toLocaleLowerCase().includes(normalizedQuery)) {
+            return true;
+        }
+        if (entry.feature.toLocaleLowerCase().includes(normalizedQuery)) {
+            return true;
+        }
+        if (entry.body.toLocaleLowerCase().includes(normalizedQuery)) {
+            return true;
+        }
+        return entry.tags.some((tag) => tag.toLocaleLowerCase().includes(normalizedQuery));
+    });
+    return sortEntries(matches).map(knowledge_utils_1.toSummary);
+}
+function isMissingFileError(error) {
+    if (typeof error !== 'object' || error === null) {
+        return false;
+    }
+    const withCode = error;
+    return withCode.code === 'ENOENT';
+}
+//# sourceMappingURL=knowledge-storage.js.map

package/dist/services/knowledge-storage.js.map

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

package/dist/services/persisted-read.d.ts

@@ -0,0 +1,5 @@
+import type { ArchEdge, ArchNode } from '@archkit/core';
+export declare function readPersistedNodes(rootDir: string): Promise<ArchNode[]>;
+export declare function readPersistedEdges(rootDir: string): Promise<ArchEdge[]>;
+export declare function readPersistedSymbolsIndex(rootDir: string): Promise<Record<string, string[]>>;
+//# sourceMappingURL=persisted-read.d.ts.map

package/dist/services/persisted-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persisted-read.d.ts","sourceRoot":"","sources":["../../src/services/persisted-read.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAUvD,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAI7E;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAI7E;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAInC"}

package/dist/services/persisted-read.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readPersistedNodes = readPersistedNodes;
+exports.readPersistedEdges = readPersistedEdges;
+exports.readPersistedSymbolsIndex = readPersistedSymbolsIndex;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+function parseJsonl(content) {
+    return content
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .map((line) => JSON.parse(line));
+}
+async function readPersistedNodes(rootDir) {
+    const nodesPath = node_path_1.default.join(rootDir, '.arch', 'graph', 'nodes.jsonl');
+    const content = await (0, promises_1.readFile)(nodesPath, 'utf-8');
+    return parseJsonl(content);
+}
+async function readPersistedEdges(rootDir) {
+    const edgesPath = node_path_1.default.join(rootDir, '.arch', 'graph', 'edges.jsonl');
+    const content = await (0, promises_1.readFile)(edgesPath, 'utf-8');
+    return parseJsonl(content);
+}
+async function readPersistedSymbolsIndex(rootDir) {
+    const symbolsPath = node_path_1.default.join(rootDir, '.arch', 'index', 'symbols.json');
+    const content = await (0, promises_1.readFile)(symbolsPath, 'utf-8');
+    return JSON.parse(content);
+}
+//# sourceMappingURL=persisted-read.js.map

package/dist/services/persisted-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persisted-read.js","sourceRoot":"","sources":["../../src/services/persisted-read.ts"],"names":[],"mappings":";;;;;AAYA,gDAIC;AAED,gDAIC;AAED,8DAMC;AA9BD,+CAA2C;AAC3C,0DAA4B;AAG5B,SAAS,UAAU,CAAI,OAAe;IACpC,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC,CAAA;AACzC,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAAC,OAAe;IACtD,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;IACrE,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAClD,OAAO,UAAU,CAAW,OAAO,CAAC,CAAA;AACtC,CAAC;AAEM,KAAK,UAAU,kBAAkB,CAAC,OAAe;IACtD,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,CAAC,CAAA;IACrE,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,SAAS,EAAE,OAAO,CAAC,CAAA;IAClD,OAAO,UAAU,CAAW,OAAO,CAAC,CAAA;AACtC,CAAC;AAEM,KAAK,UAAU,yBAAyB,CAC7C,OAAe;IAEf,MAAM,WAAW,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAA;IACxE,MAAM,OAAO,GAAG,MAAM,IAAA,mBAAQ,EAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA6B,CAAA;AACxD,CAAC"}

package/dist/services/snippet.d.ts

@@ -0,0 +1,3 @@
+import type { ArchNode } from '@archkit/core';
+export declare function extractSnippetForNode(rootDir: string, node: ArchNode): Promise<string>;
+//# sourceMappingURL=snippet.d.ts.map

package/dist/services/snippet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.d.ts","sourceRoot":"","sources":["../../src/services/snippet.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,MAAM,CAAC,CAQjB"}

package/dist/services/snippet.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSnippetForNode = extractSnippetForNode;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+async function extractSnippetForNode(rootDir, node) {
+    const absolutePath = node_path_1.default.join(rootDir, node.filePath);
+    const source = await (0, promises_1.readFile)(absolutePath, 'utf-8');
+    const lines = source.split(/\r?\n/);
+    const startIndex = Math.max(0, node.loc.startLine - 1);
+    const endIndex = Math.min(lines.length, node.loc.endLine);
+    return lines.slice(startIndex, endIndex).join('\n');
+}
+//# sourceMappingURL=snippet.js.map

package/dist/services/snippet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet.js","sourceRoot":"","sources":["../../src/services/snippet.ts"],"names":[],"mappings":";;;;;AAIA,sDAWC;AAfD,+CAA2C;AAC3C,0DAA4B;AAGrB,KAAK,UAAU,qBAAqB,CACzC,OAAe,EACf,IAAc;IAEd,MAAM,YAAY,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IACtD,MAAM,MAAM,GAAG,MAAM,IAAA,mBAAQ,EAAC,YAAY,EAAE,OAAO,CAAC,CAAA;IACpD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC,CAAA;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAEzD,OAAO,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACrD,CAAC"}

package/dist/services/symbol-query.d.ts

@@ -0,0 +1,4 @@
+import type { ResolvedSymbol, SymbolQueryResult } from '../models/query-types';
+export declare function querySymbols(rootDir: string, term: string): Promise<SymbolQueryResult>;
+export declare function resolveSymbolInput(rootDir: string, input: string): Promise<ResolvedSymbol>;
+//# sourceMappingURL=symbol-query.d.ts.map

package/dist/services/symbol-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-query.d.ts","sourceRoot":"","sources":["../../src/services/symbol-query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAG9E,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkB5F;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CA8BzB"}

package/dist/services/symbol-query.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.querySymbols = querySymbols;
+exports.resolveSymbolInput = resolveSymbolInput;
+const persisted_read_1 = require("./persisted-read");
+async function querySymbols(rootDir, term) {
+    const normalizedTerm = term.trim().toLocaleLowerCase();
+    const symbolsIndex = await (0, persisted_read_1.readPersistedSymbolsIndex)(rootDir);
+    const matches = Object.keys(symbolsIndex)
+        .filter((name) => name.toLocaleLowerCase().includes(normalizedTerm))
+        .sort((left, right) => left.localeCompare(right))
+        .map((name) => ({
+        name,
+        nodeIds: [...(symbolsIndex[name] ?? [])].sort((left, right) => left.localeCompare(right)),
+    }));
+    return {
+        term,
+        matches,
+    };
+}
+async function resolveSymbolInput(rootDir, input) {
+    const normalizedInput = input.trim();
+    const symbolsIndex = await (0, persisted_read_1.readPersistedSymbolsIndex)(rootDir);
+    const nodes = await (0, persisted_read_1.readPersistedNodes)(rootDir);
+    const nodeMap = createNodeMap(nodes);
+    const nodeById = nodeMap.get(normalizedInput);
+    if (nodeById) {
+        return {
+            input,
+            nodes: [nodeById],
+        };
+    }
+    const directIds = symbolsIndex[normalizedInput] ?? [];
+    if (directIds.length > 0) {
+        return {
+            input,
+            nodes: mapIdsToNodes(directIds, nodeMap),
+        };
+    }
+    const caseInsensitiveIds = Object.entries(symbolsIndex)
+        .filter(([name]) => name.toLocaleLowerCase() === normalizedInput.toLocaleLowerCase())
+        .flatMap(([, nodeIds]) => nodeIds);
+    return {
+        input,
+        nodes: mapIdsToNodes(caseInsensitiveIds, nodeMap),
+    };
+}
+function createNodeMap(nodes) {
+    return new Map(nodes.map((node) => [node.id, node]));
+}
+function mapIdsToNodes(nodeIds, nodeMap) {
+    return [...new Set(nodeIds)]
+        .map((id) => nodeMap.get(id))
+        .filter((node) => node !== undefined)
+        .sort((left, right) => left.id.localeCompare(right.id));
+}
+//# sourceMappingURL=symbol-query.js.map

package/dist/services/symbol-query.js.map

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

package/dist/utils/jsonl.d.ts

@@ -0,0 +1,2 @@
+export declare function toJsonl<T>(items: T[]): string;
+//# sourceMappingURL=jsonl.d.ts.map

package/dist/utils/jsonl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.d.ts","sourceRoot":"","sources":["../../src/utils/jsonl.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,MAAM,CAM7C"}

package/dist/utils/jsonl.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toJsonl = toJsonl;
+function toJsonl(items) {
+    if (items.length === 0) {
+        return '';
+    }
+    return `${items.map((item) => JSON.stringify(item)).join('\n')}\n`;
+}
+//# sourceMappingURL=jsonl.js.map

package/dist/utils/jsonl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl.js","sourceRoot":"","sources":["../../src/utils/jsonl.ts"],"names":[],"mappings":";;AAAA,0BAMC;AAND,SAAgB,OAAO,CAAI,KAAU;IACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAA;AACpE,CAAC"}

package/dist/utils/knowledge-utils.d.ts

@@ -0,0 +1,11 @@
+import type { AddKnowledgeInput, KnowledgeEntry, KnowledgeEntrySummary } from '../models/knowledge-types';
+export declare function normalizeFeature(input: string | undefined): string;
+export declare function normalizeTags(tags: string[] | undefined): string[];
+export declare function toKnowledgeId(title: string): string;
+export declare function toCreatedAtDate(value: string | undefined): string;
+export declare function toEntryRelativeFile(feature: string, createdAt: string, id: string): string;
+export declare function serializeKnowledgeEntry(entry: KnowledgeEntry): string;
+export declare function parseKnowledgeEntry(content: string, file: string): KnowledgeEntry;
+export declare function toSummary(entry: KnowledgeEntry): KnowledgeEntrySummary;
+export declare function normalizeAddInput(input: AddKnowledgeInput): Omit<KnowledgeEntry, 'file'>;
+//# sourceMappingURL=knowledge-utils.d.ts.map

package/dist/utils/knowledge-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-utils.d.ts","sourceRoot":"","sources":["../../src/utils/knowledge-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAiB,MAAM,2BAA2B,CAAA;AAIxH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAIlE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAUlE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAMjE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1F;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAkBrE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAsFjF;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,qBAAqB,CAUtE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAUxF"}

package/dist/utils/knowledge-utils.js

@@ -0,0 +1,174 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeFeature = normalizeFeature;
+exports.normalizeTags = normalizeTags;
+exports.toKnowledgeId = toKnowledgeId;
+exports.toCreatedAtDate = toCreatedAtDate;
+exports.toEntryRelativeFile = toEntryRelativeFile;
+exports.serializeKnowledgeEntry = serializeKnowledgeEntry;
+exports.parseKnowledgeEntry = parseKnowledgeEntry;
+exports.toSummary = toSummary;
+exports.normalizeAddInput = normalizeAddInput;
+const node_path_1 = __importDefault(require("node:path"));
+const FRONTMATTER_SEPARATOR = '---';
+function normalizeFeature(input) {
+    const normalized = (input ?? 'general').trim().toLocaleLowerCase();
+    const slugged = slugify(normalized);
+    return slugged.length > 0 ? slugged : 'general';
+}
+function normalizeTags(tags) {
+    if (!tags || tags.length === 0) {
+        return [];
+    }
+    const cleaned = tags
+        .map((tag) => slugify(tag))
+        .filter((tag) => tag.length > 0);
+    return [...new Set(cleaned)].sort((left, right) => left.localeCompare(right));
+}
+function toKnowledgeId(title) {
+    const id = slugify(title);
+    return id.length > 0 ? id : 'entry';
+}
+function toCreatedAtDate(value) {
+    if (value && /^\d{4}-\d{2}-\d{2}$/.test(value)) {
+        return value;
+    }
+    return new Date().toISOString().slice(0, 10);
+}
+function toEntryRelativeFile(feature, createdAt, id) {
+    return node_path_1.default.posix.join('entries', feature, `${createdAt}_${id}.md`);
+}
+function serializeKnowledgeEntry(entry) {
+    const lines = [
+        FRONTMATTER_SEPARATOR,
+        `id: ${entry.id}`,
+        `title: ${entry.title}`,
+        `type: ${entry.type}`,
+        `feature: ${entry.feature}`,
+    ];
+    if (entry.tags.length > 0) {
+        lines.push('tags:');
+        entry.tags.forEach((tag) => {
+            lines.push(`  - ${tag}`);
+        });
+    }
+    lines.push(`createdAt: ${entry.createdAt}`, FRONTMATTER_SEPARATOR, '', entry.body);
+    return `${lines.join('\n')}\n`;
+}
+function parseKnowledgeEntry(content, file) {
+    const lines = content.split(/\r?\n/);
+    if (lines.length < 3 || lines[0].trim() !== FRONTMATTER_SEPARATOR) {
+        throw new Error(`Invalid knowledge entry frontmatter in ${file}`);
+    }
+    let separatorIndex = -1;
+    for (let index = 1; index < lines.length; index += 1) {
+        if (lines[index].trim() === FRONTMATTER_SEPARATOR) {
+            separatorIndex = index;
+            break;
+        }
+    }
+    if (separatorIndex < 0) {
+        throw new Error(`Invalid knowledge entry frontmatter in ${file}`);
+    }
+    let id = '';
+    let title = '';
+    let type;
+    let feature = 'general';
+    const tags = [];
+    let createdAt = '';
+    for (let index = 1; index < separatorIndex; index += 1) {
+        const line = lines[index];
+        const trimmedLine = line.trim();
+        if (trimmedLine.length === 0) {
+            continue;
+        }
+        if (trimmedLine === 'tags:') {
+            for (let tagIndex = index + 1; tagIndex < separatorIndex; tagIndex += 1) {
+                const tagLine = lines[tagIndex].trim();
+                if (!tagLine.startsWith('- ')) {
+                    break;
+                }
+                const tag = slugify(tagLine.slice(2));
+                if (tag.length > 0) {
+                    tags.push(tag);
+                }
+                index = tagIndex;
+            }
+            continue;
+        }
+        const splitIndex = line.indexOf(':');
+        if (splitIndex < 0) {
+            continue;
+        }
+        const key = line.slice(0, splitIndex).trim();
+        const value = line.slice(splitIndex + 1).trim();
+        if (key === 'id') {
+            id = value;
+        }
+        else if (key === 'title') {
+            title = value;
+        }
+        else if (key === 'type' && isKnowledgeType(value)) {
+            type = value;
+        }
+        else if (key === 'feature') {
+            feature = normalizeFeature(value);
+        }
+        else if (key === 'createdAt') {
+            createdAt = value;
+        }
+    }
+    if (id.length === 0 || title.length === 0 || !type || createdAt.length === 0) {
+        throw new Error(`Missing required metadata in knowledge entry ${file}`);
+    }
+    const body = lines.slice(separatorIndex + 1).join('\n').trim();
+    return {
+        id,
+        title,
+        type,
+        feature,
+        tags: normalizeTags(tags),
+        createdAt,
+        file,
+        body,
+    };
+}
+function toSummary(entry) {
+    return {
+        id: entry.id,
+        title: entry.title,
+        type: entry.type,
+        feature: entry.feature,
+        tags: [...entry.tags],
+        createdAt: entry.createdAt,
+        file: entry.file,
+    };
+}
+function normalizeAddInput(input) {
+    return {
+        id: toKnowledgeId(input.title),
+        title: input.title.trim(),
+        type: input.type,
+        feature: normalizeFeature(input.feature),
+        tags: normalizeTags(input.tags),
+        createdAt: toCreatedAtDate(input.createdAt),
+        body: input.body.trim(),
+    };
+}
+function slugify(value) {
+    return value
+        .toLocaleLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/(^-|-$)/g, '');
+}
+function isKnowledgeType(value) {
+    return (value === 'decision'
+        || value === 'workaround'
+        || value === 'caveat'
+        || value === 'note'
+        || value === 'migration');
+}
+//# sourceMappingURL=knowledge-utils.js.map

package/dist/utils/knowledge-utils.js.map

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

package/dist/utils/sort-utils.d.ts

@@ -0,0 +1,4 @@
+import type { ArchEdge, ArchNode } from '@archkit/core';
+export declare function sortNodes(nodes: ArchNode[]): ArchNode[];
+export declare function sortEdges(edges: ArchEdge[]): ArchEdge[];
+//# sourceMappingURL=sort-utils.d.ts.map

package/dist/utils/sort-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-utils.d.ts","sourceRoot":"","sources":["../../src/utils/sort-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAEvD,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAEvD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAMvD"}

package/dist/utils/sort-utils.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortNodes = sortNodes;
+exports.sortEdges = sortEdges;
+function sortNodes(nodes) {
+    return [...nodes].sort((left, right) => left.id.localeCompare(right.id));
+}
+function sortEdges(edges) {
+    return [...edges].sort((left, right) => {
+        const leftKey = `${left.type}:${left.from}:${left.to}:${left.filePath ?? ''}:${left.loc?.startLine ?? 0}`;
+        const rightKey = `${right.type}:${right.from}:${right.to}:${right.filePath ?? ''}:${right.loc?.startLine ?? 0}`;
+        return leftKey.localeCompare(rightKey);
+    });
+}
+//# sourceMappingURL=sort-utils.js.map

package/dist/utils/sort-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-utils.js","sourceRoot":"","sources":["../../src/utils/sort-utils.ts"],"names":[],"mappings":";;AAEA,8BAEC;AAED,8BAMC;AAVD,SAAgB,SAAS,CAAC,KAAiB;IACzC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAA;AAC1E,CAAC;AAED,SAAgB,SAAS,CAAC,KAAiB;IACzC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,EAAE,CAAA;QACzG,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,QAAQ,IAAI,EAAE,IAAI,KAAK,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,EAAE,CAAA;QAC/G,OAAO,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;IACxC,CAAC,CAAC,CAAA;AACJ,CAAC"}