Skip to content

release: withhold codegraph ui until the viewer launches; hold its changelog entries - #2089

Merged
colbymchenry merged 3 commits into
mainfrom
release/withhold-viewer
Sep 29, 2026
Merged

colbymchenry merged 3 commits into
mainfrom
release/withhold-viewer

Conversation

@colbymchenry

Copy link
Copy Markdown
Owner

Prepares a fixes release that ships everything in [Unreleased] except the browser viewer. So far the viewer has been exercised on Expo apps, not on API, Laravel, Spring, Angular or Swift projects. It launches separately, with its own announcement.

Three commits, each revertible on its own at launch:

  1. feat(cli): codegraph ui / web refused unless CODEGRAPH_UI=1.
    • A dependency-free check in src/bin/viewer-gate.ts runs before any startup work. It catches ui, web, help ui, ui --help and a leading --color / --no-color, prints 'codegraph ui' is not in this release yet, and exits 1.
    • The command is hidden from --help unless opted in.
    • The viewer assets still ship, so the opt-in works on a released build for the people testing it.
    • viewer-gate.test.ts covers every spelling and the --help listing both ways. The existing cli-ui-command tests run with the opt-in.
  2. docs(site): a "Not released yet" note on the viewer guide, the CLI reference and the next-steps link.
  3. docs(changelog): the viewer's entries move to docs/viewer-launch-changelog.md.
    • 53 moved, verbatim, along with the launch Highlights.
    • 12 reworded around the graph and codegraph_explore, because their engine half ships now. They cover the Expo / Next.js / React Router / TanStack / Vue / Nuxt / SvelteKit navigates edges, the cross-tier hops (a page's fetch → its route, queue → consumer, socket → gateway), explore's when conditions on each Flow hop, SvelteKit layouts, and wrapped Express handlers. Their original wording is kept in the holding file.
    • A few kept entries lose a viewer clause.
    • New Highlights for this release, with the re-index note.
    • Verified with a script: every original entry is in one of the two files, the released sections are byte-identical, and prepare-release.mjs plus extract-release-notes.mjs produce notes with no mention of codegraph ui.

AGENTS.md records the gate, the holding file and the launch steps.

Full suite: 321 files, 5,489 passed, 0 failed.

🤖 Generated with Claude Code

colbymchenry and others added 3 commits September 28, 2026 23:47
…PH_UI=1 opts in)

The viewer has been exercised on Expo apps only, not on API, Laravel,
Spring, Angular or Swift projects, so it stays out of this release. `ui` and
its alias `web` — also as `help ui` or `ui --help` — are refused before any
startup work, and the command is hidden from `--help`, unless CODEGRAPH_UI=1
is set, which keeps it usable for the people testing it. The viewer assets
still ship, so the opt-in works on a released build.

Reverting this commit is the launch.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The viewer pages have been live on the docs site since they landed, and
1.6.0 answers `codegraph ui` with "unknown command" (#1816, #1900). Until the
viewer launches, the guide, the CLI reference and the next-steps link say so.

Reverting this commit is part of the launch.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…ghts for the fixes release

53 entries that describe `codegraph ui` and its screens move, verbatim, to
docs/viewer-launch-changelog.md along with the launch Highlights. 12 entries
whose graph and `codegraph_explore` half ships now (the router navigation
edges, the cross-tier hops, explore's `when` conditions, SvelteKit layouts,
wrapped Express handlers, …) are reworded around the graph; their original
wording is kept in the holding file for the launch. A few kept entries lose a
viewer clause. The Highlights are rewritten for this release.

prepare-release.mjs promotes the section and extract-release-notes.mjs reads
it back with no mention of the viewer; the released sections are untouched.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@colbymchenry
colbymchenry merged commit 2c4d4eb into main Sep 29, 2026
@colbymchenry
colbymchenry deleted the release/withhold-viewer branch September 29, 2026 05:01
@colbymchenry colbymchenry mentioned this pull request Sep 29, 2026
danusha2345 pushed a commit to danusha2345/codegraph that referenced this pull request Sep 29, 2026
Resolve conflicts:
- CHANGELOG.md: take main; the saved-trail entries move to
  docs/viewer-launch-changelog.md with the other held viewer entries (colbymchenry#2089).
- __tests__/git-index-currency.test.ts: keep the Vitest 4 injection helpers,
  with colbymchenry#2082's note on why openSync is injected too.
- package-lock.json: keep the Vitest 4 dependency set, regenerated for 1.6.1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant