resource-control/SCOPE.md
tegwick 1be143586a docs: expose portfolio and optimization capability
Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a15374-f59f-7a31-86d2-d23b5d2ed181
2026-10-19 11:28:41 +02:00

64 lines
2.7 KiB
Markdown

# SCOPE
> This file was generated by `statehub register`. Refine it as the repository
> boundaries become clearer.
## One-liner
Provider-neutral infrastructure resource inventory, procurement, cost, utilization, and optimization control plane.
## Core Idea
resource-control exists to provide the capability described in INTENT.md.
## In Scope
- Inventory purchased and proposed compute, storage, network, and managed
resources across Host Europe, Scaleway, Hetzner, and future providers.
- Normalize price, commitment, utilization, capacity, ownership, workload,
location, failure domain, renewal, and exit data.
- Associate every expense, estimate, usage observation, and expense
evaluation with exactly one financial entity (Binky, Frontier, Railiance,
Netkingdom, Helixforge, Coulomb) per `docs/TermsOfResourceProcurement.md`.
- Compute Railiance delivered cost and internal transfer prices (cost plus
published markup); emit monthly settlement and credit-state evidence.
- Research and compare procurement options against provider-neutral
requirements.
- Publish resource allocation, forecast, realized-cost, and optimization
evidence to fin-hub.
- Track procurement decisions, renewal/cancellation windows, rightsizing,
consolidation, and provider-switch opportunities.
- Verify that acquired resources satisfy their operational requirement.
## Out of Scope
- Execute payments or approve financial commitments.
- Store provider, billing, or workload credentials.
- Own workload manifests, application retention policy, or backup procedures.
- Replace fin-hub's budget, burn-rate, runway, and viability authority.
- Make irreversible procurement or cancellation decisions without human
approval.
## Current State
- Status: stable. WP-0001 through WP-0007 are finished. Live inventory is
schema 0.3 with five facets. Backup object storage is live on
`reef-storage`. No open workplans.
## Getting Oriented
- Start with: INTENT.md
- Internal procurement terms: docs/TermsOfResourceProcurement.md
- Operational refs: docs/operational-reference-convention.md
- Agent instructions: AGENTS.md
- Workplans: workplans/
## Provided Capabilities
```capability
type: operations
title: Infrastructure portfolio and optimization evidence
description: Normalize resource inventory, capacity, utilization, ownership and cost evidence; make portfolio-report renders the portfolio and make optimization CASE=... evaluates a supplied optimization case. Workload owners retain deployment authority and fin-hub retains booked financial authority; observations do not grant procurement or scheduling admission.
keywords: [resource, inventory, capacity, allocation, forecast, cost, optimization]
```