@gyoungwe/research-suite 0.1.3 → 0.1.6

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

@@ -0,0 +1,70 @@
+/** 会话条目类型：日常空间按会话选择的项目（`pi.appendEntry(SESSION_PROJECT_ENTRY, { project })`）。 */
+export declare const SESSION_PROJECT_ENTRY = "drone-session-project-v1";
+/** 旧版本在未指定项目时使用的缺省项目；只用于迁移判断，不再作为回落值。 */
+export declare const LEGACY_DEFAULT_PROJECT = "research-workbench";
+export type ProjectSource = "session" | "workspace-config" | "workspace";
+export interface ProjectResolution {
+    /** 解析出的规范项目 slug。 */
+    project: string;
+    source: ProjectSource;
+    /** cwd 是否为日常空间。 */
+    daily: boolean;
+    /** 调用方（通常是模型的工具参数）请求的项目；未请求时为 null。 */
+    requested: string | null;
+    /** 请求的项目与解析结果不同，已被忽略。 */
+    ignoredRequest: boolean;
+}
+/** 是否为合法的项目 slug（小写 kebab-case，≤ 96 字符，不是保留名或 `shared`）。 */
+export declare function isProjectSlug(value: unknown): value is string;
+/** 把用户输入整理成项目 slug（NFKC、小写、非字母数字变 `-`）；无法得到合法 slug 时返回 null。 */
+export declare function normalizeProjectSlug(input: unknown): string | null;
+/** 由工作区目录派生的项目 ID；`configured` 为合法 slug 时直接使用。算法与既有 `projectIdentity` 一致。 */
+export declare function workspaceProjectId(cwd: string, configured?: unknown): string;
+/** 日常空间目录 `~/.drone/daily`（与 desktop `getDailyDir()` 一致）。 */
+export declare function dailyWorkspaceDir(home?: string): string;
+/** cwd 是否为日常空间。 */
+export declare function isDailyWorkspace(cwd: string, home?: string): boolean;
+/**
+ * 从会话条目中读出最近一次 `/project` 选择。`{ project: null }` 表示清除选择。
+ * 只接受合法 slug；条目不合法时忽略。
+ */
+export declare function sessionProjectFromEntries(entries: unknown): string | null;
+export interface SessionContextLike {
+    sessionManager?: {
+        getBranch?: () => unknown;
+        getEntries?: () => unknown;
+    } | null;
+}
+/** 安全读取当前会话分支上的条目（没有会话管理器时返回空数组）。 */
+export declare function sessionEntriesOf(ctx: SessionContextLike | null | undefined): unknown[];
+export interface ResolveProjectInput {
+    cwd: string;
+    /** `.pi/research-workspace.json` 的 `knowledgeProjectId`（未读取时为 undefined）。 */
+    configured?: unknown;
+    /** 当前会话分支的条目；只在日常空间生效。 */
+    sessionEntries?: unknown;
+    /** 调用方请求的项目（如工具参数）。 */
+    requested?: unknown;
+    /** 测试用：替代 `os.homedir()`。 */
+    home?: string;
+}
+/** 同步解析（调用方已读取工作区配置）。 */
+export declare function resolveProjectIdentity(input: ResolveProjectInput): ProjectResolution;
+/** 读取 `.pi/research-workspace.json` 的 `knowledgeProjectId`；文件缺失或损坏时返回 undefined。 */
+export declare function readConfiguredProject(cwd: string): Promise<unknown>;
+/** 读取工作区配置后解析项目身份。工具层传入 `sessionEntries: sessionEntriesOf(ctx)`。 */
+export declare function resolveWorkspaceProject(input: Omit<ResolveProjectInput, "configured">): Promise<ProjectResolution>;
+/**
+ * 运行级操作（总结、来源归档）使用的项目：运行开始时记录在 `metadata.project` 中的项目优先；
+ * 旧版本缺省写入的 `research-workbench`（以及缺失 / 非法值）视为"未指定"，改用当前解析结果。
+ */
+export declare function runProject(metadataProject: unknown, resolution: ProjectResolution): string;
+/** 请求的项目被忽略时给模型 / 用户的一句说明；否则返回 null。 */
+export declare function projectNotice(resolution: ProjectResolution): string | null;
+/** 便于结果展示的紧凑描述。 */
+export declare function describeProject(resolution: ProjectResolution): {
+    project: string;
+    source: ProjectSource;
+    notice?: string;
+};
+//# sourceMappingURL=project-identity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project-identity.d.ts","sourceRoot":"","sources":["../../src/core/project-identity.ts"],"names":[],"mappings":"AAiBA,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAChE,yCAAyC;AACzC,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAK3D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,kBAAkB,GAAG,WAAW,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IACjC,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,mBAAmB;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yBAAyB;IACzB,cAAc,EAAE,OAAO,CAAC;CACxB;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D;AAED,gEAAgE;AAChE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAUlE;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAE5E;AAED,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAkB,GAAG,MAAM,CAElE;AAQD,mBAAmB;AACnB,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAEpE;AAQD;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAWzE;AAED,MAAM,WAAW,kBAAkB;IAClC,cAAc,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;CAClF;AAED,qCAAqC;AACrC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,EAAE,CAQtF;AAED,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uBAAuB;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,yBAAyB;AACzB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,mBAAmB,GAAG,iBAAiB,CAmBpF;AAED,oFAAoF;AACpF,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASzE;AAED,oEAAoE;AACpE,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,YAAY,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAExH;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,GAAG,MAAM,CAG1F;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAM1E;AAED,mBAAmB;AACnB,wBAAgB,eAAe,CAAC,UAAU,EAAE,iBAAiB,GAAG;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAGA"}

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

@@ -0,0 +1,39 @@
+/**
+ * Pure publication policy shared by the knowledge runtime and backend fallback.
+ *
+ * The extension keeps the session-specific sealing state and validation orchestration;
+ * this module owns only deterministic notices, failure classification and advisory copy.
+ * The dependency-free packaged adapter is built from this package entrypoint.
+ */
+export type PublicationFailureCode = "paper-citation-required" | "search-required" | "coverage-incomplete" | "citation-required" | "citation-invalid" | "citation-budget" | "source-unread" | "delivery-changed" | "source-changed" | "wiki-changed" | "search-stale" | "binding-changed" | "navigation-changed" | "not-prepared" | "interrupted" | "model-error" | "check-timeout" | "check-failed" | "empty-answer" | "answer-too-large" | "protocol-budget" | "tool-loop-stopped" | "metacognitive-inconsistency" | "artifact-pending-review";
+export interface PublicationVerification {
+    sources?: unknown;
+    deliveries?: unknown;
+    unverifiedCitationCount?: unknown;
+    unverifiedCitations?: unknown;
+    citationCount?: unknown;
+    citationLimit?: unknown;
+    [key: string]: unknown;
+}
+export interface PublicationFailure {
+    code: PublicationFailureCode;
+    message: string;
+    paths: string[];
+}
+/** Message used by the backend when the runtime extension is unavailable. */
+export declare const publicationFallbackNotice = "\u56DE\u7B54\u68C0\u67E5\u672A\u5B8C\u6210\uFF0C\u56DE\u7B54\u6682\u672A\u5C55\u793A\u3002";
+export declare const publicationNotices: Readonly<Record<PublicationFailureCode, string>>;
+/** Return reader-facing copy for a publication failure or nonblocking advisory. */
+export declare function publicationNotice(code: string | null | undefined): string;
+/** Return reader-facing copy for a nonblocking advisory. */
+export declare function advisoryNotice(code: string | null | undefined): string;
+/**
+ * One reader-facing advisory line: what happened, then what was actually verified.
+ * Counts come from the check itself, so the sentence cannot overstate verification.
+ */
+export declare function advisoryLine(code: string, error?: {
+    verified?: PublicationVerification;
+}): string;
+/** Convert arbitrary validation failures into the bounded public failure contract. */
+export declare function knowledgeFailure(error: unknown): PublicationFailure;
+//# sourceMappingURL=publication-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publication-policy.d.ts","sourceRoot":"","sources":["../../src/core/publication-policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,sBAAsB,GAC/B,yBAAyB,GACzB,iBAAiB,GACjB,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,cAAc,GACd,aAAa,GACb,aAAa,GACb,eAAe,GACf,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,iBAAiB,GACjB,mBAAmB,GACnB,6BAA6B,GAC7B,yBAAyB,CAAC;AAE7B,MAAM,WAAW,uBAAuB;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,+FAAoB,CAAC;AAE3D,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,MAAM,CAAC,CA6B/E,CAAC;AAmBF,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEzE;AAED,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGtE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,uBAAuB,CAAA;CAAE,GAAG,MAAM,CAsBjG;AAkBD,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAUnE"}

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

@@ -0,0 +1,24 @@
+import { advisoryLine, advisoryNotice, knowledgeFailure } from "./publication-policy.js";
+export { advisoryLine, advisoryNotice, knowledgeFailure };
+export declare function projectKnowledgeEvent(event: any): any;
+export declare function projectKnowledgeSnapshot(messages: any, persisted?: never[]): any;
+export declare function registerAnswerPublication(pi: any, { runtime, getCurrent, evidenceOnly, getDeliveryFooter, getTaskFeedback, getTaskRuntime, getMetacognition, maxToolRounds, }: {
+    runtime?: null | undefined;
+    getCurrent: any;
+    evidenceOnly?: boolean | undefined;
+    getDeliveryFooter?: null | undefined;
+    getTaskFeedback?: null | undefined;
+    getTaskRuntime?: null | undefined;
+    getMetacognition?: null | undefined;
+    maxToolRounds?: number | undefined;
+}): {
+    attachRuntime: (next: any) => boolean;
+    attachReviewer: (next: any) => boolean;
+    recordDelivery(ctx: any, path: any): Promise<void>;
+    preflight(ctx: any, text: any): Promise<any>;
+    recordSetup(result: any, checkCurrent: any): void;
+    begin(isRequired?: boolean, newTurn?: boolean): void;
+    invalidate(): void;
+    readonly guidance: "Answer the user's question directly. For a planning request, first provide a concise provisional framework with explicit assumptions, then deepen only the evidence needed. Cite scientific claims inline using exact [[path]] citations from research_read_knowledge results read this turn; a saved report link is a deliverable, not an evidence citation. Reuse successful read receipts instead of reading the same source through both generic read and research_read_knowledge. Do not invent citations or cite a source merely to clear a warning. Label suggested sample sizes as design heuristics, not universal statistical thresholds. Acknowledge uncertainty and save useful knowledge. Evidence quality reminders are nonblocking: do not run repeated read/search/check just to clear them. Never claim scientific verification. Host permission, binding, abort and spending limits still apply; human Wiki edits require confirmation." | "For execution progress in ANY task (analysis, code, environment, experiments, writing), use task_status; its host-generated report needs no research citations. Never add irrelevant sources to an operational report. Scientific host-checked answers need a current-turn search, reads of cited [[path]] sources, then research_check_answer. Public text must answer the user's question; do not lecture about Vault policy or evidence-gate stages. Use short set_status about the task, not product design. Show Me/run links are deliverables, not evidence.";
+};
+//# sourceMappingURL=publication.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publication.d.ts","sourceRoot":"","sources":["../../src/core/publication.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,YAAY,EACZ,cAAc,EACd,gBAAgB,EAEhB,MAAM,yBAAyB,CAAC;AAIjC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC;AAyH1D,wBAAgB,qBAAqB,CAAC,KAAK,KAAA,OAiB1C;AACD,wBAAgB,wBAAwB,CAAC,QAAQ,KAAA,EAAE,SAAS,UAAK,OAWhE;AACD,wBAAgB,yBAAyB,CACxC,EAAE,KAAA,EACF,EACC,OAAc,EACd,UAAU,EACV,YAAoB,EACpB,iBAAwB,EACxB,eAAsB,EACtB,cAAqB,EACrB,gBAAuB,EACvB,aAAkB,GAClB;;;;;;;;;CAAA;;;;;;;;;EAgfD"}

package/node_modules/@gyoungwe/pi-knowledge/dist/core/recent-by-category.d.ts

@@ -0,0 +1,15 @@
+export type KnowledgeCategory = "paper" | "software" | "method" | "idea";
+export interface RecentCategoryRow {
+    path: string;
+    title: string;
+    kind: string;
+    signature: string;
+    body: string;
+}
+export declare function recentByCategory(rows: readonly RecentCategoryRow[], limit?: number): Record<KnowledgeCategory, Array<{
+    path: string;
+    title: string;
+    kind: string;
+    updatedAt: number;
+}>>;
+//# sourceMappingURL=recent-by-category.d.ts.map

package/node_modules/@gyoungwe/pi-knowledge/dist/core/recent-by-category.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent-by-category.d.ts","sourceRoot":"","sources":["../../src/core/recent-by-category.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzE,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACb;AAYD,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,SAAS,iBAAiB,EAAE,EAClC,KAAK,SAAK,GACR,MAAM,CAAC,iBAAiB,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAuBpG"}

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

@@ -0,0 +1,4 @@
+export declare function findRelatedNotes(title: string, limit?: number): Promise<string[]>;
+/** 在正文末尾追加「相关笔记」双链区；已在正文里链接过的不再重复 */
+export declare function appendRelatedLinks(markdown: string, paths: readonly string[]): string;
+//# sourceMappingURL=related-notes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"related-notes.d.ts","sourceRoot":"","sources":["../../src/core/related-notes.ts"],"names":[],"mappings":"AAOA,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBlF;AAED,qCAAqC;AACrC,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKrF"}

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

@@ -0,0 +1,124 @@
+import { type ContractParentRef, type KnowledgeEvidenceGrade, type KnowledgeFreshness, type KnowledgeReuseLevel, type KnowledgeSnapshot, type KnowledgeSourceReceipt } from "@gyoungwe/plugin-api/knowledge";
+/**
+ * The context carried by a knowledge snapshot.  A project id alone is not
+ * enough to reuse a source: the same project name may exist in two workspaces.
+ */
+export interface KnowledgeContext {
+    readonly projectId: string;
+    readonly workspaceId: string;
+    readonly workspaceRoot?: string;
+}
+export interface KnowledgeContextInput {
+    readonly projectId?: string;
+    readonly workspaceId?: string;
+    readonly workspaceRoot: string;
+}
+export declare function resolveKnowledgeContext(input: KnowledgeContextInput): KnowledgeContext;
+export type KnowledgeFreshnessStatus = "fresh" | "stale" | "unknown" | "invalid";
+export interface KnowledgeSourceState {
+    readonly contentHash: string;
+    readonly version?: string;
+}
+export interface KnowledgeFreshnessCheck {
+    readonly status: KnowledgeFreshnessStatus;
+    readonly checkedAt: string;
+    readonly reason?: string;
+}
+export interface KnowledgeFreshnessOptions {
+    readonly now?: string;
+    /** Maximum age of a read receipt. Omit to use an explicit expiry only. */
+    readonly maxAgeMs?: number;
+    /** Require a host-observed source version/hash when reusing a receipt. */
+    readonly requireCurrent?: boolean;
+    readonly current?: KnowledgeSourceState;
+}
+/** Validate one host read receipt without reading the source again. */
+export declare function validateKnowledgeSourceReceipt(receipt: KnowledgeSourceReceipt): KnowledgeSourceReceipt;
+/**
+ * Check both the age and the host-observed identity of a receipt. A missing
+ * current state is explicitly reported as unknown when the caller requests a
+ * fail-closed check; this avoids silently treating a title or stale index hit
+ * as current evidence.
+ */
+export declare function checkKnowledgeReceiptFreshness(receipt: KnowledgeSourceReceipt, options?: KnowledgeFreshnessOptions): KnowledgeFreshnessCheck;
+export interface KnowledgeReceiptInput extends Omit<KnowledgeSourceReceipt, "freshness"> {
+    readonly freshness?: KnowledgeFreshness;
+}
+export interface KnowledgeSnapshotInput {
+    readonly id?: string;
+    readonly context: KnowledgeContext;
+    readonly caseRef?: ContractParentRef;
+    readonly sources: readonly KnowledgeReceiptInput[];
+    readonly reuseLevel?: KnowledgeReuseLevel;
+    readonly evidenceGrade?: KnowledgeEvidenceGrade;
+    readonly evidenceLevel?: KnowledgeEvidenceGrade;
+    readonly assay?: string;
+    readonly analysisRefs?: readonly ContractParentRef[];
+    readonly evidenceCheckpointRefs?: readonly ContractParentRef[];
+    readonly environmentFingerprint?: string;
+    readonly methodVersion?: string;
+    readonly referenceVersion?: string;
+    readonly inputManifestHash?: string;
+    readonly createdAt?: string;
+    readonly ingestedAt?: string;
+    readonly parentRefs?: readonly ContractParentRef[];
+    readonly revision?: number;
+    readonly approval?: "pending" | "approved" | "rejected" | "revoked";
+}
+export declare function knowledgeEvidenceGradeRank(grade: KnowledgeEvidenceGrade): number;
+export declare function knowledgeReuseLevelRank(level: KnowledgeReuseLevel): number;
+/** Build a versioned, immutable snapshot from actual source read receipts. */
+export declare function ingestKnowledgeSnapshot(input: KnowledgeSnapshotInput): KnowledgeSnapshot;
+export interface KnowledgeReuseRequest {
+    readonly context: KnowledgeContext;
+    readonly requiredLevel?: KnowledgeReuseLevel;
+    readonly assay?: string;
+    readonly methodVersion?: string;
+    readonly referenceVersion?: string;
+    readonly inputManifestHash?: string;
+    readonly maxAgeMs?: number;
+    readonly now?: string;
+    readonly sourceStates?: Readonly<Record<string, KnowledgeSourceState>>;
+    readonly requireCurrent?: boolean;
+    readonly analysisRef?: ContractParentRef;
+    readonly evidenceCheckpointRef?: ContractParentRef;
+}
+export type KnowledgeReuseStatus = "reusable" | "pending-approval" | "revoked" | "stale" | "context-mismatch" | "insufficient-evidence" | "method-mismatch" | "reference-mismatch" | "input-mismatch" | "unlinked";
+export interface KnowledgeReuseDecision {
+    readonly snapshotId: string;
+    readonly reusable: boolean;
+    readonly status: KnowledgeReuseStatus;
+    readonly reasons: readonly string[];
+    readonly freshness: readonly KnowledgeFreshnessCheck[];
+    readonly reusedAt?: string;
+}
+/** Fail-closed checks used before a new analysis consumes a snapshot. */
+export declare function checkKnowledgeSnapshotReuse(snapshot: KnowledgeSnapshot, request: KnowledgeReuseRequest): KnowledgeReuseDecision;
+export interface KnowledgeReuseIndexEntry {
+    readonly snapshot: KnowledgeSnapshot;
+    readonly reuseCount: number;
+    readonly lastReusedAt?: string;
+}
+export interface KnowledgeReuseIndexStore {
+    read(): Promise<readonly KnowledgeSnapshot[]>;
+    write(snapshots: readonly KnowledgeSnapshot[]): Promise<void>;
+}
+/**
+ * A small reusable index. Persistence is supplied by the host through the
+ * optional store, so the knowledge package remains independent of JsonStore,
+ * Electron and backend implementations.
+ */
+export declare class KnowledgeReuseIndex {
+    private readonly store?;
+    private readonly entries;
+    private writeQueue;
+    constructor(store?: KnowledgeReuseIndexStore | undefined, snapshots?: readonly KnowledgeSnapshot[]);
+    load(): Promise<void>;
+    ingest(snapshot: KnowledgeSnapshot): Promise<KnowledgeSnapshot>;
+    get(id: string): KnowledgeReuseIndexEntry | undefined;
+    list(): readonly KnowledgeReuseIndexEntry[];
+    find(request: KnowledgeReuseRequest): readonly KnowledgeReuseDecision[];
+    reuse(id: string, request: KnowledgeReuseRequest): Promise<KnowledgeReuseDecision>;
+    private persist;
+}
+//# sourceMappingURL=reuse.d.ts.map

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

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

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

@@ -0,0 +1,12 @@
+export type ReviewMode = "automatic" | "strict";
+/**
+ * Read the review policy from the host-owned application directory.
+ * Environment policy is intentionally higher precedence than persisted state.
+ */
+export declare function readReviewMode(): ReviewMode;
+/** Persist a review mode atomically with restrictive file permissions. */
+export declare function saveReviewMode(mode: string): Promise<{
+    mode: ReviewMode;
+}>;
+export declare const advisoryCodes: Set<string>;
+//# sourceMappingURL=review-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review-policy.d.ts","sourceRoot":"","sources":["../../src/core/review-policy.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAMhD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAY3C;AAED,0EAA0E;AAC1E,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC,CAShF;AAED,eAAO,MAAM,aAAa,aAcxB,CAAC"}

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

@@ -0,0 +1,98 @@
+/** Host seams used by knowledge runtime modules.
+ *
+ * The domain package owns the stateful implementation; desktop/CLI hosts inject
+ * process event and runtime scheduling adapters at composition time. Defaults
+ * are deterministic and safe for read-only package use and tests.
+ */
+export type RuntimeExclusive = <T>(namespace: string, key: string, work: () => Promise<T>) => Promise<T>;
+export type ProcessEventEmitter = (event: string, payload?: unknown) => void;
+export type RuntimeSlotProvider = <T extends object>(domain: string, slot: string, create: () => T) => T;
+export type ToolMetadataLookup = (toolName: string) => unknown;
+export type FlowCardBuilder = (toolName: string) => unknown;
+export type DeliveryContract = (prompt: string, options?: Record<string, unknown>) => unknown;
+export declare function configureKnowledgeRuntime(host?: {
+    runRuntimeExclusive?: RuntimeExclusive;
+    emitProcessEvent?: ProcessEventEmitter;
+    toolMeta?: ToolMetadataLookup;
+    flowCardBuilder?: FlowCardBuilder;
+    deliveryContract?: DeliveryContract;
+    runtimeSlot?: RuntimeSlotProvider;
+}): void;
+export declare const runRuntimeExclusive: RuntimeExclusive;
+export declare const emitProcessEvent: ProcessEventEmitter;
+/** Resolve each operation through the host's current async runtime, including
+ * modules loaded before the host installs its adapter. */
+export declare function runtimeSlot<T extends object>(domain: string, key: string, factory: () => T): T;
+export declare function diagnosticText(value: unknown, limit?: number): string;
+export declare function toolMeta(_toolName: string): unknown;
+export declare function flowCardBuilder(_toolName: string): unknown;
+export type KnowledgeWorkerFactory = (url: URL, options: Record<string, unknown>) => unknown;
+export interface KnowledgeWorkerMetadata {
+    /** Human-readable worker artifact version (usually a build manifest hash). */
+    readonly version: string;
+    /** Absolute or package-relative resource path, when the host can disclose it. */
+    readonly source?: string;
+    /** SHA-256 of the exact worker bytes, when available. */
+    readonly integrity?: string;
+}
+export type KnowledgeWorkerMetadataProvider = () => KnowledgeWorkerMetadata;
+/**
+ * Install the worker factory used by the domain service.  Hosts may also
+ * provide a lazy metadata reader: packaged hosts select their resource root
+ * after this module is imported, so resolving the manifest eagerly would
+ * accidentally pin the development path.
+ */
+export declare function configureKnowledgeWorker(factory: KnowledgeWorkerFactory, metadata?: KnowledgeWorkerMetadataProvider): void;
+export declare function createKnowledgeWorker(url: URL, options: Record<string, unknown>): unknown;
+export declare function knowledgeWorkerMetadata(): KnowledgeWorkerMetadata;
+export declare const KNOWLEDGE_WORKER_LIFECYCLE_EVENT = "drone:knowledge-worker-lifecycle/v1";
+export type KnowledgeWorkerLifecycleStage = "staged" | "verified" | "enabled" | "disabled" | "drained" | "reloaded" | "rolled_back";
+export interface KnowledgeWorkerLifecycleEvent {
+    readonly stage: KnowledgeWorkerLifecycleStage;
+    readonly version: string;
+    readonly previousVersion?: string;
+    readonly source?: string;
+    readonly integrity?: string;
+    readonly reason?: string;
+    readonly pendingRequests?: number;
+    readonly at: string;
+}
+/** Emit bounded, metadata-only lifecycle evidence through the host seam. */
+export declare function emitKnowledgeWorkerLifecycle(stage: KnowledgeWorkerLifecycleStage, partial: Omit<KnowledgeWorkerLifecycleEvent, "stage" | "at">): void;
+export declare function configureKnowledgeEvidence(host: {
+    requiresPaperEvidence?: (query: string) => boolean;
+    hasPaperCitation?: (sources: unknown[]) => boolean;
+}): void;
+declare let requiresPaperEvidence: (query: string) => boolean;
+declare let hasPaperCitation: (sources: unknown[]) => boolean;
+export { requiresPaperEvidence, hasPaperCitation };
+export declare const deliveryContract: DeliveryContract;
+export type WorkspaceConfigLoader = (cwd: string) => Promise<Record<string, unknown>>;
+export type ExplainerPublisher = (input: Record<string, unknown>) => Promise<unknown>;
+export declare function configureKnowledgeHost(host?: {
+    loadWorkspaceConfig?: WorkspaceConfigLoader;
+    publishExplainer?: ExplainerPublisher;
+    consumeKnowledgeReviewPreview?: (cwd: string, token: string) => unknown;
+    specialistSettings?: () => Promise<Record<string, unknown>>;
+}): void;
+export declare const loadWorkspaceConfig: WorkspaceConfigLoader;
+export declare const publishExplainer: ExplainerPublisher;
+export declare const consumeKnowledgeReviewPreview: (cwd: string, token: string) => unknown;
+export declare const specialistSettings: () => Promise<Record<string, unknown>>;
+export type LayoutDefinition = {
+    templates: Record<string, string>;
+    noteTemplate: string;
+};
+export declare function configureKnowledgeSetup(host?: {
+    layout?: LayoutDefinition;
+    inspectObsidianSetup?: (input: Record<string, unknown>) => Promise<unknown>;
+    inspectSetupDirectory?: (vault: string) => Promise<unknown>;
+    resolveSetupVault?: (supplied: string, workspace: string) => string;
+    researchSetupOptions?: () => unknown;
+}): void;
+export declare const LAYOUT: LayoutDefinition;
+export declare const inspectObsidianSetup: (input: Record<string, unknown>) => Promise<unknown>;
+export declare const inspectSetupDirectory: (vault: string) => Promise<unknown>;
+export declare const resolveSetupVault: (supplied: string, workspace: string) => string;
+export declare const researchSetupOptions: () => unknown;
+//# sourceMappingURL=runtime-host.d.ts.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * Pure lexical/semantic indexing policy shared by knowledge hosts.
+ *
+ * The worker runtime keeps a self-contained JavaScript adapter for packaged
+ * CLI/electron builds, while this module is the typed source of truth for
+ * tests and backend callers.
+ */
+/** Tokenize English/Unicode text for the SQLite FTS index. */
+export declare function tokenizeKnowledgeText(text: string): string[];
+/** Build a bounded, quoted FTS5 expression from an end-user query. */
+export declare function buildKnowledgeSearchExpression(query: string): string;
+/** Split note text into bounded chunks for optional semantic indexing. */
+export declare function splitKnowledgeChunks(text: string, maxChars?: number): string[];
+//# sourceMappingURL=search-policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-policy.d.ts","sourceRoot":"","sources":["../../src/core/search-policy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,8DAA8D;AAC9D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAsB5D;AAED,sEAAsE;AACtE,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpE;AAED,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAO,GAAG,MAAM,EAAE,CAO5E"}

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

@@ -0,0 +1,85 @@
+/** Pure semantic projection for the knowledge network.
+ *
+ * The input deliberately accepts the old graph shape.  All fields added by
+ * this module are optional at the transport boundary, so an older worker can
+ * still be rendered by a newer desktop.
+ */
+export type SemanticView = "semantic" | "all";
+export type RelationType = "link" | "directory" | "duplicate";
+export interface SemanticNodeInput {
+    path: string;
+    title: string;
+    kind: string;
+    degree?: number;
+    scope?: string;
+    /** Stable bibliographic identity (DOI, PMID, arXiv, or a producer key). */
+    identity?: string | null;
+    /** Frontmatter type used to build the fixed research-sector layout. */
+    contentType?: string | null;
+}
+export interface SemanticEdgeInput {
+    source: string;
+    target: string;
+    type?: RelationType;
+}
+export interface SemanticNode {
+    path: string;
+    title: string;
+    kind: string;
+    degree: number;
+    nodeType: "note" | "wiki" | "navigation" | "mirror" | "infrastructure" | "memory";
+    isInfrastructure: boolean;
+    community: number;
+    x: number;
+    y: number;
+    mirrors?: string[];
+    warnings?: string[];
+    /** Normalized content category (paper, method, software, …). */
+    contentType?: string;
+    /** Research question/topic nodes anchor the surrounding category sectors. */
+    isMain?: boolean;
+    /** Main nodes this item bridges; shared items are placed between their anchors. */
+    sharedWith?: string[];
+}
+export interface SemanticRelation {
+    source: string;
+    target: string;
+    type: RelationType;
+}
+export interface SemanticGraph {
+    nodes: SemanticNode[];
+    edges: {
+        source: string;
+        target: string;
+    }[];
+    relations: SemanticRelation[];
+    duplicates: {
+        canonical: string;
+        duplicate: string;
+    }[];
+    communities: Record<string, number>;
+    layout: Record<string, {
+        x: number;
+        y: number;
+    }>;
+}
+/** Keep category colors and sectors stable even for older notes without typed frontmatter. */
+export declare function contentCategory(node: Pick<SemanticNodeInput, "path" | "kind" | "contentType">): string;
+export declare function isInfrastructureNode(node: Pick<SemanticNodeInput, "path" | "kind">): boolean;
+export declare function nodeType(node: Pick<SemanticNodeInput, "path" | "kind"> & {
+    contentType?: string | null;
+}): SemanticNode["nodeType"];
+/** Classify an edge without changing the meaning of legacy `edges`. */
+export declare function classifyRelation(source: Pick<SemanticNodeInput, "path">, target: Pick<SemanticNodeInput, "path">, type?: RelationType): RelationType;
+/** A deterministic local-moving modularity pass. It is intentionally small,
+ * dependency-free, and uses sorted keys for stable results across input order. */
+export declare function assignCommunities(paths: string[], edges: SemanticRelation[], seed?: number): Record<string, number>;
+export declare function createSemanticModel(input: {
+    nodes: SemanticNodeInput[];
+    edges?: SemanticEdgeInput[];
+}, options?: {
+    view?: SemanticView;
+    mergeMirrors?: boolean;
+    seed?: number;
+}): SemanticGraph;
+//# sourceMappingURL=semantic-model.d.ts.map

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * @param {Record<string, any>} [input]
+ */
+export declare function validateSemanticConfig(input?: {}): {
+    enabled: boolean;
+    provider: string;
+    baseUrl: string;
+    model: string;
+    credentialEnv: string;
+    remoteConsent: boolean;
+    timeoutMs?: undefined;
+    chunkChars?: undefined;
+    minSimilarity?: undefined;
+} | {
+    enabled: any;
+    provider: any;
+    baseUrl: string;
+    model: string;
+    credentialEnv: string;
+    remoteConsent: boolean;
+    timeoutMs: any;
+    chunkChars: any;
+    minSimilarity: any;
+};
+/**
+ * @param {Record<string, any>} rawConfig
+ * @param {string[]} texts
+ * @param {{ signal?: AbortSignal }} [options]
+ */
+export declare function embedTexts(rawConfig: any, texts: any, { signal }?: {}): Promise<{
+    provider: any;
+    model: string;
+    vectors: any[][];
+    dimension: number;
+}>;
+export declare const semanticLimits: Readonly<{
+    MAX_BATCH: 32;
+    MAX_CHARS: 120000;
+    MAX_RESPONSE: number;
+}>;
+//# sourceMappingURL=semantic-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-provider.d.ts","sourceRoot":"","sources":["../../src/core/semantic-provider.ts"],"names":[],"mappings":"AA6BA;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,KAAK;;;;;;;;;;;;;;;;;;;;EA+FhD;AA8DD;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,SAAS,KAAA,EAAE,KAAK,KAAA,EAAE,EAAE,MAAM,EAAE,KAAK;;;;;GA2EjE;AAED,eAAO,MAAM,cAAc;;;;EAAwD,CAAC"}

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

@@ -0,0 +1,30 @@
+export type SemanticProvider = "none" | "ollama" | "openai-compatible";
+export interface SemanticConfig {
+    enabled: boolean;
+    provider: SemanticProvider;
+    baseUrl: string;
+    model: string;
+    credentialEnv: string;
+    remoteConsent: boolean;
+    timeoutMs?: number;
+    chunkChars?: number;
+    minSimilarity?: number;
+}
+export interface SemanticSettings extends SemanticConfig {
+    version: 1;
+    revision: number;
+    updatedAt: string;
+}
+export interface SemanticSettingsState {
+    defaultUpdatedAt: Map<string, string>;
+}
+export interface SemanticSettingsApi {
+    readSemanticSettings(vaultId: string): Promise<SemanticSettings>;
+    saveSemanticSettings(vaultId: string, input: Partial<SemanticConfig>, expectedRevision: number): Promise<SemanticSettings>;
+}
+export declare function validateSemanticConfig(input?: Partial<SemanticConfig>): SemanticConfig;
+export declare function createSemanticSettingsState(): SemanticSettingsState;
+export declare function createSemanticSettingsApi(state?: SemanticSettingsState): SemanticSettingsApi;
+export declare const readSemanticSettings: (vaultId: string) => Promise<SemanticSettings>;
+export declare const saveSemanticSettings: (vaultId: string, input: Partial<SemanticConfig>, expectedRevision: number) => Promise<SemanticSettings>;
+//# sourceMappingURL=semantic-settings.d.ts.map