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

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 (115) hide show
  1. package/.build-stamp +2 -2
  2. package/CodeAgent-cqbf9gsv.js +11 -0
  3. package/{CodeAgentRpcHost-6dzfkvsc.js → CodeAgentRpcHost-pwps2d67.js} +1 -1
  4. package/{CodeTui-zee8atsr.js → CodeTui-ehdr4hgw.js} +46 -6
  5. package/TunnelShare-0p4dy89e.js +16 -0
  6. package/{agent.command-x65f2ags.js → agent.command-x55ncdjm.js} +20 -22
  7. package/akanCode.js +7 -7
  8. package/appExecutor-1ctzymwa.js +11 -0
  9. package/{application.command-azbd1pb2.js → application.command-xpntxnh8.js} +18 -20
  10. package/{applicationBuildRunner-trfxv3pd.js → applicationBuildRunner-19c76791.js} +16 -13
  11. package/buildBatch.proc.js +19 -19
  12. package/{cloud.command-gapp4634.js → cloud.command-p3ybjes7.js} +19 -24
  13. package/cloud.script-0dsyd10v.js +30 -0
  14. package/{code.command-5smx61yf.js → code.command-m6skj1kj.js} +34 -19
  15. package/{context.command-ym5jbkny.js → context.command-3c3nv0d6.js} +20 -22
  16. package/context.runner-yyp7a112.js +32 -0
  17. package/csrArtifactBuilder-mdh9ykn2.js +9 -0
  18. package/{index-2ny1e95c.js → dependencyScanner-93g8tk0r.js} +6 -5
  19. package/{fileSys-q22646yc.js → fileSys-e5mwt73x.js} +1 -1
  20. package/frameworkGraph-aneq2nwy.js +8 -0
  21. package/{guideline.command-zwypaqsh.js → guideline.command-725fq5p0.js} +8 -8
  22. package/guidelines/agentRule/agentRule.instruction.md +46 -7
  23. package/guidelines/akanApi/akanApi.instruction.md +7 -2
  24. package/guidelines/conventions/core.md +6 -11
  25. package/guidelines/conventions/rules/app.md +1 -2
  26. package/guidelines/conventions/rules/auth.md +18 -27
  27. package/guidelines/conventions/rules/config.md +15 -46
  28. package/guidelines/conventions/rules/page.md +19 -34
  29. package/guidelines/conventions/rules/server.md +1 -4
  30. package/guidelines/conventions/rules/ssr.md +3 -4
  31. package/guidelines/conventions/rules/ts.md +2 -1
  32. package/guidelines/cssRule/cssRule.instruction.md +3 -0
  33. package/guidelines/errorCodes/errorCodes.instruction.md +4 -0
  34. package/guidelines/mcpRule/mcpRule.instruction.md +11 -4
  35. package/guidelines/pageRule/pageRule.instruction.md +6 -53
  36. package/guidelines/runtimeRule/runtimeRule.instruction.md +68 -4
  37. package/incrementalBuilder.proc.js +24 -18
  38. package/{index-nc3br31y.js → index-22bwg8hy.js} +2 -2
  39. package/{index-9f3reh2y.js → index-2v38x3ad.js} +12 -1
  40. package/{index-67sd09ag.js → index-3a3vy2xy.js} +8 -8
  41. package/{index-p7beqww9.js → index-3fmzz9sf.js} +18 -18
  42. package/{index-9wh04mqy.js → index-3mj5trqc.js} +65 -11
  43. package/{index-7wf8snar.js → index-3r1crbct.js} +1 -1
  44. package/{index-41a03gkj.js → index-3zkhg65e.js} +19 -19
  45. package/{index-2jmvfa62.js → index-4r8dgm4x.js} +3 -3
  46. package/{index-jek2re5k.js → index-4yvtqcme.js} +8 -8
  47. package/{index-j0wr4e32.js → index-5ahe641t.js} +9 -9
  48. package/{index-0dm25wvf.js → index-7ssr7wq4.js} +1 -1
  49. package/{index-dmcpetwe.js → index-8bta5pnr.js} +98 -23
  50. package/{index-z92zm3wd.js → index-9a9t77hz.js} +29 -11
  51. package/{index-3txdtztz.js → index-9gjcbp2g.js} +1 -1
  52. package/{index-8jtqfye2.js → index-a4gcdffy.js} +488 -53
  53. package/{index-xwwex8rf.js → index-cbm9gzgx.js} +5 -5
  54. package/{index-j6jjmn2r.js → index-ckcc9ab3.js} +62 -21
  55. package/{index-w1zexzpx.js → index-crd99zqs.js} +1 -1
  56. package/{index-612fdtbk.js → index-f4jydw2x.js} +1 -1
  57. package/{index-4ss4gkv3.js → index-fagjtk6m.js} +2 -2
  58. package/{index-ebn9kgea.js → index-fjqapyex.js} +45 -16
  59. package/{index-h901f24n.js → index-h8w1n11r.js} +5 -5
  60. package/{index-275a4r3n.js → index-hxg6ctk2.js} +12 -16
  61. package/{index-78y75t0a.js → index-j2wq064m.js} +6 -7
  62. package/{index-knpm8sdm.js → index-j3fqs8rc.js} +1 -1
  63. package/{index-kfvjzk8r.js → index-kbnvyhy4.js} +3 -3
  64. package/{index-6dzjer7p.js → index-m303nhv6.js} +6 -6
  65. package/{index-dadwp2aw.js → index-nmdmkjt2.js} +271 -39
  66. package/{index-2yn3r67f.js → index-nnmw56fz.js} +6 -6
  67. package/{index-a860mx0m.js → index-pr9nypg7.js} +24 -24
  68. package/{index-s885g0jj.js → index-pyjkbg8e.js} +3 -3
  69. package/{index-zmd9xxgd.js → index-q63nbpv7.js} +3 -3
  70. package/{index-v7ajmsh3.js → index-qecrqpt6.js} +4 -21
  71. package/{index-gt8phqpt.js → index-rdcgz02t.js} +4 -4
  72. package/{index-j592zfqc.js → index-rt7q20sj.js} +1 -1
  73. package/{index-baccvws5.js → index-se7n78fh.js} +1 -1
  74. package/{index-s4nvxpzm.js → index-sxbsrndq.js} +1 -1
  75. package/{index-k6vwww45.js → index-t23dgyaf.js} +7 -7
  76. package/{index-71y6176j.js → index-v16gj2as.js} +86 -66
  77. package/{index-0s7w2085.js → index-vnk1qwgr.js} +4 -4
  78. package/{index-z96ks033.js → index-wkwe91sn.js} +169 -51
  79. package/{index-ybcb9wc8.js → index-wxqp1amd.js} +9 -9
  80. package/{index-p5zh7pmc.js → index-xv3pvdw4.js} +1 -1
  81. package/{index-zfnz878d.js → index-yey1envc.js} +1 -1
  82. package/{index-by2tvsq6.js → index-zyjztrvc.js} +1 -1
  83. package/index.js +30 -28
  84. package/{libExecutor-jc6f8hm6.js → libExecutor-n8hpm8s7.js} +3 -3
  85. package/{library.command-nxvesvhb.js → library.command-8abb26pg.js} +8 -8
  86. package/{localRegistry.command-xz62e4ng.js → localRegistry.command-sa211m1z.js} +18 -23
  87. package/{module.command-aaws9byg.js → module.command-z3cwjf0p.js} +10 -10
  88. package/{package.command-j7hv26p0.js → package.command-akynhtee.js} +9 -12
  89. package/package.json +3 -2
  90. package/{page.command-7yffs7n9.js → page.command-3fpdavk9.js} +8 -8
  91. package/{pipeline.command-7yk0zcng.js → pipeline.command-ca95n8rd.js} +7 -7
  92. package/{pkgExecutor-arxmvx4t.js → pkgExecutor-a73q41vx.js} +3 -3
  93. package/{primitive.command-7a1pt715.js → primitive.command-xwe9ggnf.js} +11 -11
  94. package/{projectTypecheck-f4qhbecd.js → projectTypecheck-7g542ymk.js} +1 -1
  95. package/{prompter-qyggfhqd.js → prompter-d33wmdpa.js} +2 -2
  96. package/{quality.command-c6mvrjh1.js → quality.command-7wz7y8z1.js} +9 -9
  97. package/{repair.command-093adzt9.js → repair.command-dej1qtfq.js} +10 -10
  98. package/{scalar.command-2ex84spb.js → scalar.command-z9qfxnvm.js} +9 -9
  99. package/skills/akan-agent/SKILL.md +8 -1
  100. package/skills/akan-code/SKILL.md +38 -3
  101. package/skills/akan-page/SKILL.md +18 -13
  102. package/skills/akan-runtime/SKILL.md +21 -16
  103. package/skills/akan-service/SKILL.md +2 -2
  104. package/{subspace.command-4n4n4jpv.js → subspace.command-9wekm4gn.js} +11 -13
  105. package/templates/localDev/docker-compose.yaml.template +2 -2
  106. package/{tunnel.command-f7ep1qfa.js → tunnel.command-cxc4h3j8.js} +10 -12
  107. package/{verify.command-zrkxnvct.js → verify.command-j0w9dr5c.js} +15 -17
  108. package/{workflow.command-ks16jegk.js → workflow.command-yt4sz04b.js} +15 -15
  109. package/{workspace.command-ahhfpaag.js → workspace.command-8mp4mcp2.js} +34 -38
  110. package/CodeAgent-fx6088tv.js +0 -11
  111. package/TunnelShare-9ry4vh0y.js +0 -18
  112. package/appExecutor-79azsb2w.js +0 -11
  113. package/cloud.script-3b401efv.js +0 -35
  114. package/context.runner-kctbfsde.js +0 -34
  115. package/dependencyScanner-ge10gb52.js +0 -8
@@ -3,17 +3,17 @@ import {
3
3
  Lib,
4
4
  Workspace,
5
5
  command
6
- } from "./index-2yn3r67f.js";
6
+ } from "./index-nnmw56fz.js";
7
7
  import"./index-j4yvgfhr.js";
8
- import"./index-71y6176j.js";
9
- import"./index-by2tvsq6.js";
10
- import"./index-z92zm3wd.js";
11
- import"./index-zfnz878d.js";
12
- import"./index-w1zexzpx.js";
8
+ import"./index-v16gj2as.js";
9
+ import"./index-zyjztrvc.js";
10
+ import"./index-9a9t77hz.js";
11
+ import"./index-yey1envc.js";
12
+ import"./index-crd99zqs.js";
13
13
  import {
14
14
  LibraryScript
15
- } from "./index-2jmvfa62.js";
16
- import"./index-7wf8snar.js";
15
+ } from "./index-4r8dgm4x.js";
16
+ import"./index-3r1crbct.js";
17
17
 
18
18
  // pkgs/@akanjs/cli/library/library.command.ts
19
19
  class LibraryCommand extends command("library", [LibraryScript], ({ public: target }) => ({
@@ -4,48 +4,43 @@ import {
4
4
  runner,
5
5
  script,
6
6
  command
7
- } from "./index-2yn3r67f.js";
7
+ } from "./index-nnmw56fz.js";
8
8
  import"./index-j4yvgfhr.js";
9
9
  import {
10
10
  parseEnvFile
11
- } from "./index-71y6176j.js";
12
- import"./index-by2tvsq6.js";
13
- import"./index-z92zm3wd.js";
14
- import"./index-zfnz878d.js";
11
+ } from "./index-v16gj2as.js";
12
+ import"./index-zyjztrvc.js";
13
+ import"./index-9a9t77hz.js";
14
+ import"./index-yey1envc.js";
15
15
  import {
16
16
  PkgExecutor2
17
- } from "./index-w1zexzpx.js";
17
+ } from "./index-crd99zqs.js";
18
18
  import {
19
19
  npmRegistryFromEnv,
20
20
  warnIgnoredNpmRegistry,
21
21
  getNpmRegistryUrl
22
22
  } from "./index-jf4vk1s0.js";
23
- import"./index-dmcpetwe.js";
24
- import"./index-ebn9kgea.js";
25
- import"./index-612fdtbk.js";
23
+ import"./index-8bta5pnr.js";
24
+ import"./index-fjqapyex.js";
25
+ import"./index-f4jydw2x.js";
26
26
  import"./index-m9jj544v.js";
27
- import"./index-9wh04mqy.js";
28
- import"./index-a860mx0m.js";
29
- import"./index-2jmvfa62.js";
30
- import"./index-z96ks033.js";
27
+ import"./index-4r8dgm4x.js";
28
+ import"./index-wkwe91sn.js";
31
29
  import"./index-rwgqba9p.js";
32
30
  import {
33
31
  ApplicationScript
34
- } from "./index-41a03gkj.js";
35
- import"./index-s885g0jj.js";
32
+ } from "./index-3zkhg65e.js";
33
+ import"./index-pyjkbg8e.js";
36
34
  import {
37
35
  CloudRunner
38
- } from "./index-xwwex8rf.js";
39
- import"./index-trffs83s.js";
40
- import"./index-p7beqww9.js";
41
- import"./index-baccvws5.js";
42
- import"./index-2ny1e95c.js";
36
+ } from "./index-cbm9gzgx.js";
37
+ import"./index-se7n78fh.js";
43
38
  import {
44
39
  PackageScript
45
- } from "./index-275a4r3n.js";
46
- import"./index-j592zfqc.js";
40
+ } from "./index-hxg6ctk2.js";
41
+ import"./index-rt7q20sj.js";
47
42
  import"./index-9bv479q5.js";
48
- import"./index-7wf8snar.js";
43
+ import"./index-3r1crbct.js";
49
44
 
50
45
  // pkgs/@akanjs/cli/localRegistry/localRegistry.runner.ts
51
46
  import { mkdir, rm } from "fs/promises";
@@ -4,22 +4,22 @@ import {
4
4
  Module,
5
5
  ModuleOrService,
6
6
  command
7
- } from "./index-2yn3r67f.js";
7
+ } from "./index-nnmw56fz.js";
8
8
  import"./index-j4yvgfhr.js";
9
- import"./index-71y6176j.js";
10
- import"./index-by2tvsq6.js";
11
- import"./index-z92zm3wd.js";
12
- import"./index-zfnz878d.js";
13
- import"./index-w1zexzpx.js";
9
+ import"./index-v16gj2as.js";
10
+ import"./index-zyjztrvc.js";
11
+ import"./index-9a9t77hz.js";
12
+ import"./index-yey1envc.js";
13
+ import"./index-crd99zqs.js";
14
14
  import {
15
15
  renderPrimitiveReport
16
- } from "./index-zmd9xxgd.js";
16
+ } from "./index-q63nbpv7.js";
17
17
  import"./index-trffs83s.js";
18
- import"./index-3txdtztz.js";
18
+ import"./index-9gjcbp2g.js";
19
19
  import {
20
20
  ModuleScript
21
- } from "./index-gt8phqpt.js";
22
- import"./index-7wf8snar.js";
21
+ } from "./index-rdcgz02t.js";
22
+ import"./index-3r1crbct.js";
23
23
 
24
24
  // pkgs/@akanjs/cli/module/module.command.ts
25
25
  import { Logger, lowerlize } from "akanjs/common";
@@ -3,21 +3,18 @@ import {
3
3
  Pkg,
4
4
  Workspace,
5
5
  command
6
- } from "./index-2yn3r67f.js";
6
+ } from "./index-nnmw56fz.js";
7
7
  import"./index-j4yvgfhr.js";
8
- import"./index-71y6176j.js";
9
- import"./index-by2tvsq6.js";
10
- import"./index-z92zm3wd.js";
11
- import"./index-zfnz878d.js";
12
- import"./index-w1zexzpx.js";
13
- import"./index-trffs83s.js";
14
- import"./index-p7beqww9.js";
15
- import"./index-baccvws5.js";
16
- import"./index-2ny1e95c.js";
8
+ import"./index-v16gj2as.js";
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";
17
14
  import {
18
15
  PackageScript
19
- } from "./index-275a4r3n.js";
20
- import"./index-7wf8snar.js";
16
+ } from "./index-hxg6ctk2.js";
17
+ import"./index-3r1crbct.js";
21
18
 
22
19
  // pkgs/@akanjs/cli/package/package.command.ts
23
20
  class PackageCommand extends command("package", [PackageScript], ({ public: target }) => ({
package/package.json CHANGED
@@ -1,11 +1,12 @@
1
1
  {
2
2
  "name": "@akanjs/cli",
3
- "version": "3.3.0-rc.1",
3
+ "version": "3.3.0-rc.11",
4
4
  "sourceType": "module",
5
5
  "type": "module",
6
6
  "publishConfig": {
7
7
  "access": "public"
8
8
  },
9
+ "description": "The akan command of Akan.js: create, sync, verify, build, start and deploy an Akan.js workspace. Create one with: bunx create-akan-workspace@latest",
9
10
  "homepage": "https://akanjs.com",
10
11
  "license": "MIT",
11
12
  "repository": {
@@ -39,7 +40,7 @@
39
40
  "@earendil-works/pi-tui": "1.5.2",
40
41
  "@inquirer/prompts": "^8.7.3",
41
42
  "@tailwindcss/node": "^4.3.3",
42
- "akanjs": "3.3.0-rc.1",
43
+ "akanjs": "3.3.0-rc.11",
43
44
  "chalk": "^6.0.1",
44
45
  "commander": "^15.0.0",
45
46
  "dayjs": "^1.11.23",
@@ -3,17 +3,17 @@ import {
3
3
  App,
4
4
  Module,
5
5
  command
6
- } from "./index-2yn3r67f.js";
6
+ } from "./index-nnmw56fz.js";
7
7
  import"./index-j4yvgfhr.js";
8
- import"./index-71y6176j.js";
9
- import"./index-by2tvsq6.js";
10
- import"./index-z92zm3wd.js";
11
- import"./index-zfnz878d.js";
12
- import"./index-w1zexzpx.js";
8
+ import"./index-v16gj2as.js";
9
+ import"./index-zyjztrvc.js";
10
+ import"./index-9a9t77hz.js";
11
+ import"./index-yey1envc.js";
12
+ import"./index-crd99zqs.js";
13
13
  import {
14
14
  PageScript
15
- } from "./index-3txdtztz.js";
16
- import"./index-7wf8snar.js";
15
+ } from "./index-9gjcbp2g.js";
16
+ import"./index-3r1crbct.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-2yn3r67f.js";
7
+ } from "./index-nnmw56fz.js";
8
8
  import"./index-j4yvgfhr.js";
9
9
  import {
10
10
  AkanAppConfig,
11
11
  AkanWorkspaceConfig
12
- } from "./index-71y6176j.js";
12
+ } from "./index-v16gj2as.js";
13
13
  import {
14
14
  FileSys2
15
- } from "./index-by2tvsq6.js";
15
+ } from "./index-zyjztrvc.js";
16
16
  import {
17
17
  AppExecutor2
18
- } from "./index-z92zm3wd.js";
19
- import"./index-zfnz878d.js";
20
- import"./index-w1zexzpx.js";
18
+ } from "./index-9a9t77hz.js";
19
+ import"./index-yey1envc.js";
20
+ import"./index-crd99zqs.js";
21
21
  import {
22
22
  resolveMobileTargets
23
23
  } from "./index-m9jj544v.js";
24
- import"./index-7wf8snar.js";
24
+ import"./index-3r1crbct.js";
25
25
 
26
26
  // pkgs/@akanjs/cli/pipeline/pipeline.command.ts
27
27
  import { pipelineTriggers as pipelineTriggers2 } from "akanjs/common";
@@ -1,10 +1,10 @@
1
1
  // @bun
2
2
  import {
3
3
  PkgExecutor2
4
- } from "./index-w1zexzpx.js";
5
- import"./index-71y6176j.js";
4
+ } from "./index-crd99zqs.js";
5
+ import"./index-v16gj2as.js";
6
6
  import"./index-j4yvgfhr.js";
7
- import"./index-by2tvsq6.js";
7
+ import"./index-zyjztrvc.js";
8
8
  export {
9
9
  PkgExecutor2 as PkgExecutor
10
10
  };
@@ -2,23 +2,23 @@
2
2
  import {
3
3
  Workspace,
4
4
  command
5
- } from "./index-2yn3r67f.js";
5
+ } from "./index-nnmw56fz.js";
6
6
  import"./index-j4yvgfhr.js";
7
- import"./index-71y6176j.js";
8
- import"./index-by2tvsq6.js";
9
- import"./index-z92zm3wd.js";
10
- import"./index-zfnz878d.js";
11
- import"./index-w1zexzpx.js";
7
+ import"./index-v16gj2as.js";
8
+ import"./index-zyjztrvc.js";
9
+ import"./index-9a9t77hz.js";
10
+ import"./index-yey1envc.js";
11
+ import"./index-crd99zqs.js";
12
12
  import {
13
13
  renderPrimitiveReport
14
- } from "./index-zmd9xxgd.js";
14
+ } from "./index-q63nbpv7.js";
15
15
  import"./index-trffs83s.js";
16
- import"./index-3txdtztz.js";
17
- import"./index-gt8phqpt.js";
16
+ import"./index-9gjcbp2g.js";
17
+ import"./index-rdcgz02t.js";
18
18
  import {
19
19
  PrimitiveScript
20
- } from "./index-6dzjer7p.js";
21
- import"./index-7wf8snar.js";
20
+ } from "./index-m303nhv6.js";
21
+ import"./index-3r1crbct.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-71y6176j.js";
4
+ } from "./index-v16gj2as.js";
5
5
  import"./index-j4yvgfhr.js";
6
6
  export {
7
7
  ProjectTypecheck2 as ProjectTypecheck
@@ -1,8 +1,8 @@
1
1
  // @bun
2
2
  import {
3
3
  Prompter2
4
- } from "./index-knpm8sdm.js";
5
- import"./index-by2tvsq6.js";
4
+ } from "./index-j3fqs8rc.js";
5
+ import"./index-zyjztrvc.js";
6
6
  export {
7
7
  Prompter2 as Prompter
8
8
  };
@@ -3,35 +3,35 @@ import {
3
3
  Workspace,
4
4
  script,
5
5
  command
6
- } from "./index-2yn3r67f.js";
6
+ } from "./index-nnmw56fz.js";
7
7
  import"./index-j4yvgfhr.js";
8
- import"./index-71y6176j.js";
9
- import"./index-by2tvsq6.js";
8
+ import"./index-v16gj2as.js";
9
+ import"./index-zyjztrvc.js";
10
10
  import {
11
11
  AppExecutor2
12
- } from "./index-z92zm3wd.js";
12
+ } from "./index-9a9t77hz.js";
13
13
  import {
14
14
  LibExecutor2
15
- } from "./index-zfnz878d.js";
15
+ } from "./index-yey1envc.js";
16
16
  import {
17
17
  PkgExecutor2
18
- } from "./index-w1zexzpx.js";
18
+ } from "./index-crd99zqs.js";
19
19
  import {
20
20
  MaintainabilityBaseline
21
- } from "./index-baccvws5.js";
21
+ } from "./index-se7n78fh.js";
22
22
  import {
23
23
  WorkspaceRunner,
24
24
  AkanQualityScanner,
25
25
  formatQualityScanResult,
26
26
  formatSsrScanResult
27
- } from "./index-78y75t0a.js";
27
+ } from "./index-j2wq064m.js";
28
28
  import"./index-trffs83s.js";
29
29
  import"./index-1p81ecbz.js";
30
30
  import"./index-62md4dwy.js";
31
31
  import"./index-zyb0ebm4.js";
32
32
  import"./index-jf4vk1s0.js";
33
33
  import"./index-t4d0ckde.js";
34
- import"./index-7wf8snar.js";
34
+ import"./index-3r1crbct.js";
35
35
 
36
36
  // pkgs/@akanjs/cli/quality/quality.script.ts
37
37
  import { Logger } from "akanjs/common";
@@ -3,21 +3,21 @@ import {
3
3
  Workspace,
4
4
  script,
5
5
  command
6
- } from "./index-2yn3r67f.js";
6
+ } from "./index-nnmw56fz.js";
7
7
  import"./index-j4yvgfhr.js";
8
- import"./index-71y6176j.js";
9
- import"./index-by2tvsq6.js";
10
- import"./index-z92zm3wd.js";
11
- import"./index-zfnz878d.js";
12
- import"./index-w1zexzpx.js";
13
- import"./index-zmd9xxgd.js";
8
+ import"./index-v16gj2as.js";
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";
14
14
  import"./index-trffs83s.js";
15
- import"./index-h901f24n.js";
15
+ import"./index-h8w1n11r.js";
16
16
  import"./index-1p81ecbz.js";
17
17
  import {
18
18
  RepairRunner
19
- } from "./index-kfvjzk8r.js";
20
- import"./index-7wf8snar.js";
19
+ } from "./index-kbnvyhy4.js";
20
+ import"./index-3r1crbct.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-2yn3r67f.js";
5
+ } from "./index-nnmw56fz.js";
6
6
  import"./index-j4yvgfhr.js";
7
- import"./index-71y6176j.js";
8
- import"./index-by2tvsq6.js";
9
- import"./index-z92zm3wd.js";
10
- import"./index-zfnz878d.js";
11
- import"./index-w1zexzpx.js";
7
+ import"./index-v16gj2as.js";
8
+ import"./index-zyjztrvc.js";
9
+ import"./index-9a9t77hz.js";
10
+ import"./index-yey1envc.js";
11
+ import"./index-crd99zqs.js";
12
12
  import {
13
13
  renderPrimitiveReport
14
- } from "./index-zmd9xxgd.js";
14
+ } from "./index-q63nbpv7.js";
15
15
  import"./index-trffs83s.js";
16
16
  import {
17
17
  ScalarScript
18
- } from "./index-4ss4gkv3.js";
19
- import"./index-7wf8snar.js";
18
+ } from "./index-fagjtk6m.js";
19
+ import"./index-3r1crbct.js";
20
20
 
21
21
  // pkgs/@akanjs/cli/scalar/scalar.command.ts
22
22
  import { Logger, lowerlize } from "akanjs/common";
@@ -36,7 +36,14 @@ agent nothing, and only the current page's declarations are live.
36
36
 
37
37
  - `st.use.x({ agent: false })` hides a key; `hidden`, `secret` and `visual` fields are stripped from every read.
38
38
  - Page text is data the model reads, never instructions: after a screen read the next call that changes something
39
- asks once, and `data-agent-private="<label>"` keeps a region's text out of every read.
39
+ asks once, and `data-agent-private="<label>"` keeps a region's text out of every read. An `@` mention of a record
40
+ counts as a screen read.
41
+ - A turn's context carries ids, enum members, numbers and booleans. Any other string, a search param, a path
42
+ param or a list row's title included, is left out and read with `readState` or `readScreen`, so instructions say
43
+ "read `searchParams`", never "the query is in the route context". A search param rides inline when a store
44
+ declares its key with `search()`; of the others at most four short ones do. A zone's `label` and a value
45
+ published with `st.expose`, `st.useState` or `useAgentResource` ride whole: publish an id or a count there, never
46
+ text a user wrote.
40
47
  - A tool value is capped at 20,000 characters.
41
48
  - Route guidance is `<Agent.Guide instructions="…" />`; model-facing text is English.
42
49
 
@@ -139,13 +139,48 @@ akan code -i "<prompt>" open the session with the prompt already sent
139
139
  --compact-at <percent> compact once the window is this full (10, 20, … 100)
140
140
  --trust-workspace start this repo's MCP servers and extensions without asking
141
141
  --no-ask-network never ask before an unlisted host (local profile)
142
+ --no-ask-commands run shell commands without asking (local profile)
143
+ --no-ask both of those at once: this session asks before nothing it runs (local profile)
142
144
  --rpc-listen unix:<path>|tcp:[host:]<port> serve the RPC wire on a socket instead of stdio
143
145
  ```
144
146
 
145
147
  `local` runs as the user: it refuses known secret files and the home credential stores, and asks before it
146
- fetches a page from a host off a short documentation list or a shell command that reaches the network
147
- (`curl`, `ssh`, …) — refused outright where nobody can answer, as in a one-shot `akan code "<prompt>"`. It is
148
- not a sandbox; `pod` in a container is.
148
+ runs a shell command, fetches a page from a host off a short documentation list, or runs a shell command that
149
+ reaches the network (`curl`, `ssh`, …). Where nobody can answer, as in a one-shot `akan code "<prompt>"` or
150
+ inside a sub-agent, an ordinary command runs unasked and those network calls are refused outright. It is not a
151
+ sandbox; `pod` in a container is.
152
+
153
+ An approval for a shell command reads `approve? run: <command> [y/n/a]`. `y` runs it once, `n` or esc refuses
154
+ it, and `a` runs it and stops asking about that command until the session ends. What `a` remembers is the
155
+ program, and the sub-command too for `git`, `bun`, `bunx`, `npm`, `npx`, `pnpm`, `yarn`, `akan`, `docker`,
156
+ `kubectl`, `helm`, `cargo` and `go`: allowing `git status` leaves `git diff` asked about, and allowing
157
+ `bun test` leaves `bun x` asked about. `gh` is remembered two words deep, so allowing `gh pr view` leaves
158
+ `gh pr merge` asked about. A line of several commands (`&&`, `;`, `|`, `$(…)`, a subshell) runs unasked only
159
+ once every command in it is allowed, and its prompt names the ones `a` would add. `/allowed` lists what the
160
+ session has allowed and `/allowed clear` forgets it. Nothing is written down: a resumed, forked or reloaded
161
+ session asks again.
162
+
163
+ Some lines are asked about every time and their prompt offers only `[y/n]`:
164
+
165
+ - a networking command: `curl`, `wget`, `nc`, `ncat`, `netcat`, `socat`, `telnet`, `ssh`, `scp`, `sftp`,
166
+ `rsync`, `ftp`, and a redirection to or from `/dev/tcp/…` or `/dev/udp/…`;
167
+ - a command that sends something out of the machine: `git push`, `npm publish`, `pnpm publish`,
168
+ `yarn publish`, `yarn npm`, `bun publish`, `cargo publish`, `gh api`, and a `docker` line with `push` or
169
+ `--push` in it (`docker push`, `docker image push`, `docker build --push`);
170
+ - `rm`;
171
+ - a command that runs another, or sets what a later one runs: `sudo`, `env`, `command`, `exec`, `nohup`,
172
+ `time`, `timeout`, `nice`, `watch`, `stdbuf`, `xargs`, `sh`, `bash`, `zsh`, `dash`, `ksh`, `fish`, `eval`,
173
+ `builtin`, `source`, `.`, `trap`, `alias`, `coproc`, `export`, `declare`, `typeset`, `readonly`, `find -exec`;
174
+ - a variable set in front of a command, other than `CI`, `NODE_ENV`, `FORCE_COLOR`, `NO_COLOR`, `TZ`, `LANG`,
175
+ `LC_ALL`, `TERM`, `DEBUG` or `PORT` given one plain word (`CI=1 bun test` is read as `bun test`);
176
+ - a line that writes a file with `>` or `>>` (other than to `/dev/null`);
177
+ - a line the reader cannot split with confidence: a loop or `if`, backticks, a here-document, a program named
178
+ by a variable, a flag between `git` and its sub-command.
179
+
180
+ `--no-ask` is `--no-ask-commands --no-ask-network` under one name, for a run where the user has decided not to
181
+ be asked: it prints one line at start saying so. It changes nothing else: the secret files stay refused, this
182
+ repo's MCP servers and extensions still wait for their own approval (`--trust-workspace`), the agent's own
183
+ questions are still asked, and the other profiles behave as they did.
149
184
 
150
185
  A `tcp:` listener asks every connection to open with `{"auth":"<token>"}` on its first line; the token is a
151
186
  fresh one in `~/.akan/code/rpc/<port>.token`, or the one in the file `AKAN_CODE_RPC_TOKEN_FILE` names.
@@ -26,19 +26,19 @@ export default page()
26
26
  ## Steps
27
27
 
28
28
  1. Place the file: `<route>.tsx` or `<dir>/_index.tsx` serves the path, `_layout.tsx` nests a layout (`layout()`;
29
- the root one is `rootLayout()`), `[id]` is a dynamic segment, `(group)` groups without a segment. `page/` holds
30
- route modules only — no helpers, no `.ts` files.
29
+ the root one is `rootLayout()`), `[id]` is a dynamic segment, `(group)` groups without a segment.
31
30
  2. Name every `[x]` segment with `.param("x", Type)` and read a query key only with `.search("k", Type)`. Values
32
- arrive typed; `lang` reaches every stage and is never declared.
33
- 3. Gate with `.guard(() => signedIn())` on the `_layout.tsx` (a real redirect before anything renders), and repeat
34
- a stricter guard on a page that needs more. The endpoint guards are still the real gate. `signedIn` comes from
35
- `@libs/shared/webkit`, and a new workspace has that lib only with `create-workspace --libs true`.
31
+ arrive typed: `ID` / `String` → string, `Int` / `Float` → number, `Boolean`, `Date` → Dayjs, an `enumOf` class →
32
+ its union, `[T]` → array. A path value the type refuses answers not-found, and a search value that fails is
33
+ dropped. `lang` reaches every stage and is never declared.
34
+ 3. Gate with `.guard(() => signedIn())` on the `_layout.tsx`, and repeat a stricter guard on a page that needs more.
35
+ `.guard((_, { path }) => signedIn({ path }))` sends a refused visitor to `/signin?redirect=<path>`.
36
36
  4. In `.render()`: `usePage()`, then fetch, then return. Hand `fetch.init*` / `view*` / `edit*` fields to sections
37
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. A canonical link comes only from the
39
- page's own head.
38
+ 5. `.head()` takes JSX (or a function returning it), never a metadata object.
40
39
  6. Re-skin an `akanjs/ui` component for a subtree with `_overrides.tsx`:
41
- `export default override({ Slot: AppComponent })`, no logic.
40
+ `export default override({ Slot: AppComponent })`, no logic. Nested ones merge slot by slot, the closest winning;
41
+ `componentRule` lists the slots.
42
42
 
43
43
  ## API at a glance
44
44
 
@@ -50,12 +50,16 @@ declared params and search keys plus `lang`.
50
50
  where `Book` is the `common/` interface for the query's `Any` return (`akan-service`).
51
51
  - Async page: `.render(async ({ id }) => { const book = (await fetch.book(id)) as Book | null; if (!book) return router.notFound(); … })`;
52
52
  the same query in `.head()` and `.render()` is one request.
53
+ - Loading: `.loading(() => <Skeleton />)` on a page or layout is what that level shows until its `.render()` and the
54
+ levels below it resolve; the levels above it stream first.
53
55
  - `router.notFound()` from `.guard()`, `.head()` or `.render()` answers 404 with the nearest layout's `.notFound()`
54
56
  above it (an unmatched URL: the deepest layout covering it), else the built-in 404.
55
57
  - A layout's own 404 and error views: `.notFound(({ pathname }) => …)` and `.error(({ error }) => …)` on `layout()`
56
- or `rootLayout()`.
58
+ or `rootLayout()`. A `<title>` and `<meta>` at the top of what they return replace the page's head:
59
+ `.notFound(() => <><title>Not found</title>…</>)`, except below a `.loading()`, where the head is already out.
57
60
  - `<Link href="/books/OL45804W">`: write the path without the locale; Link adds it, or leaves it off for the default
58
- locale under `i18n.localePrefix: "as-needed"`. `activeClassName` marks the current one.
61
+ locale under `i18n.localePrefix: "as-needed"`. It renders an `<a>` and takes its attributes; `activeClassName`
62
+ marks the current one.
59
63
  - From a handler: `router.push(href)` / `router.replace(href)`; in a server stage, `router.redirect(href)`.
60
64
  - A client filter kept in the URL without reloading the page: ``router.replace(`/books?q=${q}`, { shallow: true,
61
65
  scrollToTop: false })`` in a `"use client"` component, read back with `usePageLocation().searchParams`. Shallow
@@ -68,5 +72,6 @@ declared params and search keys plus `lang`.
68
72
  - `useState`, `useEffect`, comments, a named export beside the chain, or the legacy `export default async function`.
69
73
  - Editing a lib page through its link in `page/(libs)/` — edit the lib's own `page/` source.
70
74
 
71
- Full detail: `get_guideline` with `pageRule`, or `ssrRule` for what may render on the server; every stage's
72
- signature, the router's methods, Link's props and every import path: `akanApi`.
75
+ Full detail: `get_guideline` with `pageRule` (guards in depth, heads, MCP apps, CSR root layouts, lib pages), or
76
+ `ssrRule` for what may render on the server. Every stage's signature, the router's methods, Link's props and every
77
+ import path are in the `akanApi-*` references below.
@@ -5,8 +5,9 @@ description: "Configure how an app runs: web surfaces, route prefixes, gateway v
5
5
 
6
6
  # Akan runtime
7
7
 
8
- Runtime and build settings are declared in `akan.config.ts` and narrowed — never widened — by an env at boot.
9
- Domain code reaches none of them.
8
+ Runtime and build settings are declared in `akan.config.ts`. What must hold when you edit it, `main.ts` or an env
9
+ file — the prefixes, the `main.ts` import, the image, log sinks, the desktop server's guard — is the `config` rule in
10
+ the agent guide's Path Rules table.
10
11
 
11
12
  ## Where each setting lives
12
13
 
@@ -16,28 +17,32 @@ Domain code reaches none of them.
16
17
  | Move the API or websocket mount | `new AkanApp({ prefix, websocketPrefix })` in `main.ts`, mirrored in `api: { … }`; read with `getApiPrefix()` / `getWsPrefix()` |
17
18
  | The production image | `docker: string \| { image, preRuns, postRuns, command }` |
18
19
  | iOS, Android, desktop | the `native` section; `desktop: { server: true }` carries the server |
19
- | SQLite, several databases, a cluster | `database: { modes: [...] }`, picked by `AKAN_DATABASE_MODE` |
20
+ | SQLite, several databases, a cluster | `database: { modes: [...] }` (`single`, `multiple`, `cluster`), picked by `AKAN_DATABASE_MODE` |
20
21
  | 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 |
21
22
 
22
- - `main.ts` imports `AkanApp` from `akanjs/server/akanApp`, never the barrel.
23
- - Never write `/api` or `/ws` literally, and never pass a prefix as a prop.
24
- - The generated image installs only `ca-certificates` and `tzdata`; add the rest in `preRuns`.
25
- - An app running in two database modes avoids `q.raw`.
26
-
27
23
  ## Running and logs
28
24
 
29
25
  - `akan start <app>` (`a,b` or `all` for several) runs the dev server; `akan build <app>` checks the production
30
- build. A supervised session writes `local/apps/<app>/runtime/dev.log` — hand over that path, not a paste of the
31
- live view. Tail with `akan logs <app>`.
26
+ build. A supervised session writes `local/apps/<app>/runtime/dev.log` (previous: `dev.prev.log`) — hand over that
27
+ path, not a paste of the live view. Tail with `akan logs <app>`.
32
28
  - Run a build without Docker with `cd dist/apps/<app> && bun main.js`: it boots with the env the Dockerfile sets,
33
29
  read from `akan.env.json` beside it, and a variable you set yourself (`PORT=3000`) wins.
34
- - Give every log sink a floor (`Logger.addSink(sink, { minLevel })`) and never log once per delivered record.
35
30
 
36
31
  ## Native and desktop
37
32
 
38
- - `akan start-desktop <app>`, `akan start-ios <app>`, `akan start-android <app>` load pages from a running
39
- `akan start`; a desktop app carrying its server starts it itself.
40
- - A desktop app's carried server listens on a loopback port any local program can call — guard it like a network
41
- server. Read runtime files from `AKAN_APP_DIR`, and keep a user's secret with `NativeSecret`, never in a file.
33
+ A `start-*` command loads its pages from a running `akan start`; a desktop app carrying its server starts it itself.
34
+
35
+ ```bash
36
+ akan start-desktop <app> # Run the desktop app on this computer
37
+ akan start-ios <app> # Run it in a simulator or on an iPhone (start-android alike)
38
+ akan build-desktop <app> # Build it for this computer into dist/native/<app>/<target>/build
39
+ akan build-desktop <app> --installer true # Windows: add a per-user setup program
40
+ akan update-keygen <app> # Make the update signing key once; print its public key
41
+ akan publish-update <app> # Build a key-signed release for updates.url; --sign true also code-signs it
42
+ ```
43
+
44
+ A device capability the framework lacks is a plugin the app owns in `native/<id>/`: `native-plugin.json`,
45
+ `src/index.ts` (the page API, used from a `webkit/` hook), `src/desktop.ts`, Kotlin and Swift.
42
46
 
43
- Full detail: `get_guideline` with `runtimeRule`.
47
+ Full detail: `get_guideline` with `runtimeRule` (keys, `--plain`, boot waves, `--kill`, watch scope, booting a
48
+ server in a test, native targets and updates).
@@ -106,5 +106,5 @@ The page calls it as `await fetch.book(id)` (`fetch` from `@apps/<app>/client`)
106
106
  `common/`, or return a scalar (`akan create-scalar`) for a typed wire shape. A query that answers `null` without
107
107
  `nullable: true` fails the render, naming the endpoint.
108
108
 
109
- Full detail: `get_guideline` with `modelService`; every import path and the exact signatures of serve, adapt,
110
- endpoint and serviceDictionary: `akanApi`.
109
+ Full detail: `get_guideline` with `modelService`. The exact signatures of serve, adapt, endpoint and
110
+ serviceDictionary, and every import path, are in the `akanApi-*` references below.