@diff-review-system/drs 4.1.0 → 5.0.0-rc.1

package/dist/lib/wiki-run-summary.js

@@ -0,0 +1,168 @@
+import { createEmptyUsageSummary, } from './review-usage.js';
+export function createWikiRunSummary(options) {
+    const { plan, validation, workspaceChanges } = options;
+    const missingProvenance = new Set(validation.warnings
+        .filter((warning) => warning.code === 'missing_provenance' && warning.path)
+        .map((warning) => warning.path)).size;
+    const uncoveredConcepts = Math.min(validation.concepts, missingProvenance);
+    const conceptChanges = countConceptChanges(validation.root, workspaceChanges);
+    return {
+        mode: plan.mode,
+        changedSourceCount: plan.changedPathCount,
+        concepts: {
+            total: validation.concepts,
+            ...conceptChanges,
+        },
+        validation: {
+            errors: validation.errors.length,
+            warnings: validation.warnings.length,
+        },
+        graph: validation.graph,
+        provenance: {
+            coveredConcepts: validation.concepts - uncoveredConcepts,
+            uncoveredConcepts,
+            coverage: validation.concepts === 0
+                ? 0
+                : (validation.concepts - uncoveredConcepts) / validation.concepts,
+        },
+        model: {
+            invoked: options.modelInvoked,
+            ...(options.usage?.model ? { id: options.usage.model } : {}),
+            turns: options.usage?.turns ?? 0,
+            usage: options.usage?.usage ?? createEmptyUsageSummary(),
+        },
+        elapsedMs: Math.max(0, Math.round(options.elapsedMs)),
+        ...(plan.instructionsHash ? { instructionsHash: plan.instructionsHash } : {}),
+    };
+}
+export function formatWikiRunSummaryHuman(summary) {
+    return [
+        'Repository wiki summary',
+        `Mode: ${summary.mode}`,
+        `Changed sources: ${summary.changedSourceCount}`,
+        `Concepts: ${summary.concepts.total} total, ${summary.concepts.added} added, ${summary.concepts.edited} edited, ${summary.concepts.deleted} deleted`,
+        `Validation: ${summary.validation.errors} errors, ${summary.validation.warnings} warnings`,
+        `Graph: ${formatGraph(summary)}`,
+        `Provenance: ${formatProvenance(summary)}`,
+        `Model: ${formatModel(summary)}`,
+        `Elapsed: ${formatElapsed(summary.elapsedMs)}`,
+        `Instructions hash: ${summary.instructionsHash ?? 'none'}`,
+    ].join('\n');
+}
+export function formatWikiRunSummaryMarkdown(summary) {
+    const rows = [
+        ['Mode', summary.mode],
+        ['Changed sources', String(summary.changedSourceCount)],
+        [
+            'Concepts',
+            `${summary.concepts.total} total; ${summary.concepts.added} added, ${summary.concepts.edited} edited, ${summary.concepts.deleted} deleted`,
+        ],
+        ['Validation', `${summary.validation.errors} errors, ${summary.validation.warnings} warnings`],
+        ['Graph', formatGraph(summary)],
+        ['Provenance', formatProvenance(summary)],
+        ['Model', formatModel(summary)],
+        ['Elapsed', formatElapsed(summary.elapsedMs)],
+        ['Instructions hash', summary.instructionsHash ?? 'none'],
+    ];
+    return [
+        '## Repository wiki summary',
+        '',
+        '| Metric | Result |',
+        '| --- | --- |',
+        ...rows.map(([label, value]) => `| ${escapeMarkdownTableCell(label)} | ${escapeMarkdownTableCell(value)} |`),
+        '',
+        'Automated repository wiki update generated from the latest default branch.',
+        '',
+        'If the base branch moves before merge, rerun this workflow to refresh the wiki and deterministic state.',
+        '',
+    ].join('\n');
+}
+export function getWikiRunSummary(value) {
+    if (!isRecord(value) || !isRecord(value.summary))
+        return undefined;
+    const summary = value.summary;
+    if (!['generate', 'reconcile', 'update', 'noop'].includes(String(summary.mode)) ||
+        !isNumber(summary.changedSourceCount) ||
+        !isRecord(summary.concepts) ||
+        !hasNumbers(summary.concepts, ['total', 'added', 'edited', 'deleted']) ||
+        !isRecord(summary.validation) ||
+        !hasNumbers(summary.validation, ['errors', 'warnings']) ||
+        !isRecord(summary.graph) ||
+        !hasNumbers(summary.graph, [
+            'nodeCount',
+            'directedEdgeCount',
+            'orphanConceptCount',
+            'weaklyConnectedConceptCount',
+        ]) ||
+        !isRecord(summary.provenance) ||
+        !hasNumbers(summary.provenance, ['coveredConcepts', 'uncoveredConcepts', 'coverage']) ||
+        !isRecord(summary.model) ||
+        typeof summary.model.invoked !== 'boolean' ||
+        !isNumber(summary.model.turns) ||
+        !isRecord(summary.model.usage) ||
+        !hasNumbers(summary.model.usage, [
+            'input',
+            'output',
+            'cacheRead',
+            'cacheWrite',
+            'totalTokens',
+            'cost',
+        ]) ||
+        (summary.model.id !== undefined && typeof summary.model.id !== 'string') ||
+        !isNumber(summary.elapsedMs) ||
+        (summary.instructionsHash !== undefined && typeof summary.instructionsHash !== 'string')) {
+        return undefined;
+    }
+    return summary;
+}
+function countConceptChanges(root, changes) {
+    const isConcept = (filePath) => {
+        const normalizedRoot = root.replaceAll('\\', '/').replace(/\/+$/u, '');
+        const prefix = `${normalizedRoot}/`;
+        if (!filePath.startsWith(prefix) || !filePath.endsWith('.md'))
+            return false;
+        const filename = filePath.slice(filePath.lastIndexOf('/') + 1);
+        return filename !== 'index.md' && filename !== 'log.md';
+    };
+    return {
+        added: changes?.added.filter(isConcept).length ?? 0,
+        edited: changes?.modified.filter(isConcept).length ?? 0,
+        deleted: changes?.deleted.filter(isConcept).length ?? 0,
+    };
+}
+function formatProvenance(summary) {
+    const { coveredConcepts, uncoveredConcepts, coverage } = summary.provenance;
+    return `${coveredConcepts}/${coveredConcepts + uncoveredConcepts} concepts (${(coverage * 100).toFixed(1)}%)`;
+}
+function formatGraph(summary) {
+    return `${summary.graph.nodeCount} concepts, ${summary.graph.directedEdgeCount} directed links, ${summary.graph.orphanConceptCount} orphans, ${summary.graph.weaklyConnectedConceptCount} weakly connected`;
+}
+function formatModel(summary) {
+    if (!summary.model.invoked)
+        return 'not invoked';
+    const id = summary.model.id ?? 'unknown model';
+    const usage = summary.model.usage;
+    return `${id}, ${summary.model.turns} turns, ${usage.totalTokens} tokens (${usage.input} input, ${usage.output} output, ${usage.cacheRead} cache read, ${usage.cacheWrite} cache write), $${usage.cost.toFixed(4)}`;
+}
+function formatElapsed(elapsedMs) {
+    if (elapsedMs < 1000)
+        return `${elapsedMs}ms`;
+    return `${(elapsedMs / 1000).toFixed(1)}s`;
+}
+function escapeMarkdownTableCell(value) {
+    return value
+        .replace(/\p{Cc}/gu, ' ')
+        .replace(/\s+/gu, ' ')
+        .replace(/[\\`*_[\]<>|]/gu, '\\$&')
+        .trim();
+}
+function hasNumbers(value, fields) {
+    return fields.every((field) => isNumber(value[field]));
+}
+function isNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=wiki-run-summary.js.map

package/dist/lib/wiki-run-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-run-summary.js","sourceRoot":"","sources":["../../src/lib/wiki-run-summary.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,uBAAuB,GAGxB,MAAM,mBAAmB,CAAC;AAyC3B,MAAM,UAAU,oBAAoB,CAAC,OAAoC;IACvE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IACvD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAC/B,UAAU,CAAC,QAAQ;SAChB,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;SAC1E,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAc,CAAC,CAC5C,CAAC,IAAI,CAAC;IACP,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC3E,MAAM,cAAc,GAAG,mBAAmB,CAAC,UAAU,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;IAE9E,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,kBAAkB,EAAE,IAAI,CAAC,gBAAgB;QACzC,QAAQ,EAAE;YACR,KAAK,EAAE,UAAU,CAAC,QAAQ;YAC1B,GAAG,cAAc;SAClB;QACD,UAAU,EAAE;YACV,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM;YAChC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM;SACrC;QACD,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,UAAU,EAAE;YACV,eAAe,EAAE,UAAU,CAAC,QAAQ,GAAG,iBAAiB;YACxD,iBAAiB;YACjB,QAAQ,EACN,UAAU,CAAC,QAAQ,KAAK,CAAC;gBACvB,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,GAAG,iBAAiB,CAAC,GAAG,UAAU,CAAC,QAAQ;SACtE;QACD,KAAK,EAAE;YACL,OAAO,EAAE,OAAO,CAAC,YAAY;YAC7B,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC;YAChC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,IAAI,uBAAuB,EAAE;SACzD;QACD,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAuB;IAC/D,OAAO;QACL,yBAAyB;QACzB,SAAS,OAAO,CAAC,IAAI,EAAE;QACvB,oBAAoB,OAAO,CAAC,kBAAkB,EAAE;QAChD,aAAa,OAAO,CAAC,QAAQ,CAAC,KAAK,WAAW,OAAO,CAAC,QAAQ,CAAC,KAAK,WAAW,OAAO,CAAC,QAAQ,CAAC,MAAM,YAAY,OAAO,CAAC,QAAQ,CAAC,OAAO,UAAU;QACpJ,eAAe,OAAO,CAAC,UAAU,CAAC,MAAM,YAAY,OAAO,CAAC,UAAU,CAAC,QAAQ,WAAW;QAC1F,UAAU,WAAW,CAAC,OAAO,CAAC,EAAE;QAChC,eAAe,gBAAgB,CAAC,OAAO,CAAC,EAAE;QAC1C,UAAU,WAAW,CAAC,OAAO,CAAC,EAAE;QAChC,YAAY,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;QAC9C,sBAAsB,OAAO,CAAC,gBAAgB,IAAI,MAAM,EAAE;KAC3D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAuB;IAClE,MAAM,IAAI,GAAG;QACX,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;QACtB,CAAC,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QACvD;YACE,UAAU;YACV,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,WAAW,OAAO,CAAC,QAAQ,CAAC,KAAK,WAAW,OAAO,CAAC,QAAQ,CAAC,MAAM,YAAY,OAAO,CAAC,QAAQ,CAAC,OAAO,UAAU;SAC3I;QACD,CAAC,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,YAAY,OAAO,CAAC,UAAU,CAAC,QAAQ,WAAW,CAAC;QAC9F,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,YAAY,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,SAAS,EAAE,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC,mBAAmB,EAAE,OAAO,CAAC,gBAAgB,IAAI,MAAM,CAAC;KAC1D,CAAC;IAEF,OAAO;QACL,4BAA4B;QAC5B,EAAE;QACF,qBAAqB;QACrB,eAAe;QACf,GAAG,IAAI,CAAC,GAAG,CACT,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CACjB,KAAK,uBAAuB,CAAC,KAAK,CAAC,MAAM,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAC9E;QACD,EAAE;QACF,4EAA4E;QAC5E,EAAE;QACF,yGAAyG;QACzG,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACnE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9B,IACE,CAAC,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3E,CAAC,QAAQ,CAAC,OAAO,CAAC,kBAAkB,CAAC;QACrC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC3B,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;QACtE,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;QAC7B,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACvD,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;QACxB,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE;YACzB,WAAW;YACX,mBAAmB;YACnB,oBAAoB;YACpB,6BAA6B;SAC9B,CAAC;QACF,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;QAC7B,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,EAAE,UAAU,CAAC,CAAC;QACrF,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;QACxB,OAAO,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS;QAC1C,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAC9B,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAC9B,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE;YAC/B,OAAO;YACP,QAAQ;YACR,WAAW;YACX,YAAY;YACZ,aAAa;YACb,MAAM;SACP,CAAC;QACF,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC;QACxE,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;QAC5B,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,gBAAgB,KAAK,QAAQ,CAAC,EACxF,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,OAAoC,CAAC;AAC9C,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAAY,EACZ,OAA0C;IAE1C,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAW,EAAE;QAC9C,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,GAAG,cAAc,GAAG,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5E,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,OAAO,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,QAAQ,CAAC;IAC1D,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,IAAI,CAAC;QACnD,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,IAAI,CAAC;QACvD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,IAAI,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAuB;IAC/C,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAC5E,OAAO,GAAG,eAAe,IAAI,eAAe,GAAG,iBAAiB,cAAc,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAChH,CAAC;AAED,SAAS,WAAW,CAAC,OAAuB;IAC1C,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,cAAc,OAAO,CAAC,KAAK,CAAC,iBAAiB,oBAAoB,OAAO,CAAC,KAAK,CAAC,kBAAkB,aAAa,OAAO,CAAC,KAAK,CAAC,2BAA2B,mBAAmB,CAAC;AAC9M,CAAC;AAED,SAAS,WAAW,CAAC,OAAuB;IAC1C,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,aAAa,CAAC;IACjD,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,eAAe,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAClC,OAAO,GAAG,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,WAAW,YAAY,KAAK,CAAC,KAAK,WAAW,KAAK,CAAC,MAAM,YAAY,KAAK,CAAC,SAAS,gBAAgB,KAAK,CAAC,UAAU,mBAAmB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACtN,CAAC;AAED,SAAS,aAAa,CAAC,SAAiB;IACtC,IAAI,SAAS,GAAG,IAAI;QAAE,OAAO,GAAG,SAAS,IAAI,CAAC;IAC9C,OAAO,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa;IAC5C,OAAO,KAAK;SACT,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC;SAClC,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,UAAU,CAAC,KAA8B,EAAE,MAAgB;IAClE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/lib/wiki-search.d.ts

@@ -0,0 +1,24 @@
+import { type OkfConceptSource } from './okf-wiki.js';
+export interface WikiSearchOptions {
+    limit?: number;
+    source?: string;
+}
+export interface WikiSearchMatch {
+    description?: string;
+    path: string;
+    score: number;
+    snippet: string;
+    sources?: OkfConceptSource[];
+    tags: string[];
+    title: string;
+    type: string;
+}
+export interface WikiSearchResult {
+    query: string;
+    results: WikiSearchMatch[];
+    source: string;
+    total: number;
+}
+/** Search a validated OKF bundle without a model or generated site index. */
+export declare function searchWiki(workingDir: string, query: string, options?: WikiSearchOptions): Promise<WikiSearchResult>;
+//# sourceMappingURL=wiki-search.d.ts.map

package/dist/lib/wiki-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-search.d.ts","sourceRoot":"","sources":["../../src/lib/wiki-search.ts"],"names":[],"mappings":"AACA,OAAO,EAA4C,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEhG,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,6EAA6E;AAC7E,wBAAsB,UAAU,CAC9B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA4B3B"}

package/dist/lib/wiki-search.js

@@ -0,0 +1,200 @@
+import * as path from 'path';
+import { loadOkfConcepts } from './okf-wiki.js';
+const DEFAULT_LIMIT = 10;
+/** Search a validated OKF bundle without a model or generated site index. */
+export async function searchWiki(workingDir, query, options = {}) {
+    const displayQuery = cleanDisplayText(query);
+    const normalizedQuery = normalizeSearchText(displayQuery);
+    if (!normalizedQuery)
+        throw new Error('Wiki search query cannot be empty.');
+    const limit = options.limit ?? DEFAULT_LIMIT;
+    if (!Number.isInteger(limit) || limit <= 0) {
+        throw new Error('Wiki search limit must be a positive integer.');
+    }
+    const bundle = await loadOkfConcepts(workingDir, options.source ?? 'wiki');
+    const terms = [...new Set(normalizedQuery.split(' '))];
+    const matches = bundle.concepts
+        .map((concept) => scoreConcept(bundle.root, concept, normalizedQuery, terms))
+        .filter((match) => match !== null)
+        .sort((left, right) => right.score - left.score ||
+        compareStrings(left.title, right.title) ||
+        compareStrings(left.path, right.path));
+    return {
+        query: displayQuery,
+        results: matches.slice(0, limit),
+        source: bundle.root,
+        total: matches.length,
+    };
+}
+function scoreConcept(root, concept, phrase, terms) {
+    const headings = extractHeadings(concept.body);
+    const title = cleanDisplayText(concept.title ?? headings[0] ?? titleFromPath(concept.path));
+    const description = concept.description ? cleanDisplayText(concept.description) : undefined;
+    const tags = concept.tags.map(cleanDisplayText).filter(Boolean);
+    const fields = [
+        { values: [title], phraseWeight: 80, termWeight: 20 },
+        { values: tags, phraseWeight: 50, termWeight: 15 },
+        { values: [description ?? ''], phraseWeight: 40, termWeight: 10 },
+        { values: headings, phraseWeight: 30, termWeight: 8 },
+        { values: [concept.path], phraseWeight: 24, termWeight: 6 },
+        { values: [concept.type], phraseWeight: 20, termWeight: 5 },
+        { values: [concept.body], phraseWeight: 16, termWeight: 2 },
+    ];
+    const allTokens = new Set(fields.flatMap((field) => field.values.flatMap(tokenize)));
+    const matchedTerms = terms.filter((term) => allTokens.has(term));
+    if (matchedTerms.length === 0)
+        return null;
+    let score = matchedTerms.length * 3;
+    if (matchedTerms.length === terms.length)
+        score += 25;
+    if (normalizeSearchText(title) === phrase)
+        score += 100;
+    for (const field of fields) {
+        const normalizedValues = field.values.map(normalizeSearchText).filter(Boolean);
+        if (normalizedValues.some((value) => value.includes(phrase)))
+            score += field.phraseWeight;
+        const tokens = new Set(normalizedValues.flatMap((value) => value.split(' ')));
+        score += terms.filter((term) => tokens.has(term)).length * field.termWeight;
+    }
+    return {
+        path: path.posix.join(root, concept.path),
+        score,
+        snippet: createSnippet(concept, phrase, terms),
+        ...(concept.sources?.length ? { sources: concept.sources } : {}),
+        tags,
+        title,
+        type: cleanDisplayText(concept.type),
+        ...(description ? { description } : {}),
+    };
+}
+function createSnippet(concept, phrase, terms) {
+    const bodySegments = concept.body
+        .split(/\n\s*\n/gu)
+        .map(stripMarkdown)
+        .filter(Boolean);
+    const candidates = [
+        concept.description ? cleanDisplayText(concept.description) : '',
+        ...bodySegments,
+        cleanDisplayText(concept.title ?? ''),
+        concept.tags.map(cleanDisplayText).join(', '),
+        cleanDisplayText(concept.type),
+        cleanDisplayText(concept.path),
+    ]
+        .filter(Boolean)
+        .map((value, index) => ({ index, score: snippetScore(value, phrase, terms), value }));
+    candidates.sort((left, right) => right.score - left.score || left.index - right.index);
+    const selected = candidates[0]?.value ?? cleanDisplayText(concept.title ?? concept.path);
+    return excerpt(selected, phrase, terms, 180);
+}
+function snippetScore(value, phrase, terms) {
+    const normalized = normalizeSearchText(value);
+    const tokens = new Set(normalized.split(' '));
+    return (normalized.includes(phrase) ? 10 : 0) + terms.filter((term) => tokens.has(term)).length;
+}
+function excerpt(value, phrase, terms, maximumLength) {
+    const normalizedValue = value.normalize('NFKC');
+    const characters = [...normalizedValue];
+    if (characters.length <= maximumLength)
+        return normalizedValue;
+    const matchIndex = findSearchMatchOffset(normalizedValue, [phrase, ...terms]);
+    const start = Math.max(0, (matchIndex < 0 ? 0 : matchIndex) - 40);
+    const end = Math.min(characters.length, start + maximumLength);
+    return `${start > 0 ? '...' : ''}${characters.slice(start, end).join('').trim()}${end < characters.length ? '...' : ''}`;
+}
+function findSearchMatchOffset(value, candidates) {
+    let searchable = '';
+    const offsets = [];
+    let previousWasSeparator = true;
+    for (const [offset, character] of [...value].entries()) {
+        const normalized = character.toLocaleLowerCase('en-US').replace(/[^\p{L}\p{N}]+/gu, ' ');
+        for (const normalizedCharacter of normalized) {
+            const separator = normalizedCharacter === ' ';
+            if (separator && previousWasSeparator)
+                continue;
+            searchable += normalizedCharacter;
+            offsets.push(offset);
+            previousWasSeparator = separator;
+        }
+    }
+    if (searchable.endsWith(' ')) {
+        searchable = searchable.slice(0, -1);
+        offsets.pop();
+    }
+    const searchIndex = candidates.reduce((best, candidate) => {
+        const index = searchable.indexOf(candidate);
+        return index >= 0 && (best < 0 || index < best) ? index : best;
+    }, -1);
+    return searchIndex < 0 ? -1 : (offsets[searchIndex] ?? -1);
+}
+function extractHeadings(body) {
+    const headings = [];
+    let fence;
+    for (const line of body.split(/\r?\n/gu)) {
+        const fenceLine = /^\s{0,3}(`{3,}|~{3,})(.*)$/u.exec(line);
+        if (fenceLine) {
+            const [, fenceMatch, remainder] = fenceLine;
+            if (!fence) {
+                if (fenceMatch[0] !== '`' || !remainder.includes('`')) {
+                    fence = { character: fenceMatch[0], length: fenceMatch.length };
+                }
+            }
+            else if (fenceMatch[0] === fence.character &&
+                fenceMatch.length >= fence.length &&
+                !remainder.trim()) {
+                fence = undefined;
+            }
+            continue;
+        }
+        if (fence)
+            continue;
+        const heading = /^#{1,6}\s+(.+?)\s*#*\s*$/u.exec(line)?.[1];
+        if (heading)
+            headings.push(stripMarkdown(heading));
+    }
+    return headings;
+}
+function stripMarkdown(value) {
+    return cleanDisplayText(value
+        .replace(/!\[([^\]]*)\]\([^)]*\)/gu, '$1')
+        .replace(/\[([^\]]+)\]\([^)]*\)/gu, '$1')
+        .replace(/^\s{0,3}(?:#{1,6}|[-*+]|\d+\.)\s+/gmu, '')
+        .replace(/[`*_~>]/gu, ' '));
+}
+function tokenize(value) {
+    const normalized = normalizeSearchText(value);
+    return normalized ? normalized.split(' ') : [];
+}
+function normalizeSearchText(value) {
+    return cleanDisplayText(value)
+        .normalize('NFKC')
+        .toLocaleLowerCase('en-US')
+        .replace(/[^\p{L}\p{N}]+/gu, ' ')
+        .trim();
+}
+function cleanDisplayText(value) {
+    return [...value]
+        .map((character) => {
+        const codePoint = character.codePointAt(0) ?? 0;
+        const unsafeControl = codePoint <= 8 ||
+            codePoint === 11 ||
+            codePoint === 12 ||
+            (codePoint >= 14 && codePoint <= 31) ||
+            (codePoint >= 127 && codePoint <= 159);
+        return unsafeControl ? ' ' : character;
+    })
+        .join('')
+        .replace(/\s+/gu, ' ')
+        .trim();
+}
+function titleFromPath(relativePath) {
+    const slug = path.posix.basename(relativePath, '.md');
+    return slug
+        .split(/[-_\s]+/u)
+        .filter(Boolean)
+        .map((word) => `${word[0].toUpperCase()}${word.slice(1)}`)
+        .join(' ');
+}
+function compareStrings(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=wiki-search.js.map

package/dist/lib/wiki-search.js.map

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

package/dist/lib/wiki-site-graph.d.ts

@@ -0,0 +1,33 @@
+export interface WikiSiteGraphConcept {
+    description: string;
+    id: string;
+    links: string[];
+    title: string;
+    type: string;
+}
+export interface WikiSiteGraphOptions {
+    base: string;
+    siteTitle: string;
+}
+export interface WikiConceptGraphEdge {
+    source: string;
+    target: string;
+}
+export interface WikiConceptGraphMetrics {
+    directedEdgeCount: number;
+    nodeCount: number;
+    orphanConceptCount: number;
+    weaklyConnectedConceptCount: number;
+}
+export interface WikiConceptGraphAnalysis {
+    edges: WikiConceptGraphEdge[];
+    metrics: WikiConceptGraphMetrics;
+    orphanIds: string[];
+    weaklyConnectedIds: string[];
+}
+export declare function extractWikiSiteConceptLinks(content: string, currentId: string, conceptIds: ReadonlySet<string>): string[];
+/** Analyze semantic concept links as directed edges and deterministic quality metrics. */
+export declare function analyzeWikiConceptGraph(concepts: ReadonlyArray<Pick<WikiSiteGraphConcept, 'id' | 'links'>>): WikiConceptGraphAnalysis;
+export declare function createWikiSiteGraphHtml(concepts: WikiSiteGraphConcept[], options: WikiSiteGraphOptions): string;
+export declare function encodeWikiSiteConceptId(id: string): string;
+//# sourceMappingURL=wiki-site-graph.d.ts.map

package/dist/lib/wiki-site-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-site-graph.d.ts","sourceRoot":"","sources":["../../src/lib/wiki-site-graph.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,OAAO,EAAE,uBAAuB,CAAC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAmBD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,MAAM,EAAE,CA2BV;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC,GAClE,wBAAwB,CAuC1B;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,oBAAoB,EAAE,EAChC,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CA+VR;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAK1D"}