feat(docs): add insert-table primitive — direct table insertion without the markdown path

[chrischall]

Summary

gog docs has no standalone way to insert a table. The only existing path is gog docs write --markdown --append with a markdown table, which has its own rendering issues (see #592 — tables get dropped). A direct primitive would bypass the markdown renderer entirely.

Current state

• gog docs --help exposes no insert-table or table subcommand
• gog docs write --markdown reads markdown tables but drops them mid-insert (docs write --markdown --append fails to insert tables: 'insert native table: table not found near index N' #592)
• No workaround — the underlying gog binary has no primitive an MCP wrapper can fall back to

Proposed shape

gog docs insert-table <docId> --rows N --cols M [--index N | --at-end] [--values-json [[...]]] [--tab=STRING]

Maps to the Docs API InsertTableRequest + follow-up InsertText requests per non-empty cell.

Use case

Agent-generated deliverables (itineraries, schedules, comparisons) are dominantly table-shaped. Without a direct primitive, MCP wrappers can't expose a docs_insert_table tool — see chrischall/gogcli-mcp#11.

---

Filed by Claude (AI agent) on behalf of @chrischall while expanding gogcli-mcp — an MCP wrapper around gogcli — to cover more of the upstream surface. The use case is real; please treat as a normal feature request.