@aitne/daemon 0.1.4 → 0.1.7

package/dist/core/wiki/git-precompile.d.ts

@@ -0,0 +1,86 @@
+import type { WikiWorkspaceRow } from "./workspaces.js";
+/**
+ * Pre-compile git auto-commit for `!compile full` on external vaults.
+ *
+ * WIKI_BUILDER_DESIGN.md §P2.E / §14 Q5.
+ *
+ * Gate:
+ *   - Internal-mode workspace                 → skip (NotApplicable). The
+ *     `md_file_snapshots` mechanism is the recovery surface.
+ *   - External, not a git repo                → skip (NoBackup). The
+ *     approval-gate DM tells the operator no git backup was taken.
+ *   - External + git, `git_pre_compile_enabled = 0` → skip (Disabled).
+ *   - External + git, dirty working tree      → Refused. The bang
+ *     handler is expected to abort with a DM telling the operator to
+ *     commit/stash first; no agent session is spawned.
+ *   - External + git, clean working tree      → run `git add -A` +
+ *     `git commit -m "aitne wiki: pre-compile snapshot <ts>"`. Operator
+ *     hooks fire as normal (no `--no-verify`).
+ */
+export type GitPreCompileOutcome = {
+    status: "skipped";
+    reason: "internal_mode" | "no_git_repo" | "disabled";
+} | {
+    status: "refused";
+    reason: "dirty_tree";
+    dirtyPaths: string[];
+} | {
+    status: "committed";
+    commitSha: string;
+    commitMessage: string;
+};
+/**
+ * Preview shape — what a dry-run of the pre-compile gate would do without
+ * actually mutating git state. Mirrors `GitPreCompileOutcome` minus the
+ * `committed` arm, replacing it with `clean_would_commit`.
+ *
+ * Used by `GET /wiki/:ws/git/status` so the dashboard can render the
+ * "what would happen on `!compile full`" hint without creating empty
+ * commits on every poll. WIKI_BUILDER_DESIGN.md §P2.E.
+ */
+export type GitPreCompilePreview = {
+    status: "skipped";
+    reason: "internal_mode" | "no_git_repo" | "disabled";
+} | {
+    status: "refused";
+    reason: "dirty_tree";
+    dirtyPaths: string[];
+} | {
+    status: "clean_would_commit";
+};
+export interface GitPreCompileDeps {
+    /**
+     * Override the timestamp baked into the commit message. Tests pass a
+     * fixed string here; production callers leave it unset and the helper
+     * uses `new Date().toISOString()`.
+     */
+    now?: () => Date;
+    /**
+     * Inject a custom `execFile`-compatible runner. Production code uses
+     * the node built-in; tests can stub it without monkey-patching the
+     * module. The signature matches `child_process.execFile`'s callback
+     * form via `promisify` — callers do not need to await the wrapped
+     * shape directly.
+     */
+    run?: (file: string, args: string[], options?: {
+        cwd?: string;
+        timeout?: number;
+    }) => Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+}
+/**
+ * Pure read of the pre-compile gate state — never mutates the git working
+ * tree. Returns the same `skipped` / `refused` arms as the mutating
+ * `runGitPreCompile`, plus a `clean_would_commit` arm in place of the
+ * mutating `committed` arm.
+ *
+ * Use this on dashboard GETs and on the `!compile full` decision pass so
+ * the actual commit is deferred until the path that *will* run the agent
+ * session decides to proceed.
+ */
+export declare function previewGitPreCompile(workspace: WikiWorkspaceRow, deps?: GitPreCompileDeps): Promise<GitPreCompilePreview>;
+export declare function runGitPreCompile(workspace: WikiWorkspaceRow, deps?: GitPreCompileDeps): Promise<GitPreCompileOutcome>;
+export declare function isGitRepo(rootPath: string): boolean;
+//# sourceMappingURL=git-precompile.d.ts.map

package/dist/core/wiki/git-precompile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-precompile.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/git-precompile.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKxD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,aAAa,GAAG,UAAU,CAAA;CAAE,GAC3E;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GACjE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,aAAa,GAAG,UAAU,CAAA;CAAE,GAC3E;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,GACjE;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,CACJ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,KACzC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,gBAAgB,EAC3B,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAgB/B;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,gBAAgB,EAC3B,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAiC/B;AA4BD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CASnD"}

package/dist/core/wiki/git-precompile.js

@@ -0,0 +1,96 @@
+import { execFile } from "node:child_process";
+import { existsSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { promisify } from "node:util";
+import { createLogger } from "../../logging.js";
+const execFileAsync = promisify(execFile);
+const logger = createLogger("wiki-git-precompile");
+/**
+ * Pure read of the pre-compile gate state — never mutates the git working
+ * tree. Returns the same `skipped` / `refused` arms as the mutating
+ * `runGitPreCompile`, plus a `clean_would_commit` arm in place of the
+ * mutating `committed` arm.
+ *
+ * Use this on dashboard GETs and on the `!compile full` decision pass so
+ * the actual commit is deferred until the path that *will* run the agent
+ * session decides to proceed.
+ */
+export async function previewGitPreCompile(workspace, deps = {}) {
+    if (workspace.kind !== "external") {
+        return { status: "skipped", reason: "internal_mode" };
+    }
+    if (!isGitRepo(workspace.root_path)) {
+        return { status: "skipped", reason: "no_git_repo" };
+    }
+    if (workspace.git_pre_compile_enabled !== 1) {
+        return { status: "skipped", reason: "disabled" };
+    }
+    const dirtyPaths = await readDirtyPaths(workspace, deps);
+    if (dirtyPaths.length > 0) {
+        return { status: "refused", reason: "dirty_tree", dirtyPaths };
+    }
+    return { status: "clean_would_commit" };
+}
+export async function runGitPreCompile(workspace, deps = {}) {
+    const preview = await previewGitPreCompile(workspace, deps);
+    if (preview.status !== "clean_would_commit") {
+        return preview;
+    }
+    const run = deps.run ?? defaultRun;
+    const root = workspace.root_path;
+    const now = (deps.now ?? (() => new Date()))().toISOString();
+    const commitMessage = `aitne wiki: pre-compile snapshot ${now}`;
+    await run("git", ["-C", root, "add", "-A"], { timeout: 30_000 });
+    await run("git", [
+        "-C",
+        root,
+        "commit",
+        "--allow-empty",
+        "-m",
+        commitMessage,
+    ], { timeout: 30_000 });
+    const sha = await run("git", ["-C", root, "rev-parse", "HEAD"], {
+        timeout: 5_000,
+    });
+    return {
+        status: "committed",
+        commitSha: sha.stdout.trim(),
+        commitMessage,
+    };
+}
+async function readDirtyPaths(workspace, deps) {
+    const run = deps.run ?? defaultRun;
+    const statusOut = await run("git", ["-C", workspace.root_path, "status", "--porcelain"], { timeout: 10_000 }).catch((err) => {
+        logger.warn({ workspace: workspace.name, err: err instanceof Error ? err.message : String(err) }, "wiki git pre-compile: status check failed — treating as dirty for safety");
+        return { stdout: "?? git-status-failed", stderr: "" };
+    });
+    // Porcelain output is exactly "XY <path>" — two status chars + space.
+    // Do NOT pre-trim because trimming would eat the leading space for the
+    // single-column statuses (`?? newfile`, ` M tracked-edit`) and chop the
+    // first letter of the filename.
+    return statusOut.stdout
+        .split("\n")
+        .filter((line) => line.length > 0)
+        .map((line) => line.slice(3));
+}
+export function isGitRepo(rootPath) {
+    const gitDir = join(rootPath, ".git");
+    if (!existsSync(gitDir))
+        return false;
+    try {
+        const stat = statSync(gitDir);
+        return stat.isDirectory() || stat.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function defaultRun(file, args, options) {
+    const { stdout, stderr } = await execFileAsync(file, args, {
+        timeout: options?.timeout ?? 10_000,
+        cwd: options?.cwd,
+        windowsHide: true,
+    });
+    return { stdout, stderr };
+}
+//# sourceMappingURL=git-precompile.js.map

package/dist/core/wiki/git-precompile.js.map

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

package/dist/core/wiki/import-migrate.d.ts

@@ -0,0 +1,38 @@
+export interface FrontmatterMigration {
+    path: string;
+    renames: Array<{
+        from: string;
+        to: string;
+    }>;
+}
+export interface FlattenMove {
+    fromRelPath: string;
+    toRelPath: string;
+}
+export interface SlugConflict {
+    layer: "10_raw" | "20_wiki";
+    slug: string;
+    paths: string[];
+}
+export interface WikiImportMigrationPlan {
+    rootPath: string;
+    frontmatterMigrations: FrontmatterMigration[];
+    flattenMoves: FlattenMove[];
+    conflicts: SlugConflict[];
+    estimatedBackupBytes: number;
+    generatedAtIso: string;
+}
+export interface ApplyImportMigrationResult {
+    backupDir: string;
+    filesWritten: number;
+    filesMoved: number;
+}
+export declare function planImportMigration(rootPath: string): WikiImportMigrationPlan;
+export interface ApplyMigrationOptions {
+    /** ISO date used to name the backup directory. */
+    dateStamp?: string;
+    /** Skip the conflict guard. Use only when the wizard explicitly chose to overwrite. */
+    allowConflicts?: boolean;
+}
+export declare function applyImportMigration(plan: WikiImportMigrationPlan, options?: ApplyMigrationOptions): ApplyImportMigrationResult;
+//# sourceMappingURL=import-migrate.d.ts.map

package/dist/core/wiki/import-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-migrate.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/import-migrate.ts"],"names":[],"mappings":"AA2EA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;IAC9C,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CA6B7E;AAED,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,uBAAuB,EAC7B,OAAO,GAAE,qBAA0B,GAClC,0BAA0B,CA2C5B"}

package/dist/core/wiki/import-migrate.js

@@ -0,0 +1,310 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { writeFileAtomically } from "../atomic-write.js";
+import { extractFrontmatter } from "./import-probe.js";
+/**
+ * Import-migrate — WIKI_BUILDER_DESIGN.md §7 (Migrate branch).
+ *
+ * Two-step operation:
+ *   1. `planImportMigration(rootPath)` — pure inspection. Returns the list
+ *      of files that would be rewritten, the frontmatter-key mappings,
+ *      and the subdirectory flattening moves. **Never touches disk.**
+ *      The dashboard renders the plan as the user-facing preview.
+ *   2. `applyImportMigration(rootPath, plan, opts)` — executes the plan.
+ *      Always writes a sibling backup mirror under
+ *      `90_meta/health/pre-migrate-<date>/` before touching any file
+ *      (the per-vault `git` backup is layered on top by §P2.E for git
+ *      vaults; this mirror is the always-available recovery surface for
+ *      non-git vaults).
+ *
+ * Migrations supported in P2:
+ *   - Flatten type-based subdirectories under `20_wiki/<type>/<slug>.md`
+ *     → `20_wiki/<slug>.md`, preserving the `type:` frontmatter (which
+ *     stays the discriminator, per §2.4 Bases-era convention).
+ *   - Flatten subdirectories under `10_raw/<topic>/<slug>.md` →
+ *     `10_raw/<slug>.md`. The `images/<slug>/` subdirectory is the only
+ *     permitted nested layout (§2.3) and is preserved as-is.
+ *   - Frontmatter key rename for any keys that map cleanly between the
+ *     two schema flavours. Unknown keys are passed through untouched —
+ *     `wiki.lint` is the long-term enforcer; the migration is a one-shot
+ *     best effort.
+ *
+ * Slug collisions during flattening are reported in the plan as
+ * `conflicts` and the migration refuses to apply until the wizard
+ * surfaces them and the operator chooses how to resolve.
+ *
+ * **Known limitation — iCloud-sandboxed external vaults**: this module
+ * uses `renameSync` and direct `writeFileAtomically` for moves and
+ * rewrites. Both fail with EPERM on iCloud-sandboxed paths, and the
+ * Obsidian CLI (which the runtime write path falls back to for normal
+ * file writes) does not expose a `rename` primitive — there is no
+ * equivalent fallback to route a move through. Callers running the
+ * import flow against an iCloud vault must temporarily relocate it
+ * outside the sandbox, run the migration, and move it back. The wizard
+ * surfaces this in the troubleshooting guide; the API call itself just
+ * propagates the EPERM upstream.
+ */
+const KEY_RENAMES_RAW = {
+    // Common renames observed in pre-Aitne LLM-wiki implementations.
+    source_url: "url",
+    retrieved_at: "captured_at",
+    fetched_at: "captured_at",
+};
+const KEY_RENAMES_WIKI = {
+    topic: "title",
+    kind: "type",
+    state: "status",
+    last_compiled: "compiled_at",
+};
+const KEY_RENAMES_OUTPUT = {
+    asked_at: "generated_at",
+    refs: "sources",
+    answer_to: "question",
+};
+export function planImportMigration(rootPath) {
+    const flattenMoves = [];
+    const conflicts = [];
+    collectFlattenMoves(rootPath, "20_wiki", flattenMoves, conflicts);
+    collectFlattenMoves(rootPath, "10_raw", flattenMoves, conflicts);
+    const frontmatterMigrations = collectFrontmatterMigrations(rootPath, flattenMoves);
+    const estimatedBackupBytes = estimateBytes(rootPath, flattenMoves.map((move) => move.fromRelPath)) +
+        estimateBytes(rootPath, frontmatterMigrations.map((m) => m.path));
+    return {
+        rootPath,
+        frontmatterMigrations,
+        flattenMoves,
+        conflicts,
+        estimatedBackupBytes,
+        generatedAtIso: new Date().toISOString(),
+    };
+}
+export function applyImportMigration(plan, options = {}) {
+    if (plan.conflicts.length > 0 && !options.allowConflicts) {
+        throw Object.assign(new Error(`import-migrate: ${plan.conflicts.length} slug collision(s) detected — resolve them in the wizard before applying.`), { code: "EWIKI_IMPORT_CONFLICT" });
+    }
+    const dateStamp = options.dateStamp ?? new Date().toISOString().slice(0, 10);
+    const backupDir = join(plan.rootPath, "90_meta", "health", `pre-migrate-${dateStamp}`);
+    mkdirSync(backupDir, { recursive: true });
+    let filesWritten = 0;
+    let filesMoved = 0;
+    for (const move of plan.flattenMoves) {
+        const from = join(plan.rootPath, move.fromRelPath);
+        const to = join(plan.rootPath, move.toRelPath);
+        backupFile(plan.rootPath, move.fromRelPath, backupDir);
+        mkdirSync(dirname(to), { recursive: true });
+        renameSync(from, to);
+        filesMoved += 1;
+    }
+    for (const migration of plan.frontmatterMigrations) {
+        const fullPath = join(plan.rootPath, migration.path);
+        backupFile(plan.rootPath, migration.path, backupDir);
+        const original = readFileSafely(fullPath);
+        const rewritten = applyFrontmatterRenames(original, migration.renames);
+        if (rewritten !== original) {
+            writeFileAtomically(fullPath, rewritten);
+            filesWritten += 1;
+        }
+    }
+    writeImportReport(plan.rootPath, dateStamp, plan, {
+        filesWritten,
+        filesMoved,
+        backupDir,
+    });
+    return { backupDir, filesWritten, filesMoved };
+}
+function collectFlattenMoves(rootPath, layer, moves, conflicts) {
+    const dir = join(rootPath, layer);
+    if (!existsSync(dir))
+        return;
+    const seenSlugs = new Map();
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        if (layer === "10_raw" && entry.name === "images")
+            continue;
+        const subPath = join(dir, entry.name);
+        for (const md of readMarkdownChildren(subPath)) {
+            const fromRel = `${layer}/${entry.name}/${md}`;
+            const toRel = `${layer}/${md}`;
+            moves.push({ fromRelPath: fromRel, toRelPath: toRel });
+            const existing = seenSlugs.get(toRel) ?? [];
+            existing.push(fromRel);
+            seenSlugs.set(toRel, existing);
+        }
+    }
+    // Any slug also living at the layer root would conflict with a move.
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isFile() || !entry.name.endsWith(".md"))
+            continue;
+        const rootRel = `${layer}/${entry.name}`;
+        if (seenSlugs.has(rootRel)) {
+            seenSlugs.get(rootRel)?.push(rootRel);
+        }
+    }
+    for (const [toRel, sources] of seenSlugs) {
+        if (sources.length > 1) {
+            conflicts.push({
+                layer,
+                slug: toRel.split("/").pop() ?? toRel,
+                paths: sources,
+            });
+        }
+    }
+}
+function* readMarkdownChildren(dir) {
+    if (!existsSync(dir))
+        return;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isFile() && entry.name.endsWith(".md")) {
+            yield entry.name;
+        }
+    }
+}
+function collectFrontmatterMigrations(rootPath, moves) {
+    const out = [];
+    const moveByFrom = new Map(moves.map((move) => [move.fromRelPath, move.toRelPath]));
+    for (const layer of ["10_raw", "20_wiki", "30_outputs"]) {
+        const dir = join(rootPath, layer);
+        if (!existsSync(dir))
+            continue;
+        const renameMap = renameMapForLayer(layer);
+        // Inspect the file at its *current* on-disk location so the
+        // frontmatter scan sees real bytes. The recorded `path` in the
+        // returned plan is the post-flatten location — that is where the
+        // rewrite step will look after `renameSync` has run.
+        for (const currentAbs of iterateLayerMarkdownOnDisk(rootPath, layer)) {
+            const content = readFileSafely(currentAbs);
+            const fm = extractFrontmatter(content);
+            if (!fm)
+                continue;
+            const renames = [];
+            for (const [from, to] of Object.entries(renameMap)) {
+                if (Object.prototype.hasOwnProperty.call(fm, from)) {
+                    renames.push({ from, to });
+                }
+            }
+            if (renames.length === 0)
+                continue;
+            const currentRel = relative(rootPath, currentAbs).split(/[\\/]/).join("/");
+            const postMoveRel = moveByFrom.get(currentRel) ?? currentRel;
+            out.push({ path: postMoveRel, renames });
+        }
+    }
+    return out;
+}
+function* iterateLayerMarkdownOnDisk(rootPath, layer) {
+    const dir = join(rootPath, layer);
+    if (!existsSync(dir))
+        return;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isFile() && entry.name.endsWith(".md")) {
+            yield join(dir, entry.name);
+        }
+        else if (entry.isDirectory()) {
+            if (layer === "10_raw" && entry.name === "images")
+                continue;
+            const sub = join(dir, entry.name);
+            for (const md of readdirSync(sub, { withFileTypes: true })) {
+                if (md.isFile() && md.name.endsWith(".md")) {
+                    yield join(sub, md.name);
+                }
+            }
+        }
+    }
+}
+function renameMapForLayer(layer) {
+    switch (layer) {
+        case "10_raw":
+            return KEY_RENAMES_RAW;
+        case "20_wiki":
+            return KEY_RENAMES_WIKI;
+        case "30_outputs":
+            return KEY_RENAMES_OUTPUT;
+    }
+}
+function applyFrontmatterRenames(content, renames) {
+    if (renames.length === 0)
+        return content;
+    const delim = "---";
+    if (!content.startsWith(delim))
+        return content;
+    const lines = content.split(/\r?\n/);
+    const endIdx = lines.findIndex((line, idx) => idx > 0 && line === delim);
+    if (endIdx < 0)
+        return content;
+    const renameByFrom = new Map(renames.map((r) => [r.from, r.to]));
+    for (let i = 1; i < endIdx; i += 1) {
+        const match = /^([A-Za-z_][A-Za-z0-9_-]*)(\s*:\s*.*)$/.exec(lines[i]);
+        if (!match)
+            continue;
+        const [, key, rest] = match;
+        const replacement = renameByFrom.get(key);
+        if (!replacement)
+            continue;
+        lines[i] = `${replacement}${rest}`;
+    }
+    return lines.join("\n");
+}
+function readFileSafely(path) {
+    try {
+        return readFileSync(path, "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+function estimateBytes(rootPath, relPaths) {
+    let total = 0;
+    for (const rel of relPaths) {
+        const full = join(rootPath, rel);
+        try {
+            total += statSync(full).size;
+        }
+        catch {
+            /* skip — file already moved by an earlier step */
+        }
+    }
+    return total;
+}
+function backupFile(rootPath, relPath, backupDir) {
+    const src = join(rootPath, relPath);
+    if (!existsSync(src))
+        return;
+    const dest = join(backupDir, relPath);
+    mkdirSync(dirname(dest), { recursive: true });
+    writeFileAtomically(dest, readFileSync(src, "utf-8"));
+}
+function writeImportReport(rootPath, dateStamp, plan, outcome) {
+    const reportPath = join(rootPath, "90_meta", "health", `import-${dateStamp}.md`);
+    const lines = [
+        `# Wiki Import Report — ${dateStamp}`,
+        "",
+        `- Generated: ${plan.generatedAtIso}`,
+        `- Backup directory: \`${relative(rootPath, outcome.backupDir).split(/[\\/]/).join("/")}\``,
+        `- Files written (frontmatter rewrite): ${outcome.filesWritten}`,
+        `- Files moved (flatten): ${outcome.filesMoved}`,
+        "",
+        "## Frontmatter migrations",
+        "",
+        ...(plan.frontmatterMigrations.length === 0
+            ? ["_None._"]
+            : plan.frontmatterMigrations.map((m) => `- \`${m.path}\` — ${m.renames
+                .map((r) => `\`${r.from}\` → \`${r.to}\``)
+                .join(", ")}`)),
+        "",
+        "## Flatten moves",
+        "",
+        ...(plan.flattenMoves.length === 0
+            ? ["_None._"]
+            : plan.flattenMoves.map((m) => `- \`${m.fromRelPath}\` → \`${m.toRelPath}\``)),
+        "",
+        "## Slug conflicts (resolved during apply)",
+        "",
+        ...(plan.conflicts.length === 0
+            ? ["_None._"]
+            : plan.conflicts.map((c) => `- ${c.layer} \`${c.slug}\` — ${c.paths.map((p) => `\`${p}\``).join(", ")}`)),
+        "",
+    ];
+    writeFileAtomically(reportPath, lines.join("\n"));
+}
+//# sourceMappingURL=import-migrate.js.map

package/dist/core/wiki/import-migrate.js.map

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

package/dist/core/wiki/import-probe.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Existing-vault import probe — WIKI_BUILDER_DESIGN.md §7.
+ *
+ * Called by the setup wizard against a candidate `external` mode root
+ * path BEFORE the workspace row is created. The probe is read-only:
+ * it never modifies files on disk. Its job is to classify the vault
+ * (empty, partial-LLM-Wiki, full-LLM-Wiki, foreign) and surface the
+ * data the wizard needs to render the Adopt / Migrate / Split choice.
+ *
+ * Contract:
+ * - Returns `kind: "empty"` when the root has no markdown files under any
+ *   of the layered directories. The wizard then offers "Initialise empty
+ *   vault" rather than the Adopt/Migrate/Split branching.
+ * - Returns `kind: "partial"` when fewer than two of the canonical layer
+ *   directories exist. The wizard nudges the owner to inspect the dir
+ *   before continuing — likely a foreign vault we should not touch.
+ * - Returns `kind: "wiki"` when two or more layer directories exist. The
+ *   wizard then surfaces the schema/layout deltas and the Adopt /
+ *   Migrate / Split decision.
+ *
+ * The probe deliberately rejects layouts where any layer directory is a
+ * symlink — refusing the import is the safe default and matches the
+ * defensive posture taken by `writeFileAtomically`.
+ */
+export type WikiImportKind = "empty" | "partial" | "wiki";
+declare const LAYER_DIRS: readonly ["00_inbox", "10_raw", "20_wiki", "30_outputs", "90_meta"];
+type LayerDir = (typeof LAYER_DIRS)[number];
+export interface LayerInventory {
+    dir: LayerDir;
+    exists: boolean;
+    isSymlink: boolean;
+    fileCount: number;
+    subdirectories: string[];
+    lastModifiedAt: string | null;
+}
+export interface SchemaDelta {
+    schema: "raw" | "wiki" | "output";
+    present: boolean;
+    expectedKeys: string[];
+    foundKeys: string[];
+    missingKeys: string[];
+    extraKeys: string[];
+}
+export interface WikiImportProbeResult {
+    rootPath: string;
+    kind: WikiImportKind;
+    layers: LayerInventory[];
+    schemas: SchemaDelta[];
+    /**
+     * Top values of the `type:` frontmatter property across the vault.
+     * Used by the wizard to preview the existing taxonomy.
+     */
+    topTypes: Array<{
+        value: string;
+        count: number;
+    }>;
+    /**
+     * Detected nested layout (e.g. `20_wiki/concepts/`). Aitne is flat;
+     * the wizard offers to flatten as part of Migrate mode.
+     */
+    unexpectedSubdirectories: Array<{
+        layer: LayerDir;
+        subdir: string;
+    }>;
+    /** Whether `90_meta/taxonomy.md` exists. */
+    taxonomyPresent: boolean;
+    /** Whether `20_wiki/_index.md` exists. */
+    indexPresent: boolean;
+    /** Whether the root is a git repository (used by the precompile gate). */
+    isGitRepo: boolean;
+}
+export declare function probeExistingWikiVault(rootPath: string): WikiImportProbeResult;
+export declare function extractFrontmatter(content: string): Record<string, string> | null;
+export declare function formatProbeRelativePath(rootPath: string, abs: string): string;
+export {};
+//# sourceMappingURL=import-probe.d.ts.map

package/dist/core/wiki/import-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-probe.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/import-probe.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE1D,QAAA,MAAM,UAAU,qEAAsE,CAAC;AACvF,KAAK,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAQ5C,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,QAAQ,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD;;;OAGG;IACH,wBAAwB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,4CAA4C;IAC5C,eAAe,EAAE,OAAO,CAAC;IACzB,0CAA0C;IAC1C,YAAY,EAAE,OAAO,CAAC;IACtB,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAkC9E;AAoJD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAiBjF;AAkCD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7E"}