Skip to content

Update extension to current spec-kit and glab formats (v1.1.0) - #3

Merged
ohartwig merged 3 commits into
mainfrom
ai/tender-goldberg-fn55f5
Nov 6, 2026
Merged

ohartwig merged 3 commits into
mainfrom
ai/tender-goldberg-fn55f5

Conversation

@ohartwig

@ohartwig ohartwig commented Nov 5, 2026 •

Copy link
Copy Markdown
Owner

Brings the extension in line with spec-kit 1.3.1 and glab 1.128. Several parts of 1.0.0 couldn't work with either one. It also adds a release workflow, so the extension can be installed with a single command.

Breaking issues fixed

  • Registration: command frontmatter used custom script keys (gitlab-helpers.sh: ...) with {SCRIPT:name} placeholders. The current registrar only accepts sh/ps/py and raises "No runnable script variant", and it never replaces {SCRIPT:...}. All commands now use scripts: {sh, ps} → check-prerequisites --json --paths-only and {SCRIPT}, and source the helpers from .specify/extensions/gitlab/scripts/bash/.
  • glab calls that don't exist: issue create --type, issue relation add, issue list --state all, api ... --repo. They are replaced by the supported equivalents: --linked-issues, the issue links API, a paginated issues API call, and glab api --hostname with the URL-encoded project path. The task type is set through PUT issues/:iid issue_type=task.
  • Formats: in spec-kit's tasks.md, [P] marks a parallel task (it isn't a priority), and implement checks tasks off as [X]. Stories in spec.md are ### User Story 1 - Title (Priority: P1). Both are parsed now, the old formats still work, and tasks inherit their story's priority.
  • Mapping file: writing entries under stories: {} produced invalid YAML.
  • Command references: use __SPECKIT_COMMAND_*__ tokens, so they render for both slash-command and skills agents. /speckit.spec doesn't exist and is replaced by the specify command.

Simpler install

  • New release.yml: pushing a vX.Y.Z tag checks the tag against extension.yml, CHANGELOG.md and the README install command, then runs the tests and builds spec-kit-gitlab.zip with extension.yml at the archive root. It publishes a GitHub release with the zip, its SHA-256 and the install command.
  • The README now leads with a single command:
    specify extension add gitlab --from https://github.com/ohartwig/spec-kit-gitlab/releases/download/v1.1.0/spec-kit-gitlab.zip
  • The release URL fits the URL format the spec-kit community catalog accepts for submissions (releases/download/<tag>/<asset>.zip).

Other changes

  • requires.speckit_version: ">=0.12.17", glab >=1.50.0, and jq listed as a required tool. Added repository, homepage, category and effect.
  • New optional after_implement hook that offers to run close-issues, plus a mapping.task_issue_type option (task or issue).
  • Local overrides now apply key by key. The template no longer contains ${...} placeholders, because spec-kit copies it into the project on install and doesn't expand them.
  • Sourcing the helpers no longer turns on set -euo pipefail in the caller's shell. The YAML parsing works with BSD/macOS sed and with bash 3.2.
  • Added --dry-run to close-issues and sync, and --no-update to status.
  • Added offline tests (tests/test-helpers.sh), a CI workflow (tests on Ubuntu and macOS, plus ShellCheck), .extensionignore and CHANGELOG.md.

Testing

  • bash tests/test-helpers.sh: 36 checks pass, under the default locale and LC_ALL=C.
  • A static check of the manifest and commands against the rules in spec-kit's source passes: ID and command patterns, script keys, path rewriting, and that every token resolves to a known command.
  • The version check, release-notes extraction and zip build steps of the release workflow were run locally; the archive layout matches what spec-kit's installer expects.
  • Not tested: installing with the real specify CLI, running against a live GitLab instance, and the gh release create step (it runs only when a tag is pushed).

🤖 Generated with Claude Code

https://claude.ai/code/session_01FU4A2CPkCPyvBLkPvUsoVg

Bring the extension in line with spec-kit 1.3 and glab 1.128:

- Use the standard `scripts: {sh, ps}` frontmatter with `{SCRIPT}`; the
  custom keys and `{SCRIPT:name}` placeholders made registration fail
- Resolve the feature directory with check-prerequisites --paths-only
- Reference commands with __SPECKIT_COMMAND_*__ tokens
- Parse the spec-kit tasks.md ([P] = parallel, [X] = done) and spec.md
  (User Story N - Title (Priority: PN)) formats, keeping legacy formats
- Replace glab calls that don't exist (issue create --type, issue
  relation, issue list --state, api --repo) with supported flags and
  REST API calls, with pagination and --hostname for self-hosted GitLab
- Fix invalid YAML in the mapping file and make local config overrides
  apply per key
- Add an optional after_implement hook, task_issue_type option, offline
  tests, CI, .extensionignore and a CHANGELOG

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FU4A2CPkCPyvBLkPvUsoVg
Pushing a vX.Y.Z tag now builds spec-kit-gitlab.zip (manifest at the
archive root), checks the tag against extension.yml, CHANGELOG.md and
README.md, runs the tests and publishes a GitHub release with the zip,
its SHA-256 and the install command. The README leads with that
single-command install.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FU4A2CPkCPyvBLkPvUsoVg
@ohartwig
ohartwig merged commit 8ec3254 into main Nov 6, 2026
3 checks passed
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.

2 participants