Releases: tstapler/docspan
Releases · tstapler/docspan
v0.1.0 — Initial release
0.1.0 - 2026-06-07
0.1.0 - 2026-06-07
Added
docspan push— push local markdown files to Google Docs or Confluencedocspan pull— pull remote documents into local markdown files with three-way mergedocspan status— show current mapping status in a tabledocspan auth setup— interactive authentication setup forgoogle_docsandconfluencebackendsdocspan conflicts list— list files with unresolved merge conflictsdocspan conflicts resolve— resolve merge conflicts withremote,local, ormergedstrategy- Google Docs backend: push and pull via Google Docs API (service account auth)
- Confluence backend: push and pull via Atlassian REST API (API token auth)
- Three-way merge for bidirectional sync conflict detection
- Confluence comment sidecar: pull writes inline and footer comments to
{file}.comments.md markgate.yamlconfig file format with per-mapping direction control (push/pull/both)- Sync state tracking via
.markgate-state.jsonand content-addressed base store in.markgate-base/
Known Limitations
- Google Docs: comments on edited paragraphs are destroyed on push (paragraph-level diff; comments on unchanged paragraphs are preserved)
- Push: no image support — local image files cannot be pushed to Google Docs or Confluence
- Push: no table support — markdown tables are not rendered in Google Docs
- Confluence: requires an Atlassian API token; no OAuth flow
- Confluence: comment sidecar (
{file}.comments.md) is informational only; comments cannot be pushed back - Config file is named
markgate.yaml(notdocspan.yaml) and state file is.markgate-state.json(not.docspan-state.json). These will be renamed in v0.2.0.