ed/manual_slop
Private
Public Access
0
0
Fork 0
Code Activity

docs(conductor): type_aliases count, tracks.md stale rows, index.md guide count

Browse Source 
- product-guidelines.md: '10 aliases' -> core + extended per-aggregate
  dataclasses (Metadata, CommsLogEntry, ... PathInfo, FileItemsDiff,
  JsonPrimitive/JsonValue) reflecting the actual ~19 types in
  src/type_aliases.py.
- tracks.md: marked rows 2 (qwen_llama_grok), 3 (data_oriented_error
  handling), 17 (code_path_audit) as Completed per chronology.md
  (they were stale 'in progress' / 'ready to start'). Added cleanup
  note. data_structure_strengthening already dropped.
- index.md: '27 deep-dive guides' -> 41 (actual count in docs/);
  refreshed last doc-refresh date to 2026-07-02 with the drift-fix
  summary.
This commit is contained in:
ed
2026-07-02 19:02:35 -04:00
parent 84372a9ae0
commit e5a8a84381
3 changed files with 12 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
conductor/product-guidelines.md
+5 -2
View File
@@ -98,9 +98,12 @@ section for the full taxonomy.
The codebase follows the "names for shapes" pattern: every `dict[str, Any]`
or `list[dict[...]]` should use a `TypeAlias` from `src/type_aliases.py`.
The 10 aliases (`Metadata`, `CommsLogEntry`, `CommsLog`, `HistoryMessage`,
The core aliases (`Metadata`, `CommsLogEntry`, `CommsLog`, `HistoryMessage`,
`History`, `FileItem`, `FileItems`, `ToolDefinition`, `ToolCall`,
`CommsLogCallback`) cover the 86% of common patterns. The canonical
`CommsLogCallback`) plus the extended per-aggregate dataclasses
(`SessionInsights`, `DiscussionSettings`, `CustomSlice`, `MMAUsageStats`,
`ProviderPayload`, `UIPanelConfig`, `PathInfo`, `FileItemsDiff`, plus
the `JsonPrimitive`/`JsonValue` pair) cover the common patterns. The canonical
reference is in
[`conductor/code_styleguides/type_aliases.md`](code_styleguides/type_aliases.md).