cgraphx 1.4.1 → 2.0.0

package/dist/core/markdown/constants.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Business constants for the markdown knowledge base subsystem.
+ *
+ * These mirror the spec §5 validation rules. Keep this file the single source
+ * of truth for required fields, enum values, and section names.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACCEPTED_EXTENSIONS = exports.KNOWLEDGE_DIR = exports.SUMMARY_HEADINGS = exports.OPTIONAL_SCALAR_KEYS = exports.LIST_KEYS = exports.SOURCE_TYPES = exports.DOCUMENT_STATUSES = exports.DOCUMENT_TYPES = exports.REQUIRED_FRONTMATTER_KEYS = void 0;
+exports.REQUIRED_FRONTMATTER_KEYS = [
+    'title',
+    'document_type',
+    'domains',
+    'concepts',
+    'status',
+    'source_type',
+    'updated',
+    'owners',
+];
+exports.DOCUMENT_TYPES = [
+    'business-entity', // 业务实体
+    'business-flow', // 业务流程
+    'mechanism', // 技术机制(含架构)
+    'decision', // 决策
+    'rule', // 规则
+    'lesson', // 教训
+    'guide', // 指南(含运维手册/教程/安装/FAQ/API 文档)
+];
+exports.DOCUMENT_STATUSES = [
+    'draft',
+    'active',
+    'superseded',
+    'deprecated',
+];
+exports.SOURCE_TYPES = [
+    'work_context', // 工作上下文:需求/任务流中沉淀
+    'batch_exploration', // 批量探索:knowledge-init 式项目探索
+    'review', // 评审:代码/架构评审中发现
+    'debugging', // 调查排障:问题调查中发现
+    'manual', // 手工:人工主动整理
+];
+exports.LIST_KEYS = [
+    'domains',
+    'concepts',
+    'aliases',
+    'tags',
+    'owners',
+    'related_code',
+    'related_documents',
+];
+exports.OPTIONAL_SCALAR_KEYS = [
+    'created',
+    'updated',
+];
+/** Headings recognized as the Summary section. Match must be exact + case-sensitive. */
+exports.SUMMARY_HEADINGS = ['Summary', '摘要'];
+/** Subdirectory under project root that gets scanned. */
+exports.KNOWLEDGE_DIR = 'docs/knowledge';
+/** File extensions accepted by the scanner. */
+exports.ACCEPTED_EXTENSIONS = ['.md', '.mdx'];
+//# sourceMappingURL=constants.js.map

package/dist/core/markdown/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/markdown/constants.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEU,QAAA,yBAAyB,GAAG;IACvC,OAAO;IACP,eAAe;IACf,SAAS;IACT,UAAU;IACV,QAAQ;IACR,aAAa;IACb,SAAS;IACT,QAAQ;CACA,CAAC;AAEE,QAAA,cAAc,GAAG;IAC5B,iBAAiB,EAAE,OAAO;IAC1B,eAAe,EAAE,OAAO;IACxB,WAAW,EAAE,YAAY;IACzB,UAAU,EAAE,KAAK;IACjB,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,KAAK;IACf,OAAO,EAAE,6BAA6B;CAC9B,CAAC;AAEE,QAAA,iBAAiB,GAAG;IAC/B,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,YAAY;CACJ,CAAC;AAEE,QAAA,YAAY,GAAG;IAC1B,cAAc,EAAE,kBAAkB;IAClC,mBAAmB,EAAE,4BAA4B;IACjD,QAAQ,EAAE,gBAAgB;IAC1B,WAAW,EAAE,eAAe;IAC5B,QAAQ,EAAE,YAAY;CACd,CAAC;AAEE,QAAA,SAAS,GAAG;IACvB,SAAS;IACT,UAAU;IACV,SAAS;IACT,MAAM;IACN,QAAQ;IACR,cAAc;IACd,mBAAmB;CACX,CAAC;AAEE,QAAA,oBAAoB,GAAG;IAClC,SAAS;IACT,SAAS;CACD,CAAC;AAEX,wFAAwF;AAC3E,QAAA,gBAAgB,GAAG,CAAC,SAAS,EAAE,IAAI,CAAU,CAAC;AAE3D,yDAAyD;AAC5C,QAAA,aAAa,GAAG,gBAAgB,CAAC;AAE9C,+CAA+C;AAClC,QAAA,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC"}

package/dist/core/markdown/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAmBH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAwB/C"}

package/dist/core/markdown/dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../../src/core/markdown/dedup.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAmBH,sCAwBC;AAzCD,4EAA4E;AAC5E,qDAAqD;AACrD,yCAAyC;AACzC,yCAAyC;AACzC,kFAAkF;AAClF,sCAAsC;AACtC,sCAAsC;AACtC,2EAA2E;AAC3E,6EAA6E;AAC7E,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS;IAC3C,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,0BAA0B;IAC/B,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,oBAAoB;CAC1B,CAAC,CAAC;AAEH,SAAgB,aAAa,CAAC,CAAS;IACrC,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,SAAS,CAAC,uCAAuC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,yEAAyE;QACzE,gDAAgD;QAChD,IAAI,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC3C,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC9B,IACE,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,IAAQ,MAAM;YACxC,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,GAAG,CAAC,IAAO,2BAA2B;YAC7D,CAAC,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,CAAC,IAAI,qCAAqC;YAC3E,IAAI,IAAI,MAAM,CAAoB,+CAA+C;UACjF,CAAC;YACD,GAAG,IAAI,EAAE,CAAC;QACZ,CAAC;QACD,2EAA2E;QAC3E,2DAA2D;IAC7D,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/markdown/errors.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Error types for the markdown knowledge base subsystem.
+ *
+ * Kept separate from cgraphx's main error types so the subsystem can be
+ * removed without touching the rest of the project.
+ */
+export declare class MarkdownIndexError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class SchemaMismatchError extends MarkdownIndexError {
+    constructor(expected: number, actual: number);
+}
+export declare class DocumentNotFoundError extends MarkdownIndexError {
+    readonly queriedIdOrPath: string;
+    constructor(queriedIdOrPath: string);
+}
+export declare class ProjectNotInitializedError extends MarkdownIndexError {
+    readonly projectPath: string;
+    constructor(projectPath: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/markdown/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,kBAAmB,SAAQ,KAAK;aACE,KAAK,CAAC,EAAE,OAAO;gBAAhD,OAAO,EAAE,MAAM,EAAkB,KAAK,CAAC,EAAE,OAAO,YAAA;CAI7D;AAED,qBAAa,mBAAoB,SAAQ,kBAAkB;gBAC7C,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAO7C;AAED,qBAAa,qBAAsB,SAAQ,kBAAkB;aAC/B,eAAe,EAAE,MAAM;gBAAvB,eAAe,EAAE,MAAM;CAIpD;AAED,qBAAa,0BAA2B,SAAQ,kBAAkB;aACpC,WAAW,EAAE,MAAM;gBAAnB,WAAW,EAAE,MAAM;CAMhD"}

package/dist/core/markdown/errors.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Error types for the markdown knowledge base subsystem.
+ *
+ * Kept separate from cgraphx's main error types so the subsystem can be
+ * removed without touching the rest of the project.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectNotInitializedError = exports.DocumentNotFoundError = exports.SchemaMismatchError = exports.MarkdownIndexError = void 0;
+class MarkdownIndexError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'MarkdownIndexError';
+    }
+}
+exports.MarkdownIndexError = MarkdownIndexError;
+class SchemaMismatchError extends MarkdownIndexError {
+    constructor(expected, actual) {
+        super(`Markdown subsystem schema mismatch: expected version ${expected}, found ${actual}. ` +
+            `Run \`cgraphx docs index\` to apply the latest schema.`);
+        this.name = 'SchemaMismatchError';
+    }
+}
+exports.SchemaMismatchError = SchemaMismatchError;
+class DocumentNotFoundError extends MarkdownIndexError {
+    queriedIdOrPath;
+    constructor(queriedIdOrPath) {
+        super(`Document not found: ${queriedIdOrPath}`);
+        this.queriedIdOrPath = queriedIdOrPath;
+        this.name = 'DocumentNotFoundError';
+    }
+}
+exports.DocumentNotFoundError = DocumentNotFoundError;
+class ProjectNotInitializedError extends MarkdownIndexError {
+    projectPath;
+    constructor(projectPath) {
+        super(`cgraphx not initialized at ${projectPath}. Run \`cgraphx install\` first.`);
+        this.projectPath = projectPath;
+        this.name = 'ProjectNotInitializedError';
+    }
+}
+exports.ProjectNotInitializedError = ProjectNotInitializedError;
+//# sourceMappingURL=errors.js.map

package/dist/core/markdown/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/markdown/errors.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,MAAa,kBAAmB,SAAQ,KAAK;IACE;IAA7C,YAAY,OAAe,EAAkB,KAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,UAAK,GAAL,KAAK,CAAU;QAE1D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAED,MAAa,mBAAoB,SAAQ,kBAAkB;IACzD,YAAY,QAAgB,EAAE,MAAc;QAC1C,KAAK,CACH,wDAAwD,QAAQ,WAAW,MAAM,IAAI;YACnF,wDAAwD,CAC3D,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AARD,kDAQC;AAED,MAAa,qBAAsB,SAAQ,kBAAkB;IAC/B;IAA5B,YAA4B,eAAuB;QACjD,KAAK,CAAC,uBAAuB,eAAe,EAAE,CAAC,CAAC;QADtB,oBAAe,GAAf,eAAe,CAAQ;QAEjD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AALD,sDAKC;AAED,MAAa,0BAA2B,SAAQ,kBAAkB;IACpC;IAA5B,YAA4B,WAAmB;QAC7C,KAAK,CACH,8BAA8B,WAAW,kCAAkC,CAC5E,CAAC;QAHwB,gBAAW,GAAX,WAAW,CAAQ;QAI7C,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAPD,gEAOC"}

package/dist/core/markdown/extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAcH,OAAO,KAAK,EAEV,kBAAkB,EAClB,YAAY,EAEb,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,GACxC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAEtC;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,GAClB,aAAa,CA2Gf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,GAClB,MAAM,CAGR"}

package/dist/core/markdown/extractor.js.map

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

package/dist/core/markdown/frontmatter-parser.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Minimal YAML frontmatter parser.
+ *
+ * Supports the limited subset of YAML the markdown knowledge base requires:
+ *   - `key: value`                 (scalar)
+ *   - `key:` followed by a list of `  - item` lines
+ *
+ * Rejects (throws) on anything more complex — nested objects, anchors/aliases,
+ * flow collections, block scalars, tab indentation, full-width colons. This is
+ * deliberate: the frontmatter convention is intentionally simple, and a parser
+ * that silently accepts surprising shapes is worse than one that errors.
+ *
+ * Does NOT depend on the `yaml` npm package. No new runtime deps for the
+ * subsystem.
+ */
+export type MetaValue = string | string[];
+export interface ParsedFrontmatter {
+    values: Map<string, MetaValue>;
+}
+export declare class FrontmatterSyntaxError extends Error {
+    readonly line: number;
+    constructor(message: string, line: number);
+}
+/**
+ * Extract the YAML frontmatter block delimited by leading `---` lines.
+ *
+ * Returns `null` when no frontmatter is present. Throws `FrontmatterSyntaxError`
+ * when an opening `---` is found but no matching close is.
+ *
+ * @param source full file source (CRLF normalized to LF)
+ * @returns the body between the fences (excluding the fences themselves)
+ */
+export declare function extractFrontmatterBlock(source: string): string | null;
+/**
+ * 去掉文件开头的 `---` … `---` frontmatter 块,返回正文。
+ *
+ * 无 frontmatter / frontmatter 未闭合 → 原样返回(降级语义与调用方对
+ * parseFrontmatter 的处理一致:剥离失败不破坏原文)。
+ */
+export declare function stripFrontmatter(raw: string): string;
+/**
+ * Parse the YAML-subset frontmatter into a Map.
+ *
+ * @throws FrontmatterSyntaxError on any unsupported syntax
+ */
+export declare function parseFrontmatter(source: string): ParsedFrontmatter;
+export declare function parseFrontmatterBlock(block: string): ParsedFrontmatter;
+/** Convenience: read a scalar value (default ''). */
+export declare function readScalar(parsed: ParsedFrontmatter, key: string): string;
+/** Convenience: read a list value (default []). Throws if the key holds a scalar. */
+export declare function readList(parsed: ParsedFrontmatter, key: string): string[];
+/** Convenience: presence + non-empty check. */
+export declare function hasNonEmpty(parsed: ParsedFrontmatter, key: string): boolean;
+//# sourceMappingURL=frontmatter-parser.d.ts.map

package/dist/core/markdown/frontmatter-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-parser.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/frontmatter-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CAChC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;aAG7B,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQpD;AAwDD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAMlE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAmGtE;AAoBD,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAUzE;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,MAAM,GACV,OAAO,CAKT"}

package/dist/core/markdown/frontmatter-parser.js

@@ -0,0 +1,229 @@
+"use strict";
+/**
+ * Minimal YAML frontmatter parser.
+ *
+ * Supports the limited subset of YAML the markdown knowledge base requires:
+ *   - `key: value`                 (scalar)
+ *   - `key:` followed by a list of `  - item` lines
+ *
+ * Rejects (throws) on anything more complex — nested objects, anchors/aliases,
+ * flow collections, block scalars, tab indentation, full-width colons. This is
+ * deliberate: the frontmatter convention is intentionally simple, and a parser
+ * that silently accepts surprising shapes is worse than one that errors.
+ *
+ * Does NOT depend on the `yaml` npm package. No new runtime deps for the
+ * subsystem.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontmatterSyntaxError = void 0;
+exports.extractFrontmatterBlock = extractFrontmatterBlock;
+exports.stripFrontmatter = stripFrontmatter;
+exports.parseFrontmatter = parseFrontmatter;
+exports.parseFrontmatterBlock = parseFrontmatterBlock;
+exports.readScalar = readScalar;
+exports.readList = readList;
+exports.hasNonEmpty = hasNonEmpty;
+class FrontmatterSyntaxError extends Error {
+    line;
+    constructor(message, line) {
+        super(`Line ${line}: ${message}`);
+        this.line = line;
+        this.name = 'FrontmatterSyntaxError';
+    }
+}
+exports.FrontmatterSyntaxError = FrontmatterSyntaxError;
+/**
+ * Extract the YAML frontmatter block delimited by leading `---` lines.
+ *
+ * Returns `null` when no frontmatter is present. Throws `FrontmatterSyntaxError`
+ * when an opening `---` is found but no matching close is.
+ *
+ * @param source full file source (CRLF normalized to LF)
+ * @returns the body between the fences (excluding the fences themselves)
+ */
+function extractFrontmatterBlock(source) {
+    return locateFrontmatterBlock(source)?.inner ?? null;
+}
+/**
+ * 去掉文件开头的 `---` … `---` frontmatter 块,返回正文。
+ *
+ * 无 frontmatter / frontmatter 未闭合 → 原样返回(降级语义与调用方对
+ * parseFrontmatter 的处理一致:剥离失败不破坏原文)。
+ */
+function stripFrontmatter(raw) {
+    let located;
+    try {
+        located = locateFrontmatterBlock(raw);
+    }
+    catch {
+        return raw; // frontmatter 未闭合 → 原样返回
+    }
+    return located?.body ?? raw; // 无 frontmatter → 原样返回
+}
+/**
+ * 共用的 frontmatter 块定位逻辑(extractFrontmatterBlock 与 stripFrontmatter
+ * 复用同一套 fence 规则:BOM 容忍、前置空行跳过、闭合 fence 为 `---` 或 `...`)。
+ *
+ * @returns null 表示没有 frontmatter
+ * @throws FrontmatterSyntaxError frontmatter opened with --- but never closed
+ */
+function locateFrontmatterBlock(source) {
+    const lines = source.split('\n');
+    // Optional BOM at the very start
+    if (lines[0]?.startsWith('')) {
+        lines[0] = lines[0].slice(1);
+    }
+    // Skip leading blank lines (allow whitespace before the fence)
+    let i = 0;
+    while (i < lines.length && lines[i].trim() === '') {
+        i++;
+    }
+    if (i >= lines.length || lines[i].trim() !== '---') {
+        return null;
+    }
+    const startIdx = i + 1;
+    // Find the close fence. Spec: a line whose trimmed content is exactly `---` or `...`.
+    let endIdx = -1;
+    for (let j = startIdx; j < lines.length; j++) {
+        const t = lines[j].trim();
+        if (t === '---' || t === '...') {
+            endIdx = j;
+            break;
+        }
+    }
+    if (endIdx === -1) {
+        throw new FrontmatterSyntaxError('frontmatter opened with --- but never closed', startIdx);
+    }
+    return {
+        inner: lines.slice(startIdx, endIdx).join('\n'),
+        body: lines.slice(endIdx + 1).join('\n'),
+    };
+}
+/**
+ * Parse the YAML-subset frontmatter into a Map.
+ *
+ * @throws FrontmatterSyntaxError on any unsupported syntax
+ */
+function parseFrontmatter(source) {
+    const block = extractFrontmatterBlock(source);
+    if (block === null) {
+        return { values: new Map() };
+    }
+    return parseFrontmatterBlock(block);
+}
+function parseFrontmatterBlock(block) {
+    const values = new Map();
+    const lines = block.split('\n');
+    let i = 0;
+    while (i < lines.length) {
+        const raw = lines[i];
+        // Skip blank lines and comments
+        if (raw.trim() === '' || raw.trim().startsWith('#')) {
+            i++;
+            continue;
+        }
+        const lineNo = i + 1;
+        if (raw.startsWith('\t')) {
+            throw new FrontmatterSyntaxError('tab indentation is not allowed; use spaces', lineNo);
+        }
+        // Top-level key:value (no leading indentation)
+        if (/^\s/.test(raw)) {
+            throw new FrontmatterSyntaxError('unexpected indented line (expected a top-level key)', lineNo);
+        }
+        const colonIdx = raw.indexOf(':');
+        if (colonIdx === -1) {
+            throw new FrontmatterSyntaxError(`expected "key: value" but no colon found in: ${raw}`, lineNo);
+        }
+        const key = raw.slice(0, colonIdx).trim();
+        const restRaw = raw.slice(colonIdx + 1);
+        // Reject full-width colon anywhere in the line — common CJK typo
+        // (U+FF1A, not the ASCII ':' that delimits key from value)
+        if (raw.includes('：')) {
+            throw new FrontmatterSyntaxError('full-width colon (：) is not allowed; use half-width ":"', lineNo);
+        }
+        if (!/^[a-zA-Z_][a-zA-Z0-9_-]*$/.test(key)) {
+            throw new FrontmatterSyntaxError(`invalid key "${key}"; expected alphanumeric/underscore/dash`, lineNo);
+        }
+        const rest = restRaw.trim();
+        if (rest === '') {
+            // Could be `key:` with inline null OR `key:\n  - item` list. Peek next lines.
+            const listItems = [];
+            let j = i + 1;
+            while (j < lines.length) {
+                const nl = lines[j];
+                if (nl.trim() === '') {
+                    j++;
+                    continue;
+                }
+                // List item: starts with whitespace then `-`
+                if (/^\s+-\s+/.test(nl) || /^\s+-$/.test(nl)) {
+                    if (nl.includes('\t')) {
+                        throw new FrontmatterSyntaxError('tab indentation is not allowed in list items', j + 1);
+                    }
+                    const item = nl.replace(/^\s+-\s*/, '').trim();
+                    listItems.push(stripQuotes(item, j + 1));
+                    j++;
+                }
+                else {
+                    break;
+                }
+            }
+            if (listItems.length > 0) {
+                values.set(key, listItems);
+                i = j;
+            }
+            else {
+                // Empty value — treat as empty string
+                values.set(key, '');
+                i++;
+            }
+        }
+        else {
+            // Inline scalar
+            values.set(key, stripQuotes(rest, lineNo));
+            i++;
+        }
+    }
+    return { values };
+}
+/** Remove surrounding matching quotes (single or double). Throws on mismatched. */
+function stripQuotes(value, line) {
+    if (value.length >= 2) {
+        const first = value[0];
+        const last = value[value.length - 1];
+        if ((first === '"' || first === "'") && first === last) {
+            return value.slice(1, -1);
+        }
+        if ((first === '"' || first === "'") && first !== last) {
+            throw new FrontmatterSyntaxError(`mismatched quote in value: ${value}`, line);
+        }
+    }
+    return value;
+}
+/** Convenience: read a scalar value (default ''). */
+function readScalar(parsed, key) {
+    const v = parsed.values.get(key);
+    if (v === undefined)
+        return '';
+    return Array.isArray(v) ? v[0] ?? '' : v;
+}
+/** Convenience: read a list value (default []). Throws if the key holds a scalar. */
+function readList(parsed, key) {
+    const v = parsed.values.get(key);
+    if (v === undefined)
+        return [];
+    if (typeof v === 'string') {
+        throw new FrontmatterSyntaxError(`key "${key}" should be a list, got scalar "${v}"`, 0);
+    }
+    return v;
+}
+/** Convenience: presence + non-empty check. */
+function hasNonEmpty(parsed, key) {
+    const v = parsed.values.get(key);
+    if (v === undefined)
+        return false;
+    if (typeof v === 'string')
+        return v.trim() !== '';
+    return v.length > 0;
+}
+//# sourceMappingURL=frontmatter-parser.js.map

package/dist/core/markdown/frontmatter-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-parser.js","sourceRoot":"","sources":["../../../src/core/markdown/frontmatter-parser.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AA2BH,0DAEC;AAQD,4CAQC;AA6DD,4CAMC;AAED,sDAmGC;AAqBD,gCAIC;AAGD,4BAUC;AAGD,kCAQC;AA9PD,MAAa,sBAAuB,SAAQ,KAAK;IAG7B;IAFlB,YACE,OAAe,EACC,IAAY;QAE5B,KAAK,CAAC,QAAQ,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAFlB,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AARD,wDAQC;AAED;;;;;;;;GAQG;AACH,SAAgB,uBAAuB,CAAC,MAAc;IACpD,OAAO,sBAAsB,CAAC,MAAM,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,IAAI,OAAmC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC,CAAC,yBAAyB;IACvC,CAAC;IACD,OAAO,OAAO,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC,uBAAuB;AACtD,CAAC;AAQD;;;;;;GAMG;AACH,SAAS,sBAAsB,CAAC,MAAc;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEjC,iCAAiC;IACjC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,+DAA+D;IAC/D,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,CAAC,EAAE,CAAC;IACN,CAAC;IAED,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;IACvB,sFAAsF;IACtF,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YAC/B,MAAM,GAAG,CAAC,CAAC;YACX,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAClB,MAAM,IAAI,sBAAsB,CAC9B,8CAA8C,EAC9C,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/C,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;KACzC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,MAAc;IAC7C,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAC/B,CAAC;IACD,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,SAAgB,qBAAqB,CAAC,KAAa;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEhC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACtB,gCAAgC;QAChC,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACpD,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,sBAAsB,CAC9B,4CAA4C,EAC5C,MAAM,CACP,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,sBAAsB,CAC9B,qDAAqD,EACrD,MAAM,CACP,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,sBAAsB,CAC9B,gDAAgD,GAAG,EAAE,EACrD,MAAM,CACP,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;QAExC,iEAAiE;QACjE,2DAA2D;QAC3D,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,sBAAsB,CAC9B,yDAAyD,EACzD,MAAM,CACP,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,sBAAsB,CAC9B,gBAAgB,GAAG,0CAA0C,EAC7D,MAAM,CACP,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YAChB,8EAA8E;YAC9E,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBACrB,IAAI,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBACrB,CAAC,EAAE,CAAC;oBACJ,SAAS;gBACX,CAAC;gBACD,6CAA6C;gBAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC7C,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;wBACtB,MAAM,IAAI,sBAAsB,CAC9B,8CAA8C,EAC9C,CAAC,GAAG,CAAC,CACN,CAAC;oBACJ,CAAC;oBACD,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC/C,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBACzC,CAAC,EAAE,CAAC;gBACN,CAAC;qBAAM,CAAC;oBACN,MAAM;gBACR,CAAC;YACH,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;gBAC3B,CAAC,GAAG,CAAC,CAAC;YACR,CAAC;iBAAM,CAAC;gBACN,sCAAsC;gBACtC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACpB,CAAC,EAAE,CAAC;YACN,CAAC;QACH,CAAC;aAAM,CAAC;YACN,gBAAgB;YAChB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YAC3C,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,CAAC;AACpB,CAAC;AAED,mFAAmF;AACnF,SAAS,WAAW,CAAC,KAAa,EAAE,IAAY;IAC9C,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACvD,MAAM,IAAI,sBAAsB,CAC9B,8BAA8B,KAAK,EAAE,EACrC,IAAI,CACL,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qDAAqD;AACrD,SAAgB,UAAU,CAAC,MAAyB,EAAE,GAAW;IAC/D,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,qFAAqF;AACrF,SAAgB,QAAQ,CAAC,MAAyB,EAAE,GAAW;IAC7D,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,IAAI,sBAAsB,CAC9B,QAAQ,GAAG,mCAAmC,CAAC,GAAG,EAClD,CAAC,CACF,CAAC;IACJ,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,+CAA+C;AAC/C,SAAgB,WAAW,CACzB,MAAyB,EACzB,GAAW;IAEX,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAClC,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAClD,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACtB,CAAC"}

package/dist/core/markdown/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * markdown 子系统公共门面(子系统五件套约定中的对外入口)。
+ *
+ * 硬约定:外部调用方(web 层、未来的其它消费方)必须经此门面导入,
+ * 不得直接伸手进内部模块(query / store / indexer 等)。
+ *
+ * 导出面刻意收窄:
+ *   - 只导出查询/引导/解析/常量/错误/公共类型;
+ *   - MarkdownStore(写入面,仅 indexer 内部使用)与 MarkdownDocumentRow
+ *     (DB 原始行类型)不外泄 —— 行 → 领域类型的映射在子系统内部完成
+ *     (data-standards「ORM 映射约定」:原始行类型不外泄)。
+ */
+export { MarkdownQuery } from './query';
+export { openMarkdownDb, MARKDOWN_SCHEMA_VERSION, getCurrentMarkdownSchemaVersion } from './schema-bootstrap';
+export { parseFrontmatter } from './frontmatter-parser';
+export { stripFrontmatter } from './frontmatter-parser';
+export { DOCUMENT_TYPES, DOCUMENT_STATUSES, SOURCE_TYPES, KNOWLEDGE_DIR } from './constants';
+export type { DocumentType, DocumentStatus, SourceType } from './constants';
+export { MarkdownIndexError, SchemaMismatchError, DocumentNotFoundError, ProjectNotInitializedError } from './errors';
+export type { ConceptSummary, DomainSummary, TagSummary, FindFilter, FindPagedResult, KnowledgeStats, DocumentDescriptor, DocumentDetail, ReferenceView, ReferenceTarget } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/markdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAC9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7F,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AACtH,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EACtF,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC"}

package/dist/core/markdown/index.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * markdown 子系统公共门面(子系统五件套约定中的对外入口)。
+ *
+ * 硬约定:外部调用方(web 层、未来的其它消费方)必须经此门面导入,
+ * 不得直接伸手进内部模块(query / store / indexer 等)。
+ *
+ * 导出面刻意收窄:
+ *   - 只导出查询/引导/解析/常量/错误/公共类型;
+ *   - MarkdownStore(写入面,仅 indexer 内部使用)与 MarkdownDocumentRow
+ *     (DB 原始行类型)不外泄 —— 行 → 领域类型的映射在子系统内部完成
+ *     (data-standards「ORM 映射约定」:原始行类型不外泄)。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectNotInitializedError = exports.DocumentNotFoundError = exports.SchemaMismatchError = exports.MarkdownIndexError = exports.KNOWLEDGE_DIR = exports.SOURCE_TYPES = exports.DOCUMENT_STATUSES = exports.DOCUMENT_TYPES = exports.stripFrontmatter = exports.parseFrontmatter = exports.getCurrentMarkdownSchemaVersion = exports.MARKDOWN_SCHEMA_VERSION = exports.openMarkdownDb = exports.MarkdownQuery = void 0;
+var query_1 = require("./query");
+Object.defineProperty(exports, "MarkdownQuery", { enumerable: true, get: function () { return query_1.MarkdownQuery; } });
+var schema_bootstrap_1 = require("./schema-bootstrap");
+Object.defineProperty(exports, "openMarkdownDb", { enumerable: true, get: function () { return schema_bootstrap_1.openMarkdownDb; } });
+Object.defineProperty(exports, "MARKDOWN_SCHEMA_VERSION", { enumerable: true, get: function () { return schema_bootstrap_1.MARKDOWN_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "getCurrentMarkdownSchemaVersion", { enumerable: true, get: function () { return schema_bootstrap_1.getCurrentMarkdownSchemaVersion; } });
+var frontmatter_parser_1 = require("./frontmatter-parser");
+Object.defineProperty(exports, "parseFrontmatter", { enumerable: true, get: function () { return frontmatter_parser_1.parseFrontmatter; } });
+var frontmatter_parser_2 = require("./frontmatter-parser");
+Object.defineProperty(exports, "stripFrontmatter", { enumerable: true, get: function () { return frontmatter_parser_2.stripFrontmatter; } });
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "DOCUMENT_TYPES", { enumerable: true, get: function () { return constants_1.DOCUMENT_TYPES; } });
+Object.defineProperty(exports, "DOCUMENT_STATUSES", { enumerable: true, get: function () { return constants_1.DOCUMENT_STATUSES; } });
+Object.defineProperty(exports, "SOURCE_TYPES", { enumerable: true, get: function () { return constants_1.SOURCE_TYPES; } });
+Object.defineProperty(exports, "KNOWLEDGE_DIR", { enumerable: true, get: function () { return constants_1.KNOWLEDGE_DIR; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "MarkdownIndexError", { enumerable: true, get: function () { return errors_1.MarkdownIndexError; } });
+Object.defineProperty(exports, "SchemaMismatchError", { enumerable: true, get: function () { return errors_1.SchemaMismatchError; } });
+Object.defineProperty(exports, "DocumentNotFoundError", { enumerable: true, get: function () { return errors_1.DocumentNotFoundError; } });
+Object.defineProperty(exports, "ProjectNotInitializedError", { enumerable: true, get: function () { return errors_1.ProjectNotInitializedError; } });
+//# sourceMappingURL=index.js.map

package/dist/core/markdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/markdown/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,iCAAwC;AAA/B,sGAAA,aAAa,OAAA;AACtB,uDAA8G;AAArG,kHAAA,cAAc,OAAA;AAAE,2HAAA,uBAAuB,OAAA;AAAE,mIAAA,+BAA+B,OAAA;AACjF,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA;AACzB,2DAAwD;AAA/C,sHAAA,gBAAgB,OAAA;AACzB,yCAA6F;AAApF,2GAAA,cAAc,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAAE,yGAAA,YAAY,OAAA;AAAE,0GAAA,aAAa,OAAA;AAEvE,mCAAsH;AAA7G,4GAAA,kBAAkB,OAAA;AAAE,6GAAA,mBAAmB,OAAA;AAAE,+GAAA,qBAAqB,OAAA;AAAE,oHAAA,0BAA0B,OAAA"}

package/dist/core/markdown/indexer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * MarkdownIndexer — cover-the-table full rebuild.
+ *
+ * Flow (spec §6.1):
+ *   1. Open shared cgraphx DB; ensure markdown schema.
+ *   2. Scan <projectRoot>/docs/knowledge/ recursively (skip symlinks + dot-dirs).
+ *   3. Extract each .md/.mdx via `extractFromFile`.
+ *   4. In ONE transaction: wipeAll → insert documents/vocabularies/edges →
+ *      resolve document_references → rebuild FTS5.
+ *   5. Return IndexReport.
+ *
+ * Failure handling: any throw inside the transaction triggers ROLLBACK;
+ * the prior index is preserved untouched. The function itself only throws
+ * for unrecoverable problems (DB not initialized, scan dir absolutely
+ * unreadable).
+ *
+ * Not integrated: .gitignore filtering (YAGNI — docs/knowledge/ is a curated
+ * knowledge dir, not a vendor payload). Can be added later if needed.
+ */
+import type { IndexReport } from './types';
+export interface IndexOptions {
+    onProgress?: (msg: string) => void;
+}
+/**
+ * Index the markdown knowledge base under <projectRoot>/docs/knowledge/.
+ *
+ * Re-uses the shared `.cgraphx/cgraphx.db` (must already exist via
+ * `cgraphx init`). The markdown schema is auto-applied on first call.
+ *
+ * Errors thrown: only for unrecoverable problems. User-data problems
+ * (bad frontmatter, missing fields) are returned via `report.skipBreakdown`.
+ */
+export declare function indexMarkdownKnowledgeBase(projectRoot: string, options?: IndexOptions): Promise<IndexReport>;
+//# sourceMappingURL=indexer.d.ts.map

package/dist/core/markdown/indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../../src/core/markdown/indexer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAUH,OAAO,KAAK,EACV,WAAW,EAIZ,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAaD;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CAuKtB"}