|
| 1 | +--- |
| 2 | +title: "US House — 1, 2, 3, 4 Document Order" |
| 3 | +format: mermaid |
| 4 | +version: "1.0" |
| 5 | +companion: "docs/US-HOUSE-1-2-3-4.hsss" |
| 6 | +--- |
| 7 | + |
| 8 | +# US House — 1, 2, 3, 4 |
| 9 | + |
| 10 | +## Founding paragraph |
| 11 | + |
| 12 | +The US House is a software-house organization for turning an idea into a traceable, usable result: **1 Origin, 2 Custody, 3 Production, 4 Release**. The order is the central improvement: every program action should have a beginning, a controlled state, an actual production record, and a separately identifiable release state. Convenience is added without losing provenance, and software operations such as installation, deletion, update, repair, and deployment remain attributable and reviewable. |
| 13 | + |
| 14 | +```mermaid |
| 15 | +flowchart LR |
| 16 | + O["1 — Origin\nIdea / Request / Source"] --> C["2 — Custody\nHold / Control / Version"] |
| 17 | + C --> P["3 — Production\nBuild / Execute / Install / Update / Remove"] |
| 18 | + P --> R["4 — Release\nDeploy / Deliver / Verify"] |
| 19 | + R --> N["Next revision / next Origin"] |
| 20 | + |
| 21 | + P --> W["Windows\nPowerShell / CMD"] |
| 22 | + P --> U["Ubuntu / Linux\nShell"] |
| 23 | + P --> MS["Microsoft software\npackage lifecycle"] |
| 24 | + P --> AP["Apple software\npackage lifecycle"] |
| 25 | + |
| 26 | + O -.-> E["Evidence"] |
| 27 | + C -.-> E |
| 28 | + P -.-> E |
| 29 | + R -.-> E |
| 30 | +``` |
| 31 | + |
| 32 | +## The four documents |
| 33 | + |
| 34 | +| Order | Document | Meaning | Typical evidence | |
| 35 | +|---|---|---|---| |
| 36 | +| 1 | Origin | Why and from where | request, source, proposal | |
| 37 | +| 2 | Custody | Where and under whose control | repository, package, version, hash | |
| 38 | +| 3 | Production | What actually happened | command, build, install, update, remove, test | |
| 39 | +| 4 | Release | What became available | artifact, deployment, verification | |
| 40 | + |
| 41 | +## Improvement rule |
| 42 | + |
| 43 | +The system improves by adding precision without breaking the order. A convenience command is still a production event; an installation is still production; a deletion is still production; an update creates a new state; and a release is not assumed merely because production succeeded. |
| 44 | + |
| 45 | +## Evidence rule |
| 46 | + |
| 47 | +Every important operation SHOULD be representable as: |
| 48 | + |
| 49 | +`origin → custody → production → release → verification` |
| 50 | + |
| 51 | +Unknown information remains explicitly unknown. A proposition remains a proposition until supported by an appropriate source or verification record. |
| 52 | + |
| 53 | +## Software-house scope |
| 54 | + |
| 55 | +The US House software layer can organize: |
| 56 | + |
| 57 | +- Windows installation, update, removal, repair, and status operations. |
| 58 | +- Ubuntu/Linux equivalents. |
| 59 | +- Microsoft and Apple software catalog entries. |
| 60 | +- Convenience menus and command wrappers. |
| 61 | +- Source/build/deployment tracking. |
| 62 | +- Evidence and integrity records. |
| 63 | + |
| 64 | +Vendor inclusion is a technical catalog decision and does not imply endorsement, ownership, or governmental affiliation. |
| 65 | + |
| 66 | +## Relationship to .hsss |
| 67 | + |
| 68 | +The companion `.hsss` document is the hierarchical specification. This `.mmd` document is the visual/order document. The `.hsss` explains the system; the `.mmd` makes its four-stage structure directly renderable. |
0 commit comments