@gh-symphony/cli 0.1.3 → 0.2.0

package/dist/{chunk-2YF7PQUC.js → chunk-F46FTZJE.js}

@@ -15,7 +15,7 @@ import {
   formatClaudePreflightText,
   resolveClaudeCommandBinary,
   runClaudePreflight
-} from "./chunk-WCOIVNHH.js";
+} from "./chunk-Q3UEPUE3.js";
 
 // src/mapping/smart-defaults.ts
 var ROLE_PATTERNS = [
@@ -952,6 +952,22 @@ function generateReferenceWorkflow(input) {
     lines.push("  blocker_check_states: [{first active state}]");
   }
   lines.push("");
+  lines.push("# Linear tracker example:");
+  lines.push("# tracker:");
+  lines.push("#   kind: linear");
+  lines.push("#   endpoint: https://api.linear.app/graphql");
+  lines.push("#   api_key: $LINEAR_API_KEY");
+  lines.push("#   project_slug: symphony-0c79b11b75ea");
+  lines.push("#   active_states:");
+  lines.push("#     - Todo");
+  lines.push("#     - In Progress");
+  lines.push("#   terminal_states:");
+  lines.push("#     - Done");
+  lines.push("#     - Canceled");
+  lines.push("#     - Duplicate");
+  lines.push("# Linear uses repository-local polling; gh-symphony does not provide");
+  lines.push("# a Linear webhook setup command.");
+  lines.push("");
   lines.push("polling:");
   lines.push("  interval_ms: 30000");
   lines.push("");

package/dist/{chunk-NESHTYXQ.js → chunk-JU3WSGMZ.js}

@@ -1,11 +1,12 @@
 #!/usr/bin/env node
 import {
   workflow_init_default
-} from "./chunk-2YF7PQUC.js";
+} from "./chunk-F46FTZJE.js";
 import {
   fetchGithubProjectIssueByRepositoryAndNumber,
-  inspectManagedProjectSelection
-} from "./chunk-HQ7A3C7K.js";
+  inspectManagedProjectSelection,
+  resolveTrackerAdapter
+} from "./chunk-CTTFIZYG.js";
 import {
   GitHubApiError,
   createClient,
@@ -18,7 +19,10 @@ import {
   buildPromptVariables,
   parseWorkflowMarkdown,
   renderPrompt
-} from "./chunk-WCOIVNHH.js";
+} from "./chunk-Q3UEPUE3.js";
+import {
+  loadActiveProjectConfig
+} from "./chunk-WOVNN5NW.js";
 
 // src/commands/workflow.ts
 import { readFile } from "fs/promises";
@@ -65,7 +69,9 @@ var workflowCommandDependencies = {
   fetchLiveIssue: fetchGithubProjectIssueByRepositoryAndNumber,
   getGitHubProjectDetail: getProjectDetail,
   getGitHubTokenWithSource: getGhTokenWithSource,
+  loadActiveProjectConfig,
   resolveManagedProjectSelection: inspectManagedProjectSelection,
+  resolveTrackerAdapter,
   validateGitHubToken
 };
 function setWorkflowCommandDependenciesForTest(overrides) {
@@ -76,7 +82,9 @@ function resetWorkflowCommandDependenciesForTest() {
   workflowCommandDependencies.fetchLiveIssue = fetchGithubProjectIssueByRepositoryAndNumber;
   workflowCommandDependencies.getGitHubProjectDetail = getProjectDetail;
   workflowCommandDependencies.getGitHubTokenWithSource = getGhTokenWithSource;
+  workflowCommandDependencies.loadActiveProjectConfig = loadActiveProjectConfig;
   workflowCommandDependencies.resolveManagedProjectSelection = inspectManagedProjectSelection;
+  workflowCommandDependencies.resolveTrackerAdapter = resolveTrackerAdapter;
   workflowCommandDependencies.validateGitHubToken = validateGitHubToken;
 }
 function parseWorkflowArgs(args) {
@@ -140,6 +148,9 @@ function parsePreviewFlags(args) {
         if (!value || value.startsWith("-")) {
           throw new Error("Option '--issue' argument missing");
         }
+        if (flags.issue) {
+          throw new Error("Only one preview issue identifier can be provided.");
+        }
         flags.issue = value;
         i += 1;
         break;
@@ -162,6 +173,10 @@ function parsePreviewFlags(args) {
         if (arg?.startsWith("-")) {
           throw new Error(`Unknown option '${arg}'`);
         }
+        if (flags.issue) {
+          throw new Error("Only one preview issue identifier can be provided.");
+        }
+        flags.issue = arg;
         break;
     }
   }
@@ -185,7 +200,9 @@ Commands:
 Options:
   workflow init [--non-interactive] [--project <id>] [--output <path>] [--skip-skills] [--skip-context] [--dry-run]
   workflow validate [--file <path>]
-  workflow preview [--file <path>] [--issue <owner/repo#number>] [--project-id <projectId>] [--sample <json>] [--attempt <n>]
+  workflow preview [issue] [--file <path>] [--issue <owner/repo#number|ENG-123>] [--project-id <projectId>] [--sample <json>] [--attempt <n>]
+
+Linear workflows use polling through the configured tracker adapter. No Linear webhook setup command is provided.
 `);
 }
 async function loadWorkflowMarkdown(workflowPath) {
@@ -472,6 +489,58 @@ async function loadLiveIssue(issueReference, projectId, options) {
     sampleSource: `live:${trackedIssue.identifier}`
   };
 }
+var LINEAR_IDENTIFIER_PATTERN = /^[A-Z][A-Z0-9]*-\d+$/;
+function isLinearIssueIdentifier(value) {
+  return LINEAR_IDENTIFIER_PATTERN.test(value.trim().toUpperCase());
+}
+async function loadLinearIssue(issueIdentifier, workflow, options) {
+  const projectConfig = await workflowCommandDependencies.loadActiveProjectConfig(
+    options.configDir
+  );
+  if (!projectConfig?.repository) {
+    throw new Error(
+      "Linear live issue preview requires a repository runtime initialized with 'gh-symphony repo init'."
+    );
+  }
+  const workflowProjectSlug = workflow.tracker.projectSlug?.trim();
+  if (!workflowProjectSlug) {
+    throw new Error(
+      'Linear live issue preview requires WORKFLOW.md field "tracker.project_slug".'
+    );
+  }
+  if (!workflow.tracker.apiKey?.trim()) {
+    throw new Error(
+      'Linear live issue preview requires WORKFLOW.md field "tracker.api_key" to resolve, for example "$LINEAR_API_KEY".'
+    );
+  }
+  if (projectConfig.tracker.adapter !== "linear" || projectConfig.tracker.bindingId !== workflowProjectSlug) {
+    throw new Error(
+      `Linear live issue preview requires an active repository runtime initialized for project "${workflowProjectSlug}". Run 'gh-symphony repo init' from this repository, then re-run the preview.`
+    );
+  }
+  const orchestratorProject = {
+    projectId: projectConfig.projectId,
+    slug: projectConfig.slug,
+    workspaceDir: projectConfig.workspaceDir,
+    repository: projectConfig.repository,
+    tracker: projectConfig.tracker
+  };
+  const trackerAdapter = workflowCommandDependencies.resolveTrackerAdapter(projectConfig.tracker);
+  const [issue] = await trackerAdapter.fetchIssueStatesByIds(
+    orchestratorProject,
+    [issueIdentifier.trim().toUpperCase()],
+    { token: workflow.tracker.apiKey }
+  );
+  if (!issue) {
+    throw new Error(
+      `Linear issue ${issueIdentifier} was not found in project "${workflow.tracker.projectSlug}".`
+    );
+  }
+  return {
+    issue,
+    sampleSource: `live:${issue.identifier}`
+  };
+}
 function validateWorkflow(workflowPath, markdown) {
   const workflow = parseWorkflowMarkdown(markdown);
   const promptFreshVariables = buildPromptVariables(SAMPLE_ISSUE, {
@@ -586,12 +655,12 @@ async function runPreview(args, options) {
   }
   const { workflowPath, markdown } = await loadWorkflowMarkdown(flags.file);
   const workflow = parseWorkflowMarkdown(markdown);
-  if (flags.issue && workflow.tracker.kind !== "github-project") {
+  if (flags.issue && workflow.tracker.kind !== "github-project" && !(workflow.tracker.kind === "linear" && isLinearIssueIdentifier(flags.issue))) {
     throw new Error(
-      "Live issue preview requires 'tracker.kind: github-project' in WORKFLOW.md."
+      "Live issue preview requires 'tracker.kind: github-project' with owner/repo#number or 'tracker.kind: linear' with a Linear identifier such as ENG-123."
     );
   }
-  const { issue, sampleSource } = flags.issue ? await loadLiveIssue(flags.issue, flags.projectId, options) : await loadSampleIssue(flags.sample);
+  const { issue, sampleSource } = flags.issue ? workflow.tracker.kind === "linear" ? await loadLinearIssue(flags.issue, workflow, options) : await loadLiveIssue(flags.issue, flags.projectId, options) : await loadSampleIssue(flags.sample);
   const renderedPrompt = renderIssueWorkflowPreview({
     workflow,
     issue,