@gh-symphony/cli 0.1.4 → 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-E7OCBNB2.js → chunk-B6OHDUSH.js}

@@ -10,7 +10,7 @@ import {
   resolveGitHubGraphQLToken,
   shouldReuseAgentCredentialCache,
   writeAgentCredentialCache
-} from "./chunk-EWTMSDCE.js";
+} from "./chunk-Q3UEPUE3.js";
 
 // ../runtime-codex/src/runtime.ts
 import { spawn } from "child_process";

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

@@ -4,7 +4,7 @@ import {
 } from "./chunk-6I753NYO.js";
 import {
   parseWorkflowMarkdown
-} from "./chunk-EWTMSDCE.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);