Metadata-Version: 2.4
Name: mgf-fedres
Version: 0.1.1
Summary: The federation-resources spine: the fed-resources/ convention, schemas, the manifest + sync engine, the SourceProvider seam, live NDJSON + run-records, and the fedres CLI — the shared core for mgf-fed-web and mgf-test-web. Sibling of mgf-common under the mgf.* namespace.
Project-URL: Homepage, https://codeberg.org/magogi-admin/mgf-fedres
Project-URL: Issues, https://codeberg.org/magogi-admin/mgf-fedres/issues
Project-URL: Changelog, https://codeberg.org/magogi-admin/mgf-fedres/src/branch/main/CHANGELOG.md
Author: Bassam Alsanie, mgf-fedres contributors
License: MIT
License-File: LICENSE
Keywords: cli,fed-resources,federation,magogi,provenance,sync
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.11
Requires-Dist: jsonschema>=4.18
Provides-Extra: dev
Requires-Dist: import-linter>=2.0; extra == 'dev'
Requires-Dist: mgf-standard<0.2,>=0.1.6; extra == 'dev'
Requires-Dist: mgf-test-supervisor<0.2,>=0.1.3; extra == 'dev'
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest-timeout<3,>=2.3; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff<0.16,>=0.4; extra == 'dev'
Provides-Extra: standards
Requires-Dist: mgf-common[standards]<0.50,>=0.47; extra == 'standards'
Description-Content-Type: text/markdown

# mgf-fedres

**The federation-resources spine** — the shared core that both **`mgf-fed-web`** (the
federation dashboard) and **`mgf-test-web` / ProofWarden** (the testing & CI authority
console) build on. Part of the Magogi Foundation federation, under the `mgf.*` namespace.

```
mgf-brand-web 0.2        CSS tokens + the operator-instrument layer
        |
mgf-fedres   <-- you are here   the shared spine
        |   schemas (all, incl. test_*) + version-aware reader + validator
        |   manifest + sha256 + canonical-JSON
        |   sync engine: shallow (manifest) + deep (regenerate -> diff, non-mutating)
        |   SourceProvider seam: DiskProvider (now) / PackageProvider (later)
        |   live/ NDJSON reader+writer + run-record writer
        |   the `fedres` CLI: status / check / generate / run --trace / tail + the gate
        |
        |-------------------------> mgf-fed-web   (federation console)
        +--> mgf-test-web           (warden + testctl in base; [web] = ProofWarden console)
```

## What this provides

- **`fed-resources/`** — the per-project directory convention: `generated/` (schema-governed,
  freshness-gated, committed), `feedback/` (authored rounds), `live/` (ephemeral NDJSON).
- **The sync truth model** — "in sync" means regenerating `generated/` yields byte-identical
  output; states are first-class (`IN_SYNC / STALE / TAMPERED / UNKNOWN / UNREADABLE /
  CHECKING / SYNCING / ERROR`), never blank.
- **The schemas** — one versioned, symmetric set (`schema_version 0.1`) shared by both tools.
- **The `fedres` CLI** — the deterministic, JSON-emitting contract surface the webs consume.

## Status

**Planning / pre-implementation.** The end-to-end plan and the authoritative specs,
briefs, and reference wireframes for both tools live in **[`docs/planning/`](docs/planning/)**:

- [`docs/planning/PLAN.md`](docs/planning/PLAN.md) — the approved end-to-end plan (both tools).
- [`docs/planning/mgf-fed-web/`](docs/planning/mgf-fed-web/) — spec + brief + dashboard wireframe.
- [`docs/planning/mgf-test-web/`](docs/planning/mgf-test-web/) — spec + brief + console wireframe.

Implementation begins at Phase A (this package's M0/M1) per the plan.

## License

MIT © The Magogi Foundation
