docs: add thesis evidence index

2026-06-14 17:22:52 +07:00
parent 1aa40285b1
commit 62b59401a3
1 changed files with 88 additions and 0 deletions
@@ -0,0 +1,88 @@
+# Thesis Evidence Index
+
+This file maps thesis claims to implementation evidence. It is not prose for the
+final report; it is a guardrail against unsupported claims.
+
+## Core Workflow Lifecycle
+
+Claim: The platform separates mutable drafts, immutable artifacts, deployments,
+runs, and traces.
+
+Evidence:
+
+- `src/wf_artifacts/models.py` — artifact/deployment models.
+- `src/wf_artifacts/runs/` — run records and run store.
+- `src/wf_api/service.py` — facade for workflow lifecycle operations.
+- `tests/wf_api/test_artifact_api.py`
+- `tests/wf_api/test_run_api.py`
+
+## Source Provider Boundary
+
+Claim: Workflow execution consumes source-provided capabilities without making
+the core runtime MCP-specific.
+
+Evidence:
+
+- `src/wf_platform/sources.py` — neutral source DTOs and source policy.
+- `src/wf_server/config.py` — server composition for configured sources.
+- `src/wf_sources_mcp/` — MCP source family.
+- `src/wf_sources_python/` — Python source family.
+- `docs/source_architecture.md`
+
+## Agent-Operable Surface
+
+Claim: External agents can operate the workflow lifecycle through stable CLI/API
+surfaces.
+
+Evidence:
+
+- `src/wf_cli/`
+- `src/wf_transport_rpc_http/`
+- `tests/wf_cli/`
+- `tests/wf_transport_rpc_http/`
+- `docs/wf_cli.md`
+
+## Validation And Diagnostics
+
+Claim: Validation and diagnostics make failed workflow states repairable.
+
+Evidence:
+
+- `src/wf_artifacts/validation.py`
+- `src/wf_api/next_actions.py`
+- `src/wf_api/source_admin.py`
+- `tests/artifacts/test_validation.py`
+- `tests/wf_api/test_source_admin_api.py`
+
+## Stateful MCP Source Correctness
+
+Claim: MCP-backed sources can preserve stateful sessions across workflow calls.
+
+Evidence:
+
+- `src/wf_sources_mcp/runtime/`
+- `src/wf_sources_mcp/client/`
+- `tests/wf_sources_mcp/test_runtime.py`
+- `tests/wf_transport_rpc_http/test_mcp_backed_server_rpc.py`
+
+## Python Source Case Study
+
+Claim: The source-provider model is not MCP-only.
+
+Evidence:
+
+- `examples/report_workflow/`
+- `src/wf_sources_python/`
+- `tests/examples/test_report_workflow_example.py`
+- `tests/wf_sources_python/test_loader.py`
+
+## Limitations
+
+Claim: This is a prototype platform substrate, not a finished automation product.
+
+Evidence:
+
+- `docs/add/thesis-outline.md`
+- `docs/current_roadmap.md`
+- absence of scheduler/visual-editor/secret-manager production packages in
+  current source tree.