@gh-symphony/cli 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GitHub Symphony contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/commands/config-cmd.d.ts

@@ -0,0 +1,3 @@
+import type { GlobalOptions } from "../index.js";
+declare const handler: (args: string[], options: GlobalOptions) => Promise<void>;
+export default handler;

package/dist/commands/config-cmd.js

@@ -0,0 +1,106 @@
+import { spawn } from "node:child_process";
+import { loadGlobalConfig, saveGlobalConfig, configFilePath, } from "../config.js";
+const handler = async (args, options) => {
+    const [subcommand, ...rest] = args;
+    switch (subcommand) {
+        case "show":
+            await configShow(options);
+            break;
+        case "set":
+            await configSet(rest, options);
+            break;
+        case "edit":
+            await configEdit(options);
+            break;
+        default:
+            process.stderr.write("Usage: gh-symphony config <show|set|edit>\n");
+            process.exitCode = 2;
+    }
+};
+export default handler;
+// ── 7.1: config show ─────────────────────────────────────────────────────────
+async function configShow(options) {
+    const config = await loadGlobalConfig(options.configDir);
+    if (!config) {
+        process.stderr.write("No configuration found. Run 'gh-symphony init'.\n");
+        process.exitCode = 1;
+        return;
+    }
+    // Mask token for display
+    const display = {
+        ...config,
+        token: config.token ? maskToken(config.token) : null,
+    };
+    if (options.json) {
+        process.stdout.write(JSON.stringify(display, null, 2) + "\n");
+        return;
+    }
+    process.stdout.write(`Config: ${configFilePath(options.configDir)}\n\n`);
+    process.stdout.write(`Active workspace: ${config.activeWorkspace ?? "none"}\n`);
+    process.stdout.write(`Token:            ${display.token ?? "not set"}\n`);
+    process.stdout.write(`Workspaces:       ${config.workspaces.join(", ") || "none"}\n`);
+}
+function maskToken(token) {
+    if (token.length <= 8)
+        return "****";
+    return token.slice(0, 4) + "..." + token.slice(-4);
+}
+// ── 7.2: config set ──────────────────────────────────────────────────────────
+const VALID_KEYS = {
+    "active-workspace": { type: "string" },
+    token: { type: "string" },
+};
+async function configSet(args, options) {
+    const [key, value] = args;
+    if (!key || value === undefined) {
+        process.stderr.write("Usage: gh-symphony config set <key> <value>\n");
+        process.stderr.write(`Valid keys: ${Object.keys(VALID_KEYS).join(", ")}\n`);
+        process.exitCode = 2;
+        return;
+    }
+    const keyDef = VALID_KEYS[key];
+    if (!keyDef) {
+        process.stderr.write(`Unknown config key: ${key}\nValid keys: ${Object.keys(VALID_KEYS).join(", ")}\n`);
+        process.exitCode = 2;
+        return;
+    }
+    const config = (await loadGlobalConfig(options.configDir)) ??
+        {
+            activeWorkspace: null,
+            token: null,
+            workspaces: [],
+        };
+    switch (key) {
+        case "active-workspace":
+            if (!config.workspaces.includes(value)) {
+                process.stderr.write(`Workspace "${value}" not found. Available: ${config.workspaces.join(", ")}\n`);
+                process.exitCode = 1;
+                return;
+            }
+            config.activeWorkspace = value;
+            break;
+        case "token":
+            config.token = value;
+            break;
+    }
+    await saveGlobalConfig(options.configDir, config);
+    process.stdout.write(`Set ${key} = ${key === "token" ? maskToken(value) : value}\n`);
+}
+// ── 7.3: config edit ─────────────────────────────────────────────────────────
+async function configEdit(options) {
+    const editor = process.env.EDITOR || process.env.VISUAL || "vi";
+    const path = configFilePath(options.configDir);
+    const child = spawn(editor, [path], {
+        stdio: "inherit",
+    });
+    await new Promise((resolve, reject) => {
+        child.on("close", (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`Editor exited with code ${code}`));
+            }
+        });
+    });
+}

package/dist/commands/help.d.ts

@@ -0,0 +1,3 @@
+import type { GlobalOptions } from "../index.js";
+declare const handler: (_args: string[], _options: GlobalOptions) => Promise<void>;
+export default handler;

package/dist/commands/help.js

@@ -0,0 +1,47 @@
+const HELP_TEXT = `
+gh-symphony — AI Coding Agent Orchestrator
+
+Usage: gh-symphony <command> [options]
+
+Setup:
+  init            Interactive workspace 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
+
+Workspace Management:
+  project list    List all workspaces
+  project switch  Switch active workspace
+  project status  Show workspace details
+  repo list       List configured repositories
+  repo add        Add a repository
+  repo remove     Remove a repository
+
+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 this help message
+  --version, -V   Show version
+
+Examples:
+  gh-symphony init                    # Set up a new workspace
+  gh-symphony start                   # Start orchestrator
+  gh-symphony start --daemon          # Start in background
+  gh-symphony run org/repo#123        # Dispatch a specific issue
+  gh-symphony status --watch          # Watch status in real-time
+`.trimStart();
+const handler = async (_args, _options) => {
+    process.stdout.write(HELP_TEXT);
+};
+export default handler;

package/dist/commands/init.d.ts

@@ -0,0 +1,26 @@
+import type { GlobalOptions } from "../index.js";
+import { type ProjectDetail, type LinkedRepository } from "../github/client.js";
+import { type ColumnRole, type HumanReviewMode } from "../config.js";
+declare const handler: (args: string[], options: GlobalOptions) => Promise<void>;
+export default handler;
+type WriteConfigInput = {
+    workspaceId: string;
+    token: string;
+    project: ProjectDetail;
+    repos: LinkedRepository[];
+    statusField: {
+        name: string;
+        options: Array<{
+            name: string;
+        }>;
+    };
+    roles: Record<string, ColumnRole>;
+    humanReviewMode: HumanReviewMode;
+    runtime: string;
+    workerCommand?: string;
+    pollIntervalMs?: number;
+    concurrency?: number;
+    maxAttempts?: number;
+};
+export declare function writeConfig(configDir: string, input: WriteConfigInput): Promise<void>;
+export declare function generateWorkspaceId(projectTitle: string, uniqueKey: string): string;