update/fmt docs, lineage_writes_for_frame

.serena/memories/project_overview.md

@@ -3,17 +3,20 @@
 `lda-workflow-as-struct` is a Python 3.14 prototype for `lda.chat`: an AI-assisted workflow system where an LLM plans structured workflows and a deterministic executor validates/runs them.
 
 Main packages live under `src/`:
+
 - `wf_core`: workflow model, validation, runtime semantics, frames, trace, interrupts, foreach, async execution.
 - `wf_authoring`: ergonomic authoring layer including `@node`, `NodeSpec`, `WorkflowBuilder`, conditions, paths, and subgraph wrapping.
 - `wf_mcp`: MCP broker/proxy layer for managing multiple backend MCP connections, transparent FastMCP proxying, live config/admin tools, hot reload, tool introspection, discovery/catalog snapshots, and eventual workflow build/run integration.
 
 Important docs:
+
 - `readme.md`: running design notes and architecture.
 - `authoring_sketch.md`: authoring API direction.
 - `wf_mcp_plan.md`: MCP proxy/broker/workflow integration plan.
 - `scratchpad.md`: rough design history.
 
 Current MCP direction:
+
 - Transparent proxy mode is the main product path.
 - Old broker mode remains useful for debugging/admin/catalog operations.
 - Protocol-native FastMCP proxying exposes upstream tools/resources/prompts as first-class MCP capabilities.
@@ -21,6 +24,7 @@ Current MCP direction:
 - Direct Serena is configured outside `wf_mcp` and should be preferred for code navigation/editing because it does not reset when `wf-mcp` hot-reloads.
 
 Recent `wf_mcp` capabilities:
+
 - Pydantic config boundary in `config_models.py`.
 - Config mutation boundary in `config_manager.py`.
 - Proxy validation in `proxy_validation.py`.
@@ -29,4 +33,4 @@ Recent `wf_mcp` capabilities:
 - Opaque cursor pagination helpers in `pagination.py`.
 - Admin tools under `wf.mcp_*`: list/get config, add/update/enable/disable/remove connection, reload config, list/get proxy tools.
 - `wf.mcp_list_proxy_tools` supports `connection_id`, `query`, `limit`, and `cursor`; returns `{tools, nextCursor, total}`.
-- `wf.mcp_get_proxy_tool` returns one detailed proxied tool row with schema where available.
+- `wf.mcp_get_proxy_tool` returns one detailed proxied tool row with schema where available.