@gh-symphony/cli 0.0.3 → 0.0.5

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/commands/init.d.ts

@@ -43,6 +43,7 @@ type WriteConfigInput = {
     pollIntervalMs?: number;
     concurrency?: number;
     maxAttempts?: number;
+    assignedOnly?: boolean;
 };
 export declare function writeConfig(configDir: string, input: WriteConfigInput): Promise<void>;
 export declare function generateTenantId(projectTitle: string, uniqueKey: string): string;

package/dist/commands/init.js

@@ -469,6 +469,7 @@ export async function writeConfig(configDir, input) {
             bindingId: input.project.id,
             settings: {
                 projectId: input.project.id,
+                ...(input.assignedOnly ? { assignedOnly: true } : {}),
             },
         },
         runtime: {

package/dist/commands/start.js

@@ -151,6 +151,9 @@ const handler = async (args, options) => {
                 return snapshot ?? null;
             },
         },
+        onRefresh: async () => {
+            await service.runOnce({ tenantId });
+        },
     });
     logLine(green("\u25B2"), `Starting orchestrator for tenant: ${bold(tenantId)}`);
     logLine(dim("\u00B7"), dim("Press Ctrl+C to stop"));

package/dist/commands/status-refresh.d.ts

@@ -0,0 +1,8 @@
+type RefreshRequestOptions = {
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+    env?: NodeJS.ProcessEnv;
+};
+export declare function resolveOrchestratorStatusBaseUrl(env?: NodeJS.ProcessEnv): string;
+export declare function requestOrchestratorRefresh(options?: RefreshRequestOptions): Promise<boolean>;
+export {};

package/dist/commands/status-refresh.js

@@ -0,0 +1,21 @@
+export function resolveOrchestratorStatusBaseUrl(env = process.env) {
+    const host = env.ORCHESTRATOR_STATUS_HOST ?? "127.0.0.1";
+    const port = env.ORCHESTRATOR_STATUS_PORT ?? "4680";
+    const urlHost = host.includes(":") && !host.startsWith("[") ? `[${host}]` : host;
+    return `http://${urlHost}:${port}`;
+}
+export async function requestOrchestratorRefresh(options = {}) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const timeoutMs = options.timeoutMs ?? 5_000;
+    const signal = AbortSignal.timeout(timeoutMs);
+    try {
+        const response = await fetchImpl(`${resolveOrchestratorStatusBaseUrl(options.env)}/api/v1/refresh`, {
+            method: "POST",
+            signal,
+        });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/commands/status.js

@@ -4,6 +4,8 @@ import { resolveRuntimeRoot, resolveTenantConfig, syncTenantToRuntime, } from ".
 import { bold, dim, green, red, yellow, cyan, stripAnsi } from "../ansi.js";
 import { clearScreen, showCursor, hideCursor } from "../ansi.js";
 import { renderDashboard } from "../dashboard/renderer.js";
+import { requestOrchestratorRefresh } from "./status-refresh.js";
+const WATCH_REFRESH_TIMEOUT_MS = 1_500;
 function healthIcon(health) {
     switch (health) {
         case "idle":
@@ -166,7 +168,11 @@ const handler = async (args, options) => {
     if (parsed.watch) {
         const isTTY = process.stdout.isTTY === true;
         let terminalWidth = process.stdout.columns ?? 115;
+        let runPromise = null;
         const run = async () => {
+            await requestOrchestratorRefresh({
+                timeoutMs: WATCH_REFRESH_TIMEOUT_MS,
+            });
             const snapshots = await readAllStatusSnapshots(runtimeRoot);
             if (options.json || !isTTY) {
                 process.stdout.write(JSON.stringify(snapshots, null, 2) + "\n");
@@ -180,11 +186,20 @@ const handler = async (args, options) => {
                     "\n");
             }
         };
+        const tick = () => {
+            if (runPromise) {
+                return;
+            }
+            runPromise = run().finally(() => {
+                runPromise = null;
+            });
+        };
         if (isTTY) {
             process.stdout.write(hideCursor());
         }
-        await run();
-        const interval = setInterval(() => void run(), 2000);
+        tick();
+        await runPromise;
+        const interval = setInterval(tick, 2000);
         process.on("SIGWINCH", () => {
             terminalWidth = process.stdout.columns ?? terminalWidth;
         });

package/dist/commands/tenant.js

@@ -17,7 +17,7 @@ function displayScopeError(error, retryCommand) {
     p.note(`gh auth refresh --scopes ${scopeArg}\n\nThen re-run: ${retryCommand}`, "Fix missing scope");
 }
 function parseTenantAddFlags(args) {
-    const flags = { nonInteractive: false };
+    const flags = { nonInteractive: false, assignedOnly: false };
     for (let i = 0; i < args.length; i += 1) {
         const arg = args[i];
         const next = args[i + 1];
@@ -33,6 +33,9 @@ function parseTenantAddFlags(args) {
                 flags.runtime = next;
                 i += 1;
                 break;
+            case "--assigned-only":
+                flags.assignedOnly = true;
+                break;
         }
     }
     return flags;
@@ -143,6 +146,7 @@ async function tenantAddNonInteractive(flags, options) {
         statusField,
         mappings,
         runtime,
+        assignedOnly: flags.assignedOnly,
     });
     if (options.json) {
         process.stdout.write(JSON.stringify({ tenantId, status: "created" }) + "\n");
@@ -228,7 +232,7 @@ async function tenantAddInteractive(options) {
         return;
     }
     const selectedProjectId = await abortIfCancelled(p.select({
-        message: "Step 1/3 — Select a GitHub Project:",
+        message: "Step 1/4 — Select a GitHub Project:",
         options: projects.map((proj) => ({
             value: proj.id,
             label: `${proj.owner.login}/${proj.title}`,
@@ -256,7 +260,7 @@ async function tenantAddInteractive(options) {
         return;
     }
     const selectedRepos = await abortIfCancelled(p.multiselect({
-        message: "Step 2/3 — Select repositories to orchestrate:",
+        message: "Step 2/4 — Select repositories to orchestrate:",
         options: projectDetail.linkedRepositories.map((repo) => ({
             value: repo,
             label: `${repo.owner}/${repo.name}`,
@@ -287,9 +291,14 @@ async function tenantAddInteractive(options) {
     }
     const lifecycleConfig = toWorkflowLifecycleConfig(statusField.name, mappings);
     p.log.info(`Auto-detected workflow: Active=[${lifecycleConfig.activeStates.join(", ")}] Terminal=[${lifecycleConfig.terminalStates.join(", ")}]`);
-    // ── Step 4: Runtime selection ────────────────────────────────────────────────
+    // ── Step 4: Assignment filter ────────────────────────────────────────────────
+    const assignedOnly = await abortIfCancelled(p.confirm({
+        message: `Step 3/4 — Only process issues assigned to the authenticated GitHub user?`,
+        initialValue: false,
+    }));
+    // ── Step 5: Runtime selection ────────────────────────────────────────────────
     const runtime = await abortIfCancelled(p.select({
-        message: "Step 3/3 — Select AI runtime:",
+        message: "Step 4/4 — Select AI runtime:",
         options: [
             { value: "codex", label: "OpenAI Codex", hint: "recommended" },
             { value: "claude-code", label: "Claude Code" },
@@ -308,6 +317,7 @@ async function tenantAddInteractive(options) {
         `User:       ${login}`,
         `Project:    ${projectDetail.title}`,
         `Repos:      ${selectedRepos.map((r) => `${r.owner}/${r.name}`).join(", ")}`,
+        `Assigned:   ${assignedOnly ? `Only issues assigned to ${login}` : "All project issues"}`,
         `Runtime:    ${runtime}`,
         `Active:     ${lifecycleConfig.activeStates.join(", ")}`,
         `Terminal:   ${lifecycleConfig.terminalStates.join(", ")}`,
@@ -335,6 +345,7 @@ async function tenantAddInteractive(options) {
             mappings,
             runtime,
             agentCommand,
+            assignedOnly,
         });
         s6.stop("Configuration saved.");
     }

package/dist/config.d.ts

@@ -7,7 +7,14 @@ export type CliGlobalConfig = {
     activeTenant: string | null;
     tenants: string[];
 };
-export type CliTenantConfig = OrchestratorTenantConfig & {
+export type CliTenantTrackerSettings = Record<string, string | boolean> & {
+    projectId?: string;
+    assignedOnly?: boolean;
+};
+export type CliTenantConfig = Omit<OrchestratorTenantConfig, "tracker"> & {
+    tracker: Omit<OrchestratorTenantConfig["tracker"], "settings"> & {
+        settings?: CliTenantTrackerSettings;
+    };
     workflowMapping?: WorkflowStateConfig;
 };
 export type StateRole = "active" | "wait" | "terminal";

package/dist/dashboard/renderer.js

@@ -1,7 +1,7 @@
 // ── Dashboard Renderer (Elixir-parity) ──────────────────────────────────────
 import { bold, dim, green, red, yellow, cyan, magenta, blue, stripAnsi, } from "../ansi.js";
 // ── Column widths (from Elixir spec) ─────────────────────────────────────────
-const COL_ID = 8;
+const COL_ID = 24;
 const COL_STAGE = 14;
 const COL_PID = 8;
 const COL_AGE_TURN = 12;
@@ -152,7 +152,7 @@ function tableHeaderRow(c) {
 function activeRunRow(run, now, evtWidth, c) {
     const dot = statusDot(run, c);
     const id = pad(run.issueIdentifier, COL_ID);
-    const stage = pad(run.issueState, COL_STAGE);
+    const stage = pad(run.issueState || "\u2014", COL_STAGE);
     const pid = pad(run.processId != null ? String(run.processId) : "\u2014", COL_PID);
     const age = fmtAge(run.startedAt, now);
     const turn = run.turnCount ?? 0;

package/dist/github/gh-auth.js

@@ -31,7 +31,7 @@ export function checkGhAuthenticated(opts) {
     if ((result.status ?? 1) !== 0) {
         return { authenticated: false };
     }
-    const login = parseLogin((result.stderr ?? "").toString());
+    const login = parseLogin((result.stdout ?? "").toString());
     return { authenticated: true, login };
 }
 export function checkGhScopes(opts) {
@@ -40,7 +40,7 @@ export function checkGhScopes(opts) {
         encoding: "utf8",
         stdio: ["pipe", "pipe", "pipe"],
     });
-    const output = (result.stderr ?? "").toString();
+    const output = (result.stdout ?? "").toString();
     const scopes = parseScopes(output);
     if (scopes.length === 0) {
         return { valid: true, missing: [], scopes: [] };

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.5",
   "license": "MIT",
   "author": "hojinzs",
   "description": "Interactive CLI for GitHub Symphony orchestration",
@@ -36,10 +36,10 @@
   },
   "dependencies": {
     "@clack/prompts": "^0.9.1",
-    "@gh-symphony/core": "0.0.3",
-    "@gh-symphony/orchestrator": "0.0.3",
-    "@gh-symphony/tracker-github": "0.0.3",
-    "@gh-symphony/worker": "0.0.3"
+    "@gh-symphony/core": "0.0.5",
+    "@gh-symphony/orchestrator": "0.0.5",
+    "@gh-symphony/tracker-github": "0.0.5",
+    "@gh-symphony/worker": "0.0.5"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",