feat: enable independent Rook and Huginn releases with Release Please (#333)

Author: yacosta738

.github/workflows/ci.yml

@@ -192,6 +192,7 @@ jobs:
   test:
     name: Test (Rust)
     runs-on: ubuntu-latest
+    timeout-minutes: 45
     needs: [changes, build-dashboard, fmt, clippy]
     if: needs.changes.outputs.backend == 'true' || needs.changes.outputs.github == 'true'
     steps:

.github/workflows/release.yml

@@ -1,3 +1,4 @@
 {
-  "apps/rook": "0.0.1"
+  "apps/rook": "0.0.1",
+  "apps/huginn": "0.1.0"
 }

.release-please-manifest.json

@@ -73,11 +73,30 @@ cd cortex
 cargo build --release -p rook
 ```
 
+#### Rust installation from a product tag
+
+Rook GA supports installing directly from its immutable product tag. Publishing
+the internal crates to crates.io is a later distribution phase and is not a
+first-release requirement:
+
+```bash
+cargo install \
+  --git https://github.com/dallay/cortex.git \
+  --tag rook@vX.Y.Z \
+  --locked \
+  -p rook
+```
+
 #### Binary releases
 Download pre-built binaries from [Releases](https://github.com/dallay/cortex/releases) for:
-- Linux (x86_64, aarch64)
+- Linux (x86_64)
 - macOS (Intel, Apple Silicon)
-- Windows (x86_64, aarch64)
+- Windows (x86_64)
+
+Rook and Huginn are separate products with separate versions and release tags.
+See the [release and distribution contract](docs/releasing.md) before relying
+on a registry or container channel. Huginn's public distribution remains
+blocked until its acceptance gates are complete.
 
 ### Quick Start
 
@@ -238,6 +257,8 @@ just test-e2e
 - [Providers](docs/providers.md)
 - [API Reference](docs/api.md)
 - [Deployment](docs/deployment.md)
+- [Release and distribution contract](docs/releasing.md)
+- [ADR-0014: Product releases versus Cargo publishing](docs/adr/0014-separate-product-releases-from-cargo-publishing.md)
 - [API key troubleshooting](docs/api-key-troubleshooting.md)
 - [Rook dashboard](apps/rook/dashboard/README.md) (Vue SPA, embedded at `/dashboard/`)
 - [Local Docker testing](dev/README.md) (smoke, Playwright E2E, multi-distro)

README.md

@@ -0,0 +1,10 @@
+# Changelog
+
+All notable Rook releases are documented in this file.
+
+The file is maintained by Release Please. Rook releases use the independent
+`rook@vX.Y.Z` tag and never imply a repository-wide Cortex version.
+
+## [0.0.1] - Unreleased
+
+- Initial product-scoped release metadata.

apps/rook/CHANGELOG.md

@@ -0,0 +1,11 @@
+{
+  "name": "@dallay/rook-darwin-arm64",
+  "version": "0.0.1",
+  "description": "Rook native binary for macOS Apple Silicon.",
+  "license": "MIT",
+  "os": ["darwin"],
+  "cpu": ["arm64"],
+  "files": ["bin"],
+  "publishConfig": { "access": "public" },
+  "repository": "dallay/cortex"
+}

apps/rook/npm/rook-darwin-arm64/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@dallay/rook-darwin-x64",
+  "version": "0.0.1",
+  "description": "Rook native binary for macOS Intel.",
+  "license": "MIT",
+  "os": ["darwin"],
+  "cpu": ["x64"],
+  "files": ["bin"],
+  "publishConfig": { "access": "public" },
+  "repository": "dallay/cortex"
+}

apps/rook/npm/rook-darwin-x64/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@dallay/rook-linux-x64",
+  "version": "0.0.1",
+  "description": "Rook native binary for Linux x64.",
+  "license": "MIT",
+  "os": ["linux"],
+  "cpu": ["x64"],
+  "files": ["bin"],
+  "publishConfig": { "access": "public" },
+  "repository": "dallay/cortex"
+}

apps/rook/npm/rook-linux-x64/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "@dallay/rook-windows-x64",
+  "version": "0.0.1",
+  "description": "Rook native binary for Windows x64.",
+  "license": "MIT",
+  "os": ["win32"],
+  "cpu": ["x64"],
+  "files": ["bin"],
+  "publishConfig": { "access": "public" },
+  "repository": "dallay/cortex"
+}

apps/rook/npm/rook-windows-x64/package.json

@@ -1,5 +1,6 @@
 {
   "name": "@dallay/rook",
+  "version": "0.0.1",
   "description": "AI proxy/router that routes LLM requests to multiple providers (OpenAI, Anthropic, Ollama, Gemini, Groq) with fallback, caching, and audit logging.",
   "author": "Yuniel Acosta <info@yunielacosta.com>",
   "license": "MIT",
@@ -36,23 +37,14 @@
     "lib"
   ],
   "scripts": {
-    "test": "pnpm run typecheck",
-    "typecheck": "tsc --noEmit",
-    "build": "tsc",
-    "clean": "node -e \"require('fs').rmSync('lib', {recursive: true, force: true})\"",
-    "prepublishOnly": "npm run build"
-  },
-  "devDependencies": {
-    "@types/node": "22.20.5",
-    "typescript": "6.0.3"
+    "test": "node --check lib/index.js",
+    "prepublishOnly": "node --check lib/index.js"
   },
   "optionalDependencies": {
-    "`@dallay/rook-darwin-arm64`": "0.0.1",
-    "`@dallay/rook-darwin-x64`": "0.0.1",
-    "`@dallay/rook-linux-arm64`": "0.0.1",
-    "`@dallay/rook-linux-x64`": "0.0.1",
-    "`@dallay/rook-windows-arm64`": "0.0.1",
-    "`@dallay/rook-windows-x64`": "0.0.1"
+    "@dallay/rook-darwin-arm64": "0.0.1",
+    "@dallay/rook-darwin-x64": "0.0.1",
+    "@dallay/rook-linux-x64": "0.0.1",
+    "@dallay/rook-windows-x64": "0.0.1"
   },
   "engines": {
     "node": ">=18"