CHANGELOG

All notable changes to this project will be documented in this file. Dates are displayed in UTC.

Unreleased

updated docs 15f57ea
Refactor plugin attach-module layout 72439ad
Fix init scaffolding for hello folder template 4a401ed
Refactor plugin options wiring modules 0ce6be7
Refine aws/init action typing d641a3f
fix(aws): support SSO creds and export formats f38aea9
whoami: add really subcommand module split 4195e20
docs: align examples with implementation f89e8fa
Fix aws SSO login-on-demand flow 5990e2c
aws: apply flags to nested subcommands 0826804
docs: fix createCli usage and describe plugin structure 7670719
fix: lint require-await in aws tests a2b33ad
Fix E2E output-path test timeout fa0bc6b
Fix hello templates and init scaffolding 31a6105
docs: align examples with current CLI e02f31c
docs: update authoring guide examples to match implementation 652743a
docs: continue alignment pass (batch/capture) f22597b
docs: fix remaining config/help drift 94bceb4
lint: fix aws subcommand flags test cbe2a61
refactor names 1f36fdf
Fix aws typed action wiring 90172f0
lint: fix whoami really test mocks 5ca200b

v6.1.0

14 December 2025

updated docs 3a3e64b
updated docs ecf3aee
Docs: expand plugin flag values from ctx e61e1b6
updated docs 28f5196
docs: align mount semantics and exports ed41069
Docs: refocus batch plugin guide 90c6f91
chore: release v6.1.0 5fc2c26

v6.0.0

13 December 2025

updated docs ebd4de0
updated docs fe7f5ac
Improve docs & type inference ee6438a
updated docs 5637894
updated docs dc93ff4
docs: add package-level TypeDoc to barrels d46fae7
docs(typedoc): expand property docs across exported option types 47d3e1b
updated docs 0c590d3
updated docs e298b9e
stan imports & faceting 9878875
refactor(tests): drop overrideRootOptions; use GetDotenvCli/createCli per new API 4bfad71
Reorganized repo & imports 5fc43bd
refactor: DRY batch 1 — dynamic/trace/dotenv/aws helpers 6a6d570
refactor: infer Commander action params; widen helpers; explicit root Options 06783c9
refactor(batch): inline parent action into index.ts for better typing e48e480
refactor: remove plugin id and legacy shims; key config by path 9df72f1
refactor(cliHost): split definePlugin; add uniqueness guard b2b2d92
refactor(plugins): maximize Commander action type inference 0ada4fc
fix(plugins): adopt Commander extra-typings inference; fix aws action; clean batch opts 9d9a6f2
refactor(cliHost): extract heavy GetDotenvCli methods into helpers 284835a
docs: decompose README and cross-link to Guides 77392bb
refactor: remove public overrideRootOptions; update tests 504f61f
fix(cli): install plugins before parse; repair aws afterResolve b144e83
lintfix e8419ec
refactor(cmd): unify alias and subcommand via shared runner; remove legacy alias module 3d89095
reorganize repo & update import paths b16edba
refactor(cliHost): remove passOptions usage; consolidate hooks in overrideRootOptions 1a5aa13
build: exclude templates from TS, copy to dist; fix aliases 85131e8
refactor: remove additional unnecessary casts and fallbacks 74c7e85
docs: expand TypeDoc coverage for schemas and constants d0d706c
docs: unify root defaults via config.rootOptionDefaults and precedence abafbbb
docs: sync README and guides with current host and plugins 0ec3bf4
fix(batch): align action typings with Commander generics 110ff2e
plan: add tasks to implement Commander generics end-to-end 05a7e8a
refactor(reqs): unify root options via overrideRootOptions; update plan 48a16ad
test: refactor unit tests to use createCli and fix help capture f0bc359
docs(dx): simplify examples to remove unnecessary typing and casts 28732bb
DRY: unify JS/TS loader, dynamic apply, batch argv, and verify lists ec3131c
docs(typedoc): add missing TSDoc for interface properties e9ebf22
feat: host-created mounts with required namespaces; override API 2d3f2ea
init: inherit logger from base; remove logger option and unsafe opts cast 1eac0d8
chore(lint): satisfy require-await in resolveGetDotenvOptions ce0da8a
createCli: compose-first API; return runner fn; precompose defaults 503af64
refactor(cliHost): add small passOptions helper; restore exports 804c481
refactor: DRY batch 2 — normalize exec core and refactor wrappers 6827e13
refactor(cliHost): unify GetDotenvCli and decompose helpers 2788aa1
refactor(cli): stop using overrideRootOptions; install hooks internally 0016207
refactor: tighten config contract and add visibility, redact family 8f08e14
refactor(types): replace inline option objects with exported interfaces 1cdd1cb
removed demo plugin d84fc85
feat: visibility helper, schema rootOptionVisibility, redact flags f2fe737
removed dead file 891d24d
test: suppress Commander exits in unit tests; keep help/version non-fatal 1d65d51
requirements: adopt namespace model + host-created mounts 6642d4a
feat: rootOptionDefaults + unified defaults stack f0c12b2
Resolve overlayEnv union narrowing for typecheck 8fac838
fix(cli): cmd args, install sync mounts, and ctx on subcommands bb144c3
refactor: use readMergedOptions across plugins for merged root options adee783
devplan: record decomposition plan for visibility/redact fb91f03
chore(refactor): extract option interfaces and decompose GetDotenvCli 13b191c
feat(config): enforce strict schema; drop CLI scripts pass-through ea3fcb6
fix: typecheck and lint cleanups for cmd alias and batch action 8c14d41
refactor(opts): drop redundant casts; destructure merged flags across plugins 709256b
chore: align template plugin/CLI; fix build and scripts d25b836
refactor(types): export more option interfaces and replace inline object types 44ffccb
docs: sync config/shell/authoring/aws guides with code 4bcf71d
test: fix Vitest lint rules in E2E/schema tests c0f75f3
When: 2025-02-26T00:00:00Z 4de152d
cliHost: add getRootCommand; use in template hello plugin 4649f25
fix(types): make plugin setup return Command|GetDotenvCliPublic (no void unions) and tighten installer generics d83142d
build: suppress config-plugin TS warning; exclude templates in tsconfig a5b5040
feat(types): thread extra‑typings Commander generics through host and plugins; add typed ns(); update durable requirements 7db86db
fix(types): align Commander typing via CommandUnknownOpts and clean batch UX 41448df
chore: update dev plan for config/CLI contract changes e92aecf
docs: document root visibility and redact; add E2E eb6540a
feat: nested plugin composition with mount propagation 5ea9521
refactor(types): extract plugin composition interfaces 334cb2a
reorganization 71a4020
When: 2025-02-12T00:00:00Z d868582
fix: unify GetDotenvCli import casing; gate alias exit under tests 6a3ad64
When: 2025-02-26T00:00:00Z 3234f00
test: add visibility and redact dynamic help tests a4ece61
feat(cli): add rootOptionDefaults/Visibility in createCli; update template 223e1b2
feat(logger): strict contract and schema defaults; remove coalescing 6d9b199
fix(cli): trigger root preAction and move aws debug to stderr a04efa9
chore: add GETDOTENV_DEBUG diagnostics for root/alias flows 2b46f91
fix(types): align host/helper generics and plugin config store 02df75c
refactor(batch): use readMergedOptions in defaultCmdAction 8d64a2e
docs: improve authoring guides; add root helper and node -e argv tip 22ba3f0
cmd alias: type-safe scripts usage in maybeRunAlias aa63154
refactor(batch): export typed option interfaces with TSDoc 694bf11
feat(cliHost): make getCtx() non-nullable and throwing; add hasCtx(); update callers 9fa902f
mark built-in plugins audit completed c50db4e
repaired requirements & resolved filename case issue db76ece
feat(cli): thread Commander generics & typed ns() 0d4d712
When: 2025-02-26T00:00:00Z 90d1bc5
add cli subpath export and build outputs; prefer '@karmaniverous/get-dotenv/cli' in templates/docs ee14253
tsconfig: include templates & inherit paths; adjust init tests for template 9528400
fix(host): guard concurrent install and simplify plugin setup typing d18307b
fix: infer aws opts by making dynamic options generic 9c33d4a
fix(types): generalize plugin and thread Commander generics 73c5476
fix: wire base logger through CLI defaults and batch; no console fallback at call site 9b14ff7
refactor: remove unnecessary casts and redundant ?? {} defaults c1908c2
fix(tools): align verify-types with overlayEnv; update knip entry f697f7e
docs(typedoc): finish property docs for batch exec and command helpers 52a29c9
refactor: remove casts in plugin indexes; fix typings/lints 38a6ea2
refactor(types): replace inline option objects with interfaces a2769f2
plan: add implementation path for config.rootOptionDefaults faaa812
prune next-up; append verification and helper audit 78ad623
fix(help): show correct default for --load-process-off in top-level -h 47e2edc
refactor(types): replace type aliases with interfaces e955834
chore: prune Next up in dev plan to only remaining work fac94c8
fix(cli): repair plugin traversal, cmd alias, and generics f521b8c
refactor(plugins): rely on Commander action type inference 1adae16
Resolved circular imports e758a1c
ci: fix verify-bundle for @commander-js/extra-typings external f1c1d01
fix: finalize Commander alias typing and batch lint cleanup bd911bf
installed @commander-js/extra-typings 1952aac
fix: satisfy typecheck/lint in batch list-shell and alias hook 164097b
chore: fix lint by removing non-null assertion and unused import 53b156c
fix(types): generic plugin-config store + readonly whitelist 2285175
docs: improve authoring guides; add root helper and node -e argv tip 9f510f1
feat(cmd): add config schema and wire expand default into alias path a1c3c21
refactor: simplify configs to new format and remove redundant defaults abee580
refactor(types): convert GetDotenvConfig and plugin helpers to interfaces ad41e8c
fix(types): generalize compute/resolve over Commander generics 43093e3
fix: typecheck, lint, and programmatic defaults regression 205a739
docs(typedoc): document GetDotenvConfigResolved properties 4462d90
cmd alias: simplify entOpts and remove casts in catch 7919b38
test(batch): install passOptions in batch tests for new readMergedOptions invariant bbc438e
eliminated per-test timeouts 7059c33
fix: resolve remaining Commander variance and batch lint/typing d61ddf2
When: 2025-02-26T00:00:00Z bff8644
fix: type/lint gates for nested composition; await install; aws setup refactor 7f88077
refactor(cliHost): simplify dynamic option signatures 4f814da
improved readme links 27cac3b
chore: break core↔cliHost cycle by using neutral defaults 9e5cf6b
chore: prune completed Next up items in dev plan 2dc2201
fix(cli): keep base logger typed and lint‑clean; remove inline import() types 2735228
fix: exactOptionalPropertyTypes-safe opts for exec core 5d80875
fix(tests): mock correct batch exec module to resolve failures a3fc026
docs: add package-level and schema TypeDoc across modules fcc0286
fix(typing): rootHooks debug logs use typed view; lint clean 1c63830
feat: add nested plugin composition requirement and plan 74a8d21
fix: lint violations and test path bug for root defaults e05c369
fix(logger): required in CLI options; guarantee via readMergedOptions 0e1e647
refactor: remove unnecessary casts in help config and computeContext b140d05
When: 2025-02-26T00:00:00Z 51a5ca8
fix: correct visibility types and lint; remove unsafe casts cabcc8d
feat(cliHost): add overrideRootOptions and adopt in createCli/templates db330c6
feat(batch): inherit logger from base options; remove per-plugin logger a1a10a8
docs(getting-started): fix dynamic vars cross-link anchor 0cb1117
dx(cliHost): make readMergedOptions return a concrete bag (no undefined) 08f599a
fix(cmd): stabilize alias runner under tests; TS/lint cleanup cc79bdb
Fixed readMergedOptions 2e366f5
eliminated redundant typing db47056
test: fix unit tests for runner argv, version duplication, and cmd conflict 94a1479
removed duplicate readMergedOptions 569ebe4
Reorganized repo 8b2fc95
docs: fix CJS interop example and add dynamic import snippet 2753ab6
test(cli): install plugins in unit tests before parse; fix unknown option and arg count errors 2759f29
fix(cli): install plugins before parse; defer hooks to passOptions b0cf1f8
fix(cli): widen helper generics and remove any[] 48322b5
lint: drop unused generic from dynamicOption 9e1c469
docs: finish sync of authoring guides with current host 90f3e11
refactor(cmd): export RunCmdWithContextOptions and use in runner 8018b3f
build: silence rollup TS warning by scoping program to src 33879b8
tests: fix aws exec mock to preserve shouldCapture export 1069da5
resolve circular dependencies f7434cb
refactor: remove dynamicOption in favor of typed factories d9dcced
docs: sync guides with schema and fix shell intro 7143f45
fix(types): wire generic plugin-config helpers and widen help bag 444e69a
build: map "@/..." TS path alias for Rollup bundling 84faa08
fix: relax rootHooks param to resolve typecheck error 202ed68
fix: typecheck for plugin setup return, no runtime changes 110114d
fix: finalize typecheck by returning undefined in batch setup a1dcefe
docs(typedoc): add missing comments for defineGetDotenvConfig 4f07460
added use cases 8f89e3e
tests: remove dynamic imports in aws exec mock; static typed mock 1f19a46
knip fix 51d9660
docs(plan): audit docs and propose README decomposition edd5eca
refactor: sweep remaining unnecessary casts and fallbacks 6cbfeed
test: make redact help tests robust to wrapped output 847a3a4
fix(help): await plugin install before subcommand help routing a27f8de
docs: add TypeDoc for default root options constant b66363b
fix: resolve lint for batch default action emit 99f08bc
chore: fix final lint error in createCli help defaults 5018184
chore: release v6.0.0 ae3f564
npm publish config 11d8199
compose whoami e7c8b5a
fix(batch): remove non-null assertion in defaultCmdAction fb11e78
docs(getting-started): remove demo plugin mention; clarify customization ad152bc
test: relax cmd alias conflict assertion to only check exit 5c00fc7
remove unnecessary casts e064a35
npm skipchecks 78b605f
removed jsx tag 7ab7ce1
disabled npm publishing fcf8a68
npm publish false 70d080e
updated getdotenv config e055b27
filename fix 2fb2f2b
update template cab2cf3

v6.0.0-1

7 December 2025

docs(typedoc): fix broken JSDoc links that caused warnings 400edfa
updated docs 460fc31
fix(cmd/alias): resolve type/lint after decomposition e7c3851
updated requirements 0c4aaa9
refactor(host): remove casts via WeakMaps, plugin generics, and explicit createCommand 7b83677
scripts: verify-types now handles star & multi-hop re-exports 825934e
feat(host/plugins): materialize plugin config defaults; make readConfig non-optional ca3f719
feat(types): canonical options from Zod; typed config builder; generic getDotenv cfa2671
feat(aws): remove add-ctx; set-env follows root load-process; mirror only non-sensitive metadata 6a39f94
feat(host/plugins): instance-bound plugin config; remove by-id accessor d0facab
chore(dx): fix overloads and typing; clean up lint dc0ab85
feat: finalize plugin schema enforcement and DX polish 43384d5
docs/types: add compile-only samples and docs for Vars-aware dynamic and overlayEnv 11df3a1
feat: tighten typing requirements and loader docs b09901c
feat: typed config adoption in aws/batch + docs c5a4028
fix(types): resolveCliOptions generics, scripts guard, docs escape 62007d5
refactor(requirements): adopt instance-bound plugin config, remove by-id d87d8a3
chore(todo): prune Completed and set release tasks 524fbd6
refactor(types): reduce redundant casts and rely on inference a6f0b43
docs: migrate examples to instance-bound helpers and plugin-bound dynamic options 6f1e4e0
Fix overload selection and lint for P1 generics 25ee7ca
Implement P1 generics: defaultsDeep overloads and generic dotenvExpandAll cb13f19
chore: remove legacy attachRootOptions opts and cut casts dea2792
chore(todo): plan instance-bound config, remove by-id, migrate 567609a
feat(dx): adopt dynamic help in aws; unify vars sanitation 120b1ea
Relax defaultsDeep overload bounds to fix TS2554 57faef0
chore: trim diagnostics from Windows alias E2E test 7b5f85a
fix(host/plugins): add instance-bound plugin helpers and dynamic option support 32e212f
fix(cmd/alias): preserve "" in Node -e payloads on Windows 646d5be
refactor: remove unnecessary env casts; return NodeJS.ProcessEnv f54c14b
refactor(exec): prefer typeof string over Array.isArray for argv unions 80a51e9
chore(dx): widen programmatic patterns + exports; minor typing polish b4db7ce
refactor: drop remaining casts; lean on inference for shells/env 4e074e3
refactor(dxi): add omitUndefined/toHelpConfig helpers and apply ed2b209
chore: expand dev plan for typing enhancements fb55360
docs: quick start and npx fix for copy‑paste readiness adb5ca0
tests(e2e): add diagnostics to Windows alias termination test 9aa06c1
fix: make instance helpers required on definePlugin return; add duplicate ns guard c30dff0
fix: resolve typecheck and lint for dynamic options and Zod v4 a956fcf
scripts: make verify-types chase env-overlay re-exports 98e8282
fix(plugins): solidify schema-inferred plugin config and clean AWS types 357a325
chore: fix generic seam, tag cmd alias group, and clean lint 44e6036
chore(verify): assert DynamicFn/DynamicMap and overlayEnv types 7beaa8f
refactor: remove unnecessary casts and explicit annotations for inference fc79987
fix: type-safe dynamic help and help-time parity w/o casts 702f35b
Refocus dev plan on generics and typed helpers ba15e77
fix(types): defaultsDeep impl bound, ScriptsTable shell, and plugin config lint b60af8c
chore: prune Next up to build verification & release 8795396
fix(cliHost/plugins): align plugin-config store typing and dynamic help fallback 8e42b43
fix: resolve compile/lint issues for Zod v4 enforcement 1cf3c06
feat: strict default plugin schema and readonly config surfaces ec9edec
fix(types): overlay options, relax CLI resolver, and lint cleanups 3a04aee
docs: remove by-id helper from shipped pages; add TS notes b49c213
tests(e2e): add rich diagnostics to Windows alias test 1cabe8b
feat(types): Vars-aware defineDynamic and key-preserving overlayEnv 653ab12
chore: align plugin generics, fix TS casts, and clean lint 12385e9
lint(exec): inline pickResult to avoid unsafe assignment 6de4e84
chore: clean up lints for dynamic options and imports 7f2ec32
chore: lint and typecheck templates 140878a
chore(plugins/host): fix lint/typecheck on plugin seam and batch import 0fd1c2c
fix: verify-types chase and typedoc warning ab68ae3
tests(e2e): simulate alias transform; log eval string/quote counts c452ff3
feat(plugins): schema-inferred config and no generics at call sites 0fb4e94
docs(authoring): add typed plugin config accessor example bb5dec5
fix(types,lint): sanitize options and relax deep-merge typing 78430ff
fix: harden cmd alias env bag serialization 3e46240
docs(build): make GetDotenvCliPublic an interface to fix TypeDoc routing cbf8eef
fix(verify-types): robust fallback to source for overlayEnv f3ce748
fix(alias): compat cast at converter boundary for exactOptionals 25ad631
tests: drop env-based per-step timeouts; rely on vitest fd4770d
docs(dev-plan): prune Next up; log completed items e673964
fix(types): compat casts at converter boundaries; TSDoc cleanup 9d96718
chore: fix template lint for number interpolation 632943e
fix(types): add variadic defaultsDeep overload and assert ctx in readPluginConfig 5d05cfb
chore(ci): fix verify-types lint by tracking selected files b6f3129
fix(types): correct overload implementations for defineDynamic and overlayEnv 5b20c8d
fix(verify-types): detect typed-const overlayEnv in d.ts e656aa1
START PATCH DIAGNOSTICS 9e49f5a
fix: revert alias Node execPath substitution (preserve argv) c231eb1
fix: Windows alias Node eval uses process.execPath bb61ae9
chore(lint): remove redundant vars filter in options converter defffc2
fix(types,lint): cast deep-merge via unknown and drop redundant key check 0f33473
fix(types): satisfy InferPluginConfig constraint with GetDotenvOptions 2c9382d
fix(types): clarify Zod boundary and clean unused import b437aff
fix(plugins/host): align dynamic option param type; remove redundant coalescing 85ca94f
docs: add fence-hygiene reminder to project prompt f92cfc0
chore(ci): fix TypeDoc and knip warnings 93336aa
chore(verify): accept generic overlayEnv signature in types check c60c3c0
chore: fix lint issues in cliHost InferPluginConfig d1a4316
lintfix eae6062
refactor(plugins): remove explicit generic args on plugin dynamic options for better DX 4142765
test(e2e): stop enabling GETDOTENV_DEBUG in Windows alias test e23f102
chore: fix alias lint (remove unnecessary coalescing) 417848d
fix: lint errors in cmd alias executor 22da0e6
chore: fix lint (definePlugin generics) and bump test timeout c09abbc
docs: fix shipped plugins index typo (init link) a151ca0
chore: release v6.0.0-1 37a127f
chore(lint): silence false-positive generic lint in definePlugin 6b88a79
fix(types): remove duplicate param in createPluginDynamicOption 238a3fe

v6.0.0-0

3 December 2025

feat!: drop generator path; host-typed root options with dynamic help 5239202
nr docs 3e6c68e
docs: fix Shell guide link in shipped/aws; finalize refactor cf3fa16
updated docs e908284
feat(cli): dynamic help phase 1 (APIs + eval) d4fd4fe
updated docs 60f4549
updated docs 5a75768
docs: refactor plugin docs; add exec guide; split authoring eee48d9
chore: requirements to drop generator; host dynamic help hardening 6bc9dac
interop 859abe7
docs(help): add dynamic help authoring and plugin config notes be9d305
chore: prune plan and remove unused module (knip) efdda61
fix(cli/help): subcommand -h prints subcommand help; reorder sections fb08190
fix: drop generator imports; wire cliCore types; lint/doc cleanup d4f7ea0
build(verify): add bundle sanity check for external commander 50179aa
refactor(help): generic dynamicOption + inferred plugin slice; tag batch opts 285e4ac
docs: zod best-practices and cross-links between plugin config/dynamic help 086734a
refactor(help): infer cfg in dynamic callbacks; test/help tweaks e5d996f
feat(cli): dynamic help for log and entropy-warn flags 78426ed
feat(batch): dynamic help for pkg-cwd/root-path/globs + test d835813
refactor(help): infer cfg in dynamic callbacks; test/help tweaks e5cbf34
fix(cli): resolve dynamic flag duplication; vitest typing; lint 95fe7e9
suppress help output in tests; keep E2E help intact 85ed60e
refactor(batch): simplify dynamic help defaults for root-path and globs 93cde9d
feat(help): always end help output with a blank line; add E2E checks 7fb24c4
chore(demo): silence afterResolve breadcrumb unless debugging 68a98c8
test(e2e): preserve trailing blank line by disabling execa strip f86a87a
chore(help): keep plugin options out of root help; assert via subcommand help 9386791
feat(batch): inject dotenv env into batch child processes 01f8343
fix(help): base-only options in root; show all options for subcommands f30768d
fix(batch): include dotenvEnv param and sanitize overlay for child env 80e0459
test(help): add root dynamic help default-label checks 5edb019
fix(help): remove self plugin group on subcommand help; keep child-injected 69c2ef9
feat: dynamic option descriptions API and plan updates b156070
test(e2e): relax help trailing-newline checks to avoid false negatives cf97c37
fix: normalize trailing newlines for subcommand help (recursive) c89b8d3
fix: ensure subcommand help ends with blank line via output hook 138a9db
fix(help): skip plugin afterResolve during top-level -h to avoid timeouts fb58fdf
fix: ensure help ends with blank line for E2E portability 510cd68
test(help): make trailing-blank-line assertions CRLF-safe and tolerant 3e61688
chore(todo): prune completed items from Next up 6c10225
test: suppress stdout for passing tests; fix imports 018a04a
wip 278b0b3
chore(plan): mark spawn-env normalization done and prune Next up a0900c6
test(help): fix typecheck in root dynamic help test f009953
refactor(demo): use buildSpawnEnv for child env normalization 21731c0
fix(cmd): ensure help prints trailing blank line d478109
chore(todo): prune completed dynamic-help and docs tasks 01f638c
fix: print help when GETDOTENV_STDIO=pipe to satisfy E2E edeb84e
chore(plan): remove completed items from Next up da10122
test(help): resolve TS2353 in root dynamic help test 55ed9c1
chore(test): satisfy vitest config lint rules 1fb8a3a
chore: release v6.0.0-0 c1e2edf
fix(cmd): add Commander Command type import for TS/ESLint 77f5892
chore: release v5.2.6 c1ca443
chore(plan): prune completed items from Next up 8128b28
chore: add optional tasks to dev plan; refresh date 8161c1d
docs: persist follow-up build/docs/test tasks in TODO 5b23216
docs: fix shipped plugins index typo and log in plan d79f435
chore(todo): prune build-output sanity check from Next up 35c893f
docs(plan): prune completed generator-doc cleanup from Next up 1389058

v5.2.6

22 October 2025

updated docs 09e80ad
chore: remove enhancer module and scrub obsolete imports d022068
refactor: make root helpers real class methods; remove side-effect 96e503a
test: fix help.order.test after enhancer removal; satisfy lint de5f250
chore: release v5.2.6 81a8287

v5.2.5

22 October 2025

updated docs 13b26a7
feat(cliHost): make attachRootOptions/passOptions unconditional cd97b45
test(cliHost): fix helpers exposure test to import /cliHost entry 32cecee
chore: release v5.2.5 92d9f5a
moved interop 4231384

v5.2.4

22 October 2025

feat: public host interface + root spawn env export be4d19b
fix: host/plugin seam casting and batch typing 4a011e0
fix: generic plugin seam + batch/cmd typing; cast host to public interface 3294886
stanPath twostep a007a87
chore: release v5.2.4 192104e

v5.2.3

22 October 2025

docs: sync guides with plugins barrel; add SMOZ interop response cdd3699
Unify host type identity; add plugins barrel export 4665cec
fix: resolve TS2307 in rollup; add knip entry; docs barrel 2b073a9
chore: release v5.2.3 b9f69b8

v5.2.2

21 October 2025

build: publish cmd and demo plugin subpaths aa48cbd
chore: release v5.2.2 c8c02be
extended test timeout eba5311

v5.2.1

21 October 2025

docs update 5acf984
updated docs 87d4a9d
Docs: add wiring guide for included plugins in host CLI 1c19e60
feat: switch to get-dotenv host; add cmd/batch; unify env/validation/diagnostics 30ed52f
feat(cli): add canonical createCli export and refactor shipped CLI 45c47cd
fix(interop): short-circuit help before branding to avoid ESM timeout e444c75
fix: short-circuit help in createCli.run to avoid exit in CJS 756255b
test(interop): avoid process.exit on help under Vitest 0e25df0
test(interop): short-circuit help under tests to avoid exit cf8362a
chore: release v5.2.1 f6e62c8
test(interop): set GETDOTENV_TEST for help override in createCli dba54e3

v5.2.0

19 October 2025

docs: adopt SMOZ interop amendment; plan implementation 7ca2a94
updated dependencies 0a354f9
docs: adopt SMOZ interop amendment; plan implementation 20d47a2
docs: partition project prompt into requirements and policies b90a636
docs: partition project prompt into requirements and policies 016433f
interop 769c0f3
feat: spawn env normalization + help ordering polish a714efc
feat(diagnostics): add redaction and entropy warnings with CLI flags 2085ecb
chore(facets): slim next archive with facet overlay and anchors fd8c8aa
feat(validation): add requiredKeys/schema config validation + --strict ba7cba0
plan: prioritize interpolation, validation, diagnostics, and spawn-env 2492c02
chore(todo): trim Next up; clarify release status 149977b
feat(interpolation): add interpolateDeep; phase C and per-plugin wiring e47b598
chore(docs+knip): fix TypeDoc warning and knip findings 5fb4ee9
chore(facets): enable docs facet; plan full documentation sweep c4603b9
docs: add interpolation/validation/diagnostics; bump v5.2.0 cc1e509
chore(facets): add configs and vscode facets (inactive by default) d168f49
fix(phase-c): resolve TS2379 under exactOptionalPropertyTypes cff46ad
chore(facets): peel generator to reduce archive size 0e69c53
chore: release v5.2.0 51010f7
ignore esbuild dependency 2dcb4d1

v5.1.0

22 September 2025

updated docs 5022930
updated docs 7f5d3e1
feat(host): grouped help sections and branding API e9fe52c
refactor(host): decouple from generator; fix type import lint ecfdb75
feat(cli,docs): brand shipped CLI; add branding/app options docs ca56271
Host UX groundwork: ergonomic options accessors and plan update f9be6bd
fix(cli): alias guard, help typing, and wrapper annotations 5654a29
chore: release v5.1.0 c4946a3

v5.0.0

21 September 2025

Removed manual wrapping e844c6a
docs: fix README fences/typos, add guide links; add capture & scripts docs c2a0c3b
docs: unwrap manual wrapping in guides (cascade, generated CLI) 501245b
chore: release v5.0.0 3a622cd

v5.0.0-2

21 September 2025

test(generator): runtime parity for cmd and batch behaviors 04d0ac9
BEGIN_STAN_PATCH_FEEDBACK v1 66ea9ae
fix(generator): correct action signatures for variadic args b46f831
fix(generator): accept positional args for cmd subcommands 39dfa9d
fix(generator): avoid double exec for batch -c by early-return 9f5dc3a
chore: release v5.0.0-2 cee3f49

v5.0.0-1

21 September 2025

fix(cli-compat): accept object vars/array paths; bump timeouts for stability 8ea49ba
fix(cli-compat): tolerate object vars and array paths in CLI defaults d8b1b67
fix: lint error and stabilize E2E timeouts 730c30b
fix(converter): drop undefined vars; fix array check lint in paths 8d7868e
chore: release v5.0.0-1 7c658d6

v5.0.0-0

21 September 2025

updated dependencies d08dc47
reinstalled dependencies d807e4b
updated docs a8e8f23
decomposition 3428720
feat(cli): always-on config loader + shared cliCore flags 2467d1d
updated docs 08c53a8
init: add local config patterns to .gitignore 2c3f17f
updated docs 66892f8
feat(exec,plugins): add captured exec helper and AWS base plugin (host-only) cd36fb0
refactor(cli): host-based shipped CLI, plugin configs, and neutral batch services fc03d0f
feat: add config loader (JSON/YAML) and env overlay engine 56f05b3
feat: subpath exports, shared dynamic loader, and host demo CLI cbe2599
feat(init): scaffold configs and host CLI with templates 61708ce
docs: plugin docs and guides index refinements 764a1ce
refactor(cliHost): extract computeContext and slim GetDotenvCli 1f6d1f4
fix(batch): support implicit positional command on parent 68a33f1
fix(batch): capture positional args in default cmd action f1a72be
refactor(batch): split oversized handlers into actions modules efd790d
wip 320f877
feat(cmd): parent-level alias option and root preAction; fix batch regressions e79a4fb
feat(cli): add AWS subcommand and wire aws plugin 99f0eef
fix(cmd): type opts() usage to remove unsafe-any e272522
feat: JS/TS config support and host integration flag 5d68899
chore: migrate to Zod v4 and @vitest/eslint-plugin d6c3e98
chore: update stan.todo after aws test fixes 01124a2
feat(plugin): add batch plugin + parity tests 11f2bfa
docs: clarify loader as always-on; add roadmap & policy 7f1e4ab
fix(aws): stabilize subcommand and tests; lint clean f25b070
fix(cli): repair attachRootOptions chain; ensure batch cmd consumes variadic args 2695b0d
fix(aws): correct subcommand arg parsing; relax E2E timeout 24b4664
e2e: use argv arrays to avoid Windows quoting; stabilize tests f1a634b
feat(host): add plugin-first CLI host skeleton 6af8d44
docs: add plugin-first host and schema plan; update TODO d63e9f1
docs: add guides for config overlays and plugin host; wire into docs 414c58b
fix: complete generics pass, host typing, and lint cleanup 78f9fa6
feat(cli/batch): support implicit positional command; adopt -c, --cmd alias d7dd419
feat(cli): add demo plugin with annotated examples 3d29c19
chore(verify): fall back to npm-packlist when npm is unavailable 4cef186
docs: unify guides nav; add Generated CLI page; expose aws subpath 9d3bdc4
fix(cmd/alias): run alias-only path in preSubcommand too 03088a9
chore(tools): add smoke script and stan wiring for manual suite 49c6e3c
fix(cli): honor --shell-off with execa argv and stabilize batch globs 4a4babe
refactor(cli): split batch/cmd modules; wire init helpers; fix lint ace672a
refactor(exec): centralize run helper; harden tokenizer 23c6456
test: add schema validation tests 95debf8
init: CI-aware non-interactive detection + docs c910ff5
test(e2e): add core CLI E2E suite (options/cmd/batch) 35a4fc5
fix: Windows alias --cmd node -e termination and clean up 2067dbb
feat(cli): guarded config-loader flag and shared resolver 5374715
test(tokenize): align tests with doubled-quote semantics b62a9f1
feat(schemas): add initial Zod schemas and packaged defaults 72ccf90
fix(batch): resolve scripts/shell from merged CLI options; lint cleanup e24cc90
docs: add AWS base plugin requirements; plan next-up work 9022c11
chore(templates/pkg): add env-aware dynamic examples and verify script cb20003
fix(cli): cmd plugin TS/lint; batch default-subcmd bridges list/--command d4141a0
Enable JS/TS config support in loader 5c6f27d
feat(cli): add --capture and GETDOTENV_STDIO=pipe to capture child stdio bb40415
feat(cli): chainable attachRootOptions/passOptions (adapter-layer) b7a493b
chore: add tarball verification and pack dry-run 5d48a6e
feat(cli): add cmd plugin and make it default dd4e03b
test(e2e): add platform-guarded quoting tests for POSIX and PowerShell dc83871
test(e2e): add Windows alias termination vitest with timeout 81a5ace
fix(verify): add files-field fallback to verify-tarball dccd89f
fix(batch): treat -l/--list in default subcommand as list globs 3c763fc
feat(trace): add --trace (optional keys) diagnostics for child env composition f52b1f5
fix(batch,host,tests): typing/lint fixes and stabilize esbuild tests 34d24d3
fix(exec): exact-optional env/stdio and env sanitization e35a851
fix(batch): accept positional args for default cmd; use typed scripts/shell de9f625
chore(verify): add rich diagnostics to verify-tarball 1a972e7
batch: preserve argv arrays for shell-off; fix E2E 766a711
feat(requirements): add entropy warning design (no masking) 0db5bc4
fix(cli): allow positional args for batch via default cmd subcommand; fix TS merge error b1c69c9
feat: relax Node engines to >=18 and add default-shell smoke c0ccb9b
feat(cache): trim old compiled dynamic TS cache files; fix tests c48a44a
fix(cmd): preserve argv when shell-off to avoid breaking node -e on Windows 732860c
docs(scaffold): add README section and plugin guide note 78863ec
fix(cmd/alias): robust termination on success and error paths c10371d
smoke: enforce per-step timeouts and capture outputs 0be9143
fix(batch): register plugin before parse; type-safe calls/tests e9726dc
docs(typedoc): export DefineSpec, fix links; refresh guides and README 40e7f79
fix(cli): stabilize cmd variadic args and batch globs parsing 1a7f251
fix(cmd): exit alias only for real runs; clean ESLint guards aef71c4
fix(exec,aws): resolve TS/ESLint issues; harden parsing and optional fields 8d4024a
fix(alias): TS guards and fallback detection for node -e b2ef363
docs(todo): tests green; focus next on argv/quoting tests and docs 1158b95
test(e2e): use positional cmd instead of alias to avoid Windows hang 899a9a7
fix(batch): narrow exec command type and header rendering a19d816
fix: wire batch plugin via action; fix tests typing 703d24c
fix(cmd): guard exitCode, skip process.exit under test; lint rule 390c0af
fix(cli): TS/lint in cmd & batch; alias conflict test robustness 20213f8
fix: add useConfigLoader to GetDotenvOptions 562baba
smoke: emit trace diagnostics; collapse stacked quotes 9f31793
feat(alias): add forced-exit guard; stabilize Windows alias test 72796a0
fix: parser error in preSubcommandHook and finalize typing/lint e87dd0f
fix(batch): honor -l with positional tokens under default subcommand 478b95e
fix(init): commander opts binding, types, and template exclusions a56cf8a
fix: honor individual exclude flags (-r) in tri-state resolver 58b966e
wip 20bbcd4
fix(cmd/alias): dedupe alias execution and fix hook typings c11163c
fix(cli): avoid double logging with -l by suppressing base log in loader path 34d8cc8
fix(host): complete tests and tsdoc example 652482c
fix(batch): stabilize default cmd subcommand and flag access 026d975
fix: batch plugin tests, host parent options, and lint 25d6f39
fix(exec): conditionally include cwd in execa options 1ae91e5
chore(debug): instrument alias/run paths for E2E timeouts e9b5804
chore(test): narrow coverage to src and exclude non-source 31f9b0c
fix(verify): prefer files-field fallback before npm-packlist; fix expected list 9311b1c
fix(verify): make npm-packlist fallback robust (pass package.json) e8a3179
test: quote alias payload to prevent hang 042e688
feat(host): strict schema validation + tests; silence docs warn 3863312
cli: default omit root -c; generator opts in 3306138
fix(alias): remove ?? and narrow tokens to satisfy TS/lint 79647f3
fix(cmd/run): strip outer quotes from argv for shell-off execa 572a845
chore: peg Node engines to >=20 and align esbuild targets 808165a
test(e2e): make alias termination test exit under Vitest 4baa4d1
docs: fix TypeDoc link, README formatting; dev plan newline db125b7
fix(cmd/alias): always terminate alias-only runs outside tests fb08f07
batch(exec): run array commands; array-only for node -e shell-off efe03a4
batch(exec): fix TS for execaCommand; keep parent path string 5f2acaa
fix(cli): make --cmd alias exit with child code; stop Windows timeouts 07ad8af
fix: robust verify-tarball parsing for npm pack --json 645948a
fix(cmd): restore robust shell-off quoting and execaCommand typing c1cc73d
fix(verify-tarball): remove TS casts; keep ESM .mjs 44d26e0
fix(cmd): preserve argv array for --shell-off to avoid re-tokenization aaab254
feat(host): add --use-config-loader flag to demo CLI ba0ac52
fix(host): avoid process.env mutation in skeleton preSubcommand a809137
fix(cmd): pass ctx.dotenv to child env to honor exclusions 2738f89
fix: cast opts() to Partial<T>, drop redundant defaulting, and remove unused import 256bb48
test(cmd/alias): force stdio inherit under tests; suppress capture b64c340
chore: refine knip scope to stop false unused deps 5ea5d36
fix(host): exactOptional casts and ctx storage 075b063
fix(exec): accept cwd in shared run helper c9a8569
chore(lint): fix debug helpers in cmd alias/run; update plan 22cec03
chore: fix lint in loader and overlay docs 317194d
fix(cmd/alias): suppress fallback exit under tests; docs update f7b4e50
added env var logging test 4cdcd26
refactor: accept unknown in resolveCliOptions to avoid call-site casts fcb6f80
test(e2e): pass dataset tokens for ./test/full (dotenv/private) 7187344
fix(cli): force exit on alias capture path when exitCode is NaN 8e0e43c
fix(batch): allow list-only mode without command; improve headers 7ebdb74
fix: exact-optional and lint cleanups in host and loader 6d6bb59
fix(cli): make loadProcess OFF by default; lint alias; stabilize exclude-private fe73184
docs(plan): set next focus to E2E quoting tests; init finalized 3992f44
Added e2e test to display help 81d9623
test(cmd): guard mocked execa result with optional chaining 76270ca
resolved typedoc issues 74bdfe3
docs(cli): document --use-config-loader in README help 5916b43
chore: fix TSDoc '>' escapes to satisfy lint 5f557a1
test(e2e): fix lint and stabilize Windows flows for output/secret 692def8
fix(cmd): accept positional tokens to avoid Commander arg errors 6a673d2
fix(init): use captured command for opts() to stabilize action handler 4516832
test: deflake dynamic TS fallback error-path with longer timeout e5a4491
chore: assert aws export in verify script; update plan 6bbf7f4
chore(knip): include host demo, disable duplicates, drop ignores 9351a18
docs(plan): record init scaffolding stabilization and next steps 72da1f2
fix: restore abs declaration in config loader f753ce2
rationalized scripts aeeffff
Refactored scripts 2c84e3f
wip 85a8a8a
fix(init-test): assert config files to satisfy ESLint 4a5f3dd
test(lint): fix require-await in schema gen opts test 3451d33
updated stan 28ef052
chore: release v5.0.0-0 04a9fde
fixed readme 468bc1e
chore: knip cleanup and update dev plan timestamp 2b4fc4d
bugfix 91dfa69
updated test 5e8a8b4