@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.
- package/CHANGELOG.md +63 -6
- package/LICENSE +1 -1
- package/README.md +296 -164
- package/dist/core/cli/dispatch.d.mts +85 -0
- package/dist/core/cli/dispatch.mjs +1 -0
- package/dist/core/cli/index.d.mts +418 -0
- package/dist/core/cli/index.mjs +1 -0
- package/dist/core/cli/planner.d.mts +143 -0
- package/dist/core/cli/planner.mjs +1 -0
- package/dist/core/cli/plugin.d.mts +94 -0
- package/dist/core/cli/plugin.mjs +1 -0
- package/dist/core/cli/propagate.d.mts +39 -0
- package/dist/core/cli/propagate.mjs +1 -0
- package/dist/core/cli/root-help.d.mts +28 -0
- package/dist/core/cli/root-help.mjs +7 -0
- package/dist/core/cli/root-surface.d.mts +42 -0
- package/dist/core/cli/root-surface.mjs +1 -0
- package/dist/core/cli/runtime-preflight.d.mts +149 -0
- package/dist/core/cli/runtime-preflight.mjs +1 -0
- package/dist/core/completion/index.d.mts +46 -0
- package/dist/core/completion/index.mjs +1 -0
- package/dist/core/completion/shells/bash.d.mts +24 -0
- package/dist/core/completion/shells/bash.mjs +3 -0
- package/dist/core/completion/shells/fish.d.mts +20 -0
- package/dist/core/completion/shells/fish.mjs +2 -0
- package/dist/core/completion/shells/powershell.d.mts +14 -0
- package/dist/core/completion/shells/powershell.mjs +2 -0
- package/dist/core/completion/shells/shared.d.mts +139 -0
- package/dist/core/completion/shells/shared.mjs +1 -0
- package/dist/core/completion/shells/zsh.d.mts +24 -0
- package/dist/core/completion/shells/zsh.mjs +2 -0
- package/dist/core/config/index.d.mts +161 -0
- package/dist/core/config/index.mjs +1 -0
- package/dist/core/config/package-json.d.mts +68 -0
- package/dist/core/config/package-json.mjs +1 -0
- package/dist/core/errors/index.d.mts +126 -0
- package/dist/core/errors/index.mjs +1 -0
- package/dist/core/execution/index.d.mts +49 -0
- package/dist/core/execution/index.mjs +1 -0
- package/dist/core/help/index.d.mts +49 -0
- package/dist/core/help/index.mjs +8 -0
- package/dist/core/json-schema/index.d.mts +109 -0
- package/dist/core/json-schema/index.mjs +55 -0
- package/dist/core/json-schema/meta-descriptions.generated.d.mts +185 -0
- package/dist/core/json-schema/meta-descriptions.generated.mjs +28 -0
- package/dist/core/output/activity.d.mts +194 -0
- package/dist/core/output/activity.mjs +1 -0
- package/dist/core/output/contracts.d.mts +88 -0
- package/dist/core/output/contracts.mjs +1 -0
- package/dist/core/output/display-value.d.mts +19 -0
- package/dist/core/output/display-value.mjs +1 -0
- package/dist/core/output/index.d.mts +280 -0
- package/dist/core/output/index.mjs +2 -0
- package/dist/core/output/renderers.d.mts +46 -0
- package/dist/core/output/renderers.mjs +1 -0
- package/dist/core/output/writer.d.mts +40 -0
- package/dist/core/output/writer.mjs +1 -0
- package/dist/core/parse/index.d.mts +79 -0
- package/dist/core/parse/index.mjs +1 -0
- package/dist/core/prompt/index.d.mts +205 -0
- package/dist/core/prompt/index.mjs +6 -0
- package/dist/core/resolve/args.d.mts +8 -0
- package/dist/core/resolve/args.mjs +1 -0
- package/dist/core/resolve/coerce.d.mts +22 -0
- package/dist/core/resolve/coerce.mjs +1 -0
- package/dist/core/resolve/config.d.mts +10 -0
- package/dist/core/resolve/config.mjs +1 -0
- package/dist/core/resolve/contracts.d.mts +112 -0
- package/dist/core/resolve/errors.d.mts +11 -0
- package/dist/core/resolve/errors.mjs +2 -0
- package/dist/core/resolve/flags.d.mts +10 -0
- package/dist/core/resolve/flags.mjs +1 -0
- package/dist/core/resolve/index.d.mts +42 -0
- package/dist/core/resolve/index.mjs +1 -0
- package/dist/core/resolve/property.d.mts +47 -0
- package/dist/core/resolve/property.mjs +1 -0
- package/dist/core/schema/activity.d.mts +169 -0
- package/dist/core/schema/arg.d.mts +559 -0
- package/dist/core/schema/arg.mjs +1 -0
- package/dist/core/schema/command.d.mts +960 -0
- package/dist/core/schema/command.mjs +1 -0
- package/dist/core/schema/flag.d.mts +491 -0
- package/dist/core/schema/flag.mjs +1 -0
- package/dist/core/schema/index.d.mts +8 -0
- package/dist/core/schema/middleware.d.mts +122 -0
- package/dist/core/schema/middleware.mjs +1 -0
- package/dist/core/schema/prompt.d.mts +117 -0
- package/dist/core/schema/run.d.mts +171 -0
- package/dist/core/schema-dsl/runtime.d.mts +144 -0
- package/dist/core/schema-dsl/runtime.mjs +2 -0
- package/dist/core/schema-dsl/to-json-schema.d.mts +30 -0
- package/dist/core/schema-dsl/to-json-schema.mjs +1 -0
- package/dist/core/testkit/index.d.mts +54 -0
- package/dist/core/testkit/index.mjs +1 -0
- package/dist/index.d.mts +28 -920
- package/dist/index.mjs +1 -10
- package/dist/runtime/adapter.d.mts +212 -0
- package/dist/{adapter-B37d9oia.mjs → runtime/adapter.mjs} +1 -1
- package/dist/runtime/auto.d.mts +26 -0
- package/dist/runtime/auto.mjs +1 -0
- package/dist/runtime/bun.d.mts +28 -0
- package/dist/runtime/bun.mjs +1 -0
- package/dist/runtime/deno.d.mts +76 -0
- package/dist/runtime/deno.mjs +2 -0
- package/dist/runtime/detect.d.mts +86 -0
- package/dist/runtime/detect.mjs +1 -0
- package/dist/runtime/index.d.mts +7 -0
- package/dist/runtime/node.d.mts +65 -0
- package/dist/runtime/node.mjs +2 -0
- package/dist/runtime/paths.d.mts +31 -0
- package/dist/runtime/paths.mjs +1 -0
- package/dist/runtime/support.d.mts +42 -0
- package/dist/runtime/support.mjs +1 -0
- package/dist/runtime.d.mts +6 -252
- package/dist/runtime.mjs +1 -1
- package/dist/testkit.d.mts +5 -24
- package/dist/testkit.mjs +1 -1
- package/dist/version.d.mts +16 -0
- package/dist/version.mjs +1 -0
- package/dreamcli.schema.json +338 -0
- package/examples/basic.ts +2 -2
- package/examples/gh/package.json +7 -11
- package/examples/gh/src/commands/auth.ts +2 -2
- package/examples/gh/src/commands/issue.ts +4 -4
- package/examples/gh/src/commands/pr.ts +4 -4
- package/examples/gh/src/docs.ts +11 -0
- package/examples/gh/src/lib/auth.ts +1 -1
- package/examples/gh/src/main.test.ts +6 -5
- package/examples/gh/src/main.ts +8 -6
- package/examples/interactive.ts +3 -3
- package/examples/json-mode.ts +4 -6
- package/examples/middleware.ts +3 -3
- package/examples/multi-command.ts +3 -3
- package/examples/spinner-progress.ts +5 -5
- package/examples/testing.ts +8 -6
- package/package.json +70 -44
- package/src/core/cli/dispatch.ts +4 -0
- package/src/core/cli/index.ts +185 -632
- package/src/core/cli/planner.ts +413 -0
- package/src/core/cli/plugin.ts +7 -1
- package/src/core/cli/propagate.ts +1 -1
- package/src/core/cli/runtime-preflight.ts +409 -0
- package/src/core/completion/index.ts +15 -9
- package/src/core/completion/shells/bash.ts +6 -3
- package/src/core/completion/shells/fish.ts +245 -10
- package/src/core/completion/shells/powershell.ts +390 -9
- package/src/core/completion/shells/shared.ts +4 -4
- package/src/core/completion/shells/zsh.ts +12 -7
- package/src/core/config/index.ts +7 -4
- package/src/core/config/package-json.ts +6 -2
- package/src/core/errors/index.ts +23 -8
- package/src/core/execution/index.ts +270 -0
- package/src/core/help/index.ts +13 -15
- package/src/core/json-schema/index.ts +193 -7
- package/src/core/json-schema/meta-descriptions.generated.ts +202 -0
- package/src/core/output/contracts.ts +194 -0
- package/src/core/output/index.ts +47 -82
- package/src/core/output/renderers.ts +125 -0
- package/src/core/parse/index.ts +39 -21
- package/src/core/prompt/index.ts +44 -27
- package/src/core/resolve/args.ts +144 -0
- package/src/core/resolve/coerce.ts +432 -0
- package/src/core/resolve/config.ts +26 -0
- package/src/core/resolve/contracts.ts +135 -0
- package/src/core/resolve/errors.ts +227 -0
- package/src/core/resolve/flags.ts +205 -0
- package/src/core/resolve/index.ts +41 -1264
- package/src/core/resolve/property.ts +99 -0
- package/src/core/schema/activity.ts +3 -0
- package/src/core/schema/arg.ts +26 -14
- package/src/core/schema/command.ts +265 -38
- package/src/core/schema/flag.ts +120 -15
- package/src/core/schema/index.ts +11 -2
- package/src/core/schema/middleware.ts +6 -6
- package/src/core/schema/prompt.ts +9 -1
- package/src/core/schema/run.ts +25 -17
- package/src/core/schema-dsl/index.ts +109 -0
- package/src/core/schema-dsl/parse.ts +262 -0
- package/src/core/schema-dsl/runtime.ts +609 -0
- package/src/core/schema-dsl/to-json-schema.ts +102 -0
- package/src/core/testkit/index.ts +55 -297
- package/src/index.ts +10 -4
- package/src/runtime/adapter.ts +13 -10
- package/src/runtime/auto.ts +3 -3
- package/src/runtime/bun.ts +4 -4
- package/src/runtime/deno.ts +43 -29
- package/src/runtime/detect.ts +4 -1
- package/src/runtime/index.ts +1 -1
- package/src/runtime/node.ts +43 -21
- package/src/runtime/paths.ts +9 -3
- package/src/runtime/support.ts +20 -4
- package/src/runtime.ts +1 -1
- package/src/testkit.ts +10 -8
- package/dist/adapter-CCSh5juX.cjs +0 -1
- package/dist/adapter-DIwO-q7K.d.mts +0 -3447
- package/dist/adapter-DQnxxLiE.d.cts +0 -3447
- package/dist/auto-5cjZaF9V.mjs +0 -3
- package/dist/auto-B0eSgoDw.cjs +0 -3
- package/dist/index.cjs +0 -10
- package/dist/index.d.cts +0 -920
- package/dist/runtime.cjs +0 -1
- package/dist/runtime.d.cts +0 -253
- package/dist/testkit-CEDYPvhF.mjs +0 -14
- package/dist/testkit-ClIKijxC.cjs +0 -14
- package/dist/testkit.cjs +0 -1
- package/dist/testkit.d.cts +0 -25
- package/examples/gh/tsconfig.json +0 -37
- package/examples/tsconfig.json +0 -17
- package/src/core/cli/AGENTS.md +0 -72
- package/src/core/completion/AGENTS.md +0 -72
- package/src/core/completion/completion-test-helpers.ts +0 -48
- package/src/core/output/AGENTS.md +0 -69
- package/src/core/resolve/AGENTS.md +0 -69
- package/src/core/schema/AGENTS.md +0 -61
- package/src/core/testkit/AGENTS.md +0 -55
- package/src/runtime/AGENTS.md +0 -74
- 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
|
|
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
|
|
293
|
+
`PROMPT_CANCEL`) moved to `@kjanat/dreamcli/testkit`. Runtime adapters (`createAdapter`,
|
|
239
294
|
`createNodeAdapter`, `createBunAdapter`, `detectRuntime`, `ExitError`, `RUNTIMES`,
|
|
240
|
-
`RuntimeAdapter`) moved to
|
|
241
|
-
only from
|
|
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/
|
|
656
|
-
[
|
|
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