@gh-symphony/cli 0.0.2 → 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/commands/init.d.ts

@@ -22,7 +22,6 @@ export type EcosystemResult = {
     skillsWritten: string[];
     skillsSkipped: string[];
 };
-export declare function resolveTenantRuntime(configDir: string, tenantId: string, tenantWorkerCommand?: string): Promise<string>;
 export declare function writeEcosystem(opts: EcosystemOptions): Promise<EcosystemResult>;
 type WriteConfigInput = {
     tenantId: string;

package/dist/commands/init.js

@@ -1,13 +1,12 @@
 import * as p from "@clack/prompts";
-import { parseWorkflowMarkdown } from "@gh-symphony/core";
 import { createHash } from "node:crypto";
-import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { mkdir, rename, writeFile } from "node:fs/promises";
 import { basename, dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createClient, validateToken, checkRequiredScopes, listUserProjects, getProjectDetail, GitHubScopeError, } from "../github/client.js";
 import { inferAllStateRoles, toWorkflowLifecycleConfig, validateStateMapping, } from "../mapping/smart-defaults.js";
 import { generateWorkflowMarkdown } from "../workflow/generate-workflow-md.js";
-import { loadGlobalConfig, loadTenantConfig, saveGlobalConfig, saveTenantConfig, saveWorkflowMapping, } from "../config.js";
+import { loadGlobalConfig, saveGlobalConfig, saveTenantConfig, saveWorkflowMapping, } from "../config.js";
 import { getGhToken, ensureGhAuth, GhAuthError } from "../github/gh-auth.js";
 import { detectEnvironment } from "../detection/environment-detector.js";
 import { buildContextYaml, writeContextYaml, } from "../context/generate-context-yaml.js";
@@ -76,43 +75,6 @@ const handler = async (args, options) => {
     await runInteractive(options);
 };
 export default handler;
-function inferAgentRuntimeFromCommand(command) {
-    if (!command) {
-        return null;
-    }
-    if (command.includes("claude-code")) {
-        return "claude-code";
-    }
-    if (command.includes("codex")) {
-        return "codex";
-    }
-    return null;
-}
-function isWorkerBootstrapCommand(command) {
-    return (command.includes("@gh-symphony/worker/dist/index.js") ||
-        command.includes("packages/worker/dist/index.js"));
-}
-function isMissingAgentEnvError(error) {
-    return (error instanceof Error &&
-        error.message.includes("Workflow front matter requires environment variable"));
-}
-export async function resolveTenantRuntime(configDir, tenantId, tenantWorkerCommand) {
-    const workflowPath = join(configDir, "tenants", tenantId, "WORKFLOW.md");
-    try {
-        const workflowMarkdown = await readFile(workflowPath, "utf8");
-        const agentCommand = parseWorkflowMarkdown(workflowMarkdown, {}).agentCommand;
-        if (!isWorkerBootstrapCommand(agentCommand)) {
-            return agentCommand;
-        }
-    }
-    catch (error) {
-        const err = error;
-        if (err.code !== "ENOENT" && !isMissingAgentEnvError(error)) {
-            throw error;
-        }
-    }
-    return inferAgentRuntimeFromCommand(tenantWorkerCommand) ?? "codex";
-}
 export async function writeEcosystem(opts) {
     const { cwd, projectDetail, statusField, runtime, skipSkills, skipContext } = opts;
     const ghSymphonyDir = join(cwd, ".gh-symphony");
@@ -327,103 +289,9 @@ async function runNonInteractive(flags, options) {
 // ── Interactive mode: WORKFLOW.md generation ─────────────────────────────────
 async function runInteractive(options) {
     p.intro("gh-symphony — WORKFLOW.md Setup");
-    // Case A: tenant(s) already configured
-    const globalConfig = await loadGlobalConfig(options.configDir);
-    if (globalConfig?.tenants?.length) {
-        await runInteractiveFromTenant(globalConfig, options);
-        return;
-    }
-    // Case B: no tenants — standalone WORKFLOW.md generation
     await runInteractiveStandalone(options);
 }
-// ── Case A: Generate WORKFLOW.md from existing tenant config ─────────────────
-async function runInteractiveFromTenant(globalConfig, options) {
-    const tenants = globalConfig.tenants;
-    let tenantId;
-    if (tenants.length === 1) {
-        tenantId = tenants[0];
-    }
-    else {
-        // Multiple tenants: ask which one to base WORKFLOW.md on
-        const tenantConfigs = await Promise.all(tenants.map(async (id) => {
-            const cfg = await loadTenantConfig(options.configDir, id);
-            return { id, label: cfg?.slug ?? id };
-        }));
-        tenantId = await abortIfCancelled(p.select({
-            message: "Select a tenant to base WORKFLOW.md on:",
-            options: tenantConfigs.map((t) => ({
-                value: t.id,
-                label: t.label,
-                hint: globalConfig.activeTenant === t.id ? "active" : undefined,
-            })),
-        }));
-    }
-    const tenantConfig = await loadTenantConfig(options.configDir, tenantId);
-    if (!tenantConfig) {
-        p.log.error(`Tenant config not found for "${tenantId}".`);
-        process.exitCode = 1;
-        return;
-    }
-    const lifecycle = tenantConfig.workflowMapping?.lifecycle;
-    if (!lifecycle) {
-        p.log.error(`Tenant "${tenantId}" has no workflow lifecycle config. Run 'gh-symphony tenant add' first.`);
-        process.exitCode = 1;
-        return;
-    }
-    const mappings = {};
-    const workflowMapping = tenantConfig.workflowMapping;
-    if (workflowMapping) {
-        Object.assign(mappings, workflowMapping.mappings);
-    }
-    const projectId = tenantConfig.tracker.settings?.projectId;
-    const stateFieldName = workflowMapping?.stateFieldName ?? lifecycle.stateFieldName;
-    const runtime = await resolveTenantRuntime(options.configDir, tenantId, tenantConfig.runtime.workerCommand);
-    const workflowMd = generateWorkflowMarkdown({
-        projectId: projectId ?? "",
-        stateFieldName,
-        mappings,
-        lifecycle,
-        runtime,
-    });
-    const outputPath = resolve("WORKFLOW.md");
-    await writeFile(outputPath, workflowMd, "utf8");
-    const projId = tenantConfig.tracker.settings?.projectId;
-    let ecosystemResult = null;
-    let token;
-    try {
-        token = getGhToken();
-    }
-    catch {
-        // getGhToken failed — token stays undefined; ecosystem write proceeds best-effort
-    }
-    if (token && projId) {
-        try {
-            const client = createClient(token);
-            const fullProject = await getProjectDetail(client, projId);
-            const sf = fullProject.statusFields.find((f) => f.name.toLowerCase() === stateFieldName.toLowerCase()) ?? fullProject.statusFields[0];
-            if (sf) {
-                ecosystemResult = await writeEcosystem({
-                    cwd: process.cwd(),
-                    projectDetail: fullProject,
-                    statusField: sf,
-                    runtime,
-                    skipSkills: false,
-                    skipContext: false,
-                });
-            }
-        }
-        catch {
-            // best-effort: don't fail init if GitHub API is unreachable
-        }
-    }
-    if (ecosystemResult) {
-        printEcosystemSummary(ecosystemResult, outputPath, { interactive: true });
-    }
-    else {
-        p.outro(`WORKFLOW.md generated at ${outputPath}`);
-    }
-}
-// ── Case B: Standalone WORKFLOW.md generation (no tenant) ────────────────────
+// ── Interactive WORKFLOW.md generation ────────────────────────────────────────
 async function runInteractiveStandalone(_options) {
     const s1 = p.spinner();
     s1.start("Checking gh CLI authentication...");

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