@kjanat/dreamcli 1.0.0 → 2.0.1

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 (217) hide show
  1. package/CHANGELOG.md +63 -6
  2. package/LICENSE +1 -1
  3. package/README.md +296 -164
  4. package/dist/core/cli/dispatch.d.mts +85 -0
  5. package/dist/core/cli/dispatch.mjs +1 -0
  6. package/dist/core/cli/index.d.mts +418 -0
  7. package/dist/core/cli/index.mjs +1 -0
  8. package/dist/core/cli/planner.d.mts +143 -0
  9. package/dist/core/cli/planner.mjs +1 -0
  10. package/dist/core/cli/plugin.d.mts +94 -0
  11. package/dist/core/cli/plugin.mjs +1 -0
  12. package/dist/core/cli/propagate.d.mts +39 -0
  13. package/dist/core/cli/propagate.mjs +1 -0
  14. package/dist/core/cli/root-help.d.mts +28 -0
  15. package/dist/core/cli/root-help.mjs +7 -0
  16. package/dist/core/cli/root-surface.d.mts +42 -0
  17. package/dist/core/cli/root-surface.mjs +1 -0
  18. package/dist/core/cli/runtime-preflight.d.mts +149 -0
  19. package/dist/core/cli/runtime-preflight.mjs +1 -0
  20. package/dist/core/completion/index.d.mts +46 -0
  21. package/dist/core/completion/index.mjs +1 -0
  22. package/dist/core/completion/shells/bash.d.mts +24 -0
  23. package/dist/core/completion/shells/bash.mjs +3 -0
  24. package/dist/core/completion/shells/fish.d.mts +20 -0
  25. package/dist/core/completion/shells/fish.mjs +2 -0
  26. package/dist/core/completion/shells/powershell.d.mts +14 -0
  27. package/dist/core/completion/shells/powershell.mjs +2 -0
  28. package/dist/core/completion/shells/shared.d.mts +139 -0
  29. package/dist/core/completion/shells/shared.mjs +1 -0
  30. package/dist/core/completion/shells/zsh.d.mts +24 -0
  31. package/dist/core/completion/shells/zsh.mjs +2 -0
  32. package/dist/core/config/index.d.mts +161 -0
  33. package/dist/core/config/index.mjs +1 -0
  34. package/dist/core/config/package-json.d.mts +68 -0
  35. package/dist/core/config/package-json.mjs +1 -0
  36. package/dist/core/errors/index.d.mts +126 -0
  37. package/dist/core/errors/index.mjs +1 -0
  38. package/dist/core/execution/index.d.mts +49 -0
  39. package/dist/core/execution/index.mjs +1 -0
  40. package/dist/core/help/index.d.mts +49 -0
  41. package/dist/core/help/index.mjs +8 -0
  42. package/dist/core/json-schema/index.d.mts +109 -0
  43. package/dist/core/json-schema/index.mjs +55 -0
  44. package/dist/core/json-schema/meta-descriptions.generated.d.mts +185 -0
  45. package/dist/core/json-schema/meta-descriptions.generated.mjs +28 -0
  46. package/dist/core/output/activity.d.mts +194 -0
  47. package/dist/core/output/activity.mjs +1 -0
  48. package/dist/core/output/contracts.d.mts +88 -0
  49. package/dist/core/output/contracts.mjs +1 -0
  50. package/dist/core/output/display-value.d.mts +19 -0
  51. package/dist/core/output/display-value.mjs +1 -0
  52. package/dist/core/output/index.d.mts +280 -0
  53. package/dist/core/output/index.mjs +2 -0
  54. package/dist/core/output/renderers.d.mts +46 -0
  55. package/dist/core/output/renderers.mjs +1 -0
  56. package/dist/core/output/writer.d.mts +40 -0
  57. package/dist/core/output/writer.mjs +1 -0
  58. package/dist/core/parse/index.d.mts +79 -0
  59. package/dist/core/parse/index.mjs +1 -0
  60. package/dist/core/prompt/index.d.mts +205 -0
  61. package/dist/core/prompt/index.mjs +6 -0
  62. package/dist/core/resolve/args.d.mts +8 -0
  63. package/dist/core/resolve/args.mjs +1 -0
  64. package/dist/core/resolve/coerce.d.mts +22 -0
  65. package/dist/core/resolve/coerce.mjs +1 -0
  66. package/dist/core/resolve/config.d.mts +10 -0
  67. package/dist/core/resolve/config.mjs +1 -0
  68. package/dist/core/resolve/contracts.d.mts +112 -0
  69. package/dist/core/resolve/errors.d.mts +11 -0
  70. package/dist/core/resolve/errors.mjs +2 -0
  71. package/dist/core/resolve/flags.d.mts +10 -0
  72. package/dist/core/resolve/flags.mjs +1 -0
  73. package/dist/core/resolve/index.d.mts +42 -0
  74. package/dist/core/resolve/index.mjs +1 -0
  75. package/dist/core/resolve/property.d.mts +47 -0
  76. package/dist/core/resolve/property.mjs +1 -0
  77. package/dist/core/schema/activity.d.mts +169 -0
  78. package/dist/core/schema/arg.d.mts +559 -0
  79. package/dist/core/schema/arg.mjs +1 -0
  80. package/dist/core/schema/command.d.mts +960 -0
  81. package/dist/core/schema/command.mjs +1 -0
  82. package/dist/core/schema/flag.d.mts +491 -0
  83. package/dist/core/schema/flag.mjs +1 -0
  84. package/dist/core/schema/index.d.mts +8 -0
  85. package/dist/core/schema/middleware.d.mts +122 -0
  86. package/dist/core/schema/middleware.mjs +1 -0
  87. package/dist/core/schema/prompt.d.mts +117 -0
  88. package/dist/core/schema/run.d.mts +171 -0
  89. package/dist/core/schema-dsl/runtime.d.mts +144 -0
  90. package/dist/core/schema-dsl/runtime.mjs +2 -0
  91. package/dist/core/schema-dsl/to-json-schema.d.mts +30 -0
  92. package/dist/core/schema-dsl/to-json-schema.mjs +1 -0
  93. package/dist/core/testkit/index.d.mts +54 -0
  94. package/dist/core/testkit/index.mjs +1 -0
  95. package/dist/index.d.mts +28 -920
  96. package/dist/index.mjs +1 -10
  97. package/dist/runtime/adapter.d.mts +212 -0
  98. package/dist/{adapter-B37d9oia.mjs → runtime/adapter.mjs} +1 -1
  99. package/dist/runtime/auto.d.mts +26 -0
  100. package/dist/runtime/auto.mjs +1 -0
  101. package/dist/runtime/bun.d.mts +28 -0
  102. package/dist/runtime/bun.mjs +1 -0
  103. package/dist/runtime/deno.d.mts +76 -0
  104. package/dist/runtime/deno.mjs +2 -0
  105. package/dist/runtime/detect.d.mts +86 -0
  106. package/dist/runtime/detect.mjs +1 -0
  107. package/dist/runtime/index.d.mts +7 -0
  108. package/dist/runtime/node.d.mts +65 -0
  109. package/dist/runtime/node.mjs +2 -0
  110. package/dist/runtime/paths.d.mts +31 -0
  111. package/dist/runtime/paths.mjs +1 -0
  112. package/dist/runtime/support.d.mts +42 -0
  113. package/dist/runtime/support.mjs +1 -0
  114. package/dist/runtime.d.mts +6 -252
  115. package/dist/runtime.mjs +1 -1
  116. package/dist/testkit.d.mts +5 -24
  117. package/dist/testkit.mjs +1 -1
  118. package/dist/version.d.mts +16 -0
  119. package/dist/version.mjs +1 -0
  120. package/dreamcli.schema.json +338 -0
  121. package/examples/basic.ts +2 -2
  122. package/examples/gh/package.json +7 -11
  123. package/examples/gh/src/commands/auth.ts +2 -2
  124. package/examples/gh/src/commands/issue.ts +4 -4
  125. package/examples/gh/src/commands/pr.ts +4 -4
  126. package/examples/gh/src/docs.ts +11 -0
  127. package/examples/gh/src/lib/auth.ts +1 -1
  128. package/examples/gh/src/main.test.ts +6 -5
  129. package/examples/gh/src/main.ts +8 -6
  130. package/examples/interactive.ts +3 -3
  131. package/examples/json-mode.ts +4 -6
  132. package/examples/middleware.ts +3 -3
  133. package/examples/multi-command.ts +3 -3
  134. package/examples/spinner-progress.ts +5 -5
  135. package/examples/testing.ts +8 -6
  136. package/package.json +70 -44
  137. package/src/core/cli/dispatch.ts +4 -0
  138. package/src/core/cli/index.ts +185 -632
  139. package/src/core/cli/planner.ts +413 -0
  140. package/src/core/cli/plugin.ts +7 -1
  141. package/src/core/cli/propagate.ts +1 -1
  142. package/src/core/cli/runtime-preflight.ts +409 -0
  143. package/src/core/completion/index.ts +15 -9
  144. package/src/core/completion/shells/bash.ts +6 -3
  145. package/src/core/completion/shells/fish.ts +245 -10
  146. package/src/core/completion/shells/powershell.ts +390 -9
  147. package/src/core/completion/shells/shared.ts +4 -4
  148. package/src/core/completion/shells/zsh.ts +12 -7
  149. package/src/core/config/index.ts +7 -4
  150. package/src/core/config/package-json.ts +6 -2
  151. package/src/core/errors/index.ts +23 -8
  152. package/src/core/execution/index.ts +270 -0
  153. package/src/core/help/index.ts +13 -15
  154. package/src/core/json-schema/index.ts +193 -7
  155. package/src/core/json-schema/meta-descriptions.generated.ts +202 -0
  156. package/src/core/output/contracts.ts +194 -0
  157. package/src/core/output/index.ts +47 -82
  158. package/src/core/output/renderers.ts +125 -0
  159. package/src/core/parse/index.ts +39 -21
  160. package/src/core/prompt/index.ts +44 -27
  161. package/src/core/resolve/args.ts +144 -0
  162. package/src/core/resolve/coerce.ts +432 -0
  163. package/src/core/resolve/config.ts +26 -0
  164. package/src/core/resolve/contracts.ts +135 -0
  165. package/src/core/resolve/errors.ts +227 -0
  166. package/src/core/resolve/flags.ts +205 -0
  167. package/src/core/resolve/index.ts +41 -1264
  168. package/src/core/resolve/property.ts +99 -0
  169. package/src/core/schema/activity.ts +3 -0
  170. package/src/core/schema/arg.ts +26 -14
  171. package/src/core/schema/command.ts +265 -38
  172. package/src/core/schema/flag.ts +120 -15
  173. package/src/core/schema/index.ts +11 -2
  174. package/src/core/schema/middleware.ts +6 -6
  175. package/src/core/schema/prompt.ts +9 -1
  176. package/src/core/schema/run.ts +25 -17
  177. package/src/core/schema-dsl/index.ts +109 -0
  178. package/src/core/schema-dsl/parse.ts +262 -0
  179. package/src/core/schema-dsl/runtime.ts +609 -0
  180. package/src/core/schema-dsl/to-json-schema.ts +102 -0
  181. package/src/core/testkit/index.ts +55 -297
  182. package/src/index.ts +10 -4
  183. package/src/runtime/adapter.ts +13 -10
  184. package/src/runtime/auto.ts +3 -3
  185. package/src/runtime/bun.ts +4 -4
  186. package/src/runtime/deno.ts +43 -29
  187. package/src/runtime/detect.ts +4 -1
  188. package/src/runtime/index.ts +1 -1
  189. package/src/runtime/node.ts +43 -21
  190. package/src/runtime/paths.ts +9 -3
  191. package/src/runtime/support.ts +20 -4
  192. package/src/runtime.ts +1 -1
  193. package/src/testkit.ts +10 -8
  194. package/dist/adapter-CCSh5juX.cjs +0 -1
  195. package/dist/adapter-DIwO-q7K.d.mts +0 -3447
  196. package/dist/adapter-DQnxxLiE.d.cts +0 -3447
  197. package/dist/auto-5cjZaF9V.mjs +0 -3
  198. package/dist/auto-B0eSgoDw.cjs +0 -3
  199. package/dist/index.cjs +0 -10
  200. package/dist/index.d.cts +0 -920
  201. package/dist/runtime.cjs +0 -1
  202. package/dist/runtime.d.cts +0 -253
  203. package/dist/testkit-CEDYPvhF.mjs +0 -14
  204. package/dist/testkit-ClIKijxC.cjs +0 -14
  205. package/dist/testkit.cjs +0 -1
  206. package/dist/testkit.d.cts +0 -25
  207. package/examples/gh/tsconfig.json +0 -37
  208. package/examples/tsconfig.json +0 -17
  209. package/src/core/cli/AGENTS.md +0 -72
  210. package/src/core/completion/AGENTS.md +0 -72
  211. package/src/core/completion/completion-test-helpers.ts +0 -48
  212. package/src/core/output/AGENTS.md +0 -69
  213. package/src/core/resolve/AGENTS.md +0 -69
  214. package/src/core/schema/AGENTS.md +0 -61
  215. package/src/core/testkit/AGENTS.md +0 -55
  216. package/src/runtime/AGENTS.md +0 -74
  217. package/src/runtime/test-helpers.ts +0 -40
package/CHANGELOG.md CHANGED
@@ -7,6 +7,61 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [2.0.1] - 2026-04-07
11
+
12
+ ### Fixed
13
+
14
+ - **Schema URL resolution** — `$schema` in emitted definition documents now points at
15
+ `dreamcli.schema.json` instead of the `/schema` subpath export, which doesn't resolve on the
16
+ jsdelivr CDN.
17
+ - **GitHub Pages deploy** — use `env` import from `node:process` for env access and set VitePress
18
+ `base` to `/dreamcli/` so assets and links resolve correctly on GitHub Pages.\
19
+ This allows for the old github pages deploy to work as an alternative to the cf workers.
20
+ - **Publish pipeline** — split build and publish into separate jobs, run build before pack with
21
+ `--ignore-scripts` to prevent prepack output from breaking `GITHUB_OUTPUT` parsing, hardcode the
22
+ npm CDN schema URL instead of the unreliable jsr.io esm.sh path, replace `actions/setup-node`
23
+ with bun's native registry auth, and switch internal imports to `#dreamcli/*` subpath imports.
24
+ - **Package exports map** — moved conditional exports from `publishConfig` into top-level `exports`
25
+ so local resolution matches what consumers see after install.
26
+
27
+ ## [2.0.0] - 2026-04-07
28
+
29
+ ### Added
30
+
31
+ - **String-literal schema DSL** — added a single-source schema surface that parses definitions at
32
+ compile time and runtime, then reuses the same model for JSON Schema generation.
33
+ - **Published definition schema export** — added `@kjanat/dreamcli/schema` so tooling and docs
34
+ consumers can import the generated definition schema locally instead of relying on the CDN URL.
35
+ - **Fish and PowerShell shell completions** — expanded completion support beyond Bash and Zsh.
36
+ - **Source-backed docs surfaces** — added generated API inventory pages, per-entrypoint symbol
37
+ routes, source-backed example pages with related symbol links, and reference guides for planner,
38
+ resolver, output, schema, support, migration, troubleshooting, and semantic deltas.
39
+ - **`gh-project` workflow helper** — added a DreamCLI-powered project tool for syncing the
40
+ re-foundation task board and PRD state.
41
+
42
+ ### Changed
43
+
44
+ - **Package identity and build pipeline** — the package is now published as `@kjanat/dreamcli`,
45
+ ships ESM-only, emits the definition schema during the tsdown prepare hook, tightens published
46
+ exports for runtime-specific consumers, and hardens npm, JSR, and docs release checks.
47
+ - **Docs app architecture** — VitePress now builds reference and example pages from data loaders
48
+ instead of static generated files, adds runtime/twoslash settings UI, improves mobile twoslash
49
+ UX, and copies root artifacts into deployed docs output.
50
+ - **Examples and walkthroughs** — the `gh` example grew into a multi-file workspace canary, and the
51
+ example set now doubles as richer docs source with broader JSDoc coverage and better walkthrough
52
+ material.
53
+
54
+ ### Fixed
55
+
56
+ - **Completion and alias handling** — hidden compatibility aliases now parse correctly, Bash and Zsh
57
+ completion behavior is safer and more consistent, and shell completion edge cases were tightened.
58
+ - **Aggregate validation diagnostics** — mixed flag and arg validation failures now surface clearer
59
+ per-issue labels plus value-source labels such as `env ...` and `stdin`.
60
+ - **Schema and docs integration** — schema URLs, generated meta descriptions, twoslash rendering,
61
+ and source-backed docs pages now build reliably across local, CI, and Cloudflare deploys.
62
+ - **CLI and runtime edge cases** — unresolved schema references now fail closed, runtime/support
63
+ checks were hardened, and several dispatch/output/runtime regressions were corrected.
64
+
10
65
  ## [1.0.0] - 2026-04-02
11
66
 
12
67
  ### Added
@@ -201,7 +256,7 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
201
256
  `ReadableStream` (needed because `lib: ["ES2022"]` excludes web platform APIs).
202
257
  - **`createAdapter()` auto-detection** now handles Deno runtime via `globalThis.Deno` feature
203
258
  probing.
204
- - Re-exported `createDenoAdapter` and `DenoNamespace` from `dreamcli/runtime` subpath.
259
+ - Re-exported `createDenoAdapter` and `DenoNamespace` from `@kjanat/dreamcli/runtime` subpath.
205
260
 
206
261
  #### Cross-Runtime CI
207
262
 
@@ -235,10 +290,10 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
235
290
 
236
291
  - **Subpath exports** — single `"."` entry split into `"."`, `"./testkit"`, `"./runtime"`. Test
237
292
  utilities (`runCommand`, `createCaptureOutput`, `createTestPrompter`, `createTestAdapter`,
238
- `PROMPT_CANCEL`) moved to `dreamcli/testkit`. Runtime adapters (`createAdapter`,
293
+ `PROMPT_CANCEL`) moved to `@kjanat/dreamcli/testkit`. Runtime adapters (`createAdapter`,
239
294
  `createNodeAdapter`, `createBunAdapter`, `detectRuntime`, `ExitError`, `RUNTIMES`,
240
- `RuntimeAdapter`) moved to `dreamcli/runtime`. `createTestAdapter`/`TestAdapterOptions` exported
241
- only from `dreamcli/testkit`.
295
+ `RuntimeAdapter`) moved to `@kjanat/dreamcli/runtime`. `createTestAdapter`/`TestAdapterOptions` exported
296
+ only from `@kjanat/dreamcli/testkit`.
242
297
 
243
298
  ### Added
244
299
 
@@ -652,8 +707,10 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
652
707
  - MIT License.
653
708
  - Markdownlint configuration.
654
709
 
655
- [Unreleased]: https://github.com/kjanat/dreamcli/compare/9ea29cd...HEAD
656
- [1.0.0]: https://github.com/kjanat/dreamcli/compare/5b86f72...9ea29cd
710
+ [Unreleased]: https://github.com/kjanat/dreamcli/compare/v2.0.1...HEAD
711
+ [2.0.1]: https://github.com/kjanat/dreamcli/compare/v2.0.0...v2.0.1
712
+ [2.0.0]: https://github.com/kjanat/dreamcli/compare/v1.0.0...v2.0.0
713
+ [1.0.0]: https://github.com/kjanat/dreamcli/compare/5b86f72...v1.0.0
657
714
  [0.9.2]: https://github.com/kjanat/dreamcli/compare/b26f2d8...5b86f72
658
715
  [0.9.1]: https://github.com/kjanat/dreamcli/compare/v0.9.0...b26f2d8
659
716
  [0.9.0]: https://github.com/kjanat/dreamcli/compare/v0.8.0...v0.9.0
package/LICENSE CHANGED
@@ -1,7 +1,7 @@
1
1
  MIT License
2
2
  ===========
3
3
 
4
- Copyright (c) 2026 kjanat
4
+ Copyright (c) 2026 Kaj Kowalski
5
5
 
6
6
  Permission is hereby granted, free of charge, to any person obtaining a copy
7
7
  of this software and associated documentation files (the "Software"), to deal