@akanjs/cli 3.0.0-alpha.13 → 3.0.0-alpha.15

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 (41) hide show
  1. package/.build-stamp +1 -1
  2. package/{agent.command-a3n15c6t.js → agent.command-h6tc0pzh.js} +5 -5
  3. package/{application.command-16bzjsam.js → application.command-kphnfwyg.js} +4 -4
  4. package/buildBatch.proc.js +1 -1
  5. package/{capacitorApp-mr81qdxq.js → capacitorApp-9ejk3k7q.js} +2 -2
  6. package/{cloud.command-f6t115qw.js → cloud.command-zn6mfscb.js} +7 -7
  7. package/{context.command-ysxawe7h.js → context.command-pkbccyys.js} +12 -12
  8. package/{guideline.command-yqf9a372.js → guideline.command-0jj2k77g.js} +2 -2
  9. package/incrementalBuilder.proc.js +1 -1
  10. package/{index-yzsxc30b.js → index-1twehz1x.js} +25 -3
  11. package/{index-yzmqvg23.js → index-4agbdds8.js} +3 -3
  12. package/{index-m90fn8xe.js → index-4v0wvt37.js} +4 -4
  13. package/{index-z1s5f4e0.js → index-7ecpft60.js} +6 -3
  14. package/{index-4mgkgba3.js → index-8d9r0df5.js} +2 -2
  15. package/{index-mt3nkbpt.js → index-96vpa123.js} +3 -3
  16. package/{index-kcsa1zff.js → index-9s991k9v.js} +1 -1
  17. package/{index-mewacxye.js → index-aak9cctp.js} +4 -4
  18. package/{index-3789fdpg.js → index-b9m84bjp.js} +10 -10
  19. package/{index-etwh7sd3.js → index-bkwnr08k.js} +1 -1
  20. package/{index-e4b2ae6b.js → index-djh5gpb7.js} +2 -2
  21. package/{index-xzkynk9f.js → index-g3brq942.js} +5 -5
  22. package/{index-65aeh789.js → index-gyvrhtpm.js} +1 -1
  23. package/{index-9va8zayb.js → index-gz91pc3p.js} +1 -1
  24. package/{index-8pd02prk.js → index-p42te6qb.js} +3 -3
  25. package/{index-1az48fvn.js → index-rv16ck4r.js} +4 -4
  26. package/{index-cv9cxs5k.js → index-w7farjxd.js} +3 -3
  27. package/{index-h5whaj26.js → index-xwfkgss0.js} +2 -2
  28. package/index.js +18 -18
  29. package/{library.command-x6t29a30.js → library.command-wbptp6q3.js} +3 -3
  30. package/{localRegistry.command-3jssedmy.js → localRegistry.command-6ea3pgq0.js} +6 -6
  31. package/{module.command-8w8ys5t3.js → module.command-ghkf919z.js} +5 -5
  32. package/{package.command-zgy7f3fz.js → package.command-ph2m34tv.js} +3 -3
  33. package/package.json +2 -2
  34. package/{page.command-yjmnkyk2.js → page.command-atnzfn88.js} +3 -3
  35. package/{primitive.command-gfqaagsg.js → primitive.command-7qbdhfc2.js} +6 -6
  36. package/{quality.command-ec8r1dn3.js → quality.command-1ff2xcra.js} +2 -2
  37. package/{repair.command-p9ey6mkm.js → repair.command-weakn0yr.js} +5 -5
  38. package/{scalar.command-9dhmqhtm.js → scalar.command-xdjhvsgb.js} +4 -4
  39. package/templates/workspaceRoot/CLAUDE.md.template +19 -0
  40. package/{workflow.command-ycwc6zr6.js → workflow.command-msm2tjee.js} +9 -9
  41. package/{workspace.command-bqchx18r.js → workspace.command-gr8z82z9.js} +18 -18
package/.build-stamp CHANGED
@@ -1 +1 @@
1
- 0c2560c17e7c39a0ab1a6f08e27af58e63e9598a265c90e5d65e943b82db95c9
1
+ 714e226e4dda771d192ec7f6f9b947d03b5556e07bb7303ac02e0287c2e03d53
@@ -1,15 +1,15 @@
1
1
  // @bun
2
2
  import {
3
3
  AgentScript
4
- } from "./index-z1s5f4e0.js";
5
- import"./index-e4b2ae6b.js";
6
- import"./index-kcsa1zff.js";
4
+ } from "./index-7ecpft60.js";
5
+ import"./index-djh5gpb7.js";
6
+ import"./index-9s991k9v.js";
7
7
  import"./index-j37qq1f2.js";
8
8
  import {
9
9
  Workspace,
10
10
  command
11
- } from "./index-etwh7sd3.js";
12
- import"./index-yzsxc30b.js";
11
+ } from "./index-bkwnr08k.js";
12
+ import"./index-1twehz1x.js";
13
13
  import"./index-mxvakhsm.js";
14
14
  import"./index-xys926f2.js";
15
15
  import"./index-1577bej2.js";
@@ -4,8 +4,8 @@ import {
4
4
  } from "./index-0wae5ebk.js";
5
5
  import {
6
6
  ApplicationScript
7
- } from "./index-1az48fvn.js";
8
- import"./index-8pd02prk.js";
7
+ } from "./index-rv16ck4r.js";
8
+ import"./index-p42te6qb.js";
9
9
  import {
10
10
  getMobileTargetChoices
11
11
  } from "./index-76rn3g2c.js";
@@ -15,10 +15,10 @@ import {
15
15
  Sys,
16
16
  Workspace,
17
17
  command
18
- } from "./index-etwh7sd3.js";
18
+ } from "./index-bkwnr08k.js";
19
19
  import"./index-fgc8r6dj.js";
20
20
  import"./index-bjpxzr6s.js";
21
- import"./index-yzsxc30b.js";
21
+ import"./index-1twehz1x.js";
22
22
  import"./index-mxvakhsm.js";
23
23
  import"./index-1577bej2.js";
24
24
  import"./index-67546d0j.js";
@@ -12,7 +12,7 @@ import"./index-bjpxzr6s.js";
12
12
  import {
13
13
  AppExecutor,
14
14
  WorkspaceExecutor
15
- } from "./index-yzsxc30b.js";
15
+ } from "./index-1twehz1x.js";
16
16
  import"./index-mxvakhsm.js";
17
17
  import"./index-1577bej2.js";
18
18
  import"./index-67546d0j.js";
@@ -25,9 +25,9 @@ import {
25
25
  selectLocalDevHost,
26
26
  sortIosRunTargets,
27
27
  writeRootCapacitorConfig
28
- } from "./index-9va8zayb.js";
28
+ } from "./index-gz91pc3p.js";
29
29
  import"./index-76rn3g2c.js";
30
- import"./index-yzsxc30b.js";
30
+ import"./index-1twehz1x.js";
31
31
  import"./index-mxvakhsm.js";
32
32
  import"./index-1577bej2.js";
33
33
  import"./index-67546d0j.js";
@@ -1,22 +1,22 @@
1
1
  // @bun
2
2
  import {
3
3
  CloudScript
4
- } from "./index-xzkynk9f.js";
5
- import"./index-mt3nkbpt.js";
6
- import"./index-h5whaj26.js";
4
+ } from "./index-g3brq942.js";
5
+ import"./index-96vpa123.js";
6
+ import"./index-xwfkgss0.js";
7
7
  import {
8
8
  GlobalConfig
9
9
  } from "./index-0cj2zxbm.js";
10
- import"./index-1az48fvn.js";
11
- import"./index-8pd02prk.js";
10
+ import"./index-rv16ck4r.js";
11
+ import"./index-p42te6qb.js";
12
12
  import"./index-76rn3g2c.js";
13
13
  import {
14
14
  Workspace,
15
15
  command
16
- } from "./index-etwh7sd3.js";
16
+ } from "./index-bkwnr08k.js";
17
17
  import"./index-fgc8r6dj.js";
18
18
  import"./index-bjpxzr6s.js";
19
- import"./index-yzsxc30b.js";
19
+ import"./index-1twehz1x.js";
20
20
  import"./index-mxvakhsm.js";
21
21
  import"./index-1577bej2.js";
22
22
  import"./index-46tjzh6s.js";
@@ -1,25 +1,25 @@
1
1
  // @bun
2
2
  import {
3
3
  ContextScript
4
- } from "./index-3789fdpg.js";
5
- import"./index-yzmqvg23.js";
6
- import"./index-cv9cxs5k.js";
7
- import"./index-4mgkgba3.js";
8
- import"./index-m90fn8xe.js";
9
- import"./index-mewacxye.js";
4
+ } from "./index-b9m84bjp.js";
5
+ import"./index-4agbdds8.js";
6
+ import"./index-w7farjxd.js";
7
+ import"./index-8d9r0df5.js";
8
+ import"./index-4v0wvt37.js";
9
+ import"./index-aak9cctp.js";
10
10
  import"./index-ss469dec.js";
11
- import"./index-65aeh789.js";
12
- import"./index-9va8zayb.js";
11
+ import"./index-gyvrhtpm.js";
12
+ import"./index-gz91pc3p.js";
13
13
  import"./index-0cj2zxbm.js";
14
- import"./index-e4b2ae6b.js";
15
- import"./index-kcsa1zff.js";
14
+ import"./index-djh5gpb7.js";
15
+ import"./index-9s991k9v.js";
16
16
  import"./index-j37qq1f2.js";
17
17
  import"./index-76rn3g2c.js";
18
18
  import {
19
19
  Workspace,
20
20
  command
21
- } from "./index-etwh7sd3.js";
22
- import"./index-yzsxc30b.js";
21
+ } from "./index-bkwnr08k.js";
22
+ import"./index-1twehz1x.js";
23
23
  import"./index-mxvakhsm.js";
24
24
  import"./index-xys926f2.js";
25
25
  import"./index-1577bej2.js";
@@ -10,8 +10,8 @@ import {
10
10
  command,
11
11
  runner,
12
12
  script
13
- } from "./index-etwh7sd3.js";
14
- import"./index-yzsxc30b.js";
13
+ } from "./index-bkwnr08k.js";
14
+ import"./index-1twehz1x.js";
15
15
  import"./index-mxvakhsm.js";
16
16
  import {
17
17
  getDirname
@@ -16,7 +16,7 @@ import {
16
16
  import {
17
17
  AppExecutor,
18
18
  WorkspaceExecutor
19
- } from "./index-yzsxc30b.js";
19
+ } from "./index-1twehz1x.js";
20
20
  import"./index-mxvakhsm.js";
21
21
  import"./index-1577bej2.js";
22
22
  import"./index-67546d0j.js";
@@ -155,9 +155,29 @@ ${AGENT_BLOCK_START}
155
155
  ${block}
156
156
  ${AGENT_BLOCK_END}
157
157
  `;
158
+ var CLAUDE_COMMENT_RULE = `## Comments \u2014 Overrides Your Default
159
+
160
+ Write **no comments** unless the comment passes the test below. This is the rule agents break most often here, so it
161
+ is repeated outside the guide: a diff that adds a comment the test rejects is a diff to redo.
162
+
163
+ Before typing \`//\`, \`/*\`, or a doc block, ask \u2014 **does this sentence carry a fact that is nowhere in the code?**
164
+
165
+ - Restates the identifier, the signature, or the line under it \u2192 delete it.
166
+ - Labels a section (\`// helpers\`, \`// state\`) or narrates a step (\`// fetch the user\`, \`// then save\`) \u2192 delete it.
167
+ - JSDoc on an ordinary function, or a why/how preamble on ordinary logic \u2192 delete it.
168
+ - Explains the edit you just made, for whoever reads the diff \u2192 say it in your reply, not in the file.
169
+ - Names a vendor or protocol quirk, an infrastructure constraint, a library gotcha, security reasoning, a math
170
+ derivation, a domain field's business meaning, a state transition, or why an obvious alternative was rejected \u2192
171
+ keep it, one line.
172
+
173
+ That keep-list is exact \u2014 \`Comments\` in the guide is the full version. "It aids readability" and "this logic is
174
+ subtle" are not on it: rename or split the code instead. When you edit an existing file, match its density; if the
175
+ surrounding code carries none, your diff carries none.`;
158
176
  var renderScopeClaudeMd = (scope) => `# ${scope.name} \u2014 Claude Code Guide
159
177
 
160
178
  @AGENTS.md
179
+
180
+ ${CLAUDE_COMMENT_RULE}
161
181
  `;
162
182
 
163
183
  // pkgs/@akanjs/devkit/akanConfig/akanConfig.ts
@@ -1675,7 +1695,7 @@ class Executor {
1675
1695
  }));
1676
1696
  });
1677
1697
  proc.on("exit", (code, signal) => {
1678
- if (!!code || signal)
1698
+ if (code || signal)
1679
1699
  reject(new CommandExecutionError({
1680
1700
  command,
1681
1701
  cwd,
@@ -1773,7 +1793,7 @@ class Executor {
1773
1793
  }));
1774
1794
  });
1775
1795
  proc.on("exit", (code, signal) => {
1776
- if (!!code || signal)
1796
+ if (code || signal)
1777
1797
  reject(new CommandExecutionError({
1778
1798
  command: modulePath,
1779
1799
  args,
@@ -2594,6 +2614,8 @@ class AppExecutor extends SysExecutor {
2594
2614
  ]);
2595
2615
  } else
2596
2616
  await this.removeDir(".akan");
2617
+ if (type === "start")
2618
+ process.env.NODE_ENV = "development";
2597
2619
  const devPort = type === "start" ? (await this.getDevPort()).toString() : undefined;
2598
2620
  const env = this.getCommandEnv({
2599
2621
  AKAN_COMMAND_TYPE: type,
@@ -3050,4 +3072,4 @@ class ModuleExecutor extends Executor {
3050
3072
  }
3051
3073
  }
3052
3074
 
3053
- export { AGENT_BLOCK_START, AGENT_BLOCK_END, stampBlockVersion, extractBlockVersion, readDevkitVersion, upsertAgentBlock, extractAgentBlock, renderRecipeEntries, collectScopeRecipeSources, renderScopeAgentBlock, appRootAllowedFiles, appRootAllowedDirs, libFacetRootAllowedFiles, isScannedAppRootEntry, CommandExecutionError, Executor, WorkspaceExecutor, SysExecutor, AppExecutor, LibExecutor, PkgExecutor, ModuleExecutor };
3075
+ export { AGENT_BLOCK_START, AGENT_BLOCK_END, stampBlockVersion, extractBlockVersion, readDevkitVersion, upsertAgentBlock, extractAgentBlock, renderRecipeEntries, collectScopeRecipeSources, renderScopeAgentBlock, CLAUDE_COMMENT_RULE, appRootAllowedFiles, appRootAllowedDirs, libFacetRootAllowedFiles, isScannedAppRootEntry, CommandExecutionError, Executor, WorkspaceExecutor, SysExecutor, AppExecutor, LibExecutor, PkgExecutor, ModuleExecutor };
@@ -1,17 +1,17 @@
1
1
  // @bun
2
2
  import {
3
3
  AkanContextAnalyzer
4
- } from "./index-e4b2ae6b.js";
4
+ } from "./index-djh5gpb7.js";
5
5
  import {
6
6
  createRepairReport,
7
7
  generatedFilePathsForTarget,
8
8
  renderRepairReport,
9
9
  writeGeneratedSyncState,
10
10
  writeWorkflowRunArtifact
11
- } from "./index-kcsa1zff.js";
11
+ } from "./index-9s991k9v.js";
12
12
  import {
13
13
  runner
14
- } from "./index-etwh7sd3.js";
14
+ } from "./index-bkwnr08k.js";
15
15
 
16
16
  // pkgs/@akanjs/cli/repair/repair.runner.ts
17
17
  var commandForShell = (command) => command.startsWith("akan ") ? `bun run ${command}` : command;
@@ -1,7 +1,7 @@
1
1
  // @bun
2
2
  import {
3
3
  ModuleScript
4
- } from "./index-mewacxye.js";
4
+ } from "./index-aak9cctp.js";
5
5
  import {
6
6
  addFieldUiPolicyForType,
7
7
  coerceFieldDefault,
@@ -34,15 +34,15 @@ import {
34
34
  sourceFile,
35
35
  validationCommandsForTarget,
36
36
  viaBuilderParameterName
37
- } from "./index-kcsa1zff.js";
37
+ } from "./index-9s991k9v.js";
38
38
  import {
39
39
  script
40
- } from "./index-etwh7sd3.js";
40
+ } from "./index-bkwnr08k.js";
41
41
  import {
42
42
  AppExecutor,
43
43
  LibExecutor,
44
44
  ModuleExecutor
45
- } from "./index-yzsxc30b.js";
45
+ } from "./index-1twehz1x.js";
46
46
 
47
47
  // pkgs/@akanjs/cli/primitive/primitive.script.ts
48
48
  import { capitalize } from "akanjs/common";
@@ -1,24 +1,25 @@
1
1
  // @bun
2
2
  import {
3
3
  AkanContextAnalyzer
4
- } from "./index-e4b2ae6b.js";
4
+ } from "./index-djh5gpb7.js";
5
5
  import {
6
6
  Prompter
7
7
  } from "./index-j37qq1f2.js";
8
8
  import {
9
9
  runner,
10
10
  script
11
- } from "./index-etwh7sd3.js";
11
+ } from "./index-bkwnr08k.js";
12
12
  import {
13
13
  AGENT_BLOCK_END,
14
14
  AGENT_BLOCK_START,
15
15
  AppExecutor,
16
+ CLAUDE_COMMENT_RULE,
16
17
  LibExecutor,
17
18
  readDevkitVersion,
18
19
  renderRecipeEntries,
19
20
  stampBlockVersion,
20
21
  upsertAgentBlock
21
- } from "./index-yzsxc30b.js";
22
+ } from "./index-1twehz1x.js";
22
23
  import {
23
24
  collectRecipeSources,
24
25
  scanRecipes
@@ -199,6 +200,8 @@ var renderClaudeMd = async (workspace) => {
199
200
  return `# ${context.repoName} \u2014 Claude Code Guide
200
201
 
201
202
  @AGENTS.md
203
+
204
+ ${CLAUDE_COMMENT_RULE}
202
205
  `;
203
206
  };
204
207
  var renderCursorRule = () => `---
@@ -9,14 +9,14 @@ import {
9
9
  createPassedPrimitiveReport,
10
10
  generatedFilesForSync,
11
11
  scalarChangedFiles
12
- } from "./index-kcsa1zff.js";
12
+ } from "./index-9s991k9v.js";
13
13
  import {
14
14
  Prompter
15
15
  } from "./index-j37qq1f2.js";
16
16
  import {
17
17
  runner,
18
18
  script
19
- } from "./index-etwh7sd3.js";
19
+ } from "./index-bkwnr08k.js";
20
20
 
21
21
  // pkgs/@akanjs/cli/scalar/scalar.prompt.ts
22
22
  import { input } from "@inquirer/prompts";
@@ -7,14 +7,14 @@ import {
7
7
  } from "./index-0cj2zxbm.js";
8
8
  import {
9
9
  openBrowser
10
- } from "./index-1az48fvn.js";
10
+ } from "./index-rv16ck4r.js";
11
11
  import {
12
12
  runner
13
- } from "./index-etwh7sd3.js";
13
+ } from "./index-bkwnr08k.js";
14
14
  import {
15
15
  AppExecutor,
16
16
  WorkspaceExecutor
17
- } from "./index-yzsxc30b.js";
17
+ } from "./index-1twehz1x.js";
18
18
 
19
19
  // pkgs/@akanjs/cli/npmRegistry.ts
20
20
  var defaultNpmRegistry = "https://registry.npmjs.org";
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  AppExecutor,
4
4
  LibExecutor
5
- } from "./index-yzsxc30b.js";
5
+ } from "./index-1twehz1x.js";
6
6
 
7
7
  // pkgs/@akanjs/devkit/workflow/utils.ts
8
8
  var jsonText = (value, { trailingNewline = true } = {}) => `${JSON.stringify(value, null, 2)}${trailingNewline ? `
@@ -4,7 +4,7 @@ import {
4
4
  } from "./index-ss469dec.js";
5
5
  import {
6
6
  PageScript
7
- } from "./index-65aeh789.js";
7
+ } from "./index-gyvrhtpm.js";
8
8
  import {
9
9
  AiSession
10
10
  } from "./index-0cj2zxbm.js";
@@ -15,17 +15,17 @@ import {
15
15
  generatedFilesForSync,
16
16
  moduleSourcePaths,
17
17
  sourceFile
18
- } from "./index-kcsa1zff.js";
18
+ } from "./index-9s991k9v.js";
19
19
  import {
20
20
  Prompter
21
21
  } from "./index-j37qq1f2.js";
22
22
  import {
23
23
  runner,
24
24
  script
25
- } from "./index-etwh7sd3.js";
25
+ } from "./index-bkwnr08k.js";
26
26
  import {
27
27
  ModuleExecutor
28
- } from "./index-yzsxc30b.js";
28
+ } from "./index-1twehz1x.js";
29
29
  import {
30
30
  FileSys
31
31
  } from "./index-67546d0j.js";
@@ -1,22 +1,22 @@
1
1
  // @bun
2
2
  import {
3
3
  RepairRunner
4
- } from "./index-yzmqvg23.js";
4
+ } from "./index-4agbdds8.js";
5
5
  import {
6
6
  WorkflowRunner
7
- } from "./index-cv9cxs5k.js";
7
+ } from "./index-w7farjxd.js";
8
8
  import {
9
9
  ScalarScript
10
- } from "./index-4mgkgba3.js";
10
+ } from "./index-8d9r0df5.js";
11
11
  import {
12
12
  PrimitiveScript
13
- } from "./index-m90fn8xe.js";
13
+ } from "./index-4v0wvt37.js";
14
14
  import {
15
15
  ModuleScript
16
- } from "./index-mewacxye.js";
16
+ } from "./index-aak9cctp.js";
17
17
  import {
18
18
  isPlaceholderAppId
19
- } from "./index-9va8zayb.js";
19
+ } from "./index-gz91pc3p.js";
20
20
  import {
21
21
  AkanContextAnalyzer,
22
22
  akanMcpInstallConfigPaths,
@@ -27,14 +27,14 @@ import {
27
27
  renderDoctorText,
28
28
  resourceList,
29
29
  upsertCodexMcpServerBlock
30
- } from "./index-e4b2ae6b.js";
30
+ } from "./index-djh5gpb7.js";
31
31
  import {
32
32
  buildAkanModuleContextIndex,
33
33
  createWorkflowBaselineSummary,
34
34
  createWorkflowStepRegistry,
35
35
  jsonText,
36
36
  toolingRolloutGate
37
- } from "./index-kcsa1zff.js";
37
+ } from "./index-9s991k9v.js";
38
38
  import {
39
39
  Prompter
40
40
  } from "./index-j37qq1f2.js";
@@ -45,10 +45,10 @@ import {
45
45
  CommandContainer,
46
46
  runner,
47
47
  script
48
- } from "./index-etwh7sd3.js";
48
+ } from "./index-bkwnr08k.js";
49
49
  import {
50
50
  AppExecutor
51
- } from "./index-yzsxc30b.js";
51
+ } from "./index-1twehz1x.js";
52
52
 
53
53
  // pkgs/@akanjs/cli/context/context.script.ts
54
54
  import { Logger } from "akanjs/common";
@@ -6,7 +6,7 @@ import {
6
6
  ModuleExecutor,
7
7
  PkgExecutor,
8
8
  WorkspaceExecutor
9
- } from "./index-yzsxc30b.js";
9
+ } from "./index-1twehz1x.js";
10
10
  import {
11
11
  getDirname
12
12
  } from "./index-1577bej2.js";
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  workflowRunArtifactPath,
4
4
  workflowSyncDir
5
- } from "./index-kcsa1zff.js";
5
+ } from "./index-9s991k9v.js";
6
6
  import {
7
7
  AppExecutor,
8
8
  LibExecutor,
@@ -11,7 +11,7 @@ import {
11
11
  extractBlockVersion,
12
12
  isScannedAppRootEntry,
13
13
  readDevkitVersion
14
- } from "./index-yzsxc30b.js";
14
+ } from "./index-1twehz1x.js";
15
15
  import {
16
16
  collectRecipeSources,
17
17
  findInlineRecipeDuplicates,
@@ -1,10 +1,10 @@
1
1
  // @bun
2
2
  import {
3
3
  CloudRunner
4
- } from "./index-mt3nkbpt.js";
4
+ } from "./index-96vpa123.js";
5
5
  import {
6
6
  PackageScript
7
- } from "./index-h5whaj26.js";
7
+ } from "./index-xwfkgss0.js";
8
8
  import {
9
9
  AiSession,
10
10
  CloudApi,
@@ -12,13 +12,13 @@ import {
12
12
  } from "./index-0cj2zxbm.js";
13
13
  import {
14
14
  ApplicationScript
15
- } from "./index-1az48fvn.js";
15
+ } from "./index-rv16ck4r.js";
16
16
  import {
17
17
  script
18
- } from "./index-etwh7sd3.js";
18
+ } from "./index-bkwnr08k.js";
19
19
  import {
20
20
  PkgExecutor
21
- } from "./index-yzsxc30b.js";
21
+ } from "./index-1twehz1x.js";
22
22
 
23
23
  // pkgs/@akanjs/cli/cloud/cloud.script.ts
24
24
  import { Logger } from "akanjs/common";
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  runner,
4
4
  script
5
- } from "./index-etwh7sd3.js";
5
+ } from "./index-bkwnr08k.js";
6
6
 
7
7
  // pkgs/@akanjs/cli/page/page.runner.ts
8
8
  class PageRunner extends runner("page") {
@@ -5,7 +5,7 @@ import {
5
5
  } from "./index-76rn3g2c.js";
6
6
  import {
7
7
  CommandExecutionError
8
- } from "./index-yzsxc30b.js";
8
+ } from "./index-1twehz1x.js";
9
9
 
10
10
  // pkgs/@akanjs/devkit/capacitorApp.ts
11
11
  import { cp, mkdir, readFile, rm, writeFile } from "fs/promises";
@@ -2,10 +2,10 @@
2
2
  import {
3
3
  runner,
4
4
  script
5
- } from "./index-etwh7sd3.js";
5
+ } from "./index-bkwnr08k.js";
6
6
  import {
7
7
  LibExecutor
8
- } from "./index-yzsxc30b.js";
8
+ } from "./index-1twehz1x.js";
9
9
 
10
10
  // pkgs/@akanjs/cli/semver.ts
11
11
  function parseVersion(version) {
@@ -70,7 +70,7 @@ class LibraryRunner extends runner("library") {
70
70
  return [dep, newerVersion];
71
71
  }));
72
72
  Object.keys(allDependencies).sort().forEach((dep) => {
73
- if (!!libPackageJson.dependencies?.[dep] || !!rootPackageJson.dependencies?.[dep])
73
+ if (libPackageJson.dependencies?.[dep] || rootPackageJson.dependencies?.[dep])
74
74
  dependencies[dep] = allDependencies[dep];
75
75
  else
76
76
  devDependencies[dep] = allDependencies[dep];
@@ -1,14 +1,14 @@
1
1
  // @bun
2
2
  import {
3
3
  LibraryScript
4
- } from "./index-8pd02prk.js";
4
+ } from "./index-p42te6qb.js";
5
5
  import {
6
6
  resolveMobileTargets
7
7
  } from "./index-76rn3g2c.js";
8
8
  import {
9
9
  runner,
10
10
  script
11
- } from "./index-etwh7sd3.js";
11
+ } from "./index-bkwnr08k.js";
12
12
  import {
13
13
  HmrWatcher,
14
14
  WatchRootResolver
@@ -18,7 +18,7 @@ import {
18
18
  LibExecutor,
19
19
  PkgExecutor,
20
20
  WorkspaceExecutor
21
- } from "./index-yzsxc30b.js";
21
+ } from "./index-1twehz1x.js";
22
22
  import {
23
23
  __require
24
24
  } from "./index-r24hmh0q.js";
@@ -1900,7 +1900,7 @@ function openBrowser(url) {
1900
1900
  // pkgs/@akanjs/cli/application/application.runner.ts
1901
1901
  var loadBuildRunner = async () => (await import("./applicationBuildRunner-9ps10a0h.js")).ApplicationBuildRunner;
1902
1902
  var loadReleasePackager = async () => (await import("./applicationReleasePackager-gg8ccbeh.js")).ApplicationReleasePackager;
1903
- var loadCapacitorApp = async () => (await import("./capacitorApp-mr81qdxq.js")).CapacitorApp;
1903
+ var loadCapacitorApp = async () => (await import("./capacitorApp-9ejk3k7q.js")).CapacitorApp;
1904
1904
  var loadAbstractCompactor = async () => (await import("./abstractCompactor-e5yq60qz.js")).AbstractCompactor;
1905
1905
  var loadPrompts = async () => await import("@inquirer/prompts");
1906
1906
 
@@ -1,7 +1,7 @@
1
1
  // @bun
2
2
  import {
3
3
  AkanContextAnalyzer
4
- } from "./index-e4b2ae6b.js";
4
+ } from "./index-djh5gpb7.js";
5
5
  import {
6
6
  WorkflowExecutor,
7
7
  compactWorkflowInputs,
@@ -23,10 +23,10 @@ import {
23
23
  workflowCommandsForPlan,
24
24
  workflowPlanApproval,
25
25
  writeWorkflowRunArtifact
26
- } from "./index-kcsa1zff.js";
26
+ } from "./index-9s991k9v.js";
27
27
  import {
28
28
  runner
29
- } from "./index-etwh7sd3.js";
29
+ } from "./index-bkwnr08k.js";
30
30
 
31
31
  // pkgs/@akanjs/cli/workflow/workflow.runner.ts
32
32
  import { mkdir, readFile, writeFile } from "fs/promises";
@@ -2,10 +2,10 @@
2
2
  import {
3
3
  runner,
4
4
  script
5
- } from "./index-etwh7sd3.js";
5
+ } from "./index-bkwnr08k.js";
6
6
  import {
7
7
  PkgExecutor
8
- } from "./index-yzsxc30b.js";
8
+ } from "./index-1twehz1x.js";
9
9
  import {
10
10
  TypeScriptDependencyScanner
11
11
  } from "./index-46tjzh6s.js";
package/index.js CHANGED
@@ -4,8 +4,8 @@ import {
4
4
  getTargetCommandNames,
5
5
  getTargetMetas,
6
6
  runCommands
7
- } from "./index-etwh7sd3.js";
8
- import"./index-yzsxc30b.js";
7
+ } from "./index-bkwnr08k.js";
8
+ import"./index-1twehz1x.js";
9
9
  import"./index-mxvakhsm.js";
10
10
  import"./index-1577bej2.js";
11
11
  import"./index-67546d0j.js";
@@ -18,22 +18,22 @@ import path from "path";
18
18
 
19
19
  // pkgs/@akanjs/cli/commandModules.ts
20
20
  var commandModules = {
21
- workspace: async () => (await import("./workspace.command-bqchx18r.js")).WorkspaceCommand,
22
- agent: async () => (await import("./agent.command-a3n15c6t.js")).AgentCommand,
23
- application: async () => (await import("./application.command-16bzjsam.js")).ApplicationCommand,
24
- library: async () => (await import("./library.command-x6t29a30.js")).LibraryCommand,
25
- localRegistry: async () => (await import("./localRegistry.command-3jssedmy.js")).LocalRegistryCommand,
26
- package: async () => (await import("./package.command-zgy7f3fz.js")).PackageCommand,
27
- module: async () => (await import("./module.command-8w8ys5t3.js")).ModuleCommand,
28
- page: async () => (await import("./page.command-yjmnkyk2.js")).PageCommand,
29
- context: async () => (await import("./context.command-ysxawe7h.js")).ContextCommand,
30
- cloud: async () => (await import("./cloud.command-f6t115qw.js")).CloudCommand,
31
- guideline: async () => (await import("./guideline.command-yqf9a372.js")).GuidelineCommand,
32
- scalar: async () => (await import("./scalar.command-9dhmqhtm.js")).ScalarCommand,
33
- primitive: async () => (await import("./primitive.command-gfqaagsg.js")).PrimitiveCommand,
34
- quality: async () => (await import("./quality.command-ec8r1dn3.js")).QualityCommand,
35
- repair: async () => (await import("./repair.command-p9ey6mkm.js")).RepairCommand,
36
- workflow: async () => (await import("./workflow.command-ycwc6zr6.js")).WorkflowCommand
21
+ workspace: async () => (await import("./workspace.command-gr8z82z9.js")).WorkspaceCommand,
22
+ agent: async () => (await import("./agent.command-h6tc0pzh.js")).AgentCommand,
23
+ application: async () => (await import("./application.command-kphnfwyg.js")).ApplicationCommand,
24
+ library: async () => (await import("./library.command-wbptp6q3.js")).LibraryCommand,
25
+ localRegistry: async () => (await import("./localRegistry.command-6ea3pgq0.js")).LocalRegistryCommand,
26
+ package: async () => (await import("./package.command-ph2m34tv.js")).PackageCommand,
27
+ module: async () => (await import("./module.command-ghkf919z.js")).ModuleCommand,
28
+ page: async () => (await import("./page.command-atnzfn88.js")).PageCommand,
29
+ context: async () => (await import("./context.command-pkbccyys.js")).ContextCommand,
30
+ cloud: async () => (await import("./cloud.command-zn6mfscb.js")).CloudCommand,
31
+ guideline: async () => (await import("./guideline.command-0jj2k77g.js")).GuidelineCommand,
32
+ scalar: async () => (await import("./scalar.command-xdjhvsgb.js")).ScalarCommand,
33
+ primitive: async () => (await import("./primitive.command-7qbdhfc2.js")).PrimitiveCommand,
34
+ quality: async () => (await import("./quality.command-1ff2xcra.js")).QualityCommand,
35
+ repair: async () => (await import("./repair.command-weakn0yr.js")).RepairCommand,
36
+ workflow: async () => (await import("./workflow.command-msm2tjee.js")).WorkflowCommand
37
37
  };
38
38
  var commandModuleIds = Object.keys(commandModules);
39
39
 
@@ -1,13 +1,13 @@
1
1
  // @bun
2
2
  import {
3
3
  LibraryScript
4
- } from "./index-8pd02prk.js";
4
+ } from "./index-p42te6qb.js";
5
5
  import {
6
6
  Lib,
7
7
  Workspace,
8
8
  command
9
- } from "./index-etwh7sd3.js";
10
- import"./index-yzsxc30b.js";
9
+ } from "./index-bkwnr08k.js";
10
+ import"./index-1twehz1x.js";
11
11
  import"./index-mxvakhsm.js";
12
12
  import"./index-1577bej2.js";
13
13
  import"./index-67546d0j.js";
@@ -2,27 +2,27 @@
2
2
  import {
3
3
  CloudRunner,
4
4
  getNpmRegistryUrl
5
- } from "./index-mt3nkbpt.js";
5
+ } from "./index-96vpa123.js";
6
6
  import {
7
7
  PackageScript
8
- } from "./index-h5whaj26.js";
8
+ } from "./index-xwfkgss0.js";
9
9
  import"./index-0cj2zxbm.js";
10
10
  import {
11
11
  ApplicationScript
12
- } from "./index-1az48fvn.js";
13
- import"./index-8pd02prk.js";
12
+ } from "./index-rv16ck4r.js";
13
+ import"./index-p42te6qb.js";
14
14
  import"./index-76rn3g2c.js";
15
15
  import {
16
16
  Workspace,
17
17
  command,
18
18
  runner,
19
19
  script
20
- } from "./index-etwh7sd3.js";
20
+ } from "./index-bkwnr08k.js";
21
21
  import"./index-fgc8r6dj.js";
22
22
  import"./index-bjpxzr6s.js";
23
23
  import {
24
24
  PkgExecutor
25
- } from "./index-yzsxc30b.js";
25
+ } from "./index-1twehz1x.js";
26
26
  import"./index-mxvakhsm.js";
27
27
  import"./index-1577bej2.js";
28
28
  import"./index-46tjzh6s.js";
@@ -1,20 +1,20 @@
1
1
  // @bun
2
2
  import {
3
3
  ModuleScript
4
- } from "./index-mewacxye.js";
4
+ } from "./index-aak9cctp.js";
5
5
  import"./index-ss469dec.js";
6
- import"./index-65aeh789.js";
6
+ import"./index-gyvrhtpm.js";
7
7
  import"./index-0cj2zxbm.js";
8
8
  import {
9
9
  renderPrimitiveReport
10
- } from "./index-kcsa1zff.js";
10
+ } from "./index-9s991k9v.js";
11
11
  import"./index-j37qq1f2.js";
12
12
  import {
13
13
  Module,
14
14
  Sys,
15
15
  command
16
- } from "./index-etwh7sd3.js";
17
- import"./index-yzsxc30b.js";
16
+ } from "./index-bkwnr08k.js";
17
+ import"./index-1twehz1x.js";
18
18
  import"./index-mxvakhsm.js";
19
19
  import"./index-1577bej2.js";
20
20
  import"./index-67546d0j.js";
@@ -1,13 +1,13 @@
1
1
  // @bun
2
2
  import {
3
3
  PackageScript
4
- } from "./index-h5whaj26.js";
4
+ } from "./index-xwfkgss0.js";
5
5
  import {
6
6
  Pkg,
7
7
  Workspace,
8
8
  command
9
- } from "./index-etwh7sd3.js";
10
- import"./index-yzsxc30b.js";
9
+ } from "./index-bkwnr08k.js";
10
+ import"./index-1twehz1x.js";
11
11
  import"./index-mxvakhsm.js";
12
12
  import"./index-1577bej2.js";
13
13
  import"./index-46tjzh6s.js";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@akanjs/cli",
3
- "version": "3.0.0-alpha.13",
3
+ "version": "3.0.0-alpha.15",
4
4
  "sourceType": "module",
5
5
  "type": "module",
6
6
  "publishConfig": {
@@ -34,7 +34,7 @@
34
34
  "@langchain/openai": "^1.4.6",
35
35
  "@tailwindcss/node": "^4.3.0",
36
36
  "@trapezedev/project": "^7.1.4",
37
- "akanjs": "3.0.0-alpha.13",
37
+ "akanjs": "3.0.0-alpha.15",
38
38
  "chalk": "^5.6.2",
39
39
  "commander": "^14.0.3",
40
40
  "dayjs": "^1.11.20",
@@ -1,13 +1,13 @@
1
1
  // @bun
2
2
  import {
3
3
  PageScript
4
- } from "./index-65aeh789.js";
4
+ } from "./index-gyvrhtpm.js";
5
5
  import {
6
6
  App,
7
7
  Module,
8
8
  command
9
- } from "./index-etwh7sd3.js";
10
- import"./index-yzsxc30b.js";
9
+ } from "./index-bkwnr08k.js";
10
+ import"./index-1twehz1x.js";
11
11
  import"./index-mxvakhsm.js";
12
12
  import"./index-1577bej2.js";
13
13
  import"./index-67546d0j.js";
@@ -1,20 +1,20 @@
1
1
  // @bun
2
2
  import {
3
3
  PrimitiveScript
4
- } from "./index-m90fn8xe.js";
5
- import"./index-mewacxye.js";
4
+ } from "./index-4v0wvt37.js";
5
+ import"./index-aak9cctp.js";
6
6
  import"./index-ss469dec.js";
7
- import"./index-65aeh789.js";
7
+ import"./index-gyvrhtpm.js";
8
8
  import"./index-0cj2zxbm.js";
9
9
  import {
10
10
  renderPrimitiveReport
11
- } from "./index-kcsa1zff.js";
11
+ } from "./index-9s991k9v.js";
12
12
  import"./index-j37qq1f2.js";
13
13
  import {
14
14
  Workspace,
15
15
  command
16
- } from "./index-etwh7sd3.js";
17
- import"./index-yzsxc30b.js";
16
+ } from "./index-bkwnr08k.js";
17
+ import"./index-1twehz1x.js";
18
18
  import"./index-mxvakhsm.js";
19
19
  import"./index-1577bej2.js";
20
20
  import"./index-67546d0j.js";
@@ -7,11 +7,11 @@ import {
7
7
  command,
8
8
  runner,
9
9
  script
10
- } from "./index-etwh7sd3.js";
10
+ } from "./index-bkwnr08k.js";
11
11
  import {
12
12
  appRootAllowedFiles,
13
13
  libFacetRootAllowedFiles
14
- } from "./index-yzsxc30b.js";
14
+ } from "./index-1twehz1x.js";
15
15
  import"./index-mxvakhsm.js";
16
16
  import"./index-1577bej2.js";
17
17
  import"./index-67546d0j.js";
@@ -1,15 +1,15 @@
1
1
  // @bun
2
2
  import {
3
3
  RepairRunner
4
- } from "./index-yzmqvg23.js";
5
- import"./index-e4b2ae6b.js";
6
- import"./index-kcsa1zff.js";
4
+ } from "./index-4agbdds8.js";
5
+ import"./index-djh5gpb7.js";
6
+ import"./index-9s991k9v.js";
7
7
  import {
8
8
  Workspace,
9
9
  command,
10
10
  script
11
- } from "./index-etwh7sd3.js";
12
- import"./index-yzsxc30b.js";
11
+ } from "./index-bkwnr08k.js";
12
+ import"./index-1twehz1x.js";
13
13
  import"./index-mxvakhsm.js";
14
14
  import"./index-xys926f2.js";
15
15
  import"./index-1577bej2.js";
@@ -1,18 +1,18 @@
1
1
  // @bun
2
2
  import {
3
3
  ScalarScript
4
- } from "./index-4mgkgba3.js";
4
+ } from "./index-8d9r0df5.js";
5
5
  import"./index-ss469dec.js";
6
6
  import"./index-0cj2zxbm.js";
7
7
  import {
8
8
  renderPrimitiveReport
9
- } from "./index-kcsa1zff.js";
9
+ } from "./index-9s991k9v.js";
10
10
  import"./index-j37qq1f2.js";
11
11
  import {
12
12
  Sys,
13
13
  command
14
- } from "./index-etwh7sd3.js";
15
- import"./index-yzsxc30b.js";
14
+ } from "./index-bkwnr08k.js";
15
+ import"./index-1twehz1x.js";
16
16
  import"./index-mxvakhsm.js";
17
17
  import"./index-1577bej2.js";
18
18
  import"./index-67546d0j.js";
@@ -1,3 +1,22 @@
1
1
  # <%= repoName %> — Claude Code Guide
2
2
 
3
3
  @AGENTS.md
4
+
5
+ ## Comments — Overrides Your Default
6
+
7
+ Write **no comments** unless the comment passes the test below. This is the rule agents break most often here, so it
8
+ is repeated outside the guide: a diff that adds a comment the test rejects is a diff to redo.
9
+
10
+ Before typing `//`, `/*`, or a doc block, ask — **does this sentence carry a fact that is nowhere in the code?**
11
+
12
+ - Restates the identifier, the signature, or the line under it → delete it.
13
+ - Labels a section (`// helpers`, `// state`) or narrates a step (`// fetch the user`, `// then save`) → delete it.
14
+ - JSDoc on an ordinary function, or a why/how preamble on ordinary logic → delete it.
15
+ - Explains the edit you just made, for whoever reads the diff → say it in your reply, not in the file.
16
+ - Names a vendor or protocol quirk, an infrastructure constraint, a library gotcha, security reasoning, a math
17
+ derivation, a domain field's business meaning, a state transition, or why an obvious alternative was rejected →
18
+ keep it, one line.
19
+
20
+ That keep-list is exact — `Comments` in the guide is the full version. "It aids readability" and "this logic is
21
+ subtle" are not on it: rename or split the code instead. When you edit an existing file, match its density; if the
22
+ surrounding code carries none, your diff carries none.
@@ -1,30 +1,30 @@
1
1
  // @bun
2
2
  import {
3
3
  WorkflowRunner
4
- } from "./index-cv9cxs5k.js";
4
+ } from "./index-w7farjxd.js";
5
5
  import {
6
6
  ScalarScript
7
- } from "./index-4mgkgba3.js";
7
+ } from "./index-8d9r0df5.js";
8
8
  import {
9
9
  PrimitiveScript
10
- } from "./index-m90fn8xe.js";
10
+ } from "./index-4v0wvt37.js";
11
11
  import {
12
12
  ModuleScript
13
- } from "./index-mewacxye.js";
13
+ } from "./index-aak9cctp.js";
14
14
  import"./index-ss469dec.js";
15
- import"./index-65aeh789.js";
15
+ import"./index-gyvrhtpm.js";
16
16
  import"./index-0cj2zxbm.js";
17
- import"./index-e4b2ae6b.js";
17
+ import"./index-djh5gpb7.js";
18
18
  import {
19
19
  createWorkflowStepRegistry
20
- } from "./index-kcsa1zff.js";
20
+ } from "./index-9s991k9v.js";
21
21
  import"./index-j37qq1f2.js";
22
22
  import {
23
23
  Workspace,
24
24
  command,
25
25
  script
26
- } from "./index-etwh7sd3.js";
27
- import"./index-yzsxc30b.js";
26
+ } from "./index-bkwnr08k.js";
27
+ import"./index-1twehz1x.js";
28
28
  import"./index-mxvakhsm.js";
29
29
  import"./index-xys926f2.js";
30
30
  import"./index-1577bej2.js";
@@ -1,40 +1,40 @@
1
1
  // @bun
2
2
  import {
3
3
  ContextScript
4
- } from "./index-3789fdpg.js";
5
- import"./index-yzmqvg23.js";
6
- import"./index-cv9cxs5k.js";
7
- import"./index-4mgkgba3.js";
8
- import"./index-m90fn8xe.js";
9
- import"./index-mewacxye.js";
4
+ } from "./index-b9m84bjp.js";
5
+ import"./index-4agbdds8.js";
6
+ import"./index-w7farjxd.js";
7
+ import"./index-8d9r0df5.js";
8
+ import"./index-4v0wvt37.js";
9
+ import"./index-aak9cctp.js";
10
10
  import"./index-ss469dec.js";
11
- import"./index-65aeh789.js";
11
+ import"./index-gyvrhtpm.js";
12
12
  import {
13
13
  CloudScript
14
- } from "./index-xzkynk9f.js";
14
+ } from "./index-g3brq942.js";
15
15
  import {
16
16
  getLatestPackageVersion,
17
17
  getNpmRegistryUrl
18
- } from "./index-mt3nkbpt.js";
18
+ } from "./index-96vpa123.js";
19
19
  import {
20
20
  PackageScript
21
- } from "./index-h5whaj26.js";
22
- import"./index-9va8zayb.js";
21
+ } from "./index-xwfkgss0.js";
22
+ import"./index-gz91pc3p.js";
23
23
  import {
24
24
  GlobalConfig
25
25
  } from "./index-0cj2zxbm.js";
26
26
  import {
27
27
  AgentScript
28
- } from "./index-z1s5f4e0.js";
29
- import"./index-e4b2ae6b.js";
30
- import"./index-kcsa1zff.js";
28
+ } from "./index-7ecpft60.js";
29
+ import"./index-djh5gpb7.js";
30
+ import"./index-9s991k9v.js";
31
31
  import"./index-j37qq1f2.js";
32
32
  import {
33
33
  ApplicationScript
34
- } from "./index-1az48fvn.js";
34
+ } from "./index-rv16ck4r.js";
35
35
  import {
36
36
  LibraryScript
37
- } from "./index-8pd02prk.js";
37
+ } from "./index-p42te6qb.js";
38
38
  import"./index-76rn3g2c.js";
39
39
  import {
40
40
  Exec,
@@ -42,7 +42,7 @@ import {
42
42
  command,
43
43
  runner,
44
44
  script
45
- } from "./index-etwh7sd3.js";
45
+ } from "./index-bkwnr08k.js";
46
46
  import"./index-fgc8r6dj.js";
47
47
  import {
48
48
  ThemeValidator,
@@ -59,7 +59,7 @@ import {
59
59
  collectScopeRecipeSources,
60
60
  extractAgentBlock,
61
61
  renderScopeAgentBlock
62
- } from "./index-yzsxc30b.js";
62
+ } from "./index-1twehz1x.js";
63
63
  import"./index-mxvakhsm.js";
64
64
  import {
65
65
  collectRecipeSources,