@akanjs/cli 3.2.0-rc.17 → 3.2.0-rc.19

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 (94) hide show
  1. package/.build-stamp +2 -2
  2. package/{CodeAgent-18qg03re.js → CodeAgent-q0xkt4at.js} +2 -2
  3. package/{CodeTui-zkm51zf3.js → CodeTui-n56kpaca.js} +819 -663
  4. package/TunnelShare-844s9te4.js +18 -0
  5. package/{agent.command-5k2zegmj.js → agent.command-k07raqft.js} +20 -20
  6. package/akanCode.js +8 -8
  7. package/{appExecutor-1bgs9a69.js → appExecutor-xav1zemr.js} +3 -3
  8. package/{application.command-ge27047n.js → application.command-dv8y8r12.js} +52 -25
  9. package/{applicationBuildRunner-7skfg8zn.js → applicationBuildRunner-vhx7zq97.js} +9 -10
  10. package/buildBatch.proc.js +20 -11
  11. package/{cloud.command-d18qj1v2.js → cloud.command-0vjy3x96.js} +22 -22
  12. package/cloud.script-jp48r0kw.js +35 -0
  13. package/{code.command-tz4x5zm6.js → code.command-xc5exq4b.js} +10 -10
  14. package/{context.command-x1smtm5q.js → context.command-etsat8yk.js} +22 -22
  15. package/context.runner-e52ak0cx.js +34 -0
  16. package/{guideline.command-rdcwxf8g.js → guideline.command-zqkntk7b.js} +6 -6
  17. package/guidelines/agentRule/agentRule.instruction.md +5 -4
  18. package/guidelines/conventions/core.md +18 -0
  19. package/guidelines/errorCodes/errorCodes.instruction.md +6 -0
  20. package/guidelines/mcpRule/mcpRule.instruction.md +4 -2
  21. package/guidelines/transportRule/transportRule.instruction.md +3 -1
  22. package/incrementalBuilder.proc.js +559 -409
  23. package/{index-gh4brxzn.js → index-12js5pj4.js} +1 -1
  24. package/{index-jfkh776h.js → index-12vv4g80.js} +1 -1
  25. package/index-4zqebbqb.js +80 -0
  26. package/{index-er2ja34m.js → index-6bryy19d.js} +500 -422
  27. package/{index-3641r8q0.js → index-6pzncry1.js} +4 -4
  28. package/{index-fcrr79gh.js → index-6rrh0ffr.js} +44 -32
  29. package/{index-nd39rssn.js → index-7jr9mfp2.js} +286 -144
  30. package/{index-sp331bww.js → index-81qt1jyj.js} +1 -1
  31. package/{index-2mrn1mrg.js → index-9f3reh2y.js} +1 -1
  32. package/{index-e82xwj3x.js → index-a05ewnnp.js} +1 -1
  33. package/{index-bjnebzzc.js → index-bxevbjw7.js} +8 -8
  34. package/{index-vm6pr11y.js → index-c1vym3gx.js} +2 -2
  35. package/{index-t8tysbxv.js → index-c9hd79py.js} +4 -4
  36. package/{index-j2eqe3jk.js → index-c9mnfy9r.js} +38 -23
  37. package/{index-dtpeyts6.js → index-cc9pevta.js} +1 -1
  38. package/{index-trp7jdr1.js → index-cet2s7xk.js} +7 -6
  39. package/{index-yr5jv8yd.js → index-dasa0kbj.js} +3 -3
  40. package/{index-bxqbt5p3.js → index-ddc2zjj5.js} +1 -1
  41. package/{index-g7e58wz2.js → index-dz7z9n9t.js} +25 -25
  42. package/{index-z7t6neq1.js → index-e4vna9dn.js} +4 -4
  43. package/{index-669sg3yp.js → index-ean2tff1.js} +723 -691
  44. package/{index-ttfz2sc7.js → index-fgp04fh7.js} +6 -6
  45. package/{index-bzdq8wfw.js → index-g541mhzw.js} +3 -3
  46. package/{index-t329y8am.js → index-gh741qft.js} +8 -8
  47. package/{index-d2r762fk.js → index-k51718xz.js} +2136 -2175
  48. package/{index-39byv35b.js → index-m6r3pvf5.js} +2 -2
  49. package/{index-emf3wzvh.js → index-my17308p.js} +7 -7
  50. package/{index-xywq95wk.js → index-nd8bq17n.js} +6 -6
  51. package/{index-q4e18ne4.js → index-nxcmgqk3.js} +3 -3
  52. package/{index-b2sptt87.js → index-pkgha3rt.js} +5 -5
  53. package/{index-s75h0455.js → index-q2t2w996.js} +1 -1
  54. package/{index-6p02be7n.js → index-qtqhsb33.js} +204 -160
  55. package/{index-h7yd92c8.js → index-rj2n5kfk.js} +67 -67
  56. package/{index-1ts8vfsk.js → index-s5gvwvkb.js} +103 -138
  57. package/{index-neassptx.js → index-sh3yzse2.js} +8 -7
  58. package/{index-f482h2hj.js → index-syn4vm3y.js} +1 -1
  59. package/{index-n8mxyy3f.js → index-t00xrkey.js} +1 -1
  60. package/{index-g56xae1n.js → index-v72mh89f.js} +7 -8
  61. package/{index-q57rsax4.js → index-wq8pnev4.js} +3 -3
  62. package/{index-dp7sht3v.js → index-wxr3941g.js} +8 -8
  63. package/{index-0c8zj1da.js → index-y8mqkhcf.js} +1 -1
  64. package/{index-9mx3b3zh.js → index-zk1gjk46.js} +4 -4
  65. package/index.js +27 -27
  66. package/{libExecutor-hxe5eqfh.js → libExecutor-mr3vxtnr.js} +2 -2
  67. package/{library.command-83shs8fw.js → library.command-ps9q5t37.js} +7 -7
  68. package/{localRegistry.command-sz713jg3.js → localRegistry.command-rszxmvd0.js} +21 -21
  69. package/{module.command-jhhm0nmw.js → module.command-fcybnn1a.js} +10 -10
  70. package/{package.command-42syy96v.js → package.command-zen3rhye.js} +10 -10
  71. package/package.json +2 -2
  72. package/{page.command-jkv29zzs.js → page.command-gwrxymms.js} +7 -7
  73. package/{pipeline.command-6sg9g4hq.js → pipeline.command-m1brkqqw.js} +6 -6
  74. package/{pkgExecutor-6p82w5y1.js → pkgExecutor-x51agavp.js} +2 -2
  75. package/{primitive.command-tt6aq7m9.js → primitive.command-5vkxvvmk.js} +11 -11
  76. package/{projectTypecheck-wfrz0cxr.js → projectTypecheck-9dzfah37.js} +1 -1
  77. package/{quality.command-tqar7ss5.js → quality.command-gqry7eas.js} +9 -9
  78. package/{repair.command-qkcn329t.js → repair.command-qs4ejcrg.js} +10 -10
  79. package/{routeSourceValidator-8aph1dsr.js → routeSourceValidator-8n6j1vn7.js} +3 -1
  80. package/{scalar.command-6nvq11ag.js → scalar.command-ny0vchqq.js} +9 -9
  81. package/skills/akan-scaffold/SKILL.md +1 -1
  82. package/{subspace.command-dvwds4cv.js → subspace.command-5pxqjgmw.js} +12 -12
  83. package/templates/biomeForm.ts +1 -1
  84. package/templates/env/_env.server.type.ts +1 -1
  85. package/templates/facetIndex/index.ts +2 -37
  86. package/templates/workspaceRoot/AGENTS.md.template +2 -1
  87. package/{tunnel.command-h8r69a7v.js → tunnel.command-ndajt0xk.js} +11 -11
  88. package/{verify.command-ynec8kt2.js → verify.command-m59ashc7.js} +17 -17
  89. package/{workflow.command-f70fx73a.js → workflow.command-jchqey88.js} +15 -15
  90. package/{workspace.command-vagjy1q9.js → workspace.command-g0gzxkpd.js} +36 -36
  91. package/TunnelShare-6t4rwyc0.js +0 -19
  92. package/cloud.script-0hbhm3mw.js +0 -35
  93. package/context.runner-vb7jc0k8.js +0 -34
  94. package/index-dqsc1b5t.js +0 -18
@@ -0,0 +1,34 @@
1
+ // @bun
2
+ import {
3
+ ContextRunner2
4
+ } from "./index-qtqhsb33.js";
5
+ import"./index-gh741qft.js";
6
+ import"./index-g541mhzw.js";
7
+ import"./index-m6r3pvf5.js";
8
+ import"./index-dz7z9n9t.js";
9
+ import"./index-bxevbjw7.js";
10
+ import"./index-a05ewnnp.js";
11
+ import"./index-t4d0ckde.js";
12
+ import"./index-6bryy19d.js";
13
+ import"./index-12vv4g80.js";
14
+ import"./index-ean2tff1.js";
15
+ import"./index-wq8pnev4.js";
16
+ import"./index-m9jj544v.js";
17
+ import"./index-89x8tp7z.js";
18
+ import"./index-sh3yzse2.js";
19
+ import"./index-81qt1jyj.js";
20
+ import"./index-zyb0ebm4.js";
21
+ import"./index-7jr9mfp2.js";
22
+ import"./index-dasa0kbj.js";
23
+ import"./index-rj2n5kfk.js";
24
+ import"./index-4zqebbqb.js";
25
+ import"./index-cet2s7xk.js";
26
+ import"./index-t00xrkey.js";
27
+ import"./index-cc9pevta.js";
28
+ import"./index-v72mh89f.js";
29
+ import"./index-j4yvgfhr.js";
30
+ import"./index-1p81ecbz.js";
31
+ import"./index-by2tvsq6.js";
32
+ export {
33
+ ContextRunner2 as ContextRunner
34
+ };
@@ -2,17 +2,17 @@
2
2
  import {
3
3
  script,
4
4
  command
5
- } from "./index-neassptx.js";
5
+ } from "./index-sh3yzse2.js";
6
6
  import"./index-j4yvgfhr.js";
7
- import"./index-g56xae1n.js";
7
+ import"./index-v72mh89f.js";
8
8
  import"./index-by2tvsq6.js";
9
- import"./index-trp7jdr1.js";
10
- import"./index-n8mxyy3f.js";
11
- import"./index-dtpeyts6.js";
9
+ import"./index-cet2s7xk.js";
10
+ import"./index-t00xrkey.js";
11
+ import"./index-cc9pevta.js";
12
12
  import {
13
13
  Prompter2
14
14
  } from "./index-89x8tp7z.js";
15
- import"./index-dqsc1b5t.js";
15
+ import"./index-4zqebbqb.js";
16
16
 
17
17
  // pkgs/@akanjs/cli/guideline/guideline.script.ts
18
18
  import { Logger } from "akanjs/common";
@@ -643,10 +643,11 @@ pages declaring one name never clash, and a registry kept outside the surface re
643
643
  `text` and drops it; `AgentService.explained` folds it into the text before any adaptor sees it, because an
644
644
  assistant turn that says nothing is one the model repeats.
645
645
  - **A failed turn keeps its code for the host.** The relay's `error` event carries `code`: the `Err`'s key, else
646
- an `AkanError`'s own code, else the status's name. A refusal (401/403) is named by its status alone, whether it is
647
- answered before the stream opens or inside it, unless the server kept it under its own code. The chat keeps it
648
- on that assistant message as `errorCode` after translating the text, so a host branches on `message.errorCode`,
649
- never on the sentence. It is never sent back to the relay.
646
+ an `AkanError`'s own code when its JSON carries it, else the status's name, so a custom `toJSON()` keeps `code`
647
+ in what it returns or the failure reads as its status. It is one code whether the failure is answered before the
648
+ stream opens or inside it, a 5xx included. A refusal (401/403) is named by its status alone, unless the server
649
+ kept it under its own code. The chat keeps it on that assistant message as `errorCode` after translating the
650
+ text, so a host branches on `message.errorCode`, never on the sentence. It is never sent back to the relay.
650
651
  - **↑ and ↓ in the composer walk what was sent**, seeded from the transcript so a persisted chat does not lose
651
652
  only what was just typed. A single-line input has nothing of its own on the vertical arrows, and the
652
653
  half-written draft they were walked away from comes back at the bottom of the walk. **The `/` menu takes those
@@ -30,6 +30,24 @@ and infrastructure. A workspace is Bun-first: `apps/<app>` holds pages, domain m
30
30
  - Follow the nearest established pattern; when two shapes disagree, follow the newer neighbour. A new abstraction must
31
31
  remove real duplication — near-identical sibling modules are copied with changed literals, not parameterised.
32
32
 
33
+ ## Finishing Work
34
+
35
+ - Carry the task through to `verify ok`. A failing check, a stale generated file, a stopped dev server or a tool
36
+ error is an ordinary obstacle: diagnose it and work through it (`akan sync`, `akan repair generated`, a retry,
37
+ another command) rather than stopping to report it or offering to continue. Silencing a check is not a way through.
38
+ - Routine steps need no confirmation: reading code, `akan sync`, `akan verify`, `akan test`, `akan preview`, and the
39
+ workflow plan and apply the task calls for. Ask only when the work cannot go on without the answer, and keep doing
40
+ the parts that do not depend on it.
41
+ - A deliberate blocker stays put — another person's change in a dirty tree, an `akan.baseline.json` entry, a secret
42
+ you cannot read, a failure outside what you changed: leave it, say what you found, and finish the rest. Confirm
43
+ before a step that is hard to undo or leaves this machine, such as a push, a deploy or a write to a shared database.
44
+
45
+ ## Reporting
46
+
47
+ Write the final message for a reader who did not watch your tool calls. Lead with the outcome, name every file you
48
+ changed (small edits too), give each check's own result line, and say what you left undone or could not check, and
49
+ why. Use plain words, not labels you coined during the work.
50
+
33
51
  ## Looks Wrong, Is Right — Do Not "Fix"
34
52
 
35
53
  - Tailwind class order (`font-bold text-2xl text-foreground`) — Biome sorts it, `cn()` arguments included.
@@ -22,11 +22,14 @@ Generated from the akanjs sources of this release: every code a framework error
22
22
  | `badRequest` | 400 | `Exception.BadRequest` | yes | no | `signal/exception.ts` |
23
23
  | `badRequest` | 400 | `ImageOptimizerError` | no | yes | `server/imageOptimizerError.ts` |
24
24
  | `baseMismatch` | 500 | `SignalDeclarationError` | no | yes | `signal/signalDeclarationError.ts` |
25
+ | `buildFailed` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
26
+ | `builderUnavailable` | 503 | `AkanError` | no | yes | `base/akanError.ts` |
25
27
  | `bytesThroughAny` | 500 | `SignalContractError` | no | yes | `signal/signalContractError.ts` |
26
28
  | `clientComponentOnServer` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
27
29
  | `compressorNotInitialized` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
28
30
  | `conflict` | 409 | `Exception.Conflict` | yes | no | `signal/exception.ts` |
29
31
  | `consoleDisabled` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
32
+ | `databaseLocked` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
30
33
  | `desktopAppRequired` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
31
34
  | `documentNotFound` | 404 | `NoDocumentError` | yes | no | `document/noDocumentError.ts` |
32
35
  | `failed` | 500 | `MigrationError` | no | yes | `server/migration/migrationError.ts` |
@@ -63,6 +66,8 @@ Generated from the akanjs sources of this release: every code a framework error
63
66
  | `invalidSignal` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
64
67
  | `invalidStorageKey` | 400 | `AkanError` | no | yes | `base/akanError.ts` |
65
68
  | `ipcRequired` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
69
+ | `jobStalled` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
70
+ | `listFailed` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
66
71
  | `liveAlreadySet` | 500 | `SignalDeclarationError` | no | yes | `signal/signalDeclarationError.ts` |
67
72
  | `livePaused` | 409 | `AkanError` | no | yes | `base/akanError.ts` |
68
73
  | `liveRoomTaken` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
@@ -105,6 +110,7 @@ Generated from the akanjs sources of this release: every code a framework error
105
110
  | `transferUnsupported` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
106
111
  | `unauthorized` | 401 | `Exception.Unauthorized` | yes | no | `signal/exception.ts` |
107
112
  | `undefinedReturn` | 500 | `SignalContractError` | no | yes | `signal/signalContractError.ts` |
113
+ | `unencodableValue` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
108
114
  | `unguardedEndpoint` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
109
115
  | `unmaskedResource` | 500 | `PromptError` | no | yes | `signal/mcp/promptError.ts` |
110
116
  | `unroutableLiveQuery` | 500 | `AkanError` | no | yes | `base/akanError.ts` |
@@ -260,8 +260,10 @@ export default page()
260
260
  refusal, beside `tooManyRequests` and `internalError`. The code is the one an HTTP caller gets: a domain `Err`'s
261
261
  dictionary key (what `Err.is` matches), else the `AkanError`'s own code; a guard's 401 or 403 by its status alone
262
262
  (`unauthorized`, `forbidden`), since a guard's own code names its rule as its message does; a crash, or a 5xx whose
263
- code this server did not name, by its status (`internalError`). A code is a bounded key or camelCase token, never
264
- prose. No host hands `_meta` to the model, so what the model must act on belongs in the dictionary sentence.
263
+ answer names no bounded code, by its status (`internalError`). A 5xx's text is redacted but its code token is not,
264
+ and it comes from the error's own JSON when that carries one, which can be a third-party library's. A code is a
265
+ bounded key or camelCase token, never prose. No host hands `_meta` to the model, so what the model must act on
266
+ belongs in the dictionary sentence.
265
267
  - **Three revisions are spoken**: the modern `2026-07-28` and the legacy `2025-11-25` / `2025-06-18`, which are
266
268
  wire-identical over the POST-only surface this implements — a client whose proposal is not listed is told to
267
269
  disconnect. An unknown proposal is answered at whichever end of that list it is closer to, and an unimplemented
@@ -57,7 +57,9 @@ HTTP verb a mutation is mounted under. `conventions` carries the invariants —
57
57
  each room delivers (`seq`); a client drops a repeat, and a hole — a frame dropped under backpressure — calls the
58
58
  room's `onResync`. A resubscribe names its last frame (`since`): a server that saw every publish (a solo process)
59
59
  replays what followed it ahead of the ack, and otherwise answers a gap, which calls `onResync` as before. Binary
60
- rooms are not numbered.
60
+ rooms are not numbered. A server on Redis whose link to the app's other servers drops and returns sends each room a
61
+ `resync` frame once Redis hands it the room's events again, which calls `onResync` too (a live room refetches
62
+ instead), since what other servers published meanwhile never reached it.
61
63
  - **A cleanup registered with `ws.on("disconnect" | "unsubscribe", fn)` is scoped to the call that registered it.**
62
64
  From a `pubsub` subscribe it belongs to that room — `unsubscribe` runs when the client leaves it or a credential
63
65
  change revokes it, `disconnect` when the socket closes while still subscribed — so a room already left runs