create-oke 0.7.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-oke",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Scaffold an okengine app — bunx create-oke@latest <name>",
   "license": "MIT",
   "repository": {

package/src/drivers-catalog.ts

@@ -1,8 +1,9 @@
 /**
  * Boot-implemented driver choices offered by the create-oke customize wizard.
  *
- * Never lists ids that fail loud at boot (signal postgres/nats, clock postgres,
- * ai bedrock/vertex).
+ * Never lists ids that fail loud at boot (signal postgres/nats,
+ * ai bedrock/vertex). Clock + journal `postgres` are real (SKIP LOCKED
+ * CronStore / durable-run journal).
  */
 
 import type { CreateDefaults, CreateProfile, EnvDriverPins } from "./create-defaults.ts";
@@ -20,7 +21,7 @@ export const TEMPLATE_DOCKER_PROD = {
   kv: "redis",
   files: "s3",
   signal: "redis",
-  clock: "file",
+  clock: "postgres",
   vault: "openbao",
   email: "smtp",
 } as const;
@@ -81,9 +82,16 @@ export const SIGNAL_CHOICES: readonly DriverChoice[] = [
 export const CLOCK_CHOICES: readonly DriverChoice[] = [
   { value: "memory", label: "memory" },
   { value: "file", label: "file" },
+  { value: "postgres", label: "postgres" },
   { value: "frozen", label: "frozen" },
 ];
 
+export const JOURNAL_CHOICES: readonly DriverChoice[] = [
+  { value: "memory", label: "memory" },
+  { value: "file", label: "file" },
+  { value: "postgres", label: "postgres" },
+];
+
 export const VAULT_CHOICES: readonly DriverChoice[] = [
   { value: "env", label: "env" },
   { value: "openbao", label: "openbao" },
@@ -96,6 +104,7 @@ export const EMAIL_CHOICES: readonly DriverChoice[] = [
   { value: "smtp", label: "smtp" },
   { value: "resend", label: "resend" },
   { value: "sndr", label: "sndr" },
+  { value: "taqnyat-mail", label: "taqnyat-mail" },
 ];
 
 /** AI menu providers → protocol driver. */

package/templates/advanced/README.md

@@ -7,6 +7,7 @@ Docker-ready [okengine](https://oke.omqkhafi.dev) **Notes** starter — same dom
 bun install
 oke mode docker   # seeded by create-oke recommended path
 oke dev
+oke db seed       # essential welcome note + local/docker sample notes
 ```
 
 | Surface | URL |
@@ -26,6 +27,12 @@ oke dev
 Configure AI with `oke ai setup` or `create-oke --ai` (writes `src/ai.ts` + `drivers.ai`).
 Without AI, summarize returns a local excerpt (`via: "fallback"`).
 
+## Layout extras
+
+| Path | Role |
+| ---- | ---- |
+| `src/seed/` | `oke db seed` — essential + dev sample notes |
+
 ## Drivers
 
 See `oke.config.ts`: local sqlite/memory/fs · docker postgres/redis/s3/openbao/smtp.

package/templates/advanced/oke.config.ts

@@ -41,9 +41,16 @@ export default defineConfig({
     },
     clock: {
       local: "memory",
-      docker: "file",
+      docker: "postgres",
       test: "frozen",
-      prod: "file",
+      prod: "postgres",
+    },
+    // Durable-flow journal (durable: true runs) — shared + leased in docker/prod.
+    journal: {
+      local: "memory",
+      docker: "postgres",
+      test: "memory",
+      prod: "postgres",
     },
     vault: {
       local: "env",

package/templates/advanced/src/seed/index.ts

@@ -0,0 +1,67 @@
+import { defineSeed, type Fx } from "okengine";
+import { db } from "../core";
+import { notes } from "../schema.decl";
+
+/**
+ * Seed data — run explicitly with `oke db seed` (never at boot).
+ *
+ * Categories: `essential` (every env) · `dev` (local|docker) · `prod` (prod only).
+ * For multi-file composition (`src/seed/essential/*.ts` + arrays here), see
+ * Store docs → Seeding.
+ */
+
+async function welcomeNote(fx: Fx) {
+  await fx.store(db).upsert(
+    notes,
+    { id: "welcome" },
+    {
+      id: "welcome",
+      title: "Welcome",
+      body: "Advanced Notes starter — attach files, summarize with AI, daily digest clock.",
+      archivedAt: null,
+      createdAt: 1,
+    },
+  );
+}
+
+async function sampleNotes(fx: Fx) {
+  await fx.store(db).upsert(
+    notes,
+    { id: "sample-shipping" },
+    {
+      id: "sample-shipping",
+      title: "Shipping checklist",
+      body: "Confirm schema with oke db push (or migrate in docker), then oke db seed.",
+      archivedAt: null,
+      createdAt: 2,
+    },
+  );
+  await fx.store(db).upsert(
+    notes,
+    { id: "sample-attach" },
+    {
+      id: "sample-attach",
+      title: "Try attach",
+      body: "POST /notes/:id/attach stores a text blob on files:uploads.",
+      archivedAt: null,
+      createdAt: 3,
+    },
+  );
+  await fx.store(db).upsert(
+    notes,
+    { id: "sample-summarize" },
+    {
+      id: "sample-summarize",
+      title: "Try summarize",
+      body: "POST /notes/:id/summarize uses fx.ask when AI is configured, else a local excerpt.",
+      archivedAt: null,
+      createdAt: 4,
+    },
+  );
+}
+
+export default defineSeed({
+  essential: welcomeNote,
+  dev: sampleNotes,
+  // prod: async (fx) => { /* real production-only data, e.g. register a webhook */ },
+});

package/templates/standard/README.md

@@ -6,6 +6,7 @@ named Flows, Store, Signal → email, and Vault.
 ```bash
 bun install
 oke dev
+oke db seed   # essential welcome note + local/docker sample notes
 ```
 
 | Surface | URL |
@@ -32,6 +33,7 @@ never anonymous `flow_1`.
 | Path | Role |
 | ---- | ---- |
 | `src/schema.decl.ts` | `notes` table |
+| `src/seed/` | `oke db seed` — essential + dev sample notes |
 | `src/flows/notes/` | list · create · get · archive · onCreated |
 | `src/flows/main/` | root · health |
 | `src/channels.ts` | `note-created` email template |

package/templates/standard/oke.config.ts

@@ -34,9 +34,16 @@ export default defineConfig({
     },
     clock: {
       local: "memory",
-      docker: "file",
+      docker: "postgres",
       test: "frozen",
-      prod: "file",
+      prod: "postgres",
+    },
+    // Durable-flow journal (durable: true runs) — shared + leased in docker/prod.
+    journal: {
+      local: "memory",
+      docker: "postgres",
+      test: "memory",
+      prod: "postgres",
     },
     vault: {
       local: "env",

package/templates/standard/src/seed/index.ts

@@ -0,0 +1,56 @@
+import { defineSeed, type Fx } from "okengine";
+import { db } from "../core";
+import { notes } from "../schema.decl";
+
+/**
+ * Seed data — run explicitly with `oke db seed` (never at boot).
+ *
+ * Categories: `essential` (every env) · `dev` (local|docker) · `prod` (prod only).
+ * For multi-file composition (`src/seed/essential/*.ts` + arrays here), see
+ * Store docs → Seeding.
+ */
+
+async function welcomeNote(fx: Fx) {
+  await fx.store(db).upsert(
+    notes,
+    { id: "welcome" },
+    {
+      id: "welcome",
+      title: "Welcome",
+      body: "Your Notes API is ready. Create, list, and archive notes over HTTP.",
+      archivedAt: null,
+      createdAt: 1,
+    },
+  );
+}
+
+async function sampleNotes(fx: Fx) {
+  await fx.store(db).upsert(
+    notes,
+    { id: "sample-shipping" },
+    {
+      id: "sample-shipping",
+      title: "Shipping checklist",
+      body: "Confirm schema with oke db push, then seed with oke db seed.",
+      archivedAt: null,
+      createdAt: 2,
+    },
+  );
+  await fx.store(db).upsert(
+    notes,
+    { id: "sample-ideas" },
+    {
+      id: "sample-ideas",
+      title: "Ideas",
+      body: "Replace these seed rows with your own domain data.",
+      archivedAt: null,
+      createdAt: 3,
+    },
+  );
+}
+
+export default defineSeed({
+  essential: welcomeNote,
+  dev: sampleNotes,
+  // prod: async (fx) => { /* real production-only data, e.g. register a webhook */ },
+});