envilder 0.14.0 → 0.15.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 (118) hide show
  1. package/README.md +55 -13
  2. package/ROADMAP.md +50 -23
  3. package/docs/SECURITY.md +35 -9
  4. package/docs/changelogs/cli.md +139 -3
  5. package/docs/changelogs/gha.md +45 -2
  6. package/docs/changelogs/sdk-dotnet.md +34 -2
  7. package/docs/changelogs/sdk-nodejs.md +22 -5
  8. package/docs/changelogs/sdk-python.md +19 -2
  9. package/docs/exec-command.md +492 -0
  10. package/lib/envilder/apps/cli/Startup.d.ts +9 -0
  11. package/lib/envilder/apps/cli/Startup.d.ts.map +1 -1
  12. package/lib/envilder/apps/cli/Startup.js +39 -0
  13. package/lib/envilder/apps/cli/Startup.js.map +1 -1
  14. package/lib/envilder/apps/cli/entry/Cli.d.ts.map +1 -1
  15. package/lib/envilder/apps/cli/entry/Cli.js +346 -13
  16. package/lib/envilder/apps/cli/entry/Cli.js.map +1 -1
  17. package/lib/envilder/apps/cli/errors/CliErrorPresenter.d.ts.map +1 -1
  18. package/lib/envilder/apps/cli/errors/CliErrorPresenter.js +4 -1
  19. package/lib/envilder/apps/cli/errors/CliErrorPresenter.js.map +1 -1
  20. package/lib/envilder/apps/cli/errors/ParseErrorRedactor.d.ts +33 -0
  21. package/lib/envilder/apps/cli/errors/ParseErrorRedactor.d.ts.map +1 -0
  22. package/lib/envilder/apps/cli/errors/ParseErrorRedactor.js +121 -0
  23. package/lib/envilder/apps/cli/errors/ParseErrorRedactor.js.map +1 -0
  24. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.d.ts +13 -0
  25. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.d.ts.map +1 -1
  26. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.js +29 -13
  27. package/lib/envilder/apps/cli/recovery/SsoLoginRecovery.js.map +1 -1
  28. package/lib/envilder/apps/shared/ContainerConfiguration.d.ts +2 -1
  29. package/lib/envilder/apps/shared/ContainerConfiguration.d.ts.map +1 -1
  30. package/lib/envilder/apps/shared/ContainerConfiguration.js +4 -2
  31. package/lib/envilder/apps/shared/ContainerConfiguration.js.map +1 -1
  32. package/lib/envilder/core/application/dispatch/DispatchActionCommand.d.ts +18 -1
  33. package/lib/envilder/core/application/dispatch/DispatchActionCommand.d.ts.map +1 -1
  34. package/lib/envilder/core/application/dispatch/DispatchActionCommand.js +17 -1
  35. package/lib/envilder/core/application/dispatch/DispatchActionCommand.js.map +1 -1
  36. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts +9 -2
  37. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.d.ts.map +1 -1
  38. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js +28 -3
  39. package/lib/envilder/core/application/dispatch/DispatchActionCommandHandler.js.map +1 -1
  40. package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.d.ts +13 -0
  41. package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.d.ts.map +1 -0
  42. package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.js +19 -0
  43. package/lib/envilder/core/application/execWithSecrets/CommandLineFormatter.js.map +1 -0
  44. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.d.ts +20 -0
  45. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.d.ts.map +1 -0
  46. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.js +19 -0
  47. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommand.js.map +1 -0
  48. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.d.ts +61 -0
  49. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.d.ts.map +1 -0
  50. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.js +159 -0
  51. package/lib/envilder/core/application/execWithSecrets/ExecWithSecretsCommandHandler.js.map +1 -0
  52. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts +1 -9
  53. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.d.ts.map +1 -1
  54. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js +9 -79
  55. package/lib/envilder/core/application/pullSecretsToEnv/PullSecretsToEnvCommandHandler.js.map +1 -1
  56. package/lib/envilder/core/application/secretResolution/SecretResolver.d.ts +66 -0
  57. package/lib/envilder/core/application/secretResolution/SecretResolver.d.ts.map +1 -0
  58. package/lib/envilder/core/application/secretResolution/SecretResolver.js +132 -0
  59. package/lib/envilder/core/application/secretResolution/SecretResolver.js.map +1 -0
  60. package/lib/envilder/core/domain/ChildEnvironment.d.ts +22 -0
  61. package/lib/envilder/core/domain/ChildEnvironment.d.ts.map +1 -0
  62. package/lib/envilder/core/domain/ChildEnvironment.js +50 -0
  63. package/lib/envilder/core/domain/ChildEnvironment.js.map +1 -0
  64. package/lib/envilder/core/domain/ExecExitCode.d.ts +14 -0
  65. package/lib/envilder/core/domain/ExecExitCode.d.ts.map +1 -0
  66. package/lib/envilder/core/domain/ExecExitCode.js +23 -0
  67. package/lib/envilder/core/domain/ExecExitCode.js.map +1 -0
  68. package/lib/envilder/core/domain/OperationMode.d.ts +2 -1
  69. package/lib/envilder/core/domain/OperationMode.d.ts.map +1 -1
  70. package/lib/envilder/core/domain/OperationMode.js +1 -0
  71. package/lib/envilder/core/domain/OperationMode.js.map +1 -1
  72. package/lib/envilder/core/domain/errors/DomainErrors.d.ts +44 -0
  73. package/lib/envilder/core/domain/errors/DomainErrors.d.ts.map +1 -1
  74. package/lib/envilder/core/domain/errors/DomainErrors.js +57 -0
  75. package/lib/envilder/core/domain/errors/DomainErrors.js.map +1 -1
  76. package/lib/envilder/core/domain/ports/IProcessContext.d.ts +14 -0
  77. package/lib/envilder/core/domain/ports/IProcessContext.d.ts.map +1 -0
  78. package/lib/envilder/core/domain/ports/IProcessContext.js +2 -0
  79. package/lib/envilder/core/domain/ports/IProcessContext.js.map +1 -0
  80. package/lib/envilder/core/domain/ports/IProcessRunner.d.ts +27 -0
  81. package/lib/envilder/core/domain/ports/IProcessRunner.d.ts.map +1 -0
  82. package/lib/envilder/core/domain/ports/IProcessRunner.js +2 -0
  83. package/lib/envilder/core/domain/ports/IProcessRunner.js.map +1 -0
  84. package/lib/envilder/core/domain/ports/ISecretMasker.d.ts +7 -0
  85. package/lib/envilder/core/domain/ports/ISecretMasker.d.ts.map +1 -1
  86. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.d.ts +5 -1
  87. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.d.ts.map +1 -1
  88. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.js +3 -2
  89. package/lib/envilder/core/infrastructure/aws/AwsSecretProviderFactory.js.map +1 -1
  90. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts +6 -1
  91. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.d.ts.map +1 -1
  92. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js +10 -3
  93. package/lib/envilder/core/infrastructure/aws/AwsSsmSecretProvider.js.map +1 -1
  94. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.d.ts +22 -0
  95. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.d.ts.map +1 -1
  96. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.js +38 -1
  97. package/lib/envilder/core/infrastructure/github/GitHubActionsSecretMasker.js.map +1 -1
  98. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.d.ts +1 -0
  99. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.d.ts.map +1 -1
  100. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.js +3 -0
  101. package/lib/envilder/core/infrastructure/github/NoOpSecretMasker.js.map +1 -1
  102. package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.d.ts +11 -0
  103. package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.d.ts.map +1 -0
  104. package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.js +27 -0
  105. package/lib/envilder/core/infrastructure/logger/StderrConsoleLogger.js.map +1 -0
  106. package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.d.ts +15 -0
  107. package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.d.ts.map +1 -0
  108. package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.js +145 -0
  109. package/lib/envilder/core/infrastructure/process/CrossSpawnProcessRunner.js.map +1 -0
  110. package/lib/envilder/core/infrastructure/process/NodeProcessContext.d.ts +11 -0
  111. package/lib/envilder/core/infrastructure/process/NodeProcessContext.d.ts.map +1 -0
  112. package/lib/envilder/core/infrastructure/process/NodeProcessContext.js +18 -0
  113. package/lib/envilder/core/infrastructure/process/NodeProcessContext.js.map +1 -0
  114. package/lib/envilder/core/types.d.ts +6 -0
  115. package/lib/envilder/core/types.d.ts.map +1 -1
  116. package/lib/envilder/core/types.js +3 -0
  117. package/lib/envilder/core/types.js.map +1 -1
  118. package/package.json +15 -8
package/README.md CHANGED
@@ -14,7 +14,11 @@
14
14
  [![npm downloads](https://img.shields.io/npm/dm/envilder.svg)](https://npmcharts.com/compare/envilder)
15
15
  [![CI Tests](https://github.com/macalbert/envilder/actions/workflows/tests.yml/badge.svg)](https://github.com/macalbert/envilder/actions/workflows/tests.yml)
16
16
  [![Overall Coverage](https://macalbert.github.io/envilder/badge_combined.svg)](https://macalbert.github.io/envilder/)
17
+ [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/15703/badge)](https://www.bestpractices.dev/projects/15703)
18
+ [![Known Vulnerabilities](https://snyk.io/test/github/macalbert/envilder/badge.svg)](https://snyk.io/test/github/macalbert/envilder)
17
19
  [![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
20
+ [![Context7](https://img.shields.io/badge/Context7-docs_for_AI_agents-blue.svg)](https://context7.com/macalbert/envilder)
21
+ [![CodeRabbit Pull Request Reviews](https://img.shields.io/coderabbit/prs/github/macalbert/envilder?utm_source=oss&utm_medium=github&utm_campaign=macalbert%2Fenvilder&labelColor=171717&color=FF570A&link=https%3A%2F%2Fcoderabbit.ai&label=CodeRabbit+Reviews)](https://coderabbit.ai)
18
22
 
19
23
  ## Why Envilder?
20
24
 
@@ -34,6 +38,9 @@ npx envilder
34
38
 
35
39
  # Or with explicit paths
36
40
  npx envilder --map=envilder.json --envfile=.env
41
+
42
+ # Or skip the file: run your app with the secrets in memory
43
+ npx envilder exec -- npm run dev
37
44
  ```
38
45
 
39
46
  No SaaS middleman. One versioned mapping contract. Secrets stay in your cloud.
@@ -48,6 +55,9 @@ No SaaS middleman. One versioned mapping contract. Secrets stay in your cloud.
48
55
  - **No single mapping contract.** Your cloud provider may be the source of truth for secret
49
56
  values, but each environment still needs to know how application variables map to those
50
57
  secrets. Without a versioned contract, dev, staging, and production configurations drift apart.
58
+ - **The `.env` file is readable by everything in your repo.** `.gitignore` keeps it out of commits,
59
+ not out of reach. Editors, indexers, install scripts, and AI coding agents can all read the
60
+ plaintext values sitting in your working tree.
51
61
 
52
62
  ## How Envilder solves it
53
63
 
@@ -55,6 +65,8 @@ No SaaS middleman. One versioned mapping contract. Secrets stay in your cloud.
55
65
  needs and where they live. Git-versioned, PR-reviewable, and reused across environments.
56
66
  - ⚡ **Works everywhere your code runs.** CLI for local dev, GitHub Action for CI/CD, runtime SDKs
57
67
  for application startup. Same file, same result.
68
+ - 🚫 **No `.env` file when you don't want one.** `envilder exec` starts any command with the
69
+ secrets in its environment, in any language, without writing anything to disk.
58
70
  - 🔄 **Rotate secrets without config drift.** Keep application-facing variable names stable while
59
71
  rotating real secret values in AWS SSM or Azure Key Vault. Generated `.env` files update only
60
72
  when Envilder runs again; runtime consumers must restart or resolve again.
@@ -68,6 +80,7 @@ No SaaS middleman. One versioned mapping contract. Secrets stay in your cloud.
68
80
  |---------|-------------|
69
81
  | 📋 **Declarative Mapping** | One JSON file defines how application variables map to cloud secrets. Git-versioned, PR-reviewable, and diff-able |
70
82
  | ☁️ **Cloud-native Providers** | AWS SSM and Azure Key Vault today |
83
+ | ⚡ **Exec Mode** | `envilder exec -- <command>` runs any command with the secrets in its environment. Nothing written to disk, fail-closed, exit codes propagated. [Guide](docs/exec-command.md) |
71
84
  | 🔌 **Runtime SDKs** | Load secrets into memory at app startup: [.NET](./src/sdks/dotnet/README.md), [Python](./src/sdks/python/README.md), [Node.js](./src/sdks/nodejs/README.md). No `.env` on disk |
72
85
  | ⚙️ **GitHub Action** | Pull secrets in CI/CD. Same mapping, zero manual config |
73
86
  | 🔄 **Pull & Controlled Push** | Pull secrets to `.env`, or intentionally push local values to your cloud provider when bootstrapping or rotating |
@@ -114,6 +127,22 @@ Add `.env` to `.gitignore`. The mapping file is versioned and reviewable in PRs.
114
127
  > 💡 Using Azure Key Vault? Add a `$config` section to your mapping file.
115
128
  > See [Mapping File Format](#️-mapping-file-format) below.
116
129
 
130
+ ### 4. Or skip the `.env` file entirely
131
+
132
+ ```bash
133
+ npx envilder exec -- npm run dev
134
+ ```
135
+
136
+ `envilder exec` resolves the same mapping and starts your command with the secrets in its environment.
137
+ Nothing is written to disk. Envilder options go before the command (or before an optional `--`); everything
138
+ after belongs to your command. Exec mode is fail-closed: the command does not start if any secret is missing.
139
+ It is not a sandbox: your command and everything it starts can read the secrets.
140
+
141
+ 📖 See the [Exec Command Guide](docs/exec-command.md) for exit codes, signals and GitHub Actions masking.
142
+
143
+ 💡 Runnable examples: [envilder-examples](https://github.com/macalbert/envilder-examples) (Testcontainers and Aspire for
144
+ .NET, Python and TypeScript, AWS SSM and Azure Key Vault, plus `envilder exec`).
145
+
117
146
  ### 🎥 See it in action
118
147
 
119
148
  Watch how easy it is to automate your `.env` management in less than 1 minute:
@@ -238,7 +267,7 @@ Env.Load("envilder.json");
238
267
  var dbPassword = Environment.GetEnvironmentVariable("DB_PASSWORD");
239
268
  ```
240
269
 
241
- 📖 **[Full .NET SDK docs](./src/sdks/dotnet/README.md)** · 💡 **[Examples](./examples/sdk/dotnet/)**
270
+ 📖 **[Full .NET SDK docs](./src/sdks/dotnet/README.md)** · 💡 **Examples:** [Testcontainers](https://github.com/macalbert/envilder-examples/tree/main/dotnet-testcontainers) · [Aspire](https://github.com/macalbert/envilder-examples/tree/main/dotnet-aspire)
242
271
 
243
272
  ### Python SDK
244
273
 
@@ -271,7 +300,7 @@ Envilder.load('production', {
271
300
  })
272
301
  ```
273
302
 
274
- 📖 **[Full Python SDK docs](./src/sdks/python/README.md)** · 💡 **[Examples](./examples/sdk/python/)**
303
+ 📖 **[Full Python SDK docs](./src/sdks/python/README.md)** · 💡 **Examples:** [Testcontainers](https://github.com/macalbert/envilder-examples/tree/main/python-testcontainers)
275
304
 
276
305
  ### Node.js SDK
277
306
 
@@ -301,7 +330,7 @@ const secrets = await Envilder.fromMapFile('envilder.json')
301
330
  .resolve();
302
331
  ```
303
332
 
304
- 📖 **[Full Node.js SDK docs](./src/sdks/nodejs/README.md)** · 💡 **[Examples](./examples/sdk/nodejs/)**
333
+ 📖 **[Full Node.js SDK docs](./src/sdks/nodejs/README.md)** · 💡 **Examples:** [Testcontainers](https://github.com/macalbert/envilder-examples/tree/main/typescript-testcontainers) · [Aspire](https://github.com/macalbert/envilder-examples/tree/main/typescript-aspire)
305
334
 
306
335
  ## 🤖 GitHub Action
307
336
 
@@ -350,6 +379,11 @@ prebuilt action, so consumers do not need an Envilder build step.
350
379
  - [📖 Full Documentation](https://envilder.com/docs/getting-started/?utm_source=npm&utm_medium=readme&utm_campaign=root-docs): the complete guide at envilder.com
351
380
  - [Push Command Guide](docs/push-command.md)
352
381
  - [Pull Command Guide](docs/pull-command.md)
382
+ - [Exec Command Guide](docs/exec-command.md)
383
+ - [envilder-examples](https://github.com/macalbert/envilder-examples): runnable examples for the SDKs and `envilder exec`
384
+ (Testcontainers and Aspire, AWS SSM and Azure Key Vault)
385
+ - [🤖 Envilder on Context7](https://context7.com/macalbert/envilder): up-to-date docs for AI coding assistants
386
+ (Claude Code, Cursor, Copilot). Add `use context7` to your prompt, or reference the library ID `/macalbert/envilder`.
353
387
 
354
388
  ## 🛠️ How it works
355
389
 
@@ -357,6 +391,7 @@ prebuilt action, so consumers do not need an Envilder build step.
357
391
  graph LR
358
392
  A["Mapping Contract<br/>(envilder.json)"] --> B[Envilder]:::core
359
393
  B --> C["CLI → .env file"]
394
+ B --> X["CLI exec → process env"]
360
395
  B --> D["GitHub Action → CI/CD"]
361
396
  B --> E["SDK → app memory"]
362
397
  F["AWS SSM / Azure Key Vault"]:::cloud --> B
@@ -367,7 +402,8 @@ graph LR
367
402
 
368
403
  1. **Define**: create an `envilder.json` mapping env var names to cloud secret paths
369
404
  2. **Resolve**: Envilder fetches each secret from your cloud vault
370
- 3. **Deliver**: secrets arrive as a `.env` file (CLI/GHA) or in-memory (SDKs)
405
+ 3. **Deliver**: secrets arrive as a `.env` file (CLI/GHA), in the environment of a command you
406
+ start with `envilder exec` (CLI), or in-memory (SDKs)
371
407
  4. **Rotate**: update secret values in your cloud provider while keeping the same
372
408
  application-facing mapping. Rerun Envilder to refresh a generated `.env`, or restart/re-resolve
373
409
  in runtime consumers
@@ -387,11 +423,15 @@ layer that makes those secrets usable consistently across local development, CI/
387
423
  Use Envilder when your secrets already live in your cloud provider and you want one versioned
388
424
  `envilder.json` mapping contract everywhere your code runs.
389
425
 
426
+ `envilder exec` is not a sandbox either. It keeps secrets off the disk, but it does not isolate
427
+ the process: your command and every process it starts can read them. It also leaves an existing
428
+ `.env` file untouched, so delete it yourself when you move from pull mode to exec mode.
429
+
390
430
  ## 🏁 What's Next
391
431
 
392
- Envilder already covers CLI, GitHub Action, and runtime SDKs for .NET, Python, and Node.js.
432
+ Envilder already covers CLI (including `envilder exec`), GitHub Action, and runtime SDKs for .NET, Python, and Node.js.
393
433
 
394
- Next priorities include Go and Java SDKs, GCP Secret Manager, and exec mode.
434
+ Next priorities include Go and Java SDKs and GCP Secret Manager.
395
435
 
396
436
  See the [full roadmap](./ROADMAP.md).
397
437
 
@@ -414,17 +454,19 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md).
414
454
  <img src="./src/website/public/localstack-logo-horizontal-Dark.svg" alt="LocalStack" height="40">
415
455
  </picture>
416
456
  </a>
417
- </p>
418
-
419
- <p align="center">
420
- Supported by <a href="https://localstack.cloud">LocalStack</a>.
457
+ &nbsp;&nbsp;&nbsp;
458
+ <a href="https://snyk.io/open-source/" target="_blank" rel="noopener noreferrer">
459
+ <picture>
460
+ <source media="(prefers-color-scheme: dark)" srcset="./src/website/public/snyk-logo-Light.svg">
461
+ <source media="(prefers-color-scheme: light)" srcset="./src/website/public/snyk-logo-Dark.svg">
462
+ <img src="./src/website/public/snyk-logo-Dark.svg" alt="Snyk" height="40">
463
+ </picture>
464
+ </a>
421
465
  </p>
422
466
 
423
467
  <p align="center">
424
468
  Envilder is also supported through the
425
- <a href="https://aws.amazon.com/blogs/opensource/aws-cloud-credits-for-open-source-projects-affirming-our-commitment/">
426
- AWS Open Source Credits Program
427
- </a>.
469
+ <a href="https://aws.amazon.com/blogs/opensource/aws-cloud-credits-for-open-source-projects-affirming-our-commitment/">AWS Open Source Credits Program</a>.
428
470
  </p>
429
471
 
430
472
  ## 📜 License
package/ROADMAP.md CHANGED
@@ -11,6 +11,9 @@ or directly inside application code at runtime.
11
11
  > **Note:** This roadmap contains ideas and potential features based on initial vision and community feedback.
12
12
  > Not all features are guaranteed to be implemented. Priorities may change based on user needs, feedback,
13
13
  > and real-world usage patterns. Your input matters. Feel free to share your thoughts and suggestions!
14
+ >
15
+ > **Horizon:** "Up Next" covers the coming months and "Planned" the rest of the next twelve months
16
+ > (through October 2027). The [Out of scope](#-out-of-scope) section lists what Envilder does not intend to do.
14
17
 
15
18
  ---
16
19
 
@@ -18,41 +21,65 @@ or directly inside application code at runtime.
18
21
 
19
22
  ### ✅ Shipped
20
23
 
21
- | Feature | Notes |
22
- |---------|-------|
23
- | **Mapping-based resolution** | Core functionality |
24
- | **`.env` file generation** | Core functionality |
25
- | **AWS SSM Parameter Store** | Default provider |
26
- | **AWS profile support** | `--profile` flag |
27
- | **Push mode** (`--push`) | [Guide](./docs/push-command.md) |
28
- | **GitHub Action** | [Documentation](./github-action/README.md) |
29
- | **Azure Key Vault** | Multi-backend via `$config` map-file section ([#90](https://github.com/macalbert/envilder/pull/90)) |
30
- | **Documentation website** | [envilder.com](https://envilder.com) |
31
- | **Onboarding documentation** | [Setup guide](./docs/requirements-installation.md) |
32
- | **.NET SDK** (`Envilder`) | First runtime SDK: load secrets into `IConfiguration` or `EnvilderClient`. AWS SSM + Azure Key Vault. [Documentation](./src/sdks/dotnet/README.md) |
33
- | **Python SDK** (`envilder`) | Runtime library for Python: Django, FastAPI, data pipelines. Sync API with `EnvilderClient`, `MapFileParser`, `SecretProviderFactory`. AWS SSM + Azure Key Vault. Published to PyPI. [Documentation](./src/sdks/python/README.md) |
34
- | **Node.js SDK** (`@envilder/sdk`) | Runtime library for Node.js: load secrets directly into `process.env` from a map-file. AWS SSM + Azure Key Vault. Published to npm. [Documentation](./src/sdks/nodejs/README.md) |
24
+ Versions refer to each component's own changelog: [CLI](./docs/changelogs/cli.md), [GitHub Action](./docs/changelogs/gha.md), [.NET SDK](./docs/changelogs/sdk-dotnet.md), [Python SDK](./docs/changelogs/sdk-python.md) and [Node.js SDK](./docs/changelogs/sdk-nodejs.md).
25
+
26
+ | Feature | Version | Notes |
27
+ |---------|---------|-------|
28
+ | **Mapping-based resolution** | CLI v0.1.4 | Core functionality: resolve every variable declared in a JSON map file |
29
+ | **`.env` file generation** | CLI v0.1.4 | Core functionality |
30
+ | **AWS SSM Parameter Store** | CLI v0.1.4 | Default provider |
31
+ | **AWS profile support** | CLI v0.3.0 | `--profile` flag |
32
+ | **Push mode** (`--push`) | CLI v0.6.0 | Upload a `.env` file or a single variable (`--key`, `--value`, `--secret-path`) to the provider. Throttling retry and duplicate path checks since v0.7.7. [Guide](./docs/push-command.md) |
33
+ | **GitHub Action** | Action v0.7.0 | Pull secrets into `.env` files during workflow runs. [Documentation](./github-action/README.md) |
34
+ | **Azure Key Vault** | CLI v0.8.0, Action v0.8.0 | `--provider`, `--vault-url` and the `$config` map-file section. Precedence: flags > `$config` > defaults ([#90](https://github.com/macalbert/envilder/pull/90)) |
35
+ | **Documentation website** | CLI v0.9.1 | [envilder.com](https://envilder.com), in English, Spanish and Catalan. [Setup guide](./docs/requirements-installation.md) |
36
+ | **.NET SDK** (`Envilder`) | .NET SDK v0.1.0 | Load secrets into `IConfiguration`, `IServiceCollection` or `EnvilderClient`. Static facade, fluent builder and environment routing since v0.2.0. Published to NuGet. [Documentation](./src/sdks/dotnet/README.md) |
37
+ | **Python SDK** (`envilder`) | Python SDK v0.1.0 | Runtime library for Django, FastAPI and data pipelines. Fluent facade since v0.2.0, environment routing since v0.3.0. Published to PyPI. [Documentation](./src/sdks/python/README.md) |
38
+ | **Node.js SDK** (`@envilder/sdk`) | Node.js SDK v0.1.0 | Load secrets into `process.env` from a map file, with fluent builder, secret validation and environment routing. Published to npm. [Documentation](./src/sdks/nodejs/README.md) |
39
+ | **Map-file JSON Schema** | CLI v0.10.0, .NET SDK v0.3.0, Node.js SDK v0.2.0, Python SDK v0.4.0 | Formal spec at [`spec/map-file.v1.json`](./spec/map-file.v1.json), published at `https://envilder.com/schema/map-file.v1.json`: the contract between all SDKs and tools |
40
+ | **AWS identity banner** | CLI v0.12.1, Action v0.12.1 | Logs the effective AWS identity before resolving secrets (colorized since v0.13.0) |
41
+ | **Actionable credential errors** | CLI v0.13.0, .NET SDK v0.5.0, Node.js SDK v0.4.0, Python SDK v0.5.0 | Typed expired-credentials and expired-SSO-session errors with the exact fix (ADR-0010) |
42
+ | **SSO login recovery** | CLI v0.13.0 | On an interactive terminal, offers to run `aws sso login` and retries |
43
+ | **Secret masking in GitHub Actions** | Action v0.13.2 | Every resolved value is registered with `::add-mask::` before the `.env` file is written |
44
+ | **Zero-config defaults** | CLI v0.14.0 | `envilder` with no flags reads `envilder.json` and writes `.env` |
45
+ | **Safe `.env` writing** | CLI v0.14.0, Action v0.14.0 | Values round-trip exactly, and mapping keys a `.env` file cannot represent are rejected |
46
+ | **Exec mode** (`envilder exec`) | CLI v0.15.0 | `envilder exec [options] [--] <command> [args...]` starts a command with the resolved secrets in its environment, without writing a `.env` file. [Guide](./docs/exec-command.md) |
35
47
 
36
48
  ### 🔥 Up Next
37
49
 
38
50
  | Feature | Priority | Notes |
39
51
  |---------|----------|-------|
40
- | **Go SDK** (`envilder`) | 🔴 High | Runtime library for Go: cloud-native apps, Kubernetes tooling. Published as Go module |
41
- | **Java SDK** (`envilder`) | 🔴 High | Runtime library for Java/Kotlin: Spring Boot, Android backends. Published to Maven Central |
42
- | **Map-file JSON Schema** | 🔴 High | Formal spec for the map-file format at `spec/`: serves as the contract between all SDKs and tools |
52
+ | **Go SDK** (`envilder`) | 🔴 High | Runtime library for Go: cloud-native apps, Kubernetes tooling. Published as Go module ([#561](https://github.com/macalbert/envilder/issues/561) → [#562](https://github.com/macalbert/envilder/issues/562) → [#563](https://github.com/macalbert/envilder/issues/563)) |
53
+ | **Java SDK** (`envilder`) | 🔴 High | Runtime library for Java/Kotlin: Spring Boot, Android backends. Published to Maven Central ([#569](https://github.com/macalbert/envilder/issues/569)) |
43
54
  | **SDK conformance tests** | 🔴 High | Language-agnostic test fixtures (JSON input → expected output) that all SDKs must pass |
44
- | **Exec mode** (`--exec`) | 🟡 Medium | Inject secrets into a child process env without writing to disk (`envilder exec -- node server.js`) |
45
- | **GCP Secret Manager** | 🟡 Medium | Third cloud provider: similar DX to AWS SSM. Completes the multi-cloud trident (AWS + Azure + GCP) |
55
+ | **Validate command** (`envilder validate`) | 🟡 Medium | Preflight check: map file, remote key existence and optional `.env` comparison, without printing values. CLI first, then the SDKs ([#532](https://github.com/macalbert/envilder/issues/532)) |
56
+ | **GCP Secret Manager** | 🟡 Medium | Third cloud provider: similar DX to AWS SSM. Completes the multi-cloud trident (AWS + Azure + GCP) ([#573](https://github.com/macalbert/envilder/issues/573)) |
46
57
  | **AWS Secrets Manager** | 🟡 Medium | Support AWS Secrets Manager alongside SSM Parameter Store for teams using JSON-structured secrets |
47
- | **Check/sync mode** (`--check`) | 🟡 Medium | Validate cloud secrets vs local `.env`, fail CI if out-of-sync |
48
58
 
49
59
  ### 💡 Planned
50
60
 
51
61
  | Feature | Priority | Notes |
52
62
  |---------|----------|-------|
53
63
  | **Auto-discovery mode** (`--auto`) | Medium | Fetch all parameters matching a given prefix (e.g., `/my-app/prod/*`) |
54
- | **Exec with refresh** (`--refresh-interval`) | Low | Kill & restart child process periodically with fresh secrets (requires `--exec`) |
55
- | **Hierarchical mapping** | Low | Per-environment `envilder.json` with inheritance/overrides |
64
+ | **Local override map file** (`envilder.local.json`) | Medium | Personal, gitignored layer on top of the committed map file, on every surface (ADR-0011, [#385](https://github.com/macalbert/envilder/issues/385)) |
65
+ | **Environment delivery in the GitHub Action** | Medium | Export resolved values to later job steps instead of writing a `.env` file ([#478](https://github.com/macalbert/envilder/issues/478)) |
66
+ | **Exec with refresh** (`--refresh-interval`) | Low | Kill & restart child process periodically with fresh secrets (builds on `envilder exec`, [#479](https://github.com/macalbert/envilder/issues/479)) |
67
+ | **Named providers and per-environment config** | Medium | Several providers in one map file, per-environment provider settings and optional secrets, through `$config.providers`. Additive to the current schema; the flat `$config` fields are deprecated, with `envilder migrate` ([#586](https://github.com/macalbert/envilder/issues/586)) |
68
+ | **Per-provider packages** | Medium | Split the SDK packages per provider, so an app installs only the cloud SDKs it uses. Prerequisite for adding more providers |
69
+ | **Kubernetes Secrets** | Low | Read secrets from a cluster: in-cluster service account in production, kubeconfig locally |
70
+ | **HashiCorp Vault / OpenBao** | Low | KV secrets engine, with GitHub OIDC (JWT auth) in the Action |
71
+ | **Infisical** | Low | Cloud or self-hosted Infisical, with machine identities and GitHub OIDC |
72
+ | **Azure App Configuration** | Low | Settings and Key Vault references from App Configuration, for .NET-centric teams on Azure |
73
+
74
+ ### 🚫 Out of scope
75
+
76
+ Envilder resolves secrets from stores you already run. It does not intend to:
77
+
78
+ - **Be a secret store**: values stay in the cloud provider; Envilder never keeps its own copy outside the `.env` file or process environment you ask for
79
+ - **Run a hosted service or server**: everything runs locally, in CI or inside your application, with your own credentials
80
+ - **Manage secret lifecycle**: creating vaults, rotating values, setting expiry or access policies stays with the provider's own tooling
81
+ - **Encrypt `.env` files**: protecting the generated file on disk is the job of the environment that consumes it
82
+ - **Ship a graphical interface**: the CLI, GitHub Action and SDKs are the supported surfaces
56
83
 
57
84
  ---
58
85
 
@@ -89,7 +116,7 @@ All five SDKs are developed **in parallel**: same map-file contract, same confor
89
116
  - **One map-file spec**: formal JSON Schema at `spec/` is the source of truth for all SDKs
90
117
  - **Conformance tests**: language-agnostic fixtures that every SDK must pass
91
118
  - **Independent versioning**: each SDK has its own semver (`sdk-node@1.2.0`, `sdk-py@0.3.0`)
92
- - **Shared test infrastructure**: LocalStack (AWS) and Lowkey Vault (Azure) via Docker Compose serve all SDKs
119
+ - **Shared test infrastructure**: LocalStack for AWS and Azure via Docker Compose serve all SDKs
93
120
 
94
121
  ---
95
122
 
package/docs/SECURITY.md CHANGED
@@ -9,6 +9,12 @@ We release patches for security vulnerabilities only in the latest version:
9
9
  | Latest | ✅ |
10
10
  | Older | ❌ |
11
11
 
12
+ ## 🎯 Security Requirements
13
+
14
+ Envilder reads secrets from AWS SSM Parameter Store or Azure Key Vault with your own credentials and writes them only to the `.env` file, process environment or application configuration you ask for. It never logs secret values, runs no server and implements no cryptography of its own.
15
+
16
+ It does not protect the generated `.env` file, the command started by `envilder exec`, or a map file that someone with write access to your repository has changed. The full list of what you can and cannot expect, together with the threat model, trust boundaries and the reasoning behind them, is in the [Security Requirements and Assurance Case](./security-assurance-case.md).
17
+
12
18
  ## 🚨 Reporting a Vulnerability
13
19
 
14
20
  **Please do not report security vulnerabilities through public GitHub issues.**
@@ -17,18 +23,22 @@ If you discover a security vulnerability in Envilder, please report it privately
17
23
 
18
24
  ### How to Report
19
25
 
20
- 1. **Email**: Send details to <mac.albert@gmail.com>
21
- 2. **Subject**: `[SECURITY] Envilder - [Brief Description]`
22
- 3. **Include**:
23
- - Description of the vulnerability
24
- - Steps to reproduce the issue
25
- - Potential impact
26
- - Suggested fix (if available)
27
- - Your contact information for follow-up
26
+ Use either channel:
27
+
28
+ - **GitHub (preferred)**: [open a private security advisory](https://github.com/macalbert/envilder/security/advisories/new)
29
+ - **Email**: send details to <mac.albert@gmail.com> with the subject `[SECURITY] Envilder - [Brief Description]`
30
+
31
+ Please include:
32
+
33
+ - Description of the vulnerability
34
+ - Steps to reproduce the issue
35
+ - Potential impact
36
+ - Suggested fix (if available)
37
+ - Your contact information for follow-up
28
38
 
29
39
  ### What to Expect
30
40
 
31
- - **Acknowledgment**: I will acknowledge your email as soon as possible
41
+ - **Acknowledgment**: I aim to acknowledge every report within 14 days
32
42
  - **Initial Assessment**: I'll provide an initial assessment and prioritize based on severity
33
43
  - **Updates**: I'll keep you informed about the progress
34
44
  - **Resolution**: I'll work to release a fix as soon as feasible (timeline depends on severity and complexity)
@@ -131,11 +141,27 @@ When using Envilder GitHub Action:
131
141
  - ❌ Store AWS credentials in GitHub Secrets (use OIDC roles)
132
142
  - ❌ Use overly permissive IAM policies
133
143
 
144
+ ## 🔏 Verifying Releases
145
+
146
+ Packages are built and published only by GitHub Actions workflows in this repository, using OIDC instead of long-lived registry tokens.
147
+
148
+ - **npm** (`envilder`, `@envilder/sdk`): published with [npm provenance](https://docs.npmjs.com/generating-provenance-statements), signed through Sigstore. After installing, run `npm audit signatures` in your project to verify the registry signatures and provenance attestations. The npm package page also links each version to the commit and workflow run that built it.
149
+ - **PyPI** (`envilder`): published with [PEP 740 attestations](https://docs.pypi.org/attestations/) through trusted publishing. The "Provenance" section of each file on PyPI shows the source repository and workflow. To verify locally:
150
+
151
+ ```bash
152
+ pip install pypi-attestations
153
+ pypi-attestations verify pypi --repository https://github.com/macalbert/envilder pypi:envilder-<version>-py3-none-any.whl
154
+ ```
155
+
156
+ - **NuGet** (`Envilder`): every package carries the NuGet.org repository signature, which you can check with `dotnet nuget verify Envilder.<version>.nupkg`.
157
+ - **GitHub Action**: referenced directly from this repository. For an immutable reference, pin the action to a full commit SHA instead of a tag.
158
+
134
159
  ## 🔍 Security Audits
135
160
 
136
161
  This project uses:
137
162
 
138
163
  - **Snyk**: Vulnerability scanning for dependencies
164
+ - **CodeQL**: Static analysis for security issues in the TypeScript code
139
165
  - **Secretlint**: Prevents accidental secret commits
140
166
  - **Biome**: Code quality and security linting
141
167
  - **Dependabot**: Automated dependency updates
@@ -5,6 +5,71 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
5
5
 
6
6
  ---
7
7
 
8
+ ## [0.15.1] - 2026-10-22
9
+
10
+ ### Security
11
+
12
+ * Update development and build dependencies to resolve open advisories:
13
+ `undici` 8.10.2 → 8.12.3 (via `testcontainers`), `brace-expansion`,
14
+ `@grpc/grpc-js` and `@vitest/mocker`. The published `envilder` package and
15
+ its runtime dependencies are unchanged
16
+ ([#609](https://github.com/macalbert/envilder/pull/609))
17
+
18
+ ### Dependencies
19
+
20
+ * Bump `testcontainers` and `@testcontainers/localstack` from 12.2.0 to 12.2.1
21
+ * Bump `vitest` and `@vitest/coverage-v8` from 4.1.11 to 4.1.12
22
+
23
+ ---
24
+
25
+ ## [0.15.0] - 2026-10-16
26
+
27
+ ### Added
28
+
29
+ * **`envilder exec`: run a command with resolved secrets, without a `.env`
30
+ file**: `envilder exec [options] [--] <command> [args...]` resolves every
31
+ secret in the map file and starts the command with those values in its
32
+ environment. Nothing is written to disk. The command starts at the first
33
+ argument that is not an Envilder option (`--` is optional), arguments are
34
+ passed verbatim without a shell, and Windows `npm`/`npx` shims are supported.
35
+ Resolution is fail-closed: the command never starts when a secret is missing,
36
+ empty or unreadable. Mapped values override inherited variables, naming the
37
+ overridden variables on stderr. All Envilder output goes to stderr as a
38
+ single summary line that names the program but never its arguments, so
39
+ stdout carries only the command's output. Inside GitHub Actions every value
40
+ is registered for masking, and every registration is written to stderr
41
+ before the command starts. Exit codes follow GNU `env`: the command's own
42
+ code, `128+n` for signals, `125` for Envilder errors, `126` and `127` when
43
+ the command cannot be executed or found. `SIGTERM` and `SIGHUP` are
44
+ forwarded and the command is awaited without a timeout, even if a signal
45
+ cannot be delivered. An expired AWS SSO session is recovered interactively
46
+ before the command starts. Exec mode is not a sandbox: see
47
+ [docs/exec-command.md](../exec-command.md)
48
+ ([#550](https://github.com/macalbert/envilder/issues/550))
49
+
50
+ ### Security
51
+
52
+ * **Parse errors no longer echo option values or arguments**: parse errors
53
+ are rebuilt from safe forms, so option values and extra arguments are never
54
+ printed. An unknown long option is named only when it is a near-typo of a
55
+ real option, together with the suggestion (`--valeu=<value>` is shown as
56
+ `unknown option '--valeu' (Did you mean --value?)`); any other unknown long
57
+ option gets a generic message, so a mistyped secret is never echoed. An
58
+ unknown short option is named by its single character, "too many
59
+ arguments" shows only the counts, and any other parse error is replaced
60
+ with a generic message. Exit codes are unchanged
61
+ ([#554](https://github.com/macalbert/envilder/issues/554))
62
+
63
+ * **Path and name options never swallow the next option**: `--map`,
64
+ `--envfile`, `--profile`, `--provider`, `--vault-url`, `--key`,
65
+ `--secret-path` and `--ssm-path` (and their `exec` counterparts) reject a
66
+ value that starts with `-` as a missing argument, before any map file is
67
+ read, instead of taking the following option as their value. `--value` is
68
+ exempt, so a secret may still start with `-`
69
+ ([#554](https://github.com/macalbert/envilder/issues/554))
70
+
71
+ ---
72
+
8
73
  ## [0.14.0] - 2026-09-26
9
74
 
10
75
  ### Added
@@ -80,7 +145,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
80
145
 
81
146
  ---
82
147
 
83
- ## [0.13.0] - 2026-06-26
148
+ ## [0.13.0] - 2026-07-11
84
149
 
85
150
  ### Added
86
151
 
@@ -171,6 +236,20 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
171
236
 
172
237
  ---
173
238
 
239
+ ## [0.11.1] - 2026-06-25
240
+
241
+ ### Fixed
242
+
243
+ * **AWS SSO / assumed-role profiles now resolve correctly**: Selecting an
244
+ SSO, IAM Identity Center, or assumed-role profile (via `--profile` or
245
+ `$config.profile`) now resolves credentials through the full AWS provider
246
+ chain instead of silently falling back to the default credentials.
247
+ Previously these profiles were ignored, reading and writing secrets against
248
+ the wrong AWS account
249
+ ([#364](https://github.com/macalbert/envilder/issues/364))
250
+
251
+ ---
252
+
174
253
  ## [0.11.0] - 2026-05-31
175
254
 
176
255
  ### Changed
@@ -197,7 +276,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
197
276
  published at `https://envilder.com/schema/map-file.v1.json`. Add
198
277
  `"$schema": "https://envilder.com/schema/map-file.v1.json"` to any map file
199
278
  for IDE autocomplete, inline documentation, and validation
200
- ([#218](https://github.com/macalbert/envilder/pull/218))
279
+ ([#217](https://github.com/macalbert/envilder/pull/217))
201
280
  * **Schema contract tests**: 39 tests validating the JSON Schema across all
202
281
  providers (AWS, Azure, GCP, HashiCorp Vault, file)
203
282
 
@@ -327,6 +406,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
327
406
  ### Fixed
328
407
 
329
408
  * **deps:** Move `@types/node` from `dependencies` to `devDependencies` to prevent it from being bundled as a runtime dependency
409
+ ([#135](https://github.com/macalbert/envilder/pull/135))
330
410
  * **e2e:** Use unique SSM paths per CLI test run to prevent race conditions between parallel test executions
331
411
 
332
412
  ### Dependencies
@@ -336,7 +416,7 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
336
416
 
337
417
  ---
338
418
 
339
- ## [0.8.0] - 2026-03-22
419
+ ## [0.8.0] - 2026-03-26
340
420
 
341
421
  ### Added
342
422
 
@@ -350,6 +430,13 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
350
430
  * New infrastructure adapter: `AzureKeyVaultSecretProvider` implementing `ISecretProvider`
351
431
  * New CLI option `--provider <name>` to select cloud provider (`aws` or `azure`, default: `aws`)
352
432
  * Azure authentication via `DefaultAzureCredential` (supports Azure CLI, managed identity, etc.)
433
+ * Automatic secret name normalization for Key Vault naming constraints (alphanumeric and hyphens,
434
+ 1–127 characters)
435
+
436
+ ### Security
437
+
438
+ * **Vault URL validation**: Azure Key Vault URLs must use HTTPS and match an Azure domain allowlist
439
+ (with dot-boundary checks), preventing SSRF through spoofed hostnames
353
440
 
354
441
  ### Changed
355
442
 
@@ -701,3 +788,52 @@ For SDK-specific changes, see `sdk-dotnet.md`, `sdk-python.md`, or `sdk-nodejs.m
701
788
 
702
789
  * CLI command not recognized after global install (`npm install -g envilder`)
703
790
  * Fixed missing compiled `lib/` files in published package
791
+
792
+ ---
793
+
794
+ ## [0.3.0] - 2025-05-09
795
+
796
+ ### Added
797
+
798
+ * **`--profile` option**: Choose which AWS CLI profile to use for credentials,
799
+ so you can work with different AWS accounts or configurations
800
+ ([#31](https://github.com/macalbert/envilder/pull/31))
801
+
802
+ ### Dependencies
803
+
804
+ * Bumped commander from 12.1.0 to 13.1.0, @aws-sdk/client-ssm, @types/node,
805
+ vite and @secretlint/secretlint-rule-preset-recommend
806
+
807
+ ---
808
+
809
+ ## [0.2.3] - 2025-04-13
810
+
811
+ ### Dependencies
812
+
813
+ * Bumped @aws-sdk/client-ssm from 3.670.0 to 3.716.0
814
+ * Bumped nanoid (security patch), @types/node, @biomejs/biome, secretlint and
815
+ @secretlint/secretlint-rule-preset-recommend
816
+
817
+ ---
818
+
819
+ ## [0.2.1] - 2024-10-16
820
+
821
+ ### Added
822
+
823
+ * **Preserve existing `.env` variables**: When the target `.env` already
824
+ exists, its variables are kept and only the mapped ones are added or updated
825
+ ([#5](https://github.com/macalbert/envilder/pull/5))
826
+ * Secret values are masked in console output
827
+ * Code coverage reporting published to GitHub Pages
828
+ ([#2](https://github.com/macalbert/envilder/pull/2))
829
+ * CodeQL code scanning ([#4](https://github.com/macalbert/envilder/pull/4))
830
+
831
+ ---
832
+
833
+ ## [0.1.4] - 2024-10-01
834
+
835
+ ### Added
836
+
837
+ * **Initial release**: Generate `.env` files from AWS SSM Parameter Store
838
+ using a JSON map of environment variable names to SSM parameter paths
839
+ * Supports both encrypted (`SecureString`) and plain SSM parameters
@@ -1,3 +1,27 @@
1
+ ## [0.15.1] - 2026-10-22
2
+
3
+ ### Security
4
+
5
+ * Update development and build dependencies to resolve open advisories
6
+ (`undici`, `brace-expansion`, `@grpc/grpc-js`, `@vitest/mocker`). The
7
+ Action bundle and its runtime dependencies are unchanged
8
+ ([#609](https://github.com/macalbert/envilder/pull/609))
9
+
10
+ ---
11
+
12
+ ## [0.15.0] - 2026-10-16
13
+
14
+ ### Changed
15
+
16
+ * **Shared secret masker can report when registrations are written**: The
17
+ masker the Action shares with the CLI gained an internal capability to
18
+ report when its `::add-mask::` writes have completed, used by the new
19
+ CLI-only `envilder exec` command. The Action's pull flow does not use it,
20
+ and the registrations it prints are unchanged
21
+ ([#550](https://github.com/macalbert/envilder/issues/550))
22
+
23
+ ---
24
+
1
25
  ## [0.14.0] - 2026-09-26
2
26
 
3
27
  ### Fixed
@@ -50,6 +74,13 @@
50
74
 
51
75
  ## [0.13.1] - 2026-07-31
52
76
 
77
+ ### Added
78
+
79
+ * **GitHub Marketplace listing and root reference**: A root `action.yml`
80
+ publishes the Action to the GitHub Marketplace and lets workflows use it as
81
+ `macalbert/envilder@<version>`. The `macalbert/envilder/github-action@v0`
82
+ reference keeps working.
83
+
53
84
  ### Changed
54
85
 
55
86
  * **Bundle the GitHub Action with esbuild**: Replace the ncc bundler so the
@@ -61,7 +92,7 @@
61
92
 
62
93
  ---
63
94
 
64
- ## [0.13.0] - 2026-06-26
95
+ ## [0.13.0] - 2026-07-11
65
96
 
66
97
  ### Added
67
98
 
@@ -141,6 +172,18 @@
141
172
 
142
173
  ---
143
174
 
175
+ ## [0.11.1] - 2026-06-25
176
+
177
+ ### Fixed
178
+
179
+ * **AWS SSO / assumed-role profiles now resolve correctly**: The bundled CLI
180
+ now resolves SSO, IAM Identity Center, and assumed-role profiles (via the
181
+ `profile` input or `$config.profile`) through the full AWS provider chain
182
+ instead of silently falling back to the default credentials
183
+ ([#364](https://github.com/macalbert/envilder/issues/364))
184
+
185
+ ---
186
+
144
187
  ## [0.11.0] - 2026-05-31
145
188
 
146
189
  ### Changed
@@ -203,7 +246,7 @@
203
246
 
204
247
  ---
205
248
 
206
- ## [0.8.0] - 2026-03-22
249
+ ## [0.8.0] - 2026-03-26
207
250
 
208
251
  ### Added
209
252