@evegoodevening/dsh-llmwiki 0.0.0-stage → 0.0.2

package/lib/types/atomic.d.ts

@@ -0,0 +1,19 @@
+import { type FileHandle } from 'node:fs/promises';
+import { type WikiDirectory } from './paths.ts';
+export interface AtomicWriteOperations {
+    readonly open: (path: string, flags: string | number, mode?: number) => Promise<FileHandle>;
+    readonly rename: (oldPath: string, newPath: string) => Promise<void>;
+    readonly unlink: (path: string) => Promise<void>;
+    readonly randomBytes: (size: number) => Buffer;
+}
+export interface AtomicWriteOptions {
+    readonly signal?: AbortSignal | undefined;
+    readonly mode?: number;
+    readonly operations?: Partial<AtomicWriteOperations>;
+}
+export declare function syncFile(handle: FileHandle): Promise<void>;
+/** Recognize only names produced by this writer for the specified target. */
+export declare function isAtomicTemporaryName(candidate: string, name: string): boolean;
+/** Publish exact bytes within one pinned parent. No failure is reported after rename commits. */
+export declare function atomicWriteFile(directory: WikiDirectory, name: string, bytes: Uint8Array, options?: AtomicWriteOptions): Promise<void>;
+//# sourceMappingURL=atomic.d.ts.map

package/lib/types/atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.d.ts","sourceRoot":"","sources":["../../src/atomic.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAGxE,OAAO,EAA6C,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAK1F,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC3F,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAC/C;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAA;CACrD;AACD,wBAAsB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhE;AAMD,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG9E;AACD,iGAAiG;AACjG,wBAAsB,eAAe,CAAC,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDhJ"}

package/lib/types/command.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { ResolvedConfig } from './config.ts';
+export declare function registerLlmWikiCommand(ctx: Context, config: ResolvedConfig): void;
+//# sourceMappingURL=command.d.ts.map

package/lib/types/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAwDjD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAwBjF"}

package/lib/types/config.d.ts

@@ -0,0 +1,22 @@
+import z from '@deepseek-ai/schemastery';
+export interface Config {
+    readonly root?: string;
+    readonly maxSourceBytes?: number;
+    readonly maxPageBytes?: number;
+    readonly maxResults?: number;
+    readonly maxSnippetBytes?: number;
+    readonly commandDiagnosticLimit?: number;
+}
+export interface ResolvedConfig {
+    readonly root: string;
+    readonly maxSourceBytes: number;
+    readonly maxPageBytes: number;
+    readonly maxResults: number;
+    readonly maxSnippetBytes: number;
+    readonly commandDiagnosticLimit: number;
+}
+type ConfigSchema = z<Config, ResolvedConfig>;
+export declare const Config: ConfigSchema;
+export declare function resolveConfig(config?: Config): ResolvedConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/lib/types/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;CACxC;AA0BD,KAAK,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;AAc7C,eAAO,MAAM,MAAM,EAAE,YAGnB,CAAA;AAEF,wBAAgB,aAAa,CAAC,MAAM,GAAE,MAAW,GAAG,cAAc,CAEjE"}

package/lib/types/errors.d.ts

@@ -0,0 +1,16 @@
+export declare const LLMWIKI_ERROR_CODES: readonly ["NOT_INITIALIZED", "INVALID_PATH", "SOURCE_NOT_FOUND", "PAGE_NOT_FOUND", "INVALID_PAGE", "INVALID_PRECONDITION", "PAGE_CONFLICT", "LIMIT_EXCEEDED", "ABORTED", "UNSAFE_FILESYSTEM", "INDEX_CORRUPT", "INVALID_CURSOR", "CATALOG_CORRUPT"];
+export type LlmWikiErrorCode = (typeof LLMWIKI_ERROR_CODES)[number];
+export interface SerializedLlmWikiError {
+    readonly code: LlmWikiErrorCode;
+    readonly message: string;
+}
+export declare class LlmWikiError extends Error {
+    readonly code: LlmWikiErrorCode;
+    constructor(code: LlmWikiErrorCode, message: string, options?: ErrorOptions);
+    toJSON(): SerializedLlmWikiError;
+}
+export declare function isLlmWikiError(value: unknown): value is LlmWikiError;
+export declare function throwIfAborted(signal?: AbortSignal): void;
+export declare function invalidPath(message: string, options?: ErrorOptions): LlmWikiError;
+export declare function unsafeFilesystem(message: string, options?: ErrorOptions): LlmWikiError;
+//# sourceMappingURL=errors.d.ts.map

package/lib/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,qPActB,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;gBAEnB,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;IAM3E,MAAM,IAAI,sBAAsB;CAGjC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,IAAI,CAIzD;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,CAEjF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,CAEtF"}

package/lib/types/ids.d.ts

@@ -0,0 +1,8 @@
+import type { Branded } from '@deepseek-ai/dsh-brand';
+export type SourceId = Branded<'SourceId'>;
+export type PageId = Branded<'PageId'>;
+export declare function sourceId(value: string): SourceId;
+export declare function pageId(value: string): PageId;
+export declare function isSourceId(value: string): value is SourceId;
+export declare function isPageId(value: string): value is PageId;
+//# sourceMappingURL=ids.d.ts.map

package/lib/types/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAGrD,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;AAC1C,MAAM,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;AAMtC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAKhD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA0B5C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAOvD"}

package/lib/types/index.d.ts

@@ -0,0 +1,14 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { Config as LlmWikiConfig } from './config.ts';
+export { Config } from './config.ts';
+export type { Config as LlmWikiConfig, ResolvedConfig } from './config.ts';
+export { LLMWIKI_ERROR_CODES, LlmWikiError, isLlmWikiError, } from './errors.ts';
+export type { LlmWikiErrorCode, SerializedLlmWikiError, } from './errors.ts';
+export { isPageId, isSourceId, pageId, sourceId, } from './ids.ts';
+export type { PageId, SourceId } from './ids.ts';
+export { LlmWikiService } from './service.ts';
+export type * from './types.ts';
+export declare const name = "llmwiki";
+export declare const inject: string[];
+export declare function apply(ctx: Context, config?: LlmWikiConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,KAAK,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,aAAa,CAAA;AAK1D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,YAAY,EAAE,MAAM,IAAI,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC1E,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,GACT,MAAM,UAAU,CAAA;AACjB,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,mBAAmB,YAAY,CAAA;AAE/B,eAAO,MAAM,IAAI,YAAY,CAAA;AAC7B,eAAO,MAAM,MAAM,UAAwC,CAAA;AAE3D,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,aAAkB,GAAG,IAAI,CAMpE"}

package/lib/types/indexer.d.ts

@@ -0,0 +1,69 @@
+import type { WikiDirectory, WikiPaths } from './paths.ts';
+import type { SearchHit } from './types.ts';
+export declare const INDEX_FORMAT_VERSION: 1;
+interface Fingerprint {
+    readonly pageId: string;
+    readonly sha256: string;
+}
+interface TermCount {
+    readonly term: string;
+    readonly count: number;
+}
+export interface IndexStateV1 {
+    readonly formatVersion: 1;
+    readonly pages: readonly Fingerprint[];
+    readonly searchSha256: string;
+}
+export interface SearchSectionV1 {
+    readonly pageId: string;
+    readonly title: string;
+    readonly headingTrail: readonly string[];
+    readonly startLine: number;
+    readonly sourceIds: readonly string[];
+    readonly normalizedText: string;
+    readonly length: number;
+    readonly titleTermFrequencies: readonly TermCount[];
+    readonly headingTermFrequencies: readonly TermCount[];
+    readonly bodyTermFrequencies: readonly TermCount[];
+}
+export interface SearchIndexV1 {
+    readonly formatVersion: 1;
+    readonly pageFingerprints: readonly Fingerprint[];
+    readonly documentCount: number;
+    readonly averageSectionLength: number;
+    readonly documentFrequencies: readonly TermCount[];
+    readonly sections: readonly SearchSectionV1[];
+}
+export interface SearchOptions {
+    readonly limit: number;
+    readonly maxResults: number;
+    readonly maxSnippetBytes: number;
+    readonly signal?: AbortSignal;
+}
+export interface BuiltIndex {
+    readonly state: IndexStateV1;
+    readonly search: SearchIndexV1;
+    readonly stateBytes: Uint8Array;
+    readonly searchBytes: Uint8Array;
+}
+export interface IndexPage {
+    readonly pageId: string;
+    readonly bytes: Uint8Array;
+    readonly title: string;
+    readonly sourceIds: readonly string[];
+    readonly body: string;
+    readonly bodyStartLine: number;
+}
+export declare function parseSearchIndex(bytes: Uint8Array): SearchIndexV1;
+export declare function parseIndexState(bytes: Uint8Array): IndexStateV1;
+export declare function fingerprintPages(paths: WikiPaths, signal?: AbortSignal, root?: WikiDirectory): Promise<readonly Fingerprint[]>;
+export declare function buildSearchIndexFromPages(pages: readonly IndexPage[]): BuiltIndex;
+export declare function buildSearchIndex(paths: WikiPaths, signal?: AbortSignal, onPageExamined?: (path: string) => void, root?: WikiDirectory): Promise<BuiltIndex>;
+export declare function trustedSearchIndex(searchBytes: Uint8Array, stateBytes: Uint8Array, expected: BuiltIndex): SearchIndexV1 | null;
+export declare function validateBuiltIndexSnapshot(paths: WikiPaths, built: BuiltIndex, signal?: AbortSignal, root?: WikiDirectory): Promise<void>;
+export declare function writeIndex(paths: WikiPaths, built: BuiltIndex, signal?: AbortSignal, root?: WikiDirectory): Promise<void>;
+export declare function ensureSearchIndex(paths: WikiPaths, signal?: AbortSignal, root?: WikiDirectory): Promise<SearchIndexV1>;
+export declare function searchBuiltIndex(index: SearchIndexV1, query: string, options: SearchOptions): readonly SearchHit[];
+export declare function searchWiki(paths: WikiPaths, query: string, options: SearchOptions, root?: WikiDirectory): Promise<readonly SearchHit[]>;
+export {};
+//# sourceMappingURL=indexer.d.ts.map

package/lib/types/indexer.d.ts.map

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

package/lib/types/lint.d.ts

@@ -0,0 +1,8 @@
+import type { WikiDirectory, WikiPaths } from './paths.ts';
+import type { LintReport } from './types.ts';
+export declare const LINT_DIAGNOSTIC_CODES: readonly ["ROOT_MISSING", "ROOT_NOT_DIRECTORY", "UNSAFE_SYMLINK", "REQUIRED_DIRECTORY_MISSING", "REQUIRED_PATH_NOT_DIRECTORY", "SCHEMA_MISSING", "INVALID_UTF8", "SOURCE_INVALID_ID", "SOURCE_CONTENT_MISSING", "SOURCE_CONTENT_NOT_FILE", "SOURCE_HASH_MISMATCH", "SOURCE_METADATA_MISSING", "SOURCE_METADATA_NOT_FILE", "SOURCE_METADATA_MALFORMED", "SOURCE_METADATA_INVALID", "SOURCE_METADATA_UNKNOWN_KEY", "SOURCE_METADATA_ID_MISMATCH", "SOURCE_METADATA_BYTE_COUNT_MISMATCH", "SOURCE_UNREFERENCED", "PAGE_INVALID_PATH", "PAGE_INVALID_MARKDOWN", "PAGE_MISSING_SOURCE", "DUPLICATE_TITLE", "ORPHAN_PAGE", "LINK_ESCAPES_PAGES", "BROKEN_PAGE_LINK", "INDEX_MISSING", "INDEX_MALFORMED", "INDEX_INCOMPATIBLE", "INDEX_STALE", "TEMP_FILE_ABANDONED"];
+export type LintDiagnosticCode = (typeof LINT_DIAGNOSTIC_CODES)[number];
+export declare function lintRootFailure(paths: WikiPaths, cause: unknown): LintReport;
+export declare function lintWiki(paths: WikiPaths, signal?: AbortSignal, root?: WikiDirectory | null): Promise<LintReport>;
+export declare function serializeLintReport(report: LintReport): string;
+//# sourceMappingURL=lint.d.ts.map

package/lib/types/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/lint.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC1D,OAAO,KAAK,EAAkB,UAAU,EAAgC,MAAM,YAAY,CAAA;AAE1F,eAAO,MAAM,qBAAqB,guBAgCxB,CAAA;AAEV,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA;AAuYvE,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,CAQ5E;AAED,wBAAsB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CA4CvH;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAE9D"}

package/lib/types/markdown.d.ts

@@ -0,0 +1,17 @@
+import type { PageMetadata } from './types.ts';
+export interface ParsedPageMarkdown {
+    readonly metadata: PageMetadata;
+    readonly body: string;
+    readonly bodyStartLine: number;
+}
+export interface MarkdownSection {
+    readonly headingTrail: readonly string[];
+    readonly startLine: number;
+    readonly text: string;
+}
+export declare function encodeUtf8(text: string): Uint8Array;
+export declare function decodeUtf8(bytes: Uint8Array): string;
+export declare function parsePageMarkdown(markdown: string): ParsedPageMarkdown;
+export declare function renderPageMarkdown(metadata: PageMetadata, body: string): string;
+export declare function splitMarkdownSections(body: string, firstLine?: number): readonly MarkdownSection[];
+//# sourceMappingURL=markdown.d.ts.map

package/lib/types/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/markdown.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAU9C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAEnD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMpD;AA6GD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAatE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB/E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,SAAS,eAAe,EAAE,CAmD7F"}

package/lib/types/paths.d.ts

@@ -0,0 +1,92 @@
+import { type BigIntStats } from 'node:fs';
+import { type FileHandle } from 'node:fs/promises';
+import { LlmWikiError } from './errors.ts';
+import type { PageId, SourceId } from './ids.ts';
+import { type AtomicWriteOptions } from './atomic.ts';
+/** Keep shared descriptors alive until every started sibling settles, preserving the first failure. */
+export declare function allSettledOnFailure<const T extends readonly unknown[]>(values: T): Promise<{
+    -readonly [P in keyof T]: Awaited<T[P]>;
+}>;
+export interface DirectoryIdentity {
+    readonly dev: bigint;
+    readonly ino: bigint;
+}
+export interface WikiAuthority {
+    readonly root: string;
+    identity?: DirectoryIdentity;
+}
+export interface EntrySnapshot {
+    readonly name: string;
+    readonly segments: readonly string[];
+    readonly stat: BigIntStats;
+}
+export type FileSnapshot = EntrySnapshot;
+/** Diagnostic metadata only; never authorizes a retry or pathname access. */
+export declare class WikiTraversalError extends LlmWikiError {
+    readonly segments: readonly string[];
+    readonly entryKind: 'symlink' | 'not-directory' | 'unknown';
+    constructor(segments: readonly string[], entryKind: 'symlink' | 'not-directory' | 'unknown', cause: unknown);
+}
+export interface WikiPaths {
+    readonly authority: WikiAuthority;
+    readonly root: string;
+    readonly schema: string;
+    readonly sources: string;
+    readonly pages: string;
+    readonly index: string;
+    sourceDirectory(id: SourceId): string;
+    sourceContent(id: SourceId): string;
+    sourceMetadata(id: SourceId): string;
+    page(id: PageId): string;
+    indexFile(name: 'search.json' | 'state.json'): string;
+}
+export declare function validateComponent(name: string): void;
+export declare function sameFileSnapshot(a: BigIntStats, b: BigIntStats): boolean;
+export declare class WikiDirectory {
+    private readonly handle;
+    readonly segments: readonly string[];
+    private readonly operationRoot?;
+    private readonly publication;
+    constructor(handle: FileHandle, segments: readonly string[], operationRoot?: WikiDirectory | undefined, publication?: {
+        committed: boolean;
+    });
+    /** Internal commit boundary used by the atomic adapter, including ancestor cleanup. */
+    markCommitted(): void;
+    /** Internal filesystem adapter seam. Only atomic.ts may use descriptor aliases. */
+    withHandle<T>(callback: (handle: FileHandle, alias: string) => Promise<T>): Promise<T>;
+    private child;
+    identity(): Promise<DirectoryIdentity>;
+    inspect(name: string, signal?: AbortSignal): Promise<BigIntStats | null>;
+    directory<T>(segments: readonly string[], options: {
+        create?: boolean;
+        signal?: AbortSignal | undefined;
+    }, callback: (directory: WikiDirectory) => Promise<T>): Promise<T | null>;
+    read(name: string, signal?: AbortSignal): Promise<{
+        bytes: Buffer;
+        snapshot: FileSnapshot;
+    } | null>;
+    list(signal?: AbortSignal): Promise<readonly EntrySnapshot[]>;
+    validate(snapshot: EntrySnapshot, signal?: AbortSignal): Promise<boolean>;
+    createDirectory(name: string, signal?: AbortSignal): Promise<{
+        created: boolean;
+        identity: DirectoryIdentity;
+    }>;
+    createFileExclusive(name: string, bytes: Uint8Array, options?: {
+        mode?: number;
+        signal?: AbortSignal | undefined;
+    }): Promise<void>;
+    atomicWrite(name: string, bytes: Uint8Array, options?: AtomicWriteOptions): Promise<void>;
+    unlink(name: string, expectedIdentity?: DirectoryIdentity): Promise<void>;
+    removeCreatedSource(name: string, expectedIdentity: DirectoryIdentity, ownedNames: readonly string[]): Promise<void>;
+}
+export declare function withWikiRoot<T>(authority: WikiAuthority, options: {
+    create?: boolean;
+    signal?: AbortSignal | undefined;
+}, callback: (root: WikiDirectory) => Promise<T>): Promise<T | null>;
+export declare function wikiRelativeSegments(paths: WikiPaths, target: string): readonly string[];
+export declare function assertContainedWikiPath(root: string, target: string): void;
+export declare function createWikiPaths(root: string, authority?: WikiAuthority): WikiPaths;
+export declare function acquireWikiPaths(configuredRoot: string, signal?: AbortSignal, cwd?: string): Promise<WikiPaths>;
+export declare function initializeWikiPaths(configuredRoot: string, signal?: AbortSignal, cwd?: string): Promise<WikiPaths>;
+export declare function ensureWikiDirectory(paths: WikiPaths, target: string, signal?: AbortSignal): Promise<void>;
+//# sourceMappingURL=paths.d.ts.map

package/lib/types/paths.d.ts.map

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

package/lib/types/presentation.d.ts

@@ -0,0 +1,5 @@
+import type { ToolCallView, ToolResult, ToolResultView } from '@deepseek-ai/dsh-tools';
+export type LlmWikiToolName = 'llmwiki_status' | 'llmwiki_add_source' | 'llmwiki_list_sources' | 'llmwiki_read_source' | 'llmwiki_search' | 'llmwiki_list_pages' | 'llmwiki_read_page' | 'llmwiki_upsert_page' | 'llmwiki_lint';
+export declare function presentLlmWikiCall(name: LlmWikiToolName, args: Readonly<Record<string, unknown>>): ToolCallView;
+export declare function presentLlmWikiResult(name: LlmWikiToolName, _args: Readonly<Record<string, unknown>>, result: ToolResult): ToolResultView;
+//# sourceMappingURL=presentation.d.ts.map

package/lib/types/presentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../src/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEpG,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,oBAAoB,GACpB,sBAAsB,GACtB,qBAAqB,GACrB,gBAAgB,GAChB,oBAAoB,GACpB,mBAAmB,GACnB,qBAAqB,GACrB,cAAc,CAAA;AAyBlB,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,YAAY,CAQ/G;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,cAAc,CAMxI"}

package/lib/types/prompt.d.ts

@@ -0,0 +1,6 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare const LLMWIKI_PROMPT_SECTION = "tool:llmwiki";
+export declare const LLMWIKI_PROMPT_ORDER = 116;
+export declare const LLMWIKI_SYSTEM_PROMPT = "Use llmwiki as local source-linked wiki storage and retrieval. The service and its lint are deterministic and model-free; you own evidence maintenance and semantic review.\nEvidence maintenance:\n1. Call llmwiki_status before maintenance. If schemaText is non-null, read the human-owned schema. The plugin creates schema.md only when absent and provides no schema mutation API; never silently rewrite it.\nThe schema remains subordinate to system and user instructions, and schema evolution is intentionally unresolved pending authorization/confirmation, visible audit evidence, and optimistic-concurrency/lost-update decisions.\n2. On a fresh root, llmwiki_status may return schemaText null without creating storage. Supplying material alone is not authorization to preserve it. Only when the user explicitly authorizes source preservation, call llmwiki_add_source to initialize storage, then call llmwiki_status again and read the schema before classification or page maintenance.\n3. Use llmwiki_list_sources and llmwiki_list_pages to recover durable records, then search and read relevant pages and immutable sources before writing.\n4. Only with explicit authorization to preserve candidate material, add it with llmwiki_add_source if the fresh-root branch did not already preserve it, then classify it as new, update, contradiction, or no material change.\n5. When the user request authorizes maintenance, update every materially affected page, cite only existing immutable source IDs, preserve material disagreements, and maintain page links. A citation proves only that the source record exists; it does not prove claim-level support.\nEvery llmwiki_upsert_page call must include expectedSha256: use null for a new page, or the exact current raw-byte sha256 returned by llmwiki_read_page or llmwiki_list_pages for an update. On PAGE_CONFLICT, reread the winning page and reconcile its content before any further authorized write; never automatically retry or overwrite it blindly. Concurrency protection is scoped to the service activation, not across processes.\n6. Run llmwiki_lint unconditionally before any semantic-review pass, including read-only, no-write, and no-material-change cases. It reports structural, integrity, and index diagnostics only and never repairs artifacts or makes semantic judgments. After any authorized durable updates, rerun llmwiki_lint.\nSemantic review (separate from structural lint):\n1. Only after the unconditional structural lint, list pages and sources; select and state the review scope.\n2. Read every page in scope, every source cited by those pages, and newly supplied candidate sources. Compare dated and qualified claims.\n3. Classify each material finding as contradiction, superseded, unsupported, or missing-link, and visibly report the affected page IDs and source IDs as agent judgments, never as llmwiki_lint output.\n4. Only when the user request authorizes maintenance, update affected pages while preserving both sides of a disagreement or recording a clearly dated supersession, then maintain links and rerun structural lint.";
+export declare function registerLlmWikiPrompt(ctx: Context): void;
+//# sourceMappingURL=prompt.d.ts.map

package/lib/types/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,eAAO,MAAM,sBAAsB,iBAAiB,CAAA;AACpD,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAIvC,eAAO,MAAM,qBAAqB,shGAckL,CAAA;AAEpN,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAMxD"}

package/lib/types/service.d.ts

@@ -0,0 +1,39 @@
+import { Service } from '@deepseek-ai/cordis';
+import type { Context } from '@deepseek-ai/cordis';
+import { Config as ConfigSchema } from './config.ts';
+import type { Config, ResolvedConfig } from './config.ts';
+import type { PageId, SourceId } from './ids.ts';
+import type { AddSourceInput, ByteRange, CatalogRequest, LintReport, PageCatalogPage, PageRead, PageReceipt, ReindexReceipt, SearchHit, SourceCatalogPage, SourceRead, SourceReceipt, UpsertPageInput, WikiStatus } from './types.ts';
+declare const configKey: unique symbol;
+export declare class LlmWikiService extends Service {
+    static Config: Schemastery<ConfigSchema, ResolvedConfig>;
+    private readonly [configKey];
+    private pathsValue;
+    private queue;
+    private readonly queued;
+    private disposed;
+    constructor(ctx: Context, config?: Config);
+    private enqueue;
+    private initialize;
+    status(signal?: AbortSignal): Promise<WikiStatus>;
+    addSource(input: AddSourceInput, signal?: AbortSignal): Promise<SourceReceipt>;
+    readSource(id: SourceId, range?: ByteRange, signal?: AbortSignal): Promise<SourceRead>;
+    listSources(request?: CatalogRequest, signal?: AbortSignal): Promise<SourceCatalogPage>;
+    listPages(request?: CatalogRequest, signal?: AbortSignal): Promise<PageCatalogPage>;
+    private readSourceRecord;
+    readPage(id: PageId, signal?: AbortSignal): Promise<PageRead>;
+    upsertPage(input: UpsertPageInput, signal?: AbortSignal): Promise<PageReceipt>;
+    lint(signal?: AbortSignal): Promise<LintReport>;
+    search(query: string, limitValue?: number, signal?: AbortSignal): Promise<SearchHit[]>;
+    reindex(signal?: AbortSignal): Promise<ReindexReceipt>;
+    private indexTargetPresence;
+    private ensureIndex;
+    private indexStatus;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        llmwiki: LlmWikiService;
+    }
+}
+export {};
+//# sourceMappingURL=service.d.ts.map

package/lib/types/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../src/service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,MAAM,IAAI,YAAY,EAAiB,MAAM,aAAa,CAAA;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIzD,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAiBhD,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,cAAc,EAEd,UAAU,EAEV,eAAe,EACf,QAAQ,EACR,WAAW,EACX,cAAc,EACd,SAAS,EAET,iBAAiB,EAEjB,UAAU,EACV,aAAa,EACb,eAAe,EACf,UAAU,EACX,MAAM,YAAY,CAAA;AAyUnB,QAAA,MAAM,SAAS,EAAE,OAAO,MAAiC,CAAA;AAEzD,qBAAa,cAAe,SAAQ,OAAO;IACzC,MAAM,CAAC,MAAM,4CAAe;IAE5B,OAAO,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,CAAgB;IAC5C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2C;IAClE,OAAO,CAAC,QAAQ,CAAQ;gBAEZ,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,MAAW;IAa7C,OAAO,CAAC,OAAO;YAwDD,UAAU;IAkBlB,MAAM,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA4BjD,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IA2F9E,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IActF,WAAW,CAAC,OAAO,GAAE,cAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoE3F,SAAS,CAAC,OAAO,GAAE,cAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;YAyD/E,gBAAgB;IAkCxB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmB7D,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IAgC9E,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,SAA6B,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAoB1G,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC;YAc9C,mBAAmB;YAQnB,WAAW;YAqBX,WAAW;CAsC1B;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,OAAO,EAAE,cAAc,CAAA;KACxB;CACF"}

package/lib/types/tokenizer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tokenizes normalized text deterministically. CJK-only runs are retained as a
+ * token and, when longer than one code point, additionally produce overlapping
+ * two-code-point grams. Mixed/non-CJK letter-number runs are emitted whole.
+ */
+export declare function tokenize(value: string): readonly string[];
+/** Visits existing tokens in normalized text; offsets are UTF-16 slice boundaries. */
+export declare function visitNormalizedTokenSpans(text: string, visit: (term: string, start: number, end: number) => void): void;
+//# sourceMappingURL=tokenizer.d.ts.map

package/lib/types/tokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../src/tokenizer.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAIzD;AAED,sFAAsF;AACtF,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAevH"}

package/lib/types/tools.d.ts

@@ -0,0 +1,3 @@
+import type { Context } from '@deepseek-ai/cordis';
+export declare function registerLlmWikiTools(ctx: Context): void;
+//# sourceMappingURL=tools.d.ts.map

package/lib/types/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AA+ClD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAiNvD"}

package/lib/types/types.d.ts

@@ -0,0 +1,123 @@
+import type { PageId, SourceId } from './ids.ts';
+export interface IndexStatus {
+    readonly present: boolean;
+    readonly fresh: boolean;
+    readonly formatVersion: number | null;
+    readonly sectionCount: number;
+}
+export interface ReindexReceipt {
+    readonly pageCount: number;
+    readonly sectionCount: number;
+    readonly formatVersion: number;
+}
+export interface WikiStatus {
+    readonly initialized: boolean;
+    readonly sourceCount: number;
+    readonly pageCount: number;
+    readonly schemaText: string | null;
+    readonly index: IndexStatus;
+}
+export interface AddSourceInput {
+    readonly name: string;
+    readonly content: string;
+    readonly mediaType?: string;
+    readonly origin?: string;
+}
+export interface SourceMetadata {
+    readonly id: SourceId;
+    readonly name: string;
+    readonly mediaType: string;
+    readonly byteCount: number;
+    readonly capturedAt: string;
+    readonly origin?: string;
+}
+export interface SourceReceipt {
+    readonly id: SourceId;
+    readonly deduplicated: boolean;
+    readonly metadata: SourceMetadata;
+}
+export interface ByteRange {
+    readonly offset: number;
+    readonly limit: number;
+}
+export interface SourceRead {
+    readonly id: SourceId;
+    readonly content: string;
+    readonly metadata: SourceMetadata;
+    readonly byteStart: number;
+    readonly byteEnd: number;
+    readonly byteCount: number;
+}
+export interface CatalogRequest {
+    readonly limit?: number;
+    readonly cursor?: string;
+}
+export interface SourceCatalogEntry {
+    readonly id: SourceId;
+    readonly name: string;
+    readonly mediaType: string;
+    readonly byteCount: number;
+    readonly capturedAt: string;
+    readonly origin?: string;
+}
+export interface SourceCatalogPage {
+    readonly items: readonly SourceCatalogEntry[];
+    readonly nextCursor: string | null;
+}
+export interface PageCatalogEntry {
+    readonly id: PageId;
+    readonly title: string;
+    readonly summary: string;
+    readonly sources: readonly SourceId[];
+    readonly byteCount: number;
+    readonly sha256: string;
+}
+export interface PageCatalogPage {
+    readonly items: readonly PageCatalogEntry[];
+    readonly nextCursor: string | null;
+}
+export interface PageMetadata {
+    readonly title: string;
+    readonly summary: string;
+    readonly sources: readonly SourceId[];
+}
+export interface PageRead {
+    readonly id: PageId;
+    readonly markdown: string;
+    readonly metadata: PageMetadata;
+    readonly sha256: string;
+}
+export interface UpsertPageInput extends PageMetadata {
+    readonly id: PageId;
+    readonly body: string;
+    readonly expectedSha256: string | null;
+}
+export interface PageReceipt {
+    readonly id: PageId;
+    readonly created: boolean;
+    readonly sha256: string;
+}
+export interface SearchHit {
+    readonly pageId: PageId;
+    readonly title: string;
+    readonly headingTrail: readonly string[];
+    readonly startLine: number;
+    readonly score: number;
+    readonly snippet: string;
+    readonly sourceIds: readonly SourceId[];
+}
+export type LintSeverity = 'error' | 'warning';
+export interface LintDiagnostic {
+    readonly code: string;
+    readonly severity: LintSeverity;
+    readonly path: string;
+    readonly line?: number;
+    readonly message: string;
+}
+export interface LintReport {
+    readonly diagnostics: readonly LintDiagnostic[];
+    readonly errorCount: number;
+    readonly warningCount: number;
+    readonly filesExamined: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/types.d.ts.map

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