Skip to content

fix(catalog): companion → README docs, version-pinned download URL, v0.11.0, refreshed tags#2954

Merged
mnriem merged 8 commits into
github:mainfrom
alfredoperez:fix/companion-documentation-readme
Jun 26, 2026
Merged

fix(catalog): companion → README docs, version-pinned download URL, v0.11.0, refreshed tags#2954
mnriem merged 8 commits into
github:mainfrom
alfredoperez:fix/companion-documentation-readme

Conversation

@alfredoperez

@alfredoperez alfredoperez commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Updates the companion (SpecKit Companion) community-catalog entry. This started as a one-line docs fix and grew through review into a full refresh of the entry to the current release. The summary below reflects the final state of the entry.

Changes

  • documentation → now points at the extension README.md (a single fetchable markdown file) instead of a directory URL. The catalog consumer (speckit-community.github.io) renders this field as one markdown file; a directory URL yielded a blank page. companion was the only entry pointing at a directory.
  • download_url → version-pinned to the release asset speckit-ext-v0.11.0/companion-0.11.0.zip (returns 200), so the declared version and the downloaded bits always agree. This matches every other catalog entry (all pin to a tag). The companion-latest rolling tag still exists for our own install scripts, but the catalog is version-pinned, which is the right semantics here.
  • version 0.3.00.11.0 (latest released build).
  • provides.commands 1013 (matches what ships in v0.11.0).
  • requires.speckit_version >=0.8.5>=0.9.5 (bare floor, matching the rest of the catalog). A .dev0 suffix would only affect users running a pre-release of the exact floor version (0.9.5.devN), which never shipped stable and is moot now that Spec Kit is at 0.11.x — newer dev builds already satisfy a bare floor.
  • tags refreshed for discovery. Final set: vscode, progress, status, resume, configurable, extensible.

The catalog entry tracks the latest published release (v0.11.0). Going forward, the release flow bumps this entry automatically on each new release, so it won't drift.

The companion entry's documentation URL pointed at a directory
(speckit-extension/docs/), which the community site can't fetch as
markdown — its extension page renders an empty README (readmeContent:
null). Every other catalog entry points documentation at a specific
README.md (or .md file). Point companion at its extension README so the
page renders.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
Copilot AI review requested due to automatic review settings June 12, 2026 14:23
@alfredoperez alfredoperez requested a review from mnriem as a code owner June 12, 2026 14:23

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates the Speckit Companion entry in the community extensions catalog to point users to the correct documentation page.

Changes:

  • Changed the documentation URL from a docs directory listing to the extension README.md.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread extensions/catalog.community.json
…1, sharper tags

- download_url now points at the rolling companion-latest asset so by-name install always serves the newest build (no per-release catalog PR)
- version 0.3.0 → 0.4.1
- tags: drop redundant 'companion'/'progress'/'lifecycle', add spec-driven-development, spec-kit, turbo, capture
@alfredoperez alfredoperez changed the title fix(catalog): point companion documentation at README.md so its page renders fix(catalog): companion → README docs, stable download URL, v0.4.1, sharper tags Jun 13, 2026
…atus, resume, configurable, extensible)

Tags now name what Companion adds over stock spec-kit, in browse-able terms — dropped catalog-noise (spec-kit, spec-driven-development) and insider jargon (turbo, capture).
Copilot AI review requested due to automatic review settings June 13, 2026 02:14

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread extensions/catalog.community.json Outdated
Pin download_url to the version-matched release asset (every other catalog
entry pins to a tag; the floating companion-latest URL made installs
non-reproducible). Bring the entry up to v0.8.0: version 0.4.1 -> 0.8.0,
commands 10 -> 12, speckit_version floor >=0.9.5.dev0, and drop the removed
"turbo pipeline profile" from the description in favor of the hooks/recipes
customization that shipped.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot's findings

  • Files reviewed: 1/1 changed files
  • Comments generated: 3

Comment thread extensions/catalog.community.json Outdated
Comment thread extensions/catalog.community.json
Comment thread extensions/catalog.community.json
@mnriem

mnriem commented Jun 16, 2026

Copy link
Copy Markdown
Collaborator

Please address Copilot feedback

@alfredoperez alfredoperez changed the title fix(catalog): companion → README docs, stable download URL, v0.4.1, sharper tags fix(catalog): companion → README docs, version-pinned download URL, v0.8.0, refreshed tags Jun 26, 2026
@alfredoperez alfredoperez changed the title fix(catalog): companion → README docs, version-pinned download URL, v0.8.0, refreshed tags fix(catalog): companion → README docs, version-pinned download URL, v0.11.0, refreshed tags Jun 26, 2026
Copilot AI review requested due to automatic review settings June 26, 2026 01:33

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread extensions/catalog.community.json

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread extensions/catalog.community.json
@alfredoperez

Copy link
Copy Markdown
Contributor Author

Pushed a round of fixes addressing the review:

  • Docs linkREADME.md blob (a directory URL rendered blank on the catalog site).
  • download_url → version-pinned speckit-ext-v0.11.0/companion-0.11.0.zip (returns 200), so declared version == downloaded bits, matching every other catalog entry.
  • version0.11.0 (latest published release).
  • provides.commands10 → 13 (matches what ships in v0.11.0).
  • requires.speckit_version → bare >=0.9.5 (dropped the .dev0; under PEP 440 it only affects a pre-release of the exact floor version, which never shipped stable and is moot now that Spec Kit is at 0.11.x).

PR title and description updated to match the final state. Thanks for the careful pass.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated 1 comment.

Comment thread extensions/catalog.community.json Outdated
Copilot AI review requested due to automatic review settings June 26, 2026 01:55

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 1 out of 1 changed files in this pull request and generated no new comments.

@alfredoperez

Copy link
Copy Markdown
Contributor Author

@mnriem it should be good now =) Thank you!

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review details

  • Files reviewed: 1/1 changed files
  • Comments generated: 0 new
  • Review effort level: Low

@mnriem mnriem merged commit 5f9791b into github:main Jun 26, 2026
12 checks passed
@mnriem

mnriem commented Jun 26, 2026

Copy link
Copy Markdown
Collaborator

Thank you!

kanfil added a commit to tikalk/agentic-sdlc-spec-kit that referenced this pull request Jun 29, 2026
Merge github/spec-kit 0.11.8 -> 0.11.9 (15 commits).

Key upstream changes:
- fix(extensions): tell agent to run mandatory hooks (github#2901)
- fix(scripts): keep PowerShell branch-name acronym case-sensitive (github#3129)
- fix(extensions,presets,workflows): resolve GHES private release assets (github#3157)
- fix(catalog): companion docs, version-pinned URL, refreshed tags (github#2954)
- Add community bundle submission path (github#3162)
- Docs: document missing flags --force and --refresh-shared-infra (github#3179)

Fork customizations preserved:
- Phase A/B + Mission Brief in core specify.md
- spec.* command aliases, orange theming
- Bundled extensions/presets, enhanced hook dispatcher
- Bundled-extension preferred update path (install_from_directory)
- Git extension opt-in (aligned with upstream)

Fork bug fixes:
- Relative imports in extensions/ and presets/ __init__.py
- registered.append guard in agents.py
- Bundled update now uses install_from_directory, not catalog download
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.

3 participants