create-githolon 0.52.0 → 0.54.0

package/index.mjs

@@ -70,7 +70,7 @@ if (existsSync(path.join(targetDir, "vscode"))) {
 // client FACTORY (`todoClient`) is named off the DOMAIN key, which stays `todo`.
 const appHash = `${appName.replace(/[-\s]+/g, "_").replace(/([a-z0-9])([A-Z])/g, "$1_$2").toUpperCase()}_DOMAIN_HASH`;
 const subst = (s) => s.replaceAll("__APP_NAME__", appName).replaceAll("__APP_HASH__", appHash);
-for (const f of ["package.json", "README.md", "nomos.package.mjs", "domains/todo.ts", "test/e2e.mts"]) {
+for (const f of ["package.json", "README.md", "nomos.package.mjs", "CLAUDE.md", "domains/todo.ts", "test/e2e.mts"]) {
   const p = path.join(targetDir, f);
   if (existsSync(p)) writeFileSync(p, subst(readFileSync(p, "utf8")), "utf8");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-githolon",
-  "version": "0.52.0",
+  "version": "0.54.0",
   "type": "module",
   "description": "Scaffold a Nomos domain package: the starter domain + compile config + live e2e. `npm create githolon my-app`.",
   "license": "SEE LICENSE IN LICENSE.md",

package/template/CLAUDE.md

@@ -0,0 +1,36 @@
+# __APP_NAME__ — Nomos domain package
+
+A local-first Nomos domain: law authored in the `@githolon/dsl` TypeScript DSL under
+`domains/`, compiled into ONE deterministic GitHolon artifact, deployed to a workspace.
+Read `docs/01-mental-model.md` first — the docs travel with this repo, offline.
+
+## For AI agents
+
+This project's law is guarded by an author-time gate (static twins). Use it:
+
+- **Lint the law** — before compiling or deploying, run the gate over `nomos.package.mjs`:
+
+  ```bash
+  npx githolon check            # human report; exits non-zero on any REFUSE
+  npx githolon check --json     # the findings as a machine-readable array (file:line)
+  ```
+
+- **Preview a law evolution** — before deploying a change to already-deployed law, diff
+  against the prior deployed law and paste any generated `dispositions` block:
+
+  ```bash
+  npx githolon check --against build/<name>.deploy.json
+  ```
+
+- **Editor / agent diagnostics** — `npx githolon lsp` is a standard stdio Language Server
+  (red squiggles as you write law). For Claude Code, the `nomos-law` plugin ships it as a
+  plugin LSP; for Codex or other MCP clients, `githolon mcp` exposes the same gate as the
+  `nomos_check` and `nomos_evolve_preview` tools (`codex mcp add nomos -- githolon mcp`).
+
+## The loop
+
+```bash
+npx githolon compile   # → build/: deployable package + typed client + a generated proof
+npx githolon proof     # run that proof offline on a local holon
+npx githolon deploy <ws>
+```