@akanjs/cli 3.1.1-rc.15 → 3.1.1-rc.16

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 (71) hide show
  1. package/.build-stamp +1 -1
  2. package/{CodeAgent-gtwn7tmb.js → CodeAgent-23ewzxqa.js} +2 -2
  3. package/{CodeTui-v941fqdh.js → CodeTui-kc99fk78.js} +1 -1
  4. package/TunnelShare-dk2gw78d.js +14 -0
  5. package/{agent.command-h82gepwn.js → agent.command-knp5j7bq.js} +5 -5
  6. package/akanCode.js +2 -2
  7. package/{application.command-j1reb9p1.js → application.command-bvfd1680.js} +9 -9
  8. package/{applicationBuildRunner-w20x63mz.js → applicationBuildRunner-4ajaesk1.js} +6 -5
  9. package/buildBatch.proc.js +5 -5
  10. package/{cloud.command-zd2mfkm0.js → cloud.command-f2w40fyy.js} +13 -13
  11. package/cloud.script-2r82sv0f.js +24 -0
  12. package/{code.command-dyet4xn6.js → code.command-dbhhnahn.js} +6 -6
  13. package/{context.command-79gxczm4.js → context.command-yswjwv6y.js} +17 -16
  14. package/context.runner-c3wsh2jw.js +26 -0
  15. package/{guideline.command-xwkskvky.js → guideline.command-ztx6dkpk.js} +2 -2
  16. package/guidelines/conventions/conventions.instruction.md +56 -10
  17. package/incrementalBuilder.proc.js +3 -3
  18. package/{index-yknrmkmt.js → index-005dqc83.js} +2 -2
  19. package/{index-qmeh0s05.js → index-00ke4phc.js} +2 -2
  20. package/{index-hdzjaq7s.js → index-2epb3wgh.js} +2 -2
  21. package/{index-rshwdv9w.js → index-2p1brf5e.js} +2 -2
  22. package/{index-wvvwdzfw.js → index-4332q6yj.js} +3 -3
  23. package/{index-6pzt55w3.js → index-4t4qb8jg.js} +3 -3
  24. package/{index-7ktk2hnz.js → index-76jwsm3g.js} +2 -2
  25. package/{index-tzzs52h0.js → index-7ndgffg4.js} +9 -9
  26. package/{index-1e2955yd.js → index-921cxqrd.js} +3 -1
  27. package/{index-8jb5ep2e.js → index-97fsvy66.js} +2 -2
  28. package/{index-pc9ps0hx.js → index-9sa6abze.js} +8 -8
  29. package/{index-jjd97ya6.js → index-deeskxjh.js} +1 -1
  30. package/{index-cz9g85xh.js → index-er16p89s.js} +1 -1
  31. package/{index-ygy8c12j.js → index-gxj80jz7.js} +1 -1
  32. package/index-hvg3esm0.js +1844 -0
  33. package/{index-41d3zx66.js → index-k9k18vq9.js} +3 -3
  34. package/{index-nmy1rana.js → index-m54n0v29.js} +4 -4
  35. package/index-m5n3ka0p.js +18 -0
  36. package/{index-brpk7gd8.js → index-m6qgr1rx.js} +7 -7
  37. package/{index-553xyb55.js → index-m93qg20j.js} +1 -1
  38. package/{index-4rwfh2de.js → index-mk391h0z.js} +3 -3
  39. package/{index-ch1sv7ke.js → index-nzfgyw3b.js} +9 -21
  40. package/{index-2qzzp0c9.js → index-p2pahmsa.js} +3 -3
  41. package/{index-kbbyzs6j.js → index-qx4r4cj2.js} +2 -2
  42. package/index-rxse80x6.js +408 -0
  43. package/{index-kr62ph5a.js → index-s4c2y5gs.js} +2 -2
  44. package/{index-jtydvvq7.js → index-saj9cx3a.js} +4 -4
  45. package/index-vgt25eh1.js +615 -0
  46. package/{index-8rvwgd1r.js → index-vq77g679.js} +1 -1
  47. package/{index-xeh7m2j5.js → index-xfp4dcnx.js} +1 -1
  48. package/{index-pqdz7rat.js → index-xjwcp91m.js} +910 -36
  49. package/{index-7abjzny1.js → index-ysyt782g.js} +33 -37
  50. package/index.js +22 -22
  51. package/{library.command-td8t85kb.js → library.command-hmbkcwzw.js} +3 -3
  52. package/{localRegistry.command-jx9zkmxf.js → localRegistry.command-sq5p4c9x.js} +15 -13
  53. package/{module.command-j70mqgpp.js → module.command-n4z29zcv.js} +5 -5
  54. package/{package.command-1b1v6k5v.js → package.command-20025dy3.js} +3 -3
  55. package/package.json +2 -2
  56. package/{page.command-m31w2tsz.js → page.command-q8fvpjer.js} +3 -3
  57. package/{pipeline.command-q7b8wy55.js → pipeline.command-8j97fq88.js} +2 -2
  58. package/{primitive.command-4zrbhkb9.js → primitive.command-e5y6dqp1.js} +6 -6
  59. package/{projectTypecheck-synx6qff.js → projectTypecheck-tbdye9k3.js} +1 -1
  60. package/{quality.command-cy0pgqjz.js → quality.command-168pt5vm.js} +621 -311
  61. package/{repair.command-98n6zxg7.js → repair.command-dq1gckth.js} +5 -5
  62. package/{scalar.command-rak5pjk3.js → scalar.command-5vwf152w.js} +4 -4
  63. package/{subspace.command-ej0rk116.js → subspace.command-182be8vj.js} +8 -8
  64. package/{tunnel.command-kdx3amrc.js → tunnel.command-bfzj7xkb.js} +7 -7
  65. package/{workflow.command-gffk9nj9.js → workflow.command-3g53242s.js} +37 -13
  66. package/workspace.command-h7399jwv.js +260 -0
  67. package/TunnelShare-26ty9skr.js +0 -14
  68. package/cloud.script-vdj8ymch.js +0 -24
  69. package/context.runner-ejag7mhr.js +0 -25
  70. package/index-y5m4j2w6.js +0 -856
  71. package/workspace.command-097hv6n1.js +0 -521
package/.build-stamp CHANGED
@@ -1 +1 @@
1
- c3a2d3427230f80931408a4606598af837dc95de313343084e806b685cf6b81b
1
+ 9bf641c8b229369b89856a905b865ca191fce5f2913b0b2b82a00fec24409ee1
@@ -1,8 +1,8 @@
1
1
  // @bun
2
2
  import {
3
3
  CodeAgent2
4
- } from "./index-41d3zx66.js";
5
- import"./index-jjd97ya6.js";
4
+ } from "./index-k9k18vq9.js";
5
+ import"./index-deeskxjh.js";
6
6
  import"./index-7md2g9vw.js";
7
7
  export {
8
8
  CodeAgent2 as CodeAgent
@@ -5,7 +5,7 @@ import {
5
5
  McpTokenStore,
6
6
  McpSignIn,
7
7
  AkanCodeCompaction2
8
- } from "./index-jjd97ya6.js";
8
+ } from "./index-deeskxjh.js";
9
9
  import {
10
10
  CodeTuiLines2,
11
11
  CodeTuiAgents2,
@@ -0,0 +1,14 @@
1
+ // @bun
2
+ import {
3
+ TunnelShare2
4
+ } from "./index-xfp4dcnx.js";
5
+ import"./index-76jwsm3g.js";
6
+ import"./index-p2pahmsa.js";
7
+ import"./index-m9jj544v.js";
8
+ import"./index-005dqc83.js";
9
+ import"./index-er16p89s.js";
10
+ import"./index-921cxqrd.js";
11
+ import"./index-52w0fvh8.js";
12
+ export {
13
+ TunnelShare2 as TunnelShare
14
+ };
@@ -2,16 +2,16 @@
2
2
  import {
3
3
  Workspace,
4
4
  command
5
- } from "./index-qmeh0s05.js";
5
+ } from "./index-00ke4phc.js";
6
6
  import"./index-52w0fvh8.js";
7
- import"./index-1e2955yd.js";
7
+ import"./index-921cxqrd.js";
8
8
  import"./index-hj6w4ka1.js";
9
- import"./index-pqdz7rat.js";
10
- import"./index-kr62ph5a.js";
9
+ import"./index-xjwcp91m.js";
10
+ import"./index-s4c2y5gs.js";
11
11
  import"./index-zzvvc845.js";
12
12
  import {
13
13
  AgentScript
14
- } from "./index-6pzt55w3.js";
14
+ } from "./index-4t4qb8jg.js";
15
15
 
16
16
  // pkgs/@akanjs/cli/agent/agent.command.ts
17
17
  class AgentCommand extends command("agent", [AgentScript], ({ public: target }) => ({
package/akanCode.js CHANGED
@@ -28,7 +28,7 @@ import {
28
28
  CodeMailbox2,
29
29
  CodeSessionFork2,
30
30
  CodeAgent2
31
- } from "./index-41d3zx66.js";
31
+ } from "./index-k9k18vq9.js";
32
32
  import {
33
33
  akanCodeDefaultModel2,
34
34
  akanCodeModel2,
@@ -40,7 +40,7 @@ import {
40
40
  SubagentPool2,
41
41
  akanCodePaths2,
42
42
  AkanCodeCompaction2
43
- } from "./index-jjd97ya6.js";
43
+ } from "./index-deeskxjh.js";
44
44
  import"./index-7md2g9vw.js";
45
45
  import {
46
46
  CodeAgentRpcHost2
@@ -7,19 +7,19 @@ import {
7
7
  Exec,
8
8
  Workspace,
9
9
  command
10
- } from "./index-qmeh0s05.js";
10
+ } from "./index-00ke4phc.js";
11
11
  import"./index-52w0fvh8.js";
12
- import"./index-1e2955yd.js";
12
+ import"./index-921cxqrd.js";
13
13
  import"./index-5nd1wtkv.js";
14
- import"./index-2qzzp0c9.js";
15
- import"./index-8rvwgd1r.js";
14
+ import"./index-p2pahmsa.js";
15
+ import"./index-vq77g679.js";
16
16
  import"./index-m9jj544v.js";
17
- import"./index-yknrmkmt.js";
18
- import"./index-cz9g85xh.js";
19
- import"./index-rshwdv9w.js";
17
+ import"./index-005dqc83.js";
18
+ import"./index-er16p89s.js";
19
+ import"./index-2p1brf5e.js";
20
20
  import {
21
21
  ApplicationScript
22
- } from "./index-tzzs52h0.js";
22
+ } from "./index-7ndgffg4.js";
23
23
  import"./index-7md2g9vw.js";
24
24
  import {
25
25
  writeOption,
@@ -28,7 +28,7 @@ import {
28
28
  allowLocalOption,
29
29
  publicEnvOption
30
30
  } from "./index-mdjc93e1.js";
31
- import"./index-553xyb55.js";
31
+ import"./index-m93qg20j.js";
32
32
 
33
33
  // pkgs/@akanjs/cli/application/application.command.ts
34
34
  import { MigrationCommand } from "akanjs/server/migration/migrationCommand";
@@ -4,19 +4,19 @@ import {
4
4
  Spinner,
5
5
  ProjectTypecheck2,
6
6
  WorkspaceExecutor
7
- } from "./index-1e2955yd.js";
7
+ } from "./index-921cxqrd.js";
8
8
  import"./index-52w0fvh8.js";
9
- import"./index-8jb5ep2e.js";
10
- import"./index-cz9g85xh.js";
9
+ import"./index-97fsvy66.js";
10
+ import"./index-er16p89s.js";
11
11
  import {
12
12
  AllRoutesBuilder,
13
13
  FontPruner,
14
14
  precompressArtifacts,
15
15
  SsrBaseArtifactBuilder
16
- } from "./index-4rwfh2de.js";
16
+ } from "./index-mk391h0z.js";
17
17
  import {
18
18
  CsrArtifactBuilder
19
- } from "./index-yknrmkmt.js";
19
+ } from "./index-005dqc83.js";
20
20
  import"./index-62md4dwy.js";
21
21
 
22
22
  // pkgs/@akanjs/devkit/applicationBuildRunner.ts
@@ -211,6 +211,7 @@ class ApplicationBuildRunner {
211
211
  "../../page/**/*.ts",
212
212
  "../../page/**/*.tsx",
213
213
  ...libPageIncludes,
214
+ ...options.tests ? ["../../script/**/*.ts"] : [],
214
215
  "../../../../pkgs/akanjs/*/types/**/*.d.ts"
215
216
  ], options);
216
217
  }
@@ -6,26 +6,26 @@ import {
6
6
  resolveSsrPageEntriesForApp,
7
7
  WorkspaceExecutor,
8
8
  AppExecutor
9
- } from "./index-1e2955yd.js";
9
+ } from "./index-921cxqrd.js";
10
10
  import {
11
11
  computeRouteSeedIndex,
12
12
  saveRouteSeedIndex,
13
13
  CsrDevBundler,
14
14
  SsrDevBundler
15
- } from "./index-8jb5ep2e.js";
15
+ } from "./index-97fsvy66.js";
16
16
  import"./index-52w0fvh8.js";
17
17
  import {
18
18
  ServerGraphFile,
19
19
  PagesBundleBuilder
20
- } from "./index-cz9g85xh.js";
20
+ } from "./index-er16p89s.js";
21
21
  import {
22
22
  CssCompiler,
23
23
  FontOptimizer,
24
24
  SsrBaseArtifactBuilder
25
- } from "./index-4rwfh2de.js";
25
+ } from "./index-mk391h0z.js";
26
26
  import {
27
27
  CsrArtifactBuilder
28
- } from "./index-yknrmkmt.js";
28
+ } from "./index-005dqc83.js";
29
29
  import"./index-62md4dwy.js";
30
30
 
31
31
  // pkgs/@akanjs/devkit/incrementalBuilder/buildBatch.proc.ts
@@ -3,27 +3,27 @@ import {
3
3
  App,
4
4
  Workspace,
5
5
  command
6
- } from "./index-qmeh0s05.js";
6
+ } from "./index-00ke4phc.js";
7
7
  import"./index-52w0fvh8.js";
8
- import"./index-1e2955yd.js";
9
- import"./index-7ktk2hnz.js";
8
+ import"./index-921cxqrd.js";
9
+ import"./index-76jwsm3g.js";
10
10
  import {
11
11
  PlatformTestRun
12
- } from "./index-ch1sv7ke.js";
13
- import"./index-2qzzp0c9.js";
14
- import"./index-8rvwgd1r.js";
12
+ } from "./index-nzfgyw3b.js";
13
+ import"./index-p2pahmsa.js";
14
+ import"./index-vq77g679.js";
15
15
  import"./index-m9jj544v.js";
16
- import"./index-yknrmkmt.js";
17
- import"./index-cz9g85xh.js";
16
+ import"./index-005dqc83.js";
17
+ import"./index-er16p89s.js";
18
18
  import"./index-5nd1wtkv.js";
19
- import"./index-rshwdv9w.js";
20
- import"./index-tzzs52h0.js";
19
+ import"./index-2p1brf5e.js";
20
+ import"./index-7ndgffg4.js";
21
21
  import"./index-7md2g9vw.js";
22
22
  import"./index-tvehn2sp.js";
23
- import"./index-hdzjaq7s.js";
23
+ import"./index-2epb3wgh.js";
24
24
  import {
25
25
  CloudScript2
26
- } from "./index-brpk7gd8.js";
26
+ } from "./index-m6qgr1rx.js";
27
27
  import {
28
28
  writeOption,
29
29
  oneNativeTargetOption,
@@ -34,7 +34,7 @@ import {
34
34
  hostOption,
35
35
  subspaceOption
36
36
  } from "./index-mdjc93e1.js";
37
- import"./index-553xyb55.js";
37
+ import"./index-m93qg20j.js";
38
38
 
39
39
  // pkgs/@akanjs/cli/cloud/cloud.command.ts
40
40
  var localRegistryUrl = () => process.env.AKAN_NPM_REGISTRY ?? "http://127.0.0.1:4873";
@@ -0,0 +1,24 @@
1
+ // @bun
2
+ import {
3
+ CloudScript2
4
+ } from "./index-m6qgr1rx.js";
5
+ import"./index-nzfgyw3b.js";
6
+ import"./index-7ndgffg4.js";
7
+ import"./index-m93qg20j.js";
8
+ import"./index-2p1brf5e.js";
9
+ import"./index-2epb3wgh.js";
10
+ import"./index-vq77g679.js";
11
+ import"./index-76jwsm3g.js";
12
+ import"./index-p2pahmsa.js";
13
+ import"./index-m9jj544v.js";
14
+ import"./index-00ke4phc.js";
15
+ import"./index-7md2g9vw.js";
16
+ import"./index-005dqc83.js";
17
+ import"./index-5nd1wtkv.js";
18
+ import"./index-er16p89s.js";
19
+ import"./index-921cxqrd.js";
20
+ import"./index-tvehn2sp.js";
21
+ import"./index-52w0fvh8.js";
22
+ export {
23
+ CloudScript2 as CloudScript
24
+ };
@@ -4,9 +4,9 @@ import {
4
4
  runner,
5
5
  script,
6
6
  command
7
- } from "./index-qmeh0s05.js";
7
+ } from "./index-00ke4phc.js";
8
8
  import"./index-52w0fvh8.js";
9
- import"./index-1e2955yd.js";
9
+ import"./index-921cxqrd.js";
10
10
  import {
11
11
  akanCodeDefaultModel2,
12
12
  CodeAgentStreamPrinter2
@@ -19,7 +19,7 @@ class CodeRunner extends runner("code") {
19
19
  async serve(options, listen) {
20
20
  await import("./consoleToStderr-h5bryj94.js");
21
21
  const [{ CodeAgent }, { CodeAgentRpcHost }, { CodeAgentRpcListener }] = await Promise.all([
22
- import("./CodeAgent-gtwn7tmb.js"),
22
+ import("./CodeAgent-23ewzxqa.js"),
23
23
  import("./CodeAgentRpcHost-9g27hmer.js"),
24
24
  import("./CodeAgentRpcListener-7p7z5dd7.js")
25
25
  ]);
@@ -34,8 +34,8 @@ class CodeRunner extends runner("code") {
34
34
  }
35
35
  async tui(options, seed) {
36
36
  const [{ CodeAgent }, { CodeTui }] = await Promise.all([
37
- import("./CodeAgent-gtwn7tmb.js"),
38
- import("./CodeTui-v941fqdh.js")
37
+ import("./CodeAgent-23ewzxqa.js"),
38
+ import("./CodeTui-kc99fk78.js")
39
39
  ]);
40
40
  const agentOptions = await CodeRunner.#agentOptions(options, false);
41
41
  let resume = options.resume;
@@ -67,7 +67,7 @@ class CodeRunner extends runner("code") {
67
67
  }
68
68
  }
69
69
  async run(prompt, options) {
70
- const { CodeAgent } = await import("./CodeAgent-gtwn7tmb.js");
70
+ const { CodeAgent } = await import("./CodeAgent-23ewzxqa.js");
71
71
  const agent = await CodeAgent.create(await CodeRunner.#agentOptions(options, false));
72
72
  const printer = new CodeAgentStreamPrinter2({ json: options.json, thinking: options.thinking });
73
73
  agent.on((event) => printer.print(event));
@@ -2,28 +2,29 @@
2
2
  import {
3
3
  Workspace,
4
4
  command
5
- } from "./index-qmeh0s05.js";
5
+ } from "./index-00ke4phc.js";
6
6
  import"./index-52w0fvh8.js";
7
- import"./index-1e2955yd.js";
7
+ import"./index-921cxqrd.js";
8
8
  import"./index-hj6w4ka1.js";
9
- import"./index-pqdz7rat.js";
10
- import"./index-kr62ph5a.js";
11
- import"./index-pc9ps0hx.js";
12
- import"./index-2qzzp0c9.js";
13
- import"./index-8rvwgd1r.js";
9
+ import"./index-xjwcp91m.js";
10
+ import"./index-s4c2y5gs.js";
11
+ import"./index-9sa6abze.js";
12
+ import"./index-p2pahmsa.js";
13
+ import"./index-vq77g679.js";
14
14
  import"./index-m9jj544v.js";
15
- import"./index-yknrmkmt.js";
16
- import"./index-cz9g85xh.js";
15
+ import"./index-005dqc83.js";
16
+ import"./index-er16p89s.js";
17
17
  import"./index-zzvvc845.js";
18
- import"./index-wvvwdzfw.js";
19
- import"./index-ygy8c12j.js";
20
- import"./index-nmy1rana.js";
21
- import"./index-7abjzny1.js";
22
- import"./index-kbbyzs6j.js";
23
- import"./index-y5m4j2w6.js";
18
+ import"./index-4332q6yj.js";
19
+ import"./index-gxj80jz7.js";
20
+ import"./index-m54n0v29.js";
21
+ import"./index-ysyt782g.js";
22
+ import"./index-qx4r4cj2.js";
23
+ import"./index-vgt25eh1.js";
24
+ import"./index-rxse80x6.js";
24
25
  import {
25
26
  ContextScript
26
- } from "./index-jtydvvq7.js";
27
+ } from "./index-saj9cx3a.js";
27
28
 
28
29
  // pkgs/@akanjs/cli/context/context.command.ts
29
30
  class ContextCommand extends command("context", [ContextScript], ({ public: target }) => ({
@@ -0,0 +1,26 @@
1
+ // @bun
2
+ import {
3
+ ContextRunner2
4
+ } from "./index-9sa6abze.js";
5
+ import"./index-rxse80x6.js";
6
+ import"./index-qx4r4cj2.js";
7
+ import"./index-ysyt782g.js";
8
+ import"./index-vgt25eh1.js";
9
+ import"./index-4332q6yj.js";
10
+ import"./index-m54n0v29.js";
11
+ import"./index-gxj80jz7.js";
12
+ import"./index-vq77g679.js";
13
+ import"./index-p2pahmsa.js";
14
+ import"./index-m9jj544v.js";
15
+ import"./index-s4c2y5gs.js";
16
+ import"./index-xjwcp91m.js";
17
+ import"./index-zzvvc845.js";
18
+ import"./index-00ke4phc.js";
19
+ import"./index-005dqc83.js";
20
+ import"./index-er16p89s.js";
21
+ import"./index-921cxqrd.js";
22
+ import"./index-hj6w4ka1.js";
23
+ import"./index-52w0fvh8.js";
24
+ export {
25
+ ContextRunner2 as ContextRunner
26
+ };
@@ -2,9 +2,9 @@
2
2
  import {
3
3
  script,
4
4
  command
5
- } from "./index-qmeh0s05.js";
5
+ } from "./index-00ke4phc.js";
6
6
  import"./index-52w0fvh8.js";
7
- import"./index-1e2955yd.js";
7
+ import"./index-921cxqrd.js";
8
8
  import {
9
9
  Prompter2
10
10
  } from "./index-zzvvc845.js";
@@ -96,6 +96,9 @@ not "fix" it back.
96
96
  `st.tool(…).exec()` / `.card()`, `st.useState(…).init()`, `st.expose(…).value()` — behind `||` / `&&` / `??`, in a
97
97
  ternary, an `if`, a `switch`, a loop, a `catch`, a default value, an optional call or a callback; not after an early
98
98
  `return` or inside a helper the component calls. Read each into its own `const` at the top, then combine.
99
+ - **Never ask a list for more than 500 rows** (`no-oversized-list-limit`) — the server serves at most 500 per
100
+ request and drops the rest without an error, so `fetch.xListInY(0, 10000)` silently stops at row 500. Page with
101
+ skip/limit or `st.do.loadMoreOf<X>()` while `hasMoreOf<X>`, or compute the figure in an insight or an endpoint.
99
102
  - **No deep imports past a barrel**, except cross-module constants (`../map/map.constant`).
100
103
  - **Never import across the client/server boundary** (`apps/**`, `libs/**`). Client files (`ui/`, `webkit/`,
101
104
  `page/`, `*.store.ts`, every `.tsx`) never import a `*.document|dictionary|service|signal.ts`, `srvkit/`, a
@@ -119,6 +122,26 @@ not "fix" it back.
119
122
  discovery and aborts on a nested config); rename it `biome.jsonc` to document a disabled rule.
120
123
  - **`akan lint` prints up to 200 diagnostics** (`--max-diagnostics <n>`, `0` = all); Biome's own uncounted 20 reads
121
124
  as progress when the mix merely changed.
125
+ - **Size, store reach, where writes start, and per-item calls fail `akan lint`** for an app or lib, each failure
126
+ naming its rule and the `akan workflow plan …` path that fixes it:
127
+ - `akan.size.file`: a `Zone` / `Util` / `Template` / `Unit` / `View`, a `*.store.ts`, or a `ui/` / `webkit/` file
128
+ over 400 lines; a service or document over 500; an abstract over 300. `akan.size.component`: a component or hook
129
+ over 250. `akan.component.store-access`: a component or hook reaching `st` more than 16 times (form setters aside).
130
+ - `akan.write.placement`: a server write leaves the browser only through a store action, started by a module
131
+ component — no `fetch.<mutation>` outside a `*.store.ts`, and no writing `st.do.*` in `ui/` or `webkit/`, which
132
+ take the write as an `onX` prop or hook argument.
133
+ - `akan.store.multi-write`, `akan.store.root-write-chain`, `akan.component.write-chain`: a store action, a store
134
+ `static`, or one handler (a hook's included) sending two or more writes — directly, through a sibling action,
135
+ through another store via `RootStore`, or once per item in a loop or `map`. Make them one service method
136
+ (`this.transaction(fn)`, a side effect in `this.afterCommit(fn)`) behind one endpoint, taking the list, that the
137
+ action calls once.
138
+ - `akan.service.call-in-loop`: a service method an `endpoint` or `slice` reaches calling a service, a model or a
139
+ generated query once per item (`for … of`, `map`, `forEach`); load the set once (`load<Model>Many`, one
140
+ filter query) or write it once. An `internal` job and a counted loop (a retry, paging) are spared.
141
+ - `akan.baseline.json` records, per rule, the debt adopted with the gate, and is compared with its copy at the
142
+ fork point of the default branch, so it only ever shrinks: never add or raise an entry. A size, store-reach or
143
+ per-item entry with a `reasons` line is an exception a person decided on, never an agent; the write rules take
144
+ no exceptions.
122
145
 
123
146
  ## Coding Style (`**/*.{ts,tsx}`)
124
147
 
@@ -172,7 +195,9 @@ not "fix" it back.
172
195
  - **One suite per module file**: `<model>.<role>.test.ts` beside the file it covers — never topic splits
173
196
  (`chatMessage.trim.signal.test.ts`); add a `describe`. A suite spanning modules goes in `srvkit/`
174
197
  (`libs/shared/srvkit/guards.signal.test.ts`), never the `lib/` root; `akan sync` refuses all three shapes. Only
175
- `akan typecheck <app-or-lib>` typechecks tests (`bun:test` types included).
198
+ `akan typecheck <app-or-lib>` typechecks tests (`bun:test` types included) and the `script/` files nothing imports.
199
+ - Delete an export only tests reference together with its test (`akan quality scan` reports
200
+ `akan.global.test-only-export` in an app's `common/`, `webkit/`, `srvkit/`, `ui/`).
176
201
  - Import `UserAgent` / `AdminAgent` from `lib/user/user.signal.spec.ts`, the one place agent types are re-typed.
177
202
 
178
203
  ## Comments
@@ -182,7 +207,10 @@ Do not narrate code. Do document the thing the code cannot say. Both halves are
182
207
  - Never restate the identifier, the signature, or the control flow; prefer names and structure. No JSDoc, section
183
208
  banners, or "why/how" comments on ordinary logic.
184
209
  - Density tracks the layer: pages carry none, product `lib/` and `ui/` stay under 1 %, `srvkit/` adapters and
185
- `guards.ts` (what would leak without each guard) carry what the external constraints require.
210
+ `guards.ts` (what would leak without each guard) carry what the external constraints require. `akan quality scan`
211
+ reports a `lib/` module or `ui/` entry past 1 % once it holds five comment lines (`akan.comment.density`).
212
+ - Mark a retired field or function `/** @deprecated <what to use instead> */` on its declaration, never a
213
+ `// deprecated` comment — only the tag strikes through every use site.
186
214
  - Warranted for: a vendor or protocol quirk; an infrastructure constraint; a library gotcha; security reasoning; why
187
215
  an arbitrary-looking rule is correct; a math derivation; a domain field's business meaning; a state transition above
188
216
  a document chain method; why an obvious alternative was rejected.
@@ -260,6 +288,24 @@ Declared in `akan.config.ts`, narrowed — never widened — by an env at boot;
260
288
 
261
289
  ## React Components And Styling (`**/*.tsx`)
262
290
 
291
+ A screen that grows keeps five roles: an **assembly** `Zone` that reads the store and places pieces, with no
292
+ branching; **pieces** (`Unit`, `View`, small components) that only display, server-rendered where they can be; a
293
+ **kind table** `{ [kind in cnst.X["value"]]: Component }` instead of mode flags, so a new enum value without an entry
294
+ is a type error — each entry is a component of the module that owns that kind's data (a tab of video scenes is
295
+ `VideoScene.Zone.<X>`), so a screen spanning several models adds no folder; an **interaction hook**
296
+ `webkit/use<X>.tsx` over a pure, tested `common/<x>.ts` class for drag, selection and keys, handed its writes as
297
+ arguments; and **writes** as one-line store actions, one endpoint each. Kinds a screen invents rather than a model
298
+ (canvas node kinds) key the table by an `as const` union in `common/`. A screen choosing along two axes (what to
299
+ pick, and where the pick lands) keeps two tables, the second mapping each purpose to its one commit action. State
300
+ several components or an agent tool read stays in the store, where `st.tool` sees it; the hook keeps only gesture
301
+ state. Reach for the path, not the nearest file:
302
+
303
+ | Task | Path |
304
+ |---|---|
305
+ | A state-changing act, or chained writes in an action or handler | `akan workflow plan add-mutation --app <app> --module <m> --mutation <verbModel> --guard <Guard>[,…] [--with <ref>.<method>] [--after <ref>.<method>]` |
306
+ | Event, keyboard, pointer or layout logic growing in a component | `akan workflow plan create-interaction --app <app> --interaction <name>` |
307
+ | A missing `View` / `Unit` / `Template` / `Zone` / `Util` | `akan workflow plan create-ui --app <app> --module <m> --surface <surface>` |
308
+
263
309
  - `export const X = ({ … }: XProps) => { return (…); };` — `export default` only for pages, layouts, `lazy()`
264
310
  targets. No `React.FC`, `defaultProps`, `PropsWithChildren`; defaults in the destructuring, `children: ReactNode`.
265
311
  - `cond ? <X/> : null`, never `{cond && <X/>}` (renders `"false"` in a `className`); early `return null` only for
@@ -520,14 +566,14 @@ export default page()
520
566
 
521
567
  ## Akan Sync Conventions (`apps/**`, `libs/**`)
522
568
 
523
- - App root files: `AGENTS.md`, `CLAUDE.md`, `akan.app.json`, `akan.config.ts`, `client.ts`, `main.ts`,
524
- `package.json`, `server.ts`, `tsconfig.json`, `tsconfig.tsbuildinfo`; folders: `.akan`, `common`, `env`, `lib`,
525
- `native`, `page`, `plugin`, `private`, `public`, `script`, `secrets`, `srvkit`, `ui`, `webkit`. A Capacitor-era
569
+ - App root files: `AGENTS.md`, `CLAUDE.md`, `akan.app.json`, `akan.baseline.json`, `akan.config.ts`, `client.ts`,
570
+ `main.ts`, `package.json`, `server.ts`, `tsconfig.json`, `tsconfig.tsbuildinfo`; folders: `.akan`, `common`, `env`,
571
+ `lib`, `native`, `page`, `plugin`, `private`, `public`, `script`, `secrets`, `srvkit`, `ui`, `webkit`. A Capacitor-era
526
572
  `ios` / `android` / `mobile` folder or `capacitor.config.*` in an app root is refused as a leftover (native
527
573
  projects live under `dist/native/<app>/<target>`).
528
- - Lib root files: `AGENTS.md`, `CLAUDE.md`, `README.md`, `akan.config.ts`, `akan.lib.json`, `client.ts`, `index.ts`,
529
- `package.json`, `server.ts`, `tsconfig.json`, `tsconfig.spec.json`, `tsconfig.tsbuildinfo`; folders: the app's
530
- minus `.akan`, `script`, `secrets` (no `main.ts` either — a lib is never booted).
574
+ - Lib root files: `AGENTS.md`, `CLAUDE.md`, `README.md`, `akan.baseline.json`, `akan.config.ts`, `akan.lib.json`,
575
+ `client.ts`, `index.ts`, `package.json`, `server.ts`, `tsconfig.json`, `tsconfig.spec.json`, `tsconfig.tsbuildinfo`;
576
+ folders: the app's minus `.akan`, `script`, `secrets` (no `main.ts` either — a lib is never booted).
531
577
  - The allowlists' one source is `pkgs/@akanjs/devkit/workspaceLayout.ts`, read by `akan sync` (error), `akan doctor`
532
578
  and `akan quality scan` — add an entry there and mirror it here.
533
579
  - `apps/<app>/AGENTS.md` / `libs/<lib>/AGENTS.md` carry a generated `## Recipes In Scope` block between the
@@ -558,9 +604,9 @@ export default page()
558
604
  | Folder | Admission test | Naming |
559
605
  |---|---|---|
560
606
  | `common/` | pure, isomorphic, zero-dependency; imports only sibling `common/*` and `akanjs/base` (so no `Err`, and no throwing code) | camelCase file named after its single export |
561
- | `webkit/` | touches `window` / `navigator` / the native bridge (`akanjs/client/native[/<plugin id>]`), or is a React hook | `use<Thing>.tsx`, `.tsx` even without JSX |
607
+ | `webkit/` | touches `window` / `navigator` / the native bridge (`akanjs/client/native[/<plugin id>]`), or is a React hook; sends no server write | `use<Thing>.tsx`, `.tsx` even without JSX |
562
608
  | `srvkit/` | touches `node:*`, `Bun`, `process.env`, a secret, or a server SDK | camelCase file, PascalCase class |
563
- | `ui/` | renders JSX or defines a look (`Recipe/`, a lib's `tokens.css`), not bound to one model | PascalCase component, camelCase sidecar, `Recipe/<name>.ts` |
609
+ | `ui/` | renders JSX or defines a look (`Recipe/`, a lib's `tokens.css`), not bound to one model; sends no server write | PascalCase component, camelCase sidecar, `Recipe/<name>.ts` |
564
610
  | `plugin/` | a build- or CLI-time `AkanPlugin` | `<name>.plugin.ts`, registered in `akan.config.ts` |
565
611
  | `native/` | a native plugin the app or lib owns — its page API reached only through a `webkit/` hook (`runtimeRule`) | `native/<id>/` |
566
612
 
@@ -8,7 +8,7 @@ import {
8
8
  CodegenLock,
9
9
  WorkspaceExecutor,
10
10
  AppExecutor
11
- } from "./index-1e2955yd.js";
11
+ } from "./index-921cxqrd.js";
12
12
  import"./index-52w0fvh8.js";
13
13
  import {
14
14
  GraphClientEntryDiscovery,
@@ -19,10 +19,10 @@ import {
19
19
  DevChangePlanner,
20
20
  DevGeneratedIndexSync,
21
21
  SsrDevBundler
22
- } from "./index-8jb5ep2e.js";
22
+ } from "./index-97fsvy66.js";
23
23
  import {
24
24
  ServerGraphFile
25
- } from "./index-cz9g85xh.js";
25
+ } from "./index-er16p89s.js";
26
26
  import {
27
27
  prepareDevWatchBatch
28
28
  } from "./index-a5vmm6x4.js";
@@ -1,13 +1,13 @@
1
1
  // @bun
2
2
  import {
3
3
  resolveSsrPageEntriesForApp
4
- } from "./index-1e2955yd.js";
4
+ } from "./index-921cxqrd.js";
5
5
  import {
6
6
  bundleDefine,
7
7
  CsrEntryFiles,
8
8
  PagesEntrySourceGenerator,
9
9
  PagesBundleBuilder
10
- } from "./index-cz9g85xh.js";
10
+ } from "./index-er16p89s.js";
11
11
 
12
12
  // pkgs/@akanjs/devkit/frontendBuild/csrArtifactBuilder.ts
13
13
  import { mkdir as mkdir2, rm as rm2, unlink as unlink2 } from "fs/promises";
@@ -10,7 +10,7 @@ import {
10
10
  LibExecutor,
11
11
  PkgExecutor,
12
12
  ModuleExecutor
13
- } from "./index-1e2955yd.js";
13
+ } from "./index-921cxqrd.js";
14
14
 
15
15
  // pkgs/@akanjs/devkit/commandDecorators/camelToKebabCase.ts
16
16
  var camelToKebabCase = (str) => str.replace(/([A-Z])/g, "-$1").toLowerCase();
@@ -857,4 +857,4 @@ function command(refName, depsOrBuilder, builder) {
857
857
  }
858
858
  return CommandBase;
859
859
  }
860
- export { getTargetMetas, getTargetCommandNames, App, Apps, Lib, Sys, SysOrOnlyApp, Exec, Pkg, Module, Workspace, CommandContainer, runner, script, ExitCodeError, markCliErrorPrinted, assertPromptable, runCommands, command };
860
+ export { camelToKebabCase, getTargetMetas, getTargetCommandNames, App, Apps, Lib, Sys, SysOrOnlyApp, Exec, Pkg, Module, Workspace, CommandContainer, runner, script, ExitCodeError, markCliErrorPrinted, assertPromptable, runCommands, command };
@@ -2,13 +2,13 @@
2
2
  import {
3
3
  runner,
4
4
  script
5
- } from "./index-qmeh0s05.js";
5
+ } from "./index-00ke4phc.js";
6
6
  import {
7
7
  FileSys2
8
8
  } from "./index-52w0fvh8.js";
9
9
  import {
10
10
  PkgExecutor
11
- } from "./index-1e2955yd.js";
11
+ } from "./index-921cxqrd.js";
12
12
  import {
13
13
  TypeScriptDependencyScanner2
14
14
  } from "./index-tvehn2sp.js";
@@ -2,13 +2,13 @@
2
2
  import {
3
3
  runner,
4
4
  script
5
- } from "./index-qmeh0s05.js";
5
+ } from "./index-00ke4phc.js";
6
6
  import {
7
7
  LibSource,
8
8
  formatLibStatuses,
9
9
  CommandExecutionError,
10
10
  LibExecutor
11
- } from "./index-1e2955yd.js";
11
+ } from "./index-921cxqrd.js";
12
12
 
13
13
  // pkgs/@akanjs/cli/library/library.script.ts
14
14
  import { Logger } from "akanjs/common";
@@ -5,13 +5,13 @@ import {
5
5
  writeGeneratedSyncState,
6
6
  createRepairReport,
7
7
  renderRepairReport
8
- } from "./index-pqdz7rat.js";
8
+ } from "./index-xjwcp91m.js";
9
9
  import {
10
10
  AkanContextAnalyzer
11
- } from "./index-kr62ph5a.js";
11
+ } from "./index-s4c2y5gs.js";
12
12
  import {
13
13
  runner
14
- } from "./index-qmeh0s05.js";
14
+ } from "./index-00ke4phc.js";
15
15
 
16
16
  // pkgs/@akanjs/cli/repair/repair.runner.ts
17
17
  var spawnShell = async (workspace, command) => await workspace.spawn("bash", ["-lc", command.startsWith("akan ") ? `bun run ${command}` : command], {
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  runner,
4
4
  script
5
- } from "./index-qmeh0s05.js";
5
+ } from "./index-00ke4phc.js";
6
6
  import {
7
7
  AGENT_BLOCK_START,
8
8
  AGENT_BLOCK_END,
@@ -13,14 +13,14 @@ import {
13
13
  CLAUDE_COMMENT_RULE,
14
14
  AppExecutor,
15
15
  LibExecutor
16
- } from "./index-1e2955yd.js";
16
+ } from "./index-921cxqrd.js";
17
17
  import {
18
18
  collectRecipeSources2,
19
19
  scanRecipes2
20
20
  } from "./index-hj6w4ka1.js";
21
21
  import {
22
22
  AkanContextAnalyzer
23
- } from "./index-kr62ph5a.js";
23
+ } from "./index-s4c2y5gs.js";
24
24
  import {
25
25
  Prompter2
26
26
  } from "./index-zzvvc845.js";