@gyoungwe/research-suite 0.1.5 → 0.1.7

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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"}

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