agentxchain 2.17.0 → 2.19.0

package/README.md

@@ -17,6 +17,16 @@ Legacy IDE-window coordination is still shipped as a compatibility mode for team
 - [Build your own runner](https://agentxchain.dev/docs/build-your-own-runner/)
 - [Why governed multi-agent delivery matters](https://agentxchain.dev/why/)
 
+## Try It Now
+
+See governance before you scaffold a real repo:
+
+```bash
+npx agentxchain demo
+```
+
+Requires Node.js 18.17+ or 20.5+ and `git`. The demo creates a temporary governed repo, runs a full PM -> Dev -> QA lifecycle through the real runner interface, shows gates/decisions/objections, and removes the temp workspace when finished. No API keys, config edits, or manual turn authoring required.
+
 ## Install
 
 ```bash
@@ -59,7 +69,7 @@ agentxchain status
 agentxchain step --role pm
 ```
 
-The default governed dev runtime is `claude --print` with stdin prompt delivery. If your local coding agent uses a different launch contract, set it during scaffold creation:
+The default governed dev runtime is `claude --print --dangerously-skip-permissions` with stdin prompt delivery. The non-interactive governed path needs write access, so do not pretend bare `claude --print` is sufficient for unattended implementation turns. If your local coding agent uses a different launch contract, set it during scaffold creation:
 
 ```bash
 npx agentxchain init --governed --dir my-agentxchain-project --dev-command ./scripts/dev-agent.sh --dev-prompt-transport dispatch_bundle_only -y
@@ -119,6 +129,7 @@ agentxchain step
 
 | Command | What it does |
 |---|---|
+| `demo` | Run a temporary PM -> Dev -> QA governed lifecycle demo with real gates, decisions, and objections |
 | `init --governed [--dir <path>] [--template <id>]` | Create a governed project, optionally in-place or in an explicit target directory, with project-shape-specific planning artifacts |
 | `migrate` | Convert a legacy v3 project to governed format |
 | `status` | Show current run, template, phase, turn, and approval state |

package/bin/agentxchain.js

@@ -101,6 +101,7 @@ import { intakeHandoffCommand } from '../src/commands/intake-handoff.js';
 import { intakeScanCommand } from '../src/commands/intake-scan.js';
 import { intakeResolveCommand } from '../src/commands/intake-resolve.js';
 import { intakeStatusCommand } from '../src/commands/intake-status.js';
+import { demoCommand } from '../src/commands/demo.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
@@ -233,6 +234,13 @@ program
   .description('Check local environment and first-run readiness')
   .action(doctorCommand);
 
+program
+  .command('demo')
+  .description('Run a complete governed lifecycle demo (no API keys required)')
+  .option('-j, --json', 'Output as JSON')
+  .option('-v, --verbose', 'Show stack traces on failure')
+  .action(demoCommand);
+
 program
   .command('validate')
   .description('Validate project protocol artifacts')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentxchain",
-  "version": "2.17.0",
+  "version": "2.19.0",
   "description": "CLI for AgentXchain — governed multi-agent software delivery",
   "type": "module",
   "bin": {

package/scripts/release-downstream-truth.sh

@@ -48,6 +48,8 @@ fi
 
 PACKAGE_NAME="$(node -e "console.log(JSON.parse(require('fs').readFileSync('package.json', 'utf8')).name)")"
 CANONICAL_HOMEBREW_FORMULA_URL="${AGENTXCHAIN_DOWNSTREAM_FORMULA_URL:-https://raw.githubusercontent.com/shivamtiwari93/homebrew-tap/main/Formula/agentxchain.rb}"
+CANONICAL_HOMEBREW_FORMULA_REPO="${AGENTXCHAIN_DOWNSTREAM_FORMULA_REPO:-https://github.com/shivamtiwari93/homebrew-tap.git}"
+CANONICAL_HOMEBREW_FORMULA_PATH="${AGENTXCHAIN_DOWNSTREAM_FORMULA_PATH:-Formula/agentxchain.rb}"
 
 PASS=0
 FAIL=0
@@ -55,6 +57,30 @@ FAIL=0
 pass() { PASS=$((PASS + 1)); echo "  PASS: $1"; }
 fail() { FAIL=$((FAIL + 1)); echo "  FAIL: $1"; }
 
+fetch_formula_content() {
+  local content=""
+  if [[ -n "${AGENTXCHAIN_DOWNSTREAM_FORMULA_URL:-}" ]]; then
+    content="$(curl -fsSL "$CANONICAL_HOMEBREW_FORMULA_URL" 2>/dev/null || true)"
+    printf '%s' "$content"
+    return 0
+  fi
+
+  if ! command -v git >/dev/null 2>&1; then
+    printf ''
+    return 0
+  fi
+
+  local tmpdir
+  tmpdir="$(mktemp -d)"
+  if git clone --depth 1 "$CANONICAL_HOMEBREW_FORMULA_REPO" "$tmpdir" >/dev/null 2>&1; then
+    if [[ -f "$tmpdir/$CANONICAL_HOMEBREW_FORMULA_PATH" ]]; then
+      content="$(cat "$tmpdir/$CANONICAL_HOMEBREW_FORMULA_PATH")"
+    fi
+  fi
+  rm -rf "$tmpdir"
+  printf '%s' "$content"
+}
+
 echo "AgentXchain v${TARGET_VERSION} Downstream Release Truth"
 echo "====================================="
 echo "Checks downstream surfaces after publish: GitHub release, canonical Homebrew tap."
@@ -87,11 +113,11 @@ fi
 # --- Get registry tarball URL and compute SHA ---
 echo "[2/3] Canonical Homebrew tap SHA matches registry tarball"
 REGISTRY_TARBALL_URL="$(npm view "${PACKAGE_NAME}@${TARGET_VERSION}" dist.tarball 2>/dev/null || true)"
-FORMULA_CONTENT="$(curl -fsSL "$CANONICAL_HOMEBREW_FORMULA_URL" 2>/dev/null || true)"
+FORMULA_CONTENT="$(fetch_formula_content)"
 if [[ -z "$REGISTRY_TARBALL_URL" ]]; then
   fail "cannot fetch registry tarball URL for ${PACKAGE_NAME}@${TARGET_VERSION}"
 elif [[ -z "$FORMULA_CONTENT" ]]; then
-  fail "cannot fetch canonical Homebrew formula from ${CANONICAL_HOMEBREW_FORMULA_URL}"
+  fail "cannot fetch canonical Homebrew formula from ${CANONICAL_HOMEBREW_FORMULA_REPO}"
 else
   REGISTRY_SHA="$(curl -sL "$REGISTRY_TARBALL_URL" | shasum -a 256 | awk '{print $1}')"
   if [[ -z "$REGISTRY_SHA" ]]; then