create-holon 0.1.0 → 0.1.2

package/LICENSE.md

@@ -12,7 +12,7 @@ with it; we keep the rest for now.
   authorizes;
 - build, run, and ship applications on top of them — including commercial ones;
 - keep everything that's yours: code you write, and everything these tools
-  generate FOR you (scaffolds from `create-holon` / `holon generate`, generated
+  generate FOR you (scaffolds from `create-githolon` / `githolon generate`, generated
   clients, compiled domain packages) carries NO restriction from us — it is
   yours outright.
 

package/index.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-// `npm create holon <dir>` — scaffold a Nomos domain package (the starter
+// `npm create githolon <dir>` — scaffold a Nomos domain package (the starter
 // guestbook domain + compile config + live e2e) into <dir> and init it as a
-// git repo. The holon itself is MINTED LOCALLY after compile (`holon ledger
+// git repo. The holon itself is MINTED LOCALLY after compile (`githolon ledger
 // init holon` — genesis + your law under YOUR identity, verified by the same
 // wasm gate the cloud runs), so it is yours from the first byte. Plain node,
 // zero dependencies; the heavy lifting (compile, codegen, the engine) lives in
-// @githolon/dsl and @githolon/cli and arrives with the scaffold's `npm install`.
+// @githolon/dsl and githolon and arrives with the scaffold's `npm install`.
 //
 // Everything scaffolded here belongs to the user — see LICENSE.md ("You may /
 // keep everything that's yours").
@@ -19,11 +19,11 @@ const TEMPLATE = path.join(path.dirname(fileURLToPath(import.meta.url)), "templa
 const args = process.argv.slice(2);
 if (args.includes("-h") || args.includes("--help")) {
   process.stdout.write(
-    "create-holon — scaffold a Nomos domain package\n\n" +
-      "Usage:\n  npm create holon <dir>        (or: npx create-holon <dir>)\n\n" +
+    "create-githolon — scaffold a Nomos domain package\n\n" +
+      "Usage:\n  npm create githolon <dir>        (or: npx create-githolon <dir>)\n\n" +
       "Scaffolds the starter domain + compile config + live e2e into <dir>\n" +
-      "(default: my-holon-app) and inits a git repo. After `holon compile`,\n" +
-      "`holon ledger init holon` mints YOUR holon locally — verified by the\n" +
+      "(default: my-holon-app) and inits a git repo. After `githolon compile`,\n" +
+      "`githolon ledger init holon` mints YOUR holon locally — verified by the\n" +
       "same wasm gate the cloud runs, ready to birth by git push.\n\n" +
       "Flags:\n  --no-git    skip git init\n",
   );
@@ -39,12 +39,12 @@ const appName = path
   .replace(/[^a-z0-9-_.]+/g, "-")
   .replace(/^[-_.]+|[-_.]+$/g, "");
 if (!appName) {
-  console.error(`create-holon: '${path.basename(targetDir)}' does not reduce to a valid package name`);
+  console.error(`create-githolon: '${path.basename(targetDir)}' does not reduce to a valid package name`);
   process.exit(1);
 }
 
 if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
-  console.error(`create-holon: refusing to scaffold into non-empty directory: ${targetDir}`);
+  console.error(`create-githolon: refusing to scaffold into non-empty directory: ${targetDir}`);
   process.exit(1);
 }
 
@@ -69,8 +69,8 @@ if (!noGit) {
   if (gitInited) {
     git(["add", "-A"]);
     // Identity fallback keeps the initial commit working on unconfigured machines.
-    git(["commit", "-m", "scaffold: create-holon starter"]) ||
-      git(["-c", "user.name=create-holon", "-c", "user.email=create-holon@nomos", "commit", "-m", "scaffold: create-holon starter"]);
+    git(["commit", "-m", "scaffold: create-githolon starter"]) ||
+      git(["-c", "user.name=create-githolon", "-c", "user.email=create-githolon@nomos", "commit", "-m", "scaffold: create-githolon starter"]);
   }
 }
 
@@ -80,10 +80,10 @@ process.stdout.write(
     `\nNext:\n` +
     `  cd ${rel}\n` +
     `  npm install\n` +
-    `  npx holon compile        # → build/: deployable package + manifests + typed client\n` +
-    `  npx holon login --agent  # a verified identity, no browser\n\n` +
+    `  npx githolon compile        # → build/: deployable package + manifests + typed client\n` +
+    `  npx githolon login --agent  # a verified identity, no browser\n\n` +
     `Then pick a path (README.md walks both):\n` +
-    `  A) npx holon ws create <ws> && npx holon deploy <ws>\n` +
-    `  B) npx holon ledger init holon   # YOUR holon, minted + verified LOCALLY\n` +
-    `     cd holon && npx holon git remote <ws> && git push nomos main\n`,
+    `  A) npx githolon ws create <ws> && npx githolon deploy <ws>\n` +
+    `  B) npx githolon ledger init holon   # YOUR holon, minted + verified LOCALLY\n` +
+    `     cd holon && npx githolon git remote <ws> && git push nomos main\n`,
 );

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "create-holon",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
-  "description": "Scaffold a Nomos domain package: the starter domain + compile config + live e2e. `npm create holon my-app`.",
+  "description": "Scaffold a Nomos domain package: the starter domain + compile config + live e2e. `npm create githolon my-app`.",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Captain-App/nomos2.git",
-    "directory": "create-holon"
+    "directory": "create-githolon"
   },
   "bin": {
-    "create-holon": "./index.mjs"
+    "create-githolon": "./index.mjs"
   },
   "files": [
     "index.mjs",

package/template/README.md

@@ -1,20 +1,20 @@
 # __APP_NAME__ — a Nomos domain package
 
-Scaffolded by `npm create holon`. One domain file, one config, one command —
+Scaffolded by `npm create githolon`. One domain file, one config, one command —
 then an offline-first typed client against Nomos Cloud. Two ways to get a live
 workspace; both end in the same place.
 
 ```bash
 npm install
-npx holon compile          # → build/: deployable package + manifests + typed client
-npx holon login --agent    # self-onboard a verified identity (no browser; linkable to a full account later)
+npx githolon compile          # → build/: deployable package + manifests + typed client
+npx githolon login --agent    # self-onboard a verified identity (no browser; linkable to a full account later)
 ```
 
 ## Path A — deploy your law
 
 ```bash
-npx holon ws create <ws>   # births a fresh workspace on your identity; SAVES its one-time secret to ~/.holon
-npx holon deploy <ws>      # POSTs build/guestbook.deploy.json with the stored secret
+npx githolon ws create <ws>   # births a fresh workspace on your identity; SAVES its one-time secret to ~/.holon
+npx githolon deploy <ws>      # POSTs build/guestbook.deploy.json with the stored secret
 npm run e2e                # the full loop, live: offline write → sync → admission → cloud query
 ```
 
@@ -30,24 +30,24 @@ from genesis and re-derive your exact verdict (same head, same plans re-run)
 before serving anything. Authority lives in the git; no holon outranks another.
 
 ```bash
-npx holon ledger init holon    # mint + assert locally: chain VALID, head <h>, under YOUR uid
-npx holon ledger verify holon  # re-assert any time
+npx githolon ledger init holon    # mint + assert locally: chain VALID, head <h>, under YOUR uid
+npx githolon ledger verify holon  # re-assert any time
 cd holon
-npx holon git remote <ws>      # wires the remote + credential helper; mints + stores the owner secret
+npx githolon git remote <ws>      # wires the remote + credential helper; mints + stores the owner secret
 git push nomos main            # the upload birth — the cloud re-derives the verdict, byte-identical adoption
-npx holon deploy <ws>          # idempotent (alreadyInstalled) + stages the read manifests so queries route
+npx githolon deploy <ws>          # idempotent (alreadyInstalled) + stages the read manifests so queries route
 cd ..
 ```
 
 After birth, `holon/` tracks YOUR workspace: new writes admitted on main arrive
-with `git pull`. (`holon git setup` installed a git credential helper, so plain
+with `git pull`. (`githolon git setup` installed a git credential helper, so plain
 git just works against the cloud.)
 
 ## What's here
 
 - `domains/guestbook.ts` — the starter domain (the law): one aggregate, two
   directives, a declared query, a derived field, a count. Rename it, reshape
-  it, or add domains with `npx holon generate domain <name>`.
+  it, or add domains with `npx githolon generate domain <name>`.
 - `nomos.package.mjs` — the compile config (module list per domain key; reads
   are auto-discovered from exports).
 - `build/guestbook.client.ts` — GENERATED typed TS client (payload types from

package/template/nomos.package.mjs

@@ -1,12 +1,9 @@
-// The nomos-compile config: one package, one domain, one module file.
+// The holon-compile config: one package, one domain, one module file.
 // Read-side declarations (queries/counts/...) are auto-discovered from the
 // module's exports by shape — nothing to wire here.
+// Building a Flutter app too? Add `dart: true` for the typed Dart frontend
+// (build/dart/) alongside the TS client.
 export default {
   name: "guestbook",
   domains: [{ key: "guestbook", modules: ["./domains/guestbook.ts"] }],
-  // Typed Dart frontend (the Flutter sibling of build/guestbook.client.ts):
-  // build/dart/guestbook.dart + the vendored nomos_dsl support files. A Flutter
-  // app vendors the build/dart/ directory as-is. `dart: { out: "some/dir" }`
-  // overrides the destination.
-  dart: true,
 };

package/template/package.json

@@ -3,9 +3,9 @@
   "version": "0.0.0",
   "private": true,
   "type": "module",
-  "description": "A Nomos domain package — authored in @githolon/dsl, compiled with `holon compile`, deployed to Nomos Cloud with one POST.",
+  "description": "A Nomos domain package — authored in @githolon/dsl, compiled with `githolon compile`, deployed to Nomos Cloud with one POST.",
   "scripts": {
-    "compile": "holon compile",
+    "compile": "githolon compile",
     "e2e": "tsx test/e2e.mts",
     "typecheck": "tsc --noEmit"
   },
@@ -15,7 +15,7 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@githolon/cli": "^0.1.0",
+    "githolon": "^0.1.2",
     "@types/node": "^25.9.2",
     "tsx": "^4.19.2",
     "typescript": "^5.6.3"