Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
e8fa69d
feat(cli): support multiple deployment instances per chain
maxnorm Oct 17, 2026
b0b9465
feat(cli): add upgradeability selection to init
maxnorm Oct 17, 2026
20c3848
feat(cli): add managed compose deploy workflow
maxnorm Oct 17, 2026
cafc10a
refactor(cli): generate deploy scripts on demand
maxnorm Oct 17, 2026
5efd2d8
fix(cli): include RPC endpoint and root cause in errors
maxnorm Oct 17, 2026
593eb73
fix solidity comment enforcement
maxnorm Oct 17, 2026
6cc3ac7
feat(cli): add compose test command
maxnorm Oct 20, 2026
52ad0b0
fix(cli): prefer the framework package root for facet sources
maxnorm Oct 20, 2026
12dd70e
feat(cli): install the Compose CLI in generated projects
maxnorm Oct 20, 2026
25b672b
feat(cli): redact secrets from command output
maxnorm Oct 27, 2026
f1a0616
fix(cli): sanitize RPC endpoints in adapter errors
maxnorm Oct 27, 2026
cb067c8
feat(cli): initialize Hardhat projects from official templates
maxnorm Oct 27, 2026
abc15d1
feat(cli): add npm scripts to generated projects
maxnorm Oct 27, 2026
30fa411
feat(cli): preconfigure Sepolia in generated projects
maxnorm Oct 27, 2026
5407246
feat(cli): add non-secret deployment account aliases
maxnorm Oct 27, 2026
77b49d7
feat(cli): support per-deployment RPC URL overrides
maxnorm Oct 27, 2026
f855657
feat(cli): deploy reviewable artifacts with fork simulation and Ignition
maxnorm Oct 27, 2026
b2cc224
docs(cli): document generated scripts, accounts, and deploy workflow
maxnorm Oct 27, 2026
22f1f33
fix(cli): harden Foundry and Hardhat deploy flows
maxnorm Oct 27, 2026
0e9a3d3
revert(cli): expose native framework commands
maxnorm Oct 28, 2026
73806c1
feat(docs): review getting started with compose deploy usage
maxnorm Oct 28, 2026
6743553
feat(cli): require Node.js 22 and check Hardhat's minimum
maxnorm Nov 16, 2026
2cf3d55
refactor(cli): move framework capabilities into the adapters
maxnorm Nov 16, 2026
21bb6c5
fix(cli): bind deploy plans to reviewable identity, signers, and routing
maxnorm Nov 16, 2026
87920fd
fix(cli): make facet install and remove guidance actionable
maxnorm Nov 16, 2026
7fddad5
fix(cli): scope env loading and lock lookup to the Compose project
maxnorm Nov 16, 2026
0bff0f0
docs(website): tidy trailing whitespace in my first diamond
maxnorm Nov 16, 2026
4f8cd77
feat(cli): show exact next steps after account setup
maxnorm Nov 17, 2026
a5e46a1
feat(cli): print facet addresses after a Hardhat deploy
maxnorm Nov 17, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/add-test-command.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": patch
---

Add `compose test` to run a project's test suite through its detected framework (`forge test` or `npx hardhat test`), with `--` passthrough for framework filters and reporting flags.
5 changes: 5 additions & 0 deletions .changeset/compose-install-package-facets.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": patch
---

Fix `compose install` of catalog package facets (e.g. `ERC20DataFacet`) in Hardhat projects: package-sourced facets are never copied into `contracts/`, and Hardhat only compiles npm Solidity files listed in `solidity.npmFilesToBuild`, so the install-time validation compile missed the facet and failed with "Facet contract not found in Solidity AST". Install now adds the batch's package facets to the Compose `composeNpmFilesToBuild` overlay in `hardhat.config.ts` before validating, and reverts the config when the transaction rolls back. Projects whose config no longer contains the generated overlay get an error naming the exact specifiers to add manually. Foundry is unaffected (its validation compile already receives the facet paths directly). Install/remove error messages now carry recovery hints (`compose remove <facet>`, `path.sol:ContractName` examples, available diamond lists).
5 changes: 5 additions & 0 deletions .changeset/compose-runtime-directory.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": patch
---

Move every Compose-owned Hardhat runtime file into the ignored `.compose/hardhat/` directory (`.compose/foundry/` is reserved for Foundry): the transient Ignition runner, the generated deploy result, and the account probe. The probe is now a deterministic rendered template rather than a per-run `scripts/compose-account-check-<uuid>.ts` file, so an interrupted run can no longer leave an untracked script in a tracked directory. `compose init` and every runtime write now ensure the project `.gitignore` contains `.compose/`; the nested `cache/compose/.gitignore` workaround is gone.
7 changes: 7 additions & 0 deletions .changeset/deploy-command.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
"@perfect-abstractions/compose-cli": minor
---

Add `compose deploy`: plan the diamond from `compose.json` and generate a reviewable managed deployment artifact. Foundry uses a Solidity script; Hardhat 3 uses a Hardhat Ignition module with an ignored transient runner. The default command prints the artifact path and review instructions without prompting or broadcasting; `--dry-run` simulates on a pinned chain fork, while `--broadcast` explicitly deploys, verifies the result on-chain, and records it in `compose.lock`. Hardhat deployment transaction hashes are read from the Ignition journal by future ID. Signing stays in the framework. Supports `--chain`, a per-deployment `--rpc-url` override, named Compose account aliases, `--instance`, `--redeploy`, and `--` passthrough for framework arguments. Add and list non-secret account aliases with `compose account`.

Hardhat 3 initialization now uses Hardhat's official non-interactive Ethers/Mocha or Viem/Node test-runner template, overlays Compose project settings without discarding the official config, and requires Node.js 22.13 or newer.
5 changes: 5 additions & 0 deletions .changeset/fix-package-facet-source-precedence.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": patch
---

Resolve package facets from the project framework's package root (Foundry `lib/Compose`, Hardhat `node_modules`), so a project that has both copies no longer fails with an ambiguous package source.
5 changes: 5 additions & 0 deletions .changeset/generated-project-scripts.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": patch
---

Generated Foundry and Hardhat projects now expose native framework commands as `npm run build` and `npm test`, plus Compose workflows as `npm run validate` and `npm run deploy`. Foundry projects also include `npm run fmt`. The `compose build` and `compose test` commands remain available as convenience wrappers.
5 changes: 5 additions & 0 deletions .changeset/hardhat-node-version-check.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": patch
---

Raise the CLI's minimum Node.js version to 22 and check for Node.js 22.13+ before initializing a Hardhat project, so the engine requirement and the getting-started docs agree.
5 changes: 5 additions & 0 deletions .changeset/init-no-deploy-script.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": minor
---

`compose init` no longer scaffolds a default deploy script; the first `compose deploy` generates the managed, reviewable script from `compose.json` instead.
5 changes: 5 additions & 0 deletions .changeset/init-upgradeability.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": minor
---

Scaffold immutable diamonds by default: `compose init` prompts for upgradeability, defaulting to Immutable, and non-interactive runs accept `--upgradeable` and `--immutable`. `--upgradeable` includes `DiamondUpgradeFacet` and couples the `owner` base when no ownership base is selected; an explicit `DiamondUpgradeFacet` in `--libraries` opts in for compatibility. Hardhat projects also scaffold a `local` network entry targeting the default Anvil RPC.
5 changes: 5 additions & 0 deletions .changeset/local-compose-cli-dev-dependency.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": patch
---

`compose init` now adds `@perfect-abstractions/compose-cli` to the generated project's `devDependencies` and installs it, so Compose commands run locally with `npx compose` without a global install. Foundry projects now include a `package.json` for this, and the tutorial and generated READMEs use the `npx compose` flow.
5 changes: 5 additions & 0 deletions .changeset/lock-file-instances.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": minor
---

Nest `compose.lock` deployments by instance (`diamond → chain → instance → deployment`) and validate every recorded instance in `compose validate`.
5 changes: 5 additions & 0 deletions .changeset/redact-command-secrets.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": patch
---

Redact private keys, mnemonics, passwords, and secret-bearing RPC URLs from command failure errors and passthrough validation messages.
5 changes: 5 additions & 0 deletions .changeset/sepolia-default-chain.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@perfect-abstractions/compose-cli": minor
---

Generated Foundry and Hardhat projects now include a preconfigured `sepolia` chain. `compose.json` points Sepolia at `${SEPOLIA_RPC_URL}`, Foundry projects add a `sepolia` entry under `[rpc_endpoints]`, and Hardhat projects define a Sepolia HTTP network that reads `SEPOLIA_RPC_URL` and the `SEPOLIA_PRIVATE_KEY` signer. Generated projects also include a `.env.example` and README instructions for Sepolia deployments.
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,9 @@
cache/
out/

# Compose runtime files
.compose/

# Ignores development broadcast logs
!/broadcast
/broadcast/*/31337/
Expand Down
2 changes: 1 addition & 1 deletion cli/.gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ my-diamond/
.env
.env.local

docs/
docs/
Loading
Loading