Skip to content

feat(catalog): add linear extension to community catalog#2749

Open
ashbrener wants to merge 1 commit into
github:mainfrom
ashbrener:add-linear-to-community-catalog
Open

feat(catalog): add linear extension to community catalog#2749
ashbrener wants to merge 1 commit into
github:mainfrom
ashbrener:add-linear-to-community-catalog

Conversation

@ashbrener
Copy link
Copy Markdown
Contributor

@ashbrener ashbrener commented May 28, 2026

Summary

Adds the linear community extension (spec-kit-linear) to extensions/catalog.community.json for discovery.

Extension repo: https://github.com/ashbrener/spec-kit-linear · Release: v0.2.0

What it does

Mirrors spec-kit feature directories into Linear: one Linear Issue per spec, sub-issues per task phase (checklists + inter-phase blocking relations), auto-synced via six after_* lifecycle hooks. Direction is filesystem → Linear, reconcile-based, unidirectional — never mutates the local filesystem.

Category integration
Effect Read+Write (creates per-repo config under .specify/extensions/linear/)
Commands 5 — speckit.linear.push / .pull / .status / .seed / .install
Hooks 6 — after_specify/clarify/plan/tasks/implement/analyze
License MIT · Requires spec-kit ≥ 0.1.0
Tags issue-tracking, linear, tasks-sync, lifecycle-mirror, memory, cross-repo

Entry fields copied verbatim from the extension's extension.yml manifest. download_url pins to the immutable v0.2.0 release tag.

Install model

catalog.community.json is discovery-only (install_allowed: false in the default stack). Install:

specify extension add linear --from https://github.com/ashbrener/spec-kit-linear/archive/refs/tags/v0.2.0.zip

Test plan

  • Catalog JSON parses; linear inserted between learn and m365
  • download_url resolves (HTTP 200 — /archive/refs/tags/v0.2.0.zip)
  • version (0.2.0) matches extension.yml at the v0.2.0 tag
  • tags use issue-tracking (matching jira / azure-devops)
  • Entry surfaced by specify extension search linear once live

Companion docs-table PR: #2750. Submission issue: #2778.

Copilot AI review requested due to automatic review settings May 28, 2026 21:33
@ashbrener ashbrener requested a review from mnriem as a code owner May 28, 2026 21:33
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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.

Adds a new community extension entry to the catalog for a Linear integration (“Linear Bridge”).

Changes:

  • Added a linear extension record with metadata (links, version, tags, capability counts).
  • Registered compatibility requirements (speckit_version) and provided feature counts (commands, hooks).

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

Comment thread extensions/catalog.community.json Outdated
@mnriem
Copy link
Copy Markdown
Collaborator

mnriem commented May 30, 2026

Going forward for a new/update extension submission please use the extension submissions issue template as that will speed things up

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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: 1

Comment thread extensions/catalog.community.json Outdated
"hooks": 6
},
"tags": [
"issue-tracker",
Copy link
Copy Markdown
Collaborator

@mnriem mnriem left a comment

Choose a reason for hiding this comment

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

Please address Copilot feedback

@ashbrener ashbrener force-pushed the add-linear-to-community-catalog branch from b3f4548 to d745968 Compare May 30, 2026 22:43
Copilot AI review requested due to automatic review settings May 31, 2026 06:00
@ashbrener ashbrener force-pushed the add-linear-to-community-catalog branch from d745968 to 0e1d0e5 Compare May 31, 2026 06:00
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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 2 comments.

Comment on lines 1248 to +1250
},
"linear": {
"name": "spec-kit-linear",
Comment on lines +1280 to 1282
"updated_at": "2026-05-31T05:45:58Z"
},
"m365": {
@ashbrener
Copy link
Copy Markdown
Contributor Author

Thanks for the review — Copilot feedback addressed:

  • download_url is pinned to the immutable release-tag archive (/archive/refs/tags/v0.2.0.zip), matching the advertised version. The earlier note flagged refs/heads/main.zip; that was on a prior revision — the branch had already been switched to the tag.
  • tags: aligned the one-off issue-trackerissue-tracking, consistent with the existing jira and azure-devops entries.

I've also bumped the entry to the latest release (v0.2.0), and filed the submission via the Extension Submission template per your guidance: #2778.

Ready for re-review — happy to adjust anything further.

@ashbrener ashbrener force-pushed the add-linear-to-community-catalog branch from 0e1d0e5 to 74d9ec2 Compare May 31, 2026 06:07
@ashbrener
Copy link
Copy Markdown
Contributor Author

Addressed + refreshed:

  • Rebased onto latest main (both this PR and the docs-table PR docs(community): list spec-kit-linear in community extensions table #2750), so they're current with upstream.
  • The two new comma findings are false positives. The file parses as valid JSON — python -c "import json; json.load(open('extensions/catalog.community.json'))" succeeds (106 entries), and both boundaries already carry the separator: the learn object closes with }, immediately before "linear", and the linear object closes with }, immediately before "m365". The flagged lines are inside the diff hunk; the commas are on the lines just above each "<key>": { and weren't visible in the hunk context.
  • Earlier items remain resolved: download_url pins to the immutable /archive/refs/tags/v0.2.0.zip, and the tag is issue-tracking (matching jira/azure-devops).

Happy to adjust anything further — ready for re-review.

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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants