context-eng 0.1.0

package/dist/engine.d.ts

@@ -0,0 +1,149 @@
+import { type Category, type Scope } from "./categories.js";
+import { type MapIndex } from "./map.js";
+import { type Layout } from "./paths.js";
+import { EngineError, budgetHits, sortHits, type SearchDebugSnapshot, type SearchInput, type SearchResult } from "./search.js";
+export { EngineError, budgetHits, sortHits };
+export type { EngineErrorCode, ListFilter, MatchMode, SearchFilters, SearchHints, SearchHit, SearchInput, SearchResult, SearchSort, TimeFilter } from "./search.js";
+export interface Memory {
+    id: string;
+    scope: Scope;
+    category: Category;
+    content: string;
+    subject?: string;
+    topics: string[];
+    tags: string[];
+    links: string[];
+    importance: number;
+    staging: boolean;
+    active: boolean;
+    tokens: number;
+    created_at: number;
+    updated_at: number;
+}
+export interface CreateInput {
+    scope: Scope;
+    category: Category;
+    confirmNewCategory?: boolean;
+    content: string;
+    subject?: string;
+    topics?: string[];
+    tags?: string[];
+    links?: string[];
+    importance?: number;
+}
+export interface CreateResult {
+    memory: Memory;
+    promoted: boolean;
+    projectPath?: string;
+    projectKey?: string;
+}
+export interface BindResult {
+    projectPath: string;
+    projectKey: string;
+    created: boolean;
+    maps: {
+        global: string;
+        project: string;
+    };
+}
+export interface CategoryListResult {
+    global?: string[];
+    project?: {
+        projectPath: string;
+        categories: string[];
+    };
+}
+export interface MemoryMapResult {
+    global: MapIndex;
+    project?: MapIndex;
+}
+export interface EditInput {
+    content?: string;
+    category?: Category;
+    confirmNewCategory?: boolean;
+    subject?: string | null;
+    topics?: string[];
+    tags?: string[];
+    links?: string[];
+    importance?: number;
+}
+export interface EngineOptions {
+    projectPath?: string;
+    home?: string;
+    deferProject?: boolean;
+}
+export declare class Engine {
+    private readonly globalLayout;
+    private projectLayout;
+    private readonly globalCatalog;
+    private projectCatalog;
+    private readonly categoryDbs;
+    constructor(opts?: EngineOptions);
+    get layout(): Layout;
+    get projectPath(): string | undefined;
+    get globalMapPath(): string;
+    get projectMapPath(): string;
+    close(): void;
+    bind(projectPath: string): BindResult;
+    create(input: CreateInput): CreateResult;
+    edit(currentCategory: Category, id: string, patch: EditInput): Memory;
+    get(category: Category, id: string): Memory;
+    promote(category: Category, target: string | {
+        id?: string;
+        line?: string;
+    }): Memory;
+    demote(category: Category, target: string | {
+        id?: string;
+        line?: string;
+    }): Memory;
+    delete(category: Category, target: string | {
+        id?: string;
+        line?: string;
+    }): {
+        id: string;
+        deleted: true;
+    };
+    /** Candidates for Jev: exhaustive for small notebooks, bounded signals plus fill for large notebooks. */
+    prepareSearch(input: SearchInput): SearchResult;
+    /** Raw selection data for diagnostics; formatting and relevance decisions stay outside Engine. */
+    prepareSearchDebug(input: SearchInput): SearchDebugSnapshot;
+    /** Complete local fallback: lexical and exact-label candidates plus final sorting and read budget. */
+    search(input: SearchInput): SearchResult;
+    private runSearch;
+    private resolveSearch;
+    map(): MemoryMapResult;
+    map(scope: "global"): {
+        global: MapIndex;
+    };
+    map(scope: "project"): {
+        project: MapIndex;
+    };
+    listCategoryNames(scope?: Scope): CategoryListResult;
+    refreshMaps(): {
+        global: MapIndex;
+        project: MapIndex;
+    };
+    listStaging(scope: Scope, category?: Category): Memory[];
+    categoryDatabasePath(scope: Scope, category: Category): string;
+    private searchAccess;
+    private mapSources;
+    private refreshGlobalMap;
+    private refreshAvailableMaps;
+    private openProject;
+    private closeProject;
+    private catalogFor;
+    private categoriesDir;
+    private recordFor;
+    private requireRecord;
+    private ensureCategory;
+    private dbForRecord;
+    private dbCacheKey;
+    private locate;
+    private locateSelector;
+    private locateByLine;
+    private setChatLocated;
+    private moveRow;
+    private migrateScope;
+    private bindResult;
+    private requireProjectLayout;
+}