@gyoungwe/research-suite 0.1.3 → 0.1.6

package/node_modules/@gyoungwe/pi-knowledge/dist/core/ingest-frontmatter.d.ts

@@ -0,0 +1,125 @@
+/**
+ * 知识入库标准的 frontmatter 规范（schema `drone-note/1`）：解析受限 YAML、校验与规范化、确定性序列化。
+ * 只覆盖 Obsidian frontmatter 常见写法（映射、列表、行内列表、引号字符串、注释），不执行任何 YAML 标签或锚点。
+ * 纯函数，不读写文件。
+ */
+import { type KnowledgeIdentity } from "./ingest-identity.js";
+export declare const NOTE_SCHEMA = "drone-note/1";
+/** 知识类（K）笔记类型。 */
+export declare const KNOWLEDGE_TYPES: readonly ["paper", "method", "software", "dataset", "concept", "entity", "idea", "claim", "evidence", "decision", "question", "wiki"];
+/** 运行结果类（R）笔记类型：运行中心笔记、产物指针、展示层讲解。 */
+export declare const RUN_RESULT_TYPES: readonly ["run", "artifact", "explainer"];
+export declare const NOTE_TYPES: readonly ["paper", "method", "software", "dataset", "concept", "entity", "idea", "claim", "evidence", "decision", "question", "wiki", "run", "artifact", "explainer"];
+export type KnowledgeType = (typeof KNOWLEDGE_TYPES)[number];
+export type RunResultType = (typeof RUN_RESULT_TYPES)[number];
+export type NoteType = (typeof NOTE_TYPES)[number];
+/** 分类：知识 / 运行结果 / 临时内容。临时内容不写入 Vault，因此不是合法的 frontmatter `class`。 */
+export type IngestClass = "knowledge" | "run-result" | "ephemeral";
+export type NoteClass = Exclude<IngestClass, "ephemeral">;
+export declare const NOTE_STATUSES: readonly ["candidate", "verified", "stale", "superseded", "archived"];
+export type NoteStatus = (typeof NOTE_STATUSES)[number];
+export declare const NOTE_CONFIDENCE: readonly ["high", "medium", "low"];
+export type NoteConfidence = (typeof NOTE_CONFIDENCE)[number];
+export interface NoteSource {
+    doi?: string;
+    pmid?: string;
+    pmcid?: string;
+    arxiv?: string;
+    isbn?: string;
+    zotero_key?: string;
+    url?: string;
+    /** Vault 相对路径（`Library/Papers/x.md`）。 */
+    vault?: string;
+    /** 运行目录内的相对路径（`results/...`）。 */
+    file?: string;
+    sha256?: string;
+    /** 页码、章节、行号等定位。 */
+    locator?: string;
+}
+export interface CreatedFrom {
+    session?: string;
+    run?: string;
+    task?: string;
+    tool?: string;
+    turn?: number;
+}
+export interface NoteFrontmatter {
+    schema: typeof NOTE_SCHEMA;
+    id?: string;
+    type: NoteType;
+    class: NoteClass;
+    /** `shared` 或规范项目 slug。 */
+    project: string;
+    status: NoteStatus;
+    confidence?: NoteConfidence;
+    tags: string[];
+    aliases: string[];
+    identity: KnowledgeIdentity;
+    sources: NoteSource[];
+    created_from?: CreatedFrom;
+    derived_from: string[];
+    content_sha256?: string;
+    created?: string;
+    updated?: string;
+}
+export declare const FRONTMATTER_KEY_ORDER: readonly ["schema", "id", "type", "class", "project", "status", "confidence", "tags", "aliases", "identity", "sources", "created_from", "derived_from", "content_sha256", "created", "updated"];
+export declare const PROJECT_SLUG: RegExp;
+export declare function isKnowledgeType(value: unknown): value is KnowledgeType;
+export declare function isNoteType(value: unknown): value is NoteType;
+/** 类型对应的默认分类。 */
+export declare function classForType(type: NoteType): NoteClass;
+export interface FrontmatterSplit {
+    /** 没有 frontmatter 时为 null。 */
+    raw: string | null;
+    body: string;
+}
+/** 拆出开头的 frontmatter 块。第一行必须是 `---`，以 `---` 或 `...` 结束。 */
+export declare function splitFrontmatter(text: string): FrontmatterSplit;
+export interface ParsedFrontmatter {
+    data: Record<string, unknown> | null;
+    body: string;
+    errors: string[];
+}
+/** 解析一篇笔记的 frontmatter。语法错误不抛异常，而是放进 `errors`，`data` 为 null。 */
+export declare function parseFrontmatter(text: string): ParsedFrontmatter;
+export interface FrontmatterValidation {
+    /** 有错误时为 null。 */
+    value: NoteFrontmatter | null;
+    errors: string[];
+    warnings: string[];
+}
+/** Obsidian 标签：去掉 `#`，空白换成 `-`，只允许字母数字、`_`、`-`、`/`，不能是纯数字；统一小写。 */
+export declare function normalizeTag(input: unknown): string | null;
+/**
+ * 校验并规范化 frontmatter（通常是 {@link parseFrontmatter} 的 `data`）。
+ * - 缺少 `class` 时按 `type` 推导；`class` 与 `type` 矛盾报错。
+ * - 旧状态值（draft/generated…）映射到新状态并给出 warning。
+ * - `identity` 与 `sources` 中的标识全部规范化；`identity` 缺失时从 `sources` 推导。
+ */
+export declare function validateFrontmatter(input: unknown, options?: {
+    body?: string;
+}): FrontmatterValidation;
+export interface BuildFrontmatterInput {
+    type: NoteType;
+    project: string;
+    id?: string;
+    status?: NoteStatus;
+    confidence?: NoteConfidence;
+    tags?: readonly string[];
+    aliases?: readonly string[];
+    identity?: KnowledgeIdentity;
+    sources?: readonly unknown[];
+    createdFrom?: CreatedFrom;
+    derivedFrom?: readonly string[];
+    /** 提供正文时自动计算 `content_sha256`。 */
+    body?: string;
+    created?: string;
+    updated?: string;
+}
+/** 由宿主写入方使用：构建一个已规范化的 frontmatter；不合法时抛出包含所有错误的异常。 */
+export declare function buildFrontmatter(input: BuildFrontmatterInput): NoteFrontmatter;
+/** 确定性序列化（固定键顺序、字符串一律 JSON 双引号），返回带 `---` 分隔线的块，末尾有换行。 */
+export declare function serializeFrontmatter(frontmatter: NoteFrontmatter): string;
+/** frontmatter + 正文，组成一篇笔记的完整文本。 */
+export declare function renderNote(frontmatter: NoteFrontmatter, body: string): string;
+//# sourceMappingURL=ingest-frontmatter.d.ts.map

package/node_modules/@gyoungwe/pi-knowledge/dist/core/ingest-frontmatter.d.ts.map

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

package/node_modules/@gyoungwe/pi-knowledge/dist/core/ingest-identity.d.ts

@@ -0,0 +1,93 @@
+/** 去重用的外部标识。字段名与 frontmatter `identity` 一致（snake_case）。 */
+export interface KnowledgeIdentity {
+    doi?: string;
+    pmid?: string;
+    pmcid?: string;
+    arxiv?: string;
+    isbn?: string;
+    zotero_key?: string;
+    url?: string;
+}
+export declare const IDENTITY_FIELDS: readonly ["doi", "pmid", "pmcid", "arxiv", "isbn", "zotero_key", "url"];
+export type IdentityField = (typeof IDENTITY_FIELDS)[number];
+/**
+ * DOI → 小写裸 DOI（`10.xxxx/...`）。接受 `doi:` 前缀、doi.org / dx.doi.org 链接与 URL 编码；
+ * 去掉句末标点。无法识别时返回 null。
+ */
+export declare function normalizeDoi(input: unknown): string | null;
+/** PMID → 纯数字字符串。接受 `PMID: 123`、`pmid:123`、PubMed 链接。 */
+export declare function normalizePmid(input: unknown): string | null;
+/** PMCID → `PMC` + 数字（大写）。 */
+export declare function normalizePmcid(input: unknown): string | null;
+/**
+ * arXiv → 不带版本号的标识：新式 `2401.01234`，旧式 `hep-th/9901001`。
+ * 接受 `arXiv:` 前缀与 arxiv.org/abs|pdf 链接。
+ */
+export declare function normalizeArxiv(input: unknown): string | null;
+/** ISBN → 校验通过的 ISBN-13（ISBN-10 自动转换）。 */
+export declare function normalizeIsbn(input: unknown): string | null;
+/** Zotero item key：8 位字母数字（与 `research_deposit_knowledge` 的校验一致）。 */
+export declare function normalizeZoteroKey(input: unknown): string | null;
+/**
+ * URL → 去重用的规范形式：只接受 http(s)，统一为 https，主机小写并去掉 `www.`，去掉默认端口、
+ * 片段、跟踪参数，查询参数排序，路径去掉末尾 `/`。DOI 链接请先用 {@link normalizeDoi}。
+ */
+export declare function normalizeUrl(input: unknown): string | null;
+/** 把任意一个来源字符串识别成最具体的标识（DOI > PMID > PMCID > arXiv > ISBN > URL）。 */
+export declare function identifyReference(input: unknown): {
+    field: IdentityField;
+    value: string;
+} | null;
+export interface ExtractedIdentifiers {
+    doi: string[];
+    pmid: string[];
+    pmcid: string[];
+    arxiv: string[];
+    url: string[];
+}
+/** 从一段正文中抽取所有可识别的标识（每类最多 64 个，按出现顺序去重）。 */
+export declare function extractIdentifiers(text: unknown): ExtractedIdentifiers;
+/** 规范化一个 identity 对象：未知字段丢弃，无效值丢弃。 */
+export declare function normalizeIdentity(input: unknown): KnowledgeIdentity;
+/** 从来源字符串列表推导 identity：每类取第一个。 */
+export declare function identityFromReferences(references: readonly unknown[]): KnowledgeIdentity;
+/** 标题去重键：NFKC、小写、只保留字母数字（含中文），空白折叠。 */
+export declare function normalizeTitleKey(title: unknown): string;
+/**
+ * 去重键，按可信度从高到低排列：`doi:` > `pmid:` > `pmcid:` > `arxiv:` > `isbn:` > `zotero:` > `url:` >
+ * `title:<type>:`。第一个是主键；任一键相同即视为同一对象。
+ */
+export declare function identityKeys(identity: KnowledgeIdentity, options?: {
+    type?: string | null;
+    title?: string | null;
+}): string[];
+/** 两个对象是否同一（任一去重键相同）。 */
+export declare function sameIdentity(a: {
+    identity?: KnowledgeIdentity;
+    type?: string | null;
+    title?: string | null;
+}, b: {
+    identity?: KnowledgeIdentity;
+    type?: string | null;
+    title?: string | null;
+}): boolean;
+/** 去掉开头 frontmatter 块（`---` … `---`/`...`），返回正文。 */
+export declare function stripFrontmatter(text: string): string;
+/**
+ * 正文内容哈希（`content_sha256`）：去掉 frontmatter、换行统一为 LF、去掉行尾空白与首尾空行后取 sha256。
+ * 只改 frontmatter 或换行风格不会改变哈希。
+ */
+export declare function contentHash(text: string): string;
+export interface ClaimHashInput {
+    subject?: unknown;
+    predicate?: unknown;
+    value?: unknown;
+    organism?: unknown;
+    tissue?: unknown;
+    stage?: unknown;
+    method?: unknown;
+    sourceHash?: unknown;
+}
+/** 结论去重键：主语、谓词、取值、条件（物种/组织/阶段/方法）与来源哈希规范化后取 sha256。 */
+export declare function claimHash(claim: ClaimHashInput): string;
+//# sourceMappingURL=ingest-identity.d.ts.map

package/node_modules/@gyoungwe/pi-knowledge/dist/core/ingest-identity.d.ts.map

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

package/node_modules/@gyoungwe/pi-knowledge/dist/core/ingest-policy.d.ts

@@ -0,0 +1,63 @@
+import { type IngestClass, type KnowledgeType, type NoteType } from "./ingest-frontmatter.js";
+/** 运行结果的用途（与 inquiry `ArtifactPurpose` 对齐，另加日志、来源、摘要、卡片和展示层）。 */
+export type IngestPurpose = "deliverable" | "intermediate" | "log" | "source" | "summary" | "cards" | "presentation" | "navigation";
+export type IngestRule = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+export declare const INGEST_RULES: Readonly<Record<IngestRule, string>>;
+export interface IngestOrigin {
+    /** 产生内容的工具，如 `research_deposit_knowledge`、`research_summarize_run`。 */
+    tool?: string;
+    /** 工具参数里的类型（deposit 的 `type`）。 */
+    type?: string;
+    /** inquiry 账本记录（规则 8）。 */
+    inquiry?: {
+        kind: "finding" | "decision";
+        /** finding.reviewStatus 或 decision.status。 */
+        status: string;
+    };
+}
+export interface IngestInput {
+    /** 相对路径（工作区或 Vault），`/` 或 `\` 分隔均可。inquiry 记录可以为空。 */
+    path?: string;
+    /** 路径所在位置；`vault` 时启用规范目录判定（规则 2）。缺省按路径推断。 */
+    location?: "vault" | "workspace";
+    origin?: IngestOrigin;
+    /** Markdown 正文（可含 frontmatter）。用于规则 2 与规则 7。 */
+    text?: string;
+    /** 已解析的 frontmatter（优先于从 `text` 解析）。 */
+    frontmatter?: Record<string, unknown> | null;
+    /** 文件是否命中某个任务里程碑的验收（决定数据/图表是 deliverable 还是 intermediate）。 */
+    acceptance?: boolean;
+    /** 调用方已确认文件位于某个运行目录内。缺省按路径中的 `results/`、`runs/`、`run-*` 推断。 */
+    inRunDir?: boolean;
+}
+export interface IngestDecision {
+    class: IngestClass;
+    /** 推断出的笔记类型；运行产物文件和临时内容为 null。 */
+    type: NoteType | null;
+    purpose: IngestPurpose | null;
+    rule: IngestRule;
+    ruleId: string;
+    /** 是知识候选（需要经过质量门 / 审核队列），而不是已确认的知识。 */
+    candidate: boolean;
+    /** 运行结果容器里含有可抽取的知识原子（如逐篇证据卡）。 */
+    extractAtoms: boolean;
+    reasons: string[];
+}
+export declare const CANDIDATE_MIN_CHARS = 300;
+/**
+ * 按九条有序规则分类。
+ *
+ * 1. 临时路径（tmp/、.cache/、scratch/、*.tmp …）→ ephemeral
+ * 2. 显式声明：frontmatter `class`/`type`，或 Vault 规范目录 → 按声明
+ * 3. 工具来源（deposit / Wiki 提议 → knowledge；summarize / archive_source / research_loop / 讲解 → run-result）
+ * 4. 运行记录文件名（search-log、*receipts*、metadata.json、manifest、failures、SUMMARY.md …）→ run-result
+ * 5. 卡片容器（evidence-cards.md、*-cards.md、claims.md）→ run-result，并标记可抽取知识原子
+ * 6. 数据 / 图表后缀 → run-result（命中验收为 deliverable，否则 intermediate）
+ * 7. 带来源、≥300 字、含方法或结论标题的 Markdown → knowledge 候选
+ * 8. inquiry 中已复核的 finding / 已确认的 decision → knowledge（claim / decision）
+ * 9. 兜底：在运行目录内 → run-result（intermediate），否则 ephemeral
+ */
+export declare function classifyIngest(input: IngestInput): IngestDecision;
+/** 便于文档与 UI 展示：所有知识类型。 */
+export declare const INGEST_KNOWLEDGE_TYPES: readonly KnowledgeType[];
+//# sourceMappingURL=ingest-policy.d.ts.map

package/node_modules/@gyoungwe/pi-knowledge/dist/core/ingest-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-policy.d.ts","sourceRoot":"","sources":["../../src/core/ingest-policy.ts"],"names":[],"mappings":"AAMA,OAAO,EAEN,KAAK,WAAW,EAIhB,KAAK,aAAa,EAClB,KAAK,QAAQ,EAEb,MAAM,yBAAyB,CAAC;AAEjC,iEAAiE;AACjE,MAAM,MAAM,aAAa,GACtB,aAAa,GACb,cAAc,GACd,KAAK,GACL,QAAQ,GACR,SAAS,GACT,OAAO,GACP,cAAc,GACd,YAAY,CAAC;AAEhB,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE3D,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAU7D,CAAC;AAEF,MAAM,WAAW,YAAY;IAC5B,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,OAAO,CAAC,EAAE;QACT,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;QAC7B,8CAA8C;QAC9C,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;CACF;AAED,MAAM,WAAW,WAAW;IAC3B,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IACjC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,WAAW,CAAC;IACnB,kCAAkC;IAClC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAwID,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAiFvC;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CA2FjE;AAED,0BAA0B;AAC1B,eAAO,MAAM,sBAAsB,EAAE,SAAS,aAAa,EAAoB,CAAC"}

package/node_modules/@gyoungwe/pi-knowledge/dist/core/layout.d.ts

@@ -0,0 +1,47 @@
+type ContainedFile = (root: string, path: string) => Promise<string>;
+type CreateOnly = (path: string, content: string) => Promise<boolean>;
+type UpdateNavigation = (root: string, path: string, heading: string, body: string) => Promise<NavigationUpdateResult>;
+export interface NavigationUpdateResult {
+    path: string;
+    changed: boolean;
+}
+/** Raised when a conditional Vault write observes a newer local version. */
+export declare class VaultFileConflictError extends Error {
+    readonly code: "conflict";
+    constructor(path: string);
+}
+export interface ReplaceVaultFileOptions {
+    /** SHA-256 of the version the caller showed to the user. */
+    expectedHash?: string;
+    /** Test seam used to deterministically model an editor write before commit. */
+    beforeCommit?: () => void | Promise<void>;
+}
+/**
+ * Filesystem seams for embedding layout initialization in a host runtime.
+ * The defaults enforce Vault containment and create-only semantics. Hosts can
+ * inject the same contracts when they already own a filesystem abstraction.
+ */
+export interface KnowledgeLayoutDependencies {
+    containedFile?: ContainedFile;
+    createOnly?: CreateOnly;
+    updateNavigation?: UpdateNavigation;
+}
+/** Resolve a Vault-relative destination without following it outside Vault. */
+export declare function containedVaultFile(root: string, path: string): Promise<string>;
+/** Atomically create a regular file, preserving an existing human-edited file. */
+export declare function createVaultFileOnly(path: string, content: string): Promise<boolean>;
+/**
+ * Atomically replace an existing regular Vault file with an optional content CAS.
+ *
+ * The second hash check runs immediately before rename. It closes the stale-preview
+ * window for callers that show a version before asking for confirmation; if another
+ * writer changes the file during that window, the write is rejected and the caller
+ * can report a conflict without replacing the newer edit.
+ */
+export declare function replaceVaultFile(path: string, content: string, options?: ReplaceVaultFileOptions): Promise<void>;
+/** Update only the managed navigation block, preserving human-authored text. */
+export declare function updateVaultNavigation(vault: string, path: string, heading: string, body: string, containedFile?: ContainedFile): Promise<NavigationUpdateResult>;
+export declare function initializeSharedNavigation(vault: string, dependencies?: KnowledgeLayoutDependencies): Promise<void>;
+export declare function initializeProjectContext(vault: string, project: string, dependencies?: KnowledgeLayoutDependencies): Promise<void>;
+export {};
+//# sourceMappingURL=layout.d.ts.map

package/node_modules/@gyoungwe/pi-knowledge/dist/core/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/core/layout.ts"],"names":[],"mappings":"AAqBA,KAAK,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AACrE,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AACtE,KAAK,gBAAgB,GAAG,CACvB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,KACR,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAErC,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,4EAA4E;AAC5E,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;gBAExB,IAAI,EAAE,MAAM;CAIxB;AAED,MAAM,WAAW,uBAAuB;IACvC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC3C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACpC;AAmBD,+EAA+E;AAC/E,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpF;AAED,kFAAkF;AAClF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBzF;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,uBAA4B,GACnC,OAAO,CAAC,IAAI,CAAC,CAmBf;AAQD,gFAAgF;AAChF,wBAAsB,qBAAqB,CAC1C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,aAAkC,GAC/C,OAAO,CAAC,sBAAsB,CAAC,CA0CjC;AAeD,wBAAsB,0BAA0B,CAC/C,KAAK,EAAE,MAAM,EACb,YAAY,GAAE,2BAAgC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED,wBAAsB,wBAAwB,CAC7C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,YAAY,GAAE,2BAAgC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/node_modules/@gyoungwe/pi-knowledge/dist/core/maintenance.d.ts

@@ -0,0 +1,16 @@
+export declare function updateNavigation(vault: any, path: any, heading: any, body: any): Promise<{
+    path: any;
+    changed: boolean;
+}>;
+export declare function runNavigationMaintenance(service: any, project: any, limit?: number): Promise<{
+    navigation: ({
+        path: any;
+        changed: boolean;
+    } | {
+        path: any;
+        error: any;
+    })[];
+    semanticWikiRewritten: boolean;
+    remaining: any;
+}>;
+//# sourceMappingURL=maintenance.d.ts.map

package/node_modules/@gyoungwe/pi-knowledge/dist/core/maintenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance.d.ts","sourceRoot":"","sources":["../../src/core/maintenance.ts"],"names":[],"mappings":"AAUA,wBAAsB,gBAAgB,CAAC,KAAK,KAAA,EAAE,IAAI,KAAA,EAAE,OAAO,KAAA,EAAE,IAAI,KAAA;;;GAwChE;AACD,wBAAsB,wBAAwB,CAAC,OAAO,KAAA,EAAE,OAAO,KAAA,EAAE,KAAK,SAAI;;;;;;;;;;GAkCzE"}

package/node_modules/@gyoungwe/pi-knowledge/dist/core/memory-note.d.ts

@@ -0,0 +1,14 @@
+/** 观察记忆 → 知识库笔记（单向沉淀）。纯函数，便于测试。 */
+export interface MemoryNoteInput {
+    id: number;
+    kind: string;
+    title: string;
+    body: string;
+    sessionId?: string;
+    createdAt: number;
+    files?: string[];
+}
+export declare function memoryNoteSlug(memory: Pick<MemoryNoteInput, "id" | "title">): string;
+/** 笔记正文：frontmatter（type: memory + 来源）、摘要、涉及文件、相关笔记的 [[链接]]（知识网络据此连边）。 */
+export declare function memoryNoteMarkdown(memory: MemoryNoteInput, related?: string[]): string;
+//# sourceMappingURL=memory-note.d.ts.map

package/node_modules/@gyoungwe/pi-knowledge/dist/core/memory-note.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-note.d.ts","sourceRoot":"","sources":["../../src/core/memory-note.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,MAAM,CAQpF;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,GAAE,MAAM,EAAO,GAAG,MAAM,CA6B1F"}

package/node_modules/@gyoungwe/pi-knowledge/dist/core/metacognitive-policy.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Deterministic publication checks for host-observed research claims.
+ *
+ * The host supplies this snapshot; the policy never executes a workflow or
+ * infers scientific truth. It only compares the final draft with bounded,
+ * current receipts and returns actionable, redacted diffs. A finding that
+ * passes these structural checks is citable evidence of what was observed,
+ * never a claim that the underlying science is true.
+ */
+export type MetacognitiveLabel = "exploratory" | "validation" | "validated" | "overturned" | "unstable";
+export type MetacognitiveUseRole = "evidence" | "exploratory" | "validation" | "conclusion";
+export interface MetacognitiveArtifactNumber {
+    value: number | string;
+    tolerance?: number;
+}
+export interface MetacognitiveArtifact {
+    path: string;
+    /** Inquiry lineage status; pending review is never publishable. */
+    status?: "valid" | "superseded" | "cleanup-candidate" | "archived" | "pending-review";
+    /** Hash recorded when the artifact was cited. */
+    sha256?: string;
+    /** Hash observed immediately before publication. */
+    currentSha256?: string;
+    /** Human confirmation metadata retained with a previously revoked artifact. */
+    reviews?: readonly {
+        decisionId: string;
+        confirmedBy: "user";
+        confirmedAt: string;
+    }[];
+    /** Reproducibility is advisory; a missing receipt never bypasses fail-closed checks. */
+    reproducibility?: "reproducible" | "partial" | "not-reproducible";
+    /** Optional bounded text/number index supplied by the host. */
+    text?: string;
+    numbers?: readonly MetacognitiveArtifactNumber[];
+    /** Optional current-turn read receipt reference for source citations. */
+    receiptId?: string;
+}
+export interface MetacognitiveNumberClaim {
+    id?: string;
+    value: number | string;
+    /** Exact representation expected in the final answer (supports rounding). */
+    rendered?: string;
+    artifactPath: string;
+    rounding?: {
+        digits?: number;
+        tolerance?: number;
+    };
+}
+export interface MetacognitiveExecutedWorkflow {
+    workflows?: readonly string[];
+    modules?: readonly string[];
+    params?: Readonly<Record<string, unknown>>;
+}
+export interface MetacognitiveMethodClaim {
+    id?: string;
+    /** A bounded method sentence from the final answer. */
+    description: string;
+    workflow?: string;
+    modules?: readonly string[];
+    params?: Readonly<Record<string, unknown>>;
+}
+export interface MetacognitiveFinding {
+    id: string;
+    text: string;
+    label: MetacognitiveLabel;
+    citationPaths?: readonly string[];
+}
+export interface MetacognitiveFindingUse {
+    findingId: string;
+    role: MetacognitiveUseRole;
+}
+export interface MetacognitiveDiagnostic {
+    id: string;
+    reported: unknown;
+    observed: unknown;
+}
+export interface MetacognitiveSnapshot {
+    /** A host may turn this off for operational/setup turns. */
+    enabled?: boolean;
+    artifacts?: readonly MetacognitiveArtifact[];
+    numbers?: readonly MetacognitiveNumberClaim[];
+    executed?: MetacognitiveExecutedWorkflow;
+    methods?: readonly MetacognitiveMethodClaim[];
+    findings?: readonly MetacognitiveFinding[];
+    uses?: readonly MetacognitiveFindingUse[];
+    diagnostics?: readonly MetacognitiveDiagnostic[];
+}
+export type MetacognitiveFailureCode = "report-number-unbound" | "artifact-checksum-stale" | "method-mismatch" | "finding-label-conflict" | "diagnostic-drift" | "artifact-pending-review" | "metacognition-invalid";
+export interface MetacognitiveFailure {
+    code: MetacognitiveFailureCode;
+    subject: string;
+    detail: string;
+    path?: string;
+}
+export interface MetacognitiveEvidenceFinding {
+    id: string;
+    text: string;
+    label: MetacognitiveLabel;
+    citationPaths: string[];
+}
+export interface MetacognitiveEvaluation {
+    ok: boolean;
+    failures: MetacognitiveFailure[];
+    warnings: MetacognitiveWarning[];
+    /** Finding records are copied into the publication proof for citation. */
+    findings: MetacognitiveEvidenceFinding[];
+}
+export interface MetacognitiveWarning {
+    code: "artifact-not-reproducible";
+    subject: string;
+    detail: string;
+    path?: string;
+}
+/** Compare a final answer with host-observed reports, workflows and findings. */
+export declare function evaluateMetacognitivePublication(answer: string, snapshot: unknown): MetacognitiveEvaluation;
+//# sourceMappingURL=metacognitive-policy.d.ts.map

package/node_modules/@gyoungwe/pi-knowledge/dist/core/metacognitive-policy.d.ts.map

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

package/node_modules/@gyoungwe/pi-knowledge/dist/core/note-title.d.ts

@@ -0,0 +1,8 @@
+/** A title that is really a file name ("PMC7022188.1.pdf", "lora-2106-09685") says nothing about the content. */
+export declare function looksLikeFileName(title: string): boolean;
+/**
+ * Node/display title for a Vault note: an explicit `topic` written at ingestion wins,
+ * then frontmatter `title`, then the first H1, then the file name.
+ */
+export declare function noteDisplayTitle(text: string, path: string): string;
+//# sourceMappingURL=note-title.d.ts.map

package/node_modules/@gyoungwe/pi-knowledge/dist/core/note-title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-title.d.ts","sourceRoot":"","sources":["../../src/core/note-title.ts"],"names":[],"mappings":"AAKA,iHAAiH;AACjH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAMxD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAanE"}

package/node_modules/@gyoungwe/pi-knowledge/dist/core/orchestration-policy.d.ts

@@ -0,0 +1,84 @@
+/** Deterministic, auditable scheduling decisions for knowledge specialists. */
+export declare const SPECIALIST_DECISIONS: readonly ["run", "skip", "wait", "ask-user"];
+export type SpecialistDecision = (typeof SPECIALIST_DECISIONS)[number];
+export interface SpecialistRequestSignatureOptions {
+    role?: string;
+    task?: string;
+    sourcePaths?: unknown[];
+    sourceHashes?: unknown[];
+    summary?: string;
+    targetPath?: string | null;
+}
+export declare function specialistRequestSignature({ role, task, sourcePaths, sourceHashes, summary, targetPath, }?: SpecialistRequestSignatureOptions): string;
+export interface SpecialistRunOptions extends SpecialistRequestSignatureOptions {
+    automatic?: boolean;
+    mode?: string;
+    trusted?: boolean;
+    policy?: string;
+    hasEvidence?: boolean;
+    taskNeedsSpecialist?: boolean;
+    observedNeed?: boolean;
+    duplicate?: boolean;
+    turnRuns?: number;
+    maxRunsPerTurn?: number;
+    sessionRuns?: number;
+    maxRunsPerSession?: number;
+    active?: number;
+    concurrency?: number;
+    queueLength?: number;
+    queueLimit?: number;
+}
+export interface SpecialistRunDecision {
+    role?: string;
+    signature: string;
+    decision: SpecialistDecision;
+    reasonCode: string;
+}
+export declare function decideSpecialistRun({ role, task, sourcePaths, targetPath, sourceHashes, summary, automatic, mode, trusted, policy, hasEvidence, taskNeedsSpecialist, observedNeed, duplicate, turnRuns, maxRunsPerTurn, sessionRuns, maxRunsPerSession, active, concurrency, queueLength, queueLimit, }?: SpecialistRunOptions): SpecialistRunDecision;
+export interface SpecialistBudgetOptions {
+    maxRunsPerTurn?: number;
+    maxRunsPerSession?: number;
+    maxToolOperations?: number;
+    maxTokensPerTurn?: number;
+    maxTokensPerSession?: number;
+    maxCostPerTurn?: number;
+    maxCostPerSession?: number;
+}
+export interface SpecialistUsage {
+    totalTokens?: number;
+    cost?: number;
+}
+export interface SpecialistBudgetSnapshot {
+    turn: number;
+    turnRuns: number;
+    sessionRuns: number;
+    toolOperations: number;
+    reservations: number;
+    maxRunsPerTurn: number;
+    maxRunsPerSession: number;
+    maxToolOperations: number;
+    turnTokens: number;
+    sessionTokens: number;
+    turnCost: number;
+    sessionCost: number;
+    maxTokensPerTurn: number;
+    maxTokensPerSession: number;
+    maxCostPerTurn: number;
+    maxCostPerSession: number;
+}
+export interface SpecialistBudget {
+    begin(): void;
+    reserve(signature: string, reservationTurn?: number, options?: {
+        dedupe?: boolean;
+    }): boolean;
+    commit(signature: string, reservationTurn?: number): boolean;
+    release(signature: string, reservationTurn?: number): boolean;
+    addToolOperation(): boolean;
+    configure(next?: SpecialistBudgetOptions): void;
+    updateUsage(usage?: SpecialistUsage, usageTurn?: number): boolean;
+    recordUsage(usage?: SpecialistUsage, usageTurn?: number): boolean;
+    checkUsage(): true;
+    readonly snapshot: SpecialistBudgetSnapshot;
+}
+export declare function createSpecialistBudget({ maxRunsPerTurn, maxRunsPerSession, maxToolOperations, maxTokensPerTurn, maxTokensPerSession, maxCostPerTurn, maxCostPerSession, }?: SpecialistBudgetOptions): SpecialistBudget;
+//# sourceMappingURL=orchestration-policy.d.ts.map

package/node_modules/@gyoungwe/pi-knowledge/dist/core/orchestration-policy.d.ts.map

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