pi-para 0.6.0 → 0.6.2

package/dist/frontmatter.js

@@ -0,0 +1,170 @@
+/**
+ * YAML frontmatter parsing and serialization for wiki pages.
+ *
+ * Handles the `---\n...\n---` frontmatter block in markdown files.
+ * Uses the `yaml` package for robust parsing. Preserves unknown fields.
+ */
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+// -- Schema versioning -------------------------------------------------------
+/** Current schema version. Bump when frontmatter/body format changes. */
+export const CURRENT_SCHEMA_VERSION = 1;
+/**
+ * Registry of all schema migrations, ordered by `from` version.
+ * Empty while CURRENT_SCHEMA_VERSION = 1 — add entries when bumping.
+ */
+export const MIGRATIONS = [];
+/**
+ * Apply all applicable migrations to bring a page up to CURRENT_SCHEMA_VERSION.
+ *
+ * Chains migrations sequentially: 1→2, 2→3, etc.
+ * If `schemaVersion` is already >= CURRENT_SCHEMA_VERSION, returns as-is (no downgrade).
+ * If `schemaVersion` is missing, defaults to 1.
+ */
+export function migrateToLatest(fm, body) {
+    let version = typeof fm.schemaVersion === "number" ? fm.schemaVersion : 1;
+    // Don't downgrade pages ahead of current version
+    if (version >= CURRENT_SCHEMA_VERSION) {
+        return { fm: { ...fm, schemaVersion: version }, body };
+    }
+    let currentFm = { ...fm };
+    let currentBody = body;
+    while (version < CURRENT_SCHEMA_VERSION) {
+        const migration = MIGRATIONS.find((m) => m.from === version);
+        if (!migration) {
+            // No migration path — stop at current version
+            break;
+        }
+        const result = migration.migrate(currentFm, currentBody);
+        currentFm = result.fm;
+        currentBody = result.body;
+        version = migration.to;
+    }
+    currentFm.schemaVersion = version;
+    return { fm: currentFm, body: currentBody };
+}
+const VALID_PARA_CATEGORIES = new Set([
+    "projects",
+    "areas",
+    "resources",
+    "archives",
+]);
+const FRONTMATTER_REGEX = /^---\n([\s\S]*?)\n?---\n?([\s\S]*)$/;
+// -- Functions ---------------------------------------------------------------
+/**
+ * Parse YAML frontmatter from markdown content.
+ *
+ * Expects content starting with `---\n...\n---`. If no frontmatter block
+ * is found, returns default frontmatter and the entire content as body.
+ * If the YAML is malformed, throws with a descriptive error.
+ */
+export function parseFrontmatter(content) {
+    const match = content.match(FRONTMATTER_REGEX);
+    if (!match) {
+        return {
+            frontmatter: validateFrontmatter({}),
+            body: content,
+        };
+    }
+    const rawYaml = match[1];
+    const body = match[2];
+    let parsed;
+    try {
+        parsed = parseYaml(rawYaml);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`Malformed YAML frontmatter: ${msg}`);
+    }
+    if (parsed == null || typeof parsed !== "object") {
+        return {
+            frontmatter: validateFrontmatter({}),
+            body,
+        };
+    }
+    return {
+        frontmatter: validateFrontmatter(parsed),
+        body,
+    };
+}
+/**
+ * Serialize frontmatter and body back to a markdown string with YAML
+ * frontmatter block.
+ */
+export function serializeFrontmatter(frontmatter, body) {
+    // Always write the current schema version on serialize
+    const fmWithVersion = { ...frontmatter, schemaVersion: CURRENT_SCHEMA_VERSION };
+    const yaml = stringifyYaml(fmWithVersion, { lineWidth: 0 }).trimEnd();
+    return `---\n${yaml}\n---\n${body}`;
+}
+/**
+ * Validate and normalize a raw frontmatter object into a PageFrontmatter.
+ *
+ * Required field: `title` (defaults to "Untitled" if missing).
+ * All other fields get sensible defaults. Unknown fields are preserved.
+ */
+export function validateFrontmatter(fm) {
+    const now = new Date().toISOString();
+    const title = typeof fm.title === "string" && fm.title.length > 0
+        ? fm.title
+        : "Untitled";
+    const para = validateParaCategory(fm.para);
+    const scope = toStringArray(fm.scope);
+    const tags = toStringArray(fm.tags);
+    const sources = toStringArray(fm.sources);
+    const links = toStringArray(fm.links);
+    const created = typeof fm.created === "string" && fm.created.length > 0
+        ? fm.created
+        : now;
+    const updated = typeof fm.updated === "string" && fm.updated.length > 0
+        ? fm.updated
+        : now;
+    const schemaVersion = typeof fm.schemaVersion === "number" ? fm.schemaVersion : 1;
+    // Build result with known fields first, then spread unknown fields underneath.
+    // Known fields override any unknown fields with the same name.
+    const knownKeys = new Set([
+        "title",
+        "para",
+        "scope",
+        "tags",
+        "sources",
+        "created",
+        "updated",
+        "links",
+        "schemaVersion",
+    ]);
+    const unknownFields = {};
+    for (const [key, value] of Object.entries(fm)) {
+        if (!knownKeys.has(key)) {
+            unknownFields[key] = value;
+        }
+    }
+    return {
+        ...unknownFields,
+        title,
+        para,
+        scope,
+        tags,
+        sources,
+        created,
+        updated,
+        links,
+        schemaVersion,
+    };
+}
+// -- Helpers -----------------------------------------------------------------
+function validateParaCategory(value) {
+    if (typeof value === "string" && VALID_PARA_CATEGORIES.has(value)) {
+        return value;
+    }
+    return "resources";
+}
+function toStringArray(value) {
+    if (Array.isArray(value)) {
+        return value.filter((v) => typeof v === "string");
+    }
+    if (typeof value === "string") {
+        return [value];
+    }
+    return [];
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * pi-para — PARA Knowledge Base Extension for pi
+ *
+ * Main extension entry point. Wires together wiki filesystem, qmd store,
+ * scope detection, context injection, tools, and commands.
+ *
+ * Session capture and maintenance are coordinated by an in-process scheduler.
+ * Completed-session registry entries are kept as a durable catch-up queue.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export type { ParaCategory, WikiPage, PageFrontmatter, PageRef, LogEntry } from "./wiki.js";
+export type { WikiSearchOptions, WikiSearchResult } from "./store.js";
+export type { ProjectScope, ScopeConfig } from "./scope.js";
+export type { IngestOptions, IngestReport, IngestResult } from "./ingest.js";
+export type { QueryOptions, QueryResult } from "./query.js";
+export type { LintOptions, LintReport, LintIssue, WikiStats } from "./lint.js";
+export type { ContextOptions } from "./context.js";
+export type { RawSource, SessionDigest } from "./raw.js";
+export type { SummarizeOptions } from "./summarize.js";
+export default function piPara(pi: ExtensionAPI): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iCAAiC,CAAC;AAuBtF,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC/E,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA2HvD,wBAA8B,MAAM,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAiRpE"}

package/dist/index.js

@@ -0,0 +1,357 @@
+/**
+ * pi-para — PARA Knowledge Base Extension for pi
+ *
+ * Main extension entry point. Wires together wiki filesystem, qmd store,
+ * scope detection, context injection, tools, and commands.
+ *
+ * Session capture and maintenance are coordinated by an in-process scheduler.
+ * Completed-session registry entries are kept as a durable catch-up queue.
+ */
+import { join } from "node:path";
+import { homedir, networkInterfaces } from "node:os";
+import { detectScope } from "./scope.js";
+import { initWiki } from "./wiki.js";
+import { openStore, closeStore } from "./store.js";
+import { registerTools } from "./tools.js";
+import { setupContextInjection, markContextDirty } from "./context.js";
+import { registerCommands } from "./commands.js";
+import { createServer } from "node:http";
+import { startWikiScheduler, stopWikiScheduler } from "./scheduler/index.js";
+import { appendCompletedSession, createCaptureSessionHandler, enqueueCompletedSessionsFromRegistry, } from "./scheduler/session-capture.js";
+import { loadParaConfig, toLegacyRuntimeConfig } from "./config.js";
+import { createModelApiKeyResolver, createPiModelRegistry, getCaptureSelection, resolveSelectedModel } from "./model-resolver.js";
+import { StateDB } from "./state.js";
+function getDefaultConfig() {
+    return {
+        wikiDir: join(homedir(), ".pi", "wiki"),
+        contextMaxTokens: 4000,
+        contextIncludeSchema: true,
+        contextIncludeIndex: true,
+        lintAutoFix: true,
+        lintStaleDays: 90,
+        searchLimit: 10,
+        searchIncludeArchives: false,
+        searchGraphBoost: true,
+        daemonModel: null,
+        webWiki: {
+            enabled: false,
+            host: "0.0.0.0",
+            port: 10973,
+        },
+    };
+}
+async function loadConfig() {
+    try {
+        const loaded = await loadParaConfig({ migrate: true });
+        const runtime = toLegacyRuntimeConfig(loaded.config);
+        return {
+            runtime,
+            userConfig: loaded.config,
+            secretsPath: loaded.paths.secretsPath,
+        };
+    }
+    catch {
+        return { runtime: getDefaultConfig(), userConfig: null, secretsPath: null };
+    }
+}
+// -- LAN IP detection --------------------------------------------------------
+/** Check if the optional web wiki server is alive on the given port. */
+function checkWebServerAlive(port) {
+    return new Promise((resolve) => {
+        const req = createServer().listen(port, "127.0.0.1");
+        req.on("error", (err) => {
+            req.close();
+            // EADDRINUSE means something is already listening — daemon is running
+            resolve(err.code === "EADDRINUSE");
+        });
+        req.on("listening", () => {
+            // Port is free — no daemon web server
+            req.close();
+            resolve(false);
+        });
+    });
+}
+function isPrintModeProcess(argv = process.argv) {
+    return argv.includes("-p") || argv.includes("--print") || argv.includes("--mode") && argv[argv.indexOf("--mode") + 1] === "json";
+}
+function getLanIp() {
+    const interfaces = networkInterfaces();
+    for (const name of Object.keys(interfaces)) {
+        const addrs = interfaces[name];
+        if (!addrs)
+            continue;
+        for (const addr of addrs) {
+            if (addr.family === "IPv4" && !addr.internal) {
+                return addr.address;
+            }
+        }
+    }
+    return null;
+}
+const ENTRY_TYPE = "pi-para-state";
+function reconstructState(ctx) {
+    let latest = null;
+    for (const entry of ctx.sessionManager.getBranch()) {
+        if (entry.type === "custom" && entry.customType === ENTRY_TYPE) {
+            latest = entry.data;
+        }
+    }
+    return latest;
+}
+// -- Extension entry point ---------------------------------------------------
+export default async function piPara(pi) {
+    const loadedConfig = await loadConfig();
+    const config = loadedConfig.runtime;
+    const wikiDir = config.wikiDir;
+    let store = null;
+    let currentScope = null;
+    let storeDisabled = false;
+    const getScope = () => {
+        if (!currentScope) {
+            return { name: "unknown", include: ["unknown"], exclude: [], source: "dirname" };
+        }
+        return currentScope;
+    };
+    const setScope = (scope) => {
+        currentScope = scope;
+        markContextDirty();
+        pi.appendEntry(ENTRY_TYPE, {
+            lastScope: scope,
+            sessionFile: null,
+        });
+    };
+    const getConfig = () => ({
+        contextMaxTokens: config.contextMaxTokens,
+        contextIncludeSchema: config.contextIncludeSchema,
+        contextIncludeIndex: config.contextIncludeIndex,
+    });
+    // Lazy retry: if the store failed at startup, try reopening on first tool use.
+    // This handles cases where the db was temporarily locked or had transient errors.
+    let storeRetrying = false;
+    async function retryStoreOpen() {
+        if (storeRetrying)
+            return false;
+        storeRetrying = true;
+        try {
+            store = await openStore(wikiDir, {
+                paraConfig: loadedConfig.userConfig ?? undefined,
+                secretsPath: loadedConfig.secretsPath ?? undefined,
+                backgroundEmbed: false,
+            });
+            storeDisabled = false;
+            markContextDirty(); // rebuild context now that store works
+            return true;
+        }
+        catch {
+            return false;
+        }
+        finally {
+            storeRetrying = false;
+        }
+    }
+    // Store proxy — delegates to real store once opened, with lazy retry on failure
+    const storeProxy = new Proxy({}, {
+        get(_target, prop) {
+            if (!store) {
+                if (storeDisabled) {
+                    // Return an async function that retries opening the store first
+                    return async (...args) => {
+                        const reopened = await retryStoreOpen();
+                        if (reopened && store) {
+                            const method = store[prop];
+                            if (typeof method === "function") {
+                                return method.apply(store, args);
+                            }
+                            return method;
+                        }
+                        throw new Error("Wiki search is disabled: qmd store failed to open.");
+                    };
+                }
+                return (..._args) => {
+                    throw new Error("Wiki store not initialized yet.");
+                };
+            }
+            return store[prop];
+        },
+    });
+    // Register tools, context injection, commands
+    registerTools(pi, wikiDir, storeProxy, getScope, markContextDirty, () => config.searchGraphBoost);
+    setupContextInjection(pi, wikiDir, storeProxy, () => currentScope, getConfig);
+    registerCommands(pi, wikiDir, storeProxy, getScope, setScope);
+    // -- session_start ---------------------------------------------------------
+    pi.on("session_start", async (_event, ctx) => {
+        ctx.ui.setStatus("pi-para", "wiki: loading...");
+        try {
+            await initWiki(wikiDir);
+        }
+        catch (err) {
+            ctx.ui.notify(`Wiki init failed: ${err instanceof Error ? err.message : String(err)}`, "error");
+        }
+        ctx.ui.setStatus("pi-para", "wiki: indexing...");
+        storeDisabled = false;
+        try {
+            store = await openStore(wikiDir, {
+                paraConfig: loadedConfig.userConfig ?? undefined,
+                secretsPath: loadedConfig.secretsPath ?? undefined,
+                backgroundEmbed: false,
+            });
+        }
+        catch (err) {
+            store = null;
+            storeDisabled = true;
+            ctx.ui.notify(`Wiki search disabled: ${err instanceof Error ? err.message : String(err)}`, "warning");
+        }
+        currentScope = await detectScope(ctx.cwd);
+        const savedState = reconstructState(ctx);
+        if (savedState?.lastScope.source === "config") {
+            currentScope = savedState.lastScope;
+        }
+        pi.appendEntry(ENTRY_TYPE, {
+            lastScope: currentScope,
+            sessionFile: ctx.sessionManager.getSessionFile() ?? null,
+        });
+        const schedulerHandlers = {};
+        const schedulerConfig = loadedConfig.userConfig?.scheduler;
+        const wikiConfig = loadedConfig.userConfig?.wiki;
+        const autoCaptureEnabled = wikiConfig?.autoCapture !== false;
+        const startupCatchupEnabled = autoCaptureEnabled && wikiConfig?.captureOnStartup !== false && schedulerConfig?.startupCatchup !== false;
+        try {
+            const loadedParaConfig = await loadParaConfig({ migrate: true });
+            const registry = autoCaptureEnabled ? await createPiModelRegistry() : null;
+            if (registry) {
+                const captureSelection = getCaptureSelection(loadedParaConfig.config);
+                const captureModel = resolveSelectedModel(captureSelection, registry.modelRegistry, {
+                    legacyModelSpec: config.daemonModel,
+                    preferredModelSpec: "anthropic/claude-sonnet-4-20250514",
+                });
+                if (captureModel) {
+                    schedulerHandlers["capture-session"] = createCaptureSessionHandler({
+                        wikiDir,
+                        storeProvider: () => store,
+                        model: captureModel,
+                        getApiKey: createModelApiKeyResolver(captureSelection, registry.modelRegistry, {
+                            authStorage: registry.authStorage,
+                            secretsPath: loadedParaConfig.paths.secretsPath,
+                        }),
+                    });
+                }
+            }
+        }
+        catch {
+            // Capture handler registration is best-effort; manual capture remains available.
+        }
+        const embedEnabled = loadedConfig.userConfig?.qmd.embedEnabled !== false;
+        const schedulerEnabled = !isPrintModeProcess() && schedulerConfig?.enabled !== false;
+        const scheduler = schedulerEnabled
+            ? startWikiScheduler({
+                wikiDir,
+                enabled: true,
+                intervalMs: (schedulerConfig?.intervalMinutes ?? 15) * 60_000,
+                storeProvider: () => store,
+                markDirty: () => markContextDirty(),
+                handlers: schedulerHandlers,
+                embedEnabled,
+            })
+            : null;
+        // Drain any pre-existing embedding backlog in the background. Startup
+        // opens the store with backgroundEmbed:false (fast print-mode exits), so
+        // without this new pages stayed BM25-only until an explicit embed pass.
+        if (scheduler && embedEnabled && store) {
+            try {
+                scheduler.embedEnabled = true;
+                scheduler.enqueue("qmd-embed", {}, { dedupeKey: "qmd-embed", priority: 5 });
+                void scheduler.tick();
+            }
+            catch {
+                // Background embedding is best-effort; BM25 search works regardless.
+            }
+        }
+        if (scheduler && startupCatchupEnabled) {
+            try {
+                const stateDb = new StateDB(wikiDir);
+                await enqueueCompletedSessionsFromRegistry(scheduler, wikiDir, { stateDb });
+                stateDb.close();
+                void scheduler.tick();
+            }
+            catch {
+                // Startup capture catch-up is best-effort.
+            }
+        }
+        // Check if web wiki server is running (don't start our own yet)
+        if (config.webWiki.enabled) {
+            const port = config.webWiki.port;
+            try {
+                const alive = await checkWebServerAlive(port);
+                if (alive) {
+                    const lanIp = getLanIp();
+                    const url = lanIp ? `http://${lanIp}:${port}` : `http://localhost:${port}`;
+                    ctx.ui.setStatus("pi-para", `wiki: ${url}`);
+                }
+                else {
+                    ctx.ui.setStatus("pi-para", "wiki: ready (web UI disabled)");
+                    setTimeout(() => ctx.ui.setStatus("pi-para", undefined), 5000);
+                }
+            }
+            catch {
+                ctx.ui.setStatus("pi-para", "wiki: ready");
+                setTimeout(() => ctx.ui.setStatus("pi-para", undefined), 3000);
+            }
+        }
+        else {
+            ctx.ui.setStatus("pi-para", "wiki: ready");
+            setTimeout(() => ctx.ui.setStatus("pi-para", undefined), 3000);
+        }
+    });
+    // -- session_tree ----------------------------------------------------------
+    pi.on("session_tree", async (_event, ctx) => {
+        const savedState = reconstructState(ctx);
+        if (savedState?.lastScope.source === "config") {
+            currentScope = savedState.lastScope;
+        }
+        else {
+            currentScope = await detectScope(ctx.cwd);
+        }
+        markContextDirty();
+    });
+    // -- session_compact: register session for scheduler capture on compaction --
+    pi.on("session_compact", async (_event, ctx) => {
+        // Compaction means the session has accumulated enough content that details
+        // are about to be compressed/lost. Perfect time to capture knowledge.
+        const sessionFile = ctx.sessionManager.getSessionFile();
+        if (sessionFile) {
+            try {
+                await appendCompletedSession(wikiDir, sessionFile);
+                ctx.ui.setStatus("pi-para", "wiki: capture queued (compaction)");
+                setTimeout(() => ctx.ui.setStatus("pi-para", undefined), 5000);
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+    });
+    // -- session_shutdown: register session for scheduler, close store ---------
+    pi.on("session_shutdown", async (_event, ctx) => {
+        // 1. Register session as completed (scheduler catch-up processes later)
+        const sessionFile = ctx.sessionManager.getSessionFile();
+        if (sessionFile) {
+            try {
+                await appendCompletedSession(wikiDir, sessionFile);
+            }
+            catch {
+                // Non-fatal — startup catch-up can also discover sessions via filesystem scan
+            }
+        }
+        // 2. Stop scheduler and close the store (instant)
+        stopWikiScheduler(wikiDir);
+        if (store) {
+            try {
+                await closeStore(store);
+            }
+            catch {
+                // Non-fatal
+            }
+            store = null;
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/ingest.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Ingest pipeline — processes sources and integrates knowledge into the wiki.
+ *
+ * Resolves source content (URL, file, text), saves raw copy to the vault,
+ * and returns structured data for the caller (tool or standalone agent)
+ * to pass to the LLM for synthesis into wiki pages.
+ */
+import type { ParaCategory, PageRef, LogEntry } from "./wiki.js";
+import type { ProjectScope } from "./scope.js";
+export interface IngestOptions {
+    source: string;
+    sourceType?: "url" | "file" | "text";
+    scope?: string[];
+    category?: ParaCategory;
+}
+export interface IngestReport {
+    pagesCreated: PageRef[];
+    pagesUpdated: PageRef[];
+    logEntry: LogEntry;
+}
+/** Structure returned by LLM during ingest. */
+export interface IngestResult {
+    newPages: Array<{
+        category: ParaCategory;
+        slug: string;
+        title: string;
+        scope: string[];
+        tags: string[];
+        body: string;
+    }>;
+    updatedPages: Array<{
+        category: ParaCategory;
+        slug: string;
+        appendOrReplace: "append" | "replace";
+        body: string;
+    }>;
+    indexUpdate: string;
+    logSummary: string;
+}
+/** Resolved source data from the ingest pipeline. */
+export interface ResolvedSource {
+    /** Original source string (URL, path, or text) */
+    source: string;
+    /** Detected or explicit source type */
+    sourceType: "url" | "file" | "text";
+    /** Fetched/read source content */
+    content: string;
+    /** Path in raw/ vault (undefined for inline text) */
+    rawPath: string | undefined;
+    /** Schema.md content for LLM context */
+    schema: string;
+    /** Index.md content for LLM context */
+    index: string;
+    /** Scope tags to assign */
+    scopeTags: string[];
+    /** Scope name */
+    scopeName: string;
+    /** Category hint (if provided) */
+    categoryHint: ParaCategory | undefined;
+}
+/** Detect source type from the source string. */
+export declare function detectSourceType(source: string): "url" | "file" | "text";
+/** Fetch content from a URL. */
+export declare function fetchUrl(url: string): Promise<string>;
+/** Read content from a file path. */
+export declare function readFileSource(filePath: string): Promise<string>;
+/**
+ * Resolve a source and prepare it for LLM synthesis.
+ *
+ * This is the reusable library function. It:
+ * 1. Detects or uses the explicit source type
+ * 2. Fetches URL / reads file / uses text directly
+ * 3. Saves a raw copy to the vault (for non-text sources)
+ * 4. Reads schema.md and index.md for LLM context
+ * 5. Returns everything the caller needs to build an LLM prompt
+ *
+ * The caller (tool or standalone agent) assembles the prompt and
+ * passes it to the LLM, which calls wiki_write to create pages.
+ */
+export declare function resolveSource(wikiDir: string, options: IngestOptions, scope: ProjectScope): Promise<ResolvedSource>;
+/** Maximum source content length before truncation. */
+export declare const MAX_SOURCE_LENGTH = 50000;
+/**
+ * Truncate source content if it exceeds the limit.
+ * Returns the truncated content with a marker.
+ */
+export declare function truncateSource(content: string, maxLength?: number): string;
+//# sourceMappingURL=ingest.d.ts.map