tai/taicpp/PARITY.md

# Parity detz vs tai.py (generated, do not edit)

Generated by `tools/parity_ledger.py` from the symbol ledger and the last differential run.
Only a passing differential case (`tools/parity_diff.py`) makes a symbol `verified`; a facet
after the symbol says what that case proved (for example `parse` means argument parsing only).
`name-only` means an identifier matches in the C++ tree and NOTHING about behavior is known.

- tai.py sha256: `7e817bba8d48f4ab`
- detz sha256: `a7a705c9b8bd5ed0`
- differential run: 2026-10-25T01:20:14 (tai.py `7e817bba8d48f4ab`, detz `a7a705c9b8bd5ed0`)

## Summary

| kind | total | verified | name-only | missing |
|---|---|---|---|---|
| class | 264 | 0 | 28 | 236 |
| method | 2140 | 0 | 109 | 2031 |
| function | 413 | 0 | 25 | 388 |
| tool | 61 | 0 | 61 | 0 |
| flag | 45 | 3 | 42 | 0 |
| setting | 28 | 0 | 13 | 15 |
| command | 31 | 0 | 24 | 7 |
| **all** | 2982 | 3 | 302 | 2677 |

## Differential cases

Counts: fail=54, pass=9, xfail=1

| case | status | reason |
|---|---|---|
| boot.vault | fail | vault differs (44 diff lines) |
| cli.cap_manifest | fail | stdout differs (61 diff lines) |
| cli.err.ambiguous.cap | fail | stderr differs (18 diff lines) |
| cli.err.ambiguous.debug | fail | stderr differs (18 diff lines) |
| cli.err.ambiguous.install | fail | stderr differs (18 diff lines) |
| cli.err.ambiguous.tui | fail | stderr differs (18 diff lines) |
| cli.err.auto.explicit | fail | stderr differs (18 diff lines) |
| cli.err.cap-cwd.missing | fail | stdout differs (12 diff lines) |
| cli.err.cap-manifest.explicit | fail | stderr differs (18 diff lines) |
| cli.err.cap-max-turns.int | fail | stderr differs (19 diff lines) |
| cli.err.cap-max-turns.missing | fail | stdout differs (12 diff lines) |
| cli.err.cap-model.missing | fail | stdout differs (12 diff lines) |
| cli.err.cap-permission-mode.choice | fail | stderr differs (18 diff lines) |
| cli.err.cap-permission-mode.missing | fail | stdout differs (12 diff lines) |
| cli.err.cap-speak.explicit | fail | stderr differs (18 diff lines) |
| cli.err.continue.explicit | fail | stderr differs (18 diff lines) |
| cli.err.debug-format.choice | fail | stderr differs (18 diff lines) |
| cli.err.debug-format.missing | fail | stderr differs (17 diff lines) |
| cli.err.debug.choice | fail | stderr differs (18 diff lines) |
| cli.err.demo-shot.explicit | fail | stderr differs (18 diff lines) |
| cli.err.demo.explicit | fail | stderr differs (18 diff lines) |
| cli.err.env.missing | fail | stdout differs (12 diff lines) |
| cli.err.error_before_help | fail | stderr differs (18 diff lines) |
| cli.err.eval-retrieval.explicit | fail | stderr differs (18 diff lines) |
| cli.err.install-telegram.explicit | fail | stderr differs (18 diff lines) |
| cli.err.install.explicit | fail | stderr differs (18 diff lines) |
| cli.err.mcp-bind.missing | fail | stdout differs (12 diff lines) |
| cli.err.mcp-port.int | fail | stderr differs (19 diff lines) |
| cli.err.mcp-port.missing | fail | stdout differs (12 diff lines) |
| cli.err.no-opencode.explicit | fail | stderr differs (18 diff lines) |
| cli.err.plexer-wrap.explicit | fail | stderr differs (18 diff lines) |
| cli.err.profile.missing | fail | stdout differs (12 diff lines) |
| cli.err.scheduler.explicit | fail | stderr differs (18 diff lines) |
| cli.err.serve-mcp.missing | fail | stdout differs (12 diff lines) |
| cli.err.stats-rag.explicit | fail | stderr differs (18 diff lines) |
| cli.err.telegram.explicit | fail | stderr differs (18 diff lines) |
| cli.err.theme.missing | fail | stdout differs (12 diff lines) |
| cli.err.tui-local.explicit | fail | stderr differs (18 diff lines) |
| cli.err.tui.explicit | fail | stderr differs (18 diff lines) |
| cli.err.uninstall-telegram.explicit | fail | stderr differs (18 diff lines) |
| cli.err.unknown.long | fail | stderr differs (17 diff lines) |
| cli.err.unknown.short | fail | stderr differs (17 diff lines) |
| cli.err.update-models.explicit | fail | stderr differs (18 diff lines) |
| cli.err.version.explicit | fail | stderr differs (18 diff lines) |
| cli.err.yes.explicit | fail | stderr differs (18 diff lines) |
| cli.err.yolo.explicit | fail | stderr differs (18 diff lines) |
| cli.help.wins_over_error | fail | stdout differs (87 diff lines) |
| cli.prefix.version | fail | stdout differs (5 diff lines) |
| persist.restart_history | xfail | needs the foundation agent: vault events persistence and history resume across process restarts; detz has no REPL/agent  |
| repl.help | fail | stdout differs (123 diff lines) |
| repl.profiles | fail | stdout differs (94 diff lines) |
| repl.skills_secret_schedules | fail | stdout differs (103 diff lines) |
| repl.tools | fail | stdout differs (139 diff lines) |
| repl.tools_named | fail | stdout differs (92 diff lines) |
| repl.unknown_command | fail | stdout differs (89 diff lines) |

## Python test-suite coverage

150 test classes, 1233 tests; tests reproduced by a passing diff case: 0 (in 0 classes); classes with no covered test: 150.
Full table: `build/parity/tests-map.md`.

## flags (45)

| name | status | facets | cases |
|---|---|---|---|
| `--allow-tool` | name-only |  |  |
| `--argv` | name-only |  |  |
| `--auto` | name-only |  |  |
| `--auto-answer` | name-only |  |  |
| `--binary` | name-only |  |  |
| `--cap` | name-only |  |  |
| `--cap-cwd` | name-only |  |  |
| `--cap-manifest` | name-only |  |  |
| `--cap-max-turns` | name-only |  |  |
| `--cap-model` | name-only |  |  |
| `--cap-permission-mode` | verified | parse | cli.version.with_choice,cli.ok.cap-permission-mode.none,cli.ok.cap-permission-mode.confirm |
| `--cap-speak` | name-only |  |  |
| `--continue` | name-only |  |  |
| `--cwd` | name-only |  |  |
| `--debug` | name-only |  |  |
| `--debug-format` | verified | parse | cli.ok.debug-format.sentence,cli.ok.debug-format.json |
| `--demo` | name-only |  |  |
| `--demo-shot` | name-only |  |  |
| `--deny-tool` | name-only |  |  |
| `--driver` | name-only |  |  |
| `--env` | name-only |  |  |
| `--eval-retrieval` | name-only |  |  |
| `--install` | name-only |  |  |
| `--install-telegram` | name-only |  |  |
| `--max-risk` | name-only |  |  |
| `--mcp-bind` | name-only |  |  |
| `--mcp-port` | name-only |  |  |
| `--model` | name-only |  |  |
| `--mplex` | name-only |  |  |
| `--no-opencode` | name-only |  |  |
| `--plexer-wrap` | name-only |  |  |
| `--profile` | name-only |  |  |
| `--scheduler` | name-only |  |  |
| `--serve-mcp` | name-only |  |  |
| `--stats-rag` | name-only |  |  |
| `--task` | name-only |  |  |
| `--telegram` | name-only |  |  |
| `--theme` | name-only |  |  |
| `--tui` | name-only |  |  |
| `--tui-local` | name-only |  |  |
| `--uninstall-telegram` | name-only |  |  |
| `--update-models` | name-only |  |  |
| `--version` | verified | output | cli.version.long |
| `--yes` | name-only |  |  |
| `--yolo` | name-only |  |  |

## tools (61)

| name | status | facets | cases |
|---|---|---|---|
| `ask_user` | name-only |  |  |
| `audit` | name-only |  |  |
| `create_bot` | name-only |  |  |
| `create_skill` | name-only |  |  |
| `delete_file` | name-only |  |  |
| `delete_secret` | name-only |  |  |
| `describe_image` | name-only |  |  |
| `edit_file` | name-only |  |  |
| `export_terminal_log` | name-only |  |  |
| `fork` | name-only |  |  |
| `get_current_terminal_content` | name-only |  |  |
| `graph_link` | name-only |  |  |
| `graph_query` | name-only |  |  |
| `install` | name-only |  |  |
| `install_skill` | name-only |  |  |
| `list_secrets` | name-only |  |  |
| `list_terminals` | name-only |  |  |
| `listen` | name-only |  |  |
| `load_skill` | name-only |  |  |
| `mcp_add` | name-only |  |  |
| `mcp_call` | name-only |  |  |
| `mcp_disable` | name-only |  |  |
| `mcp_enable` | name-only |  |  |
| `mcp_list` | name-only |  |  |
| `mcp_login` | name-only |  |  |
| `mcp_remove` | name-only |  |  |
| `mcp_tools` | name-only |  |  |
| `plexer_read` | name-only |  |  |
| `plexer_send` | name-only |  |  |
| `plexer_show` | name-only |  |  |
| `plexer_status` | name-only |  |  |
| `plexer_type` | name-only |  |  |
| `poll` | name-only |  |  |
| `read_file` | name-only |  |  |
| `recall` | name-only |  |  |
| `record_delete` | name-only |  |  |
| `record_read` | name-only |  |  |
| `record_save` | name-only |  |  |
| `record_search` | name-only |  |  |
| `release` | name-only |  |  |
| `remember` | name-only |  |  |
| `restore` | name-only |  |  |
| `schedule` | name-only |  |  |
| `schedules` | name-only |  |  |
| `search` | name-only |  |  |
| `shell` | name-only |  |  |
| `speak` | name-only |  |  |
| `store_secret` | name-only |  |  |
| `sysinfo` | name-only |  |  |
| `tags` | name-only |  |  |
| `tail_terminals` | name-only |  |  |
| `tui_click` | name-only |  |  |
| `tui_goto` | name-only |  |  |
| `tui_keys` | name-only |  |  |
| `tui_result` | name-only |  |  |
| `tui_screen` | name-only |  |  |
| `tui_type` | name-only |  |  |
| `unschedule` | name-only |  |  |
| `web_fetch` | name-only |  |  |
| `web_search` | name-only |  |  |
| `write_file` | name-only |  |  |

## settings (28)

| name | status | facets | cases |
|---|---|---|---|
| `backends` | name-only |  |  |
| `box_caps` | missing |  |  |
| `claude_bin` | missing |  |  |
| `codex_bin` | missing |  |  |
| `codex_sandbox` | missing |  |  |
| `devplace_base` | name-only |  |  |
| `devplace_key` | name-only |  |  |
| `devplace_models` | name-only |  |  |
| `gemini_bin` | missing |  |  |
| `gemini_plan` | missing |  |  |
| `grok_bin` | missing |  |  |
| `model` | name-only |  |  |
| `muse_bin` | missing |  |  |
| `opencode_bin` | missing |  |  |
| `opencode_client_name` | missing |  |  |
| `opencode_client_ua` | missing |  |  |
| `opencode_enabled` | missing |  |  |
| `opencode_models` | name-only |  |  |
| `openrouter_enabled` | missing |  |  |
| `openrouter_key` | name-only |  |  |
| `openrouter_models` | name-only |  |  |
| `pollinations_enabled` | missing |  |  |
| `pollinations_models` | name-only |  |  |
| `retry_seconds` | name-only |  |  |
| `theme` | name-only |  |  |
| `voice` | name-only |  |  |
| `zen_enabled` | missing |  |  |
| `zen_models` | name-only |  |  |

## commands (31)

| name | status | facets | cases |
|---|---|---|---|
| `/agent` | name-only |  |  |
| `/agents` | missing |  |  |
| `/audit` | name-only |  |  |
| `/bot` | missing |  |  |
| `/bots` | name-only |  |  |
| `/clear` | name-only |  |  |
| `/compact` | missing |  |  |
| `/ctx` | missing |  |  |
| `/demo` | name-only |  |  |
| `/env` | missing |  |  |
| `/fork` | name-only |  |  |
| `/graph` | name-only |  |  |
| `/help` | name-only |  |  |
| `/install` | name-only |  |  |
| `/models` | name-only |  |  |
| `/profile` | name-only |  |  |
| `/profiles` | missing |  |  |
| `/quit` | missing |  |  |
| `/record` | name-only |  |  |
| `/records` | name-only |  |  |
| `/release` | name-only |  |  |
| `/restore` | name-only |  |  |
| `/schedule` | name-only |  |  |
| `/schedules` | name-only |  |  |
| `/search` | name-only |  |  |
| `/secret` | name-only |  |  |
| `/skills` | name-only |  |  |
| `/sysinfo` | name-only |  |  |
| `/tags` | name-only |  |  |
| `/tools` | name-only |  |  |
| `/unschedule` | name-only |  |  |

## Classes with the most missing methods (top 25 of 241)

| class | missing methods |
|---|---|
| MplexCopyMode | 128 |
| MplexCommands | 92 |
| Store | 90 |
| MplexServer | 87 |
| Tools | 85 |
| TuiApp | 62 |
| GrrChatView | 55 |
| TuiPanel | 50 |
| GrrShell | 50 |
| CapAcpDriver | 44 |
| TuiVtScreen | 35 |
| ChatClient | 28 |
| Agent | 26 |
| CapA2aDriver | 24 |
| McpOAuth | 21 |
| MplexPane | 20 |
| TuiCompositor | 20 |
| TuiTextBox | 19 |
| CapPtyDriver | 19 |
| CapFleet | 19 |
| GrrPage | 18 |
| CapDriver | 17 |
| Glow | 16 |
| DebugLog | 16 |
| TuiTerminal | 16 |