@aitne/daemon 0.1.4 → 0.1.7

package/dist/core/wiki/workspaces.js

@@ -0,0 +1,352 @@
+import { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, statSync, } from "node:fs";
+import { join, resolve } from "node:path";
+import { validatePrimaryVaultPath } from "../../config.js";
+import { writeFileAtomically } from "../atomic-write.js";
+export const DEFAULT_WIKI_WORKSPACE_NAME = "default";
+export const DEFAULT_WIKI_SCHEMA_VERSION = 1;
+// WIKI_BUILDER_DESIGN.md §14 Q2 — wiki has its own language; no cascade
+// from `primaryLanguage`. NULL defaults to 'en' at the DB layer; the seed
+// row must not inherit the user's primary language even when set.
+export const DEFAULT_WIKI_LANGUAGE = "en";
+// WIKI_BUILDER_DESIGN.md §6.0 / §11 — default $2.00 approval threshold
+// for `!compile full`. Mirrors the dashboard default and schema CHECK.
+export const DEFAULT_WIKI_FULL_COMPILE_APPROVAL_USD = 2.0;
+const FALLBACK_SEEDS = {
+    "taxonomy.md": [
+        "# Wiki Taxonomy",
+        "",
+        "This file defines stable topic names, aliases, and merge rules for the personal wiki.",
+        "",
+        "## Topics",
+        "",
+        "- Add canonical topic names here as the wiki grows.",
+        "",
+    ].join("\n"),
+    "schemas/raw.md": [
+        "# Raw Note Schema",
+        "",
+        "Raw notes live under `10_raw/` and preserve source facts before synthesis.",
+        "",
+        "- Source URL",
+        "- Retrieved timestamp",
+        "- Extracted facts and quotations",
+        "- Open questions",
+        "",
+    ].join("\n"),
+    "schemas/wiki.md": [
+        "# Wiki Note Schema",
+        "",
+        "Wiki notes live under `20_wiki/` and should contain synthesized, cited knowledge.",
+        "",
+        "- Summary",
+        "- Key facts",
+        "- Source links",
+        "- Related notes",
+        "",
+    ].join("\n"),
+    "schemas/output.md": [
+        "# Output Schema",
+        "",
+        "Outputs live under `30_outputs/` and answer a specific user question from the wiki.",
+        "",
+        "- Question",
+        "- Answer",
+        "- Evidence",
+        "- Follow-up gaps",
+        "",
+    ].join("\n"),
+};
+export function defaultWikiRoot(dataDir) {
+    return resolve(dataDir, "wiki");
+}
+export function ensureDefaultWikiWorkspace(db, config) {
+    const rootPath = defaultWikiRoot(config.dataDir);
+    // §P5.C — multi-workspace: check the named default specifically
+    // rather than "first active workspace". With multiple active rows,
+    // `readDefaultWikiWorkspace` returns the oldest active row by id,
+    // which may not be the named default at all.
+    const existing = readWikiWorkspaceByName(db, DEFAULT_WIKI_WORKSPACE_NAME);
+    if (!existing) {
+        const existingNamed = readWikiWorkspaceByName(db, DEFAULT_WIKI_WORKSPACE_NAME);
+        if (existingNamed) {
+            db.prepare(`UPDATE wiki_workspaces
+         SET active = 1,
+             kind = 'internal',
+             root_path = ?,
+             updated_at = CURRENT_TIMESTAMP
+         WHERE name = ?`).run(rootPath, DEFAULT_WIKI_WORKSPACE_NAME);
+        }
+        else {
+            db.prepare(`INSERT INTO wiki_workspaces (
+         name,
+         kind,
+         root_path,
+         language,
+         dispatch_mode,
+         concurrency_cap,
+         dm_agent_write_enabled,
+         bridge_enabled,
+         full_compile_approval_threshold_usd,
+         schema_version,
+         active,
+         updated_at
+        ) VALUES (?, 'internal', ?, ?, 'parallel', 3, 0, 0, ?, ?, 1, CURRENT_TIMESTAMP)`).run(DEFAULT_WIKI_WORKSPACE_NAME, rootPath, DEFAULT_WIKI_LANGUAGE, DEFAULT_WIKI_FULL_COMPILE_APPROVAL_USD, DEFAULT_WIKI_SCHEMA_VERSION);
+        }
+    }
+    seedWikiWorkspaceFiles(rootPath, config.workspaceDir);
+    return readWikiWorkspaceByName(db, DEFAULT_WIKI_WORKSPACE_NAME) ?? {
+        id: 0,
+        name: DEFAULT_WIKI_WORKSPACE_NAME,
+        kind: "internal",
+        root_path: rootPath,
+        language: DEFAULT_WIKI_LANGUAGE,
+        dispatch_mode: "parallel",
+        concurrency_cap: 3,
+        dm_agent_write_enabled: 0,
+        bridge_enabled: 0,
+        bridge_measurement_only: 1,
+        bridge_min_confidence: 0.7,
+        full_compile_approval_threshold_usd: DEFAULT_WIKI_FULL_COMPILE_APPROVAL_USD,
+        write_strategy: "fs",
+        git_pre_compile_enabled: 1,
+        schema_version: DEFAULT_WIKI_SCHEMA_VERSION,
+        active: 1,
+        last_ingest_at: null,
+        last_compile_at: null,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+    };
+}
+/**
+ * Create (or re-activate) an external-mode wiki workspace pointed at a
+ * caller-supplied path. WIKI_BUILDER_DESIGN.md §P2.A / §P2.C.
+ *
+ * Path-collision rules (§2.1.1) and writability are enforced by the
+ * caller (`validateWikiRootPath` + wizard probe) — this function trusts
+ * its inputs and is only responsible for the idempotent DB insert and
+ * vault skeleton seeding.
+ */
+export function createExternalWikiWorkspace(db, config, options) {
+    const name = options.name ?? DEFAULT_WIKI_WORKSPACE_NAME;
+    const language = options.language ?? DEFAULT_WIKI_LANGUAGE;
+    const rootPath = resolve(options.rootPath);
+    const existing = readWikiWorkspaceByName(db, name);
+    if (existing) {
+        db.prepare(`UPDATE wiki_workspaces
+         SET active = 1,
+             kind = 'external',
+             root_path = ?,
+             language = ?,
+             write_strategy = 'auto',
+             updated_at = CURRENT_TIMESTAMP
+       WHERE name = ?`).run(rootPath, language, name);
+    }
+    else {
+        db.prepare(`INSERT INTO wiki_workspaces (
+         name,
+         kind,
+         root_path,
+         language,
+         dispatch_mode,
+         concurrency_cap,
+         dm_agent_write_enabled,
+         bridge_enabled,
+         full_compile_approval_threshold_usd,
+         write_strategy,
+         git_pre_compile_enabled,
+         schema_version,
+         active,
+         updated_at
+       ) VALUES (?, 'external', ?, ?, 'parallel', 3, 0, 0, ?, 'auto', 1, ?, 1, CURRENT_TIMESTAMP)`).run(name, rootPath, language, DEFAULT_WIKI_FULL_COMPILE_APPROVAL_USD, DEFAULT_WIKI_SCHEMA_VERSION);
+    }
+    seedWikiWorkspaceFiles(rootPath, config.workspaceDir);
+    const row = readWikiWorkspaceByName(db, name);
+    if (!row) {
+        throw new Error(`Failed to create external wiki workspace ${name}`);
+    }
+    return row;
+}
+export function readDefaultWikiWorkspace(db) {
+    return (db
+        .prepare(`SELECT * FROM wiki_workspaces WHERE active = 1 ORDER BY id ASC LIMIT 1`)
+        .get() ?? null);
+}
+export function readWikiWorkspaceByName(db, name) {
+    return (db
+        .prepare(`SELECT * FROM wiki_workspaces WHERE name = ? LIMIT 1`)
+        .get(name) ?? null);
+}
+export function listWikiWorkspaces(db) {
+    return db
+        .prepare(`SELECT * FROM wiki_workspaces ORDER BY active DESC, name ASC`)
+        .all();
+}
+/**
+ * WIKI_BUILDER_DESIGN.md §P5.C — active-only iteration helper.
+ *
+ * Multiple workspaces can be active at once in Phase 5; callers that
+ * need to enumerate dispatch targets (the workspace dropdown, the
+ * `@<workspace>` resolver, the boot-time FTS backfill) want the
+ * single-purpose query rather than filtering `listWikiWorkspaces`
+ * downstream and getting it wrong.
+ */
+export function listActiveWikiWorkspaces(db) {
+    return db
+        .prepare(`SELECT * FROM wiki_workspaces WHERE active = 1 ORDER BY name ASC`)
+        .all();
+}
+/**
+ * WIKI_BUILDER_DESIGN.md §P5.C — resolve an `@<workspace>` token (or a
+ * bare workspace name) against the active set, with a fallback to the
+ * default workspace when the caller did not name one.
+ *
+ * Returns `null` when the named workspace does not exist or is
+ * archived — bang handlers turn that into a usage DM rather than
+ * silently dispatching to the default. Returning `null` also covers
+ * the "wiki not enabled" case (no rows at all) so callers do not have
+ * to double-check.
+ */
+export function resolveWikiWorkspace(db, name) {
+    if (name) {
+        const row = readWikiWorkspaceByName(db, name);
+        return row && row.active === 1 ? row : null;
+    }
+    return readDefaultWikiWorkspace(db);
+}
+/**
+ * Validate a candidate external-mode wiki workspace `root_path`.
+ *
+ * Reuses `validatePrimaryVaultPath` for the writability + system-path
+ * + dataDir-overlap + path-traversal checks, then layers on the
+ * wiki-specific overlap rules from WIKI_BUILDER_DESIGN.md §2.1.1:
+ *   - must not equal / overlap `primaryVaultPath`
+ *   - must not equal / overlap `externalObsidianVaultPath`
+ *   - must not equal / overlap any *other* wiki workspace `root_path`
+ *
+ * Equality-with-self is allowed so the validator is idempotent during
+ * an in-place PATCH of an existing row.
+ */
+export function validateWikiRootPath(rawPath, db, config, options = {}) {
+    const base = validatePrimaryVaultPath(rawPath, config, {
+        autoCreate: false,
+        allowMissingLeaf: true,
+        collectFsInfo: false,
+    });
+    if (!base.ok) {
+        return { ok: false, error: base.error, message: base.message };
+    }
+    const real = realpathSafe(resolve(rawPath));
+    if (config.primaryVaultPath) {
+        const primaryReal = realpathSafe(config.primaryVaultPath);
+        if (overlaps(primaryReal, real)) {
+            return {
+                ok: false,
+                error: "overlaps_primary_vault",
+                message: "Wiki root must not overlap the primary vault.",
+            };
+        }
+    }
+    if (config.externalObsidianVaultPath) {
+        const extReal = realpathSafe(config.externalObsidianVaultPath);
+        if (overlaps(extReal, real)) {
+            return {
+                ok: false,
+                error: "overlaps_external_obsidian",
+                message: "Wiki root must not overlap the external Obsidian vault path.",
+            };
+        }
+    }
+    for (const other of listWikiWorkspaces(db)) {
+        if (other.name === options.selfWorkspaceName)
+            continue;
+        if (other.active !== 1)
+            continue;
+        const otherReal = realpathSafe(other.root_path);
+        if (overlaps(otherReal, real)) {
+            return {
+                ok: false,
+                error: "overlaps_other_wiki",
+                message: `Wiki root overlaps existing workspace \`${other.name}\` at ${other.root_path}.`,
+            };
+        }
+    }
+    return { ok: true, resolvedPath: real };
+}
+function realpathSafe(path) {
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return resolve(path);
+    }
+}
+function overlaps(a, b) {
+    return containsOrEquals(a, b) || containsOrEquals(b, a);
+}
+function containsOrEquals(outer, inner) {
+    if (outer === inner)
+        return true;
+    const prefix = outer.endsWith("/") ? outer : `${outer}/`;
+    return inner.startsWith(prefix);
+}
+export function seedWikiWorkspaceFiles(rootPath, workspaceDir) {
+    for (const rel of [
+        "00_inbox",
+        "10_raw/images",
+        "20_wiki",
+        "30_outputs",
+        "90_meta/schemas",
+        "90_meta/health",
+    ]) {
+        mkdirSync(join(rootPath, rel), { recursive: true });
+    }
+    writeIfMissing(join(rootPath, "20_wiki/_index.md"), [
+        "# Wiki Index",
+        "",
+        "This index is maintained by `wiki.compile`.",
+        "",
+    ].join("\n"));
+    writeIfMissing(join(rootPath, "log.md"), "# Wiki Log\n\n");
+    const seedsRoot = join(workspaceDir, "agent-assets", "wiki-seeds");
+    for (const [rel, fallback] of Object.entries(FALLBACK_SEEDS)) {
+        const sourcePath = join(seedsRoot, rel);
+        const targetPath = join(rootPath, "90_meta", rel);
+        const content = existsSync(sourcePath)
+            ? readFileSync(sourcePath, "utf-8")
+            : fallback;
+        writeIfMissing(targetPath, content);
+    }
+}
+export function buildWikiWorkspaceStats(row) {
+    return {
+        rawCount: countMarkdownFiles(join(row.root_path, "10_raw")),
+        wikiCount: countMarkdownFiles(join(row.root_path, "20_wiki")),
+        outputCount: countMarkdownFiles(join(row.root_path, "30_outputs")),
+        lastIngestAt: row.last_ingest_at,
+        lastCompileAt: row.last_compile_at,
+    };
+}
+function countMarkdownFiles(dir) {
+    if (!existsSync(dir))
+        return 0;
+    let count = 0;
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            count += countMarkdownFiles(full);
+        }
+        else if (entry.isFile() && entry.name.endsWith(".md")) {
+            count += 1;
+        }
+    }
+    return count;
+}
+function writeIfMissing(path, content) {
+    if (existsSync(path)) {
+        const stat = statSync(path);
+        if (stat.isFile())
+            return;
+    }
+    writeFileAtomically(path, content.endsWith("\n") ? content : `${content}\n`);
+}
+//# sourceMappingURL=workspaces.js.map

package/dist/core/wiki/workspaces.js.map

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

package/dist/core/wiki/write-strategy.d.ts

@@ -0,0 +1,70 @@
+import type Database from "better-sqlite3";
+import { ObsidianService } from "../../services/obsidian.js";
+import type { WikiWorkspaceRow } from "./workspaces.js";
+/**
+ * WikiWriteStrategy — encapsulates how the daemon persists a write into
+ * a wiki workspace.
+ *
+ * - `internal` workspaces always use the local-fs path (atomic write).
+ * - `external` workspaces start in `auto` and probe: try direct fs first,
+ *   fall back to Obsidian-CLI on EPERM / EACCES / EROFS (typical for
+ *   iCloud-sandboxed vaults). The resolved strategy is persisted to
+ *   `wiki_workspaces.write_strategy` so subsequent writes skip the probe.
+ *
+ * WIKI_BUILDER_DESIGN.md §P2.B, §8 (external-mode iCloud fallback).
+ *
+ * The module owns ZERO state besides the per-workspace ObsidianService
+ * instance map; the resolved strategy lives in the DB row. This keeps
+ * the probe outcome durable across daemon restarts.
+ */
+export type WikiResolvedStrategy = "fs" | "cli";
+export interface WikiWriteStrategyResolverDeps {
+    db: Database.Database;
+    obsidian: ObsidianService;
+}
+export interface WriteWikiFileInput {
+    workspace: WikiWorkspaceRow;
+    relPath: string;
+    content: string;
+}
+export interface WriteWikiFileOutcome {
+    strategy: WikiResolvedStrategy;
+    durationMs: number;
+}
+export declare class WikiWriteStrategyResolver {
+    private readonly deps;
+    constructor(deps: WikiWriteStrategyResolverDeps);
+    /**
+     * Resolve the strategy a write should use for a workspace.
+     *
+     * Internal-mode rows are always `fs`. External-mode rows return their
+     * cached `write_strategy` when it is `fs` or `cli`; `auto` (the post-
+     * setup default) means "probe on the first write". The probe happens
+     * inside `writeFile()` rather than here, because we only know the
+     * outcome after attempting the write — surfacing it ahead of time
+     * would duplicate the failure path.
+     */
+    resolveStrategy(workspace: WikiWorkspaceRow): "fs" | "cli" | "auto";
+    writeFile(input: WriteWikiFileInput): Promise<WriteWikiFileOutcome>;
+    private writeViaCli;
+    private persistResolved;
+}
+/**
+ * Health surface for `/api/health.wiki` — reports the per-workspace
+ * resolved strategy plus a one-shot CLI reachability probe.
+ */
+export interface WikiWriteStrategyHealth {
+    workspace: string;
+    kind: "internal" | "external";
+    strategy: "fs" | "cli" | "auto";
+    cliAvailable: boolean | null;
+}
+export declare function probeWikiWriteStrategyHealth(workspace: WikiWorkspaceRow, obsidian: ObsidianService): Promise<WikiWriteStrategyHealth>;
+/**
+ * Resolve the workspace-relative directory of a vault-local file. Exposed
+ * so the chokidar-driven `_index.md` cache can register the watcher path
+ * without duplicating the join.
+ */
+export declare function resolveWikiPath(workspace: WikiWorkspaceRow, relPath: string): string;
+export declare function indexCachePathFor(workspace: WikiWorkspaceRow): string;
+//# sourceMappingURL=write-strategy.d.ts.map

package/dist/core/wiki/write-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-strategy.d.ts","sourceRoot":"","sources":["../../../src/core/wiki/write-strategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGxD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,KAAK,CAAC;AAEhD,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,yBAAyB;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,6BAA6B;IAEhE;;;;;;;;;OASG;IACH,eAAe,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM;IAK7D,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAmC3D,WAAW;IA0BzB,OAAO,CAAC,eAAe;CAcxB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,GAAG,UAAU,CAAC;IAC9B,QAAQ,EAAE,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;IAChC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAsB,4BAA4B,CAChD,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,uBAAuB,CAAC,CAelC;AAWD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAErE"}

package/dist/core/wiki/write-strategy.js

@@ -0,0 +1,112 @@
+import { dirname, join, relative, resolve } from "node:path";
+import { writeFileAtomically } from "../atomic-write.js";
+const FALLBACK_ERROR_CODES = new Set(["EPERM", "EACCES", "EROFS", "EBUSY"]);
+export class WikiWriteStrategyResolver {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Resolve the strategy a write should use for a workspace.
+     *
+     * Internal-mode rows are always `fs`. External-mode rows return their
+     * cached `write_strategy` when it is `fs` or `cli`; `auto` (the post-
+     * setup default) means "probe on the first write". The probe happens
+     * inside `writeFile()` rather than here, because we only know the
+     * outcome after attempting the write — surfacing it ahead of time
+     * would duplicate the failure path.
+     */
+    resolveStrategy(workspace) {
+        if (workspace.kind === "internal")
+            return "fs";
+        return workspace.write_strategy;
+    }
+    async writeFile(input) {
+        const start = Date.now();
+        const strategy = this.resolveStrategy(input.workspace);
+        const fullPath = resolve(input.workspace.root_path, input.relPath);
+        const safe = ensureWithinRoot(input.workspace.root_path, fullPath);
+        if (!safe) {
+            throw Object.assign(new Error(`wiki write: path escapes workspace root: ${input.relPath}`), { code: "EWIKIPATH" });
+        }
+        if (strategy === "fs") {
+            writeFileAtomically(fullPath, ensureTrailingNewline(input.content));
+            return { strategy: "fs", durationMs: Date.now() - start };
+        }
+        if (strategy === "cli") {
+            await this.writeViaCli(input);
+            return { strategy: "cli", durationMs: Date.now() - start };
+        }
+        // strategy === "auto" — external workspace, no probe outcome cached.
+        try {
+            writeFileAtomically(fullPath, ensureTrailingNewline(input.content));
+            this.persistResolved(input.workspace, "fs");
+            return { strategy: "fs", durationMs: Date.now() - start };
+        }
+        catch (err) {
+            const code = err.code ?? "";
+            if (!FALLBACK_ERROR_CODES.has(code))
+                throw err;
+            await this.writeViaCli(input);
+            this.persistResolved(input.workspace, "cli");
+            return { strategy: "cli", durationMs: Date.now() - start };
+        }
+    }
+    async writeViaCli(input) {
+        if (!this.deps.obsidian.available) {
+            throw Object.assign(new Error("wiki write: Obsidian CLI is required for external-mode fallback but the service is not configured."), { code: "EWIKI_CLI_UNAVAILABLE" });
+        }
+        if (!(await this.deps.obsidian.isRunning())) {
+            throw Object.assign(new Error("wiki write: Obsidian app is not running; the CLI fallback cannot reach the sandboxed vault."), { code: "EWIKI_CLI_NOT_RUNNING" });
+        }
+        // The Obsidian CLI's `create path=… overwrite` is idempotent and
+        // accepts relative vault paths. We use the workspace root_path as the
+        // vault root, so the rel path passed straight through is correct.
+        await this.deps.obsidian.updateNote(input.relPath, ensureTrailingNewline(input.content));
+    }
+    persistResolved(workspace, strategy) {
+        if (workspace.write_strategy === strategy)
+            return;
+        this.deps.db
+            .prepare(`UPDATE wiki_workspaces
+           SET write_strategy = ?, updated_at = CURRENT_TIMESTAMP
+         WHERE id = ?`)
+            .run(strategy, workspace.id);
+        workspace.write_strategy = strategy;
+    }
+}
+export async function probeWikiWriteStrategyHealth(workspace, obsidian) {
+    if (workspace.kind === "internal") {
+        return {
+            workspace: workspace.name,
+            kind: workspace.kind,
+            strategy: "fs",
+            cliAvailable: null,
+        };
+    }
+    return {
+        workspace: workspace.name,
+        kind: workspace.kind,
+        strategy: workspace.write_strategy,
+        cliAvailable: obsidian.available ? await obsidian.isRunning() : false,
+    };
+}
+function ensureTrailingNewline(content) {
+    return content.endsWith("\n") ? content : `${content}\n`;
+}
+function ensureWithinRoot(root, fullPath) {
+    const rel = relative(root, fullPath);
+    return !rel.startsWith("..") && !rel.startsWith("/");
+}
+/**
+ * Resolve the workspace-relative directory of a vault-local file. Exposed
+ * so the chokidar-driven `_index.md` cache can register the watcher path
+ * without duplicating the join.
+ */
+export function resolveWikiPath(workspace, relPath) {
+    return join(workspace.root_path, relPath);
+}
+export function indexCachePathFor(workspace) {
+    return dirname(resolveWikiPath(workspace, "20_wiki/_index.md"));
+}
+//# sourceMappingURL=write-strategy.js.map

package/dist/core/wiki/write-strategy.js.map

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

package/dist/core/workdir.d.ts

@@ -75,6 +75,11 @@ export declare function createSessionWorkdir(projectRoot: string, eventType: str
      *  during materialization so each skill's CURATION anchors resolve to
      *  the active overlay (or seed) JSON. */
     skillCurationDataDir?: string;
+    /** WIKI_BUILDER_DESIGN.md §P5.C — per-event wiki workspace name for
+     *  `{{vault_path}}` / `{{language}}` / `{{workspace_name}}` /
+     *  `{{schema_version}}` token substitution in skill bodies and the
+     *  wiki-agent profile. Undefined falls back to the default workspace. */
+    wikiWorkspaceName?: string;
 }): string;
 export declare function ensureSessionWorkdir(projectRoot: string, dataDir: string, dbSessionId: number, eventType: string, options?: {
     backendId?: BackendId;
@@ -104,6 +109,8 @@ export declare function ensureSessionWorkdir(projectRoot: string, dataDir: strin
         skillSlugs: readonly string[] | null;
         profileBody: string | null;
     };
+    /** WIKI_BUILDER_DESIGN.md §P5.C — see createSessionWorkdir options. */
+    wikiWorkspaceName?: string;
 }): string;
 /**
  * Get the deterministic path for a session workdir (without creating it).
@@ -131,7 +138,7 @@ export declare function cleanupStaleWorkdirs(dataDir: string, activeSessionIds:
  * Idempotent — if the files already exist for this backend, it overwrites
  * with the latest content (which is cheap since the source hasn't changed).
  */
-export declare function ensureBackendMaterialized(projectRoot: string, sessionDir: string, backendId: BackendId, eventType: string, processKey?: ProcessKey, configuredServices?: ReadonlySet<string>, mailAccounts?: readonly import("../services/mail/provider.js").MailAccount[], integrations?: Partial<Record<IntegrationKey, IntegrationState>>, character?: string): void;
+export declare function ensureBackendMaterialized(projectRoot: string, sessionDir: string, backendId: BackendId, eventType: string, processKey?: ProcessKey, configuredServices?: ReadonlySet<string>, mailAccounts?: readonly import("../services/mail/provider.js").MailAccount[], integrations?: Partial<Record<IntegrationKey, IntegrationState>>, character?: string, wikiWorkspaceName?: string): void;
 /**
  * Validate that every delegated-mode skill AND task-flow variant required by
  * the currently-stored integration state exists on disk. Returns the missing

package/dist/core/workdir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workdir.d.ts","sourceRoot":"","sources":["../../src/core/workdir.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAeH,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,UAAU,EACX,MAAM,eAAe,CAAC;AAqBvB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAgD7E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAErD;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAErD;AAED,KAAK,UAAU,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AActE,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAoB5B;AA+ED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,SAAS,OAAO,8BAA8B,EAAE,WAAW,EAAE,CAAC;IAC7E,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACjE,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;6CAEyC;IACzC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,GACA,MAAM,CAyDR;AAyBD,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,SAAS,OAAO,8BAA8B,EAAE,WAAW,EAAE,CAAC;IAC7E,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACjE,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,EAAE;QACT,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;CACH,GACA,MAAM,CAwGR;AA2CD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAElF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAO9D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,GAC5B,MAAM,CA0BR;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,UAAU,EACvB,kBAAkB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EACxC,YAAY,CAAC,EAAE,SAAS,OAAO,8BAA8B,EAAE,WAAW,EAAE,EAC5E,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,EAChE,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI,CAuBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,GAC9D;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAG3C;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAQ9D;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,YAAY,EAAE,SAAS,OAAO,8BAA8B,EAAE,WAAW,EAAE,CAAC;IAC5E;;;;;;;;;OASG;IACH,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAChE;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,8BAA8B,GACrC,8BAA8B,CAwChC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE;IACN,yBAAyB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C,EACD,mBAAmB,CAAC,EAAE;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,GAAG,CAAC,MAAM,CAAC,CASb"}
+{"version":3,"file":"workdir.d.ts","sourceRoot":"","sources":["../../src/core/workdir.ts"],"names":[],"mappings":"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"}

package/dist/core/workdir.js

@@ -216,6 +216,7 @@ export function createSessionWorkdir(projectRoot, eventType, userSkillsDir, opti
             sessionDir,
             eventType,
             processKey: options?.processKey,
+            wikiWorkspaceName: options?.wikiWorkspaceName,
         });
         writeInstructionAssetStamp(sessionDir, computeInstructionAssetStatus(projectRoot));
         ensureDaemonApiCli(sessionDir);
@@ -293,6 +294,7 @@ export function ensureSessionWorkdir(projectRoot, dataDir, dbSessionId, eventTyp
             sessionDir,
             eventType,
             processKey: options?.processKey,
+            wikiWorkspaceName: options?.wikiWorkspaceName,
             ...(options?.override ? { override: options.override } : {}),
         });
         writeInstructionAssetStamp(sessionDir, computeInstructionAssetStatus(projectRoot));
@@ -444,13 +446,14 @@ export function cleanupStaleWorkdirs(dataDir, activeSessionIds) {
  * Idempotent — if the files already exist for this backend, it overwrites
  * with the latest content (which is cheap since the source hasn't changed).
  */
-export function ensureBackendMaterialized(projectRoot, sessionDir, backendId, eventType, processKey, configuredServices, mailAccounts, integrations, character) {
+export function ensureBackendMaterialized(projectRoot, sessionDir, backendId, eventType, processKey, configuredServices, mailAccounts, integrations, character, wikiWorkspaceName) {
     const compiler = new SkillsCompiler(projectRoot, configuredServices, mailAccounts, integrations, character);
     const deployed = compiler.materializeSessionBundle({
         backendId,
         sessionDir,
         eventType,
         processKey,
+        wikiWorkspaceName,
     });
     writeInstructionAssetStamp(sessionDir, computeInstructionAssetStatus(projectRoot));
     ensureDaemonApiCli(sessionDir);