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

docs: update roadmap and feature map

Browse Source
This commit is contained in:
scawful
2025-12-30 13:15:10 -05:00
parent ff807f2b3a
commit 4084bc87e0
3 changed files with 51 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
docs/PORTING_MAP.md Normal file
View File

@@ -0,0 +1,39 @@
# Feature Map (legacy -> current)
Scope: inventory of legacy features and their status in the current AFS/AFS Scawful repos. Use this as a porting checklist; verify specifics when moving code.
Sources (local workspace):
- Previous core: `trunk/scawful/research/legacy/afs_legacy`
- Previous plugin: `trunk/scawful/research/legacy/afs_scawful_legacy`
- Current core: `trunk/scawful/research/afs`
- Current plugin: `trunk/scawful/research/afs_scawful`
Status legend: Ported, Partial, Planned, Not started.
## AFS Core
- Context roots + workspace registry: Ported (config + CLI + workspaces.toml). `src/afs/config.py`, `src/afs/cli.py`.
- Context validation/mapping/policy/graph: Ported. `src/afs/manager.py`, `src/afs/mapping.py`, `src/afs/policy.py`, `src/afs/validator.py`, `src/afs/graph.py`.
- Discovery + ensure-all: Ported. `src/afs/discovery.py`, `src/afs/cli.py`.
- 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.
- TUI: Not started.
- API/backends/integrations/models/llm: Not started.
- Native/cc/editor tooling: Not started.
## AFS Scawful Plugin
- Training paths/resources config: Ported. `src/afs_scawful/config.py`.
- 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.
- 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).

17
docs/ROADMAP.md
View File

@@ -1,13 +1,18 @@
# ROADMAP
## Committed
- Minimal module layout + package stubs
- One small utility
- Core config + schema + CLI
- Context manager (init/ensure/mount/list) + discovery + graph export
- Plugin discovery + load hooks
- AFS Studio port (ImGui app)
## Planned
- Configuration schema
- Basic CLI entry point
- Service config + minimal service manager (no auto-start by default)
- Orchestrator config + routing skeleton
- TUI starter (status + context browsing)
- Test harness for core modules
## Ideas
- Idea: Status TUI
- Idea: Plugin discovery via ~/.config/afs/plugins
- Idea: Full orchestration pipeline (plan/execute/verify) with adapters
- Idea: Context window builder + token budgeting helpers
- Idea: Service adapters for launchd/systemd with dry-run previews