Skip to content

Adopt offline tool revision and opt-in version check across ConfluenceBridge CLIs #2

Open

Description

@SomeSunlight

Goal

Apply the shared, manually invoked source-currency convention to this Python toolbox where meaningful, without changing Confluence page-version/delta-sync behavior.

Work

  • Identify the actual user-facing entrypoint(s) and a canonical tool/release version. Do not confuse Confluence content versions in its manifest with the source code's commit.
  • Provide a fast offline version identity showing installed Git commit/branch/dirty (or PEP 610 if later packaged as a Git-URL tool), and a separate explicit version check [--branch ...] for this repository.
  • Remote verification must compare immutable commits to the original GitHub branch, show up-to-date/behind/ahead/diverged/unknown, and never install/update or touch exports, credentials, browsers, or existing output archives.
  • If this repo intentionally remains a collection of independent scripts instead of a single CLI, document a consistent top-level entrypoint or a narrowly scoped alternative before implementing; avoid a large packaging rewrite merely for this feature.
  • Add tests for offline/network/error behavior.

Reusable contract: https://github.com/SomeSunlight/context-canon/blob/main/nodes/library/development-workflow/docs/version-provenance-python.md, pending implementation/review SomeSunlight/context-canon#132 and SomeSunlight/context-canon#130. Adopt a released/accepted Context Node through normal ContextCanon onboarding/source acceptance if and when the project uses ContextCanon; do not copy generated package state or treat a pending PR as accepted.

Activity

  1. SomeSunlight commented on Nov 10, 2026

    @SomeSunlight
    OwnerAuthor

    Implemented in PR #3 without changing the existing Confluence exporter/PDF scripts. New lightweight python -m confluence_dump / installed confluencebridge CLI provides fully offline --version with exact Git/PEP 610 provenance, plus explicit read-only version check [--branch] against the public ConfluenceBridge source repo. Identical status/0-1-2 exit-code convention to ContextCanon and github-local; no Confluence credentials, workspaces, browser or export side effects. Canonical runtime/package release version is now 3.0.1 rather than stale setup.py 0.0.1; Confluence page and manifest versions are untouched.

    Final exact-head CI green at e74a3332a5b5: Windows and Ubuntu × Python 3.11/3.12, including real uv Git-URL commits and branch installs. Full ContextCanon project onboarding (normative inheritance) is scoped separately to #4. PR stays a Draft for owner test/approval; do not merge automatically.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions