create-oke 0.2.8 → 0.3.2

package/README.md

@@ -8,9 +8,8 @@ cd my-app
 oke dev
 ```
 
-On a TTY, create-oke opens a Clack wizard: confirm name, pick a template, and
-optionally install + start `oke dev`. Pass `--yes` or `--template` /
-`--from-example` for non-interactive (CI / agents).
+On a TTY, create-oke opens a Clack wizard to confirm the name and optionally
+install dependencies and start `oke dev`. Pass `--yes` for non-interactive use.
 
 | Port    | What                |
 | ------- | ------------------- |
@@ -18,49 +17,29 @@ optionally install + start `oke dev`. Pass `--yes` or `--template` /
 | `:6533` | Console             |
 | `:6535` | MCP (live Manifest) |
 
-Default template is **standard** (full recommended file layout, empty scaffolding).
-Pick another with `--template`, or start from a teaching example with `--from-example`:
+The single bundled template is **standard**: the full recommended file layout
+with empty scaffolding.
 
 ```bash
-bunx create-oke@latest my-app --template hello
-bunx create-oke@latest my-app --template minimal
-bunx create-oke@latest my-app --template full
+bunx create-oke@latest my-app --template standard
 bunx create-oke@latest my-app --sql postgres
 bunx create-oke@latest my-app --yes
-bunx create-oke@latest my-notes --from-example notes
 ```
 
 `--sql sqlite|postgres` is opt-in. The default keeps the dual-mode Store
-config (`local: sqlite` · `docker`/`prod: postgres`) and a `sqliteTable`
-schema. Pass `--sql postgres` to rewrite `src/schema.ts` to `pgTable` /
-`drizzle-orm/pg-core` and pin `oke.config.ts` `store.sql` local/docker/prod to
-`postgres`. The interactive wizard does not ask — same dual-mode default
-(skipped entirely for `hello`, which has no Store).
+config (`local: sqlite` · `docker`/`prod: postgres`) and abstract
+`src/schema.decl.ts` (dialect emitted from the active driver). Pass
+`--sql postgres` to pin `oke.config.ts` `store.sql` local/docker/prod to
+`postgres`. The interactive wizard does not ask and keeps the same dual-mode
+default.
 
 Store-bearing scaffolds ship `drizzle.config.ts` and `.env.example`. Local
 `oke dev` auto-runs `oke db push` on schema change; use `oke mode docker` /
 `oke dev --docker` for compose infra.
 
-| Template   | Purpose                                                   |
-| ---------- | --------------------------------------------------------- |
-| `hello`    | Fastest possible "it works" — one flow, no Store          |
-| `minimal`  | Smallest shape you'd actually ship — Store + 1–2 flows    |
-| `standard` | Full recommended file layout, empty scaffolding (default) |
-| `full`     | Every element present and wired, no business logic        |
-
 Every scaffold writes an `AGENTS.md` so coding agents know the OKE contract
 (`--no-agents-md` to skip).
 
-`--from-example` copies a teaching example (including its business logic and
-comments) — most new projects want `--template` instead.
-
-| Example      | Adds                                                 |
-| ------------ | ---------------------------------------------------- |
-| `notes`      | `oke` · `flow` · `http` · `store.sql` · typed client |
-| `linkly`     | `signal` · `clock` · `gate` · abstract `schema.decl` |
-| `provisions` | durable flows · `vault` · `channel` · plugins        |
-| `skyport`    | `ai` · multi-tenancy · distributed topology          |
-
 ## Registries
 
 | Registry  | Package                                                                                                 |
@@ -68,4 +47,4 @@ comments) — most new projects want `--template` instead.
 | npm (CLI) | [`create-oke`](https://www.npmjs.com/package/create-oke) — use this with `bunx`                         |
 | JSR       | [`@omqkhafi/create-oke`](https://jsr.io/@omqkhafi/create-oke) — same sources; prefer npm for the binary |
 
-Requires **Bun ≥ 1.3**. Docs: [okengine.vercel.app](https://okengine.vercel.app) · [handbook](https://okengine.vercel.app/docs) · [unified theory](https://github.com/omqkhafi/okengine/blob/main/docs/spec/unified-theory.md).
+Requires **Bun ≥ 1.3**. Docs: [oke.omqkhafi.dev](https://oke.omqkhafi.dev) · [handbook](https://oke.omqkhafi.dev/docs).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-oke",
-  "version": "0.2.8",
+  "version": "0.3.2",
   "description": "Scaffold an okengine app — bunx create-oke@latest <name>",
   "license": "MIT",
   "repository": {
@@ -13,8 +13,7 @@
   },
   "files": [
     "src",
-    "templates",
-    "examples"
+    "template"
   ],
   "type": "module",
   "sideEffects": false,
@@ -22,7 +21,6 @@
     ".": "./src/index.ts"
   },
   "scripts": {
-    "prepack": "bun ./src/sync-templates.ts",
     "typecheck": "tsc --noEmit",
     "test": "bun test",
     "test:integration": "CREATE_OKE_INTEGRATION=1 bun test tests/scaffold.integration.test.ts tests/dev.integration.test.ts"

package/src/cli.test.ts

@@ -7,7 +7,6 @@ import { existsSync, mkdtempSync, readFileSync, readdirSync, rmSync } from "node
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import {
-  FROM_EXAMPLE_CHOICE,
   formatCdPath,
   nextStepsText,
   parseArgs,
@@ -19,14 +18,7 @@ import {
   type InteractiveAnswers,
 } from "./cli.ts";
 import { listTemplateFiles, scaffold } from "./scaffold.ts";
-import {
-  DEFAULT_TEMPLATE,
-  EXAMPLES,
-  TEMPLATES,
-  packageRoot,
-  resolveExampleDir,
-  resolveTemplateDir,
-} from "./templates.ts";
+import { DEFAULT_TEMPLATE, TEMPLATES, packageRoot, resolveTemplateDir } from "./templates.ts";
 import {
   sanitizeProjectName,
   shouldSkipTemplatePath,
@@ -41,19 +33,13 @@ describe("parseArgs", () => {
     expect(a.name).toBe("my-app");
     expect(a.template).toBe("standard");
     expect(a.templateExplicit).toBe(false);
-    expect(a.fromExample).toBeUndefined();
   });
 
   test("accepts --template and -t", () => {
-    expect(parseArgs(["x", "--template", "hello"]).template).toBe("hello");
-    expect(parseArgs(["x", "-t", "full"]).template).toBe("full");
-    expect(parseArgs(["x", "--template=minimal"]).template).toBe("minimal");
-    expect(parseArgs(["x", "--template", "hello"]).templateExplicit).toBe(true);
-  });
-
-  test("accepts --from-example", () => {
-    expect(parseArgs(["x", "--from-example", "notes"]).fromExample).toBe("notes");
-    expect(parseArgs(["x", "--from-example=skyport"]).fromExample).toBe("skyport");
+    expect(parseArgs(["x", "--template", "standard"]).template).toBe("standard");
+    expect(parseArgs(["x", "-t", "standard"]).template).toBe("standard");
+    expect(parseArgs(["x", "--template=standard"]).template).toBe("standard");
+    expect(parseArgs(["x", "--template", "standard"]).templateExplicit).toBe(true);
   });
 
   test("accepts --sql sqlite|postgres", () => {
@@ -64,13 +50,10 @@ describe("parseArgs", () => {
     expect(parseArgs(["x", "--sql", "postgres"]).sqlDriverExplicit).toBe(true);
   });
 
-  test("rejects unknown template / example / sql / both", () => {
+  test("rejects unknown template, option, and sql", () => {
     expect(() => parseArgs(["x", "--template", "nope"])).toThrow(/template/);
-    expect(() => parseArgs(["x", "--from-example", "nope"])).toThrow(/example/);
+    expect(() => parseArgs(["x", "--unknown"])).toThrow(/unknown option/);
     expect(() => parseArgs(["x", "--sql", "mysql"])).toThrow(/sql/);
-    expect(() => parseArgs(["x", "--template", "hello", "--from-example", "notes"])).toThrow(
-      /either/,
-    );
   });
 });
 
@@ -87,9 +70,8 @@ describe("shouldPrompt", () => {
     expect(shouldPrompt(parseArgs([]), false)).toBe(false);
     expect(shouldPrompt(parseArgs(["my-app"]), false)).toBe(false);
     expect(shouldPrompt(parseArgs(["my-app", "--yes"]), true)).toBe(false);
-    expect(shouldPrompt(parseArgs(["my-app", "--template", "hello"]), true)).toBe(false);
-    expect(shouldPrompt(parseArgs(["--template", "hello"]), true)).toBe(false);
-    expect(shouldPrompt(parseArgs(["--from-example", "notes"]), true)).toBe(false);
+    expect(shouldPrompt(parseArgs(["my-app", "--template", "standard"]), true)).toBe(false);
+    expect(shouldPrompt(parseArgs(["--template", "standard"]), true)).toBe(false);
     expect(shouldPrompt(parseArgs(["--help"]), true)).toBe(false);
   });
 });
@@ -110,11 +92,7 @@ describe("parseArgs flags", () => {
 });
 
 describe("sourceFromArgs", () => {
-  test("prefers example when set", () => {
-    expect(sourceFromArgs(parseArgs(["x", "--from-example", "linkly"]))).toEqual({
-      kind: "example",
-      id: "linkly",
-    });
+  test("uses the standard template", () => {
     expect(sourceFromArgs(parseArgs(["x"]))).toEqual({
       kind: "template",
       id: DEFAULT_TEMPLATE,
@@ -139,23 +117,6 @@ describe("scaffoldArgsFromAnswers ≡ flag-driven", () => {
     }
   });
 
-  test("each --from-example path matches interactive from-example choice", () => {
-    for (const id of EXAMPLES) {
-      const answers: InteractiveAnswers = {
-        name: "x",
-        choice: FROM_EXAMPLE_CHOICE,
-        example: id,
-        installAndRun: false,
-        agentsMd: true,
-      };
-      const fromAnswers = scaffoldArgsFromAnswers(answers);
-      const fromFlags = scaffoldArgsFromCli(parseArgs(["x", "--from-example", id]));
-      expect(fromAnswers).toEqual(fromFlags);
-      expect(fromAnswers.source).toEqual({ kind: "example", id });
-      expect(fromAnswers.sqlDriver).toBe("sqlite");
-    }
-  });
-
   test("interactive never opts into --sql postgres (flag-only)", () => {
     const answers: InteractiveAnswers = {
       name: "x",
@@ -170,8 +131,8 @@ describe("scaffoldArgsFromAnswers ≡ flag-driven", () => {
     ).toBe("postgres");
   });
 
-  test("8 paths cover every template and every example", () => {
-    expect(TEMPLATES.length + EXAMPLES.length).toBe(8);
+  test("only standard is available", () => {
+    expect(TEMPLATES).toEqual(["standard"]);
   });
 });
 
@@ -179,7 +140,7 @@ describe("transformPackageJson", () => {
   test("rewrites name and okengine file:../.. to installable ref", () => {
     const next = transformPackageJson(
       {
-        name: "@oke/template-hello",
+        name: "@oke/template-standard",
         private: true,
         dependencies: {
           okengine: "file:../..",
@@ -298,32 +259,6 @@ describe("scaffold structure", () => {
     }
   });
 
-  test("hello has exactly one flow and no Store", () => {
-    const dir = mkdtempSync(join(tmpdir(), "create-oke-hello-assert-"));
-    try {
-      const result = scaffold({
-        targetDir: join(dir, "hello"),
-        name: "hello-app",
-        source: { kind: "template", id: "hello" },
-      });
-      const flowFiles = result.files.filter((f) => f.startsWith("src/flows/") && f.endsWith(".ts"));
-      expect(flowFiles).toEqual(["src/flows/hello/index.ts"]);
-      const flowSrc = readFileSync(join(result.targetDir, "src/flows/hello/index.ts"), "utf8");
-      expect(flowSrc).toMatch(/export const hello/);
-      expect(flowSrc).not.toMatch(/\bstore\b/);
-      expect(result.files.some((f) => f.includes("core.ts"))).toBe(false);
-      expect(result.files.some((f) => f.includes("schema.ts"))).toBe(false);
-      const all = result.files
-        .filter((f) => f.endsWith(".ts"))
-        .map((f) => readFileSync(join(result.targetDir, f), "utf8"))
-        .join("\n");
-      expect(all).not.toMatch(/store\.sql/);
-      expect(all).not.toMatch(/\bbookings\b|\borders\b|\blinks\b|\bnotes\b/);
-    } finally {
-      rmSync(dir, { recursive: true, force: true });
-    }
-  });
-
   test("standard has full four-applications layout and no business domain", () => {
     const dir = mkdtempSync(join(tmpdir(), "create-oke-standard-assert-"));
     try {
@@ -341,7 +276,7 @@ describe("scaffold structure", () => {
         "src/flows/main/shapes.ts",
         "src/flows/main/signals.ts",
         "src/core.ts",
-        "src/schema.ts",
+        "src/schema.decl.ts",
         "src/app.ts",
       ]) {
         expect(result.files).toContain(path);
@@ -356,26 +291,7 @@ describe("scaffold structure", () => {
     }
   });
 
-  test("--from-example notes matches today's example tree", () => {
-    const dir = mkdtempSync(join(tmpdir(), "create-oke-from-example-"));
-    try {
-      const exampleDir = resolveExampleDir("notes");
-      const expected = listTemplateFiles(exampleDir);
-      const result = scaffold({
-        targetDir: join(dir, "notes"),
-        name: "from-notes",
-        source: { kind: "example", id: "notes" },
-      });
-      const extras = ["AGENTS.md"];
-      if (expected.includes(".env.example")) extras.push(".env.local");
-      expect([...result.files].sort()).toEqual([...expected, ...extras].sort());
-      expect(result.files).toContain("src/flows/notes/index.ts");
-    } finally {
-      rmSync(dir, { recursive: true, force: true });
-    }
-  });
-
-  test("--sql postgres rewrites schema dialect and pins store.sql", () => {
+  test("--sql postgres pins store.sql (abstract schema stays dialect-agnostic)", () => {
     const dir = mkdtempSync(join(tmpdir(), "create-oke-sql-pg-"));
     try {
       const result = scaffold({
@@ -385,10 +301,14 @@ describe("scaffold structure", () => {
         sqlDriver: "postgres",
       });
       expect(result.sqlDriver).toBe("postgres");
-      const schema = readFileSync(join(result.targetDir, "src/schema.ts"), "utf8");
-      expect(schema).toContain('from "drizzle-orm/pg-core"');
-      expect(schema).toContain("pgTable(");
-      expect(schema).not.toContain("sqliteTable");
+      // Abstract decl is dialect-agnostic — emit picks pgTable at sync time.
+      const decl = readFileSync(join(result.targetDir, "src/schema.decl.ts"), "utf8");
+      expect(decl).toContain("store.schema.table(");
+      expect(decl).not.toContain("sqliteTable");
+      expect(decl).not.toContain("pgTable");
+      const drizzle = readFileSync(join(result.targetDir, "drizzle.config.ts"), "utf8");
+      expect(drizzle).toContain("OKE_DRIZZLE_DIALECT");
+      expect(drizzle).toContain("schema.generated.ts");
       const config = readFileSync(join(result.targetDir, "oke.config.ts"), "utf8");
       expect(config).toMatch(/sql:\s*\{[\s\S]*local:\s*"postgres"/);
       expect(config).toMatch(/sql:\s*\{[\s\S]*docker:\s*"postgres"/);
@@ -403,9 +323,9 @@ describe("scaffold structure", () => {
     const dir = mkdtempSync(join(tmpdir(), "create-oke-no-agents-"));
     try {
       const result = scaffold({
-        targetDir: join(dir, "hello"),
+        targetDir: join(dir, "standard"),
         name: "no-agents",
-        source: { kind: "template", id: "hello" },
+        source: { kind: "template", id: "standard" },
         writeAgentsMd: false,
       });
       expect(result.files).not.toContain("AGENTS.md");
@@ -443,7 +363,7 @@ describe("non-TTY CLI", () => {
     const root = mkdtempSync(join(tmpdir(), "create-oke-flag-"));
     const target = join(root, "flag-app");
     try {
-      const code = await run([target, "--template", "hello", "--no-install"], {
+      const code = await run([target, "--template", "standard", "--no-install"], {
         stdinIsTTY: false,
         runPostScaffold: false,
       });
@@ -453,25 +373,17 @@ describe("non-TTY CLI", () => {
       const result = {
         targetDir: target,
         name: "flag-app",
-        source: { kind: "template" as const, id: "hello" as const },
-        label: "hello",
+        source: { kind: "template" as const, id: "standard" as const },
+        label: "standard",
         okengineDependency: "x",
         files: [],
         sqlDriver: "sqlite" as const,
       };
       expect(nextStepsText(result)).toContain("oke dev");
       expect(nextStepsText(result)).toContain("bun install");
-      expect(nextStepsText(result)).toContain("okengine.vercel.app");
+      expect(nextStepsText(result)).toContain("oke.omqkhafi.dev");
     } finally {
       rmSync(root, { recursive: true, force: true });
     }
   });
 });
-
-describe("examples catalogue", () => {
-  test("all four teaching examples resolve", () => {
-    for (const id of EXAMPLES) {
-      expect(resolveExampleDir(id)).toBeTruthy();
-    }
-  });
-});

package/src/cli.ts

@@ -1,25 +1,14 @@
 /**
- * `create-oke` CLI — clean templates by default; teaching examples opt-in.
+ * `create-oke` CLI — one standard starter.
  *
  * ```bash
- * bunx create-oke@latest <name> [--template hello|minimal|standard|full]
- * bunx create-oke@latest <name> --from-example notes|linkly|provisions|skyport
+ * bunx create-oke@latest <name> [--template standard]
  * bunx create-oke@latest <name> --yes
  * bunx create-oke@latest   # interactive when stdin is a TTY
  * ```
  */
 
-import {
-  cancel,
-  confirm,
-  intro,
-  isCancel,
-  note,
-  outro,
-  select,
-  spinner,
-  text,
-} from "@clack/prompts";
+import { cancel, confirm, intro, isCancel, note, outro, spinner, text } from "@clack/prompts";
 import { basename, relative, resolve } from "node:path";
 import { existsSync, rmSync } from "node:fs";
 import { agentsMdContent } from "./agents-md.ts";
@@ -27,13 +16,9 @@ import { docsUrl } from "./docs-origin.ts";
 import { scaffold, type ScaffoldResult, type ScaffoldSource } from "./scaffold.ts";
 import {
   DEFAULT_TEMPLATE,
-  EXAMPLE_NEW_IDEAS,
-  EXAMPLES,
   TEMPLATE_PURPOSES,
   TEMPLATES,
-  isExampleId,
   isTemplateId,
-  type ExampleId,
   type TemplateId,
 } from "./templates.ts";
 import { DEFAULT_SQL_DRIVER, SQL_DRIVERS, isSqlDriverId, type SqlDriverId } from "./transform.ts";
@@ -42,7 +27,6 @@ import { DEFAULT_SQL_DRIVER, SQL_DRIVERS, isSqlDriverId, type SqlDriverId } from
 export type CliArgs = {
   readonly name: string | undefined;
   readonly template: TemplateId;
-  readonly fromExample: ExampleId | undefined;
   /** True when `--template` / `-t` was present on the argv. */
   readonly templateExplicit: boolean;
   /** Store SQL driver (`sqlite` default). */
@@ -62,27 +46,13 @@ export type CliArgs = {
   readonly targetDir: string | undefined;
 };
 
-/**
- * Sentinel choice for "Start from a worked example" in interactive answers.
- * Distinct from clack's internal select value (`__example__`).
- */
-export const FROM_EXAMPLE_CHOICE = "from-example" as const;
-
 /** Answers collected by the interactive ask step (no clack types). */
-export type InteractiveAnswers =
-  | {
-      readonly name: string;
-      readonly choice: TemplateId;
-      readonly installAndRun: boolean;
-      readonly agentsMd: boolean;
-    }
-  | {
-      readonly name: string;
-      readonly choice: typeof FROM_EXAMPLE_CHOICE;
-      readonly example: ExampleId;
-      readonly installAndRun: boolean;
-      readonly agentsMd: boolean;
-    };
+export type InteractiveAnswers = {
+  readonly name: string;
+  readonly choice: TemplateId;
+  readonly installAndRun: boolean;
+  readonly agentsMd: boolean;
+};
 
 /**
  * Canonical scaffold invocation — shared by interactive and flag-driven paths.
@@ -103,7 +73,6 @@ export type ScaffoldCallArgs = {
 export function parseArgs(argv: readonly string[]): CliArgs {
   let name: string | undefined;
   let template: TemplateId = DEFAULT_TEMPLATE;
-  let fromExample: ExampleId | undefined;
   let templateExplicit = false;
   let sqlDriver: SqlDriverId = DEFAULT_SQL_DRIVER;
   let sqlDriverExplicit = false;
@@ -175,22 +144,6 @@ export function parseArgs(argv: readonly string[]): CliArgs {
       templateExplicit = true;
       continue;
     }
-    if (a === "--from-example") {
-      const next = argv[++i];
-      if (!next || !isExampleId(next)) {
-        throw new Error(`create-oke: --from-example must be one of ${EXAMPLES.join("|")}`);
-      }
-      fromExample = next;
-      continue;
-    }
-    if (a.startsWith("--from-example=")) {
-      const value = a.slice("--from-example=".length);
-      if (!isExampleId(value)) {
-        throw new Error(`create-oke: --from-example must be one of ${EXAMPLES.join("|")}`);
-      }
-      fromExample = value;
-      continue;
-    }
     if (a.startsWith("-")) {
       throw new Error(`create-oke: unknown option ${a}`);
     }
@@ -201,10 +154,6 @@ export function parseArgs(argv: readonly string[]): CliArgs {
     throw new Error(`create-oke: unexpected argument ${a}`);
   }
 
-  if (templateExplicit && fromExample !== undefined) {
-    throw new Error("create-oke: use either --template or --from-example, not both");
-  }
-
   if (argv.includes("--install") && argv.includes("--no-install")) {
     throw new Error("create-oke: use either --install or --no-install, not both");
   }
@@ -216,7 +165,6 @@ export function parseArgs(argv: readonly string[]): CliArgs {
   return {
     name,
     template,
-    fromExample,
     templateExplicit,
     sqlDriver,
     sqlDriverExplicit,
@@ -266,25 +214,18 @@ export function helpText(): string {
     (id) =>
       `  ${id.padEnd(12)}${TEMPLATE_PURPOSES[id]}${id === DEFAULT_TEMPLATE ? "  (default)" : ""}`,
   ).join("\n");
-  const exampleLines = EXAMPLES.map((id) => `  ${id.padEnd(12)}${EXAMPLE_NEW_IDEAS[id]}`).join(
-    "\n",
-  );
-
   return `create-oke — scaffold an okengine app
 
 Usage:
-  bunx create-oke@latest <name> [--template hello|minimal|standard|full]
-  bunx create-oke@latest <name> --from-example notes|linkly|provisions|skyport
+  bunx create-oke@latest <name> [--template standard]
   bunx create-oke@latest <name> --yes
   bunx create-oke@latest          # interactive (TTY only)
 
 Options:
   -t, --template <id>   Clean starter (default: ${DEFAULT_TEMPLATE})
-  --from-example <id>   Teaching example (non-interactive)
   --sql <id>            Opt-in Store SQL dialect: ${SQL_DRIVERS.join("|")}
                         Default keeps local sqlite · docker/prod postgres.
-                        --sql postgres rewrites src/schema.ts to pgTable and
-                        pins store.sql local/docker/prod to postgres.
+                        --sql postgres pins store.sql local/docker/prod to postgres.
   -y, --yes             No prompts; defaults + bun install (no oke dev)
   --install             Run bun install after scaffold
   --no-install          Skip bun install
@@ -292,16 +233,11 @@ Options:
   --no-agents-md        Skip AGENTS.md
   -h, --help            Show this help
 
-Templates (clean starters from templates/):
+Template:
 ${templateLines}
 
---from-example (copies a teaching example, including its business logic and
-comments — most new projects want --template instead):
-${exampleLines}
-
 No telemetry. Bun only. On a TTY, a project name alone still opens the wizard
-(confirm name, template, install). Non-TTY / --yes / --template /
---from-example stay fully scriptable.
+(confirm name and install). Non-TTY / --yes / --template stay fully scriptable.
 `;
 }
 
@@ -309,7 +245,7 @@ No telemetry. Bun only. On a TTY, a project name alone still opens the wizard
  * Whether the CLI should open the interactive Clack flow.
  *
  * TTY humans get the wizard even when a name is pre-filled. Config flags
- * (`--template`, `--from-example`) or `--yes` skip prompts for CI/agents.
+ * `--template` or `--yes` skips prompts for CI/agents.
  *
  * @param args - Parsed args
  * @param stdinIsTTY - `process.stdin.isTTY`
@@ -319,7 +255,6 @@ export function shouldPrompt(args: CliArgs, stdinIsTTY: boolean | undefined): bo
   if (args.help) return false;
   if (args.yes) return false;
   if (args.templateExplicit) return false;
-  if (args.fromExample !== undefined) return false;
   return true;
 }
 
@@ -329,9 +264,6 @@ export function shouldPrompt(args: CliArgs, stdinIsTTY: boolean | undefined): bo
  * @param args - Parsed args
  */
 export function sourceFromArgs(args: CliArgs): ScaffoldSource {
-  if (args.fromExample !== undefined) {
-    return { kind: "example", id: args.fromExample };
-  }
   return { kind: "template", id: args.template };
 }
 
@@ -359,7 +291,7 @@ export function scaffoldArgsFromCli(args: CliArgs): ScaffoldCallArgs {
  * Pure map from interactive answers → scaffold call args.
  *
  * Independent of clack — unit-tested against {@link scaffoldArgsFromCli}
- * for every template and every `--from-example` choice.
+ * for the standard template.
  *
  * @param answers - Collected interactive answers
  */
@@ -368,15 +300,6 @@ export function scaffoldArgsFromAnswers(answers: InteractiveAnswers): ScaffoldCa
   const name = basename(targetDir);
   // Interactive always keeps the dual-mode default (local sqlite ·
   // docker/prod postgres). Opt into postgres-everywhere with `--sql postgres`.
-  if (answers.choice === FROM_EXAMPLE_CHOICE) {
-    return {
-      name,
-      targetDir,
-      source: { kind: "example", id: answers.example },
-      agentsMd: answers.agentsMd,
-      sqlDriver: DEFAULT_SQL_DRIVER,
-    };
-  }
   return {
     name,
     targetDir,
@@ -419,54 +342,8 @@ export async function askInteractiveAnswers(
   if (isCancel(nameValue)) return null;
   const name = String(nameValue).trim();
 
-  const templateValue = await select({
-    message: "Template",
-    options: [
-      ...TEMPLATES.map((id) => ({
-        value: id as string,
-        label: id,
-        hint: TEMPLATE_PURPOSES[id],
-      })),
-      {
-        value: "__example__",
-        label: "Start from a worked example",
-        hint: "Teaching apps with business logic — most projects want a template",
-      },
-    ],
-    initialValue: DEFAULT_TEMPLATE,
-  });
-  if (isCancel(templateValue)) return null;
-
   const agentsMd = partial.agentsMd ?? true;
 
-  if (templateValue === "__example__") {
-    const exampleValue = await select({
-      message: "Example",
-      options: EXAMPLES.map((id) => ({
-        value: id,
-        label: id,
-        hint: EXAMPLE_NEW_IDEAS[id],
-      })),
-    });
-    if (isCancel(exampleValue)) return null;
-
-    const installAndRunValue = await confirm({
-      message: "Install dependencies and start oke dev?",
-      initialValue: true,
-    });
-    if (isCancel(installAndRunValue)) return null;
-
-    return {
-      name,
-      choice: FROM_EXAMPLE_CHOICE,
-      example: exampleValue as ExampleId,
-      installAndRun: Boolean(installAndRunValue),
-      agentsMd,
-    };
-  }
-
-  const templateId = templateValue as TemplateId;
-
   const installAndRunValue = await confirm({
     message: "Install dependencies and start oke dev?",
     initialValue: true,
@@ -475,7 +352,7 @@ export async function askInteractiveAnswers(
 
   return {
     name,
-    choice: templateId,
+    choice: DEFAULT_TEMPLATE,
     installAndRun: Boolean(installAndRunValue),
     agentsMd,
   };

package/src/docs-origin.ts

@@ -2,11 +2,10 @@
  * Canonical public docs origin for scaffolded AGENTS.md and next-steps.
  *
  * Keep in lockstep with `src/docs-origin.ts` in the okengine package.
- * Flip both when the custom domain is attached: `https://oke.omqkhafi.dev`.
  */
 
-/** Live docs site (Vercel). Planned cutover: `https://oke.omqkhafi.dev`. */
-export const DOCS_ORIGIN = "https://okengine.vercel.app" as const;
+/** Live docs site. */
+export const DOCS_ORIGIN = "https://oke.omqkhafi.dev" as const;
 
 /**
  * Absolute docs URL for a path under the handbook / site.