pi-para 0.6.0 → 0.6.2

package/dist/scheduler/session-capture.js

@@ -0,0 +1,108 @@
+import { appendFile, readFile } from "node:fs/promises";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
+import { StateDB } from "../state.js";
+import { processSession } from "../processor.js";
+export function parseCompletedSessionLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    const parts = trimmed.split("|", 2);
+    if (parts.length !== 2 || !parts[0] || !parts[1])
+        return null;
+    return { timestamp: parts[0], sessionPath: parts[1] };
+}
+export async function readCompletedSessionRegistry(wikiDir) {
+    const registryPath = join(wikiDir, ".completed-sessions");
+    if (!existsSync(registryPath))
+        return [];
+    const content = await readFile(registryPath, "utf-8");
+    return content
+        .split(/\r?\n/)
+        .map(parseCompletedSessionLine)
+        .filter((entry) => entry !== null);
+}
+export async function appendCompletedSession(wikiDir, sessionPath, timestamp = new Date().toISOString()) {
+    const registryPath = join(wikiDir, ".completed-sessions");
+    await appendFile(registryPath, `${timestamp}|${sessionPath}\n`, "utf-8");
+    return { timestamp, sessionPath };
+}
+export async function enqueueCompletedSessionsFromRegistry(scheduler, wikiDir, opts = {}) {
+    const entries = await readCompletedSessionRegistry(wikiDir);
+    return enqueueCompletedSessions(scheduler, entries, opts);
+}
+export function enqueueCompletedSessions(scheduler, entries, opts = {}) {
+    const ids = [];
+    for (const entry of entries) {
+        if (!existsSync(entry.sessionPath))
+            continue;
+        if (opts.stateDb?.isProcessed(entry.sessionPath))
+            continue;
+        ids.push(scheduler.enqueue("capture-session", { sessionPath: entry.sessionPath, scope: detectScopeFromSessionPath(entry.sessionPath) }, { dedupeKey: `capture-session:${entry.sessionPath}`, priority: 20 }));
+    }
+    return ids;
+}
+export function createCaptureSessionHandler(deps) {
+    return async (item) => {
+        const payload = item.payload;
+        if (!payload.sessionPath)
+            throw new Error("capture-session payload missing sessionPath");
+        if (!existsSync(payload.sessionPath))
+            throw new Error(`Session file not found: ${payload.sessionPath}`);
+        const store = deps.storeProvider();
+        if (!store)
+            throw new Error("QMD store unavailable for capture-session");
+        if (!deps.model)
+            throw new Error("Capture model unavailable for capture-session");
+        if (!deps.getApiKey)
+            throw new Error("API key resolver unavailable for capture-session");
+        const stateDb = deps.stateDb ?? new StateDB(deps.wikiDir);
+        const ownsState = !deps.stateDb;
+        const scope = payload.scope ?? detectScopeFromSessionPath(payload.sessionPath);
+        try {
+            if (stateDb.isProcessed(payload.sessionPath))
+                return;
+            const run = deps.processor ?? processSession;
+            const result = await run(payload.sessionPath, deps.wikiDir, store, scope, deps.model, deps.getApiKey);
+            if (result.skipped) {
+                stateDb.recordSuccess(payload.sessionPath, scope, [], []);
+            }
+            else {
+                stateDb.recordSuccess(payload.sessionPath, scope, result.pagesCreated, result.pagesUpdated);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            stateDb.recordFailure(payload.sessionPath, scope, message);
+            throw err;
+        }
+        finally {
+            if (ownsState)
+                stateDb.close();
+        }
+    };
+}
+export function detectScopeFromSessionPath(sessionPath) {
+    try {
+        const firstLine = requireReadFirstLine(sessionPath);
+        const header = JSON.parse(firstLine);
+        if (header.cwd)
+            return basename(header.cwd) || "unknown";
+    }
+    catch {
+        // fall through to path decoding
+    }
+    const dirName = basename(dirname(sessionPath));
+    if (dirName.startsWith("--") && dirName.endsWith("--")) {
+        const inner = dirName.slice(2, -2);
+        const projectsIdx = inner.indexOf("projects-");
+        if (projectsIdx >= 0)
+            return inner.slice(projectsIdx + "projects-".length);
+    }
+    return "unknown";
+}
+function requireReadFirstLine(path) {
+    const content = readFileSync(path, "utf-8");
+    return content.split("\n")[0] ?? "";
+}
+//# sourceMappingURL=session-capture.js.map

package/dist/scheduler/session-capture.js.map

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

package/dist/scheduler/state.d.ts

@@ -0,0 +1,56 @@
+import Database from "better-sqlite3";
+export type QueueStatus = "queued" | "running" | "done" | "failed";
+export interface QueueItem<T = unknown> {
+    id: number;
+    taskName: string;
+    payload: T;
+    priority: number;
+    availableAt: string;
+    dedupeKey: string | null;
+    status: QueueStatus;
+    attempts: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface EnqueueOptions {
+    priority?: number;
+    availableAt?: Date;
+    dedupeKey?: string;
+    now?: Date;
+}
+export interface SchedulerHistoryItem<T = unknown> {
+    id: number;
+    taskName: string;
+    payload: T | null;
+    status: string;
+    startedAt: string;
+    finishedAt: string | null;
+    durationMs: number | null;
+    error: string | null;
+}
+export declare class SchedulerStateDB {
+    readonly db: Database.Database;
+    constructor(dbPath?: string);
+    migrate(): void;
+    enqueue(taskName: string, payload: unknown, opts?: EnqueueOptions): number;
+    claimNext(now?: Date): QueueItem | null;
+    complete(id: number, now?: Date): void;
+    fail(id: number, error: string, opts?: {
+        retryAt?: Date;
+        maxAttempts?: number;
+        now?: Date;
+    }): void;
+    get(id: number): QueueItem | null;
+    list(status?: QueueStatus): QueueItem[];
+    requeueRunning(now?: Date): number;
+    retryFailed(taskName?: string, now?: Date): number;
+    listHistory(opts?: {
+        taskName?: string;
+        limit?: number;
+    }): SchedulerHistoryItem[];
+    getHistoryItem(id: number): SchedulerHistoryItem | null;
+    recordHistory(taskName: string, payload: unknown, status: string, startedAt: Date, finishedAt: Date | null, durationMs: number | null, error: string | null): void;
+    close(): void;
+    private getQueuedByDedupe;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/scheduler/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/scheduler/state.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAMtC,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,OAAO;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;gBAEnB,MAAM,SAAiC;IAOnD,OAAO,IAAI,IAAI;IA6Cf,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,cAAmB,GAAG,MAAM;IAuB9E,SAAS,CAAC,GAAG,OAAa,GAAG,SAAS,GAAG,IAAI;IA4B7C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,IAAI;IAI5C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,IAAI,CAAA;KAAO,GAAG,IAAI;IAiBtG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAKjC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,EAAE;IAOvC,cAAc,CAAC,GAAG,OAAa,GAAG,MAAM;IASxC,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAa,GAAG,MAAM;IAexD,WAAW,CAAC,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,oBAAoB,EAAE;IAQrF,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI;IAKvD,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,IAAI,EACf,UAAU,EAAE,IAAI,GAAG,IAAI,EACvB,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,IAAI;IAgBP,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/scheduler/state.js

@@ -0,0 +1,210 @@
+import Database from "better-sqlite3";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { getParaPaths } from "../paths.js";
+import { ensureLeaseSchema } from "./leases.js";
+export class SchedulerStateDB {
+    db;
+    constructor(dbPath = getParaPaths().schedulerDbPath) {
+        mkdirSync(dirname(dbPath), { recursive: true });
+        this.db = new Database(dbPath);
+        this.db.pragma("journal_mode = WAL");
+        this.migrate();
+    }
+    migrate() {
+        ensureLeaseSchema(this.db);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS scheduler_tasks (
+        task_key TEXT PRIMARY KEY,
+        task_name TEXT NOT NULL,
+        scope TEXT,
+        schedule TEXT,
+        next_due_at TEXT,
+        last_run_at TEXT,
+        last_status TEXT,
+        retry_count INTEGER NOT NULL DEFAULT 0,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS scheduler_queue (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        task_name TEXT NOT NULL,
+        payload_json TEXT NOT NULL,
+        priority INTEGER NOT NULL DEFAULT 0,
+        available_at TEXT NOT NULL,
+        dedupe_key TEXT,
+        status TEXT NOT NULL DEFAULT 'queued',
+        attempts INTEGER NOT NULL DEFAULT 0,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE UNIQUE INDEX IF NOT EXISTS scheduler_queue_dedupe
+        ON scheduler_queue(dedupe_key)
+        WHERE dedupe_key IS NOT NULL AND status IN ('queued', 'running');
+
+      CREATE TABLE IF NOT EXISTS scheduler_history (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        task_name TEXT NOT NULL,
+        payload_json TEXT,
+        status TEXT NOT NULL,
+        started_at TEXT NOT NULL,
+        finished_at TEXT,
+        duration_ms INTEGER,
+        error TEXT
+      );
+    `);
+    }
+    enqueue(taskName, payload, opts = {}) {
+        const now = opts.now ?? new Date();
+        const availableAt = opts.availableAt ?? now;
+        const payloadJson = JSON.stringify(payload ?? {});
+        const existing = opts.dedupeKey ? this.getQueuedByDedupe(opts.dedupeKey) : null;
+        if (existing)
+            return existing.id;
+        const result = this.db.prepare(`
+      INSERT INTO scheduler_queue
+      (task_name, payload_json, priority, available_at, dedupe_key, status, attempts, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, 'queued', 0, ?, ?)
+    `).run(taskName, payloadJson, opts.priority ?? 0, availableAt.toISOString(), opts.dedupeKey ?? null, now.toISOString(), now.toISOString());
+        return Number(result.lastInsertRowid);
+    }
+    claimNext(now = new Date()) {
+        this.db.exec("BEGIN IMMEDIATE");
+        try {
+            const row = this.db.prepare(`
+        SELECT * FROM scheduler_queue
+        WHERE status = 'queued' AND available_at <= ?
+        ORDER BY priority DESC, id ASC
+        LIMIT 1
+      `).get(now.toISOString());
+            if (!row) {
+                this.db.exec("COMMIT");
+                return null;
+            }
+            this.db.prepare(`
+        UPDATE scheduler_queue
+        SET status = 'running', attempts = attempts + 1, updated_at = ?
+        WHERE id = ?
+      `).run(now.toISOString(), row.id);
+            this.db.exec("COMMIT");
+            return rowToItem({ ...row, status: "running", attempts: row.attempts + 1, updated_at: now.toISOString() });
+        }
+        catch (err) {
+            try {
+                this.db.exec("ROLLBACK");
+            }
+            catch { }
+            throw err;
+        }
+    }
+    complete(id, now = new Date()) {
+        this.db.prepare("UPDATE scheduler_queue SET status = 'done', updated_at = ? WHERE id = ?").run(now.toISOString(), id);
+    }
+    fail(id, error, opts = {}) {
+        const now = opts.now ?? new Date();
+        const row = this.get(id);
+        if (!row)
+            return;
+        const maxAttempts = opts.maxAttempts ?? 3;
+        if (row.attempts < maxAttempts && opts.retryAt) {
+            this.db.prepare(`
+        UPDATE scheduler_queue
+        SET status = 'queued', available_at = ?, updated_at = ?
+        WHERE id = ?
+      `).run(opts.retryAt.toISOString(), now.toISOString(), id);
+        }
+        else {
+            this.db.prepare("UPDATE scheduler_queue SET status = 'failed', updated_at = ? WHERE id = ?").run(now.toISOString(), id);
+        }
+        this.recordHistory(row.taskName, row.payload, "failed", now, now, 0, error);
+    }
+    get(id) {
+        const row = this.db.prepare("SELECT * FROM scheduler_queue WHERE id = ?").get(id);
+        return row ? rowToItem(row) : null;
+    }
+    list(status) {
+        const rows = status
+            ? this.db.prepare("SELECT * FROM scheduler_queue WHERE status = ? ORDER BY id ASC").all(status)
+            : this.db.prepare("SELECT * FROM scheduler_queue ORDER BY id ASC").all();
+        return rows.map(rowToItem);
+    }
+    requeueRunning(now = new Date()) {
+        const result = this.db.prepare(`
+      UPDATE scheduler_queue
+      SET status = 'queued', available_at = ?, updated_at = ?
+      WHERE status = 'running'
+    `).run(now.toISOString(), now.toISOString());
+        return result.changes;
+    }
+    retryFailed(taskName, now = new Date()) {
+        const result = taskName
+            ? this.db.prepare(`
+        UPDATE scheduler_queue
+        SET status = 'queued', available_at = ?, updated_at = ?
+        WHERE status = 'failed' AND task_name = ?
+      `).run(now.toISOString(), now.toISOString(), taskName)
+            : this.db.prepare(`
+        UPDATE scheduler_queue
+        SET status = 'queued', available_at = ?, updated_at = ?
+        WHERE status = 'failed'
+      `).run(now.toISOString(), now.toISOString());
+        return result.changes;
+    }
+    listHistory(opts = {}) {
+        const limit = opts.limit ?? 20;
+        const rows = opts.taskName
+            ? this.db.prepare("SELECT * FROM scheduler_history WHERE task_name = ? ORDER BY id DESC LIMIT ?").all(opts.taskName, limit)
+            : this.db.prepare("SELECT * FROM scheduler_history ORDER BY id DESC LIMIT ?").all(limit);
+        return rows.map(rowToHistoryItem);
+    }
+    getHistoryItem(id) {
+        const row = this.db.prepare("SELECT * FROM scheduler_history WHERE id = ?").get(id);
+        return row ? rowToHistoryItem(row) : null;
+    }
+    recordHistory(taskName, payload, status, startedAt, finishedAt, durationMs, error) {
+        this.db.prepare(`
+      INSERT INTO scheduler_history
+      (task_name, payload_json, status, started_at, finished_at, duration_ms, error)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+    `).run(taskName, JSON.stringify(payload ?? {}), status, startedAt.toISOString(), finishedAt?.toISOString() ?? null, durationMs, error);
+    }
+    close() {
+        this.db.close();
+    }
+    getQueuedByDedupe(dedupeKey) {
+        const row = this.db.prepare(`
+      SELECT * FROM scheduler_queue
+      WHERE dedupe_key = ? AND status IN ('queued', 'running')
+      ORDER BY id ASC LIMIT 1
+    `).get(dedupeKey);
+        return row ? rowToItem(row) : null;
+    }
+}
+function rowToItem(row) {
+    return {
+        id: row.id,
+        taskName: row.task_name,
+        payload: JSON.parse(row.payload_json),
+        priority: row.priority,
+        availableAt: row.available_at,
+        dedupeKey: row.dedupe_key,
+        status: row.status,
+        attempts: row.attempts,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function rowToHistoryItem(row) {
+    return {
+        id: row.id,
+        taskName: row.task_name,
+        payload: row.payload_json ? JSON.parse(row.payload_json) : null,
+        status: row.status,
+        startedAt: row.started_at,
+        finishedAt: row.finished_at,
+        durationMs: row.duration_ms,
+        error: row.error,
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/scheduler/state.js.map

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

package/dist/scope.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Project scope detection and filtering.
+ *
+ * Determines which wiki pages are relevant to the current working context
+ * by auto-detecting project name from cwd (git remote, git root, dirname)
+ * or reading explicit config from .pi/wiki-scope.json.
+ */
+export interface ProjectScope {
+    name: string;
+    include: string[];
+    exclude: string[];
+    source: "config" | "git-remote" | "git-root" | "dirname";
+}
+/** .pi/wiki-scope.json schema */
+export interface ScopeConfig {
+    name: string;
+    include?: string[];
+    exclude?: string[];
+}
+/**
+ * Extract a repo name from a git remote URL.
+ *
+ * Handles:
+ *   git@github.com:user/repo.git  -> repo
+ *   https://github.com/user/repo.git -> repo
+ *   https://github.com/user/repo -> repo
+ *   ssh://git@host/user/repo.git -> repo
+ */
+export declare function extractRepoName(remoteUrl: string): string | null;
+/**
+ * Load .pi/wiki-scope.json from the given directory.
+ * Returns null if the file doesn't exist or is invalid JSON.
+ */
+export declare function loadScopeConfig(cwd: string): Promise<ScopeConfig | null>;
+/**
+ * Auto-detect project scope from the working directory.
+ *
+ * Detection priority:
+ *   1. .pi/wiki-scope.json (explicit config)
+ *   2. Git remote origin URL -> repo name
+ *   3. Git repository root directory name
+ *   4. cwd basename (fallback)
+ */
+export declare function detectScope(cwd: string): Promise<ProjectScope>;
+/**
+ * Check whether a page's scope tags match the project scope.
+ *
+ * Rules:
+ *   - A page matches if its scope contains "global" OR any tag in projectScope.include
+ *   - A page is excluded if its scope contains any tag in projectScope.exclude
+ *   - Exclude takes priority over include
+ */
+export declare function matchesScope(pageScope: string[], projectScope: ProjectScope): boolean;
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;CAC1D;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAsBD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYhE;AAID;;;GAGG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwC7B;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAuDpE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EAAE,EACnB,YAAY,EAAE,YAAY,GACzB,OAAO,CAeT"}

package/dist/scope.js

@@ -0,0 +1,161 @@
+/**
+ * Project scope detection and filtering.
+ *
+ * Determines which wiki pages are relevant to the current working context
+ * by auto-detecting project name from cwd (git remote, git root, dirname)
+ * or reading explicit config from .pi/wiki-scope.json.
+ */
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { basename, join } from "node:path";
+// -- Helpers ----------------------------------------------------------------
+/** Run a command and return trimmed stdout, or null on failure. */
+function exec(cmd, args, cwd) {
+    return new Promise((resolve) => {
+        execFile(cmd, args, { cwd }, (err, stdout) => {
+            if (err) {
+                resolve(null);
+                return;
+            }
+            const trimmed = (stdout ?? "").trim();
+            resolve(trimmed || null);
+        });
+    });
+}
+/**
+ * Extract a repo name from a git remote URL.
+ *
+ * Handles:
+ *   git@github.com:user/repo.git  -> repo
+ *   https://github.com/user/repo.git -> repo
+ *   https://github.com/user/repo -> repo
+ *   ssh://git@host/user/repo.git -> repo
+ */
+export function extractRepoName(remoteUrl) {
+    // Strip trailing slashes
+    let url = remoteUrl.trim().replace(/\/+$/, "");
+    // Strip .git suffix
+    url = url.replace(/\.git$/, "");
+    // Get the last path segment
+    const lastSlash = url.lastIndexOf("/");
+    const lastColon = url.lastIndexOf(":");
+    const sep = Math.max(lastSlash, lastColon);
+    if (sep < 0 || sep === url.length - 1)
+        return null;
+    const name = url.slice(sep + 1);
+    return name || null;
+}
+// -- Public API -------------------------------------------------------------
+/**
+ * Load .pi/wiki-scope.json from the given directory.
+ * Returns null if the file doesn't exist or is invalid JSON.
+ */
+export async function loadScopeConfig(cwd) {
+    const configPath = join(cwd, ".pi", "wiki-scope.json");
+    let raw;
+    try {
+        raw = await readFile(configPath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+    if (typeof parsed !== "object" ||
+        parsed === null ||
+        typeof parsed.name !== "string" ||
+        !parsed.name) {
+        return null;
+    }
+    const obj = parsed;
+    const config = { name: obj.name };
+    if (Array.isArray(obj.include)) {
+        config.include = obj.include.filter((v) => typeof v === "string");
+    }
+    if (Array.isArray(obj.exclude)) {
+        config.exclude = obj.exclude.filter((v) => typeof v === "string");
+    }
+    return config;
+}
+/**
+ * Auto-detect project scope from the working directory.
+ *
+ * Detection priority:
+ *   1. .pi/wiki-scope.json (explicit config)
+ *   2. Git remote origin URL -> repo name
+ *   3. Git repository root directory name
+ *   4. cwd basename (fallback)
+ */
+export async function detectScope(cwd) {
+    // 1. Explicit config
+    const config = await loadScopeConfig(cwd);
+    if (config) {
+        const include = Array.from(new Set([config.name, ...(config.include ?? [])]));
+        return {
+            name: config.name,
+            include,
+            exclude: config.exclude ?? [],
+            source: "config",
+        };
+    }
+    // 2. Git remote origin
+    const remoteUrl = await exec("git", ["remote", "get-url", "origin"], cwd);
+    if (remoteUrl) {
+        const repoName = extractRepoName(remoteUrl);
+        if (repoName) {
+            return {
+                name: repoName,
+                include: [repoName],
+                exclude: [],
+                source: "git-remote",
+            };
+        }
+    }
+    // 3. Git root directory name
+    const gitRoot = await exec("git", ["rev-parse", "--show-toplevel"], cwd);
+    if (gitRoot) {
+        const name = basename(gitRoot);
+        if (name) {
+            return {
+                name,
+                include: [name],
+                exclude: [],
+                source: "git-root",
+            };
+        }
+    }
+    // 4. Fallback to cwd basename
+    const name = basename(cwd);
+    return {
+        name,
+        include: [name],
+        exclude: [],
+        source: "dirname",
+    };
+}
+/**
+ * Check whether a page's scope tags match the project scope.
+ *
+ * Rules:
+ *   - A page matches if its scope contains "global" OR any tag in projectScope.include
+ *   - A page is excluded if its scope contains any tag in projectScope.exclude
+ *   - Exclude takes priority over include
+ */
+export function matchesScope(pageScope, projectScope) {
+    // Exclude takes priority
+    if (projectScope.exclude.length > 0 &&
+        pageScope.some((tag) => projectScope.exclude.includes(tag))) {
+        return false;
+    }
+    // Match: "global" or any include tag
+    if (pageScope.includes("global")) {
+        return true;
+    }
+    return pageScope.some((tag) => projectScope.include.includes(tag));
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

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

package/dist/scripts/bulk-link-fix.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env tsx
+/**
+ * One-time bulk fix: auto-link slugs, normalize tags, sync frontmatter.links
+ * across all wiki pages.
+ *
+ * Usage: npx tsx src/scripts/bulk-link-fix.ts [--dry-run]
+ */
+export {};
+//# sourceMappingURL=bulk-link-fix.d.ts.map

package/dist/scripts/bulk-link-fix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bulk-link-fix.d.ts","sourceRoot":"","sources":["../../src/scripts/bulk-link-fix.ts"],"names":[],"mappings":";AACA;;;;;GAKG"}