create-geonosis 2.13.0 → 3.0.0

package/dist/files.js

@@ -0,0 +1,497 @@
+// src/files.ts
+import {
+  countersFor,
+  LAW_SOURCE,
+  LOADED_VERSION,
+  oxlintConfigFor,
+  rulesFor,
+  tiersFor
+} from "@geonosis/cli";
+import { CORPUS_DIR, corpusFor } from "./corpus.js";
+import { TOOL_VERSIONS, TOOLS_RUNTIME } from "./floor-versions.js";
+import { workspacesOf } from "./layout.js";
+var VERSION = LOADED_VERSION;
+var CATALOG = TOOL_VERSIONS;
+var REACT = { "@types/react": "^19.0.0", react: "^19.0.0" };
+var json = (value) => `${JSON.stringify(value, undefined, 2)}
+`;
+var exec = (runtime) => runtime === "bun" ? "bunx" : "npx";
+var run = (runtime) => runtime === "bun" ? "bun run" : "pnpm";
+var everyWorkspace = (runtime, script) => runtime === "bun" ? `bun run --filter '*' ${script}` : `pnpm -r ${script}`;
+var presetsFor = (answers) => [
+  "tooling",
+  ...answers.ui === "none" ? [] : ["frontend"],
+  ...answers.backend === "none" ? [] : ["tenant-scoping"],
+  ...answers.backend === "medusa" ? ["backend-medusa"] : [],
+  ...answers.backend === "sagaflow-cf" ? ["backend-workflows-cf"] : [],
+  ...answers.themekit === undefined ? [] : ["themekit"]
+];
+var tokenPrefix = (name) => `--${name.toLowerCase().replaceAll(/[^a-z]/g, "").slice(0, 3)}-`;
+var answersForRules = (answers) => ({
+  "layer-walls": ["error", { layers: [] }],
+  ...answers.brand === undefined ? {} : {
+    "no-brand-names": [
+      "error",
+      { allowedSubstrings: [`${answers.scope}/`], brands: [answers.brand] }
+    ]
+  },
+  ...answers.ui === "none" ? {} : {
+    "no-raw-html-atoms": [
+      "error",
+      [{ atom: "Button", element: "button", importPath: `${answers.scope}/ui/atoms/button` }]
+    ],
+    "no-runtime-dead-affordance": [
+      "error",
+      [{ atom: "Button", element: "button", importPath: `${answers.scope}/ui/atoms/button` }]
+    ]
+  },
+  ...answers.backend === "medusa" ? {
+    "plugin-route-namespaced": [
+      "error",
+      {
+        packages: [
+          {
+            name: `${answers.scope}/{dir}`,
+            namespaced: true,
+            under: "packages/medusa-plugins"
+          }
+        ]
+      }
+    ]
+  } : {},
+  ...answers.backend === "sagaflow-cf" ? {
+    "step-opens-its-own-cell": [
+      "error",
+      {
+        engine: "sagaflow-js",
+        within: "packages/backend/src/workflows/",
+        wrapper: "packages/backend/src/workflows/step\\.ts$"
+      }
+    ]
+  } : {},
+  ...answers.themekit === undefined ? {} : {
+    "font-roles-only": ["error", { roles: ["body", "display"] }],
+    "tokens-only-colors": ["error", { tokenPrefix: [tokenPrefix(answers.name)] }]
+  }
+});
+var exportsOf = (workspace) => Object.fromEntries(Object.keys(workspace.sources).filter((file) => !file.includes(".test.")).toSorted().map((file) => [`./${file.replace(/^src\//, "").replace(/\.tsx?$/, "")}`, `./${file}`]));
+var workspaceManifest = (workspace, answers, workspaces) => {
+  const react = workspace.dir === "packages/ui";
+  return json({
+    name: workspace.name,
+    version: "0.0.0",
+    private: true,
+    type: "module",
+    exports: exportsOf(workspace),
+    scripts: {
+      lint: "oxlint --config ../../.oxlintrc.json .",
+      test: "vitest run --reporter=default --reporter=json --outputFile=.geonosis/vitest.json",
+      typecheck: "tsc --noEmit"
+    },
+    devDependencies: {
+      "@types/node": "catalog:",
+      ...react ? { "@types/react": "catalog:", react: "catalog:" } : {},
+      oxlint: "catalog:",
+      typescript: "catalog:",
+      vitest: "catalog:"
+    },
+    dependencies: {
+      ...Object.fromEntries(workspace.mayDependOn.flatMap((tag) => {
+        const found = workspaces.find((one) => one.tag === tag);
+        return found === undefined || found.name === workspace.name ? [] : [[found.name, "workspace:*"]];
+      })),
+      ...Object.fromEntries(Object.entries(workspace.packages ?? {}).filter(([name]) => answers.kit === undefined || !name.startsWith("@geonosis/")))
+    }
+  });
+};
+var kitDependencies = (answers) => ({
+  "@geonosis/cli": `^${VERSION}`,
+  "@geonosis/doctor": `^${VERSION}`,
+  "@geonosis/ledger": `^${VERSION}`,
+  "@geonosis/oxlint-plugin-biological-architecture": `^${VERSION}`,
+  "@geonosis/ratchet": `^${VERSION}`,
+  "@geonosis/verify": `^${VERSION}`,
+  ...answers.themekit === undefined ? {} : { "@geonosis/themekit": `^${VERSION}` }
+});
+var GRAPH_SYNCS = [
+  { target: "turbo", write: "turbo.json" },
+  { target: "layer-walls", write: ".oxlintrc.json" }
+];
+var graphScript = GRAPH_SYNCS.map(({ target, write }) => `geonosis-ledger sync --target ${target} --write ${write}`).join(" && ");
+var HOOK_INSTALLER = "scripts/install-hooks.mjs";
+var hookInstaller = () => [
+  "import { spawnSync } from 'node:child_process'",
+  "import { existsSync, lstatSync } from 'node:fs'",
+  "import { join, resolve } from 'node:path'",
+  "",
+  "const git = (...args) => {",
+  "  const done = spawnSync('git', args, { encoding: 'utf8' })",
+  "",
+  "  return done.status === 0 ? done.stdout.trim() : undefined",
+  "}",
+  "",
+  "const say = (line) => process.stdout.write(`install-hooks: ${line}\n`)",
+  "",
+  "const common = git('rev-parse', '--path-format=absolute', '--git-common-dir')",
+  "if (common === undefined) {",
+  "  say('git says nothing about this directory, so there is no hooks path to install into.')",
+  "  process.exit(0)",
+  "}",
+  "",
+  "// A worktree's own .git is a FILE; the hooks it would install into belong to the checkout the",
+  "// common dir names, and writing them from here changes the tree somebody else is in.",
+  "const here = resolve(process.cwd(), '.git')",
+  "if (existsSync(here) && lstatSync(here).isFile() && resolve(common) !== here) {",
+  "  say(`this is a git worktree and its hooks path is shared with ${common} — install them there instead.`)",
+  "  process.exit(0)",
+  "}",
+  "",
+  "const lefthook = join(process.cwd(), 'node_modules/.bin/lefthook')",
+  "if (!existsSync(lefthook)) {",
+  "  say('lefthook is not installed here yet, so no hook was written.')",
+  "  process.exit(0)",
+  "}",
+  "",
+  "const done = spawnSync(lefthook, ['install'], { stdio: 'inherit' })",
+  "process.exit(done.status ?? 0)",
+  ""
+].join(`
+`);
+var rootScripts = ({ runtime }) => ({
+  doctor: "geonosis-doctor",
+  prepare: `node ${HOOK_INSTALLER}`,
+  "format:check": "oxfmt --config .oxfmtrc.json --check .",
+  format: "oxfmt --config .oxfmtrc.json .",
+  lint: "oxlint --config .oxlintrc.json .",
+  prove: "geonosis-ratchet --prove",
+  ratchet: "geonosis-ratchet",
+  "sync:graph": graphScript,
+  sync: "geonosis sync",
+  test: everyWorkspace(runtime, "test"),
+  typecheck: everyWorkspace(runtime, "typecheck"),
+  verify: "geonosis-verify"
+});
+var rootManifest = (answers) => {
+  const { runtime } = answers;
+  const globs = ["apps/*", "packages/*"];
+  return json({
+    name: answers.name,
+    version: "0.0.0",
+    private: true,
+    type: "module",
+    ...runtime === "pnpm" ? TOOLS_RUNTIME : {},
+    ...runtime === "bun" ? {
+      workspaces: {
+        catalog: { ...CATALOG, ...answers.ui === "none" ? {} : REACT },
+        packages: globs
+      }
+    } : {},
+    scripts: rootScripts(answers),
+    devDependencies: {
+      ...answers.kit === undefined ? kitDependencies(answers) : {},
+      "@types/node": "catalog:",
+      ...answers.ui === "none" ? {} : { "@types/react": "catalog:", react: "catalog:" },
+      lefthook: "^2.1.0",
+      oxfmt: "catalog:",
+      oxlint: "catalog:",
+      turbo: "^2.10.0",
+      typescript: "catalog:",
+      vitest: "catalog:"
+    }
+  });
+};
+var workspaceYaml = (answers) => [
+  "packages:",
+  "  - apps/*",
+  "  - packages/*",
+  "",
+  "# One version of a shared dependency, named once. A repo whose workspaces each pin their own",
+  "# typescript is a repo where one of them typechecks against a compiler the others do not run.",
+  "catalog:",
+  ...Object.entries({ ...CATALOG, ...answers.ui === "none" ? {} : REACT }).toSorted(([a], [b]) => a.localeCompare(b, "en-US")).map(([name, spec]) => `  '${name}': '${spec}'`),
+  "",
+  "# pnpm 11 runs no dependency's install script unless it is named here. esbuild fetches its",
+  "# platform binary in one, and without it vitest cannot start — a test suite that cannot run",
+  "# reports nothing, which is the shape of green this kit exists to refuse.",
+  "allowBuilds:",
+  "  esbuild: true",
+  "  lefthook: true",
+  ""
+].join(`
+`);
+var architecture = (answers, workspaces) => [
+  `# ${answers.name} — target architecture`,
+  "",
+  "The edges table is the ONE place this graph is written down. `geonosis sync --target turbo`",
+  "generates turbo's `boundaries.tags` from it, and `--target layer-walls` generates the linter's",
+  "layers from it, so a tag added here reaches both gates and neither can drift from the other.",
+  "",
+  "| tag | packages | may depend on |",
+  "| --- | --- | --- |",
+  ...workspaces.map((one) => `| ${one.tag} | ${one.name} | ${one.mayDependOn.join(", ") || "—"} |`),
+  "",
+  ...answers.backend === "medusa" ? [
+    "Medusa plugins go under `packages/medusa-plugins/<name>`; the `plugin-route-namespaced`",
+    "rule is configured for that root, so a store route without a namespace is refused.",
+    ""
+  ] : []
+].join(`
+`);
+var pipeline = (answers) => [
+  "# Pipeline: order placed",
+  "",
+  "One page per pipeline, and this is the template. Say what enters, what each hop does to it, and",
+  "what leaves — then keep the diagram beside the code that implements it.",
+  "",
+  "```mermaid",
+  "graph LR",
+  `  IN[request] --> APP[${answers.scope}/web]`,
+  `  APP --> CORE[${answers.scope}/core]`,
+  ...answers.backend === "none" ? [] : [`  APP --> BACK[${answers.scope}/backend]`],
+  "  CORE --> OUT[response]",
+  "```",
+  "",
+  "| Hop | Owns | Fails how |",
+  "| --- | --- | --- |",
+  "| entry | shape of the request | refuses, never guesses |",
+  "| core | the calculation | pure, so it is tested without a server |",
+  "| exit | the response | one shape, named |",
+  ""
+].join(`
+`);
+var law = (answers) => [
+  `# ${answers.name} — repo doctrine`,
+  "",
+  `A ${answers.runtime} monorepo on the geonosis kit. \`docs/architecture.md\` is the graph;`,
+  "`docs/pipelines/` is one page per flow. Depth belongs in skills and in the rules, never here.",
+  "",
+  "## The laws",
+  "",
+  "**1. RED → GREEN.** Every new rule, constraint or invariant begins with a failing test. Write",
+  "it, watch it fail, then write the code that makes it pass. A test written afterwards validates",
+  "what was built, not what was intended.",
+  "",
+  "**2. Never downgrade a rule.** Setting one to `warn` or `off`, narrowing its globs, adding a",
+  "file to `ignorePatterns` or silencing it with a disable comment — all forbidden without asking.",
+  "A gate breaking because real code violates a real invariant is enforcement working.",
+  "",
+  "**3. No suppression.** No `@ts-ignore`, no `@ts-expect-error`. Fix the type, or ask.",
+  "",
+  `**4. oxfmt only.** \`${run(answers.runtime)} format\` writes, \`${run(answers.runtime)} format:check\` verifies. Never`,
+  "prettier: it is not a dependency here, so it downloads itself and reformats with its own defaults.",
+  "",
+  "**5. Nothing is hardcoded to a repo.** Every list a rule needs is an option.",
+  "",
+  "**6. Test what the code does, not how.** Never assert on class names or DOM structure.",
+  "",
+  "## The gates",
+  "",
+  "```bash",
+  "geonosis verify full     # typecheck → lint → test → format → ratchet",
+  "geonosis doctor          # loaded, exercised, baseline, runner, drift",
+  "```",
+  "",
+  "`gate-baseline.json` holds one number per counter, and a number may only shrink. A counter that",
+  "grew fails; one that shrank rewrites the baseline down in the commit that earned it.",
+  "",
+  "## The method",
+  "",
+  "The `geonosis` Claude Code plugin carries the hooks, agents and skills:",
+  "",
+  "```bash",
+  `claude plugin marketplace add ${answers.marketplace ?? "microcompanies/geonosis"}`,
+  "claude plugin install geonosis@geonosis",
+  "```",
+  "",
+  "`AGENTS.md` and `.cursor/rules/` are GENERATED from this file by `geonosis sync` — edit this",
+  "one. `lint-corpus/` is fixture code that must stay broken: it is how the doctor proves the rules",
+  "configured for this repo can fire at all.",
+  ""
+].join(`
+`);
+var ci = (answers) => [
+  "name: verify",
+  "",
+  "on:",
+  "  push:",
+  "    branches: [main]",
+  "  pull_request:",
+  "",
+  "jobs:",
+  "  verify:",
+  "    runs-on: ubuntu-latest",
+  "    timeout-minutes: 30",
+  "    steps:",
+  "      - uses: actions/checkout@v4",
+  ...answers.runtime === "bun" ? ["      - uses: oven-sh/setup-bun@v2", "      - run: bun install --frozen-lockfile"] : [
+    "      - uses: pnpm/action-setup@v4",
+    "      - uses: actions/setup-node@v4",
+    "        with:",
+    "          node-version: '24'",
+    "          cache: 'pnpm'",
+    "      - run: pnpm install --frozen-lockfile"
+  ],
+  `      - run: ${exec(answers.runtime)} geonosis-verify full`,
+  `      - run: ${exec(answers.runtime)} geonosis-doctor`,
+  "",
+  "# When @geonosis/testbed is installed, add its matrix here: one job per adapter the repo",
+  "# declares in geonosis.json → testbed.adapters. A job switched off in a condition is a job",
+  "# that lies, so the disabledCiJobs counter counts them and the ratchet holds the number at 0.",
+  ""
+].join(`
+`);
+var settings = (answers) => json({
+  extraKnownMarketplaces: {
+    geonosis: answers.marketplace === undefined ? { source: { repo: "microcompanies/geonosis", source: "github" } } : { source: { path: answers.marketplace, source: "directory" } }
+  },
+  enabledPlugins: { "geonosis@geonosis": true }
+});
+var tsconfigBase = (answers) => json({
+  compilerOptions: {
+    target: "ES2023",
+    lib: ["ES2023", ...answers.ui === "none" ? [] : ["DOM"]],
+    module: "ESNext",
+    moduleResolution: "bundler",
+    moduleDetection: "force",
+    ...answers.ui === "none" ? {} : { jsx: "react-jsx" },
+    types: ["node"],
+    strict: true,
+    noUncheckedIndexedAccess: true,
+    noImplicitOverride: true,
+    noFallthroughCasesInSwitch: true,
+    verbatimModuleSyntax: true,
+    isolatedModules: true,
+    skipLibCheck: true,
+    esModuleInterop: true,
+    resolveJsonModule: true,
+    noEmit: true
+  }
+});
+var filesFor = (answers) => {
+  const workspaces = workspacesOf(answers);
+  const counters = countersFor(answers.runtime, LAW_SOURCE, workspaces.map((one) => ({ dir: one.dir, name: one.name })));
+  const { rules } = rulesFor(presetsFor(answers), answersForRules(answers));
+  const files = {
+    "package.json": rootManifest(answers),
+    ...answers.runtime === "pnpm" ? { "pnpm-workspace.yaml": workspaceYaml(answers) } : {},
+    [LAW_SOURCE]: law(answers),
+    "CLAUDE.md": `@${LAW_SOURCE}
+`,
+    "docs/architecture.md": architecture(answers, workspaces),
+    "docs/pipelines/order-placed.md": pipeline(answers),
+    ".github/workflows/ci.yml": ci(answers),
+    ".claude/settings.json": settings(answers),
+    ".gitignore": ["node_modules/", "dist/", ".turbo/", ".geonosis/", "coverage/", ""].join(`
+`),
+    ".oxfmtrc.json": json({
+      printWidth: 100,
+      singleQuote: true,
+      semi: false,
+      trailingComma: "none",
+      arrowParens: "always",
+      endOfLine: "lf",
+      tabWidth: 2,
+      quoteProps: "as-needed",
+      sortImports: true,
+      sortPackageJson: true,
+      ignorePatterns: [
+        "node_modules",
+        "dist",
+        ".turbo",
+        "coverage",
+        "**/*.md",
+        "**/*.json",
+        CORPUS_DIR
+      ]
+    }),
+    ".oxlintrc.json": json(oxlintConfigFor(rules, [CORPUS_DIR])),
+    "geonosis.json": json({
+      verify: tiersFor({
+        rules,
+        runtime: answers.runtime,
+        scripts: Object.keys(rootScripts(answers))
+      }),
+      doctor: { corpus: CORPUS_DIR },
+      law: { file: LAW_SOURCE },
+      ledger: {
+        architecture: "docs/architecture.md",
+        law: LAW_SOURCE,
+        plans: "plans",
+        progress: "plans/PROGRESS.md",
+        proofs: "proofs"
+      },
+      walk: { probes: [], urls: [] },
+      testbed: {
+        adapters: answers.backend === "medusa" ? ["medusa-built"] : answers.backend === "sagaflow-cf" ? ["workerd"] : []
+      }
+    }),
+    "geonosis.ratchet.json": json({ baseline: "gate-baseline.json", counters }),
+    "gate-baseline.json": json(Object.fromEntries(counters.map((one) => [
+      typeof one.key === "string" ? one.key : String(one.counter),
+      one.counter === "lawLineCount" ? law(answers).split(`
+`).length - 1 : 0
+    ]))),
+    "skills-lock.json": json({ skills: {}, version: 1 }),
+    [HOOK_INSTALLER]: hookInstaller(),
+    "lefthook.yml": [
+      "# Staged scope only, so a commit never waits on a file it did not touch. When one fires, fix",
+      "# or delete the code — never downgrade the rule to get past it.",
+      "#",
+      "# Each binary is called through node_modules/.bin, never through npx, bunx or pnpm: a git",
+      "# hook's PATH is not the shell's and carries no version-manager shim, so the runner fails to",
+      "# START and what you read is its message rather than the gate refusing anything.",
+      "pre-commit:",
+      "  parallel: true",
+      "  commands:",
+      "    fmt:",
+      "      glob: '*.{ts,tsx,js,json}'",
+      "      run: node_modules/.bin/oxfmt --config .oxfmtrc.json --check {staged_files}",
+      "    lint:",
+      "      glob: '*.{ts,tsx}'",
+      "      run: node_modules/.bin/oxlint --config .oxlintrc.json {staged_files}",
+      ""
+    ].join(`
+`),
+    "turbo.json": json({
+      $schema: "https://turborepo.dev/schema.json",
+      boundaries: { tags: {} },
+      tasks: {
+        build: { dependsOn: ["^build"] },
+        lint: {},
+        test: { dependsOn: ["^build"] },
+        typecheck: { dependsOn: ["^typecheck"] }
+      }
+    }),
+    "tsconfig.base.json": tsconfigBase(answers),
+    "tsconfig.json": json({
+      extends: "./tsconfig.base.json",
+      include: [
+        "apps/*/src/**/*.ts",
+        "apps/*/src/**/*.tsx",
+        "packages/*/src/**/*.ts",
+        "packages/*/src/**/*.tsx"
+      ],
+      exclude: ["**/dist/**", "**/node_modules/**", `${CORPUS_DIR}/**`]
+    }),
+    ...corpusFor(answers, workspaces)
+  };
+  for (const workspace of workspaces) {
+    files[`${workspace.dir}/package.json`] = workspaceManifest(workspace, answers, workspaces);
+    files[`${workspace.dir}/tsconfig.json`] = json({
+      extends: "../../tsconfig.base.json",
+      include: ["src"]
+    });
+    for (const [file, body] of Object.entries(workspace.sources)) {
+      files[`${workspace.dir}/${file}`] = body;
+    }
+  }
+  return files;
+};
+var presetsChosenBy = presetsFor;
+export {
+  GRAPH_SYNCS,
+  HOOK_INSTALLER,
+  filesFor,
+  kitDependencies,
+  presetsChosenBy
+};

package/dist/floor-versions.d.ts

@@ -0,0 +1,29 @@
+export declare const FLOOR_VERSIONS: {
+    readonly '@geonosis/assistant': '0.1.0';
+    readonly '@geonosis/conformance': '0.4.0';
+    readonly '@geonosis/db': '0.14.2';
+    readonly '@geonosis/document': '0.9.2';
+    readonly '@geonosis/events': '2.2.0';
+    readonly '@geonosis/extraction': '0.1.0';
+    readonly '@geonosis/files': '0.1.0';
+    readonly '@geonosis/inbox': '0.1.1';
+    readonly '@geonosis/interchange': '0.1.0';
+    readonly '@geonosis/money': '0.1.0';
+    readonly '@geonosis/placement': '0.1.0';
+    readonly '@geonosis/plans': '0.1.0';
+    readonly '@geonosis/recurring': '0.1.0';
+    readonly '@geonosis/search': '0.4.1';
+    readonly '@geonosis/ui': '0.2.1';
+    readonly '@geonosis/workflows': '0.6.0';
+};
+export declare const TOOL_VERSIONS: Record<string, string>;
+export declare const TOOLS_RUNTIME: {
+    devEngines: {
+        runtime: {
+            name: string;
+            version: string;
+            onFail: string;
+        };
+    };
+    packageManager: string;
+};

package/dist/floor-versions.js

@@ -0,0 +1,35 @@
+// src/floor-versions.ts
+var FLOOR_VERSIONS = {
+  "@geonosis/assistant": "0.1.0",
+  "@geonosis/conformance": "0.4.0",
+  "@geonosis/db": "0.14.2",
+  "@geonosis/document": "0.9.2",
+  "@geonosis/events": "2.2.0",
+  "@geonosis/extraction": "0.1.0",
+  "@geonosis/files": "0.1.0",
+  "@geonosis/inbox": "0.1.1",
+  "@geonosis/interchange": "0.1.0",
+  "@geonosis/money": "0.1.0",
+  "@geonosis/placement": "0.1.0",
+  "@geonosis/plans": "0.1.0",
+  "@geonosis/recurring": "0.1.0",
+  "@geonosis/search": "0.4.1",
+  "@geonosis/ui": "0.2.1",
+  "@geonosis/workflows": "0.6.0"
+};
+var TOOL_VERSIONS = {
+  "@types/node": "^26.6.3",
+  oxfmt: "^0.70.0",
+  oxlint: "^1.85.0",
+  typescript: "^7.0.2",
+  vitest: "^5.0.2"
+};
+var TOOLS_RUNTIME = {
+  devEngines: { runtime: { name: "bun", version: "^1.4.2", onFail: "download" } },
+  packageManager: "pnpm@12.6.0"
+};
+export {
+  FLOOR_VERSIONS,
+  TOOLS_RUNTIME,
+  TOOL_VERSIONS
+};