@akanjs/cli 3.0.0-alpha.0 → 3.0.0-alpha.2

package/.build-stamp

@@ -1 +1 @@
-ce7835b9c7e649ebc830a1ac94fa9db80a2c2aaec64459445780b8dc7bd627a0
+5ce0c5971a50c46a41ba69a3a1125bb984dfbb8bc836bb7a817970eca45b7c59

package/{abstractCompactor-rk6twzvj.js → abstractCompactor-e5yq60qz.js}

@@ -1,11 +1,11 @@
 // @bun
 import {
   AiSession
-} from "./index-3pgtw35d.js";
+} from "./index-0cj2zxbm.js";
 import {
   AbstractDoc
 } from "./index-0wae5ebk.js";
-import"./index-6pz1j0zj.js";
+import"./index-mxvakhsm.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{agent.command-jfz8yfwy.js → agent.command-yv00p0s0.js}

@@ -1,16 +1,16 @@
 // @bun
 import {
   AgentScript
-} from "./index-n0z3f2xg.js";
-import"./index-4yp06pn1.js";
-import"./index-4zgs8g1w.js";
-import"./index-xwgm94zr.js";
+} from "./index-ej426mcr.js";
+import"./index-a00jg8x8.js";
+import"./index-rzwcpcc3.js";
+import"./index-tdbas9r0.js";
 import {
   Workspace,
   command
-} from "./index-jk9q6pse.js";
-import"./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+} from "./index-8hsbnyes.js";
+import"./index-hgna5rjy.js";
+import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";

package/{application.command-3smsv7mq.js → application.command-0qsczf4k.js}

@@ -4,22 +4,22 @@ import {
 } from "./index-0wae5ebk.js";
 import {
   ApplicationScript
-} from "./index-ev6rjw9n.js";
+} from "./index-e16gnn26.js";
 import {
   getMobileTargetChoices
 } from "./index-76rn3g2c.js";
-import"./index-cn24dcqn.js";
+import"./index-7c6k4yvg.js";
 import {
   App,
   Exec,
   Sys,
   Workspace,
   command
-} from "./index-jk9q6pse.js";
+} from "./index-8hsbnyes.js";
 import"./index-fgc8r6dj.js";
 import"./index-bjpxzr6s.js";
-import"./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+import"./index-hgna5rjy.js";
+import"./index-mxvakhsm.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{applicationBuildRunner-aq7mb3z6.js → applicationBuildRunner-ct2pxyvw.js}

@@ -10,7 +10,7 @@ import"./index-rh16j3c7.js";
 import"./index-bjpxzr6s.js";
 import {
   Spinner
-} from "./index-6pz1j0zj.js";
+} from "./index-mxvakhsm.js";
 import"./index-r24hmh0q.js";
 
 // pkgs/@akanjs/devkit/applicationBuildRunner.ts

package/{applicationReleasePackager-yrrhbkv3.js → applicationReleasePackager-gg8ccbeh.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   Spinner
-} from "./index-6pz1j0zj.js";
+} from "./index-mxvakhsm.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/buildBatch.proc.js

@@ -12,8 +12,8 @@ import"./index-bjpxzr6s.js";
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+} from "./index-hgna5rjy.js";
+import"./index-mxvakhsm.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{capacitorApp-q3mpmkkz.js → capacitorApp-4r9sm3qg.js}

@@ -24,10 +24,10 @@ import {
   selectLocalDevHost,
   sortIosRunTargets,
   writeRootCapacitorConfig
-} from "./index-sggm9qkv.js";
+} from "./index-t3723f99.js";
 import"./index-76rn3g2c.js";
-import"./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+import"./index-hgna5rjy.js";
+import"./index-mxvakhsm.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 export {

package/{cloud.command-rk4e9vrt.js → cloud.command-dxfv18sa.js}

@@ -1,23 +1,23 @@
 // @bun
 import {
   CloudScript
-} from "./index-f4gqk0dd.js";
-import"./index-ktprgc5g.js";
-import"./index-e3qskyt2.js";
+} from "./index-nm6wghb6.js";
+import"./index-zasydjxd.js";
+import"./index-k95xkh4p.js";
 import {
   GlobalConfig
-} from "./index-3pgtw35d.js";
-import"./index-ev6rjw9n.js";
+} from "./index-0cj2zxbm.js";
+import"./index-e16gnn26.js";
 import"./index-76rn3g2c.js";
-import"./index-cn24dcqn.js";
+import"./index-7c6k4yvg.js";
 import {
   Workspace,
   command
-} from "./index-jk9q6pse.js";
+} from "./index-8hsbnyes.js";
 import"./index-fgc8r6dj.js";
 import"./index-bjpxzr6s.js";
-import"./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+import"./index-hgna5rjy.js";
+import"./index-mxvakhsm.js";
 import"./index-46tjzh6s.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";

package/{context.command-ygzyb0xb.js → context.command-8d9e3k6b.js}

@@ -1,26 +1,26 @@
 // @bun
 import {
   ContextScript
-} from "./index-h0bngh79.js";
-import"./index-b978vs2e.js";
-import"./index-csqk9z5j.js";
-import"./index-r4w8cry5.js";
-import"./index-vhv3xnjz.js";
-import"./index-hjzr8ja1.js";
-import"./index-fmgbwsr5.js";
+} from "./index-1pvex4az.js";
+import"./index-mr5s7mqd.js";
+import"./index-2q1f5j9k.js";
+import"./index-bekddz9q.js";
+import"./index-yzmhasdb.js";
+import"./index-bbkek1bp.js";
+import"./index-ec09pws3.js";
 import"./index-ss469dec.js";
-import"./index-sggm9qkv.js";
-import"./index-3pgtw35d.js";
-import"./index-4yp06pn1.js";
-import"./index-4zgs8g1w.js";
-import"./index-xwgm94zr.js";
+import"./index-t3723f99.js";
+import"./index-0cj2zxbm.js";
+import"./index-a00jg8x8.js";
+import"./index-rzwcpcc3.js";
+import"./index-tdbas9r0.js";
 import"./index-76rn3g2c.js";
 import {
   Workspace,
   command
-} from "./index-jk9q6pse.js";
-import"./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+} from "./index-8hsbnyes.js";
+import"./index-hgna5rjy.js";
+import"./index-mxvakhsm.js";
 import"./index-xys926f2.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";

package/{guideline.command-1m1ctar3.js → guideline.command-3jbkxzh6.js}

@@ -1,20 +1,20 @@
 // @bun
 import {
   AiSession
-} from "./index-3pgtw35d.js";
+} from "./index-0cj2zxbm.js";
 import {
   Prompter
-} from "./index-xwgm94zr.js";
+} from "./index-tdbas9r0.js";
 import {
   Workspace,
   command,
   runner,
   script
-} from "./index-jk9q6pse.js";
+} from "./index-8hsbnyes.js";
 import {
   getDirname
-} from "./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+} from "./index-hgna5rjy.js";
+import"./index-mxvakhsm.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/guidelines/ssrRule/ssrRule.generate.json

@@ -0,0 +1,31 @@
+{
+  "title": "SSR Rule",
+  "description": "Akan SSR-first rendering rules — keep JSX on the server and justify every client boundary",
+  "group": "core",
+  "codegenPriority": 3,
+  "deprecated": false,
+  "scans": [
+    {
+      "type": "example",
+      "description": "Client boundary shells that render server children untouched",
+      "path": "{apps,libs}/*/ui/**/*.tsx",
+      "sample": 4
+    },
+    {
+      "type": "example",
+      "description": "Module UI split across client Zone/Template/Util and server Unit/View",
+      "path": "{apps,libs}/*/lib/*/*.tsx",
+      "sample": 4
+    }
+  ],
+  "update": {
+    "filePath": "./ssrRule.instruction.md",
+    "contents": ["purpose", "when a client boundary is earned", "quality rules", "implementation playbook"],
+    "rules": [
+      "Use current Akan APIs only",
+      "Keep output parseable for codegen",
+      "Name the akan.ssr.* rule ids the quality scanner emits",
+      "Ground every pattern in a file that exists in the workspace"
+    ]
+  }
+}

package/guidelines/ssrRule/ssrRule.instruction.md

@@ -0,0 +1,108 @@
+# Akan SSR Rule Guideline
+
+## Purpose
+Use this when writing or reviewing any `.tsx` file. Akan is SSR-first: an element rendered on the server ships as
+HTML and costs nothing to hydrate, while an element behind `"use client"` ships twice — as markup and as bundled JS
+that re-runs in the browser. The boundary question is never "may this file be client", it is **how little ends up
+on the client side**.
+
+## When A Client Boundary Is Earned
+- A component earns `"use client"` only by using a client-only capability: a React hook, a JSX event handler, the
+  store (`st.use.*` / `st.do.*`), a browser global (`window`, `document`, `navigator`, `localStorage`, …), or a
+  client-only third-party package.
+- Rendering markup, mapping over data, reading a route param, and calling `l()` are server work. `usePage()` and
+  `getSelf()` are legal in server components and never force a boundary.
+- In domain UI the file role fixes the directive: `Template`, `Zone`, and `Util` are client; `Unit` and `View` are
+  server. That decides *where* the boundary sits, not how much markup sits behind it — a `Zone` that hoards markup
+  is still an SSR regression.
+- Measure with `akan quality ssr` (`--format json` for tooling). It reports the server render share per app and
+  lib as server-rendered JSX elements over total. Treat **50% server share as the floor** and a falling share as a
+  regression to justify or revert.
+
+## Quality Rules
+- `akan.ssr.unnecessary-use-client` — the directive is present but nothing in the file needs it. Delete it. If the
+  file exists only to wrap one client child, drop the wrapper and use the child directly.
+- `akan.ssr.client-static-component` — a component inside a client file renders real markup with zero client-only
+  capability. Move it to a server file: a `<Model>.Unit.tsx` / `<Model>.View.tsx` for a module, or a `ui/` file with
+  no directive.
+- `akan.ssr.client-static-markup` — a large subtree wraps one or two interactive touches. Keep the interactive
+  element in the client component and hoist the static subtree into a server component received as `children`.
+- `akan.ssr.client-mount-load` — a `useEffect(…, [])` loads server data. Fetch it in the route and pass the
+  init/view object down.
+- `akan.ssr.module-missing-server-view` — a module renders only from `Template`/`Zone`/`Util` and declares no
+  `Unit`/`View`. Add them and have the `Zone` delegate.
+- `akan.ssr.template-client-state` — a `Template` holds form state in `useState`. Bind to the store instead:
+  `value={xForm.field}` with `onChange={st.do.setFieldOnX}`.
+
+A third-party client package and the `ui/<Folder>/index_.tsx` + `lazy()` boundary both justify the directive and are
+not flagged. Interaction-driven `fetch.*` inside an `onClick` is not flagged either — only mount-time loads are,
+because those are the ones the server could have performed.
+
+## Implementation Playbook
+
+**① Wrap the interaction, not the UI.** The smallest useful client component adds one behaviour and renders
+`children` untouched, so the markup inside never reaches the bundle.
+
+```tsx
+"use client";
+export const ClickWrapper = ({ children, onPick }: ClickWrapperProps) => <div onClick={onPick}>{children}</div>;
+```
+
+`libs/shared/ui/Only/User.tsx` is the same shape: it reads auth state on the client and returns `{children}`.
+
+**② Split compound components so panels stay on the server.** A tab, accordion, or disclosure needs client state
+only for *which* part is visible, never for what the parts contain. `Tab` / `Tab.Menus` / `Tab.Menu` / `Tab.Panel`
+in `akanjs/ui` is the reference: only the provider and menu hold state, and `<Tab.Panel>` renders its children
+as-is, so a server `Unit`/`View` passed in stays server-rendered.
+
+```tsx
+<Tab defaultMenu="detail">
+  <Tab.Menus>
+    <Tab.Menu menu="detail">{l("post.detail")}</Tab.Menu>
+    <Tab.Menu menu="history">{l("post.history")}</Tab.Menu>
+  </Tab.Menus>
+  <Tab.Panel menu="detail">
+    <Post.View.General post={post} />
+  </Tab.Panel>
+</Tab>
+```
+
+Never collapse this into one client file with a mode `useState` and every panel body inlined.
+
+**③ Sync state instead of fetching it.** A server component cannot hold state, so render the initial data on the
+server and hand it across as a serializable object. The route calls `fetch.initXInY(...)` / `fetch.viewX(...)` and
+passes the result into a `Zone`; `Load.Units` / `Load.View` hydrate the store from it. A `useEffect(…, [])` that
+fetches on mount renders an empty shell, hydrates, then round-trips for data the server already had.
+
+**④ Push the boundary down to the leaf that needs it.** A store-reading `Zone` should hold zero markup and delegate
+to a server `View` — `User.Zone.Self` is one line, `st.use.self()` into `<User.View.General user={self} />`, so the
+whole detail surface renders server-side wherever a route uses the `View` directly.
+
+**⑤ Hand the promise across, not the awaited value.** `ClientInit` / `ClientView` are `PromiseOrObject<T>`, so a
+route may pass an unawaited `fetch.initX(...)` and `Load.*` resolves it behind a skeleton. `await` blocks the shell
+for data the page needs immediately; the promise streams the rest. Independent fetches still go through one
+`Promise.all`.
+
+**⑥ Use named `ReactNode` slots, not just `children`.** `Layout.Navbar` accepts `title`, `back`, `left`, `right`,
+and `children`, so a client shell composes server-rendered content in five places instead of absorbing it.
+
+**⑦ Let the server do the derived work.** Display and predicate logic belongs on `Light<Model>` (`isNew()`,
+`canWrite(user?)`, `formatTimes()`), and enum→class lookups belong in a module-scope `as const` map. Both sides call
+the same method, so a client component that exists only to compute a label is markup in the wrong place.
+
+**⑧ Gate auth on the server.** `getSelf({ unauthorize: "/signin" })` in `_layout.tsx` redirects before any HTML is
+sent. A client-side check costs a hydration round-trip and flashes the wrong UI first.
+
+**⑨ Prefer CSS over client state for pure visibility.** A `data-*` attribute plus `group-data-[…]` variants (see
+`libs/util/ui/Grid/*`) or `<details>`/`<summary>` keeps both branches server-rendered. Reach for `useState` when the
+state is real, not when a Tailwind variant would do.
+
+**⑩ Keep the heavy island out of the first load.** A large client-only widget goes behind the
+`ui/<Folder>/index_.tsx` + `lazy()` pair so the server renders the page around it.
+
+## Review Checklist
+- Does every `"use client"` in the diff name a capability that requires it?
+- Does each client component hold only interaction, with markup delegated to `children`, a slot prop, or a
+  `Unit`/`View`?
+- Is initial data fetched in the route and passed as `init`/`view`, with no mount-only load effect?
+- Did `akan quality ssr` hold or improve the server share for every touched app and lib?

package/incrementalBuilder.proc.js

@@ -16,8 +16,8 @@ import {
 import {
   AppExecutor,
   WorkspaceExecutor
-} from "./index-jtm86byd.js";
-import"./index-6pz1j0zj.js";
+} from "./index-hgna5rjy.js";
+import"./index-mxvakhsm.js";
 import"./index-67546d0j.js";
 import"./index-r24hmh0q.js";
 

package/{index-3pgtw35d.js → index-0cj2zxbm.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   Spinner
-} from "./index-6pz1j0zj.js";
+} from "./index-mxvakhsm.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/{index-h0bngh79.js → index-1pvex4az.js}

@@ -1,22 +1,22 @@
 // @bun
 import {
   RepairRunner
-} from "./index-b978vs2e.js";
+} from "./index-mr5s7mqd.js";
 import {
   WorkflowRunner
-} from "./index-csqk9z5j.js";
+} from "./index-2q1f5j9k.js";
 import {
   PrimitiveScript
-} from "./index-r4w8cry5.js";
+} from "./index-bekddz9q.js";
 import {
   ModuleScript
-} from "./index-vhv3xnjz.js";
+} from "./index-yzmhasdb.js";
 import {
   ScalarScript
-} from "./index-fmgbwsr5.js";
+} from "./index-ec09pws3.js";
 import {
   isPlaceholderAppId
-} from "./index-sggm9qkv.js";
+} from "./index-t3723f99.js";
 import {
   AkanContextAnalyzer,
   akanMcpInstallConfigPaths,
@@ -27,17 +27,17 @@ import {
   renderDoctorText,
   resourceList,
   upsertCodexMcpServerBlock
-} from "./index-4yp06pn1.js";
+} from "./index-a00jg8x8.js";
 import {
   buildAkanModuleContextIndex,
   createWorkflowBaselineSummary,
   createWorkflowStepRegistry,
   jsonText,
   toolingRolloutGate
-} from "./index-4zgs8g1w.js";
+} from "./index-rzwcpcc3.js";
 import {
   Prompter
-} from "./index-xwgm94zr.js";
+} from "./index-tdbas9r0.js";
 import {
   getMobileTargets
 } from "./index-76rn3g2c.js";
@@ -45,10 +45,10 @@ import {
   CommandContainer,
   runner,
   script
-} from "./index-jk9q6pse.js";
+} from "./index-8hsbnyes.js";
 import {
   AppExecutor
-} from "./index-jtm86byd.js";
+} from "./index-hgna5rjy.js";
 
 // pkgs/@akanjs/cli/context/context.script.ts
 import { Logger } from "akanjs/common";

package/{index-csqk9z5j.js → index-2q1f5j9k.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   AkanContextAnalyzer
-} from "./index-4yp06pn1.js";
+} from "./index-a00jg8x8.js";
 import {
   WorkflowExecutor,
   compactWorkflowInputs,
@@ -23,10 +23,10 @@ import {
   workflowCommandsForPlan,
   workflowPlanApproval,
   writeWorkflowRunArtifact
-} from "./index-4zgs8g1w.js";
+} from "./index-rzwcpcc3.js";
 import {
   runner
-} from "./index-jk9q6pse.js";
+} from "./index-8hsbnyes.js";
 
 // pkgs/@akanjs/cli/workflow/workflow.runner.ts
 import { mkdir, readFile, writeFile } from "fs/promises";

package/{index-cn24dcqn.js → index-7c6k4yvg.js}

@@ -2,10 +2,10 @@
 import {
   runner,
   script
-} from "./index-jk9q6pse.js";
+} from "./index-8hsbnyes.js";
 import {
   LibExecutor
-} from "./index-jtm86byd.js";
+} from "./index-hgna5rjy.js";
 
 // pkgs/@akanjs/cli/semver.ts
 function parseVersion(version) {

package/{index-jk9q6pse.js → index-8hsbnyes.js}

@@ -7,7 +7,7 @@ import {
   PkgExecutor,
   WorkspaceExecutor,
   getDirname
-} from "./index-jtm86byd.js";
+} from "./index-hgna5rjy.js";
 import {
   FileSys
 } from "./index-67546d0j.js";

package/{index-4yp06pn1.js → index-a00jg8x8.js}

@@ -2,11 +2,11 @@
 import {
   workflowRunArtifactPath,
   workflowSyncDir
-} from "./index-4zgs8g1w.js";
+} from "./index-rzwcpcc3.js";
 import {
   AppExecutor,
   LibExecutor
-} from "./index-jtm86byd.js";
+} from "./index-hgna5rjy.js";
 import {
   collectRecipeSources,
   findInlineRecipeDuplicates,

package/{index-hjzr8ja1.js → index-bbkek1bp.js}

@@ -2,7 +2,7 @@
 import {
   runner,
   script
-} from "./index-jk9q6pse.js";
+} from "./index-8hsbnyes.js";
 
 // pkgs/@akanjs/cli/page/page.runner.ts
 class PageRunner extends runner("page") {

package/{index-r4w8cry5.js → index-bekddz9q.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   ModuleScript
-} from "./index-vhv3xnjz.js";
+} from "./index-yzmhasdb.js";
 import {
   addFieldUiPolicyForType,
   coerceFieldDefault,
@@ -34,15 +34,15 @@ import {
   sourceFile,
   validationCommandsForTarget,
   viaBuilderParameterName
-} from "./index-4zgs8g1w.js";
+} from "./index-rzwcpcc3.js";
 import {
   script
-} from "./index-jk9q6pse.js";
+} from "./index-8hsbnyes.js";
 import {
   AppExecutor,
   LibExecutor,
   ModuleExecutor
-} from "./index-jtm86byd.js";
+} from "./index-hgna5rjy.js";
 
 // pkgs/@akanjs/cli/primitive/primitive.script.ts
 import { capitalize } from "akanjs/common";

package/{index-ev6rjw9n.js → index-e16gnn26.js}

@@ -4,11 +4,11 @@ import {
 } from "./index-76rn3g2c.js";
 import {
   LibraryScript
-} from "./index-cn24dcqn.js";
+} from "./index-7c6k4yvg.js";
 import {
   runner,
   script
-} from "./index-jk9q6pse.js";
+} from "./index-8hsbnyes.js";
 import {
   HmrWatcher,
   WatchRootResolver
@@ -18,7 +18,7 @@ import {
   LibExecutor,
   PkgExecutor,
   WorkspaceExecutor
-} from "./index-jtm86byd.js";
+} from "./index-hgna5rjy.js";
 import {
   __require
 } from "./index-r24hmh0q.js";
@@ -1898,10 +1898,10 @@ function openBrowser(url) {
 }
 
 // pkgs/@akanjs/cli/application/application.runner.ts
-var loadBuildRunner = async () => (await import("./applicationBuildRunner-aq7mb3z6.js")).ApplicationBuildRunner;
-var loadReleasePackager = async () => (await import("./applicationReleasePackager-yrrhbkv3.js")).ApplicationReleasePackager;
-var loadCapacitorApp = async () => (await import("./capacitorApp-q3mpmkkz.js")).CapacitorApp;
-var loadAbstractCompactor = async () => (await import("./abstractCompactor-rk6twzvj.js")).AbstractCompactor;
+var loadBuildRunner = async () => (await import("./applicationBuildRunner-ct2pxyvw.js")).ApplicationBuildRunner;
+var loadReleasePackager = async () => (await import("./applicationReleasePackager-gg8ccbeh.js")).ApplicationReleasePackager;
+var loadCapacitorApp = async () => (await import("./capacitorApp-4r9sm3qg.js")).CapacitorApp;
+var loadAbstractCompactor = async () => (await import("./abstractCompactor-e5yq60qz.js")).AbstractCompactor;
 var loadPrompts = async () => await import("@inquirer/prompts");
 
 class ApplicationRunner extends runner("application") {
@@ -2241,6 +2241,7 @@ ${detail}`
 
 // pkgs/@akanjs/cli/application/application.script.ts
 class ApplicationScript extends script("application", [ApplicationRunner, LibraryScript]) {
+  static dbShutdownTimeoutMs = 20000;
   async confirmDatabaseModeDependencyInstall(databaseMode, installSpecs) {
     return await confirm({
       message: [
@@ -2418,10 +2419,7 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
     if (app.getEnv() === "local" && dbup && databaseMode !== "single") {
       const wasDbAlreadyUp = await this.dbup(app.workspace, databaseMode);
       if (!wasDbAlreadyUp)
-        process.on("SIGINT", async () => {
-          await this.dbdown(app.workspace);
-          process.exit(0);
-        });
+        this.#stopDatabaseOnInterrupt(app.workspace);
     }
     const spinner = app.spinning("Preparing backend...");
     const akanAppHost = await this.applicationRunner.start(app, {
@@ -2518,9 +2516,34 @@ class ApplicationScript extends script("application", [ApplicationRunner, Librar
   }
   async dbdown(workspace) {
     const spinner = workspace.spinning("Stopping local database...");
-    await this.applicationRunner.dbdown(workspace);
+    try {
+      await this.applicationRunner.dbdown(workspace);
+    } catch (error) {
+      spinner.fail("Local database failed to stop");
+      throw error;
+    }
     spinner.succeed("Local database (/local/docker-compose.yaml) is down");
   }
+  #stopDatabaseOnInterrupt(workspace) {
+    let stopping = false;
+    process.on("SIGINT", () => {
+      if (stopping) {
+        Logger5.rawLog("Abandoning the local database teardown; containers are left running.", undefined, "warn");
+        process.exit(130);
+      }
+      stopping = true;
+      this.#stopDatabase(workspace).finally(() => process.exit(0));
+    });
+  }
+  async#stopDatabase(workspace) {
+    const timeout = new Promise((resolve) => setTimeout(() => resolve("timeout"), ApplicationScript.dbShutdownTimeoutMs));
+    const result = await Promise.race([this.dbdown(workspace).catch(() => {
+      return;
+    }), timeout]);
+    if (result !== "timeout")
+      return;
+    Logger5.rawLog(`Local database did not stop within ${ApplicationScript.dbShutdownTimeoutMs}ms; run \`akan dbdown\` once Docker responds.`, undefined, "warn");
+  }
   async testSys(sys) {
     if (sys.type === "app")
       await this.testApplication(sys);