[jefft72]

Summary

Documents native plan mode across the README, usage guide, SDK reference, session format, JSON and TUI docs, and the plan mode extension example.

Replaces #76.

Reasoning

Plan mode shipped with no reference material, so neither users nor SDK consumers had a description of the tool policy, the persistence model, or the continuation contract.
The continuation semantics in particular need documenting, because the token is single-use and the retry behaviour after a failed preflight is not obvious from the API shape.

Task profile routing prose is left to the integration stack, so these docs describe only behaviour that exists on main.

Changes

• Documents plan mode in the README and usage guide, including --plan and /plan
• Documents the plan tool policy, artifact, resolution, and continuation contract in the SDK reference
• Documents plan session entries in the session format reference
• Updates the JSON, TUI, and extensions docs, and the plan mode example README

Testing

• tsgo --noEmit reports zero errors
• biome check . clean
• Verified no em dashes were introduced in Markdown

[Issacboy123]

The SDK documentation usefully presents plan state, lifecycle methods, events, persistence, and tool policy as one public contract. Its export inventory is part of that contract, but it lists three profile-routing helpers that are neither implemented nor exported. Keep the inventory synchronized with the package index. This issue persists through the stack.

[Issacboy123]

These three accepted-plan profile-routing names do not exist in the source tree and are not exported from the package index. Please remove the stale entries or add the intended implementations and public exports.