herdr-orchestra 4.11.1 → 5.0.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes. Versions follow [semantic versioning](https://semver.org).
 
+## [5.0.0] - 2026-11-12
+
+### Fixed
+- **Links go to github.com again.** Some files pointed at mirror domains in place of github.com and api.github.com: the website's GitHub links (header, footer, docs header, "Star on GitHub"), the PR link `orch finish` prints, and the version lookup and source download in `install.sh` (used for `--version`, `--list` and the git-less fallback). All of them use github.com and api.github.com now.
+
+### Changed
+- **Easier to find.** The npm package has a clearer description, more search keywords (agent orchestration, multi-agent, agentic workflow, Claude Code, Codex, OpenCode) and an author. The README opens with one line on what herdr-orchestra is and the `npx herdr-orchestra@latest` command. The website has a canonical URL on every page, full Open Graph and Twitter cards (docs pages included), `robots.txt` pointing at the sitemap, and a SoftwareApplication JSON-LD block on the homepage. Page titles and a few docs titles use the words people search for, such as "Install herdr-orchestra with npx" and "What is herdr-orchestra?".
+
 ## [4.11.1] - 2026-11-12
 
 ### Fixed
@@ -184,7 +192,7 @@ Answers the architecture review: one driver, checked state transitions, nothing
 - **Lead researches; coders own the how.** The planner has a research phase and writes milestones as issues: Goal, Why, Acceptance criteria, Constraints, Interfaces, Context (facts), Out of scope. Reviews report problems only (`BLOCKER: file:line — what — why`). Fix and conflict jobs describe the problem and leave the solution to the coder.
 - **Better dependency planning:** the "could B be built if A never existed?" test, a reason required for every dependency (`Depends on: M1 (what it needs)`), scaffold-first for hotspot files, contract-first for parallel milestones, integration last.
 - `orch sync` warnings: dependency without a reason; shared hotspot files (`package.json`, lockfiles, routes, `App.tsx`, `pubspec.yaml`, `go.mod`, `docker-compose.yml`…) in parallel milestones; code blocks or step-by-step "how" in a milestone; independent milestones in shared mode.
-- Curl install from the GitHub Release: `curl -fsSL https://gh.ali360.cloudns.ch/arunnarangali/herdr-orchestra/releases/latest/download/install.sh | bash`. Each release attaches an `install.sh` that installs that version (`/releases/download/vX.Y.Z/install.sh`).
+- Curl install from the GitHub Release: `curl -fsSL https://github.com/arunnarangali/herdr-orchestra/releases/latest/download/install.sh | bash`. Each release attaches an `install.sh` that installs that version (`/releases/download/vX.Y.Z/install.sh`).
 - Installing from a git checkout at a release tag installs as that version; other commits install as `vX.Y.Z-dev`.
 - Commands: `orch handoff`, `orch needs-fix`, `orch send-job`, `orch review-ok`. `orch ready` lists `FIX` jobs first.
 

package/README.md

@@ -1,8 +1,16 @@
 # herdr-orchestra
 
-[![Website](https://img.shields.io/badge/website-herdr--orchestra.vercel.app-f5a524)](https://herdr-orchestra.vercel.app/)
+**Orchestrate AI coding agents as one team in [Herdr](https://herdr.dev).** A lead agent plans, coders build in parallel, a reviewer checks every diff, and you get one pull request. Works with Claude Code, Codex, OpenCode, Amp, Hermes and Antigravity.
 
-**Website and docs: [herdr-orchestra.vercel.app](https://herdr-orchestra.vercel.app/)**
+```bash
+npx herdr-orchestra@latest
+```
+
+[![npm](https://img.shields.io/npm/v/herdr-orchestra)](https://www.npmjs.com/package/herdr-orchestra) [![Website](https://img.shields.io/badge/website-herdr--orchestra.vercel.app-f5a524)](https://herdr-orchestra.vercel.app/)
+
+**Website and docs: [herdr-orchestra.vercel.app](https://herdr-orchestra.vercel.app/)** · [Install](#install) · [Quick start](https://herdr-orchestra.vercel.app/docs/quick-start/)
+
+## What is herdr-orchestra?
 
 Run a small team of AI coding agents inside [Herdr](https://herdr.dev). An AI **lead** writes the **orchestration plan**, picks the level of model each step needs, hands out the work and then pauses. A **pool of coders** builds it, in parallel git worktrees when tasks are independent, each on a model that fits its task: a small fast one for simple work, a stronger one where reasoning is the hard part. An optional **reviewer** checks every diff. A plain script, the **event manager** (`orch autopilot`), runs the **orchestration run**: it watches the agents, runs checks, merges, and wakes the lead only when something needs a decision. **Any installed agent can play any role**: Claude Code, Codex, Amp, OpenCode, Hermes, Antigravity (`agy`), or anything else that can run shell commands.
 

package/VERSION

@@ -1 +1 @@
-4.11.1
+5.0.0

package/bin/orch

@@ -2283,7 +2283,7 @@ def cmd_cleanup(args):
 
 def github_compare_url(remote, base, branch):
     m = re.match(r"(?:git@github\.com:|https://(?:[^@/]+@)?github\.com/)([^/]+/[^/]+?)(?:\.git)?/?$", remote)
-    return f"https://gh.ali360.cloudns.ch/{m.group(1)}/compare/{base}...{branch}?expand=1" if m else None
+    return f"https://github.com/{m.group(1)}/compare/{base}...{branch}?expand=1" if m else None
 
 
 def cmd_finish(args):

package/install.sh

@@ -61,17 +61,17 @@ norm() { local v="${1#v}"; echo "v$v"; }
 
 list_versions() {
   if command -v git >/dev/null; then
-    git ls-remote --tags --refs "https://gh.ali360.cloudns.ch/$REPO.git" 2>/dev/null \
+    git ls-remote --tags --refs "https://github.com/$REPO.git" 2>/dev/null \
       | sed -E 's#.*refs/tags/##' | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | sort -V
   else
-    curl -fsSL "https://api-github-com.hhj520.top/repos/$REPO/tags?per_page=100" \
+    curl -fsSL "https://api.github.com/repos/$REPO/tags?per_page=100" \
       | grep -oE '"name": *"v[0-9]+\.[0-9]+\.[0-9]+"' | grep -oE 'v[0-9.]+' | sort -V
   fi
 }
 
 latest_version() {
   local v
-  v=$(curl -fsSL "https://api-github-com.hhj520.top/repos/$REPO/releases/latest" 2>/dev/null \
+  v=$(curl -fsSL "https://api.github.com/repos/$REPO/releases/latest" 2>/dev/null \
       | grep -oE '"tag_name": *"[^"]+"' | head -1 | sed -E 's/.*"([^"]+)"$/\1/') || true
   [[ -n "$v" ]] || v=$(list_versions | tail -1)
   [[ -n "$v" ]] || die "could not find any released version of $REPO"
@@ -145,7 +145,7 @@ else
   else
     say "downloading $REPO $VER"
     TMP=$(mktemp -d); trap 'rm -rf "$TMP"' EXIT
-    curl -fsSL "https://gh.ali360.cloudns.ch/$REPO/archive/refs/tags/$VER.tar.gz" -o "$TMP/src.tgz" \
+    curl -fsSL "https://github.com/$REPO/archive/refs/tags/$VER.tar.gz" -o "$TMP/src.tgz" \
       || die "version $VER not found. Run with --list to see available versions."
     tar -xzf "$TMP/src.tgz" -C "$TMP"
     SRC=$(find "$TMP" -mindepth 1 -maxdepth 1 -type d | head -1)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "herdr-orchestra",
-  "version": "4.11.1",
-  "description": "A lead agent plans, coders build, a reviewer checks, all in herdr panes. Install with: npx herdr-orchestra@latest",
+  "version": "5.0.0",
+  "description": "Orchestrate AI coding agents (Claude Code, Codex, OpenCode, Amp) as one team in Herdr: a lead plans, coders build in parallel, a reviewer checks, you get one PR.",
   "license": "MIT",
   "bin": {
     "herdr-orchestra": "npm/cli.js"
@@ -27,11 +27,30 @@
   },
   "homepage": "https://herdr-orchestra.vercel.app/",
   "bugs": "https://github.com/arunnarangali/herdr-orchestra/issues",
-  "keywords": ["herdr", "agents", "orchestration", "claude-code", "codex", "opencode"],
+  "keywords": [
+    "herdr",
+    "herdr-orchestra",
+    "orchestration",
+    "agent-orchestration",
+    "ai-agents",
+    "multi-agent",
+    "agentic-workflow",
+    "agent-workflow",
+    "coding-agents",
+    "ai-coding",
+    "claude-code",
+    "codex",
+    "opencode",
+    "amp",
+    "llm",
+    "cli",
+    "developer-tools"
+  ],
   "engines": {
     "node": ">=16"
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "author": "arunnarangali (https://github.com/arunnarangali)"
 }