Merge pull request #1152 from Tek-Lizzy/issue-749-deploy-checklist

Resolve #749: add pre-mainnet deploy checklist

Author: Nanle-code

API_REFERENCE.md

@@ -377,6 +377,10 @@ const SUBCOMMAND_INFO: &[(&str, &str)] = &[
         "Deploy a compiled Soroban contract and manage the lifecycle",
     ),
     ("deploy run", "Deploy a compiled Soroban contract (.wasm)"),
+    (
+        "deploy checklist",
+        "Verify required pre-mainnet deployment checks",
+    ),
     (
         "deploy history",
         "Deployment history, rollback, verification, dashboard",

build.rs

@@ -5,26 +5,26 @@ them. This file is the migration guide from the pre-ADR-0007 flat surface (86
 top-level commands) to the noun-verb tree, and the reference for where a moved
 command lives now.
 
-* Design and rationale: [`docs/adr/0007-noun-verb-command-tree.md`](adr/0007-noun-verb-command-tree.md)
-* Full flag reference: [`docs/COMMAND_REFERENCE.md`](COMMAND_REFERENCE.md)
-* Short command list: [`docs/COMMAND_CHEATSHEET.md`](COMMAND_CHEATSHEET.md) (generated by `build.rs`)
+- Design and rationale: [`docs/adr/0007-noun-verb-command-tree.md`](adr/0007-noun-verb-command-tree.md)
+- Full flag reference: [`docs/COMMAND_REFERENCE.md`](COMMAND_REFERENCE.md)
+- Short command list: [`docs/COMMAND_CHEATSHEET.md`](COMMAND_CHEATSHEET.md) (generated by `build.rs`)
 
 ## Top-level commands
 
-| Noun | What it covers |
-|---|---|
-| `wallet` | Wallets, keys, transactions, SEP-10 auth, multisig, devices |
-| `contract` | Invoke, build, inspect, test, audit, security, upgrade, monitor |
-| `deploy` | `deploy run` and the deployment lifecycle (history, env, schedule, cost) |
-| `network` | Active network, local node, simulation, snapshots |
-| `template` | Templates, template VCS, the remote registry |
-| `plugin` | Third-party plugins |
-| `ai` | Local assistant, AI audits/tests/search/planning, prompts, help |
-| `config` | Config files, `config info`, telemetry, feature flags, privacy |
-| `project` | Project scaffolding, tasks, sprints, collaboration |
-| `tool` | Tutorials, natural language, PR checks, bug reports |
-| `completions` | Shell completion scripts |
-| `man` | Man pages |
+| Noun          | What it covers                                                                                   |
+| ------------- | ------------------------------------------------------------------------------------------------ |
+| `wallet`      | Wallets, keys, transactions, SEP-10 auth, multisig, devices                                      |
+| `contract`    | Invoke, build, inspect, test, audit, security, upgrade, monitor                                  |
+| `deploy`      | `deploy run`, pre-mainnet checklist, and the deployment lifecycle (history, env, schedule, cost) |
+| `network`     | Active network, local node, simulation, snapshots                                                |
+| `template`    | Templates, template VCS, the remote registry                                                     |
+| `plugin`      | Third-party plugins                                                                              |
+| `ai`          | Local assistant, AI audits/tests/search/planning, prompts, help                                  |
+| `config`      | Config files, `config info`, telemetry, feature flags, privacy                                   |
+| `project`     | Project scaffolding, tasks, sprints, collaboration                                               |
+| `tool`        | Tutorials, natural language, PR checks, bug reports                                              |
+| `completions` | Shell completion scripts                                                                         |
+| `man`         | Man pages                                                                                        |
 
 `autocomplete` and plugin-provided external commands are still registered but
 hidden from `--help`.
@@ -120,24 +120,24 @@ warning: `starforge test` is deprecated and will stop working in starforge 0.2.0
 live under `ai local`. `starforge ai pull llama3` becomes
 `starforge ai local pull llama3`, with the same warning.
 
-| Old command | Use instead | Removed in |
-|---|---|---|
-| `starforge ai status` | `starforge ai local status` | 0.2.0 |
-| `starforge ai models` | `starforge ai local models` | 0.2.0 |
-| `starforge ai pull` | `starforge ai local pull` | 0.2.0 |
-| `starforge ai ask` | `starforge ai local ask` | 0.2.0 |
-| `starforge ai audit` | `starforge ai local audit` | 0.2.0 |
-| `starforge ai explain` | `starforge ai local explain` | 0.2.0 |
-| `starforge ai test` | `starforge ai local test` | 0.2.0 |
-| `starforge ai optimise` | `starforge ai local optimise` | 0.2.0 |
-| `starforge ai profile` | `starforge ai local profile` | 0.2.0 |
-| `starforge ai compare-profiles` | `starforge ai local compare-profiles` | 0.2.0 |
-| `starforge ai patterns` | `starforge ai local patterns` | 0.2.0 |
-| `starforge ai library` | `starforge ai local library` | 0.2.0 |
-| `starforge ai pattern-feedback` | `starforge ai local pattern-feedback` | 0.2.0 |
-| `starforge ai cache` | `starforge ai local cache` | 0.2.0 |
-| `starforge ai analytics` | `starforge ai local analytics` | 0.2.0 |
-| `starforge ai offline` | `starforge ai local offline` | 0.2.0 |
+| Old command                     | Use instead                           | Removed in |
+| ------------------------------- | ------------------------------------- | ---------- |
+| `starforge ai status`           | `starforge ai local status`           | 0.2.0      |
+| `starforge ai models`           | `starforge ai local models`           | 0.2.0      |
+| `starforge ai pull`             | `starforge ai local pull`             | 0.2.0      |
+| `starforge ai ask`              | `starforge ai local ask`              | 0.2.0      |
+| `starforge ai audit`            | `starforge ai local audit`            | 0.2.0      |
+| `starforge ai explain`          | `starforge ai local explain`          | 0.2.0      |
+| `starforge ai test`             | `starforge ai local test`             | 0.2.0      |
+| `starforge ai optimise`         | `starforge ai local optimise`         | 0.2.0      |
+| `starforge ai profile`          | `starforge ai local profile`          | 0.2.0      |
+| `starforge ai compare-profiles` | `starforge ai local compare-profiles` | 0.2.0      |
+| `starforge ai patterns`         | `starforge ai local patterns`         | 0.2.0      |
+| `starforge ai library`          | `starforge ai local library`          | 0.2.0      |
+| `starforge ai pattern-feedback` | `starforge ai local pattern-feedback` | 0.2.0      |
+| `starforge ai cache`            | `starforge ai local cache`            | 0.2.0      |
+| `starforge ai analytics`        | `starforge ai local analytics`        | 0.2.0      |
+| `starforge ai offline`          | `starforge ai local offline`          | 0.2.0      |
 
 ## Regenerating