Decodie — Overview Mode

Generate a high-level overview of a file, directory, or project — answering "what is this and how is it organized" rather than line-by-line explanations. Produces a single summary entry per target, intended as an onboarding starting point.

This mode persists by default — overviews are saved as learning entries. Re-running on the same target overwrites the existing overview rather than accumulating versions.

This mode is read-only with respect to source code. You only read source files and write to the .decodie/ directory.

Activation and Argument Parsing

1. Extract the target path. If none provided, use the project root.
2. Validate the target. Confirm it exists and is a file or directory.
3. Determine target scope:
   • File — entry_points and dependencies may be omitted.
   • Directory — entry_points and dependencies are usually meaningful.
   • Project root — all four overview fields apply.
4. Canonicalize the target path for regeneration lookup:
   • File: relative path (e.g., src/utils/helpers.ts)
   • Directory or project root: relative path with trailing slash (e.g., src/auth/, ./)