devspec 0.1.0__tar.gz → 0.1.1__tar.gz

devspec-0.1.1/.github/workflows/homebrew-package-publish.yml

@@ -0,0 +1,54 @@
+name: Homebrew Package Publish
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "Release version without the leading v"
+        required: true
+        default: "0.1.1"
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  homebrew-package:
+    name: Generate Homebrew formula artifact
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Generate Homebrew formula
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          version="${GITHUB_REF_NAME#v}"
+          if [[ "${GITHUB_REF_TYPE:-}" != "tag" ]]; then
+            version="${{ github.event.inputs.version }}"
+          fi
+
+          tarball_url="https://github.com/speclabs/devspec/archive/refs/tags/v${version}.tar.gz"
+          sha256="$(curl -fsSL "${tarball_url}" | sha256sum | awk '{print $1}')"
+
+          mkdir -p "dist/homebrew/Formula"
+          cp packaging/homebrew/devspec.rb "dist/homebrew/Formula/devspec.rb"
+          sed -i \
+            -e "s#https://github.com/speclabs/devspec/archive/refs/tags/v[0-9][0-9.]*.tar.gz#${tarball_url}#g" \
+            -e "s#REPLACE_WITH_V[0-9_]*_RELEASE_SHA256#${sha256}#g" \
+            "dist/homebrew/Formula/devspec.rb"
+
+          echo "${sha256}  devspec-v${version}.tar.gz" > "dist/homebrew/devspec-v${version}.tar.gz.sha256"
+          echo "Homebrew formula: dist/homebrew/Formula/devspec.rb"
+          echo "Source tarball SHA256: ${sha256}"
+
+      - name: Upload Homebrew package artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: devspec-homebrew-package
+          path: |
+            dist/homebrew/Formula/devspec.rb
+            dist/homebrew/*.sha256

{devspec-0.1.0 → devspec-0.1.1}/.github/workflows/winget-package-publish.yml

@@ -75,11 +75,12 @@ jobs:
         shell: pwsh
         run: |
           $ErrorActionPreference = "Stop"
+          $version = if ($env:GITHUB_REF_NAME -match "^v(.+)$") { $Matches[1] } else { "0.1.1" }
           $hash = (Get-FileHash dist\winget\devspec.exe -Algorithm SHA256).Hash.ToLowerInvariant()
           "$hash  devspec.exe" | Set-Content -Path dist\winget\devspec.exe.sha256 -Encoding ASCII
 
-          $sourceRoot = "packaging\winget\manifests\s\SpecLabs\Devspec\0.1.0"
-          $manifestRoot = "dist\winget\manifests\s\SpecLabs\Devspec\0.1.0"
+          $sourceRoot = "packaging\winget\manifests\s\SpecLabs\Devspec\$version"
+          $manifestRoot = "dist\winget\manifests\s\SpecLabs\Devspec\$version"
           New-Item -ItemType Directory -Force -Path $manifestRoot | Out-Null
           Copy-Item -Path "$sourceRoot\*.yaml" -Destination $manifestRoot
 

{devspec-0.1.0 → devspec-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devspec
-Version: 0.1.0
+Version: 0.1.1
 Summary: Installer and synchronizer CLI for the devspec workflow framework.
 Author: devspec contributors
 License:                                  Apache License

{devspec-0.1.0 → devspec-0.1.1}/docs/how-to/README.md

@@ -439,7 +439,7 @@ devspec sync --target . --profile all
 `diff` and `sync --dry-run` report version context before the file report:
 
 ```text
-Installed version: 0.1.0
+Installed version: 0.1.1
 Package version: 0.2.0
 Version status: upgrade available
 ```
@@ -511,26 +511,53 @@ Use provider-specific GitHub workflow filenames and display names. The current p
 ```text
 .github/workflows/python-package-ci.yml
 .github/workflows/python-package-publish.yml
+.github/workflows/homebrew-package-publish.yml
 .github/workflows/winget-package-publish.yml
 ```
 
 Future package-provider workflows should follow the same pattern, such as `homebrew-package-publish.yml` or `npm-package-publish.yml`.
 
+For Homebrew releases, publish the source formula through `speclabs/homebrew-tap` first. The tap-ready template files live in:
+
+```text
+packaging/homebrew/tap/Formula/devspec.rb
+packaging/homebrew/tap/README.md
+```
+
+On `v*` tags, `.github/workflows/homebrew-package-publish.yml` generates `dist/homebrew/Formula/devspec.rb` with the tag-specific tarball URL and SHA256. Copy that generated formula to `Formula/devspec.rb` in the tap repository, then validate it from the tap checkout:
+
+```text
+brew audit --new --formula Formula/devspec.rb
+brew install --build-from-source Formula/devspec.rb
+brew test devspec
+devspec version
+devspec init --target "$(mktemp -d)" --profile core --repo-state existing
+```
+
+After pushing the tap, verify the public install path:
+
+```text
+brew install speclabs/tap/devspec
+devspec doctor --target . --profile core
+```
+
+The first Homebrew release is source-only. Add bottles later after macOS and Linux source installs are stable.
+
 For WinGet releases, publish the Windows portable executable from GitHub Releases and submit the generated manifest to `microsoft/winget-pkgs`:
 
 ```text
 dist/winget/devspec.exe
 dist/winget/devspec.exe.sha256
-dist/winget/manifests/s/SpecLabs/Devspec/0.1.0/SpecLabs.Devspec.yaml
-dist/winget/manifests/s/SpecLabs/Devspec/0.1.0/SpecLabs.Devspec.locale.en-US.yaml
-dist/winget/manifests/s/SpecLabs/Devspec/0.1.0/SpecLabs.Devspec.installer.yaml
+dist/winget/manifests/s/SpecLabs/Devspec/0.1.1/SpecLabs.Devspec.yaml
+dist/winget/manifests/s/SpecLabs/Devspec/0.1.1/SpecLabs.Devspec.locale.en-US.yaml
+dist/winget/manifests/s/SpecLabs/Devspec/0.1.1/SpecLabs.Devspec.installer.yaml
 ```
 
 The manifest path is case-sensitive and must match `PackageIdentifier: SpecLabs.Devspec`. Validate the generated manifest directory on Windows before submission:
 
 ```text
-winget validate dist/winget/manifests/s/SpecLabs/Devspec/0.1.0
-winget install --manifest dist/winget/manifests/s/SpecLabs/Devspec/0.1.0
+winget validate dist/winget/manifests/s/SpecLabs/Devspec/0.1.1
+winget install --manifest dist/winget/manifests/s/SpecLabs/Devspec/0.1.1
 ```
 
 When adapter files are added, removed, or moved, update:

{devspec-0.1.0 → devspec-0.1.1}/docs/how-to/setup/homebrew.md

@@ -2,12 +2,12 @@
 
 Use this guide when your macOS or Linux team already uses Homebrew. Homebrew is a developer package manager: it installs command-line tools and can update them later.
 
-The Homebrew package name is a placeholder until the public tap and release are finalized.
+The initial Homebrew package is published through the SpecLabs tap as a source formula. Bottled packages may be added after source installs are stable on macOS and Linux.
 
 ## Before You Start
 
 - Homebrew must be installed. Use the official site: [Install Homebrew](https://brew.sh/).
-- The devspec Homebrew tap or formula must be available.
+- The SpecLabs Homebrew tap must be reachable from your machine.
 - Open your target repository in a terminal.
 
 ## Open A Terminal
@@ -25,9 +25,11 @@ cd /Users/me/code/my-app
 Install the CLI:
 
 ```text
-brew install <tap>/devspec/devspec
+brew install speclabs/tap/devspec
 ```
 
+If your environment cannot use the Homebrew tap yet, use [uv and uvx](uv.md) as the fallback.
+
 Install devspec files into your repository:
 
 ```text
@@ -115,7 +117,7 @@ devspec init --target /Users/me/code/my-app --profile all --repo-state existing
 
 | Argument | Meaning | Beginner explanation |
 | --- | --- | --- |
-| `brew install <tap>/devspec/devspec` | Install the devspec CLI. | The `<tap>` placeholder will become the real Homebrew tap name after release. |
+| `brew install speclabs/tap/devspec` | Install the devspec CLI. | Installs from the public SpecLabs tap. Initial releases build from source. |
 | `brew upgrade devspec` | Update the devspec CLI. | Updates the command-line tool. Run `devspec sync --dry-run` afterward to preview framework file changes. |
 | `version` | Print the devspec CLI version. | Use this to confirm the command runs. It does not change files. |
 | `init` | Install devspec files. | Copies framework files into your repo. |
@@ -133,6 +135,6 @@ devspec init --target /Users/me/code/my-app --profile all --repo-state existing
 | Problem | What to try |
 | --- | --- |
 | `brew` is not found. | Install Homebrew, or use [uv and uvx](uv.md). |
-| The `<tap>` command fails. | The tap name may still be a placeholder. Use `uvx devspec ...` until the tap is published. |
+| `brew install speclabs/tap/devspec` fails. | Confirm the tap is reachable and Homebrew can access GitHub. Use `uvx devspec ...` as the fallback. |
 | `devspec` is not found after install. | Run `brew doctor`, then close and reopen your terminal. |
 | Your team does not use Homebrew. | Use [uv and uvx](uv.md) instead. |

devspec-0.1.1/packaging/homebrew/devspec.rb

@@ -0,0 +1,44 @@
+class Devspec < Formula
+  include Language::Python::Virtualenv
+
+  desc "Installer and synchronizer CLI for the devspec workflow framework"
+  homepage "https://github.com/speclabs/devspec"
+  url "https://github.com/speclabs/devspec/archive/refs/tags/v0.1.1.tar.gz"
+  sha256 "REPLACE_WITH_V0_1_1_RELEASE_SHA256"
+  license "Apache-2.0"
+
+  depends_on "python@3.12"
+
+  resource "hatchling" do
+    url "https://files.pythonhosted.org/packages/63/4c/8717ccb844b4fa5a5ba6352e97d743ed24e9a22cf90b7c109c17030a46a1/hatchling-1.30.1.tar.gz"
+    sha256 "eee4fd45357f72ebb3d7a42e5d72cfb5e29ed426d79e8836288926c4258d5f2e"
+  end
+
+  resource "packaging" do
+    url "https://files.pythonhosted.org/packages/d7/f1/e7a6dd94a8d4a5626c03e4e99c87f241ba9e350cd9e6d75123f992427270/packaging-26.2.tar.gz"
+    sha256 "ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661"
+  end
+
+  resource "pathspec" do
+    url "https://files.pythonhosted.org/packages/5a/82/42f767fc1c1143d6fd36efb827202a2d997a375e160a71eb2888a925aac1/pathspec-1.1.1.tar.gz"
+    sha256 "17db5ecd524104a120e173814c90367a96a98d07c45b2e10c2f3919fff91bf5a"
+  end
+
+  resource "pluggy" do
+    url "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz"
+    sha256 "7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3"
+  end
+
+  resource "trove-classifiers" do
+    url "https://files.pythonhosted.org/packages/c2/e3/7ca82ee24c82d344584abd5b8637b3bd056f2900226e8d82fc22f1184b92/trove_classifiers-2026.6.1.19.tar.gz"
+    sha256 "c5132b4b61a829d11cfbd2d72e97f20a45ed6edb95e45c5efdeb5e00836b2745"
+  end
+
+  def install
+    virtualenv_install_with_resources
+  end
+
+  test do
+    assert_match version.to_s, shell_output("#{bin}/devspec version")
+  end
+end

devspec-0.1.1/packaging/homebrew/tap/Formula/devspec.rb

@@ -0,0 +1,44 @@
+class Devspec < Formula
+  include Language::Python::Virtualenv
+
+  desc "Installer and synchronizer CLI for the devspec workflow framework"
+  homepage "https://github.com/speclabs/devspec"
+  url "https://github.com/speclabs/devspec/archive/refs/tags/v0.1.1.tar.gz"
+  sha256 "REPLACE_WITH_V0_1_1_RELEASE_SHA256"
+  license "Apache-2.0"
+
+  depends_on "python@3.12"
+
+  resource "hatchling" do
+    url "https://files.pythonhosted.org/packages/63/4c/8717ccb844b4fa5a5ba6352e97d743ed24e9a22cf90b7c109c17030a46a1/hatchling-1.30.1.tar.gz"
+    sha256 "eee4fd45357f72ebb3d7a42e5d72cfb5e29ed426d79e8836288926c4258d5f2e"
+  end
+
+  resource "packaging" do
+    url "https://files.pythonhosted.org/packages/d7/f1/e7a6dd94a8d4a5626c03e4e99c87f241ba9e350cd9e6d75123f992427270/packaging-26.2.tar.gz"
+    sha256 "ff452ff5a3e828ce110190feff1178bb1f2ea2281fa2075aadb987c2fb221661"
+  end
+
+  resource "pathspec" do
+    url "https://files.pythonhosted.org/packages/5a/82/42f767fc1c1143d6fd36efb827202a2d997a375e160a71eb2888a925aac1/pathspec-1.1.1.tar.gz"
+    sha256 "17db5ecd524104a120e173814c90367a96a98d07c45b2e10c2f3919fff91bf5a"
+  end
+
+  resource "pluggy" do
+    url "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz"
+    sha256 "7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3"
+  end
+
+  resource "trove-classifiers" do
+    url "https://files.pythonhosted.org/packages/c2/e3/7ca82ee24c82d344584abd5b8637b3bd056f2900226e8d82fc22f1184b92/trove_classifiers-2026.6.1.19.tar.gz"
+    sha256 "c5132b4b61a829d11cfbd2d72e97f20a45ed6edb95e45c5efdeb5e00836b2745"
+  end
+
+  def install
+    virtualenv_install_with_resources
+  end
+
+  test do
+    assert_match version.to_s, shell_output("#{bin}/devspec version")
+  end
+end

devspec-0.1.1/packaging/homebrew/tap/README.md

@@ -0,0 +1,53 @@
+# SpecLabs Homebrew Tap Package
+
+This directory contains the tap-ready files for `speclabs/homebrew-tap`.
+
+Initial deployment is source-only. Bottles should be added after the formula has passed source install validation on macOS and Linux.
+
+## Publish
+
+Create or update the public tap repository:
+
+```text
+brew tap-new speclabs/tap
+```
+
+For release publishing, use the generated formula from the `Homebrew Package Publish` workflow. Copy `dist/homebrew/Formula/devspec.rb` into the tap repository so it lands at:
+
+```text
+Formula/devspec.rb
+```
+
+Commit and push the tap. Users can then install with:
+
+```text
+brew install speclabs/tap/devspec
+```
+
+## Validate
+
+Run these checks from the tap repository:
+
+```text
+brew audit --new --formula Formula/devspec.rb
+brew install --build-from-source Formula/devspec.rb
+brew test devspec
+devspec version
+devspec init --target "$(mktemp -d)" --profile core --repo-state existing
+```
+
+After the public tap is pushed, verify a clean install:
+
+```text
+brew install speclabs/tap/devspec
+devspec doctor --target . --profile core
+```
+
+## Update A Release
+
+For each new `devspec` tag:
+
+1. Update `url` to the new GitHub tag tarball.
+2. Use the `Homebrew Package Publish` workflow artifact to get the tag tarball checksum.
+3. Run `brew update-python-resources --print-only devspec` from the tap when dependencies change.
+4. Re-run the validation checks.

{devspec-0.1.0/packaging/winget/manifests/s/SpecLabs/Devspec/0.1.0 → devspec-0.1.1/packaging/winget/manifests/s/SpecLabs/Devspec/0.1.1}/SpecLabs.Devspec.installer.yaml

@@ -1,12 +1,12 @@
 # yaml-language-server: $schema=https://aka.ms/winget-manifest.installer.1.12.0.schema.json
 PackageIdentifier: SpecLabs.Devspec
-PackageVersion: 0.1.0
+PackageVersion: 0.1.1
 InstallerType: portable
 Commands:
   - devspec
 Installers:
   - Architecture: x64
-    InstallerUrl: https://github.com/speclabs/devspec/releases/download/v0.1.0/devspec.exe
+    InstallerUrl: https://github.com/speclabs/devspec/releases/download/v0.1.1/devspec.exe
     InstallerSha256: REPLACE_WITH_RELEASE_SHA256
 ManifestType: installer
 ManifestVersion: 1.12.0

{devspec-0.1.0/packaging/winget/manifests/s/SpecLabs/Devspec/0.1.0 → devspec-0.1.1/packaging/winget/manifests/s/SpecLabs/Devspec/0.1.1}/SpecLabs.Devspec.locale.en-US.yaml

@@ -1,6 +1,6 @@
 # yaml-language-server: $schema=https://aka.ms/winget-manifest.defaultLocale.1.12.0.schema.json
 PackageIdentifier: SpecLabs.Devspec
-PackageVersion: 0.1.0
+PackageVersion: 0.1.1
 PackageLocale: en-US
 Publisher: SpecLabs
 PublisherUrl: https://github.com/speclabs

{devspec-0.1.0/packaging/winget/manifests/s/SpecLabs/Devspec/0.1.0 → devspec-0.1.1/packaging/winget/manifests/s/SpecLabs/Devspec/0.1.1}/SpecLabs.Devspec.yaml

@@ -1,6 +1,6 @@
 # yaml-language-server: $schema=https://aka.ms/winget-manifest.version.1.12.0.schema.json
 PackageIdentifier: SpecLabs.Devspec
-PackageVersion: 0.1.0
+PackageVersion: 0.1.1
 DefaultLocale: en-US
 ManifestType: version
 ManifestVersion: 1.12.0

{devspec-0.1.0 → devspec-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "devspec"
-version = "0.1.0"
+version = "0.1.1"
 description = "Installer and synchronizer CLI for the devspec workflow framework."
 readme = "README.md"
 requires-python = ">=3.10"

{devspec-0.1.0 → devspec-0.1.1}/src/devspec_installer/__init__.py

@@ -1,3 +1,3 @@
 """Installer CLI for the devspec framework."""
 
-__version__ = "0.1.0"
+__version__ = "0.1.1"

devspec-0.1.0/packaging/homebrew/devspec.rb

@@ -1,19 +0,0 @@
-class Devspec < Formula
-  include Language::Python::Virtualenv
-
-  desc "Installer and synchronizer CLI for the devspec workflow framework"
-  homepage "https://github.com/OWNER/devspec"
-  url "https://github.com/OWNER/devspec/archive/refs/tags/v0.1.0.tar.gz"
-  sha256 "REPLACE_WITH_RELEASE_SHA256"
-  license "Apache-2.0"
-
-  depends_on "python@3.12"
-
-  def install
-    virtualenv_install_with_resources
-  end
-
-  test do
-    assert_match version.to_s, shell_output("#{bin}/devspec version")
-  end
-end