@gh-symphony/cli 0.0.3 → 0.0.4

package/README.md

@@ -0,0 +1,142 @@
+# @gh-symphony/cli
+
+Interactive CLI for GitHub Symphony — a multi-tenant AI coding agent orchestration platform.
+
+## Requirements
+
+The following tools must be installed before using the CLI:
+
+- **[Node.js](https://nodejs.org/)** (v24+) with npm
+- **[Git](https://git-scm.com/)**
+- **[GitHub CLI (`gh`)](https://cli.github.com/)** — authenticated with required scopes:
+  ```bash
+  gh auth login --scopes repo,read:org,project
+  ```
+
+## 1. Install Package
+
+```bash
+npm install -g @gh-symphony/cli
+```
+
+Verify the installation:
+
+```bash
+gh-symphony --version
+```
+
+## 2. Set Repository
+
+Navigate to the repository you want to orchestrate, then run:
+
+```bash
+gh-symphony init
+```
+
+The interactive wizard will:
+
+1. Authenticate via `gh` CLI
+2. Let you select a **GitHub Project** to bind
+3. Map project status columns to workflow phases (active / wait / terminal)
+4. Generate `WORKFLOW.md` and supporting files in the repository
+
+### Customizing Agent Behavior
+
+`gh-symphony init` generates skill files under `.codex/skills/` (or `.claude/skills/` for Claude Code). These skills define how the AI agent handles commits, pushes, pulls, and project status transitions.
+
+You can further customize the agent's behavior by editing `WORKFLOW.md` — this is the policy layer that controls what the agent does at each workflow phase.
+
+> Currently supported runtimes: **Codex**, **Claude Code**
+
+## 3. Set Orchestrator Runner (Tenant)
+
+On the machine where you want the orchestrator to run, register a tenant:
+
+```bash
+gh-symphony tenant add
+```
+
+The interactive wizard will:
+
+1. Authenticate via `gh` CLI
+2. Let you select a **GitHub Project**
+3. Select repositories to orchestrate
+4. Auto-detect workflow column mappings
+5. Choose an AI runtime (Codex / Claude Code / custom)
+6. Write tenant configuration to `~/.gh-symphony/`
+
+### Tenant Management
+
+```bash
+gh-symphony tenant list             # List all configured tenants
+gh-symphony tenant remove <id>      # Remove a tenant
+```
+
+## 4. Run the Orchestrator
+
+### Foreground
+
+```bash
+gh-symphony start
+```
+
+### Background (daemon)
+
+```bash
+gh-symphony start --daemon          # Start in background
+gh-symphony stop                    # Stop the daemon
+```
+
+### Monitor
+
+```bash
+gh-symphony status                  # Show current status
+gh-symphony status --watch          # Live dashboard
+gh-symphony logs                    # View event logs
+gh-symphony logs --follow           # Stream logs in real-time
+```
+
+### Dispatch a Single Issue
+
+```bash
+gh-symphony run org/repo#123
+```
+
+### Recover Stalled Runs
+
+```bash
+gh-symphony recover                 # Recover stalled runs
+gh-symphony recover --dry-run       # Preview what would be recovered
+```
+
+## Command Reference
+
+```
+Setup:
+  init                Interactive repository setup wizard
+  config show         Show current configuration
+  config set          Set a configuration value
+  config edit         Open config in $EDITOR
+
+Orchestration:
+  start               Start the orchestrator (foreground)
+  start --daemon      Start the orchestrator (background)
+  stop                Stop the background orchestrator
+  status              Show orchestrator status
+  run <issue>         Dispatch a single issue
+  recover             Recover stalled runs
+  logs                View orchestrator logs
+
+Tenant Management:
+  tenant add          Add a new tenant (interactive wizard)
+  tenant list         List all configured tenants
+  tenant remove       Remove a tenant
+
+Global Options:
+  --config <dir>      Config directory (default: ~/.gh-symphony)
+  --verbose           Enable verbose output
+  --json              Output in JSON format
+  --no-color          Disable color output
+  --help, -h          Show help
+  --version, -V       Show version
+```

package/dist/index.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { realpathSync } from "node:fs";
 import { pathToFileURL } from "node:url";
 import { resolveConfigDir } from "./config.js";
 export function parseGlobalOptions(argv) {
@@ -81,7 +82,7 @@ async function main() {
     await runCli(process.argv.slice(2));
 }
 if (process.argv[1] &&
-    import.meta.url === pathToFileURL(process.argv[1]).href) {
+    import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
     main().catch((error) => {
         process.stderr.write(`${error instanceof Error ? error.message : "Unknown error"}\n`);
         process.exitCode = 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gh-symphony/cli",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "license": "MIT",
   "author": "hojinzs",
   "description": "Interactive CLI for GitHub Symphony orchestration",