chore(conductor): Archive strategic overview and split into granular tracks

This commit is contained in:
2026-05-07 22:06:13 -04:00
parent 822d803ad8
commit d8022d841e
17 changed files with 147 additions and 4 deletions
@@ -0,0 +1,5 @@
# Track controller_state_mutation_matrix_20260507 Context
- [Specification](./spec.md)
- [Implementation Plan](./plan.md)
- [Metadata](./metadata.json)
@@ -0,0 +1,8 @@
{
"track_id": "controller_state_mutation_matrix_20260507",
"type": "chore",
"status": "new",
"created_at": "2026-05-07T16:00:00Z",
"updated_at": "2026-05-07T16:00:00Z",
"description": "Comprehensive map of all methods that modify the AppController and App state."
}
@@ -0,0 +1,10 @@
# Implementation Plan: Controller State Mutation Matrix (controller_state_mutation_matrix_20260507)
## Phase 1: State Inventory
- [ ] Task: List all public and private properties in `AppController` and `App`.
- [ ] Task: Identify all threading locks and their current usage patterns.
## Phase 2: Mutation Mapping
- [ ] Task: Use grep/AST tools to find all assignments to identified state fields.
- [ ] Task: Populate the mutation matrix table.
- [ ] Task: Conductor - User Manual Verification 'Final Review' (Protocol in workflow.md)
@@ -0,0 +1,21 @@
# Specification: Controller State Mutation Matrix (controller_state_mutation_matrix_20260507)
## Overview
Mapping the state landscape of the Manual Slop application. We need to know exactly which methods have the authority to change global state, especially within `AppController` and `App`.
## Scope
- **Classes:** `App`, `AppController`.
- **Target Fields:** `ai_status`, `mma_status`, `_pending_gui_tasks`, `disc_entries`, `config`, etc.
## Functional Requirements
1. **Mutation Matrix:**
- Create a table: [Method Name] x [State Field Modified].
2. **Lock Ownership Audit:**
- Document which locks (e.g., `_pending_gui_tasks_lock`) protect which fields.
- Identify potential race conditions or unprotected mutations.
3. **State Lifecycle:**
- Document how state is flushed to disk (autosave) vs. held in memory.
## Acceptance Criteria
- [ ] Matrix table identifying every state mutation site.
- [ ] Audit report of thread-safety and lock usage.