@opencanon/canon 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OpenCanon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,37 @@
+# @opencanon/canon
+
+Canon worldbuilding CLI — scaffold, validate, and manage shared fiction universes.
+
+## Install
+
+```bash
+npm install -g @opencanon/canon
+```
+
+## CLI Usage
+
+```bash
+canon init                      # Scaffold a new canon repo
+canon new story <id>            # Create a new story from template
+canon new character <id>        # Create a new character
+canon new location <id>         # Create a new location
+canon check [dir]               # Run compliance checks (exit 1 on failure)
+canon lock [dir]                # Regenerate canon.lock.json
+```
+
+## Library Usage
+
+```ts
+import { validateRepo } from "@opencanon/canon"
+import { loadRepoFromFs } from "@opencanon/canon/adapters/fs"
+import { buildRepoModel } from "@opencanon/canon/adapters/github"
+```
+
+---
+
+- [English docs](docs/en/README.md)
+- [한국어 문서](docs/ko/README.md)
+
+## License
+
+MIT

package/dist/adapters/fs.d.ts

@@ -0,0 +1,5 @@
+import type { RepoModel } from "../core/types.js";
+/**
+ * Load a local canon repo into an I/O-free RepoModel.
+ */
+export declare function loadRepoFromFs(repoRoot: string): RepoModel;

package/dist/adapters/fs.js

@@ -0,0 +1,52 @@
+/**
+ * Filesystem adapter — reads a local canon repo into a RepoModel.
+ */
+import { readFileSync, readdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+function listSubDirs(dirPath) {
+    if (!existsSync(dirPath))
+        return [];
+    return readdirSync(dirPath, { withFileTypes: true })
+        .filter(d => d.isDirectory())
+        .map(d => d.name);
+}
+function listCanonEntries(dirPath) {
+    if (!existsSync(dirPath))
+        return [];
+    return readdirSync(dirPath, { withFileTypes: true })
+        .map(d => d.isDirectory() ? d.name : d.name.replace(/\.json$/, ""))
+        .filter(name => name !== "index");
+}
+function readCanonLock(repoRoot) {
+    const lockPath = join(repoRoot, "canon.lock.json");
+    if (!existsSync(lockPath))
+        return null;
+    return JSON.parse(readFileSync(lockPath, "utf-8"));
+}
+function readStoryMetadata(storyDir) {
+    const metaPath = join(storyDir, "metadata.json");
+    if (!existsSync(metaPath))
+        return null;
+    const raw = JSON.parse(readFileSync(metaPath, "utf-8"));
+    return { meta: raw, raw };
+}
+/**
+ * Load a local canon repo into an I/O-free RepoModel.
+ */
+export function loadRepoFromFs(repoRoot) {
+    const canonLock = readCanonLock(repoRoot);
+    const characters = new Set(listCanonEntries(join(repoRoot, "canon", "characters")));
+    const locations = new Set(listCanonEntries(join(repoRoot, "canon", "worldbuilding", "locations")));
+    const storiesDir = join(repoRoot, "stories");
+    const storyDirs = listSubDirs(storiesDir);
+    const episodes = new Set(storyDirs);
+    const stories = new Map();
+    for (const slug of storyDirs) {
+        const result = readStoryMetadata(join(storiesDir, slug));
+        if (result) {
+            stories.set(slug, result);
+        }
+    }
+    return { canonLock, characters, locations, episodes, stories };
+}
+//# sourceMappingURL=fs.js.map

package/dist/adapters/fs.js.map

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

package/dist/adapters/github.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GitHub adapter — pure conversion from parsed GitHub API data to RepoModel.
+ * No I/O, no Octokit, no HTTP. Runs anywhere.
+ */
+import type { RepoModel, GitHubRepoInput } from "../core/types.js";
+/**
+ * Build a RepoModel from pre-fetched GitHub API data.
+ *
+ * Expects:
+ * - tree: parsed Trees API response entries
+ * - files: Map of path → file content string (for metadata.json, canon.lock.json, etc.)
+ */
+export declare function buildRepoModel(input: GitHubRepoInput): RepoModel;

package/dist/adapters/github.js

@@ -0,0 +1,63 @@
+/**
+ * Build a RepoModel from pre-fetched GitHub API data.
+ *
+ * Expects:
+ * - tree: parsed Trees API response entries
+ * - files: Map of path → file content string (for metadata.json, canon.lock.json, etc.)
+ */
+export function buildRepoModel(input) {
+    const { tree, files } = input;
+    // Parse canon.lock.json
+    let canonLock = null;
+    const lockContent = files.get("canon.lock.json");
+    if (lockContent) {
+        canonLock = JSON.parse(lockContent);
+    }
+    // Extract character IDs from tree paths: canon/characters/<id>/ (dir) or canon/characters/<id>.json (blob)
+    const characters = new Set();
+    for (const entry of tree) {
+        if (entry.path.startsWith("canon/characters/")) {
+            const parts = entry.path.split("/");
+            if (parts.length === 3) {
+                const name = entry.type === "tree" ? parts[2] : parts[2].replace(/\.json$/, "");
+                if (name !== "index") {
+                    characters.add(name);
+                }
+            }
+        }
+    }
+    // Extract location IDs from tree paths: canon/worldbuilding/locations/<id>.json or <id>/
+    const locations = new Set();
+    for (const entry of tree) {
+        if (entry.path.startsWith("canon/worldbuilding/locations/")) {
+            const parts = entry.path.split("/");
+            if (parts.length === 4) {
+                const name = entry.type === "tree" ? parts[3] : parts[3].replace(/\.json$/, "");
+                if (name !== "index") {
+                    locations.add(name);
+                }
+            }
+        }
+    }
+    // Extract episode slugs from tree: stories/<slug>/
+    const episodes = new Set();
+    for (const entry of tree) {
+        if (entry.type === "tree" && entry.path.startsWith("stories/")) {
+            const parts = entry.path.split("/");
+            if (parts.length === 2) {
+                episodes.add(parts[1]);
+            }
+        }
+    }
+    // Parse story metadata from pre-fetched file contents
+    const stories = new Map();
+    for (const slug of episodes) {
+        const metaContent = files.get(`stories/${slug}/metadata.json`);
+        if (metaContent) {
+            const raw = JSON.parse(metaContent);
+            stories.set(slug, { meta: raw, raw });
+        }
+    }
+    return { canonLock, characters, locations, episodes, stories };
+}
+//# sourceMappingURL=github.js.map

package/dist/adapters/github.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { checkCommand } from "./commands/check.js";
+import { lockCommand } from "./commands/lock.js";
+import { initCommand } from "./commands/init.js";
+import { newCommand } from "./commands/new.js";
+const program = new Command();
+program
+    .name("canon")
+    .description("Canon worldbuilding CLI — scaffold, validate, and manage shared fiction universes")
+    .version("0.1.0");
+program.addCommand(checkCommand);
+program.addCommand(lockCommand);
+program.addCommand(initCommand);
+program.addCommand(newCommand);
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,mFAAmF,CAAC;KAChG,OAAO,CAAC,OAAO,CAAC,CAAA;AAEnB,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;AAChC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;AAC/B,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAA;AAC/B,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAA;AAE9B,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/commands/check.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const checkCommand: Command;

package/dist/commands/check.js

@@ -0,0 +1,43 @@
+import { Command } from "commander";
+import { resolve } from "node:path";
+import { existsSync } from "node:fs";
+import { loadRepoFromFs } from "../adapters/fs.js";
+import { validateRepo } from "../core/validate.js";
+export const checkCommand = new Command("check")
+    .description("Run canon compliance checks against a repo")
+    .argument("[dir]", "repo root directory", ".")
+    .action((dir) => {
+    const repoRoot = resolve(dir);
+    if (!existsSync(repoRoot)) {
+        console.error(`Error: directory not found: ${repoRoot}`);
+        process.exit(1);
+    }
+    let model;
+    try {
+        model = loadRepoFromFs(repoRoot);
+    }
+    catch (err) {
+        console.error(`Error: failed to read repo: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+    const report = validateRepo(model);
+    if (report.totalStories === 0) {
+        console.error("Error: no stories found in stories/");
+        process.exit(1);
+    }
+    for (const story of report.stories) {
+        const icon = story.allPass ? "\u2713" : "\u2717";
+        console.log(`${icon} ${story.storyId}`);
+        for (const c of story.checks) {
+            const mark = c.pass ? "  \u2713" : "  \u2717";
+            const msg = c.message ? ` — ${c.message}` : "";
+            console.log(`${mark} ${c.id}${msg}`);
+        }
+    }
+    console.log();
+    console.log(`${report.passingStories}/${report.totalStories} stories passing`);
+    if (report.passingStories < report.totalStories) {
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,4CAA4C,CAAC;KACzD,QAAQ,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,CAAC;KAC7C,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE;IACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAE7B,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,+BAA+B,QAAQ,EAAE,CAAC,CAAA;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,IAAI,KAAK,CAAA;IACT,IAAI,CAAC;QACH,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAA;QACxF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;IAElC,IAAI,MAAM,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAA;QACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAA;QAChD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QACvC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAA;YAC7C,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;YAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAA;QACtC,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAA;IACb,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,YAAY,kBAAkB,CAAC,CAAA;IAE9E,IAAI,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC,CAAC,CAAA"}

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const initCommand: Command;

package/dist/commands/init.js

@@ -0,0 +1,38 @@
+import { Command } from "commander";
+import { resolve, join } from "node:path";
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import { conventionsTemplate } from "../templates/conventions.js";
+export const initCommand = new Command("init")
+    .description("Scaffold a new canon worldbuilding repo")
+    .argument("[dir]", "target directory", ".")
+    .action((dir) => {
+    const root = resolve(dir);
+    const dirs = [
+        join(root, "canon", "characters"),
+        join(root, "canon", "worldbuilding", "locations"),
+        join(root, "stories"),
+    ];
+    for (const d of dirs) {
+        mkdirSync(d, { recursive: true });
+    }
+    const conventions = join(root, "CONVENTIONS.md");
+    if (!existsSync(conventions)) {
+        writeFileSync(conventions, conventionsTemplate());
+    }
+    const rcPath = join(root, ".canonrc.json");
+    if (!existsSync(rcPath)) {
+        const config = {
+            schema_version: "canonrc.v1",
+            author: "",
+            default_lang: "ko",
+        };
+        writeFileSync(rcPath, JSON.stringify(config, null, 2) + "\n");
+    }
+    console.log("Canon repo initialized:");
+    console.log("  canon/characters/");
+    console.log("  canon/worldbuilding/locations/");
+    console.log("  stories/");
+    console.log("  CONVENTIONS.md");
+    console.log("  .canonrc.json");
+});
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAGjE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,yCAAyC,CAAC;KACtD,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,CAAC;KAC1C,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE;IACtB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAEzB,MAAM,IAAI,GAAG;QACX,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,CAAC;QACjD,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC;KACtB,CAAA;IAED,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnC,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAA;IAChD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,aAAa,CAAC,WAAW,EAAE,mBAAmB,EAAE,CAAC,CAAA;IACnD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,eAAe,CAAC,CAAA;IAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,MAAM,MAAM,GAAgB;YAC1B,cAAc,EAAE,YAAY;YAC5B,MAAM,EAAE,EAAE;YACV,YAAY,EAAE,IAAI;SACnB,CAAA;QACD,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAC/D,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;IACtC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAA;IAClC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAA;IAC/C,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IACzB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;IAC/B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;AAChC,CAAC,CAAC,CAAA"}

package/dist/commands/lock.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const lockCommand: Command;

package/dist/commands/lock.js

@@ -0,0 +1,74 @@
+import { Command } from "commander";
+import { resolve, join, relative, sep } from "node:path";
+import { readFileSync, readdirSync, writeFileSync, existsSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { execSync } from "node:child_process";
+function collectFiles(dir) {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...collectFiles(full));
+        }
+        else {
+            results.push(full);
+        }
+    }
+    return results;
+}
+export const lockCommand = new Command("lock")
+    .description("Regenerate canon.lock.json from current canon/ contents")
+    .argument("[dir]", "repo root directory", ".")
+    .action((dir) => {
+    const repoRoot = resolve(dir);
+    const canonDir = join(repoRoot, "canon");
+    if (!existsSync(canonDir)) {
+        console.error("Error: canon/ directory not found");
+        process.exit(1);
+    }
+    // git rev-parse HEAD — hard error on failure
+    let canonCommit;
+    try {
+        canonCommit = execSync("git rev-parse HEAD", {
+            cwd: repoRoot,
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+        }).trim();
+    }
+    catch {
+        console.error("Error: git rev-parse HEAD failed. canon.lock.json requires a commit ref.");
+        process.exit(1);
+    }
+    // Collect all files under canon/, normalize to forward-slash relative paths, sort
+    const absolutePaths = collectFiles(canonDir);
+    const relativePaths = absolutePaths
+        .map(p => relative(canonDir, p).split(sep).join("/"))
+        .sort();
+    // Hash: for each file in sorted order, feed relativePath + NUL + fileBytes + NUL
+    const hash = createHash("sha256");
+    for (const relPath of relativePaths) {
+        const absPath = join(canonDir, ...relPath.split("/"));
+        const bytes = readFileSync(absPath);
+        hash.update(relPath);
+        hash.update("\0");
+        hash.update(bytes);
+        hash.update("\0");
+    }
+    const worldbuildingHash = hash.digest("hex");
+    const lock = {
+        schema_version: "canon.lock.v1",
+        canon_commit: canonCommit,
+        worldbuilding_hash: worldbuildingHash,
+        hash_algo: "sha256",
+        generated_at: new Date().toISOString(),
+    };
+    const lockPath = join(repoRoot, "canon.lock.json");
+    writeFileSync(lockPath, JSON.stringify(lock, null, 2) + "\n");
+    console.log(`canon.lock.json updated`);
+    console.log(`  commit: ${canonCommit}`);
+    console.log(`  hash:   ${worldbuildingHash}`);
+});
+//# sourceMappingURL=lock.js.map

package/dist/commands/lock.js.map

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

package/dist/commands/new.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const newCommand: Command;

package/dist/commands/new.js

@@ -0,0 +1,66 @@
+import { Command } from "commander";
+import { resolve, join } from "node:path";
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import { metadataTemplate } from "../templates/metadata.js";
+import { characterTemplate } from "../templates/character.js";
+import { locationTemplate } from "../templates/location.js";
+const SLUG_RE = /^[a-z0-9][a-z0-9_-]*$/;
+function validateSlug(value) {
+    if (!SLUG_RE.test(value)) {
+        console.error(`Error: invalid id "${value}". Must match ${SLUG_RE} (lowercase alphanumeric, hyphens, underscores, no leading special chars).`);
+        process.exit(1);
+    }
+    if (value.includes("..")) {
+        console.error(`Error: id must not contain ".."`);
+        process.exit(1);
+    }
+    return value;
+}
+export const newCommand = new Command("new")
+    .description("Create a new story, character, or location from template")
+    .argument("<type>", "entity type: story, character, or location")
+    .argument("<id>", "slug/id for the new entity")
+    .option("-d, --dir <dir>", "repo root directory", ".")
+    .action((type, id, opts) => {
+    const slug = validateSlug(id);
+    const root = resolve(opts.dir);
+    switch (type) {
+        case "story": {
+            const storyDir = join(root, "stories", slug);
+            if (existsSync(storyDir)) {
+                console.error(`Error: stories/${slug} already exists`);
+                process.exit(1);
+            }
+            mkdirSync(storyDir, { recursive: true });
+            writeFileSync(join(storyDir, "metadata.json"), metadataTemplate(slug));
+            console.log(`Created stories/${slug}/metadata.json`);
+            break;
+        }
+        case "character": {
+            const charDir = join(root, "canon", "characters", slug);
+            if (existsSync(charDir)) {
+                console.error(`Error: canon/characters/${slug} already exists`);
+                process.exit(1);
+            }
+            mkdirSync(charDir, { recursive: true });
+            writeFileSync(join(charDir, "definition.json"), characterTemplate(slug));
+            console.log(`Created canon/characters/${slug}/definition.json`);
+            break;
+        }
+        case "location": {
+            const locPath = join(root, "canon", "worldbuilding", "locations", `${slug}.json`);
+            if (existsSync(locPath)) {
+                console.error(`Error: canon/worldbuilding/locations/${slug}.json already exists`);
+                process.exit(1);
+            }
+            mkdirSync(join(root, "canon", "worldbuilding", "locations"), { recursive: true });
+            writeFileSync(locPath, locationTemplate(slug));
+            console.log(`Created canon/worldbuilding/locations/${slug}.json`);
+            break;
+        }
+        default:
+            console.error(`Error: unknown type "${type}". Use: story, character, or location`);
+            process.exit(1);
+    }
+});
+//# sourceMappingURL=new.js.map

package/dist/commands/new.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,2 @@
+export type { CanonLock, StoryMetadata, CharacterDefinition, LocationDefinition, RepoModel, GitHubTreeEntry, GitHubRepoInput, CheckId, CheckResult, StoryCheckReport, RepoCheckReport, CanonConfig, } from "./types.js";
+export { checkCharacters, checkLocations, checkTimeline, checkContinuity, checkCanonVersion, checkMetadataSchema, validateStory, validateRepo, } from "./validate.js";

package/dist/core/index.js

@@ -0,0 +1,2 @@
+export { checkCharacters, checkLocations, checkTimeline, checkContinuity, checkCanonVersion, checkMetadataSchema, validateStory, validateRepo, } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,eAAe,EACf,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAA"}

package/dist/core/types.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Core types for canon worldbuilding validation.
+ * No protocol internals — these are platform-facing types only.
+ */
+export interface CanonLock {
+    schema_version: "canon.lock.v1";
+    canon_commit: string;
+    worldbuilding_hash: string;
+    hash_algo: "sha256";
+    generated_at: string;
+}
+export interface StoryMetadata {
+    schema_version: "1.1";
+    canon_ref: string;
+    id: string;
+    episode: number;
+    title: {
+        ko: string;
+        en: string;
+    };
+    timeline: string;
+    synopsis: {
+        ko: string;
+        en: string;
+    };
+    characters: string[];
+    locations: string[];
+    themes?: string[];
+    canon_events?: string[];
+    canon_status: "canonical" | "non-canonical";
+    word_count?: {
+        ko?: number;
+        en?: number;
+    };
+    temporal_context?: {
+        prev_episode: string | null;
+        next_episode: string | null;
+        thematic_echoes?: string[];
+    };
+}
+export interface CharacterDefinition {
+    id: string;
+    name: {
+        ko: string;
+        en: string;
+    };
+    description?: {
+        ko?: string;
+        en?: string;
+    };
+}
+export interface LocationDefinition {
+    id: string;
+    name: {
+        ko: string;
+        en: string;
+    };
+    description?: {
+        ko?: string;
+        en?: string;
+    };
+}
+export interface RepoModel {
+    canonLock: CanonLock | null;
+    characters: Set<string>;
+    locations: Set<string>;
+    episodes: Set<string>;
+    stories: Map<string, {
+        meta: StoryMetadata;
+        raw: Record<string, unknown>;
+    }>;
+}
+export interface GitHubTreeEntry {
+    path: string;
+    type: "blob" | "tree";
+    sha: string;
+}
+export interface GitHubRepoInput {
+    tree: GitHubTreeEntry[];
+    files: Map<string, string>;
+}
+export type CheckId = "metadata_schema_valid" | "characters_valid" | "locations_valid" | "timeline_consistent" | "continuity_valid" | "canon_version_match";
+export interface CheckResult {
+    id: CheckId;
+    pass: boolean;
+    message?: string;
+}
+export interface StoryCheckReport {
+    storyId: string;
+    checks: CheckResult[];
+    allPass: boolean;
+}
+export interface RepoCheckReport {
+    schemaVersion: "check.v1";
+    stories: StoryCheckReport[];
+    totalStories: number;
+    passingStories: number;
+}
+export interface CanonConfig {
+    schema_version: "canonrc.v1";
+    author: string;
+    default_lang: "ko" | "en";
+    repo_url?: string;
+}

package/dist/core/types.js

@@ -0,0 +1,6 @@
+/**
+ * Core types for canon worldbuilding validation.
+ * No protocol internals — these are platform-facing types only.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/core/validate.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Canon compliance validation logic.
+ *
+ * Pure functions — no I/O, no side effects.
+ * Shared between CLI (local check) and adapter (engine observation).
+ */
+import type { StoryMetadata, CanonLock, CheckResult, StoryCheckReport, RepoCheckReport, RepoModel } from "./types.js";
+/**
+ * Validate that all declared characters exist in the canon.
+ */
+export declare function checkCharacters(meta: StoryMetadata, knownCharacters: ReadonlySet<string>): CheckResult;
+/**
+ * Validate that all declared locations exist in the canon.
+ */
+export declare function checkLocations(meta: StoryMetadata, knownLocations: ReadonlySet<string>): CheckResult;
+/**
+ * Validate that the timeline field is a valid ISO date.
+ */
+export declare function checkTimeline(meta: StoryMetadata): CheckResult;
+/**
+ * Validate temporal_context references exist in known episode set.
+ */
+export declare function checkContinuity(meta: StoryMetadata, knownEpisodes: ReadonlySet<string>): CheckResult;
+/**
+ * Validate that metadata.canon_ref matches canon.lock.json.
+ */
+export declare function checkCanonVersion(meta: StoryMetadata, canonLock: CanonLock | null): CheckResult;
+/**
+ * Validate metadata.json schema conformance.
+ */
+export declare function checkMetadataSchema(meta: Record<string, unknown>): CheckResult;
+/**
+ * Run all checks for a single story.
+ */
+export declare function validateStory(input: {
+    meta: StoryMetadata;
+    rawMeta: Record<string, unknown>;
+    knownCharacters: ReadonlySet<string>;
+    knownLocations: ReadonlySet<string>;
+    knownEpisodes: ReadonlySet<string>;
+    canonLock: CanonLock | null;
+}): StoryCheckReport;
+/**
+ * Run all checks for an entire repo model.
+ * Pure function — takes RepoModel, returns RepoCheckReport.
+ */
+export declare function validateRepo(model: RepoModel): RepoCheckReport;

package/dist/core/validate.js

@@ -0,0 +1,133 @@
+function check(id, pass, message) {
+    return { id, pass, ...(!pass && message ? { message } : {}) };
+}
+/**
+ * Validate that all declared characters exist in the canon.
+ */
+export function checkCharacters(meta, knownCharacters) {
+    const missing = meta.characters.filter(c => !knownCharacters.has(c));
+    return check("characters_valid", missing.length === 0, missing.length > 0 ? `Unknown characters: ${missing.join(", ")}` : undefined);
+}
+/**
+ * Validate that all declared locations exist in the canon.
+ */
+export function checkLocations(meta, knownLocations) {
+    const missing = meta.locations.filter(l => !knownLocations.has(l));
+    return check("locations_valid", missing.length === 0, missing.length > 0 ? `Unknown locations: ${missing.join(", ")}` : undefined);
+}
+/**
+ * Validate that the timeline field is a valid ISO date.
+ */
+export function checkTimeline(meta) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(meta.timeline)) {
+        return check("timeline_consistent", false, `Invalid timeline date: "${meta.timeline}"`);
+    }
+    const [y, m, d] = meta.timeline.split("-").map(Number);
+    const date = new Date(Date.UTC(y, m - 1, d));
+    const roundTrip = date.toISOString().slice(0, 10);
+    const valid = roundTrip === meta.timeline;
+    return check("timeline_consistent", valid, valid ? undefined : `Invalid timeline date: "${meta.timeline}"`);
+}
+/**
+ * Validate temporal_context references exist in known episode set.
+ */
+export function checkContinuity(meta, knownEpisodes) {
+    if (!meta.temporal_context) {
+        return check("continuity_valid", true);
+    }
+    const tc = meta.temporal_context;
+    const broken = [];
+    if (tc.prev_episode && !knownEpisodes.has(tc.prev_episode)) {
+        broken.push(`prev_episode "${tc.prev_episode}" not found`);
+    }
+    if (tc.next_episode && !knownEpisodes.has(tc.next_episode)) {
+        broken.push(`next_episode "${tc.next_episode}" not found`);
+    }
+    if (tc.thematic_echoes) {
+        for (const echo of tc.thematic_echoes) {
+            if (!knownEpisodes.has(echo)) {
+                broken.push(`thematic_echo "${echo}" not found`);
+            }
+        }
+    }
+    return check("continuity_valid", broken.length === 0, broken.length > 0 ? broken.join("; ") : undefined);
+}
+/**
+ * Validate that metadata.canon_ref matches canon.lock.json.
+ */
+export function checkCanonVersion(meta, canonLock) {
+    if (!canonLock) {
+        return check("canon_version_match", false, "canon.lock.json not found");
+    }
+    const match = meta.canon_ref === canonLock.canon_commit;
+    return check("canon_version_match", match, match ? undefined : `canon_ref "${meta.canon_ref}" does not match lock "${canonLock.canon_commit}"`);
+}
+/**
+ * Validate metadata.json schema conformance.
+ */
+export function checkMetadataSchema(meta) {
+    const required = ["schema_version", "canon_ref", "id", "episode", "title", "timeline", "synopsis", "characters", "locations", "canon_status"];
+    const missing = required.filter(f => !(f in meta));
+    if (missing.length > 0) {
+        return check("metadata_schema_valid", false, `Missing fields: ${missing.join(", ")}`);
+    }
+    if (meta.schema_version !== "1.1") {
+        return check("metadata_schema_valid", false, `Expected schema_version "1.1", got "${meta.schema_version}"`);
+    }
+    if (typeof meta.episode !== "number") {
+        return check("metadata_schema_valid", false, `episode must be a number`);
+    }
+    if (!Array.isArray(meta.characters)) {
+        return check("metadata_schema_valid", false, `characters must be an array`);
+    }
+    if (!Array.isArray(meta.locations)) {
+        return check("metadata_schema_valid", false, `locations must be an array`);
+    }
+    const validStatuses = ["canonical", "non-canonical"];
+    if (!validStatuses.includes(meta.canon_status)) {
+        return check("metadata_schema_valid", false, `canon_status must be "canonical" or "non-canonical"`);
+    }
+    return check("metadata_schema_valid", true);
+}
+/**
+ * Run all checks for a single story.
+ */
+export function validateStory(input) {
+    const checks = [
+        checkMetadataSchema(input.rawMeta),
+        checkCharacters(input.meta, input.knownCharacters),
+        checkLocations(input.meta, input.knownLocations),
+        checkTimeline(input.meta),
+        checkContinuity(input.meta, input.knownEpisodes),
+        checkCanonVersion(input.meta, input.canonLock),
+    ];
+    return {
+        storyId: input.meta.id,
+        checks,
+        allPass: checks.every(c => c.pass),
+    };
+}
+/**
+ * Run all checks for an entire repo model.
+ * Pure function — takes RepoModel, returns RepoCheckReport.
+ */
+export function validateRepo(model) {
+    const stories = [];
+    for (const [, { meta, raw }] of model.stories) {
+        stories.push(validateStory({
+            meta,
+            rawMeta: raw,
+            knownCharacters: model.characters,
+            knownLocations: model.locations,
+            knownEpisodes: model.episodes,
+            canonLock: model.canonLock,
+        }));
+    }
+    return {
+        schemaVersion: "check.v1",
+        stories,
+        totalStories: stories.length,
+        passingStories: stories.filter(s => s.allPass).length,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/validate.js.map

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

package/dist/templates/character.d.ts

@@ -0,0 +1 @@
+export declare function characterTemplate(id: string): string;

package/dist/templates/character.js

@@ -0,0 +1,8 @@
+export function characterTemplate(id) {
+    return JSON.stringify({
+        id,
+        name: { ko: "", en: "" },
+        description: { ko: "", en: "" },
+    }, null, 2) + "\n";
+}
+//# sourceMappingURL=character.js.map

package/dist/templates/character.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"character.js","sourceRoot":"","sources":["../../src/templates/character.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,EAAU;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,EAAE;QACF,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACxB,WAAW,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;KAChC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAA;AACpB,CAAC"}

package/dist/templates/conventions.d.ts

@@ -0,0 +1 @@
+export declare function conventionsTemplate(): string;

package/dist/templates/conventions.js

@@ -0,0 +1,50 @@
+export function conventionsTemplate() {
+    return `# Canon Conventions
+
+## Repository Structure
+
+\`\`\`
+canon/
+  characters/       # One directory per character
+    <id>/
+      definition.json
+  worldbuilding/
+    locations/      # One JSON file per location
+      <id>.json
+stories/
+  <slug>/
+    metadata.json   # Required — canon compliance metadata
+    chapter-01.md   # Story content (markdown)
+canon.lock.json     # Generated — do not edit manually
+CONVENTIONS.md      # This file
+\`\`\`
+
+## Metadata Schema (v1.1)
+
+Every story directory must contain a \`metadata.json\` with these required fields:
+
+| Field            | Type     | Description                          |
+|------------------|----------|--------------------------------------|
+| schema_version   | "1.1"    | Fixed schema version                 |
+| canon_ref        | string   | Commit SHA from canon.lock.json      |
+| id               | string   | Unique story identifier (slug)       |
+| episode          | number   | Episode number                       |
+| title            | {ko, en} | Bilingual title                      |
+| timeline         | string   | ISO date (YYYY-MM-DD)                |
+| synopsis         | {ko, en} | Bilingual synopsis                   |
+| characters       | string[] | Character IDs used in this story     |
+| locations        | string[] | Location IDs used in this story      |
+| canon_status     | string   | "canonical" or "non-canonical"       |
+
+## Compliance Checks
+
+Run \`canon check\` to validate:
+- **metadata_schema_valid** — all required fields present and correct types
+- **characters_valid** — all referenced characters exist in canon/characters/
+- **locations_valid** — all referenced locations exist in canon/worldbuilding/locations/
+- **timeline_consistent** — timeline is a valid ISO date
+- **continuity_valid** — temporal_context references point to existing episodes
+- **canon_version_match** — canon_ref matches canon.lock.json commit
+`;
+}
+//# sourceMappingURL=conventions.js.map

package/dist/templates/conventions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventions.js","sourceRoot":"","sources":["../../src/templates/conventions.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB;IACjC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CR,CAAA;AACD,CAAC"}

package/dist/templates/location.d.ts

@@ -0,0 +1 @@
+export declare function locationTemplate(id: string): string;

package/dist/templates/location.js

@@ -0,0 +1,8 @@
+export function locationTemplate(id) {
+    return JSON.stringify({
+        id,
+        name: { ko: "", en: "" },
+        description: { ko: "", en: "" },
+    }, null, 2) + "\n";
+}
+//# sourceMappingURL=location.js.map

package/dist/templates/location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../../src/templates/location.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,EAAE;QACF,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACxB,WAAW,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;KAChC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAA;AACpB,CAAC"}

package/dist/templates/metadata.d.ts

@@ -0,0 +1 @@
+export declare function metadataTemplate(id: string): string;

package/dist/templates/metadata.js

@@ -0,0 +1,15 @@
+export function metadataTemplate(id) {
+    return JSON.stringify({
+        schema_version: "1.1",
+        canon_ref: "",
+        id,
+        episode: 0,
+        title: { ko: "", en: "" },
+        timeline: "2025-01-01",
+        synopsis: { ko: "", en: "" },
+        characters: [],
+        locations: [],
+        canon_status: "non-canonical",
+    }, null, 2) + "\n";
+}
+//# sourceMappingURL=metadata.js.map

package/dist/templates/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/templates/metadata.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,cAAc,EAAE,KAAK;QACrB,SAAS,EAAE,EAAE;QACb,EAAE;QACF,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QACzB,QAAQ,EAAE,YAAY;QACtB,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QAC5B,UAAU,EAAE,EAAE;QACd,SAAS,EAAE,EAAE;QACb,YAAY,EAAE,eAAe;KAC9B,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAA;AACpB,CAAC"}

package/dist/test/hotfix.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/hotfix.test.js

@@ -0,0 +1,64 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { execSync } from "node:child_process";
+import { mkdtempSync, mkdirSync, readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { buildRepoModel } from "../adapters/github.js";
+import { checkTimeline } from "../core/validate.js";
+const CLI = join(import.meta.dirname, "..", "cli.js");
+describe("hotfix regressions", () => {
+    it("check exits 1 when 0 stories found", () => {
+        const tmp = mkdtempSync(join(tmpdir(), "canon-empty-"));
+        mkdirSync(join(tmp, "stories"), { recursive: true });
+        const result = (() => {
+            try {
+                execSync(`node ${CLI} check ${tmp}`, { encoding: "utf-8", stdio: "pipe" });
+                return { code: 0 };
+            }
+            catch (e) {
+                return { code: e.status, stderr: e.stderr };
+            }
+        })();
+        assert.equal(result.code, 1);
+    });
+    it("github adapter parses canon/characters/alice.json blob", () => {
+        const input = {
+            tree: [
+                { path: "canon/characters/alice.json", type: "blob", sha: "aaa" },
+                { path: "canon/characters/bob", type: "tree", sha: "bbb" },
+                { path: "canon/characters/index.json", type: "blob", sha: "ccc" },
+                { path: "stories/ep01", type: "tree", sha: "ddd" },
+            ],
+            files: new Map([
+                ["stories/ep01/metadata.json", JSON.stringify({
+                        schema_version: "1.1", canon_ref: "abc", id: "ep01", episode: 1,
+                        title: { ko: "t", en: "t" }, timeline: "2025-01-01",
+                        synopsis: { ko: "s", en: "s" }, characters: ["alice", "bob"],
+                        locations: [], canon_status: "canonical",
+                    })],
+            ]),
+        };
+        const model = buildRepoModel(input);
+        assert.ok(model.characters.has("alice"), "alice.json blob should be parsed");
+        assert.ok(model.characters.has("bob"), "bob/ dir should be parsed");
+        assert.ok(!model.characters.has("index"), "index should be excluded");
+    });
+    it("timeline rejects 2025-02-30 and 2025-01-01junk", () => {
+        const feb30 = checkTimeline({ timeline: "2025-02-30" });
+        assert.equal(feb30.pass, false, "2025-02-30 should fail");
+        const junk = checkTimeline({ timeline: "2025-01-01junk" });
+        assert.equal(junk.pass, false, "2025-01-01junk should fail");
+        const valid = checkTimeline({ timeline: "2025-03-15" });
+        assert.equal(valid.pass, true, "2025-03-15 should pass");
+    });
+    it("init creates .canonrc.json but not canon.lock.json", () => {
+        const tmp = mkdtempSync(join(tmpdir(), "canon-init-"));
+        execSync(`node ${CLI} init ${tmp}`, { encoding: "utf-8", stdio: "pipe" });
+        assert.ok(existsSync(join(tmp, ".canonrc.json")), ".canonrc.json should exist");
+        assert.ok(!existsSync(join(tmp, "canon.lock.json")), "canon.lock.json should NOT exist");
+        const rc = JSON.parse(readFileSync(join(tmp, ".canonrc.json"), "utf-8"));
+        assert.equal(rc.schema_version, "canonrc.v1");
+    });
+});
+//# sourceMappingURL=hotfix.test.js.map

package/dist/test/hotfix.test.js.map

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

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@opencanon/canon",
+  "version": "0.1.0",
+  "description": "Canon worldbuilding CLI — scaffold, validate, and manage shared fiction universes",
+  "type": "module",
+  "bin": {
+    "canon": "./dist/cli.js"
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "exports": {
+    ".": {
+      "import": "./dist/core/index.js",
+      "types": "./dist/core/index.d.ts"
+    },
+    "./adapters/fs": {
+      "import": "./dist/adapters/fs.js",
+      "types": "./dist/adapters/fs.d.ts"
+    },
+    "./adapters/github": {
+      "import": "./dist/adapters/github.js",
+      "types": "./dist/adapters/github.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "ls dist/test/*.test.js >/dev/null 2>&1 && node --test dist/test/*.test.js || { echo 'No test files found in dist/test/'; exit 1; }",
+    "pretest": "tsc"
+  },
+  "keywords": ["worldbuilding", "canon", "fiction", "compliance", "opencanon"],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  }
+}