@gyoungwe/research-suite 0.1.5 → 0.1.6

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

@@ -0,0 +1,127 @@
+import type { MetacognitiveArtifactNumber, MetacognitiveSnapshot } from "./metacognitive-policy.js";
+export type ReviewerSeverity = "low" | "medium" | "high";
+export type ReviewerTrigger = "deliverable-write" | "milestone-complete" | "publication-projection";
+export interface DeliverableReviewLocation {
+    kind: "body" | "paragraph" | "line" | "artifact";
+    paragraph?: number;
+    line?: number;
+    artifactId?: string;
+    path?: string;
+}
+export interface DeliverableReviewFinding {
+    id: string;
+    code: "untraceable-number" | "figure-code-mismatch" | "citation-without-receipt" | "review-timeout" | "review-budget-exhausted";
+    severity: ReviewerSeverity;
+    location: DeliverableReviewLocation;
+    detail: string;
+    suggestion: string;
+    handled: boolean;
+    independent?: boolean;
+    nonIndependentReason?: string;
+}
+export interface ReviewDeliverableRecord {
+    id: string;
+    path?: string;
+    kind?: string;
+    sha256?: string;
+    attemptId?: string;
+    receiptId?: string;
+}
+export interface ReviewAttemptRecord {
+    id: string;
+    artifactIds?: readonly string[];
+    startedAt?: string;
+    finishedAt?: string;
+    /** Latest output hashes keyed by artifact id. */
+    outputs?: readonly {
+        artifactId: string;
+        sha256: string;
+    }[];
+    /** Compatibility shape used by inquiry/compute adapters. */
+    artifactSha256?: Readonly<Record<string, string>>;
+}
+export interface ReviewReadReceipt {
+    path: string;
+    hash?: string;
+    receiptRef?: string;
+    text?: string;
+    numbers?: readonly MetacognitiveArtifactNumber[];
+}
+export interface DeliverableReviewSnapshot extends MetacognitiveSnapshot {
+    /** Public answer/deliverable body. `answer` is accepted as a compatibility alias. */
+    body?: string;
+    answer?: string;
+    deliverables?: readonly ReviewDeliverableRecord[];
+    attempts?: readonly ReviewAttemptRecord[];
+    readReceipts?: readonly ReviewReadReceipt[];
+    /** Optional explicit citations when the body is not available. */
+    citations?: readonly string[];
+}
+export interface DeliverableReviewResult {
+    contentHash: string;
+    findings: readonly DeliverableReviewFinding[];
+}
+export interface ReviewerModelProvider {
+    provider: string;
+    model?: string;
+}
+export interface ReviewerProviderSelection {
+    provider: string;
+    model?: string;
+    independent: boolean;
+    nonIndependentReason?: string;
+}
+export interface BackgroundReviewerOptions {
+    timeoutMs?: number;
+    maxPerSession?: number;
+    review?: (snapshot: DeliverableReviewSnapshot) => DeliverableReviewFinding[] | Promise<DeliverableReviewFinding[]>;
+    /** Optional model-backed pass; the host selects the provider by provider id. */
+    modelReview?: (snapshot: DeliverableReviewSnapshot, selection: ReviewerProviderSelection) => DeliverableReviewFinding[] | Promise<DeliverableReviewFinding[]>;
+    mainProvider?: string;
+    providers?: readonly ReviewerModelProvider[];
+    getProviders?: () => readonly ReviewerModelProvider[] | Promise<readonly ReviewerModelProvider[]>;
+    useModel?: () => boolean | Promise<boolean>;
+    onResult?: (sessionId: string, result: DeliverableReviewResult, trigger: ReviewerTrigger) => void | Promise<void>;
+    now?: () => number;
+}
+export interface BackgroundReviewerBridge {
+    schedule(request: BackgroundReviewRequest): void;
+    getCached?(sessionId: string, snapshot: DeliverableReviewSnapshot): DeliverableReviewResult | undefined;
+    getFindings?(sessionId: string): readonly DeliverableReviewFinding[];
+    clearSession?(sessionId: string): void;
+}
+export interface BackgroundReviewRequest {
+    sessionId: string;
+    snapshot: DeliverableReviewSnapshot;
+    trigger: ReviewerTrigger;
+    mainProvider?: string;
+}
+export declare function reviewDeliverable(snapshot: DeliverableReviewSnapshot): DeliverableReviewResult;
+export declare function selectReviewerProvider(mainProvider: string | undefined, providers: readonly ReviewerModelProvider[]): ReviewerProviderSelection | null;
+export declare class BackgroundReviewer {
+    private readonly timeoutMs;
+    private readonly maxPerSession;
+    private readonly review;
+    private readonly modelReview?;
+    private readonly mainProvider?;
+    private readonly providers;
+    private readonly getProviders?;
+    private readonly useModel?;
+    private readonly onResult?;
+    private readonly now;
+    private readonly cache;
+    private readonly results;
+    private readonly counts;
+    private readonly emitted;
+    private readonly latest;
+    private disposed;
+    constructor(options?: BackgroundReviewerOptions);
+    private timeoutFinding;
+    reviewOnce(request: BackgroundReviewRequest): Promise<DeliverableReviewResult>;
+    getCached(sessionId: string, snapshot: DeliverableReviewSnapshot): DeliverableReviewResult | undefined;
+    schedule(request: BackgroundReviewRequest): void;
+    getFindings(sessionId: string): readonly DeliverableReviewFinding[];
+    clearSession(sessionId: string): void;
+    dispose(): void;
+}
+//# sourceMappingURL=deliverable-review.d.ts.map

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

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

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

@@ -0,0 +1,39 @@
+import { createEvolutionCandidate, createKnowledgeReuseDecision, type EvolutionCandidate, type KnowledgeReuseDecisionRecord, type ContractParentRef } from "@gyoungwe/plugin-api/knowledge";
+export interface EvolutionIndexStore {
+    read(): Promise<{
+        readonly candidates: readonly EvolutionCandidate[];
+        readonly decisions: readonly KnowledgeReuseDecisionRecord[];
+    }>;
+    write(value: {
+        readonly candidates: readonly EvolutionCandidate[];
+        readonly decisions: readonly KnowledgeReuseDecisionRecord[];
+    }): Promise<void>;
+}
+/**
+ * Durable host-neutral index for knowledge reuse and evolution proposals.
+ * JsonStore is injected by the backend; this package only owns lifecycle and
+ * fail-closed approval rules.
+ */
+export declare class EvolutionIndex {
+    private readonly store?;
+    private readonly candidates;
+    private readonly decisions;
+    private writeQueue;
+    constructor(store?: EvolutionIndexStore | undefined);
+    load(): Promise<void>;
+    propose(input: Parameters<typeof createEvolutionCandidate>[0]): Promise<EvolutionCandidate>;
+    getCandidate(id: string): EvolutionCandidate | undefined;
+    listCandidates(): readonly EvolutionCandidate[];
+    approveCandidate(id: string, approvalRef: ContractParentRef, now: string): Promise<EvolutionCandidate>;
+    supersedeCandidate(id: string, supersedingRef: ContractParentRef, now: string): Promise<EvolutionCandidate>;
+    revokeCandidate(id: string, revokedByRef: ContractParentRef, reason: string, now: string): Promise<EvolutionCandidate>;
+    recordReuseDecision(input: Parameters<typeof createKnowledgeReuseDecision>[0]): Promise<KnowledgeReuseDecisionRecord>;
+    getReuseDecision(id: string): KnowledgeReuseDecisionRecord | undefined;
+    listReuseDecisions(): readonly KnowledgeReuseDecisionRecord[];
+    approveReuse(id: string, approvalRef: ContractParentRef, now: string): Promise<KnowledgeReuseDecisionRecord>;
+    revokeReuse(id: string, revokedByRef: ContractParentRef, now: string): Promise<KnowledgeReuseDecisionRecord>;
+    private requireCandidate;
+    private requireDecision;
+    private persist;
+}
+//# sourceMappingURL=evolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evolution.d.ts","sourceRoot":"","sources":["../../src/core/evolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAGN,wBAAwB,EACxB,4BAA4B,EAI5B,KAAK,kBAAkB,EACvB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,EACtB,MAAM,gCAAgC,CAAC;AAExC,MAAM,WAAW,mBAAmB;IACnC,IAAI,IAAI,OAAO,CAAC;QACf,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;QACnD,QAAQ,CAAC,SAAS,EAAE,SAAS,4BAA4B,EAAE,CAAC;KAC5D,CAAC,CAAC;IACH,KAAK,CAAC,KAAK,EAAE;QACZ,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAC;QACnD,QAAQ,CAAC,SAAS,EAAE,SAAS,4BAA4B,EAAE,CAAC;KAC5D,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IAKd,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAJnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAC7E,OAAO,CAAC,UAAU,CAAoC;gBAEzB,KAAK,CAAC,EAAE,mBAAmB,YAAA;IAElD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrB,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQjG,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIxD,cAAc,IAAI,SAAS,kBAAkB,EAAE;IAIzC,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQtG,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQ3G,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAQtH,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAQ3H,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,4BAA4B,GAAG,SAAS;IAItE,kBAAkB,IAAI,SAAS,4BAA4B,EAAE;IAIvD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAQ5G,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAQlH,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,eAAe;YAMT,OAAO;CAUrB"}

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

@@ -0,0 +1,290 @@
+/** Durable format for terminal-job experience. It is intentionally separate from evidence and instructions. */
+export declare const EXPERIENCE_VERSION = 1;
+export declare const EXPERIENCE_LIMITS: Readonly<{
+    maxRecords: 128;
+    maxFileBytes: number;
+    maxSummaryChars: 1200;
+    maxReasonChars: 600;
+    maxTags: 16;
+    maxArtifacts: 16;
+    maxSources: 16;
+    maxObservationIds: 8;
+    maxJobIds: 8;
+    maxWorkflowSpecDiffs: 16;
+    maxQcMetrics: 24;
+    maxQcValues: 128;
+    maxModelSummaryChars: 500;
+    maxSearchResults: 24;
+    maxHostIdChars: 64;
+    maxProjectChars: 96;
+    maxWorkflowChars: 180;
+    maxSchedulerChars: 32;
+    maxRevisionChars: 180;
+    maxSchedulerJobIdChars: 180;
+    maxQueryChars: 200;
+}>;
+export type ExperienceStatus = "observed" | "verified";
+export type ExperienceOutcome = "success" | "failure" | "blocked" | "unknown";
+export interface ExperienceBinding {
+    vaultId: string;
+}
+export interface ExperienceArtifact {
+    path?: string;
+    sha256: string;
+    bytes?: number;
+}
+/** Host-observed execution facts copied from a terminal compute completion. */
+export interface ExperienceExecutionFacts {
+    contractHash?: string | null;
+    workflow?: string | null;
+    workflowRevision?: string | null;
+    scheduler?: string | null;
+    schedulerJobId?: string | null;
+    artifactRefs?: readonly ExperienceArtifact[] | null;
+}
+export interface ExperienceRepair {
+    succeeded: boolean;
+    summary?: string | null;
+    observationId?: string | null;
+}
+export type WorkflowSpecDiffValue = string | number | boolean | null;
+export interface WorkflowSpecDiff {
+    path: string;
+    before?: WorkflowSpecDiffValue;
+    after?: WorkflowSpecDiffValue;
+}
+export interface ExperienceResourceUse {
+    [key: string]: number;
+}
+export interface ExperienceQcDistribution {
+    [key: string]: number | undefined;
+    min?: number;
+    max?: number;
+    mean?: number;
+    median?: number;
+    p95?: number;
+    count?: number;
+}
+export interface ExperienceQcMetric {
+    name: string;
+    unit?: string | null;
+    value?: number | null;
+    count?: number | null;
+    distribution?: ExperienceQcDistribution;
+    values?: number[];
+}
+export interface ExperienceProvenance {
+    runId?: string | null;
+    observationId?: string | null;
+    receiptId?: string | null;
+    manifestSha256?: string | null;
+    artifactHashes?: readonly ExperienceArtifact[];
+}
+export interface ExperienceObservation {
+    id: string;
+    outcome: ExperienceOutcome;
+    observedAt?: string;
+    exitCode?: number | null;
+    featureKey?: string;
+    repairSucceeded?: boolean;
+    failureSignature?: string | null;
+    failedStep?: string | null;
+    step?: string | null;
+    repair?: ExperienceRepair | null;
+    workflowSpecDiff?: readonly WorkflowSpecDiff[] | null;
+    resourceUse?: ExperienceResourceUse | null;
+    qcMetrics?: readonly ExperienceQcMetric[] | null;
+    qc?: readonly ExperienceQcMetric[] | null;
+    modelSummary?: string | null;
+    contractHash?: string | null;
+    workflow?: string | null;
+    workflowRevision?: string | null;
+    scheduler?: string | null;
+    schedulerJobId?: string | null;
+    artifactRefs?: readonly ExperienceArtifact[] | null;
+    provenance?: ExperienceProvenance;
+}
+export interface TerminalJobExperienceInput {
+    jobId: string;
+    featureKey?: string;
+    summary: string;
+    outcome: ExperienceOutcome;
+    exitCode?: number | null;
+    step?: string | null;
+    failureSignature?: string | null;
+    repairSucceeded?: boolean;
+    failedStep?: string | null;
+    repair?: ExperienceRepair | null;
+    workflowSpecDiff?: readonly WorkflowSpecDiff[] | null;
+    resourceUse?: ExperienceResourceUse | null;
+    qcMetrics?: readonly ExperienceQcMetric[] | null;
+    qc?: readonly ExperienceQcMetric[] | null;
+    modelSummary?: string | null;
+    /** Immutable task/compute contract and exact workflow facts observed by the host. */
+    contractHash?: string | null;
+    workflow?: string | null;
+    workflowRevision?: string | null;
+    scheduler?: string | null;
+    schedulerJobId?: string | null;
+    artifactRefs?: readonly ExperienceArtifact[] | null;
+    observationId: string;
+    observedAt?: string;
+    topicId?: string | null;
+    provenance: ExperienceProvenance;
+    tags?: readonly string[];
+    sourceRefs?: readonly string[];
+}
+export interface ExperienceStorePort {
+    record(input: ExperienceInput, expectedRevision?: number): Promise<{
+        classification: string;
+        record: ExperienceRecord;
+        revision: number;
+    }>;
+}
+export interface ExperienceInput {
+    /** Stable job identifier from the terminal runner. */
+    jobId?: string;
+    /** A stable semantic pattern key. Different observations of this key can verify an experience. */
+    featureKey?: string;
+    summary: string;
+    observation?: ExperienceObservation;
+    hostObservation?: ExperienceObservation;
+    provenance?: ExperienceProvenance;
+    topicId?: string | null;
+    reason?: string | null;
+    tags?: readonly string[];
+    sourceRefs?: readonly string[];
+    exitCode?: number | null;
+    failureSignature?: string | null;
+    failedStep?: string | null;
+    repairSucceeded?: boolean;
+    step?: string | null;
+    repair?: ExperienceRepair | null;
+    workflowSpecDiff?: readonly WorkflowSpecDiff[] | null;
+    resourceUse?: ExperienceResourceUse | null;
+    qcMetrics?: readonly ExperienceQcMetric[] | null;
+    qc?: readonly ExperienceQcMetric[] | null;
+    /** Compatibility alias for qcMetrics at the adapter boundary. */
+    modelSummary?: string | null;
+    contractHash?: string | null;
+    workflow?: string | null;
+    workflowRevision?: string | null;
+    scheduler?: string | null;
+    schedulerJobId?: string | null;
+    artifactRefs?: readonly ExperienceArtifact[] | null;
+    /** Accepted for compatibility at the adapter boundary but intentionally never persisted. */
+    command?: unknown;
+    output?: unknown;
+    credentials?: unknown;
+}
+export interface ExperienceRecord {
+    id: string;
+    version: 1;
+    vaultId: string;
+    project: string;
+    hostId: string;
+    jobId: string;
+    featureKey: string;
+    topicId: string | null;
+    summary: string;
+    reason: string | null;
+    outcome: ExperienceOutcome;
+    status: ExperienceStatus;
+    observedAt: string;
+    observationIds: string[];
+    observationCount: number;
+    jobIds: string[];
+    jobCount: number;
+    failureSignature: string | null;
+    exitCode: number | null;
+    failedStep: string | null;
+    repair: ExperienceRepair | null;
+    workflowSpecDiff: WorkflowSpecDiff[];
+    resourceUse: ExperienceResourceUse;
+    qcMetrics: ExperienceQcMetric[];
+    modelSummary: string | null;
+    modelGenerated: boolean;
+    contractHash: string | null;
+    workflow: string | null;
+    workflowRevision: string | null;
+    scheduler: string | null;
+    schedulerJobId: string | null;
+    artifactRefs: ExperienceArtifact[];
+    provenance: ExperienceProvenance;
+    tags: string[];
+    sourceRefs: string[];
+    navigationOnly: true;
+    evidenceEligible: false;
+    instructionEligible: false;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ExperienceDocument {
+    version: 1;
+    vaultId: string;
+    project: string;
+    hostId: string;
+    revision: number;
+    updatedAt: string;
+    records: ExperienceRecord[];
+}
+export interface ExperienceSearchHit {
+    score: number;
+    record: ExperienceRecord;
+}
+export interface ExperienceSearchResult {
+    revision: number;
+    query: string;
+    records: ExperienceSearchHit[];
+    navigationOnly: true;
+    evidenceEligible: false;
+    instructionEligible: false;
+}
+export interface ExperienceStoreOptions {
+    binding: ExperienceBinding;
+    project: string;
+    hostId: string;
+    directory?: string | null;
+}
+export interface ExperienceStore {
+    path: string;
+    scope: {
+        vaultId: string;
+        project: string;
+        hostId: string;
+    };
+    read: () => Promise<ExperienceDocument>;
+    record: (input: ExperienceInput, expectedRevision?: number) => Promise<{
+        classification: "new" | "updated" | "duplicate";
+        revision: number;
+        record: ExperienceRecord;
+    }>;
+    search: (query?: string, options?: {
+        limit?: number;
+        includeObserved?: boolean;
+        workflow?: string;
+        hostId?: string;
+        failureSignature?: string;
+    }) => Promise<ExperienceSearchResult>;
+}
+/** Convert a stable B1/B3 terminal-job observation into the redacted Experience input.
+ * The adapter accepts only host-observed fields and provenance pointers; runner output and commands stay out.
+ */
+export declare function experienceInputFromTerminalJob(input: TerminalJobExperienceInput): ExperienceInput;
+export declare const terminalJobExperienceInput: typeof experienceInputFromTerminalJob;
+export declare function recordTerminalJobExperience(store: ExperienceStorePort, input: TerminalJobExperienceInput, expectedRevision?: number): Promise<{
+    classification: string;
+    record: ExperienceRecord;
+    revision: number;
+}>;
+/** Build a bounded, host-isolated experience log backed by atomic JSON and revision CAS. */
+export declare function createExperienceStore(options: ExperienceStoreOptions): ExperienceStore;
+export declare function searchExperiences(options: ExperienceStoreOptions & {
+    query?: string;
+    limit?: number;
+    includeObserved?: boolean;
+    workflow?: string;
+    failureSignature?: string;
+    hostFilter?: string;
+}): Promise<ExperienceSearchResult>;
+//# sourceMappingURL=experience-store.d.ts.map

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

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

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

@@ -0,0 +1,38 @@
+import { type SessionContextLike } from "./project-identity.js";
+/** Tool result envelope shared by knowledge extension adapters. */
+export interface KnowledgeToolResult<T = unknown> {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    details: T;
+}
+/** JSON-safe result envelope for a knowledge tool. */
+export declare function result<T>(data: T): KnowledgeToolResult<T>;
+/**
+ * Resolve the knowledge project for a tool call or turn through the shared resolver
+ * (`project-identity.ts`): the daily-space session choice, then the workspace's configured
+ * `knowledgeProjectId`, then the stable directory-derived identity.
+ */
+export declare function currentProject(cwd: string, ctx?: SessionContextLike | null): Promise<string>;
+/** Normalise a stable explainer topic id, dropping generated timestamp suffixes. */
+export declare function explainerTopicId(value: unknown, title?: string): string;
+export interface SessionIdentityContext {
+    sessionManager?: {
+        getSessionId?: () => string | null | undefined;
+    };
+    sessionId?: string | null;
+}
+/** Prefer the host session manager, with the event context as a compatibility fallback. */
+export declare function sessionIdentity(ctx: SessionIdentityContext | null | undefined): string | null;
+/** Whether a prompt contains a signal that it continues the previous topic. */
+export declare function continuationHint(value: unknown): boolean;
+export interface TopicForContinuation {
+    id?: unknown;
+    title?: unknown;
+    aliases?: readonly unknown[];
+    entities?: readonly unknown[];
+}
+/** Decide whether a prompt continues a topic using explicit switches and topic terms. */
+export declare function continuesTopic(prompt: unknown, topic: TopicForContinuation | null | undefined): boolean;
+//# sourceMappingURL=extension-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-helpers.d.ts","sourceRoot":"","sources":["../../src/core/extension-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,kBAAkB,EAAoB,MAAM,uBAAuB,CAAC;AAE3G,mEAAmE;AACnE,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,OAAO;IAC/C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC;CACX;AAED,sDAAsD;AACtD,wBAAgB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAKzD;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAElG;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAmB,GAAG,MAAM,CASjF;AAED,MAAM,WAAW,sBAAsB;IACtC,cAAc,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;KAAE,CAAC;IACpE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,GAAG,EAAE,sBAAsB,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAE7F;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIxD;AAED,MAAM,WAAW,oBAAoB;IACpC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC9B;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,oBAAoB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAUvG"}

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

@@ -0,0 +1,39 @@
+import { lstat } from "node:fs/promises";
+export declare const MAX_NOTE_BYTES: number;
+export interface NoteStat {
+    full: string;
+    stat: Awaited<ReturnType<typeof lstat>>;
+    signature: string;
+}
+export interface ReadNoteResult {
+    path: string;
+    text: string;
+    hash: string;
+    signature: string;
+    bytes: number;
+}
+export interface NoteSnippet {
+    text: string;
+    startLine: number;
+    endLine: number;
+    totalLines: number;
+    truncated: boolean;
+}
+export declare function allowedSegment(name: string): boolean;
+export declare function validateNote(path: unknown): string;
+export declare function noteScope(path: string): string;
+export declare function canRead(path: string, project: string): boolean;
+export declare function fileVersion(stat: {
+    mtimeMs: number | bigint;
+    ctimeMs: number | bigint;
+    size: number | bigint;
+    ino: number | bigint;
+}): string;
+export declare function safeNotePath(vault: string, path: string): Promise<string>;
+export declare function inspectNote(vault: string, path: string): Promise<NoteStat>;
+export declare function readNoteFile(vault: string, path: string): Promise<ReadNoteResult>;
+export declare function snippet(text: string, { startLine, maxChars }?: {
+    startLine?: number;
+    maxChars?: number;
+}): NoteSnippet;
+//# sourceMappingURL=files.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/core/files.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAkB,MAAM,kBAAkB,CAAC;AAGzD,eAAO,MAAM,cAAc,QAAc,CAAC;AAkB1C,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC;IACxC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAalD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE;IACjC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACrB,GAAG,MAAM,CAET;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAY/E;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAKhF;AAUD,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAoCvF;AAED,wBAAgB,OAAO,CACtB,IAAI,EAAE,MAAM,EACZ,EAAE,SAAa,EAAE,QAAe,EAAE,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAChF,WAAW,CAwBb"}

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

@@ -0,0 +1,77 @@
+export type FlowTone = "ok" | "error" | "muted" | "warn" | string;
+export interface FlowCardField {
+    label: string;
+    i18n?: unknown;
+    value: string;
+    status?: boolean;
+    code?: string | null;
+    note?: string | null;
+    tone: FlowTone;
+}
+export interface FlowCardLink {
+    kind: "external" | "resource" | "note" | "path";
+    target: string;
+    label: string;
+    i18n?: unknown;
+}
+export interface FlowCard {
+    key: string;
+    kind: string;
+    title: string;
+    provisionalTitle: boolean;
+    subtitle: string | null;
+    status: string;
+    tone: FlowTone;
+    detail: string | null;
+    path: string | null;
+    fields: FlowCardField[];
+    links: FlowCardLink[];
+    source: string | null;
+    at: number;
+}
+export interface CardFieldOptions {
+    i18n?: unknown;
+    status?: boolean;
+    code?: unknown;
+    note?: unknown;
+    tone?: FlowTone;
+}
+export interface FlowCardInput {
+    key?: unknown;
+    kind?: unknown;
+    title?: unknown;
+    subtitle?: unknown;
+    status?: unknown;
+    tone?: FlowTone;
+    detail?: unknown;
+    path?: unknown;
+    fields?: readonly (FlowCardField | null | undefined)[];
+    links?: readonly (FlowCardLink | null | undefined)[];
+    source?: unknown;
+    provisionalTitle?: unknown;
+}
+export interface FlowEventContent {
+    type?: unknown;
+    text?: unknown;
+}
+export interface FlowEvent {
+    toolCallId?: unknown;
+    toolName?: unknown;
+    result?: {
+        content?: readonly FlowEventContent[];
+        details?: unknown;
+    };
+}
+/** Status marker to tone mapping; display classification never changes the marker. */
+export declare function statusTone(status: unknown): FlowTone;
+export declare function cardField(label: unknown, value: unknown, extra?: CardFieldOptions): FlowCardField;
+export declare function cardLink(kind: FlowCardLink["kind"] | string, target: unknown, label: unknown, i18n?: unknown): FlowCardLink | null;
+/** Construct one generic receipt card; empty fields and null links are omitted. */
+export declare function flowCard(input: FlowCardInput): FlowCard;
+/** Failure card generated when a flow-enabled tool reports an error. */
+export declare function failureCard(event: FlowEvent): FlowCard;
+/** Literature receipt card merged by DOI across Zotero and Vault observations. */
+export declare function literatureCard(event: FlowEvent, { write }?: {
+    write?: boolean;
+}): FlowCard | null;
+//# sourceMappingURL=flow-cards.d.ts.map

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

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