|
| 1 | +# Resolution Log |
| 2 | + |
| 3 | +This file tracks all lifecycle changes to CommandLayer verbs, aliases, and schemas. |
| 4 | +It is the **single source of truth** for why something was added, deprecated, or removed. |
| 5 | +Every entry must be documented here to maintain transparency and trust. |
| 6 | + |
| 7 | +--- |
| 8 | + |
| 9 | +## Format |
| 10 | + |
| 11 | +Each entry should include: |
| 12 | + |
| 13 | +- **Date** — When the decision was made. |
| 14 | +- **Verb(s)** — Affected canonical verb(s) or aliases. |
| 15 | +- **Action** — Added, Deprecated, Replaced, or Removed. |
| 16 | +- **Reason** — Short explanation (ecosystem need, duplication, ambiguity, etc.). |
| 17 | +- **Resolution** — The final decision (what replaces it, if anything). |
| 18 | +- **Maintainers** — Who approved the change. |
| 19 | + |
| 20 | +--- |
| 21 | + |
| 22 | +## Example Entries |
| 23 | + |
| 24 | +### 2025-09-15 — Verb Addition |
| 25 | +- **Verb(s):** `stream` |
| 26 | +- **Action:** Added |
| 27 | +- **Reason:** Needed for continuous broadcast use cases (audio/video agents). |
| 28 | +- **Resolution:** Accepted as a **commercial** verb with 2 aliases (`broadcast`, `cast`). |
| 29 | +- **Maintainers:** @greg, @ayden |
| 30 | + |
| 31 | +--- |
| 32 | + |
| 33 | +### 2025-09-12 — Deprecation |
| 34 | +- **Verb(s):** `register` |
| 35 | +- **Action:** Deprecated |
| 36 | +- **Reason:** Overlaps semantically with `subscribe`; caused confusion. |
| 37 | +- **Resolution:** Marked as deprecated. Remains valid until **2025-07-10**. |
| 38 | + - Developers should migrate to `subscribe`. |
| 39 | +- **Maintainers:** @nicole |
| 40 | + |
| 41 | +--- |
| 42 | + |
| 43 | +### 2025-09-22 — Removal |
| 44 | +- **Verb(s):** `log` |
| 45 | +- **Action:** Removed |
| 46 | +- **Reason:** Completed the 90-day deprecation window. |
| 47 | +- **Resolution:** Permanently removed from canonical verbs. |
| 48 | +- **Maintainers:** @roman, @kai |
| 49 | + |
| 50 | +--- |
| 51 | + |
| 52 | +### 2025-09-01 — Alias Update |
| 53 | +- **Verb(s):** `checkout` |
| 54 | +- **Alias(es):** `buy` |
| 55 | +- **Action:** Rejected alias proposal |
| 56 | +- **Reason:** Ambiguous with `purchase` and `order`. |
| 57 | +- **Resolution:** Alias `buy` will not be added. |
| 58 | +- **Maintainers:** @ethan @julia |
| 59 | + |
| 60 | +--- |
| 61 | + |
| 62 | +## Rules of Thumb |
| 63 | + |
| 64 | +1. **No silent changes** — everything must be logged here. |
| 65 | +2. **Stability first** — once a verb is stable, only replace if absolutely necessary. |
| 66 | +3. **Deprecation window** — always give at least **90 days** before removal. |
| 67 | +4. **Aliases are soft** — easier to add/remove, but still require reasoning. |
| 68 | +5. **Governance matters** — if there’s disagreement, it must be resolved before merging. |
| 69 | + |
| 70 | +--- |
| 71 | + |
| 72 | +Maintainers: Please update this file with every schema, verb, or alias decision. |
| 73 | +If it’s not in `RESOLUTION.md`, it didn’t officially happen. |
| 74 | + |
| 75 | +## Links |
| 76 | + |
| 77 | +- [Security Policy](./SECURITY.md) — responsible disclosure and vulnerability handling |
| 78 | +- [RESOLUTION.md](./RESOLUTION.md) — governance and deprecation log |
| 79 | +- [Policy](./POLICY.md) — verbs, aliases, and ENS binding rules |
| 80 | +- [GOVERNANCE.md](./GOVERNANCE.md) — decision-making and multisig control |
0 commit comments