@gh-symphony/cli 0.1.3 → 0.2.0

package/README.md

@@ -107,6 +107,25 @@ You can further customize the agent's behavior by editing `WORKFLOW.md` — this
 
 > Currently supported runtimes: **Codex**, **Claude Code**
 
+### Linear Tracker Repositories
+
+For Linear, configure the tracker in `WORKFLOW.md` and initialize the repository runtime from the target GitHub repository:
+
+```yaml
+tracker:
+  kind: linear
+  api_key: $LINEAR_API_KEY
+  project_slug: symphony-0c79b11b75ea
+```
+
+`gh-symphony repo init` validates `tracker.project_slug` and resolves `tracker.api_key`, so `LINEAR_API_KEY` must be set before initialization. Linear aliases such as `tracker.project_id`, `projectId`, `project_id`, and `teamId` are rejected, and `.gh-symphony/config.json` is not a Linear source of truth.
+
+Linear runs are polling-only. There is no webhook setup command. Put state transition, workpad comment, and PR handoff policy in `WORKFLOW.md`; see `docs/examples/linear-WORKFLOW.md` in the repository for a complete example. Preview a Linear issue prompt with:
+
+```bash
+gh-symphony workflow preview ENG-123
+```
+
 ### Repository `.env` Mapping
 
 If your hooks or worker runs need staging hosts, database URLs, Playwright base URLs, or other runtime-only values, store them in the repository runtime directory instead of hardcoding them in `WORKFLOW.md`.

package/dist/{chunk-PEZUBHWJ.js → chunk-B6OHDUSH.js}

@@ -1,14 +1,16 @@
 #!/usr/bin/env node
 import {
+  DEFAULT_LINEAR_GRAPHQL_URL,
   buildAgentInputRequiredReason,
   createGitHubGraphQLMcpServerEntry,
+  createLinearGraphQLMcpServerEntry,
   extractEnvForCodex,
   readAgentCredentialCache,
   readEnvFile,
   resolveGitHubGraphQLToken,
   shouldReuseAgentCredentialCache,
   writeAgentCredentialCache
-} from "./chunk-WCOIVNHH.js";
+} from "./chunk-Q3UEPUE3.js";
 
 // ../runtime-codex/src/runtime.ts
 import { spawn } from "child_process";
@@ -77,6 +79,35 @@ function createGitHubGraphQLToolDefinition(config) {
     }
   };
 }
+function createLinearGraphQLToolDefinition(config) {
+  const entry = createLinearGraphQLMcpServerEntry(config);
+  return {
+    name: "linear_graphql",
+    description: "Execute a single Linear GraphQL query or mutation for the active Linear issue using runtime-managed auth.",
+    command: entry.command,
+    args: entry.args,
+    env: entry.env,
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: {
+          type: "string",
+          description: "Single GraphQL query or mutation document."
+        },
+        variables: {
+          type: "object",
+          description: "Variables for the GraphQL document."
+        },
+        operationName: {
+          type: "string",
+          description: "Optional GraphQL operation name."
+        }
+      },
+      required: ["query"],
+      additionalProperties: false
+    }
+  };
+}
 function asRecord(value) {
   return value != null && typeof value === "object" ? value : {};
 }
@@ -272,7 +303,15 @@ function resolvePreparedAgentEnvironment(workingDirectory, env) {
   };
 }
 function buildCodexRuntimePlan(config) {
-  const tool = createGitHubGraphQLToolDefinition(config);
+  const githubTool = createGitHubGraphQLToolDefinition(config);
+  const tools = [
+    githubTool,
+    ...config.enableLinearGraphqlTool ? [
+      createLinearGraphQLToolDefinition({
+        linearGraphqlUrl: config.linearGraphqlUrl ?? DEFAULT_LINEAR_GRAPHQL_URL
+      })
+    ] : []
+  ];
   const gitCredentialHelper = createGitCredentialHelperEnvironment(config);
   const shellCmd = (() => {
     const cmd = config.agentCommand ?? "codex app-server";
@@ -282,6 +321,21 @@ function buildCodexRuntimePlan(config) {
     config.workingDirectory,
     config.agentEnv
   );
+  const linearGraphqlEnv = config.enableLinearGraphqlTool ? {
+    LINEAR_GRAPHQL_TOOL_NAME: "linear_graphql",
+    LINEAR_GRAPHQL_URL: config.linearGraphqlUrl ?? DEFAULT_LINEAR_GRAPHQL_URL,
+    ...config.linearAuthorization ? {
+      LINEAR_AUTHORIZATION: config.linearAuthorization
+    } : {},
+    ...config.linearApiKey ? {
+      LINEAR_API_KEY: config.linearApiKey
+    } : {}
+  } : {
+    LINEAR_GRAPHQL_TOOL_NAME: "",
+    LINEAR_GRAPHQL_URL: void 0,
+    LINEAR_API_KEY: void 0,
+    LINEAR_AUTHORIZATION: void 0
+  };
   return {
     cwd: config.workingDirectory,
     command: "bash",
@@ -292,13 +346,17 @@ function buildCodexRuntimePlan(config) {
       ...config.agentEnv,
       CODEX_PROJECT_ID: config.projectId,
       GITHUB_PROJECT_ID: config.githubProjectId ?? "",
-      GITHUB_GRAPHQL_TOOL_NAME: tool.name,
-      GITHUB_GRAPHQL_TOOL_COMMAND: [tool.command, ...tool.args].join(" "),
+      GITHUB_GRAPHQL_TOOL_NAME: githubTool.name,
+      GITHUB_GRAPHQL_TOOL_COMMAND: [
+        githubTool.command,
+        ...githubTool.args
+      ].join(" "),
+      ...linearGraphqlEnv,
       ...agentEnv,
       ...gitCredentialHelper,
-      ...tool.env
+      ...Object.assign({}, ...tools.map((tool) => tool.env))
     },
-    tools: [tool]
+    tools
   };
 }
 function launchCodexAppServer(plan, spawnImpl = spawn) {
@@ -426,7 +484,10 @@ async function resolveAgentRuntimeEnvironment(config, dependencies = {}, adapter
   }
   const now = dependencies.now ?? /* @__PURE__ */ new Date();
   const readFileImpl = dependencies.readFileImpl ?? readFile;
-  const cachedCredentials = config.agentCredentialCachePath ? await readAgentCredentialCache(config.agentCredentialCachePath, readFileImpl) : null;
+  const cachedCredentials = config.agentCredentialCachePath ? await readAgentCredentialCache(
+    config.agentCredentialCachePath,
+    readFileImpl
+  ) : null;
   if (cachedCredentials && shouldReuseAgentCredentialCache(cachedCredentials, now)) {
     return resolveRuntimeCredentials(config, cachedCredentials, adapter);
   }
@@ -460,7 +521,10 @@ async function resolveAgentRuntimeEnvironment(config, dependencies = {}, adapter
   return resolvedEnv;
 }
 function resolveRuntimeCredentials(config, brokerResponse, adapter) {
-  return adapter ? adapter.resolveCredentials(brokerResponse) : resolvePreparedAgentEnvironment(config.workingDirectory, brokerResponse.env);
+  return adapter ? adapter.resolveCredentials(brokerResponse) : resolvePreparedAgentEnvironment(
+    config.workingDirectory,
+    brokerResponse.env
+  );
 }
 async function stageCodexHome(config, dependencies = {}) {
   const codexHomeDir = resolveStagedCodexHome(config.workingDirectory);
@@ -524,6 +588,10 @@ function resolveLocalRuntimeLaunchConfig(env = process.env) {
     agentCredentialCachePath: env.AGENT_CREDENTIAL_CACHE_PATH,
     githubProjectId: env.GITHUB_PROJECT_ID,
     githubGraphqlApiUrl: env.GITHUB_GRAPHQL_API_URL,
+    enableLinearGraphqlTool: env.SYMPHONY_TRACKER_KIND === "linear",
+    linearApiKey: env.LINEAR_API_KEY,
+    linearAuthorization: env.LINEAR_AUTHORIZATION,
+    linearGraphqlUrl: env.LINEAR_GRAPHQL_URL,
     agentCommand: env.SYMPHONY_AGENT_COMMAND
   };
 }

package/dist/{chunk-PG332ZS4.js → chunk-C44DYDNU.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-6I753NYO.js";
 import {
   parseWorkflowMarkdown
-} from "./chunk-WCOIVNHH.js";
+} from "./chunk-Q3UEPUE3.js";
 import {
   saveGlobalConfig,
   saveProjectConfig
@@ -58,6 +58,7 @@ async function initRepoRuntime(flags) {
   await migrateLegacyRuntime(runtimeRoot);
   const workflowPath = resolve(repoDir, flags.workflowFile ?? "WORKFLOW.md");
   const workflow = parseWorkflowMarkdown(await readFile(workflowPath, "utf8"));
+  validateRepoInitWorkflow(workflow);
   const repository = resolveRepository(repoDir);
   const trackerAdapter = workflow.tracker.kind ?? "github-project";
   const trackerBindingId = workflow.tracker.projectId ?? workflow.tracker.projectSlug ?? "";
@@ -112,6 +113,16 @@ async function initRepoRuntime(flags) {
     repository
   };
 }
+function validateRepoInitWorkflow(workflow) {
+  if (workflow.tracker.kind !== "linear") {
+    return;
+  }
+  if (!workflow.tracker.apiKey?.trim()) {
+    throw new Error(
+      'Linear tracker repo init requires WORKFLOW.md field "tracker.api_key" to reference a resolvable environment variable such as "$LINEAR_API_KEY".'
+    );
+  }
+}
 async function migrateLegacyRuntime(runtimeRoot) {
   const projectsDir = join(runtimeRoot, "projects");
   const projectIds = await readDirectoryNames(projectsDir);