Documentation and tooling audit: 2026-10-24¶
Historical audit: This records the documentation and tools at the audit date, not the current project status. Start with the current roadmap and handoff.
Baseline: dev-0.9.0-bootloader, 4fb9c7f1. Owner direction: stabilize the existing Unity game by December 2026; no new features; Godot rewrite cancelled.
This record describes the initial cleanup/CLI verification snapshot. A later documentation-only recollection pass added the documentation process, design ideas, ARCH-01, and a current ownership/authoring map. Counts and workspace-state checks below describe the earlier snapshot, not a claim that the workspace has remained unchanged since then. No new Unity execution or runtime validation was performed during that follow-up.
A second recollection pass extended the same design register through IDEA-19, including a proposed demo content boundary. Source checks added GAME-14/15 (stage reward filtering/index data), CONTENT-08 (enemy preview placeholder), and NET-01 (unverified server admission). Existing revive/collection/dialogue/demo traces were distinguished from newly proposed behavior. Official Steam/itch documentation was consulted for demo distribution and backend authentication; no backend requests, publishing, legal drafting, code changes, or runtime tests were performed. Pre-existing script/package/settings state was preserved during this pass.
Scope and findings¶
Inventoried all 65 first-party Markdown documents previously under docs/, the four root migration export folders, and the Phase 9 .handoff packet. Reviewed document roles, conflicting claims, proposed work, and runtime-relevant risks; cross-checked selected startup/save/reward/spawn/input/asset/settings paths against source. This was not a line-by-line audit of all game code or a full revalidation of every historical guide. Vendored plugin/package documentation and generated folders are outside the documentation cleanup.
The issue register records 36 game/content/release/tooling findings: 35 unresolved defects, risks, reported symptoms, or validation gaps, plus one disproven missing-material lead. These are not 35 reproduced bugs. Six documentation problems were addressed there too. The freeze root cause remains unconfirmed.
Useful corrections established by source inspection:
- The missing audio is one clip plus its metadata, with references remaining in MainMenu and a skill prefab.
- The best-level save call uses BestScore rather than BestLevel.
- Offline startup and legacy save migration have concrete problematic paths requiring runtime verification.
- Three older controller guides described conflicting implementations; only the simple refresh panel is active code.
- Runtime catalogs use explicit assigned lists, so Resources membership alone is not proof of released content.
- Global and Windows-profile version strings disagree; the last commit subject is not release identity.
- The allegedly missing Player material resolves to the URP default Sprite-Lit material in the package cache.
- HEAD is planning/docs plus JSON handoffs/editor configuration, with no Unity Assets/Packages/ProjectSettings change; the older branch-to-main differences still include substantial Unity changes.
Documentation changes¶
- Replaced the duplicate refactor-plan index with an entry point and updated the root README.
- Created one active status page, issue register, stabilization plan, architecture reference, maintenance reference, CLI workflow, and this audit record.
- Archived 60 historical documents, each with a withdrawal/status notice. Original bodies are retained with line-ending normalization; obsolete paths and claims below the notices are historical text.
- Deleted four speculative folder/tree documents. Git retains their original versions.
- Grouped five cancelled migration handoff packets under the migration archive, including the previously hidden Phase 9 packet. Their 13 JSON files moved without byte changes.
- No gameplay code, scene, prefab, save format, release metadata, or intended dependencies were changed. The pre-existing deleted audio and
.metaremain untouched.
Verification record¶
| Check | Result and evidence |
|---|---|
| Documentation disposition | PASS: every one of the 65 original Markdown files has a row below: 60 archived, 4 deleted, 1 index replaced. |
| Original archival content | PASS: all 60 archived documents retain the original HEAD body after the added notices, allowing CRLF normalization. |
| Migration JSON preservation | PASS: all 13 destination JSON SHA-256 hashes match their pre-move originals. |
| Local links and source paths | PASS: final local Markdown link scan covers README and all current/archive pages with no missing destinations. Historical literal paths in backticks are not presented as validated current links. |
| Whitespace | PASS: git diff --check completed without output. |
| Runtime/settings scope | PASS: package manifest, lock, and EditorBuildSettings match original HEAD bytes after restoring Unity-generated probe changes. The only remaining changes under Assets/Packages/ProjectSettings are the two pre-existing deleted audio paths. |
| Upgrade array audit | No effect/value length mismatches found in serialized upgrade assets inspected under Resources and Scriptable Object folders. This does not validate effect semantics or production reachability. |
| Installed Editor/CLI | PASS: required Editor reports 6000.2.8f1; CLI reports 1.0.0-beta.12. |
| Initial direct Editor probe | INCOMPLETE: reached C# compilation, then the 300-second limit interrupted asset import; exit 124. |
| CLI Linux-target import/compile | PASS WITH WARNINGS: exited 0 and logged successful batch shutdown plus game/firstpass/Editor assembly compilation. Unity automatically added its Linux toolchain during verification; generated tracked changes were removed afterward. |
| Generator output | WARNING: three CS8785 generator failures; recorded as TOOL-03. |
| Windows release tooling | UNAVAILABLE: missing Windows platform support/types; no Windows player build attempted. |
| Live Editor bridge | UNAVAILABLE: command listing reported no Pipeline instance. |
| Gameplay/Steam/physical input | NOT RUN: no freeze reproduction, player build, full run, save migration, controller interaction, achievement, or leaderboard acceptance test. |
The successful CLI log is temporarily available at /tmp/tinychaos-doc-audit-cli-linux.log; the earlier probe log is /tmp/tinychaos-doc-audit-editor.log. Raw logs were not committed. The durable evidence above is intentionally sanitized. See the CLI workflow for the exact reproducible command and its limits.
Previous document disposition¶
Deleted documents are recoverable from Git at the baseline commit. Archived implementation checklists and completion statements are not current validation results.
| Previous path | Current location / disposition | Reason |
|---|---|---|
docs/AchievementDebugLoggingSummary.md |
AchievementDebugLoggingSummary.md | Historical refactor/setup notes; superseded by current references. |
docs/CoreREADME.md |
Deleted; retained in Git history | Speculative folder rules/tree, including nonexistent classes; replaced by current architecture reference. |
docs/DOTweenAnimationMigration.md |
DOTweenAnimationMigration.md | Historical refactor/setup notes; superseded by current references. |
docs/EditorREADME.md |
Deleted; retained in Git history | Speculative folder rules/tree, including nonexistent classes; replaced by current architecture reference. |
docs/EncryptionBypassGuide.md |
EncryptionBypassGuide.md | Historical refactor/setup notes; superseded by current references. |
docs/FileReorganizationSummary.md |
FileReorganizationSummary.md | Historical refactor/setup notes; superseded by current references. |
docs/GameStateRefactoringSummary.md |
GameStateRefactoringSummary.md | Historical refactor/setup notes; superseded by current references. |
docs/GameSystemREADME.md |
Deleted; retained in Git history | Speculative folder rules/tree, including nonexistent classes; replaced by current architecture reference. |
docs/HyperspaceTransitionSetup.md |
HyperspaceTransitionSetup.md | Historical refactor/setup notes; superseded by current references. |
docs/JoystickDetectionQuickStart.md |
JoystickDetectionQuickStart.md | Historical refactor/setup notes; superseded by current references. |
docs/JoystickDetectionSystem.md |
JoystickDetectionSystem.md | Historical refactor/setup notes; superseded by current references. |
docs/JoystickRefreshSetup.md |
JoystickRefreshSetup.md | Historical refactor/setup notes; superseded by current references. |
docs/LeaderboardRefactoringSummary.md |
LeaderboardRefactoringSummary.md | Historical refactor/setup notes; superseded by current references. |
docs/LocalizedTextHandlerGuide.md |
LocalizedTextHandlerGuide.md | Historical refactor/setup notes; superseded by current references. |
docs/LocalizedTextHandlerImplementation.md |
LocalizedTextHandlerImplementation.md | Historical refactor/setup notes; superseded by current references. |
docs/ManagerRefactoringSummary.md |
ManagerRefactoringSummary.md | Historical refactor/setup notes; superseded by current references. |
docs/MenuControllerGameMenuIntegration.md |
MenuControllerGameMenuIntegration.md | Historical refactor/setup notes; superseded by current references. |
docs/MenuControllerRefactoringSummary.md |
MenuControllerRefactoringSummary.md | Historical refactor/setup notes; superseded by current references. |
docs/NewtonsoftJsonImplementation.md |
NewtonsoftJsonImplementation.md | Historical refactor/setup notes; superseded by current references. |
docs/QuitConfirmationSystem.md |
QuitConfirmationSystem.md | Historical refactor/setup notes; superseded by current references. |
docs/SaveDataDebuggerDocumentation.md |
SaveDataDebuggerDocumentation.md | Historical refactor/setup notes; superseded by current references. |
docs/SceneTransitionSetup.md |
SceneTransitionSetup.md | Historical refactor/setup notes; superseded by current references. |
docs/SplashScreenImplementation.md |
SplashScreenImplementation.md | Historical refactor/setup notes; superseded by current references. |
docs/TooltipRefactoringSummary.md |
TooltipRefactoringSummary.md | Historical refactor/setup notes; superseded by current references. |
docs/UIReorganizationSummary.md |
UIReorganizationSummary.md | Historical refactor/setup notes; superseded by current references. |
docs/codestructure.md |
codestructure.md | Historical refactor/setup notes; superseded by current references. |
docs/file_tree.md |
Deleted; retained in Git history | Speculative folder rules/tree, including nonexistent classes; replaced by current architecture reference. |
docs/index.md |
index.md | Replaced duplicate refactor plan with documentation entry point. |
docs/plan.md |
plan.md | Historical refactor/setup notes; superseded by current references. |
docs/task.md |
task.md | Historical refactor/setup notes; superseded by current references. |
docs/migration/README.md |
README.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/godot-architecture-plan.md |
godot-architecture-plan.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/godot-implementation-task-plan.md |
godot-implementation-task-plan.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/system-redesign-analysis.md |
system-redesign-analysis.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/00_project_overview.md |
00_project_overview.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/01_script_inventory.md |
01_script_inventory.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/02_core_game_loop.md |
02_core_game_loop.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/03_game_manager_analysis.md |
03_game_manager_analysis.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/04_ability_system_analysis.md |
04_ability_system_analysis.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/05_upgrade_system_analysis.md |
05_upgrade_system_analysis.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/06_enemy_and_spawn_system_analysis.md |
06_enemy_and_spawn_system_analysis.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/07_player_system_analysis.md |
07_player_system_analysis.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/08_ui_flow_analysis.md |
08_ui_flow_analysis.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/09_save_data_and_progression_analysis.md |
09_save_data_and_progression_analysis.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/10_audio_and_feedback_analysis.md |
10_audio_and_feedback_analysis.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/11_known_risks_and_unknowns.md |
11_known_risks_and_unknowns.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/12_migration_summary.md |
12_migration_summary.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/13_unity_data_asset_mapping.md |
13_unity_data_asset_mapping.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/14_unity_ability_behavior_catalog.md |
14_unity_ability_behavior_catalog.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/15_unity_upgrade_effect_catalog.md |
15_unity_upgrade_effect_catalog.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/16_unity_character_weapon_catalog.md |
16_unity_character_weapon_catalog.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/17_unity_stage_spawn_mapping.md |
17_unity_stage_spawn_mapping.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/18_unity_prefab_and_pool_usage_map.md |
18_unity_prefab_and_pool_usage_map.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/19_unity_event_and_runtime_state_map.md |
19_unity_event_and_runtime_state_map.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
docs/migration/unity-analysis/20_unity_freeze_bug_investigation_notes.md |
20_unity_freeze_bug_investigation_notes.md | Cancelled Godot rewrite; source observations retained as historical evidence. |
TinyChaos_Phase10_Stage1BossData/import_notes.md |
import_notes.md | Cancelled rewrite handoff; archived with its unchanged JSON data. |
TinyChaos_Phase10_Stage1BossData/migration_manifest.md |
migration_manifest.md | Cancelled rewrite handoff; archived with its unchanged JSON data. |
TinyChaos_Phase5_SoldierWeaponData/import_notes.md |
import_notes.md | Cancelled rewrite handoff; archived with its unchanged JSON data. |
TinyChaos_Phase5_SoldierWeaponData/migration_manifest.md |
migration_manifest.md | Cancelled rewrite handoff; archived with its unchanged JSON data. |
TinyChaos_Phase6_FirstStage1EnemyData/import_notes.md |
import_notes.md | Cancelled rewrite handoff; archived with its unchanged JSON data. |
TinyChaos_Phase6_FirstStage1EnemyData/migration_manifest.md |
migration_manifest.md | Cancelled rewrite handoff; archived with its unchanged JSON data. |
TinyChaos_Phase8_XPAndBasicUpgradeData/import_notes.md |
import_notes.md | Cancelled rewrite handoff; archived with its unchanged JSON data. |
TinyChaos_Phase8_XPAndBasicUpgradeData/migration_manifest.md |
migration_manifest.md | Cancelled rewrite handoff; archived with its unchanged JSON data. |
.handoff/TinyChaos_Phase9_SoldierFrenzyData/import_notes.md |
import_notes.md | Cancelled rewrite handoff; archived with its unchanged JSON data. |
.handoff/TinyChaos_Phase9_SoldierFrenzyData/migration_manifest.md |
migration_manifest.md | Cancelled rewrite handoff; archived with its unchanged JSON data. |