pi-para 0.5.5 → 0.6.0

package/dist/wiki-tool-guidance.js

@@ -1,70 +0,0 @@
-export const WIKI_TOOL_DESCRIPTIONS = {
-    wiki_ingest: "Ingest a URL, file path, or raw text into the PARA wiki and save a raw source copy.",
-    wiki_query: "Search the PARA wiki with scope/category filters and freshness metadata.",
-    wiki_edit: "Atomically edit an existing wiki page with exact oldText→newText replacements.",
-    wiki_write: "Create new pages, append sections, or intentionally replace complete wiki pages.",
-    wiki_read: "Read index.md or a wiki page by path/title, including frontmatter and freshness metadata.",
-    wiki_move: "Move a wiki page between PARA categories and update frontmatter.",
-    wiki_lint: "Run wiki health checks and optionally auto-fix safe issues.",
-    wiki_migrate: "Batch-migrate all wiki pages to the current schema version.",
-    wiki_summarize: "Collect page/category/wiki content for an LLM-written summary.",
-};
-export const WIKI_TOOL_SNIPPETS = {
-    wiki_ingest: "Ingest a source into the PARA wiki.",
-    wiki_query: "Search the PARA wiki for relevant knowledge.",
-    wiki_edit: "Surgically edit an existing wiki page; every oldText must match exactly once.",
-    wiki_write: "Create/append/replace PARA wiki pages; prefer wiki_edit for surgical updates.",
-    wiki_read: "Read index.md or a wiki page and check freshness for page results.",
-    wiki_move: "Move a wiki page between PARA categories.",
-    wiki_lint: "Run wiki health checks and safe autofixes.",
-    wiki_migrate: "Batch-migrate wiki pages to the current schema.",
-    wiki_summarize: "Summarize wiki pages, categories, or the entire wiki.",
-};
-const TOOL_SPECIFIC_GUIDELINES = {
-    wiki_ingest: [
-        "Use wiki_ingest when the user provides a URL, file path, or text to add to the knowledge base.",
-        "After ingesting, synthesize durable knowledge with wiki_write/wiki_edit when the source contains reusable facts.",
-    ],
-    wiki_query: [
-        "Use wiki_query before answering questions that may depend on past architecture decisions, debugging history, conventions, or domain knowledge.",
-        "Use global=true only when the answer should search across project scopes.",
-    ],
-    wiki_edit: [
-        "Use wiki_edit after wiki_read when fixing stale, incorrect, or incomplete content.",
-        "Keep oldText as small as possible while still unique in the page body.",
-    ],
-    wiki_write: [
-        "Use wiki_write for new pages, appending new sections, or intentional whole-page replacement.",
-        "mode=create is safe: if a page exists it is skipped, not overwritten.",
-        "Use mode=replace only when deliberately rewriting the entire page.",
-    ],
-    wiki_read: [
-        "When wiki_read returns AGING/STALE/VERY STALE, verify code/config/API claims against source before trusting them.",
-    ],
-    wiki_move: [
-        "Use wiki_move when a page's PARA lifecycle changes, such as archiving a completed project.",
-    ],
-    wiki_lint: [
-        "Use wiki_lint to check orphan pages, broken links, stale pages, scope drift, frontmatter, index drift, and duplicate slugs.",
-    ],
-    wiki_migrate: [
-        "Use wiki_migrate when schemaVersion changes or doctor/lint reports stale page schema.",
-    ],
-    wiki_summarize: [
-        "Use wiki_summarize to gather source material for a synthesized summary; write a durable page only if the summary is worth preserving.",
-    ],
-};
-export function getWikiToolGuidelines(name) {
-    return [...TOOL_SPECIFIC_GUIDELINES[name]];
-}
-export function buildWikiToolGuidanceSection() {
-    return [
-        "## pi-para Wiki Tool Guidance",
-        "",
-        "- Search with wiki_query when past architecture, debugging, conventions, domain facts, or prior discussion may matter.",
-        "- Treat AGING/STALE/VERY STALE code/config/API claims as untrusted until verified against source; fix wrong pages with wiki_edit.",
-        "- Persist major decisions/debugging/conventions without being asked. Use wiki_edit for surgical fixes; wiki_write create/append for new/additive knowledge; replace only for deliberate full rewrites.",
-        "- Prefer resources/, kebab-case scope/tags, [[wikilinks]], and no secrets.",
-    ].join("\n");
-}
-//# sourceMappingURL=wiki-tool-guidance.js.map

package/dist/wiki-tool-guidance.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wiki-tool-guidance.js","sourceRoot":"","sources":["../src/wiki-tool-guidance.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,sBAAsB,GAAiC;IAClE,WAAW,EAAE,qFAAqF;IAClG,UAAU,EAAE,0EAA0E;IACtF,SAAS,EAAE,gFAAgF;IAC3F,UAAU,EAAE,kFAAkF;IAC9F,SAAS,EAAE,2FAA2F;IACtG,SAAS,EAAE,kEAAkE;IAC7E,SAAS,EAAE,6DAA6D;IACxE,YAAY,EAAE,6DAA6D;IAC3E,cAAc,EAAE,gEAAgE;CACjF,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D,WAAW,EAAE,qCAAqC;IAClD,UAAU,EAAE,8CAA8C;IAC1D,SAAS,EAAE,+EAA+E;IAC1F,UAAU,EAAE,+EAA+E;IAC3F,SAAS,EAAE,oEAAoE;IAC/E,SAAS,EAAE,2CAA2C;IACtD,SAAS,EAAE,4CAA4C;IACvD,YAAY,EAAE,iDAAiD;IAC/D,cAAc,EAAE,uDAAuD;CACxE,CAAC;AAEF,MAAM,wBAAwB,GAA4C;IACxE,WAAW,EAAE;QACX,gGAAgG;QAChG,kHAAkH;KACnH;IACD,UAAU,EAAE;QACV,gJAAgJ;QAChJ,2EAA2E;KAC5E;IACD,SAAS,EAAE;QACT,oFAAoF;QACpF,wEAAwE;KACzE;IACD,UAAU,EAAE;QACV,8FAA8F;QAC9F,uEAAuE;QACvE,oEAAoE;KACrE;IACD,SAAS,EAAE;QACT,mHAAmH;KACpH;IACD,SAAS,EAAE;QACT,4FAA4F;KAC7F;IACD,SAAS,EAAE;QACT,6HAA6H;KAC9H;IACD,YAAY,EAAE;QACZ,uFAAuF;KACxF;IACD,cAAc,EAAE;QACd,uIAAuI;KACxI;CACF,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACtD,OAAO,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,4BAA4B;IAC1C,OAAO;QACL,+BAA+B;QAC/B,EAAE;QACF,wHAAwH;QACxH,mIAAmI;QACnI,wMAAwM;QACxM,4EAA4E;KAC7E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/wiki.d.ts

@@ -1,108 +0,0 @@
-/**
- * Wiki filesystem operations — manages ~/.pi/wiki/ directory structure.
- *
- * Handles CRUD for wiki pages (markdown + YAML frontmatter), index/log
- * maintenance, page moves between PARA categories, and wiki initialization.
- */
-import type { StateDB } from "./state.js";
-export type ParaCategory = "projects" | "areas" | "resources" | "archives";
-export interface PageFrontmatter {
-    title: string;
-    para: ParaCategory;
-    scope: string[];
-    tags: string[];
-    sources: string[];
-    created: string;
-    updated: string;
-    links: string[];
-    schemaVersion: number;
-}
-export interface WikiPage {
-    category: ParaCategory;
-    slug: string;
-    frontmatter: PageFrontmatter;
-    body: string;
-}
-export interface PageRef {
-    category: ParaCategory;
-    slug: string;
-    title: string;
-    path: string;
-}
-export interface LogEntry {
-    date: string;
-    operation: "ingest" | "query" | "lint" | "capture" | "move" | "archive" | "edit";
-    summary: string;
-    pages: string[];
-}
-export declare const PARA_CATEGORIES: readonly ParaCategory[];
-/**
- * Initialize a wiki directory. Creates the PARA category directories,
- * raw source directories, and seeds schema.md, index.md, log.md, and
- * sessions.md if they do not already exist. Idempotent.
- */
-export declare function initWiki(wikiDir: string): Promise<void>;
-/**
- * Read a wiki page by category and slug. Returns null if the page does
- * not exist. Parses YAML frontmatter via frontmatter.ts.
- */
-export declare function readPage(wikiDir: string, category: ParaCategory, slug: string): Promise<WikiPage | null>;
-/**
- * Write a wiki page. Creates the category directory if needed. Serializes
- * frontmatter and body via frontmatter.ts.
- *
- * If stateDb is provided, also updates the page summary cache.
- */
-export declare function writePage(wikiDir: string, page: WikiPage, stateDb?: StateDB): Promise<void>;
-/**
- * Delete a wiki page. No-op if the page does not exist.
- */
-export declare function deletePage(wikiDir: string, category: ParaCategory, slug: string): Promise<void>;
-/**
- * Move a page between PARA categories. Updates the page's `para` and
- * `updated` frontmatter fields. The slug is preserved.
- */
-export declare function movePage(wikiDir: string, from: PageRef, toCategory: ParaCategory): Promise<void>;
-/**
- * List pages across one or all PARA categories. Returns PageRef objects
- * sorted by category then slug.
- */
-export declare function listPages(wikiDir: string, category?: ParaCategory): Promise<PageRef[]>;
-/**
- * List page slugs across all PARA categories without reading file contents.
- * Much cheaper than listPages() when only slugs are needed (e.g. auto-linking).
- */
-export declare function listPageSlugs(wikiDir: string): Promise<Set<string>>;
-/**
- * Read the wiki index (index.md).
- */
-export declare function readIndex(wikiDir: string): Promise<string>;
-/**
- * Write the wiki index (index.md).
- */
-export declare function writeIndex(wikiDir: string, content: string): Promise<void>;
-/**
- * Append an entry to the activity log (log.md).
- */
-export declare function appendLog(wikiDir: string, entry: LogEntry): Promise<void>;
-/**
- * Read the wiki schema (schema.md).
- */
-export declare function readSchema(wikiDir: string): Promise<string>;
-/**
- * Rebuild index.md deterministically from all pages on disk.
- *
- * Reads all pages, groups by PARA category, sorts alphabetically within
- * each category, and writes a standardized index.md with one-line summaries.
- */
-export declare function rebuildIndex(wikiDir: string): Promise<void>;
-/**
- * Auto-commit all wiki changes with a descriptive message.
- *
- * Silently no-ops if:
- * - git is not installed
- * - wiki dir is not a git repo
- * - there are no changes to commit
- */
-export declare function gitCommit(wikiDir: string, message: string): Promise<boolean>;
-//# sourceMappingURL=wiki.d.ts.map

package/dist/wiki.d.ts.map

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

package/dist/wiki.js

@@ -1,497 +0,0 @@
-/**
- * Wiki filesystem operations — manages ~/.pi/wiki/ directory structure.
- *
- * Handles CRUD for wiki pages (markdown + YAML frontmatter), index/log
- * maintenance, page moves between PARA categories, and wiki initialization.
- */
-import { readFile, writeFile, mkdir, unlink, readdir, access, } from "node:fs/promises";
-import { join } from "node:path";
-import { execFile } from "node:child_process";
-import { parseFrontmatter, serializeFrontmatter, } from "./frontmatter.js";
-// -- Constants ---------------------------------------------------------------
-export const PARA_CATEGORIES = [
-    "projects",
-    "areas",
-    "resources",
-    "archives",
-];
-const DEFAULT_SCHEMA = `# Wiki Schema
-
-## Page Format
-
-Every wiki page is a markdown file with YAML frontmatter:
-
-\`\`\`yaml
----
-title: Page Title
-para: projects | areas | resources | archives
-scope:
-  - project-name
-  - global
-tags:
-  - topic-tag
-sources:
-  - https://example.com
-  - session:~/.pi/agent/sessions/.../file.jsonl
-created: "2026-01-01"
-updated: "2026-01-01"
-links:
-  - other-page-slug
----
-\`\`\`
-
-## PARA Categories
-
-- **projects/**: Active, goal-defined work with an end date. Default scope: current project name.
-- **areas/**: Ongoing responsibilities with no end date. Default scope: \`["global"]\`.
-- **resources/**: Reference material, how-tos, patterns. Scope assigned by content analysis.
-- **archives/**: Completed, deprecated, or inactive items. Moved from other categories.
-
-## Naming Conventions
-
-- Slugs: lowercase, hyphens, no special characters (e.g., \`ssl-cert-gotchas\`)
-- One concept per page
-- Use [[wikilinks]] for cross-references: \`[[slug]]\`
-
-## Wiki Summary Format
-
-\`\`\`markdown
-## Topic
-[What this page covers]
-
-## Key Facts
-- [Established knowledge points]
-
-## Insights
-- [Non-obvious findings, patterns, implications]
-
-## Connections
-- [[related-page]] — how this relates
-
-## Open Questions
-- [Gaps in knowledge, unresolved contradictions]
-
-## Sources
-- [Source URLs, file paths, session references]
-\`\`\`
-
-## Index Format
-
-\`index.md\` is organized by PARA category with one-line summaries per page.
-
-## Log Format
-
-\`log.md\` uses the heading format: \`## [YYYY-MM-DD] operation | summary\`
-
-## Tone
-
-Technical, concise, factual. No fluff.
-
-## Updates vs. New Pages
-
-- Update an existing page when new information relates to the same concept
-- Create a new page when the concept is distinct enough to stand alone
-- When in doubt, create a new page and add [[wikilinks]]
-
-## Archiving
-
-Move projects to archives when:
-- The project goal is completed
-- No log entries in 90+ days
-- Explicitly requested by user
-`;
-const DEFAULT_INDEX = `# Wiki Index
-
-## Projects
-
-_No active projects yet._
-
-## Areas
-
-_No areas defined yet._
-
-## Resources
-
-_No resources yet._
-
-## Archives
-
-_No archived items._
-`;
-const DEFAULT_LOG = "# Activity Log\n";
-const DEFAULT_SESSIONS = "# Session Digests\n";
-const DEFAULT_GITIGNORE = `# pi-para generated state (do not version)
-.qmd.sqlite*
-.daemon.sqlite*
-.pi-para.sqlite*
-gepa/input/
-gepa/output/
-
-# local caches/logs
-*.tmp
-`;
-// -- Helpers -----------------------------------------------------------------
-async function fileExists(path) {
-    try {
-        await access(path);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function seedFile(path, content) {
-    if (!(await fileExists(path))) {
-        await writeFile(path, content, "utf-8");
-    }
-}
-// -- Functions ---------------------------------------------------------------
-/**
- * Initialize a wiki directory. Creates the PARA category directories,
- * raw source directories, and seeds schema.md, index.md, log.md, and
- * sessions.md if they do not already exist. Idempotent.
- */
-export async function initWiki(wikiDir) {
-    // Create PARA category directories
-    for (const cat of PARA_CATEGORIES) {
-        await mkdir(join(wikiDir, cat), { recursive: true });
-    }
-    // Create raw source directories
-    for (const sub of ["articles", "docs", "notes"]) {
-        await mkdir(join(wikiDir, "raw", sub), { recursive: true });
-    }
-    // Seed default files (only if missing)
-    await seedFile(join(wikiDir, "schema.md"), DEFAULT_SCHEMA);
-    await seedFile(join(wikiDir, "index.md"), DEFAULT_INDEX);
-    await seedFile(join(wikiDir, "log.md"), DEFAULT_LOG);
-    await seedFile(join(wikiDir, "sessions.md"), DEFAULT_SESSIONS);
-    await seedFile(join(wikiDir, ".gitignore"), DEFAULT_GITIGNORE);
-}
-/**
- * Read a wiki page by category and slug. Returns null if the page does
- * not exist. Parses YAML frontmatter via frontmatter.ts.
- */
-export async function readPage(wikiDir, category, slug) {
-    const filePath = join(wikiDir, category, `${slug}.md`);
-    let content;
-    try {
-        content = await readFile(filePath, "utf-8");
-    }
-    catch (err) {
-        if (err.code === "ENOENT") {
-            return null;
-        }
-        throw err;
-    }
-    const { frontmatter, body } = parseFrontmatter(content);
-    return { category, slug, frontmatter, body };
-}
-/**
- * Write a wiki page. Creates the category directory if needed. Serializes
- * frontmatter and body via frontmatter.ts.
- *
- * If stateDb is provided, also updates the page summary cache.
- */
-export async function writePage(wikiDir, page, stateDb) {
-    const dirPath = join(wikiDir, page.category);
-    await mkdir(dirPath, { recursive: true });
-    const filePath = join(dirPath, `${page.slug}.md`);
-    const content = serializeFrontmatter(page.frontmatter, page.body);
-    await writeFile(filePath, content, "utf-8");
-    // Update page summary cache if state DB is available
-    if (stateDb) {
-        const firstPara = extractFirstParagraphFromBody(page.body);
-        stateDb.upsertPageSummary(page.slug, page.category, page.frontmatter.scope, page.frontmatter.tags, firstPara, page.frontmatter.updated);
-    }
-}
-/**
- * Delete a wiki page. No-op if the page does not exist.
- */
-export async function deletePage(wikiDir, category, slug) {
-    const filePath = join(wikiDir, category, `${slug}.md`);
-    try {
-        await unlink(filePath);
-    }
-    catch (err) {
-        if (err.code === "ENOENT") {
-            return;
-        }
-        throw err;
-    }
-}
-/**
- * Move a page between PARA categories. Updates the page's `para` and
- * `updated` frontmatter fields. The slug is preserved.
- */
-export async function movePage(wikiDir, from, toCategory) {
-    const srcPath = join(wikiDir, from.category, `${from.slug}.md`);
-    const destDir = join(wikiDir, toCategory);
-    const destPath = join(destDir, `${from.slug}.md`);
-    // Read source
-    const content = await readFile(srcPath, "utf-8");
-    const { frontmatter, body } = parseFrontmatter(content);
-    // Update frontmatter
-    frontmatter.para = toCategory;
-    frontmatter.updated = new Date().toISOString();
-    // Write to new location, then remove old file
-    await mkdir(destDir, { recursive: true });
-    await writeFile(destPath, serializeFrontmatter(frontmatter, body), "utf-8");
-    await unlink(srcPath);
-}
-/**
- * List pages across one or all PARA categories. Returns PageRef objects
- * sorted by category then slug.
- */
-export async function listPages(wikiDir, category) {
-    const categories = category ? [category] : PARA_CATEGORIES;
-    const refs = [];
-    for (const cat of categories) {
-        const dirPath = join(wikiDir, cat);
-        let entries;
-        try {
-            entries = await readdir(dirPath);
-        }
-        catch {
-            continue; // directory doesn't exist yet
-        }
-        const catRefs = await Promise.all(entries
-            .filter((entry) => entry.endsWith(".md"))
-            .map(async (entry) => {
-            const slug = entry.slice(0, -3);
-            const content = await readFile(join(dirPath, entry), "utf-8");
-            const { frontmatter } = parseFrontmatter(content);
-            return {
-                category: cat,
-                slug,
-                title: frontmatter.title,
-                path: `${cat}/${entry}`,
-            };
-        }));
-        refs.push(...catRefs);
-    }
-    // Sort by category order, then slug alphabetically
-    refs.sort((a, b) => {
-        const catCmp = PARA_CATEGORIES.indexOf(a.category) -
-            PARA_CATEGORIES.indexOf(b.category);
-        if (catCmp !== 0)
-            return catCmp;
-        return a.slug.localeCompare(b.slug);
-    });
-    return refs;
-}
-/**
- * List page slugs across all PARA categories without reading file contents.
- * Much cheaper than listPages() when only slugs are needed (e.g. auto-linking).
- */
-export async function listPageSlugs(wikiDir) {
-    const slugs = new Set();
-    for (const cat of PARA_CATEGORIES) {
-        let entries;
-        try {
-            entries = await readdir(join(wikiDir, cat));
-        }
-        catch {
-            continue;
-        }
-        for (const entry of entries) {
-            if (entry.endsWith(".md"))
-                slugs.add(entry.slice(0, -3));
-        }
-    }
-    return slugs;
-}
-/**
- * Read the wiki index (index.md).
- */
-export async function readIndex(wikiDir) {
-    return readFile(join(wikiDir, "index.md"), "utf-8");
-}
-/**
- * Write the wiki index (index.md).
- */
-export async function writeIndex(wikiDir, content) {
-    await writeFile(join(wikiDir, "index.md"), content, "utf-8");
-}
-/**
- * Append an entry to the activity log (log.md).
- */
-export async function appendLog(wikiDir, entry) {
-    const logPath = join(wikiDir, "log.md");
-    const existing = await readFile(logPath, "utf-8");
-    const pages = entry.pages.length > 0 ? entry.pages.join(", ") : "none";
-    const line = `\n## [${entry.date}] ${entry.operation} | ${entry.summary}\nPages: ${pages}\n`;
-    await writeFile(logPath, existing + line, "utf-8");
-}
-/**
- * Read the wiki schema (schema.md).
- */
-export async function readSchema(wikiDir) {
-    return readFile(join(wikiDir, "schema.md"), "utf-8");
-}
-// -- Git auto-commit ---------------------------------------------------------
-/**
- * Run a git command in the wiki directory. Returns stdout or null on failure.
- */
-function git(wikiDir, args) {
-    return new Promise((resolve) => {
-        execFile("git", args, { cwd: wikiDir, timeout: 10_000 }, (err, stdout) => {
-            if (err)
-                resolve(null);
-            else
-                resolve(stdout.trim());
-        });
-    });
-}
-// -- Index rebuild -----------------------------------------------------------
-/**
- * Rebuild index.md deterministically from all pages on disk.
- *
- * Reads all pages, groups by PARA category, sorts alphabetically within
- * each category, and writes a standardized index.md with one-line summaries.
- */
-export async function rebuildIndex(wikiDir) {
-    const sections = {
-        projects: [],
-        areas: [],
-        resources: [],
-        archives: [],
-    };
-    // Single pass: read each page file exactly once, in parallel per category.
-    // (Previously this called listPages() and then readPage() per page, reading
-    // every file twice sequentially — the dominant cost of wiki_write at scale.)
-    for (const cat of PARA_CATEGORIES) {
-        const dirPath = join(wikiDir, cat);
-        let entries;
-        try {
-            entries = await readdir(dirPath);
-        }
-        catch {
-            continue; // directory doesn't exist yet
-        }
-        const lines = await Promise.all(entries
-            .filter((entry) => entry.endsWith(".md"))
-            .map((entry) => entry.slice(0, -3))
-            .sort((a, b) => a.localeCompare(b))
-            .map(async (slug) => {
-            const entry = `${slug}.md`;
-            const content = await readFile(join(dirPath, entry), "utf-8");
-            const { frontmatter, body } = parseFrontmatter(content);
-            const title = frontmatter.title;
-            const summary = extractFirstParagraphFromBody(body);
-            const desc = summary && summary !== "(no summary)"
-                ? ": " + (summary.length > 120 ? summary.slice(0, 117) + "..." : summary)
-                : "";
-            return `- [[${slug}]] \u2014 ${title}${desc}`;
-        }));
-        sections[cat].push(...lines);
-    }
-    const categoryLabels = {
-        projects: "Projects",
-        areas: "Areas",
-        resources: "Resources",
-        archives: "Archives",
-    };
-    const lines = ["# Wiki Index", ""];
-    for (const cat of PARA_CATEGORIES) {
-        lines.push(`## ${categoryLabels[cat]}`, "");
-        if (sections[cat].length > 0) {
-            lines.push(...sections[cat]);
-        }
-        else {
-            const emptyMsg = {
-                projects: "_No active projects yet._",
-                areas: "_No areas defined yet._",
-                resources: "_No resources yet._",
-                archives: "_No archived items._",
-            };
-            lines.push(emptyMsg[cat]);
-        }
-        lines.push("");
-    }
-    // Remove trailing empty line to avoid double newlines
-    while (lines.length > 0 && lines[lines.length - 1] === "") {
-        lines.pop();
-    }
-    lines.push(""); // single trailing newline
-    await writeIndex(wikiDir, lines.join("\n"));
-}
-/**
- * Extract the first non-empty paragraph from a markdown body.
- * Skips headings and blank lines. Returns a single line.
- */
-function extractFirstParagraphFromBody(body) {
-    const lines = body.split("\n");
-    const paragraphLines = [];
-    let inParagraph = false;
-    for (const line of lines) {
-        const trimmed = line.trim();
-        // Skip headings and empty lines before paragraph starts
-        if (!inParagraph) {
-            if (trimmed === "" || trimmed.startsWith("#"))
-                continue;
-            inParagraph = true;
-        }
-        // End paragraph on blank line or heading
-        if (inParagraph && (trimmed === "" || trimmed.startsWith("#"))) {
-            break;
-        }
-        paragraphLines.push(trimmed);
-    }
-    const result = paragraphLines.join(" ");
-    // Truncate long paragraphs
-    if (result.length > 200) {
-        return result.slice(0, 197) + "...";
-    }
-    return result || "(no summary)";
-}
-/**
- * Auto-commit all wiki changes with a descriptive message.
- *
- * Silently no-ops if:
- * - git is not installed
- * - wiki dir is not a git repo
- * - there are no changes to commit
- */
-export async function gitCommit(wikiDir, message) {
-    try {
-        // Check if it's a git repo
-        const isRepo = await git(wikiDir, ["rev-parse", "--git-dir"]);
-        if (!isRepo) {
-            // Auto-init if not a repo yet
-            const initResult = await git(wikiDir, ["init"]);
-            if (!initResult)
-                return false;
-        }
-        // Stage durable wiki content only. Generated SQLite/search state can be large
-        // and made wiki edits slow when `git add -A` tried to version it.
-        const stageCandidates = [
-            ".gitignore",
-            "schema.md",
-            "index.md",
-            "log.md",
-            "sessions.md",
-            "config.json",
-            ".completed-sessions",
-            ...PARA_CATEGORIES,
-        ];
-        const stagePaths = [];
-        for (const p of stageCandidates) {
-            if (await fileExists(join(wikiDir, p)))
-                stagePaths.push(p);
-        }
-        if (stagePaths.length > 0) {
-            await git(wikiDir, ["add", "--", ...stagePaths]);
-        }
-        // Check if there's anything to commit
-        const status = await git(wikiDir, ["status", "--porcelain"]);
-        if (!status)
-            return false; // nothing to commit
-        // Commit
-        const result = await git(wikiDir, ["commit", "-m", message, "--no-gpg-sign"]);
-        return result !== null;
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=wiki.js.map