honertia 0.1.40 → 0.1.42

package/README.md

@@ -4,6 +4,14 @@ Inertia.js adapter for Hono with Effect.ts. Server-driven app with SPA behavior.
 
 ## CLI Commands
 
+`honertia` is shipped as a package binary. You can run commands with:
+
+```bash
+bunx honertia <command>
+# or
+npx honertia <command>
+```
+
 ### Generate Action
 
 ```bash
@@ -117,8 +125,8 @@ honertia db status              # Show migration status
 honertia db status --json       # JSON output
 honertia db migrate             # Run pending migrations
 honertia db migrate --preview   # Preview SQL without executing
-honertia db rollback            # Rollback last migration
-honertia db rollback --preview  # Preview rollback SQL
+honertia db rollback --preview  # Preview rollback SQL for latest applied migration
+# Non-preview rollback execution is manual (run preview SQL yourself)
 honertia db generate add_email  # Generate new migration
 ```
 
@@ -979,6 +987,93 @@ export const destroyProject = action(
 )
 ```
 
+### Real-World Transaction (Order Checkout)
+
+Pass a validated/trusted transaction object as the second argument to
+`dbMutation`/`dbTransaction` when you want strict write scoping.
+Inside that callback, write methods only accept values that come from
+that scoped object.
+
+```typescript
+import { Effect, Schema as S } from 'effect'
+import {
+  action,
+  authorize,
+  validate,
+  validateRequest,
+  DatabaseService,
+  dbTransaction,
+  mergeMutationInput,
+  redirect,
+  requiredString,
+} from 'honertia/effect'
+import { eq } from 'drizzle-orm'
+import { orders, orderItems, inventory } from '~/db/schema'
+
+const CheckoutSchema = S.Struct({
+  productId: requiredString,
+  quantity: S.NumberFromString,
+})
+
+const CheckoutTransactionSchema = S.Struct({
+  createOrder: S.Struct({
+    userId: S.String,
+    status: S.Literal('pending'),
+  }),
+  createItem: S.Struct({
+    productId: S.String,
+    quantity: S.Number,
+    // Reserve transaction-derived fields you plan to fill later.
+    orderId: S.optional(S.String),
+  }),
+  updateInventory: S.Struct({
+    reserved: S.Number,
+  }),
+})
+
+export const checkout = action(
+  Effect.gen(function* () {
+    const auth = yield* authorize()
+    const input = yield* validateRequest(CheckoutSchema, {
+      errorComponent: 'Checkout/Show',
+    })
+    const db = yield* DatabaseService
+
+    const txInput = yield* validate(CheckoutTransactionSchema, {
+      createOrder: {
+        userId: auth.user.id,
+        status: 'pending',
+      },
+      createItem: {
+        productId: input.productId,
+        quantity: input.quantity,
+      },
+      updateInventory: {
+        reserved: input.quantity,
+      },
+    })
+    // For untyped/unknown payloads (e.g. external JSON), use validateUnknown(schema, raw)
+
+    const order = yield* dbTransaction(db, txInput, async (tx, scoped) => {
+      const [created] = await tx.insert(orders).values(scoped.createOrder).returning()
+
+      const itemInsert = mergeMutationInput(scoped.createItem, {
+        orderId: created.id,
+      })
+      await tx.insert(orderItems).values(itemInsert)
+
+      await tx.update(inventory)
+        .set(scoped.updateInventory)
+        .where(eq(inventory.productId, scoped.createItem.productId))
+
+      return created
+    })
+
+    return yield* redirect(`/orders/${order.id}`)
+  })
+)
+```
+
 ### API Endpoint (JSON Response)
 
 ```typescript
@@ -1200,6 +1295,30 @@ const input = yield* validateRequest(CreateEventSchema, {
 })
 ```
 
+### Request Input Sources
+
+`validateRequest(schema)` uses the legacy merge order by default:
+`params -> query -> body` (later sources win).
+
+Use `options.request` to switch behavior:
+
+```typescript
+// Laravel-style input (query + body; route params excluded)
+const input = yield* validateRequest(Schema, {
+  request: 'laravel',
+})
+
+// Custom merge order + conflict policy
+const input = yield* validateRequest(Schema, {
+  request: {
+    order: ['params', 'query', 'body'],
+    onConflict: 'error', // 'last-wins' | 'first-wins' | 'error'
+  },
+})
+```
+
+If both `profile` and `order` are provided, `order` takes precedence.
+
 ---
 
 ## Route Model Binding Examples
@@ -1819,7 +1938,8 @@ const handler = action(
     yield* cache.delete('my-key')
 
     // List keys by prefix
-    const keys = yield* cache.list({ prefix: 'user:' })
+    const page = yield* cache.list({ prefix: 'user:' })
+    const keys = page.keys
   })
 )
 ```
@@ -1857,7 +1977,10 @@ const createRedisCacheClient = (redisUrl: string): CacheClient => {
       Effect.tryPromise({
         try: async () => {
           const keys = await client.keys(options?.prefix ? `${options.prefix}*` : '*')
-          return { keys: keys.map((name) => ({ name })) }
+          return {
+            keys: keys.map((name) => ({ name })),
+            list_complete: true,
+          }
         },
         catch: (e) => new CacheClientError('Redis keys failed', e),
       }),
@@ -1907,6 +2030,7 @@ const makeTestCache = (): Layer.Layer<CacheService> => {
         keys: [...store.keys()]
           .filter((k) => !options?.prefix || k.startsWith(options.prefix))
           .map((name) => ({ name })),
+        list_complete: true,
       })),
   }
 
@@ -1988,7 +2112,7 @@ Recommended cache key patterns:
 
 ### Stale-While-Revalidate (SWR)
 
-The cache supports the stale-while-revalidate pattern for improved latency and resilience. When enabled, stale values are returned immediately while a background refresh is triggered.
+The cache supports the stale-while-revalidate pattern for improved latency and resilience. When enabled, stale values are returned immediately while a background refresh is triggered. In environments without `ExecutionContext`, stale entries are recomputed synchronously instead.
 
 ```typescript
 import { Effect, Duration } from 'effect'
@@ -2122,6 +2246,16 @@ export const dashboard = action(
 **Common use cases:**
 
 ```typescript
+import { Effect } from 'effect'
+import {
+  ExecutionContextService,
+  authorize,
+  DatabaseService,
+  dbMutation,
+  asTrusted,
+  BindingsService,
+} from 'honertia/effect'
+
 // Audit logging
 const auditLog = (action: string, details: Record<string, unknown>) =>
   Effect.gen(function* () {
@@ -2130,14 +2264,14 @@ const auditLog = (action: string, details: Record<string, unknown>) =>
     const db = yield* DatabaseService
 
     yield* ctx.runInBackground(
-      Effect.tryPromise(() =>
-        db.insert(auditLogs).values({
-          userId: user.id,
+      dbMutation(db, async (tx) => {
+        await tx.insert(auditLogs).values(asTrusted({
+          userId: user.user.id,
           action,
           details,
           timestamp: new Date(),
-        })
-      )
+        }))
+      })
     )
   })
 
@@ -2185,7 +2319,7 @@ const maybeNotifySlack = (message: string) =>
 **Important notes:**
 - Background tasks run after the response is sent to the user
 - Errors in background tasks are logged but don't crash the worker
-- In non-Worker environments (tests, local dev), `isAvailable` is `false` and tasks are skipped
+- In non-Worker environments (tests, local dev), `isAvailable` is `false` and stale entries are recomputed synchronously
 - Use `catchAll` to handle errors gracefully in background tasks
 
 ### Cache Key Versioning
@@ -2276,6 +2410,7 @@ import {
   authorize,
   cache,
   cacheInvalidate,
+  asTrusted,
   render,
   redirect,
   DatabaseService,
@@ -2331,7 +2466,7 @@ export const updateProfile = action(
 
     yield* dbMutation(db, async (db) => {
       await db.update(users)
-        .set({ name: input.name, bio: input.bio })
+        .set(asTrusted({ name: input.name, bio: input.bio }))
         .where(eq(users.id, auth.user.id))
     })
 

package/dist/__tmp_db_safety_probe.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__tmp_db_safety_probe.d.ts.map

package/dist/__tmp_db_safety_probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__tmp_db_safety_probe.d.ts","sourceRoot":"","sources":["../src/__tmp_db_safety_probe.ts"],"names":[],"mappings":""}

package/dist/__tmp_db_safety_probe.js

@@ -0,0 +1,13 @@
+import { asValidated } from './effect/validation.js';
+async function probe() {
+    const raw = { name: 'Pat', email: 'pat@example.com' };
+    // @ts-expect-error raw input should be rejected by SafeTx
+    await db.insert('users').values(raw);
+    const validated = asValidated(raw);
+    await db.insert('users').values(validated);
+    const merged = { ...validated, email: validated.email.toLowerCase() };
+    await db.insert('users').values(merged);
+    const role = (Math.random() > 0.5 ? 'admin' : 'member');
+    const mergedWithUnvalidated = { ...validated, role };
+    await dbWithRole.insert('users').values(mergedWithUnvalidated);
+}

package/dist/__tmp_scoped_astrusted_probe.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__tmp_scoped_astrusted_probe.d.ts.map

package/dist/__tmp_scoped_astrusted_probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__tmp_scoped_astrusted_probe.d.ts","sourceRoot":"","sources":["../src/__tmp_scoped_astrusted_probe.ts"],"names":[],"mappings":""}

package/dist/__tmp_scoped_astrusted_probe.js

@@ -0,0 +1,10 @@
+import { Effect } from 'effect';
+import { dbMutation } from './effect/action.js';
+import { asTrusted } from './effect/validation.js';
+const txInput = asTrusted({ createUser: { name: 'pat' } });
+const program = dbMutation(db, txInput, async (tx, scoped) => {
+    await tx.insert('users').values(scoped.createUser);
+    // @ts-expect-error scoped mode rejects ad-hoc asTrusted payloads
+    await tx.insert('users').values(asTrusted({ name: 'other' }));
+});
+void Effect.runSync(program);

package/dist/__tmp_scoped_derived_probe.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__tmp_scoped_derived_probe.d.ts.map

package/dist/__tmp_scoped_derived_probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__tmp_scoped_derived_probe.d.ts","sourceRoot":"","sources":["../src/__tmp_scoped_derived_probe.ts"],"names":[],"mappings":""}

package/dist/__tmp_scoped_derived_probe.js

@@ -0,0 +1,12 @@
+import { Effect } from 'effect';
+import { dbTransaction } from './effect/action.js';
+import { asTrusted } from './effect/validation.js';
+const program = dbTransaction(db, txInput, async (tx, scoped) => {
+    const [created] = await tx.insert('orders').values(scoped.createOrder).returning();
+    // @ts-expect-error scoped mode should reject plain/asTrusted derived values
+    await tx.insert('orderItems').values(asTrusted({
+        ...scoped.createItem,
+        orderId: created.id,
+    }));
+});
+void Effect.runSync(program);

package/dist/__tmp_scoped_mutation_probe.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=__tmp_scoped_mutation_probe.d.ts.map

package/dist/__tmp_scoped_mutation_probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__tmp_scoped_mutation_probe.d.ts","sourceRoot":"","sources":["../src/__tmp_scoped_mutation_probe.ts"],"names":[],"mappings":""}

package/dist/__tmp_scoped_mutation_probe.js

@@ -0,0 +1,15 @@
+import { Effect } from 'effect';
+import { dbMutation } from './effect/action.js';
+import { asTrusted } from './effect/validation.js';
+const input = asTrusted({
+    createUser: {
+        name: 'Pat',
+        userId: 'u1',
+    },
+});
+const program = dbMutation(db, input, async (tx, scoped) => {
+    await tx.insert('users').values(scoped.createUser);
+    // @ts-expect-error scoped mode should reject ad-hoc trusted values
+    await tx.insert('users').values(asTrusted({ name: 'Other', userId: 'u2' }));
+});
+void Effect.runSync(program);

package/dist/cache.d.ts

@@ -15,7 +15,7 @@ export type CacheOptions = {
     /**
      * Stale-while-revalidate window. When set, stale values within this window
      * are returned immediately while a background refresh is triggered.
-     * Without ExecutionContext, the refresh happens on the next request.
+     * Without ExecutionContext, stale entries are recomputed synchronously.
      */
     swr?: Duration.DurationInput;
     /**
@@ -84,6 +84,8 @@ export declare class CacheError extends CacheError_base {
 export declare const cache: <V, E, R>(key: string, compute: Effect.Effect<V, E, R>, schema: Schema.Schema<V>, options: CacheOptions) => Effect.Effect<V, E | CacheError | CacheClientError | ParseResult.ParseError, R | CacheService | ExecutionContextService>;
 /**
  * Get a value from cache without computing.
+ * Returns any entry still present in the backing cache store.
+ * This does not apply `ttl`/`swr` freshness checks used by `cache()`.
  *
  * @example
  * ```typescript

package/dist/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAM9F,MAAM,MAAM,YAAY,GAAG;IACzB,qCAAqC;IACrC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAA;IAC3B;;;;OAIG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAA;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B,CAAA;;;;;;;AAMD,qBAAa,UAAW,SAAQ,eAG9B;CAAG;AA2DL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAC3B,KAAK,MAAM,EACX,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC/B,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,SAAS,YAAY,KACpB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC,GAAG,YAAY,GAAG,uBAAuB,CAuDtH,CAAA;AAEJ;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,KAAK,MAAM,EACX,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,UAAU,eAAe,KACxB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,YAAY,CAenG,CAAA;AAEJ;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,KAAK,MAAM,EACX,OAAO,CAAC,EACR,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,SAAS,YAAY,KACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,YAAY,CAevF,CAAA;AAEJ,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACxB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAC1B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,GAAG,OAAO,EACzC,KAAK,MAAM,EACX,UAAU,sBAAsB,CAAC,CAAC,CAAC,KAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAOjD,CAAA;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAWjD,CAAA"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACtE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAM9F,MAAM,MAAM,YAAY,GAAG;IACzB,qCAAqC;IACrC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAA;IAC3B;;;;OAIG;IACH,GAAG,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAA;IAC5B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B,CAAA;;;;;;;AAMD,qBAAa,UAAW,SAAQ,eAG9B;CAAG;AA2DL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAC3B,KAAK,MAAM,EACX,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC/B,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,SAAS,YAAY,KACpB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,CAAC,GAAG,YAAY,GAAG,uBAAuB,CA0DtH,CAAA;AAEJ;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,KAAK,MAAM,EACX,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,UAAU,eAAe,KACxB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,YAAY,CAenG,CAAA;AAEJ;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,EACxB,KAAK,MAAM,EACX,OAAO,CAAC,EACR,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EACxB,SAAS,YAAY,KACpB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,gBAAgB,GAAG,WAAW,CAAC,UAAU,EAAE,YAAY,CAevF,CAAA;AAEJ,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;IACtC,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACxB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;CAC1B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,GAAG,OAAO,EACzC,KAAK,MAAM,EACX,UAAU,sBAAsB,CAAC,CAAC,CAAC,KAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAOjD,CAAA;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,KACb,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,EAAE,YAAY,CAwBjD,CAAA"}

package/dist/cache.js

@@ -131,8 +131,10 @@ export const cache = (key, compute, schema, options) => Effect.gen(function* ()
                     const freshValue = yield* compute;
                     yield* storeInCache(freshValue);
                 }));
+                return entry.v;
             }
-            return entry.v;
+            // No background execution available (tests/local dev): refresh inline.
+            // Fall through to synchronous recompute below.
         }
         // Beyond SWR window - fall through to recompute
     }
@@ -144,6 +146,8 @@ export const cache = (key, compute, schema, options) => Effect.gen(function* ()
 });
 /**
  * Get a value from cache without computing.
+ * Returns any entry still present in the backing cache store.
+ * This does not apply `ttl`/`swr` freshness checks used by `cache()`.
  *
  * @example
  * ```typescript
@@ -220,6 +224,13 @@ export const cacheInvalidate = (key, options) => Effect.gen(function* () {
  */
 export const cacheInvalidatePrefix = (prefix) => Effect.gen(function* () {
     const cacheService = yield* CacheService;
-    const list = yield* cacheService.list({ prefix });
-    yield* Effect.forEach(list.keys, (key) => cacheService.delete(key.name), { concurrency: 10 });
+    let cursor = undefined;
+    while (true) {
+        const page = yield* cacheService.list({ prefix, cursor });
+        yield* Effect.forEach(page.keys, (key) => cacheService.delete(key.name), { concurrency: 10 });
+        if (page.list_complete || page.cursor === undefined) {
+            break;
+        }
+        cursor = page.cursor;
+    }
 });

package/dist/cli/bin.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Honertia CLI entrypoint.
+ *
+ * This powers the `honertia` executable distributed with the package.
+ */
+export declare function runCli(args?: string[]): Promise<void>;
+//# sourceMappingURL=bin.d.ts.map

package/dist/cli/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAwFH,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DlF"}

package/dist/cli/bin.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+/**
+ * Honertia CLI entrypoint.
+ *
+ * This powers the `honertia` executable distributed with the package.
+ */
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { runRoutes, routesHelp } from './index.js';
+import { runCheck, checkHelp } from './check.js';
+import { runDb, dbHelp } from './db.js';
+import { runGenerateAction, generateActionHelp, runGenerateCrud, generateCrudHelp } from './generate.js';
+import { runGenerateFeature, generateFeatureHelp } from './feature.js';
+import { runGenerateOpenApi, generateOpenApiHelp } from './openapi.js';
+import { runGenerateInlineTestsRunner, generateInlineTestsRunnerHelp } from './inline-tests.js';
+function mainHelp() {
+    return `
+honertia - Agent-first CLI for Honertia
+
+USAGE:
+  honertia <command> [OPTIONS]
+
+COMMANDS:
+  routes                        List registered routes
+  check                         Validate project routes/configuration
+  db <subcommand>               Database migration commands
+  db:status                     Alias for "db status"
+  db:migrate                    Alias for "db migrate"
+  db:rollback                   Alias for "db rollback"
+  db:generate <name>            Alias for "db generate <name>"
+  generate:action <name>        Generate a colocated action file
+  generate:crud <resource>      Generate CRUD action files
+  generate:feature <name>       Generate a colocated feature file
+  generate:openapi              Generate OpenAPI spec
+  generate:tests-runner         Generate inline tests runner
+
+EXAMPLES:
+  honertia routes --json
+  honertia check --verbose
+  honertia db status
+  honertia db:migrate --preview
+  honertia generate:action projects/create --method POST --path /projects
+  honertia generate:openapi --output openapi.json --format json
+
+Run "honertia <command> --help" for command-specific options.
+`.trim();
+}
+function commandHelp(command) {
+    switch (command) {
+        case 'routes':
+            return routesHelp();
+        case 'check':
+            return checkHelp();
+        case 'db':
+        case 'db:status':
+        case 'db:migrate':
+        case 'db:rollback':
+        case 'db:generate':
+            return dbHelp();
+        case 'generate:action':
+            return generateActionHelp();
+        case 'generate:crud':
+            return generateCrudHelp();
+        case 'generate:feature':
+            return generateFeatureHelp();
+        case 'generate:openapi':
+            return generateOpenApiHelp();
+        case 'generate:tests-runner':
+            return generateInlineTestsRunnerHelp();
+        default:
+            return null;
+    }
+}
+function normalizeCommand(args) {
+    if (args.length === 0) {
+        return { command: null, rest: [] };
+    }
+    const [first, ...rest] = args;
+    // Support grouped form: "generate action ..."
+    if (first === 'generate' && rest.length > 0) {
+        const [subcommand, ...remaining] = rest;
+        return { command: `generate:${subcommand}`, rest: remaining };
+    }
+    return { command: first, rest };
+}
+export async function runCli(args = process.argv.slice(2)) {
+    const { command, rest } = normalizeCommand(args);
+    if (!command || command === '--help' || command === '-h' || command === 'help') {
+        if (rest.length > 0) {
+            const help = commandHelp(rest[0]);
+            if (help) {
+                console.log(help);
+                return;
+            }
+        }
+        console.log(mainHelp());
+        return;
+    }
+    switch (command) {
+        case 'routes':
+            runRoutes(rest);
+            return;
+        case 'check':
+            runCheck(rest);
+            return;
+        case 'db':
+            await runDb(rest);
+            return;
+        case 'db:status':
+            await runDb(['status', ...rest]);
+            return;
+        case 'db:migrate':
+            await runDb(['migrate', ...rest]);
+            return;
+        case 'db:rollback':
+            await runDb(['rollback', ...rest]);
+            return;
+        case 'db:generate':
+            await runDb(['generate', ...rest]);
+            return;
+        case 'generate:action':
+            runGenerateAction(rest);
+            return;
+        case 'generate:crud':
+            runGenerateCrud(rest);
+            return;
+        case 'generate:feature':
+            runGenerateFeature(rest);
+            return;
+        case 'generate:openapi':
+            await runGenerateOpenApi(rest);
+            return;
+        case 'generate:tests-runner':
+            runGenerateInlineTestsRunner(rest);
+            return;
+        default:
+            console.error(`Unknown command: ${command}`);
+            console.error('Run "honertia --help" for usage');
+            process.exit(1);
+    }
+}
+const isMain = process.argv[1]
+    ? resolve(process.argv[1]) === fileURLToPath(import.meta.url)
+    : false;
+if (isMain) {
+    runCli().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    });
+}

package/dist/cli/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/cli/db.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/cli/db.ts"],"names":[],"mappings":"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"}