scawful/afs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: refresh status and roadmap

Browse Source
This commit is contained in:
scawful
2025-12-30 13:37:06 -05:00
parent f386327821
commit b543ff989c
4 changed files with 16 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
README.md
View File

@@ -22,5 +22,7 @@ Quickstart:
- `python -m afs context discover --path ~/src/trunk`
- `python -m afs context ensure-all --path ~/src/trunk`
- `python -m afs graph export --path ~/src/trunk`
- `python -m afs services list`
- `python -m afs orchestrator list`
Discovery skips directory names in `general.discovery_ignore` (default: legacy, archive, archives).

13
docs/PORTING_MAP.md
View File

@@ -17,8 +17,8 @@ Status legend: Ported, Partial, Planned, Not started.
- Studio UI (ImGui): Ported (apps/studio). Active.
- CLI surface: Partial (core context + graph + plugins; orchestration/services missing).
- Plugin framework + adapters: Partial (discovery + load only; adapters not yet).
- Orchestration/pipelines/swarm: Not started.
- Service management + daemons: Not started.
- Orchestration/pipelines/swarm: Partial (routing skeleton + CLI).
- Service management + daemons: Partial (definitions + render preview).
- TUI: Not started.
- API/backends/integrations/models/llm: Not started.
- Native/cc/editor tooling: Not started.
@@ -28,12 +28,11 @@ Status legend: Ported, Partial, Planned, Not started.
- Dataset registry indexing: Ported. `src/afs_scawful/registry.py`, `src/afs_scawful/cli.py`.
- Resource indexing: Ported. `src/afs_scawful/resource_index.py`, `src/afs_scawful/cli.py`.
- Training monitor config: Ported (AFS Studio loads plugin config).
- Validators (ASM/C++/KG/ASAR): Planned.
- Validators (ASM/C++/KG/ASAR): Partial (base + initial ports).
- Generators (ASM/Oracle/curated/etc.): Planned.
- Ops/runbooks/host scripts: Not started (needs reorg as CLI tasks).
## Near-term ports (priority)
1) Service config + minimal service manager (core).
2) Orchestrator config + routing skeleton (core).
3) Validator base + first validators (plugin).
4) Generator base + one small generator (plugin).
1) Service adapters (launchd/systemd) in dry-run mode.
2) Generator base + one small generator (plugin).
3) TUI starter screen (status + contexts).

7
docs/ROADMAP.md
View File

@@ -5,12 +5,13 @@
- Context manager (init/ensure/mount/list) + discovery + graph export
- Plugin discovery + load hooks
- AFS Studio port (ImGui app)
- Service definitions + render preview
- Orchestrator routing skeleton
- Test harness for core modules
## Planned
- Service config + minimal service manager (no auto-start by default)
- Orchestrator config + routing skeleton
- TUI starter (status + context browsing)
- Test harness for core modules
- Service adapters (dry-run launchd/systemd)
## Ideas
- Idea: Full orchestration pipeline (plan/execute/verify) with adapters

8
docs/STATUS.md
View File

@@ -1,7 +1,7 @@
# STATUS
Stage: Prototype
Now: init/status/workspace commands; context init/list/mount/validate/discover/ensure-all; graph export; minimal config + plugin discovery; studio sources in apps/studio.
Not yet: service runtime; full configuration schema validation.
Next: one small utility; smoke-test stub.
Issues: no runtime yet.
Now: init/status/workspace commands; context init/list/mount/validate/discover/ensure-all; graph export; minimal config + plugin discovery; service + orchestrator skeletons; pytest coverage for core modules; studio sources in apps/studio.
Not yet: service adapters that touch launchd/systemd; full orchestration pipeline; TUI.
Next: port service adapters in dry-run mode; improve orchestrator routing heuristics; add TUI starter screen.
Issues: service runtime not wired to system services.