@thjodann/wk 1.0.0

package/dist/cli/commands/installAgent.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerInstallAgentCommand = registerInstallAgentCommand;
+const fs_1 = __importDefault(require("fs"));
+const os_1 = __importDefault(require("os"));
+const path_1 = __importDefault(require("path"));
+const helpers_1 = require("../helpers");
+function registerInstallAgentCommand(program) {
+    program
+        .command("install-agent")
+        .description("Install Wikiwiki instructions for an agentic IDE.")
+        .argument("<target>", "agent target, currently: codex")
+        .option("--dest <path>", "destination skill directory")
+        .option("--yes", "write files without an interactive confirmation prompt")
+        .option("--force", "install even when the destination contains unknown files")
+        .option("--json", "print machine-readable output")
+        .action((target, options) => {
+        if (target !== "codex") {
+            throw new Error(`Unsupported agent target: ${target}. Expected: codex.`);
+        }
+        const source = bundledSkillPath();
+        const destination = path_1.default.resolve(options.dest ?? defaultCodexSkillPath());
+        const sourceFiles = listRelativeFiles(source);
+        const result = {
+            ok: Boolean(options.yes),
+            target,
+            source,
+            destination,
+            files: sourceFiles.map((file) => path_1.default.join(destination, file))
+        };
+        if (!options.yes) {
+            const command = `wk install-agent codex --dest ${JSON.stringify(destination)} --yes`;
+            if (options.json) {
+                (0, helpers_1.printJson)({
+                    ...result,
+                    ok: false,
+                    confirmation_required: true,
+                    command
+                });
+                return;
+            }
+            console.log("Wikiwiki can install the wk skill for Codex.");
+            console.log(`Destination: ${destination}`);
+            console.log(`Run this command to write files:\n${command}`);
+            return;
+        }
+        const destinationStatus = inspectDestination(destination, sourceFiles, Boolean(options.force));
+        installKnownFiles(source, destination, sourceFiles, Boolean(options.force));
+        if (options.json) {
+            (0, helpers_1.printJson)({
+                ...result,
+                force: Boolean(options.force),
+                overwritten_files: destinationStatus.knownFiles.map((file) => path_1.default.join(destination, file)),
+                unknown_files: destinationStatus.unknownFiles.map((file) => path_1.default.join(destination, file))
+            });
+            return;
+        }
+        console.log(`Installed wk agent skill to ${destination}`);
+    });
+}
+function bundledSkillPath() {
+    const candidates = [
+        path_1.default.resolve(__dirname, "../../../skills/wk"),
+        path_1.default.resolve(process.cwd(), "skills/wk")
+    ];
+    const found = candidates.find((candidate) => fs_1.default.existsSync(path_1.default.join(candidate, "SKILL.md")));
+    if (!found) {
+        throw new Error("Bundled wk skill not found.");
+    }
+    return found;
+}
+function defaultCodexSkillPath() {
+    const codexHome = process.env.CODEX_HOME || path_1.default.join(os_1.default.homedir(), ".codex");
+    return path_1.default.join(codexHome, "skills/wk");
+}
+function inspectDestination(destination, sourceFiles, force) {
+    if (!fs_1.default.existsSync(destination)) {
+        return { knownFiles: [], unknownFiles: [] };
+    }
+    const stat = fs_1.default.lstatSync(destination);
+    if (!stat.isDirectory()) {
+        throw new Error(`Destination exists and is not a directory: ${destination}`);
+    }
+    const sourceFileSet = new Set(sourceFiles);
+    const destinationFiles = listRelativeFiles(destination);
+    const knownFiles = destinationFiles.filter((file) => sourceFileSet.has(file));
+    const unknownFiles = destinationFiles.filter((file) => !sourceFileSet.has(file));
+    if (unknownFiles.length > 0 && !force) {
+        throw new Error(`Refusing to install wk skill because ${destination} contains unknown files: ${unknownFiles.join(", ")}. ` +
+            "Re-run with --force to keep those files and overwrite only bundled wk skill files.");
+    }
+    return { knownFiles, unknownFiles };
+}
+function installKnownFiles(source, destination, sourceFiles, force) {
+    fs_1.default.mkdirSync(destination, { recursive: true });
+    for (const file of sourceFiles) {
+        const sourceFile = path_1.default.join(source, file);
+        const destinationFile = path_1.default.join(destination, file);
+        fs_1.default.mkdirSync(path_1.default.dirname(destinationFile), { recursive: true });
+        if (fs_1.default.existsSync(destinationFile) && fs_1.default.lstatSync(destinationFile).isSymbolicLink()) {
+            if (!force) {
+                throw new Error(`Refusing to overwrite symlink at known wk skill path: ${destinationFile}. Re-run with --force to replace it.`);
+            }
+            fs_1.default.unlinkSync(destinationFile);
+        }
+        fs_1.default.copyFileSync(sourceFile, destinationFile);
+    }
+}
+function listRelativeFiles(root) {
+    const files = [];
+    function walk(directory) {
+        for (const entry of fs_1.default.readdirSync(directory, { withFileTypes: true })) {
+            const fullPath = path_1.default.join(directory, entry.name);
+            if (entry.isDirectory()) {
+                walk(fullPath);
+                continue;
+            }
+            files.push(toPosixPath(path_1.default.relative(root, fullPath)));
+        }
+    }
+    walk(root);
+    return files.sort();
+}
+function toPosixPath(file) {
+    return file.split(path_1.default.sep).join("/");
+}
+//# sourceMappingURL=installAgent.js.map

package/dist/cli/commands/installAgent.js.map

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

package/dist/cli/commands/link.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerLinkCommand(program: Command): void;

package/dist/cli/commands/link.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerLinkCommand = registerLinkCommand;
+const helpers_1 = require("../helpers");
+const ids_1 = require("../../core/ids");
+const paths_1 = require("../../core/paths");
+const store_1 = require("../../core/store");
+function registerLinkCommand(program) {
+    const link = program.command("link").description("Manage links between records or files.");
+    link
+        .command("add")
+        .description("Add a link.")
+        .option("--from <from>", "source record id or file")
+        .option("--to <to>", "target record id or file")
+        .option("--relationship <relationship>", "relationship name")
+        .option("--source <source>", "record source: manual, agent, git-diff, imported")
+        .option("--authority <authority>", "record authority: user, agent, system")
+        .option("--confidence <confidence>", "record confidence: low, medium, high")
+        .option("--json [payload]", "read input as JSON and print machine-readable output")
+        .action((options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const payload = (0, helpers_1.parseJsonInput)(options.json);
+        const record = {
+            type: "link",
+            id: (0, helpers_1.stringValue)(payload, "id", (0, ids_1.createId)("link")),
+            from: options.from ?? (0, helpers_1.stringValue)(payload, "from"),
+            to: options.to ?? (0, helpers_1.stringValue)(payload, "to"),
+            relationship: options.relationship ?? (0, helpers_1.stringValue)(payload, "relationship"),
+            ...(0, helpers_1.commonRecordFields)(options, payload),
+            created_at: (0, helpers_1.stringValue)(payload, "created_at", new Date().toISOString())
+        };
+        const added = (0, store_1.appendRecord)(root, "link", record);
+        (0, helpers_1.printAdded)("link", added.id, (0, helpers_1.wantsJsonOutput)(options.json), added);
+    });
+}
+//# sourceMappingURL=link.js.map

package/dist/cli/commands/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../../src/cli/commands/link.ts"],"names":[],"mappings":";;AAaA,kDA6BC;AAzCD,wCAMoB;AACpB,wCAA0C;AAC1C,4CAAgD;AAChD,4CAAgD;AAGhD,SAAgB,mBAAmB,CAAC,OAAgB;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,wCAAwC,CAAC,CAAC;IAE3F,IAAI;SACD,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,aAAa,CAAC;SAC1B,MAAM,CAAC,eAAe,EAAE,0BAA0B,CAAC;SACnD,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;SAC/C,MAAM,CAAC,+BAA+B,EAAE,mBAAmB,CAAC;SAC5D,MAAM,CAAC,mBAAmB,EAAE,kDAAkD,CAAC;SAC/E,MAAM,CAAC,yBAAyB,EAAE,uCAAuC,CAAC;SAC1E,MAAM,CAAC,2BAA2B,EAAE,sCAAsC,CAAC;SAC3E,MAAM,CAAC,kBAAkB,EAAE,sDAAsD,CAAC;SAClF,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QAClB,MAAM,IAAI,GAAG,IAAA,oBAAY,GAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAA,wBAAc,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAe;YACzB,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,IAAA,qBAAW,EAAC,OAAO,EAAE,IAAI,EAAE,IAAA,cAAQ,EAAC,MAAM,CAAC,CAAC;YAChD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAA,qBAAW,EAAC,OAAO,EAAE,MAAM,CAAC;YAClD,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,IAAA,qBAAW,EAAC,OAAO,EAAE,IAAI,CAAC;YAC5C,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAA,qBAAW,EAAC,OAAO,EAAE,cAAc,CAAC;YAC1E,GAAG,IAAA,4BAAkB,EAAC,OAAO,EAAE,OAAO,CAAC;YACvC,UAAU,EAAE,IAAA,qBAAW,EAAC,OAAO,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;SACzE,CAAC;QAEF,MAAM,KAAK,GAAG,IAAA,oBAAY,EAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,IAAA,oBAAU,EAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,IAAA,yBAAe,EAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/note.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerNoteCommand(program: Command): void;

package/dist/cli/commands/note.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerNoteCommand = registerNoteCommand;
+const helpers_1 = require("../helpers");
+const ids_1 = require("../../core/ids");
+const paths_1 = require("../../core/paths");
+const store_1 = require("../../core/store");
+function registerNoteCommand(program) {
+    const note = program.command("note").description("Manage lightweight notes.");
+    (0, helpers_1.addCommonRecordOptions)(note
+        .command("add [body...]")
+        .description("Add a note.")
+        .option("--title <title>", "note title")
+        .option("--json [payload]", "read input as JSON and print machine-readable output")).action((bodyParts, options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const payload = (0, helpers_1.parseJsonInput)(options.json);
+        const body = (0, helpers_1.stringValue)(payload, "body", bodyParts?.join(" ") ?? "");
+        const title = options.title ?? (0, helpers_1.stringValue)(payload, "title");
+        const createdAt = (0, helpers_1.stringValue)(payload, "created_at", new Date().toISOString());
+        const record = {
+            type: "note",
+            id: (0, helpers_1.stringValue)(payload, "id", (0, ids_1.createId)("note")),
+            title: title || undefined,
+            body,
+            files: (0, helpers_1.parseList)(options.files).length ? (0, helpers_1.parseList)(options.files) : (0, helpers_1.arrayValue)(payload, "files"),
+            tags: (0, helpers_1.parseList)(options.tags).length ? (0, helpers_1.parseList)(options.tags) : (0, helpers_1.arrayValue)(payload, "tags"),
+            ...(0, helpers_1.commonRecordFields)(options, payload),
+            created_at: createdAt
+        };
+        const added = (0, store_1.appendRecord)(root, "note", record);
+        (0, helpers_1.printAdded)("note", added.id, (0, helpers_1.wantsJsonOutput)(options.json), added);
+    });
+}
+//# sourceMappingURL=note.js.map

package/dist/cli/commands/note.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note.js","sourceRoot":"","sources":["../../../src/cli/commands/note.ts"],"names":[],"mappings":";;AAgBA,kDA6BC;AA5CD,wCASoB;AACpB,wCAA0C;AAC1C,4CAAgD;AAChD,4CAAgD;AAGhD,SAAgB,mBAAmB,CAAC,OAAgB;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAE9E,IAAA,gCAAsB,EACpB,IAAI;SACD,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,aAAa,CAAC;SAC1B,MAAM,CAAC,iBAAiB,EAAE,YAAY,CAAC;SACvC,MAAM,CAAC,kBAAkB,EAAE,sDAAsD,CAAC,CACtF,CAAC,MAAM,CAAC,CAAC,SAA+B,EAAE,OAAO,EAAE,EAAE;QACpD,MAAM,IAAI,GAAG,IAAA,oBAAY,GAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAA,wBAAc,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAA,qBAAW,EAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAA,qBAAW,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,IAAA,qBAAW,EAAC,OAAO,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAe;YACzB,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,IAAA,qBAAW,EAAC,OAAO,EAAE,IAAI,EAAE,IAAA,cAAQ,EAAC,MAAM,CAAC,CAAC;YAChD,KAAK,EAAE,KAAK,IAAI,SAAS;YACzB,IAAI;YACJ,KAAK,EAAE,IAAA,mBAAS,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,mBAAS,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAA,oBAAU,EAAC,OAAO,EAAE,OAAO,CAAC;YAChG,IAAI,EAAE,IAAA,mBAAS,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,mBAAS,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAA,oBAAU,EAAC,OAAO,EAAE,MAAM,CAAC;YAC5F,GAAG,IAAA,4BAAkB,EAAC,OAAO,EAAE,OAAO,CAAC;YACvC,UAAU,EAAE,SAAS;SACtB,CAAC;QAEF,MAAM,KAAK,GAAG,IAAA,oBAAY,EAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,IAAA,oBAAU,EAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,IAAA,yBAAe,EAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/commands/pages.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerPagesCommand(program: Command): void;

package/dist/cli/commands/pages.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPagesCommand = registerPagesCommand;
+const helpers_1 = require("../helpers");
+const paths_1 = require("../../core/paths");
+const pages_1 = require("../../core/pages");
+function registerPagesCommand(program) {
+    const command = program
+        .command("pages")
+        .description("Scaffold GitHub Pages publishing for the generated Wikiwiki site.");
+    command
+        .command("init")
+        .description("Write a GitHub Actions workflow that publishes wiki-site/.")
+        .option("--audience <audience>", "site audience: all, user, developer")
+        .option("--branch <branch>", "branch that should publish the Pages site")
+        .option("--source-base-url <url>", "base URL for source file links")
+        .option("--workflow <path>", "workflow path", ".github/workflows/wikiwiki-pages.yml")
+        .option("--force", "overwrite an existing different Pages workflow")
+        .option("--json", "print machine-readable output")
+        .action((options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const result = (0, pages_1.initPages)(root, options);
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        if (result.already_current) {
+            console.log("Wikiwiki Pages workflow is already current.");
+        }
+        else if (result.overwritten) {
+            console.log("Overwrote Wikiwiki Pages workflow.");
+        }
+        else {
+            console.log("Created Wikiwiki Pages workflow.");
+        }
+        console.log(`Workflow: ${result.workflow_path}`);
+        console.log(`Branch: ${result.branch}`);
+        console.log(`Audience: ${result.audience}`);
+        console.log(`Source base URL: ${result.source_base_url}`);
+        console.log("Next steps:");
+        for (const step of result.next_steps) {
+            console.log(`- ${step}`);
+        }
+    });
+}
+//# sourceMappingURL=pages.js.map

package/dist/cli/commands/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../../src/cli/commands/pages.ts"],"names":[],"mappings":";;AAcA,oDAuCC;AApDD,wCAAuC;AACvC,4CAAgD;AAChD,4CAA6C;AAW7C,SAAgB,oBAAoB,CAAC,OAAgB;IACnD,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,mEAAmE,CAAC,CAAC;IAEpF,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,uBAAuB,EAAE,qCAAqC,CAAC;SACtE,MAAM,CAAC,mBAAmB,EAAE,2CAA2C,CAAC;SACxE,MAAM,CAAC,yBAAyB,EAAE,gCAAgC,CAAC;SACnE,MAAM,CAAC,mBAAmB,EAAE,eAAe,EAAE,sCAAsC,CAAC;SACpF,MAAM,CAAC,SAAS,EAAE,gDAAgD,CAAC;SACnE,MAAM,CAAC,QAAQ,EAAE,+BAA+B,CAAC;SACjD,MAAM,CAAC,CAAC,OAA4B,EAAE,EAAE;QACvC,MAAM,IAAI,GAAG,IAAA,oBAAY,GAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAA,iBAAS,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAExC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,IAAA,mBAAS,EAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;QAC7D,CAAC;aAAM,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACrC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/record.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerRecordCommand(program: Command): void;

package/dist/cli/commands/record.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRecordCommand = registerRecordCommand;
+const helpers_1 = require("../helpers");
+const paths_1 = require("../../core/paths");
+const store_1 = require("../../core/store");
+function registerRecordCommand(program) {
+    const record = program.command("record").description("Inspect and revise records.");
+    record
+        .command("list <type>")
+        .description("List active records by type.")
+        .option("--json", "print machine-readable output")
+        .action((typeArg, options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const type = (0, helpers_1.parseRecordType)(typeArg);
+        const records = (0, store_1.readRecords)(root, type);
+        const result = { type, records };
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        for (const item of records) {
+            console.log(`${item.id}\t${(0, helpers_1.recordTitle)(item)}`);
+        }
+    });
+    record
+        .command("get <type> <id>")
+        .description("Get one active record.")
+        .option("--json", "print machine-readable output")
+        .action((typeArg, id, options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const type = (0, helpers_1.parseRecordType)(typeArg);
+        const found = (0, store_1.readActiveRecord)(root, type, id);
+        if (!found) {
+            throw new Error(`Active ${type} record not found: ${id}`);
+        }
+        if (options.json) {
+            (0, helpers_1.printJson)({ type, record: found });
+            return;
+        }
+        console.log(`${found.id}\t${(0, helpers_1.recordTitle)(found)}`);
+    });
+    record
+        .command("update <type> <id>")
+        .description("Append a revised record with the same logical id.")
+        .requiredOption("--json <payload>", "JSON fields to merge into the active record")
+        .action((typeArg, id, options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const type = (0, helpers_1.parseRecordType)(typeArg);
+        const current = (0, store_1.readActiveRecord)(root, type, id);
+        if (!current) {
+            throw new Error(`Active ${type} record not found: ${id}`);
+        }
+        const payload = (0, helpers_1.parseJsonInput)(options.json);
+        const updated = buildUpdatedRecord(type, current, payload);
+        const added = (0, store_1.appendRecord)(root, type, updated);
+        (0, helpers_1.printJson)({ ok: true, record: added });
+    });
+    record
+        .command("delete <type> <id>")
+        .description("Append a deletion tombstone for an active record.")
+        .option("--reason <reason>", "reason for deletion")
+        .option("--json", "print machine-readable output")
+        .action((typeArg, id, options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const type = (0, helpers_1.parseRecordType)(typeArg);
+        const current = (0, store_1.readActiveRecord)(root, type, id);
+        if (!current) {
+            throw new Error(`Active ${type} record not found: ${id}`);
+        }
+        const now = new Date().toISOString();
+        const tombstone = {
+            ...current,
+            updated_at: now,
+            deleted_at: now,
+            delete_reason: options.reason ?? ""
+        };
+        const added = (0, store_1.appendRecord)(root, type, tombstone);
+        const result = { ok: true, record: added };
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        console.log(`Deleted ${type}: ${id}`);
+    });
+}
+function buildUpdatedRecord(type, current, payload) {
+    const now = new Date().toISOString();
+    const next = {
+        ...current,
+        ...payload,
+        type,
+        id: current.id,
+        created_at: current.created_at,
+        updated_at: typeof payload.updated_at === "string" ? payload.updated_at : now
+    };
+    delete next.deleted_at;
+    delete next.delete_reason;
+    return next;
+}
+//# sourceMappingURL=record.js.map

package/dist/cli/commands/record.js.map

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

package/dist/cli/commands/render.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerRenderCommand(program: Command): void;

package/dist/cli/commands/render.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRenderCommand = registerRenderCommand;
+const helpers_1 = require("../helpers");
+const paths_1 = require("../../core/paths");
+const renderer_1 = require("../../core/renderer");
+const store_1 = require("../../core/store");
+function registerRenderCommand(program) {
+    program
+        .command("render")
+        .description("Render structured records into Markdown wiki pages.")
+        .option("--json", "print machine-readable output")
+        .action((options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        if (!(0, store_1.isInitialized)(root)) {
+            throw new Error("Wikiwiki is not initialized. Run `wk init` first.");
+        }
+        const files = (0, renderer_1.renderWiki)(root);
+        const result = {
+            ok: true,
+            rendered_files: files.map((file) => (0, paths_1.relativeReportPath)(root, file))
+        };
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        console.log("Rendered wiki files:");
+        for (const file of result.rendered_files) {
+            console.log(`- ${file}`);
+        }
+    });
+}
+//# sourceMappingURL=render.js.map

package/dist/cli/commands/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/cli/commands/render.ts"],"names":[],"mappings":";;AAMA,sDA2BC;AAhCD,wCAAuC;AACvC,4CAAoE;AACpE,kDAAiD;AACjD,4CAAiD;AAEjD,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,QAAQ,EAAE,+BAA+B,CAAC;SACjD,MAAM,CAAC,CAAC,OAA2B,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,IAAA,oBAAY,GAAE,CAAC;QAC5B,IAAI,CAAC,IAAA,qBAAa,EAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,qBAAU,EAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG;YACb,EAAE,EAAE,IAAI;YACR,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,0BAAkB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SACpE,CAAC;QAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,IAAA,mBAAS,EAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/search.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerSearchCommand(program: Command): void;

package/dist/cli/commands/search.js

@@ -0,0 +1,125 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSearchCommand = registerSearchCommand;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const helpers_1 = require("../helpers");
+const paths_1 = require("../../core/paths");
+const store_1 = require("../../core/store");
+const schemas_1 = require("../../core/schemas");
+function registerSearchCommand(program) {
+    program
+        .command("search <query...>")
+        .description("Search active records and rendered wiki pages.")
+        .option("--json", "print machine-readable output")
+        .action((queryParts, options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const query = queryParts.join(" ").trim();
+        if (!query) {
+            throw new Error("Search query is required.");
+        }
+        const result = {
+            query,
+            records: searchRecords(root, query),
+            file_matches: searchRenderedFiles(root, query)
+        };
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        console.log(`Record matches: ${result.records.length}`);
+        for (const match of result.records) {
+            console.log(`- ${match.type} ${match.id}: ${match.title}`);
+        }
+        console.log(`File matches: ${result.file_matches.length}`);
+        for (const match of result.file_matches) {
+            console.log(`- ${match.file}`);
+        }
+    });
+}
+function searchRecords(root, query) {
+    const normalized = query.toLowerCase();
+    const records = (0, store_1.readAllRecords)(root);
+    const matches = [];
+    for (const type of schemas_1.recordTypes) {
+        for (const record of records[type]) {
+            const haystack = recordSearchText(record).toLowerCase();
+            if (!haystack.includes(normalized)) {
+                continue;
+            }
+            matches.push({
+                type,
+                id: record.id,
+                title: (0, helpers_1.recordTitle)(record),
+                snippet: snippet(recordSearchText(record), query),
+                source: record.source,
+                authority: record.authority,
+                confidence: record.confidence,
+                files: relatedFiles(record).map(paths_1.toPosixPath)
+            });
+        }
+    }
+    return matches;
+}
+function searchRenderedFiles(root, query) {
+    const outputPath = (0, paths_1.wikiPath)(root);
+    if (!fs_1.default.existsSync(outputPath)) {
+        return [];
+    }
+    const normalized = query.toLowerCase();
+    return listMarkdownFiles(outputPath)
+        .sort()
+        .flatMap((file) => {
+        const content = fs_1.default.readFileSync(file, "utf8");
+        if (!content.toLowerCase().includes(normalized)) {
+            return [];
+        }
+        return [{
+                file: (0, paths_1.relativeReportPath)(root, file),
+                snippet: snippet(content, query)
+            }];
+    });
+}
+function listMarkdownFiles(root) {
+    return fs_1.default
+        .readdirSync(root, { withFileTypes: true })
+        .flatMap((entry) => {
+        const file = path_1.default.join(root, entry.name);
+        if (entry.isDirectory()) {
+            return listMarkdownFiles(file);
+        }
+        return entry.isFile() && entry.name.endsWith(".md") ? [file] : [];
+    });
+}
+function recordSearchText(record) {
+    return Object.values(record)
+        .flatMap((value) => Array.isArray(value) ? value : [value])
+        .filter((value) => typeof value === "string")
+        .join(" ");
+}
+function relatedFiles(record) {
+    if ("files" in record && Array.isArray(record.files)) {
+        return record.files;
+    }
+    if ("file" in record && typeof record.file === "string") {
+        return [record.file];
+    }
+    return [];
+}
+function snippet(text, query) {
+    const normalizedText = text.toLowerCase();
+    const normalizedQuery = query.toLowerCase();
+    const index = normalizedText.indexOf(normalizedQuery);
+    if (index < 0) {
+        return text.slice(0, 160).trim();
+    }
+    const start = Math.max(0, index - 60);
+    const end = Math.min(text.length, index + query.length + 100);
+    const prefix = start > 0 ? "..." : "";
+    const suffix = end < text.length ? "..." : "";
+    return `${prefix}${text.slice(start, end).trim()}${suffix}`;
+}
+//# sourceMappingURL=search.js.map

package/dist/cli/commands/search.js.map

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

package/dist/cli/commands/setup.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function registerSetupCommand(program: Command): void;