@akanjs/cli 3.3.0-rc.11 → 3.3.0-rc.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/.build-stamp +2 -2
  2. package/{CodeAgent-cqbf9gsv.js → CodeAgent-zkr3s3xy.js} +2 -2
  3. package/{CodeTui-ehdr4hgw.js → CodeTui-1qvrzfmy.js} +1 -1
  4. package/TunnelShare-8j95ta3w.js +16 -0
  5. package/{agent.command-x55ncdjm.js → agent.command-dejgb8vz.js} +18 -17
  6. package/akanCode.js +2 -2
  7. package/{appExecutor-1ctzymwa.js → appExecutor-nj95a6en.js} +3 -3
  8. package/{application.command-xpntxnh8.js → application.command-3tnq1587.js} +45 -15
  9. package/{applicationBuildRunner-19c76791.js → applicationBuildRunner-cbjy05yg.js} +75 -12
  10. package/buildBatch.proc.js +10 -10
  11. package/{cloud.command-p3ybjes7.js → cloud.command-qae6et2e.js} +19 -18
  12. package/cloud.script-34xmprty.js +31 -0
  13. package/{code.command-m6skj1kj.js → code.command-xrh506zf.js} +10 -10
  14. package/commandManifest.json +1 -1
  15. package/{context.command-3c3nv0d6.js → context.command-fxyzkwg5.js} +18 -18
  16. package/context.runner-bz1jwxkk.js +32 -0
  17. package/{csrArtifactBuilder-mdh9ykn2.js → csrArtifactBuilder-rqg85wbg.js} +2 -2
  18. package/{guideline.command-725fq5p0.js → guideline.command-7dgscqjq.js} +6 -6
  19. package/guidelines/akanApi/akanApi.instruction.md +10 -0
  20. package/guidelines/conventions/rules/config.md +5 -0
  21. package/guidelines/conventions/rules/page.md +4 -3
  22. package/guidelines/conventions/rules/server.md +21 -81
  23. package/guidelines/conventions/rules/ssr.md +4 -25
  24. package/guidelines/conventions/rules/style.md +9 -32
  25. package/guidelines/cssRule/cssRule.instruction.md +11 -4
  26. package/guidelines/errorCodes/errorCodes.instruction.md +4 -0
  27. package/guidelines/pageRule/pageRule.instruction.md +19 -0
  28. package/guidelines/recipeRule/recipeRule.instruction.md +3 -3
  29. package/guidelines/runtimeRule/runtimeRule.instruction.md +109 -6
  30. package/guidelines/ssrRule/ssrRule.instruction.md +3 -0
  31. package/guidelines/transportRule/transportRule.instruction.md +4 -0
  32. package/incrementalBuilder.proc.js +8 -8
  33. package/{index-3mj5trqc.js → index-0bzrcv91.js} +1 -1
  34. package/{index-q63nbpv7.js → index-0zkxsdsg.js} +3 -3
  35. package/{index-wxqp1amd.js → index-1c52g4st.js} +11 -9
  36. package/{index-vnk1qwgr.js → index-22h6vq3f.js} +4 -4
  37. package/index-35p43f33.js +16 -0
  38. package/{index-fagjtk6m.js → index-3q7ectss.js} +2 -2
  39. package/{index-se7n78fh.js → index-54g085ty.js} +1 -1
  40. package/{index-rt7q20sj.js → index-5sa1tr7w.js} +1 -1
  41. package/{index-h8w1n11r.js → index-6a3rmwxx.js} +4 -4
  42. package/{index-yey1envc.js → index-741xbhes.js} +1 -1
  43. package/{index-9a9t77hz.js → index-77627y32.js} +2 -2
  44. package/{index-4r8dgm4x.js → index-8javbznc.js} +3 -3
  45. package/{index-hxg6ctk2.js → index-a2a3nh57.js} +3 -3
  46. package/{index-j2wq064m.js → index-aezpcphy.js} +121 -15
  47. package/{index-3r1crbct.js → index-ay4vkwr8.js} +1 -1
  48. package/{index-t23dgyaf.js → index-b4m7bjbx.js} +7 -7
  49. package/{index-rdcgz02t.js → index-bma8tmgb.js} +4 -4
  50. package/{index-3zkhg65e.js → index-c4g8egm2.js} +40 -13
  51. package/{index-9gjcbp2g.js → index-c8kj74zz.js} +1 -1
  52. package/{index-fjqapyex.js → index-es2wkn41.js} +40 -5
  53. package/{index-pyjkbg8e.js → index-extg77rx.js} +2 -2
  54. package/{index-nmdmkjt2.js → index-fey1dd49.js} +4 -4
  55. package/{index-c669pbyb.js → index-fjzeak0t.js} +68 -37
  56. package/{index-f4jydw2x.js → index-gdgbgn82.js} +1 -1
  57. package/{index-4yvtqcme.js → index-gyyscjzx.js} +16 -4
  58. package/{index-qecrqpt6.js → index-hxcefw29.js} +1 -1
  59. package/{index-a4gcdffy.js → index-k380ww64.js} +3 -3
  60. package/index-kqxs1d7z.js +377 -0
  61. package/{index-nnmw56fz.js → index-mv3ke0fc.js} +5 -5
  62. package/{index-m303nhv6.js → index-mvdmb73w.js} +6 -6
  63. package/{index-cbm9gzgx.js → index-pa53zktp.js} +5 -5
  64. package/{index-3a3vy2xy.js → index-psvxwemh.js} +8 -8
  65. package/{index-ckcc9ab3.js → index-r24mj2pw.js} +8 -8
  66. package/{index-8bta5pnr.js → index-serpfvat.js} +2 -2
  67. package/{index-kbnvyhy4.js → index-shjjjdte.js} +3 -3
  68. package/{index-pr9nypg7.js → index-sjmk7wp7.js} +2 -2
  69. package/{index-wkwe91sn.js → index-th7qbjfz.js} +11 -11
  70. package/{index-5ahe641t.js → index-vgd07z61.js} +8 -8
  71. package/{index-crd99zqs.js → index-wzvvqkcy.js} +1 -1
  72. package/{index-v16gj2as.js → index-ys1sjp6m.js} +90 -51
  73. package/{index-22bwg8hy.js → index-zc43cyg8.js} +1 -1
  74. package/index.js +27 -27
  75. package/{libExecutor-n8hpm8s7.js → libExecutor-mqxnn0h6.js} +2 -2
  76. package/{library.command-8abb26pg.js → library.command-4kefxh8z.js} +7 -7
  77. package/{localRegistry.command-sa211m1z.js → localRegistry.command-phgrhkks.js} +18 -17
  78. package/{module.command-z3cwjf0p.js → module.command-8476gwze.js} +9 -9
  79. package/{package.command-akynhtee.js → package.command-ygxm5pp9.js} +8 -8
  80. package/package.json +2 -2
  81. package/{page.command-3fpdavk9.js → page.command-f7fwkj8y.js} +7 -7
  82. package/{pipeline.command-ca95n8rd.js → pipeline.command-9htjbrdm.js} +6 -6
  83. package/{pkgExecutor-a73q41vx.js → pkgExecutor-6a91xng5.js} +2 -2
  84. package/{primitive.command-xwe9ggnf.js → primitive.command-0k0h0cm0.js} +10 -10
  85. package/{projectTypecheck-7g542ymk.js → projectTypecheck-7kakbacs.js} +1 -1
  86. package/{quality.command-7wz7y8z1.js → quality.command-frsfdfc5.js} +9 -8
  87. package/{repair.command-dej1qtfq.js → repair.command-yag3bpq2.js} +9 -9
  88. package/{scalar.command-z9qfxnvm.js → scalar.command-qtyrywvt.js} +8 -8
  89. package/skills/akan-err/SKILL.md +11 -2
  90. package/skills/akan-page/SKILL.md +4 -14
  91. package/skills/akan-runtime/SKILL.md +20 -0
  92. package/{subspace.command-9wekm4gn.js → subspace.command-kr53abzt.js} +10 -10
  93. package/{tunnel.command-cxc4h3j8.js → tunnel.command-pswe6nye.js} +9 -9
  94. package/{typeChecker-7jt6abrs.js → typeChecker-epg7ebfy.js} +2 -1
  95. package/typecheck.proc.js +2 -1
  96. package/{verify.command-j0w9dr5c.js → verify.command-ghhhzgrw.js} +15 -14
  97. package/{workflow.command-yt4sz04b.js → workflow.command-fpwqth4w.js} +14 -14
  98. package/{workspace.command-8mp4mcp2.js → workspace.command-6bbmtn3w.js} +33 -31
  99. package/TunnelShare-0p4dy89e.js +0 -16
  100. package/cloud.script-0dsyd10v.js +0 -30
  101. package/context.runner-yyp7a112.js +0 -32
@@ -3,18 +3,18 @@ import {
3
3
  Pkg,
4
4
  Workspace,
5
5
  command
6
- } from "./index-nnmw56fz.js";
6
+ } from "./index-mv3ke0fc.js";
7
7
  import"./index-j4yvgfhr.js";
8
- import"./index-v16gj2as.js";
8
+ import"./index-ys1sjp6m.js";
9
9
  import"./index-zyjztrvc.js";
10
- import"./index-9a9t77hz.js";
11
- import"./index-yey1envc.js";
12
- import"./index-crd99zqs.js";
13
- import"./index-se7n78fh.js";
10
+ import"./index-77627y32.js";
11
+ import"./index-741xbhes.js";
12
+ import"./index-wzvvqkcy.js";
13
+ import"./index-54g085ty.js";
14
14
  import {
15
15
  PackageScript
16
- } from "./index-hxg6ctk2.js";
17
- import"./index-3r1crbct.js";
16
+ } from "./index-a2a3nh57.js";
17
+ import"./index-ay4vkwr8.js";
18
18
 
19
19
  // pkgs/@akanjs/cli/package/package.command.ts
20
20
  class PackageCommand extends command("package", [PackageScript], ({ public: target }) => ({
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@akanjs/cli",
3
- "version": "3.3.0-rc.11",
3
+ "version": "3.3.0-rc.13",
4
4
  "sourceType": "module",
5
5
  "type": "module",
6
6
  "publishConfig": {
@@ -40,7 +40,7 @@
40
40
  "@earendil-works/pi-tui": "1.5.2",
41
41
  "@inquirer/prompts": "^8.7.3",
42
42
  "@tailwindcss/node": "^4.3.3",
43
- "akanjs": "3.3.0-rc.11",
43
+ "akanjs": "3.3.0-rc.13",
44
44
  "chalk": "^6.0.1",
45
45
  "commander": "^15.0.0",
46
46
  "dayjs": "^1.11.23",
@@ -3,17 +3,17 @@ import {
3
3
  App,
4
4
  Module,
5
5
  command
6
- } from "./index-nnmw56fz.js";
6
+ } from "./index-mv3ke0fc.js";
7
7
  import"./index-j4yvgfhr.js";
8
- import"./index-v16gj2as.js";
8
+ import"./index-ys1sjp6m.js";
9
9
  import"./index-zyjztrvc.js";
10
- import"./index-9a9t77hz.js";
11
- import"./index-yey1envc.js";
12
- import"./index-crd99zqs.js";
10
+ import"./index-77627y32.js";
11
+ import"./index-741xbhes.js";
12
+ import"./index-wzvvqkcy.js";
13
13
  import {
14
14
  PageScript
15
- } from "./index-9gjcbp2g.js";
16
- import"./index-3r1crbct.js";
15
+ } from "./index-c8kj74zz.js";
16
+ import"./index-ay4vkwr8.js";
17
17
 
18
18
  // pkgs/@akanjs/cli/page/page.command.ts
19
19
  class PageCommand extends command("page", [PageScript], ({ public: target }) => ({
@@ -4,24 +4,24 @@ import {
4
4
  runner,
5
5
  script,
6
6
  command
7
- } from "./index-nnmw56fz.js";
7
+ } from "./index-mv3ke0fc.js";
8
8
  import"./index-j4yvgfhr.js";
9
9
  import {
10
10
  AkanAppConfig,
11
11
  AkanWorkspaceConfig
12
- } from "./index-v16gj2as.js";
12
+ } from "./index-ys1sjp6m.js";
13
13
  import {
14
14
  FileSys2
15
15
  } from "./index-zyjztrvc.js";
16
16
  import {
17
17
  AppExecutor2
18
- } from "./index-9a9t77hz.js";
19
- import"./index-yey1envc.js";
20
- import"./index-crd99zqs.js";
18
+ } from "./index-77627y32.js";
19
+ import"./index-741xbhes.js";
20
+ import"./index-wzvvqkcy.js";
21
21
  import {
22
22
  resolveMobileTargets
23
23
  } from "./index-m9jj544v.js";
24
- import"./index-3r1crbct.js";
24
+ import"./index-ay4vkwr8.js";
25
25
 
26
26
  // pkgs/@akanjs/cli/pipeline/pipeline.command.ts
27
27
  import { pipelineTriggers as pipelineTriggers2 } from "akanjs/common";
@@ -1,8 +1,8 @@
1
1
  // @bun
2
2
  import {
3
3
  PkgExecutor2
4
- } from "./index-crd99zqs.js";
5
- import"./index-v16gj2as.js";
4
+ } from "./index-wzvvqkcy.js";
5
+ import"./index-ys1sjp6m.js";
6
6
  import"./index-j4yvgfhr.js";
7
7
  import"./index-zyjztrvc.js";
8
8
  export {
@@ -2,23 +2,23 @@
2
2
  import {
3
3
  Workspace,
4
4
  command
5
- } from "./index-nnmw56fz.js";
5
+ } from "./index-mv3ke0fc.js";
6
6
  import"./index-j4yvgfhr.js";
7
- import"./index-v16gj2as.js";
7
+ import"./index-ys1sjp6m.js";
8
8
  import"./index-zyjztrvc.js";
9
- import"./index-9a9t77hz.js";
10
- import"./index-yey1envc.js";
11
- import"./index-crd99zqs.js";
9
+ import"./index-77627y32.js";
10
+ import"./index-741xbhes.js";
11
+ import"./index-wzvvqkcy.js";
12
12
  import {
13
13
  renderPrimitiveReport
14
- } from "./index-q63nbpv7.js";
14
+ } from "./index-0zkxsdsg.js";
15
15
  import"./index-trffs83s.js";
16
- import"./index-9gjcbp2g.js";
17
- import"./index-rdcgz02t.js";
16
+ import"./index-c8kj74zz.js";
17
+ import"./index-bma8tmgb.js";
18
18
  import {
19
19
  PrimitiveScript
20
- } from "./index-m303nhv6.js";
21
- import"./index-3r1crbct.js";
20
+ } from "./index-mvdmb73w.js";
21
+ import"./index-ay4vkwr8.js";
22
22
 
23
23
  // pkgs/@akanjs/cli/primitive/primitive.command.ts
24
24
  import { Logger } from "akanjs/common";
@@ -1,7 +1,7 @@
1
1
  // @bun
2
2
  import {
3
3
  ProjectTypecheck2
4
- } from "./index-v16gj2as.js";
4
+ } from "./index-ys1sjp6m.js";
5
5
  import"./index-j4yvgfhr.js";
6
6
  export {
7
7
  ProjectTypecheck2 as ProjectTypecheck
@@ -3,35 +3,36 @@ import {
3
3
  Workspace,
4
4
  script,
5
5
  command
6
- } from "./index-nnmw56fz.js";
6
+ } from "./index-mv3ke0fc.js";
7
7
  import"./index-j4yvgfhr.js";
8
- import"./index-v16gj2as.js";
8
+ import"./index-ys1sjp6m.js";
9
9
  import"./index-zyjztrvc.js";
10
10
  import {
11
11
  AppExecutor2
12
- } from "./index-9a9t77hz.js";
12
+ } from "./index-77627y32.js";
13
13
  import {
14
14
  LibExecutor2
15
- } from "./index-yey1envc.js";
15
+ } from "./index-741xbhes.js";
16
16
  import {
17
17
  PkgExecutor2
18
- } from "./index-crd99zqs.js";
18
+ } from "./index-wzvvqkcy.js";
19
19
  import {
20
20
  MaintainabilityBaseline
21
- } from "./index-se7n78fh.js";
21
+ } from "./index-54g085ty.js";
22
22
  import {
23
23
  WorkspaceRunner,
24
24
  AkanQualityScanner,
25
25
  formatQualityScanResult,
26
26
  formatSsrScanResult
27
- } from "./index-j2wq064m.js";
27
+ } from "./index-aezpcphy.js";
28
28
  import"./index-trffs83s.js";
29
29
  import"./index-1p81ecbz.js";
30
30
  import"./index-62md4dwy.js";
31
+ import"./index-35p43f33.js";
31
32
  import"./index-zyb0ebm4.js";
32
33
  import"./index-jf4vk1s0.js";
33
34
  import"./index-t4d0ckde.js";
34
- import"./index-3r1crbct.js";
35
+ import"./index-ay4vkwr8.js";
35
36
 
36
37
  // pkgs/@akanjs/cli/quality/quality.script.ts
37
38
  import { Logger } from "akanjs/common";
@@ -3,21 +3,21 @@ import {
3
3
  Workspace,
4
4
  script,
5
5
  command
6
- } from "./index-nnmw56fz.js";
6
+ } from "./index-mv3ke0fc.js";
7
7
  import"./index-j4yvgfhr.js";
8
- import"./index-v16gj2as.js";
8
+ import"./index-ys1sjp6m.js";
9
9
  import"./index-zyjztrvc.js";
10
- import"./index-9a9t77hz.js";
11
- import"./index-yey1envc.js";
12
- import"./index-crd99zqs.js";
13
- import"./index-q63nbpv7.js";
10
+ import"./index-77627y32.js";
11
+ import"./index-741xbhes.js";
12
+ import"./index-wzvvqkcy.js";
13
+ import"./index-0zkxsdsg.js";
14
14
  import"./index-trffs83s.js";
15
- import"./index-h8w1n11r.js";
15
+ import"./index-6a3rmwxx.js";
16
16
  import"./index-1p81ecbz.js";
17
17
  import {
18
18
  RepairRunner
19
- } from "./index-kbnvyhy4.js";
20
- import"./index-3r1crbct.js";
19
+ } from "./index-shjjjdte.js";
20
+ import"./index-ay4vkwr8.js";
21
21
 
22
22
  // pkgs/@akanjs/cli/repair/repair.script.ts
23
23
  import { Logger } from "akanjs/common";
@@ -2,21 +2,21 @@
2
2
  import {
3
3
  Sys,
4
4
  command
5
- } from "./index-nnmw56fz.js";
5
+ } from "./index-mv3ke0fc.js";
6
6
  import"./index-j4yvgfhr.js";
7
- import"./index-v16gj2as.js";
7
+ import"./index-ys1sjp6m.js";
8
8
  import"./index-zyjztrvc.js";
9
- import"./index-9a9t77hz.js";
10
- import"./index-yey1envc.js";
11
- import"./index-crd99zqs.js";
9
+ import"./index-77627y32.js";
10
+ import"./index-741xbhes.js";
11
+ import"./index-wzvvqkcy.js";
12
12
  import {
13
13
  renderPrimitiveReport
14
- } from "./index-q63nbpv7.js";
14
+ } from "./index-0zkxsdsg.js";
15
15
  import"./index-trffs83s.js";
16
16
  import {
17
17
  ScalarScript
18
- } from "./index-fagjtk6m.js";
19
- import"./index-3r1crbct.js";
18
+ } from "./index-3q7ectss.js";
19
+ import"./index-ay4vkwr8.js";
20
20
 
21
21
  // pkgs/@akanjs/cli/scalar/scalar.command.ts
22
22
  import { Logger, lowerlize } from "akanjs/common";
@@ -30,10 +30,19 @@ import path at all**, so keep throwing code out of them entirely rather than rea
30
30
 
31
31
  Best-effort code returns a sentinel (`null`, `undefined`, `{}`) instead of throwing. `try/catch` is rare and
32
32
  always converts an exception into a decision: a guard catches, warns, and returns `false`; an adapter
33
- catches, logs, and returns `null`. A store action never catches — let the framework toast the `Err`, or list it in
34
- the store's `static silent` when no screen waits on it and its caller handles the rejection.
33
+ catches, logs (`logger.error`), and returns `null`; a UI `try/finally` resets a spinner. A store action never
34
+ catches — let the framework toast the `Err`, or list it in the store's `static silent` when no screen waits on it
35
+ and its caller handles the rejection.
35
36
  Client-side validation failure is `msg.error("<key>")` plus an early return, never a throw.
36
37
 
38
+ An `srvkit/` adapter belongs to no module: its keys go in the app's or lib's own service dictionary,
39
+ `lib/_<name>/<name>.dictionary.ts`, thrown as `new Err("<name>.error.<key>")` with `Err` from `"../lib/dict"`.
40
+
41
+ **An endpoint names the errors it throws on purpose** — `errors: { 409: ["ticket.error.locked"] }` in its signal
42
+ option, with keys its dictionary defines and never `base.error.*`. That is the status's OpenAPI response and a line
43
+ of the MCP tool's description; outside production a thrown key it leaves out warns once. A caller narrows with
44
+ `Err.is(error, "ticket.error.locked")`.
45
+
37
46
  **A failure another process reported travels as itself.** A server-to-server `fetch.<endpoint>(…, { origin })`
38
47
  restores the remote `Err` with its class, key and data. Rethrow it as-is — wrapping it in a `new Error`
39
48
  discards what the endpoint chose to say, and a bare `Error` is generalized to "Internal Server Error" on the
@@ -33,19 +33,13 @@ export default page()
33
33
  dropped. `lang` reaches every stage and is never declared.
34
34
  3. Gate with `.guard(() => signedIn())` on the `_layout.tsx`, and repeat a stricter guard on a page that needs more.
35
35
  `.guard((_, { path }) => signedIn({ path }))` sends a refused visitor to `/signin?redirect=<path>`.
36
- 4. In `.render()`: `usePage()`, then fetch, then return. Hand `fetch.init*` / `view*` / `edit*` fields to sections
37
- unawaited; await only what the shell reads, in one `Promise.all`.
38
- 5. `.head()` takes JSX (or a function returning it), never a metadata object.
39
- 6. Re-skin an `akanjs/ui` component for a subtree with `_overrides.tsx`:
36
+ 4. In `.render()`: `usePage()`, then fetch, then return.
37
+ 5. Re-skin an `akanjs/ui` component for a subtree with `_overrides.tsx`:
40
38
  `export default override({ Slot: AppComponent })`, no logic. Nested ones merge slot by slot, the closest winning;
41
39
  `componentRule` lists the slots.
42
40
 
43
41
  ## API at a glance
44
42
 
45
- `page`, `layout` and `router` come from `akanjs/client`, `Link` from `akanjs/ui`, `usePageLocation` from
46
- `akanjs/webkit`, and `fetch`, `usePage` and the model namespaces from `@apps/<app>/client`. A stage receives the
47
- declared params and search keys plus `lang`.
48
-
49
43
  - Data-driven title: `.head(async ({ id }) => <title>{((await fetch.book(id)) as Book | null)?.title}</title>)`,
50
44
  where `Book` is the `common/` interface for the query's `Any` return (`akan-service`).
51
45
  - Async page: `.render(async ({ id }) => { const book = (await fetch.book(id)) as Book | null; if (!book) return router.notFound(); … })`;
@@ -65,12 +59,8 @@ declared params and search keys plus `lang`.
65
59
  scrollToTop: false })`` in a `"use client"` component, read back with `usePageLocation().searchParams`. Shallow
66
60
  holds only while the path stays the same; a server `.search()` sees the value at the next full navigation.
67
61
 
68
- ## Never
69
-
70
- - A `fetch.<mutation>()` while rendering — it throws `base.error.mutationInRender`, because opening a link would
71
- perform it. Send writes from a user action.
72
- - `useState`, `useEffect`, comments, a named export beside the chain, or the legacy `export default async function`.
73
- - Editing a lib page through its link in `page/(libs)/` — edit the lib's own `page/` source.
62
+ What a route file must never do — write while rendering, hooks, a second export — is the `page` rule, loaded with
63
+ any `page/` file.
74
64
 
75
65
  Full detail: `get_guideline` with `pageRule` (guards in depth, heads, MCP apps, CSR root layouts, lib pages), or
76
66
  `ssrRule` for what may render on the server. Every stage's signature, the router's methods, Link's props and every
@@ -18,6 +18,7 @@ the agent guide's Path Rules table.
18
18
  | The production image | `docker: string \| { image, preRuns, postRuns, command }` |
19
19
  | iOS, Android, desktop | the `native` section; `desktop: { server: true }` carries the server |
20
20
  | SQLite, several databases, a cluster | `database: { modes: [...] }` (`single`, `multiple`, `cluster`), picked by `AKAN_DATABASE_MODE` |
21
+ | A secret of `env/env.server.<env>.ts` in a deployed server | nothing to declare: `akan build` leaves it out and the server reads it from a variable named after its key path; `akan secret-env <app> --env <env>` lists them |
21
22
  | URLs without `/<locale>/`: one language, or paths fixed from outside (OAuth callback, QR code, mail link) | `i18n: { localePrefix: "as-needed" }` — the default locale's pages and `<Link>` hrefs drop the prefix, other locales keep it |
22
23
 
23
24
  ## Running and logs
@@ -28,6 +29,25 @@ the agent guide's Path Rules table.
28
29
  - Run a build without Docker with `cd dist/apps/<app> && bun main.js`: it boots with the env the Dockerfile sets,
29
30
  read from `akan.env.json` beside it, and a variable you set yourself (`PORT=3000`) wins.
30
31
 
32
+ ## Secrets in a deployed server
33
+
34
+ - Write secrets in `env/env.server.<env>.ts` as before. `akan build` replaces each string under a secret-named key,
35
+ and each URL carrying a password, with a read of an environment variable: `security.sso.google.clientSecret` is
36
+ `SECURITY__SSO__GOOGLE__CLIENT_SECRET`, an array holding a secret is one JSON variable, `security.jwtSecret` is
37
+ `JWT_SECRET`. The built files hold the names (`AKAN_ENV_NAMES` in `akan.env.json`), never the values.
38
+ - `akan secret-env <app> --env <env>` prints the variables, never a value. `--out <file> --format k8s --name <name>`
39
+ writes a Kubernetes Secret for `envFrom`, `--format dotenv` a file for `bun --env-file`. Never write it
40
+ under `dist/` or a tracked path, and delete it once applied.
41
+ - At boot a variable left unset is one warning naming it. The framework does not stop for it, though whatever reads the value may; 3.5.0 will refuse to boot.
42
+ - A secret the env file computes or imports stops the build, whatever its length: write the string at the key, or
43
+ `process.env.<NAME>` there, which the build leaves as that read. A secret string a plain key or the app's code
44
+ holds as well stops it too when long and mixed, and is a warning when short. A key the name rule misses
45
+ (`stripeKey`) stays in the image unless read from `process.env`.
46
+ - The build loads the env file to list the secrets, with the shell's variables only when it cannot load without
47
+ them; a file that throws as it loads stops the build by error class and line.
48
+ - `akan start`, `akan test`, `akan build --profile …` and desktop and mobile builds read the env file as written.
49
+ `akan build --inline-secrets` keeps the values in the image for one release, for a deployment not ready yet.
50
+
31
51
  ## Native and desktop
32
52
 
33
53
  A `start-*` command loads its pages from a running `akan start`; a desktop app carrying its server starts it itself.
@@ -5,33 +5,33 @@ import {
5
5
  runner,
6
6
  script,
7
7
  command
8
- } from "./index-nnmw56fz.js";
8
+ } from "./index-mv3ke0fc.js";
9
9
  import"./index-j4yvgfhr.js";
10
10
  import {
11
11
  Executor,
12
12
  LibSource,
13
13
  WorkspaceExecutor
14
- } from "./index-v16gj2as.js";
14
+ } from "./index-ys1sjp6m.js";
15
15
  import {
16
16
  FileSys2
17
17
  } from "./index-zyjztrvc.js";
18
18
  import {
19
19
  AppExecutor2
20
- } from "./index-9a9t77hz.js";
21
- import"./index-yey1envc.js";
22
- import"./index-crd99zqs.js";
20
+ } from "./index-77627y32.js";
21
+ import"./index-741xbhes.js";
22
+ import"./index-wzvvqkcy.js";
23
23
  import {
24
24
  GlobalConfig
25
- } from "./index-pyjkbg8e.js";
25
+ } from "./index-extg77rx.js";
26
26
  import"./index-m9jj544v.js";
27
- import"./index-fjqapyex.js";
27
+ import"./index-es2wkn41.js";
28
28
  import {
29
29
  SubspaceConfig
30
30
  } from "./index-xczjdng6.js";
31
31
  import {
32
32
  SlicePlanner
33
- } from "./index-rt7q20sj.js";
34
- import"./index-3r1crbct.js";
33
+ } from "./index-5sa1tr7w.js";
34
+ import"./index-ay4vkwr8.js";
35
35
 
36
36
  // pkgs/@akanjs/devkit/subspace/subspace.ts
37
37
  import { mkdir as mkdir2 } from "fs/promises";
@@ -822,7 +822,7 @@ class SubspaceRunner extends runner("subspace") {
822
822
  if (!asked)
823
823
  return { name: subspace.name, workspaceId, host, apps, libs: [], outcome: "cancelled", files: [] };
824
824
  const { libs } = await subspace.slice();
825
- const { CloudScript } = await import("./cloud.script-0dsyd10v.js");
825
+ const { CloudScript } = await import("./cloud.script-34xmprty.js");
826
826
  const { files } = await CommandContainer.get(CloudScript).uploadEnv(workspace, {
827
827
  host,
828
828
  workspaceId,
@@ -4,28 +4,28 @@ import {
4
4
  runner,
5
5
  script,
6
6
  command
7
- } from "./index-nnmw56fz.js";
7
+ } from "./index-mv3ke0fc.js";
8
8
  import"./index-j4yvgfhr.js";
9
- import"./index-v16gj2as.js";
9
+ import"./index-ys1sjp6m.js";
10
10
  import"./index-zyjztrvc.js";
11
11
  import {
12
12
  AppExecutor2
13
- } from "./index-9a9t77hz.js";
14
- import"./index-yey1envc.js";
15
- import"./index-crd99zqs.js";
13
+ } from "./index-77627y32.js";
14
+ import"./index-741xbhes.js";
15
+ import"./index-wzvvqkcy.js";
16
16
  import {
17
17
  GlobalConfig,
18
18
  CloudApi
19
- } from "./index-pyjkbg8e.js";
19
+ } from "./index-extg77rx.js";
20
20
  import"./index-m9jj544v.js";
21
- import"./index-fjqapyex.js";
21
+ import"./index-es2wkn41.js";
22
22
  import {
23
23
  TunnelShare2
24
- } from "./index-qecrqpt6.js";
24
+ } from "./index-hxcefw29.js";
25
25
  import {
26
26
  writeClipboard
27
27
  } from "./index-p6pbz9n5.js";
28
- import"./index-3r1crbct.js";
28
+ import"./index-ay4vkwr8.js";
29
29
 
30
30
  // pkgs/@akanjs/cli/tunnel/tunnel.script.ts
31
31
  import { select } from "@inquirer/prompts";
@@ -1,7 +1,8 @@
1
1
  // @bun
2
2
  import {
3
3
  TypeChecker2
4
- } from "./index-c669pbyb.js";
4
+ } from "./index-fjzeak0t.js";
5
+ import"./index-35p43f33.js";
5
6
  export {
6
7
  TypeChecker2 as TypeChecker
7
8
  };
package/typecheck.proc.js CHANGED
@@ -1,7 +1,8 @@
1
1
  // @bun
2
+ import"./index-35p43f33.js";
2
3
  import {
3
4
  TypeChecker2
4
- } from "./index-c669pbyb.js";
5
+ } from "./index-fjzeak0t.js";
5
6
  import {
6
7
  TypecheckFailure
7
8
  } from "./index-j4yvgfhr.js";
@@ -4,39 +4,40 @@ import {
4
4
  script,
5
5
  markCliErrorPrinted,
6
6
  command
7
- } from "./index-nnmw56fz.js";
7
+ } from "./index-mv3ke0fc.js";
8
8
  import {
9
9
  CliError
10
10
  } from "./index-j4yvgfhr.js";
11
- import"./index-v16gj2as.js";
11
+ import"./index-ys1sjp6m.js";
12
12
  import"./index-zyjztrvc.js";
13
- import"./index-9a9t77hz.js";
14
- import"./index-yey1envc.js";
15
- import"./index-crd99zqs.js";
13
+ import"./index-77627y32.js";
14
+ import"./index-741xbhes.js";
15
+ import"./index-wzvvqkcy.js";
16
16
  import {
17
17
  ApplicationRunner,
18
18
  VerifyScope
19
- } from "./index-wkwe91sn.js";
20
- import"./index-8bta5pnr.js";
21
- import"./index-fjqapyex.js";
22
- import"./index-f4jydw2x.js";
19
+ } from "./index-th7qbjfz.js";
20
+ import"./index-serpfvat.js";
21
+ import"./index-es2wkn41.js";
22
+ import"./index-gdgbgn82.js";
23
23
  import"./index-m9jj544v.js";
24
24
  import"./index-1p81ecbz.js";
25
25
  import"./index-62md4dwy.js";
26
+ import"./index-35p43f33.js";
26
27
  import"./index-zyb0ebm4.js";
27
28
  import {
28
29
  WorkspaceRunner
29
- } from "./index-j2wq064m.js";
30
- import"./index-se7n78fh.js";
30
+ } from "./index-aezpcphy.js";
31
+ import"./index-54g085ty.js";
31
32
  import"./index-trffs83s.js";
32
33
  import"./index-jf4vk1s0.js";
33
34
  import"./index-t4d0ckde.js";
34
35
  import {
35
36
  VerifyPipeline,
36
37
  VerifyReport
37
- } from "./index-wxqp1amd.js";
38
- import"./index-rt7q20sj.js";
39
- import"./index-3r1crbct.js";
38
+ } from "./index-1c52g4st.js";
39
+ import"./index-5sa1tr7w.js";
40
+ import"./index-ay4vkwr8.js";
40
41
 
41
42
  // pkgs/@akanjs/cli/verify/verify.script.ts
42
43
  import path from "path";
@@ -3,33 +3,33 @@ import {
3
3
  Workspace,
4
4
  script,
5
5
  command
6
- } from "./index-nnmw56fz.js";
6
+ } from "./index-mv3ke0fc.js";
7
7
  import"./index-j4yvgfhr.js";
8
- import"./index-v16gj2as.js";
8
+ import"./index-ys1sjp6m.js";
9
9
  import"./index-zyjztrvc.js";
10
- import"./index-9a9t77hz.js";
11
- import"./index-yey1envc.js";
12
- import"./index-crd99zqs.js";
10
+ import"./index-77627y32.js";
11
+ import"./index-741xbhes.js";
12
+ import"./index-wzvvqkcy.js";
13
13
  import {
14
14
  jsonText,
15
15
  workflowStatus,
16
16
  renderWorkflowPlan,
17
17
  renderWorkflowApply,
18
18
  renderWorkflowValidation
19
- } from "./index-q63nbpv7.js";
19
+ } from "./index-0zkxsdsg.js";
20
20
  import"./index-trffs83s.js";
21
- import"./index-h8w1n11r.js";
21
+ import"./index-6a3rmwxx.js";
22
22
  import"./index-1p81ecbz.js";
23
- import"./index-9gjcbp2g.js";
24
- import"./index-rdcgz02t.js";
25
- import"./index-m303nhv6.js";
26
- import"./index-kbnvyhy4.js";
27
- import"./index-fagjtk6m.js";
23
+ import"./index-c8kj74zz.js";
24
+ import"./index-bma8tmgb.js";
25
+ import"./index-mvdmb73w.js";
26
+ import"./index-shjjjdte.js";
27
+ import"./index-3q7ectss.js";
28
28
  import"./index-t4d0ckde.js";
29
29
  import {
30
30
  WorkflowRunner
31
- } from "./index-3a3vy2xy.js";
32
- import"./index-3r1crbct.js";
31
+ } from "./index-psvxwemh.js";
32
+ import"./index-ay4vkwr8.js";
33
33
 
34
34
  // pkgs/@akanjs/cli/workflow/workflow.script.ts
35
35
  import { Logger } from "akanjs/common";