|
1 | 1 | # HawkinsOperations .github |
2 | 2 |
|
3 | | -This repository is the HawkinsOperations GitHub organization command center. It owns the organization profile, reviewer routes, governance summaries, and visual maps that explain how the six-repo system works. |
| 3 | +The HawkinsOperations organization command center and reviewer-routing surface. |
4 | 4 |
|
5 | | -The public organization overview is controlled by [profile/README.md](profile/README.md). This repo is a front door, not a proof source: GitHub rendering is not proof. |
| 5 | +The .github is routing/governance only and not proof authority. |
| 6 | + |
| 7 | +## What This Repo Owns |
| 8 | + |
| 9 | +- Organization profile and reviewer routing. |
| 10 | +- Governance summaries, control surfaces, and command-center maps. |
| 11 | +- Reviewer-facing wording that explains where authority lives. |
| 12 | +- The command-center invariant verifier for route and claim-boundary checks. |
| 13 | + |
| 14 | +## What This Repo Does Not Own |
| 15 | + |
| 16 | +- Proof records or proof ceilings. |
| 17 | +- Runtime truth or signal truth. |
| 18 | +- Public-safe status or public publication approval. |
| 19 | +- Merge authority or final disposition authority. |
| 20 | +- Website rendering truth. |
| 21 | + |
| 22 | +Evidence and source flow stay separated: |
| 23 | + |
| 24 | +`detection source -> validation behavior -> platform contracts where applicable -> proof records -> public rendering` |
6 | 25 |
|
7 | 26 | ## Fast Reviewer Path |
8 | 27 |
|
9 | 28 | | Time | Start | What to confirm | |
10 | 29 | |---:|---|---| |
11 | 30 | | 30 sec | [profile/START_HERE.md](profile/START_HERE.md) | What HawkinsOperations is, which repo owns truth, and what remains blocked. | |
12 | | -| 3 min | [profile/README.md](profile/README.md) -> [Control Status Matrix](governance/CONTROL_STATUS_MATRIX.md) | Command-center route, proof ceiling, ledger count boundary, and standing controls. | |
13 | | -| 10 min | [Reproducible Reviewer Path](architecture/REPRODUCIBLE_REVIEWER_PATH.md) | Clone-runnable source/validation/proof inspection without private runtime access. | |
| 31 | +| 3 min | [profile/README.md](profile/README.md) -> [Control Status Matrix](governance/CONTROL_STATUS_MATRIX.md) | Command-center route, proof ceiling, and standing controls. | |
| 32 | +| 10 min | [Reproducible Reviewer Path](architecture/REPRODUCIBLE_REVIEWER_PATH.md) | Clone-runnable source, validation, proof, and rendering review without private runtime access. | |
| 33 | + |
| 34 | +## README / Repo Makeover Order |
| 35 | + |
| 36 | +This is the README/governance cleanup order, not evidence-generation order. |
| 37 | + |
| 38 | +| Order | Repo | Truth surface | Boundary | |
| 39 | +|---:|---|---|---| |
| 40 | +| 1 | `.github` | Route / governance truth | Routes reviewers and explains authority boundaries; does not prove claims. | |
| 41 | +| 2 | `hawkinsoperations-proof` | Claim / proof truth | Owns proof records, proof ceilings, evidence-boundary records, and blocked-claim status. | |
| 42 | +| 3 | `hawkinsoperations-platform` | Contract / guardrail truth | Owns schemas, contracts, ledger guardrails, runtime-route guardrails, and non-promotional platform controls. | |
| 43 | +| 4 | `hawkinsoperations-validation` | Behavior truth | Owns controlled validation checks, case packets, replay scope, and recorded validation outputs. | |
| 44 | +| 5 | `hawkinsoperations-detections` | Source truth | Owns detection source, metadata, source reviewability, and source-level eligibility routing. | |
| 45 | +| 6 | `hawkinsoperations-website` | Render truth | Renders public reviewer navigation and bounded wording; rendering is not proof. | |
14 | 46 |
|
15 | 47 | ## Command Center Routes |
16 | 48 |
|
17 | 49 | | Need | Route | Boundary | |
18 | 50 | |---|---|---| |
19 | | -| First reviewer path | [profile/START_HERE.md](profile/START_HERE.md) | Click path for review/demo; does not promote claims. | |
| 51 | +| First reviewer path | [profile/START_HERE.md](profile/START_HERE.md) | Click path for review and demo; does not promote claims. | |
20 | 52 | | Org front door | [profile/README.md](profile/README.md) | Reviewer routing only; does not create proof. | |
21 | | -| Six-repo architecture | [architecture/REPO_AUTHORITY_MAP.md](architecture/REPO_AUTHORITY_MAP.md) | Repo ownership map; source does not prove runtime. | |
| 53 | +| Repository authority map | [architecture/REPO_AUTHORITY_MAP.md](architecture/REPO_AUTHORITY_MAP.md) | Repository ownership map; source does not prove runtime. | |
22 | 54 | | Proof chain | [architecture/REPRODUCIBLE_REVIEWER_PATH.md](architecture/REPRODUCIBLE_REVIEWER_PATH.md) | Clone-runnable inspection path; no private runtime access. | |
23 | 55 | | Truth/control status | [governance/CONTROL_STATUS_MATRIX.md](governance/CONTROL_STATUS_MATRIX.md) | Current wording and blockers; soft unless enforced. | |
24 | | -| Standing control registers | [governance/ISSUE_FACTORY_CONTROL_RECEIPTS.md](governance/ISSUE_FACTORY_CONTROL_RECEIPTS.md) | #8 and #10 remain open standing controls unless Raylee approves a replacement standing-control role; governance classification only. | |
25 | | -| Command-center invariants | [governance/COMMAND_CENTER_INVARIANTS.json](governance/COMMAND_CENTER_INVARIANTS.json) and [scripts/verify-command-center-invariants.py](scripts/verify-command-center-invariants.py) | Verifier control for route and claim-boundary invariants; does not promote proof. | |
| 56 | +| Standing control registers | [governance/ISSUE_FACTORY_CONTROL_RECEIPTS.md](governance/ISSUE_FACTORY_CONTROL_RECEIPTS.md) | Standing controls and issue receipts; governance classification only. | |
| 57 | +| Command-center invariants | [governance/COMMAND_CENTER_INVARIANTS.json](governance/COMMAND_CENTER_INVARIANTS.json) and [scripts/verify-command-center-invariants.py](scripts/verify-command-center-invariants.py) | Route and claim-boundary verifier control; does not promote proof. | |
26 | 58 | | Visual system map | [wiki/11_ORG_SYSTEM_MAP.md](wiki/11_ORG_SYSTEM_MAP.md) | Docs-as-code map; routing is not proof. | |
27 | | -| Project cockpit | [private org Control Board route](https://github.com/orgs/HawkinsOperations/projects/2) | Coordination-only operating cockpit; project metadata is report-only, not proof, approval, runtime, signal, public-safe status, or merge authority. Project #1 is not an active reviewer route. | |
| 59 | +| Project cockpit | [private org Control Board route](https://github.com/orgs/HawkinsOperations/projects/2) | Canonical private HawkinsOperations Control Board; Project #1 is not an active reviewer route when already established in current `.github` files. Project metadata is coordination-only. | |
28 | 60 | | Proof records | [hawkinsoperations-proof](https://github.com/HawkinsOperations/hawkinsoperations-proof) | Proof records own claim ceilings. | |
29 | 61 |
|
30 | 62 | ## Current Boundary |
31 | 63 |
|
32 | | -Current proof records live in [hawkinsoperations-proof](https://github.com/HawkinsOperations/hawkinsoperations-proof), and the current HO-DET-001 public ceiling remains `CONTROLLED_TEST_VALIDATED`. |
| 64 | +The current public ceiling for HO-DET-001 remains `CONTROLLED_TEST_VALIDATED`. |
| 65 | + |
| 66 | +The command-center and ledger-status front door remains `SCHEMA_CONTRACT_VERIFIER_EXISTS_ONLY`. |
| 67 | + |
| 68 | +`.github` is route/governance truth only. It does not own proof authority, runtime truth, signal truth, public-safe status, merge authority, or public publication approval. |
| 69 | + |
| 70 | +The canonical private HawkinsOperations Control Board is Project #2. Project metadata is coordination-only and does not create proof, approval, runtime truth, signal truth, public-safe status, merge authority, public publication approval, or proof promotion. Project #1 is not an active reviewer route when already established in the current `.github` files. |
| 71 | + |
| 72 | +Current boundary labels: |
| 73 | + |
| 74 | +- `CONTROLLED_TEST_VALIDATED` |
| 75 | +- `NOT_PUBLIC_SAFE` |
| 76 | +- `BLOCKED` |
| 77 | +- `SCHEMA_CONTRACT_VERIFIER_EXISTS_ONLY` |
| 78 | +- `RENDERING_NOT_PROOF` |
| 79 | +- `HUMAN_REVIEW_REQUIRED` |
| 80 | + |
| 81 | +The flow remains: |
| 82 | + |
| 83 | +`detection source -> validation behavior -> platform contracts where applicable -> proof records -> public rendering` |
| 84 | + |
| 85 | +## Blocked Claims |
| 86 | + |
| 87 | +This surface does not claim runtime-active public proof, signal-observed public proof, public-safe runtime proof, production readiness, SOCaaS deployment, autonomous SOC operation, AI-approved disposition, AI-decided disposition, analyst-approved disposition, fleet-wide coverage, customer deployment, live Splunk public proof, live Wazuh public proof, Cribl-routed public proof, Wazuh-routed public proof, AWS-live proof, cloud-live proof, case closure, or public publication approval. |
| 88 | + |
| 89 | +## Related Repositories |
| 90 | + |
| 91 | +| Repo | Truth surface | Boundary | |
| 92 | +|---|---|---| |
| 93 | +| [hawkinsoperations-proof](https://github.com/HawkinsOperations/hawkinsoperations-proof) | Claim / proof truth | Owns proof records, claim ceilings, and blocked-claim status. | |
| 94 | +| [hawkinsoperations-platform](https://github.com/HawkinsOperations/hawkinsoperations-platform) | Contract / guardrail truth | Owns schemas, contracts, and non-promotional platform controls. | |
| 95 | +| [hawkinsoperations-validation](https://github.com/HawkinsOperations/hawkinsoperations-validation) | Behavior truth | Owns controlled validation and recorded validation outputs. | |
| 96 | +| [hawkinsoperations-detections](https://github.com/HawkinsOperations/hawkinsoperations-detections) | Source truth | Owns detection source and source-level routing. | |
| 97 | +| [hawkinsoperations-website](https://github.com/HawkinsOperations/hawkinsoperations-website) | Render truth | Renders public reviewer navigation and bounded wording. | |
33 | 98 |
|
34 | | -.github is routing/governance only. It does not own proof authority, runtime truth, signal truth, public-safe status, or website rendering truth. |
| 99 | +## Doctrine |
35 | 100 |
|
36 | | -The front-door/status proof ceiling for the command-center and ledger-status route remains `SCHEMA_CONTRACT_VERIFIER_EXISTS_ONLY`. |
| 101 | +AI is labor. Governance is authority. |
37 | 102 |
|
38 | | -The proof-owned Lifetime Case Ledger public summary currently records a bounded count route only: 4 ledger events, 4 total cases, 0 public-safe cases, and 0 closed cases. Its ledger status remains `NOT_PUBLIC_SAFE`, and its proof ceiling remains `SCHEMA_CONTRACT_VERIFIER_EXISTS_ONLY`. |
| 103 | +Build loud. Verify hard. Claim tight. Ship receipts. |
39 | 104 |
|
40 | | -The canonical private HawkinsOperations Control Board is the private org Project #2 route. Project #1 is not an active reviewer route and was not resolvable through the live ProjectV2 API during the current cleanup pass. Project metadata remains coordination-only and does not create proof, approval, runtime truth, signal truth, public-safe status, or merge authority. |
| 105 | +Rendering is not proof. |
0 commit comments