Skip to content

docs(backlog): B-0836 — hardware-inventory-vs-cluster reconciliation + buying-decisions substrate (no more buying willy nilly)#5353

Merged
AceHack merged 1 commit into
mainfrom
otto/b-0836-hardware-inventory-vs-cluster-reconciliation-gap-analysis-buying-decisions-2026-05-26
May 26, 2026
Merged

docs(backlog): B-0836 — hardware-inventory-vs-cluster reconciliation + buying-decisions substrate (no more buying willy nilly)#5353
AceHack merged 1 commit into
mainfrom
otto/b-0836-hardware-inventory-vs-cluster-reconciliation-gap-analysis-buying-decisions-2026-05-26

Conversation

@AceHack
Copy link
Copy Markdown
Member

@AceHack AceHack commented May 26, 2026

Summary

Per operator 2026-05-26: "we will also have an inventory for every machine and know if some are missing registration when she is done with her hardware inventory work. and know what and how we need to expand so we are not buying willy nilly anymore."

Combined with the architectural clarification: "git for source of truth and coackroach can be repopulated from".

4-phase decomposition

Phase Scope Depends on
1 Addison's CSV → DuckDB ingestion Immediate (doesn't need cluster)
2 tools/cluster/reconcile-inventory-vs-cluster.ts (3 gap types) At least one B-0812 self-reg PR merged
3 CockroachDB ingestion from git source-of-truth Cluster operational + CockroachDB deployed
4 tools/cluster/buying-recommendations.ts (closes the loop) Phases 2+3 + workload metrics

3 operational questions the reconciliation answers

Question Action
Missing registration? (in inventory; not in git cluster-nodes) Either not deployed yet OR self-reg failed
Phantom node? (in git cluster-nodes; not in inventory) Either stale inventory OR unknown machine registered
Expansion-buying-decision? What hardware to buy — informed by data not guesswork

Architecture

Addison's inventory ──┐                    ┌── Reconciliation tool
(paper → scan → CSV   │                    │   (this row B-0836)
 → DuckDB → CRDB)     │                    │
                      ▼                    ▼
              GIT SOURCE OF TRUTH ──── Gap analysis
                      ▲                    │
                      │                    ▼
              B-0812 iter-5.4.1     Buying decisions
              self-registration       (data-driven)

Highest-value operator outcome

Shifts hardware-purchase decisions from "guess what we need" to "data says we need N more of make/model X for workload Y." Materially affects operator cost-management.

Test plan

🤖 Generated with Claude Code

…+ buying-decisions substrate (no more buying willy nilly)

Per operator 2026-05-26 composed from two messages:

1. "git for source of truth and coackroach can be repopulated from"
2. "we will also have an inventory for every machine and know if some
   are missing registration when she is done with her hardware
   inventory work. and know what and how we need to expand so we are
   not buying willy nilly anymore."

Files B-0836 as P1 substrate-engineering target. 4-phase decomposition:

- Phase 1: Addison's CSV → DuckDB ingestion (immediate; doesn't need
  cluster)
- Phase 2: tools/cluster/reconcile-inventory-vs-cluster.ts (this row
  core; surfaces 3 gap types — missing-registration / phantom-node /
  expansion-buying-decision)
- Phase 3: CockroachDB ingestion when cluster operational (materialized
  view from git source of truth; repopulates anytime)
- Phase 4: tools/cluster/buying-recommendations.ts (closes the loop;
  data-driven purchase decisions)

Architecture: git (B-0812 cluster-nodes + Addison inventory) is source
of truth; CockroachDB is materialized view; reconciliation diffs both
sides; buying decisions informed by capacity-gap analysis.

Composes_with:
- B-0812 iter-5.4.1 (cluster-side data source; PR #5352 in flight)
- B-0794 parent (full GitOps cluster bring-up)
- B-0782 cluster-IS-DIO (git source of truth)
- B-0789 cluster-as-PR-author
- Addison's hardware-inventory paper-audit work (Phase 1 ingestion)
- 2026-05-26 physical hardware-support test session

Highest-value operator outcome: shifts hardware-purchase decisions
from "guess what we need" to "data says we need N more of make/model X
for workload Y." Materially affects operator cost-management.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 26, 2026 23:27
@AceHack AceHack enabled auto-merge (squash) May 26, 2026 23:27
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@AceHack AceHack merged commit 9908dcc into main May 26, 2026
29 of 30 checks passed
@AceHack AceHack deleted the otto/b-0836-hardware-inventory-vs-cluster-reconciliation-gap-analysis-buying-decisions-2026-05-26 branch May 26, 2026 23:29
@AceHack AceHack review requested due to automatic review settings May 26, 2026 23:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant