@thjodann/wk 1.0.0

package/dist/cli/commands/setup.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSetupCommand = registerSetupCommand;
+const helpers_1 = require("../helpers");
+const automation_1 = require("../../core/automation");
+const paths_1 = require("../../core/paths");
+function registerSetupCommand(program) {
+    program
+        .command("setup")
+        .description("Set up portable Wikiwiki automation scripts and repo defaults.")
+        .option("--profile <profile>", "wiki profile: mixed, user, developer")
+        .option("--audience <audience>", "site audience: all, user, developer")
+        .option("--source-base-url <url>", "base URL for source file links")
+        .option("--force", "overwrite conflicting Wikiwiki package scripts")
+        .option("--json", "print machine-readable output")
+        .action((options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const result = (0, automation_1.setupWikiwiki)(root, options);
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        console.log("Wikiwiki setup complete.");
+        console.log(`Profile: ${result.config.wiki_profile}`);
+        console.log(`Audience: ${result.config.site_audience}`);
+        if (result.config.source_base_url) {
+            console.log(`Source base URL: ${result.config.source_base_url}`);
+        }
+        if (result.integrations?.beads?.detected) {
+            const state = result.integrations.beads.available
+                ? "available"
+                : result.integrations.beads.error === "beads_auto_read_skipped" ? "detected; detailed reads skipped"
+                    : result.integrations.beads.enabled ? "detected but unavailable" : "disabled";
+            console.log(`Beads: ${state}`);
+        }
+        if (result.package_json.present) {
+            const changed = [
+                ...result.package_json.scripts_added.map((name) => `${name} added`),
+                ...result.package_json.scripts_overwritten.map((name) => `${name} overwritten`)
+            ];
+            console.log(changed.length > 0 ? `Scripts: ${changed.join(", ")}` : "Scripts: already current");
+        }
+        else {
+            console.log("No package.json found. Copy these commands into your project automation if useful:");
+            for (const [name, command] of Object.entries(result.package_json.copy_commands)) {
+                console.log(`- ${name}: ${command}`);
+            }
+        }
+        console.log("Next: run `wk theme preview --json`, then `wk theme init` to create a branded .wikiwiki/site-theme.json from repo identity and app styles.");
+        console.log("For an impressive first install, seed high-signal records, then run `wk validate`, `wk render`, and `wk site`.");
+    });
+}
+//# sourceMappingURL=setup.js.map

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

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

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

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

package/dist/cli/commands/site.js

@@ -0,0 +1,47 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSiteCommand = registerSiteCommand;
+const path_1 = __importDefault(require("path"));
+const helpers_1 = require("../helpers");
+const paths_1 = require("../../core/paths");
+const site_1 = require("../../core/site");
+const store_1 = require("../../core/store");
+function registerSiteCommand(program) {
+    program
+        .command("site")
+        .description("Generate a static human-facing Wikiwiki site into wiki-site/.")
+        .option("--source-base-url <url>", "base URL for source file links, for example https://github.com/OWNER/REPO/blob/main/")
+        .option("--audience <audience>", "site audience: all, user, developer")
+        .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 siteOptions = (0, site_1.resolveSiteOptions)(root, { sourceBaseUrl: options.sourceBaseUrl, audience: options.audience });
+        const files = (0, site_1.renderSite)(root, siteOptions);
+        const siteFiles = files.map((file) => (0, paths_1.relativeReportPath)(root, file));
+        const result = {
+            ok: true,
+            site_path: (0, paths_1.reportPath)((0, paths_1.sitePath)(root)),
+            entrypoint: (0, paths_1.reportPath)(path_1.default.join((0, paths_1.sitePath)(root), "index.html")),
+            output_behavior: "replaces wiki-site/",
+            source_base_url: siteOptions.sourceBaseUrl ?? null,
+            audience: siteOptions.audience,
+            rendered_files: siteFiles,
+            site_files: siteFiles
+        };
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        console.log("Rendered Wikiwiki site:");
+        console.log(`- ${(0, paths_1.relativeReportPath)(root, path_1.default.join((0, paths_1.sitePath)(root), "index.html"))}`);
+        console.log(`- ${result.rendered_files.length} generated files`);
+        console.log("- Existing wiki-site/ contents were replaced");
+    });
+}
+//# sourceMappingURL=site.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../../src/cli/commands/site.ts"],"names":[],"mappings":";;;;;AAOA,kDAqCC;AA5CD,gDAAwB;AAExB,wCAAuC;AACvC,4CAA0F;AAC1F,0CAAiE;AACjE,4CAAiD;AAEjD,SAAgB,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,+DAA+D,CAAC;SAC5E,MAAM,CAAC,yBAAyB,EAAE,sFAAsF,CAAC;SACzH,MAAM,CAAC,uBAAuB,EAAE,qCAAqC,CAAC;SACtE,MAAM,CAAC,QAAQ,EAAE,+BAA+B,CAAC;SACjD,MAAM,CAAC,CAAC,OAA4F,EAAE,EAAE;QACvG,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,WAAW,GAAG,IAAA,yBAAkB,EAAC,IAAI,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnH,MAAM,KAAK,GAAG,IAAA,iBAAU,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,0BAAkB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG;YACb,EAAE,EAAE,IAAI;YACR,SAAS,EAAE,IAAA,kBAAU,EAAC,IAAA,gBAAQ,EAAC,IAAI,CAAC,CAAC;YACrC,UAAU,EAAE,IAAA,kBAAU,EAAC,cAAI,CAAC,IAAI,CAAC,IAAA,gBAAQ,EAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;YAC/D,eAAe,EAAE,qBAAqB;YACtC,eAAe,EAAE,WAAW,CAAC,aAAa,IAAI,IAAI;YAClD,QAAQ,EAAE,WAAW,CAAC,QAAQ;YAC9B,cAAc,EAAE,SAAS;YACzB,UAAU,EAAE,SAAS;SACtB,CAAC;QAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,IAAA,mBAAS,EAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAA,0BAAkB,EAAC,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,IAAA,gBAAQ,EAAC,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;QACtF,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,cAAc,CAAC,MAAM,kBAAkB,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;AACP,CAAC"}

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

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

package/dist/cli/commands/spin.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSpinCommand = registerSpinCommand;
+const helpers_1 = require("../helpers");
+const config_1 = require("../../core/config");
+const paths_1 = require("../../core/paths");
+const profiles_1 = require("../../core/profiles");
+const spin_1 = require("../../core/spin");
+function registerSpinCommand(program) {
+    program
+        .command("spin")
+        .description("Inspect current repo changes and suggest knowledge updates.")
+        .option("--profile <profile>", "first-pass wiki profile: mixed, user, developer")
+        .option("--json", "print machine-readable output")
+        .action((options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const config = (0, config_1.readWikiwikiConfig)(root);
+        const profile = (0, profiles_1.parseWikiProfile)(options.profile ?? config.wiki_profile, "mixed");
+        const result = (0, spin_1.createSpinResult)(root, profile);
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        console.log(`Changed files: ${result.changed_files.length}`);
+        for (const file of result.changed_files) {
+            console.log(`- ${file}`);
+        }
+        if (result.suggested_updates.length > 0) {
+            console.log("\nSuggested updates:");
+            for (const update of result.suggested_updates) {
+                console.log(`- ${update.type}: ${update.reason}`);
+                console.log(`  ${update.command_hint}`);
+            }
+        }
+        console.log(`\nFirst-pass profile: ${result.profile.name}`);
+        console.log(result.profile.description);
+        console.log("Target counts:");
+        for (const [type, count] of Object.entries(result.profile.target_counts)) {
+            console.log(`- ${type}: ${count}`);
+        }
+    });
+}
+//# sourceMappingURL=spin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spin.js","sourceRoot":"","sources":["../../../src/cli/commands/spin.ts"],"names":[],"mappings":";;AAOA,kDAqCC;AA3CD,wCAAuC;AACvC,8CAAuD;AACvD,4CAAgD;AAChD,kDAAuD;AACvD,0CAAmD;AAEnD,SAAgB,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,6DAA6D,CAAC;SAC1E,MAAM,CAAC,qBAAqB,EAAE,iDAAiD,CAAC;SAChF,MAAM,CAAC,QAAQ,EAAE,+BAA+B,CAAC;SACjD,MAAM,CAAC,CAAC,OAA6C,EAAE,EAAE;QACxD,MAAM,IAAI,GAAG,IAAA,oBAAY,GAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAA,2BAAkB,EAAC,IAAI,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,IAAA,2BAAgB,EAAC,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAClF,MAAM,MAAM,GAAG,IAAA,uBAAgB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAE/C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,IAAA,mBAAS,EAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,MAAM,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACpC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBAC9C,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;gBAClD,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

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

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

package/dist/cli/commands/status.js

@@ -0,0 +1,63 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerStatusCommand = registerStatusCommand;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const helpers_1 = require("../helpers");
+const beads_1 = require("../../core/beads");
+const config_1 = require("../../core/config");
+const git_1 = require("../../core/git");
+const paths_1 = require("../../core/paths");
+const site_1 = require("../../core/site");
+const renderer_1 = require("../../core/renderer");
+const schemas_1 = require("../../core/schemas");
+const store_1 = require("../../core/store");
+function registerStatusCommand(program) {
+    program
+        .command("status")
+        .description("Show Wikiwiki repo status.")
+        .option("--json", "print machine-readable output")
+        .action((options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const initialized = (0, store_1.isInitialized)(root);
+        const counts = initialized ? (0, store_1.recordCounts)(root) : emptyCounts();
+        const generatedFiles = renderer_1.wikiPageFileNames
+            .map((fileName) => path_1.default.join((0, paths_1.wikiPath)(root), fileName))
+            .filter((file) => fs_1.default.existsSync(file));
+        const generatedSiteFiles = site_1.siteStaticPageFileNames
+            .map((fileName) => path_1.default.join((0, paths_1.sitePath)(root), fileName))
+            .filter((file) => fs_1.default.existsSync(file));
+        const integrations = (0, beads_1.readIntegrations)(root, (0, config_1.readWikiwikiConfig)(root));
+        const result = {
+            repo_root: (0, paths_1.reportPath)(root),
+            initialized,
+            store_path: (0, paths_1.reportPath)((0, paths_1.wikiwikiPath)(root)),
+            wiki_path: (0, paths_1.reportPath)((0, paths_1.wikiPath)(root)),
+            site_path: (0, paths_1.reportPath)((0, paths_1.sitePath)(root)),
+            records: counts,
+            generated_files: generatedFiles.map((file) => (0, paths_1.relativeReportPath)(root, file)),
+            generated_site_files: generatedSiteFiles.map((file) => (0, paths_1.relativeReportPath)(root, file)),
+            git: {
+                changed_files: (0, git_1.changedFiles)(root),
+                suppressed_changed_files: (0, git_1.suppressedGitStatusSummary)(root)
+            },
+            ...((0, beads_1.shouldReportIntegrations)(integrations) ? { integrations } : {})
+        };
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        console.log(`Repo: ${root}`);
+        console.log(`Wikiwiki: ${initialized ? "initialized" : "not initialized"}`);
+        console.log(`Records: ${schemas_1.recordTypes.map((type) => `${type}=${counts[type]}`).join(", ")}`);
+        console.log(`Site: ${generatedSiteFiles.length ? "generated" : "not generated"}`);
+        console.log(`Changed files: ${result.git.changed_files.length}`);
+    });
+}
+function emptyCounts() {
+    return Object.fromEntries(schemas_1.recordTypes.map((type) => [type, 0]));
+}
+//# sourceMappingURL=status.js.map

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

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

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

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

package/dist/cli/commands/symbol.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSymbolCommand = registerSymbolCommand;
+const helpers_1 = require("../helpers");
+const ids_1 = require("../../core/ids");
+const paths_1 = require("../../core/paths");
+const store_1 = require("../../core/store");
+function registerSymbolCommand(program) {
+    const symbol = program.command("symbol").description("Manage code symbols.");
+    (0, helpers_1.addCommonRecordOptions)(symbol
+        .command("add")
+        .description("Add a symbol.")
+        .option("--name <name>", "symbol name")
+        .option("--kind <kind>", "symbol kind")
+        .option("--file <file>", "source file")
+        .option("--summary <summary>", "symbol summary")
+        .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 timestamps = (0, helpers_1.timestampPair)(payload);
+        const record = {
+            type: "symbol",
+            id: (0, helpers_1.stringValue)(payload, "id", (0, ids_1.createId)("symbol")),
+            name: options.name ?? (0, helpers_1.stringValue)(payload, "name"),
+            kind: options.kind ?? (0, helpers_1.stringValue)(payload, "kind"),
+            file: options.file ?? (0, helpers_1.stringValue)(payload, "file"),
+            summary: options.summary ?? (0, helpers_1.stringValue)(payload, "summary"),
+            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: timestamps.created_at,
+            updated_at: timestamps.updated_at
+        };
+        const added = (0, store_1.appendRecord)(root, "symbol", record);
+        (0, helpers_1.printAdded)("symbol", added.id, (0, helpers_1.wantsJsonOutput)(options.json), added);
+    });
+}
+//# sourceMappingURL=symbol.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"symbol.js","sourceRoot":"","sources":["../../../src/cli/commands/symbol.ts"],"names":[],"mappings":";;AAiBA,sDAgCC;AAhDD,wCAUoB;AACpB,wCAA0C;AAC1C,4CAAgD;AAChD,4CAAgD;AAGhD,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAE7E,IAAA,gCAAsB,EACpB,MAAM;SACH,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,eAAe,CAAC;SAC5B,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC;SACtC,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC;SACtC,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC;SACtC,MAAM,CAAC,qBAAqB,EAAE,gBAAgB,CAAC;SAC/C,MAAM,CAAC,kBAAkB,EAAE,sDAAsD,CAAC,CACtF,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QACnB,MAAM,IAAI,GAAG,IAAA,oBAAY,GAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAA,wBAAc,EAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAA,uBAAa,EAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAiB;YAC3B,IAAI,EAAE,QAAQ;YACd,EAAE,EAAE,IAAA,qBAAW,EAAC,OAAO,EAAE,IAAI,EAAE,IAAA,cAAQ,EAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAA,qBAAW,EAAC,OAAO,EAAE,MAAM,CAAC;YAClD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAA,qBAAW,EAAC,OAAO,EAAE,MAAM,CAAC;YAClD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAA,qBAAW,EAAC,OAAO,EAAE,MAAM,CAAC;YAClD,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAA,qBAAW,EAAC,OAAO,EAAE,SAAS,CAAC;YAC3D,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,UAAU,CAAC,UAAU;YACjC,UAAU,EAAE,UAAU,CAAC,UAAU;SAClC,CAAC;QAEF,MAAM,KAAK,GAAG,IAAA,oBAAY,EAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,IAAA,oBAAU,EAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,IAAA,yBAAe,EAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;AACL,CAAC"}

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

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

package/dist/cli/commands/theme.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerThemeCommand = registerThemeCommand;
+const helpers_1 = require("../helpers");
+const paths_1 = require("../../core/paths");
+const theme_1 = require("../../core/theme");
+function registerThemeCommand(program) {
+    const command = program
+        .command("theme")
+        .description("Create or preview a project identity theme for the generated site.");
+    addThemeOptions(command
+        .command("preview")
+        .description("Preview the inferred project theme without writing files."))
+        .option("--json", "print machine-readable output")
+        .action((options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const result = (0, theme_1.previewTheme)(root, options);
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        console.log("Previewed Wikiwiki theme.");
+        console.log(`Mood: ${result.mood}`);
+        console.log(`Project: ${result.theme.project_name}`);
+        console.log(`Theme file: ${result.theme_path}${result.exists ? " (exists)" : ""}`);
+        console.log(JSON.stringify(result.theme, null, 2));
+    });
+    addThemeOptions(command
+        .command("init")
+        .description("Write .wikiwiki/site-theme.json for this project."))
+        .option("--force", "overwrite an existing .wikiwiki/site-theme.json")
+        .option("--json", "print machine-readable output")
+        .action((options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const result = (0, theme_1.writeTheme)(root, options);
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+            return;
+        }
+        console.log(result.overwritten ? "Overwrote Wikiwiki theme." : "Created Wikiwiki theme.");
+        console.log(`Mood: ${result.mood}`);
+        console.log(`Project: ${result.theme.project_name}`);
+        console.log(`Theme file: ${result.theme_path}`);
+    });
+}
+function addThemeOptions(command) {
+    return command
+        .option("--mood <mood>", `theme mood: ${theme_1.themeMoods.join(", ")}`)
+        .option("--project-name <name>", "project name for the generated site")
+        .option("--description <text>", "project description for the generated site");
+}
+//# sourceMappingURL=theme.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/cli/commands/theme.ts"],"names":[],"mappings":";;AAaA,oDA8CC;AA1DD,wCAAuC;AACvC,4CAAgD;AAChD,4CAAwE;AAUxE,SAAgB,oBAAoB,CAAC,OAAgB;IACnD,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,oEAAoE,CAAC,CAAC;IAErF,eAAe,CACb,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,2DAA2D,CAAC,CAC5E;SACE,MAAM,CAAC,QAAQ,EAAE,+BAA+B,CAAC;SACjD,MAAM,CAAC,CAAC,OAAwB,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG,IAAA,oBAAY,GAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAA,oBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,IAAA,mBAAS,EAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEL,eAAe,CACb,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mDAAmD,CAAC,CACpE;SACE,MAAM,CAAC,SAAS,EAAE,iDAAiD,CAAC;SACpE,MAAM,CAAC,QAAQ,EAAE,+BAA+B,CAAC;SACjD,MAAM,CAAC,CAAC,OAAwB,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG,IAAA,oBAAY,GAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,IAAA,mBAAS,EAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;QAC1F,OAAO,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,YAAY,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,eAAe,CAAC,OAAgB;IACvC,OAAO,OAAO;SACX,MAAM,CAAC,eAAe,EAAE,eAAe,kBAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SAC/D,MAAM,CAAC,uBAAuB,EAAE,qCAAqC,CAAC;SACtE,MAAM,CAAC,sBAAsB,EAAE,4CAA4C,CAAC,CAAC;AAClF,CAAC"}

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

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

package/dist/cli/commands/validate.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerValidateCommand = registerValidateCommand;
+const helpers_1 = require("../helpers");
+const paths_1 = require("../../core/paths");
+const validator_1 = require("../../core/validator");
+function registerValidateCommand(program) {
+    program
+        .command("validate")
+        .description("Validate Wikiwiki storage and generated wiki rendering.")
+        .option("--json", "print machine-readable output")
+        .action((options) => {
+        const root = (0, paths_1.findRepoRoot)();
+        const result = (0, validator_1.validateWikiwiki)(root);
+        if (options.json) {
+            (0, helpers_1.printJson)(result);
+        }
+        else if (result.valid) {
+            console.log("Wikiwiki validation passed.");
+            if (result.warnings.length > 0) {
+                console.log("\nWarnings:");
+                for (const warning of result.warnings) {
+                    console.log(`- ${warning}`);
+                }
+            }
+        }
+        else {
+            console.error("Wikiwiki validation failed.");
+            for (const error of result.errors) {
+                console.error(`- ${error}`);
+            }
+            if (result.warnings.length > 0) {
+                console.error("\nWarnings:");
+                for (const warning of result.warnings) {
+                    console.error(`- ${warning}`);
+                }
+            }
+        }
+        if (!result.valid) {
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=validate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":";;AAKA,0DAoCC;AAxCD,wCAAuC;AACvC,4CAAgD;AAChD,oDAAwD;AAExD,SAAgB,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,yDAAyD,CAAC;SACtE,MAAM,CAAC,QAAQ,EAAE,+BAA+B,CAAC;SACjD,MAAM,CAAC,CAAC,OAA2B,EAAE,EAAE;QACtC,MAAM,IAAI,GAAG,IAAA,oBAAY,GAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAA,4BAAgB,EAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,IAAA,mBAAS,EAAC,MAAM,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;gBAC3B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;YAC9B,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAC7B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;oBACtC,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/helpers.d.ts

@@ -0,0 +1,30 @@
+import { Command } from "commander";
+import type { AnyRecord, Authority, Confidence, RecordType, Source } from "../core/schemas";
+export type CommonRecordOptions = {
+    source?: Source;
+    authority?: Authority;
+    confidence?: Confidence;
+    files?: string | string[];
+    tags?: string | string[];
+    json?: boolean | string;
+};
+export declare function addCommonRecordOptions(command: Command): Command;
+export declare function wantsJsonOutput(value: unknown): boolean;
+export declare function parseJsonInput(value: unknown): Record<string, unknown>;
+export declare function stringValue(payload: Record<string, unknown>, key: string, fallback?: string): string;
+export declare function arrayValue(payload: Record<string, unknown>, key: string, fallback?: string[]): string[];
+export declare function parseList(value: string | string[] | undefined): string[];
+export declare function collectList(value: string, previous?: string[]): string[];
+export declare function commonRecordFields(options: CommonRecordOptions, payload: Record<string, unknown>): {
+    source: Source;
+    authority: Authority;
+    confidence: Confidence;
+};
+export declare function timestampPair(payload: Record<string, unknown>): {
+    created_at: string;
+    updated_at: string;
+};
+export declare function printJson(value: unknown): void;
+export declare function printAdded(type: string, id: string, json: boolean, record: unknown): void;
+export declare function parseRecordType(value: string): RecordType;
+export declare function recordTitle(record: AnyRecord): string;

package/dist/cli/helpers.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCommonRecordOptions = addCommonRecordOptions;
+exports.wantsJsonOutput = wantsJsonOutput;
+exports.parseJsonInput = parseJsonInput;
+exports.stringValue = stringValue;
+exports.arrayValue = arrayValue;
+exports.parseList = parseList;
+exports.collectList = collectList;
+exports.commonRecordFields = commonRecordFields;
+exports.timestampPair = timestampPair;
+exports.printJson = printJson;
+exports.printAdded = printAdded;
+exports.parseRecordType = parseRecordType;
+exports.recordTitle = recordTitle;
+const schemas_1 = require("../core/schemas");
+function addCommonRecordOptions(command) {
+    return command
+        .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("--files <files>", "comma-separated related files; repeatable", collectList, [])
+        .option("--tags <tags>", "comma-separated tags; repeatable", collectList, []);
+}
+function wantsJsonOutput(value) {
+    return value !== undefined && value !== false;
+}
+function parseJsonInput(value) {
+    if (typeof value !== "string") {
+        return {};
+    }
+    const parsed = JSON.parse(value);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("--json input must be a JSON object.");
+    }
+    return parsed;
+}
+function stringValue(payload, key, fallback = "") {
+    const value = payload[key];
+    return typeof value === "string" ? value : fallback;
+}
+function arrayValue(payload, key, fallback = []) {
+    const value = payload[key];
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === "string");
+    }
+    if (typeof value === "string") {
+        return parseList(value);
+    }
+    return fallback;
+}
+function parseList(value) {
+    if (!value) {
+        return [];
+    }
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => parseList(item));
+    }
+    return value
+        .split(",")
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+function collectList(value, previous = []) {
+    return [...previous, ...parseList(value)];
+}
+function commonRecordFields(options, payload) {
+    return {
+        source: (options.source ?? stringValue(payload, "source", "manual")),
+        authority: (options.authority ?? stringValue(payload, "authority", "agent")),
+        confidence: (options.confidence ?? stringValue(payload, "confidence", "medium"))
+    };
+}
+function timestampPair(payload) {
+    const now = new Date().toISOString();
+    return {
+        created_at: stringValue(payload, "created_at", now),
+        updated_at: stringValue(payload, "updated_at", now)
+    };
+}
+function printJson(value) {
+    console.log(JSON.stringify(value, null, 2));
+}
+function printAdded(type, id, json, record) {
+    if (json) {
+        printJson({ ok: true, record });
+        return;
+    }
+    console.log(`Added ${type}: ${id}`);
+}
+function parseRecordType(value) {
+    if (schemas_1.recordTypes.includes(value)) {
+        return value;
+    }
+    throw new Error(`Unknown record type: ${value}. Expected one of: ${schemas_1.recordTypes.join(", ")}.`);
+}
+function recordTitle(record) {
+    if (record.type === "note") {
+        return noteTitle(record);
+    }
+    if ("name" in record && typeof record.name === "string") {
+        return record.name;
+    }
+    if ("title" in record && typeof record.title === "string") {
+        return record.title;
+    }
+    if ("summary" in record && typeof record.summary === "string") {
+        return record.summary;
+    }
+    if ("body" in record && typeof record.body === "string") {
+        return conciseTitle(record.body);
+    }
+    if ("relationship" in record && typeof record.relationship === "string") {
+        return `${record.from} ${record.relationship} ${record.to}`;
+    }
+    return record.id;
+}
+function noteTitle(record) {
+    return record.title ?? `Note from ${record.created_at.slice(0, 10)}`;
+}
+function conciseTitle(value, maxLength = 80) {
+    const normalized = value.replace(/\s+/g, " ").trim();
+    if (normalized.length <= maxLength) {
+        return normalized;
+    }
+    const window = normalized.slice(0, maxLength + 1);
+    const wordBreak = window.lastIndexOf(" ");
+    const end = wordBreak >= 32 ? wordBreak : maxLength;
+    return `${normalized.slice(0, end).replace(/[\s,;:.-]+$/, "")}...`;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/cli/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/cli/helpers.ts"],"names":[],"mappings":";;AAaA,wDAOC;AAED,0CAEC;AAED,wCAWC;AAED,kCAOC;AAED,gCAeC;AAED,8BAaC;AAED,kCAEC;AAED,gDAaC;AAED,sCASC;AAED,8BAEC;AAED,gCAYC;AAED,0CAMC;AAED,kCA0BC;AAjKD,6CAA8C;AAY9C,SAAgB,sBAAsB,CAAC,OAAgB;IACrD,OAAO,OAAO;SACX,MAAM,CAAC,mBAAmB,EAAE,kDAAkD,CAAC;SAC/E,MAAM,CAAC,yBAAyB,EAAE,uCAAuC,CAAC;SAC1E,MAAM,CAAC,2BAA2B,EAAE,sCAAsC,CAAC;SAC3E,MAAM,CAAC,iBAAiB,EAAE,2CAA2C,EAAE,WAAW,EAAE,EAAE,CAAC;SACvF,MAAM,CAAC,eAAe,EAAE,kCAAkC,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,KAAK,CAAC;AAChD,CAAC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;IAC5C,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED,SAAgB,WAAW,CACzB,OAAgC,EAChC,GAAW,EACX,QAAQ,GAAG,EAAE;IAEb,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AACtD,CAAC;AAED,SAAgB,UAAU,CACxB,OAAgC,EAChC,GAAW,EACX,WAAqB,EAAE;IAEvB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAgB,SAAS,CAAC,KAAoC;IAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,SAAgB,WAAW,CAAC,KAAa,EAAE,WAAqB,EAAE;IAChE,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,SAAgB,kBAAkB,CAChC,OAA4B,EAC5B,OAAgC;IAMhC,OAAO;QACL,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAW;QAC9E,SAAS,EAAE,CAAC,OAAO,CAAC,SAAS,IAAI,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAc;QACzF,UAAU,EAAE,CAAC,OAAO,CAAC,UAAU,IAAI,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAe;KAC/F,CAAC;AACJ,CAAC;AAED,SAAgB,aAAa,CAAC,OAAgC;IAI5D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,OAAO;QACL,UAAU,EAAE,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC;QACnD,UAAU,EAAE,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,SAAgB,SAAS,CAAC,KAAc;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAgB,UAAU,CACxB,IAAY,EACZ,EAAU,EACV,IAAa,EACb,MAAe;IAEf,IAAI,IAAI,EAAE,CAAC;QACT,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,KAAK,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,SAAgB,eAAe,CAAC,KAAa;IAC3C,IAAK,qBAAiC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACvD,OAAO,KAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,wBAAwB,KAAK,sBAAsB,qBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChG,CAAC;AAED,SAAgB,WAAW,CAAC,MAAiB;IAC3C,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAED,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC1D,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,SAAS,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC9D,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,cAAc,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACxE,OAAO,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;IAC9D,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAAC,MAAkB;IACnC,OAAO,MAAM,CAAC,KAAK,IAAI,aAAa,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,SAAS,GAAG,EAAE;IACjD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,UAAU,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QACnC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,KAAK,CAAC;AACrE,CAAC"}

package/dist/core/articles.d.ts

@@ -0,0 +1,5 @@
+import type { ArticleRecord } from "./schemas";
+export declare function slugFromTitle(title: string): string;
+export declare function articleFileName(article: ArticleRecord): string;
+export declare function articleMarkdownFileName(article: ArticleRecord): string;
+export declare function safeFileName(value: string): string;

package/dist/core/articles.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slugFromTitle = slugFromTitle;
+exports.articleFileName = articleFileName;
+exports.articleMarkdownFileName = articleMarkdownFileName;
+exports.safeFileName = safeFileName;
+function slugFromTitle(title) {
+    const slug = title
+        .trim()
+        .replace(/['"]/g, "")
+        .replace(/[^a-z0-9:_-]+/gi, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    return slug || "article";
+}
+function articleFileName(article) {
+    return `${safeFileName(article.slug)}.html`;
+}
+function articleMarkdownFileName(article) {
+    return `${safeFileName(article.slug)}.md`;
+}
+function safeFileName(value) {
+    return value.replace(/[^a-z0-9._-]+/gi, "-");
+}
+//# sourceMappingURL=articles.js.map

package/dist/core/articles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"articles.js","sourceRoot":"","sources":["../../src/core/articles.ts"],"names":[],"mappings":";;AAEA,sCASC;AAED,0CAEC;AAED,0DAEC;AAED,oCAEC;AArBD,SAAgB,aAAa,CAAC,KAAa;IACzC,MAAM,IAAI,GAAG,KAAK;SACf,IAAI,EAAE;SACN,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAEzB,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC;AAED,SAAgB,eAAe,CAAC,OAAsB;IACpD,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;AAC9C,CAAC;AAED,SAAgB,uBAAuB,CAAC,OAAsB;IAC5D,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED,SAAgB,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC"}