From b543ff989cf4d315dcfc4a0caa67e17e885d61fb Mon Sep 17 00:00:00 2001 From: scawful Date: Tue, 30 Dec 2025 13:37:06 -0500 Subject: [PATCH] docs: refresh status and roadmap --- README.md | 2 ++ docs/PORTING_MAP.md | 13 ++++++------- docs/ROADMAP.md | 7 ++++--- docs/STATUS.md | 8 ++++---- 4 files changed, 16 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 7bc42a7..bc0025e 100644 --- a/README.md +++ b/README.md @@ -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). diff --git a/docs/PORTING_MAP.md b/docs/PORTING_MAP.md index 380ce8c..67537b3 100644 --- a/docs/PORTING_MAP.md +++ b/docs/PORTING_MAP.md @@ -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). diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index a03d228..8f5e8c7 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -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 diff --git a/docs/STATUS.md b/docs/STATUS.md index 2f284aa..ab06016 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -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.