@gh-symphony/cli 0.0.19 → 0.0.21

package/dist/{workflow-TBIFY5MO.js → workflow-BLJH2HC3.js}

@@ -1,13 +1,26 @@
 #!/usr/bin/env node
 import {
   init_default
-} from "./chunk-RN2PACNV.js";
+} from "./chunk-JN3TQVFV.js";
+import {
+  fetchGithubProjectIssueByRepositoryAndNumber
+} from "./chunk-SXGT7LOF.js";
+import {
+  GitHubApiError,
+  createClient,
+  findLinkedRepository,
+  getGhTokenWithSource,
+  getProjectDetail,
+  validateGitHubToken
+} from "./chunk-C67H3OUL.js";
 import {
   buildPromptVariables,
   parseWorkflowMarkdown,
   renderPrompt
-} from "./chunk-M3IFVLQS.js";
-import "./chunk-TILHWBP6.js";
+} from "./chunk-QEONJ5DZ.js";
+import {
+  inspectManagedProjectSelection
+} from "./chunk-C7G7RJ4G.js";
 import "./chunk-ROGRTUFI.js";
 
 // src/commands/workflow.ts
@@ -50,6 +63,25 @@ var SAMPLE_CONTINUATION_VARIABLES = {
   lastTurnSummary: "Validated the prompt template and updated the CLI routing.",
   cumulativeTurnCount: 3
 };
+var workflowCommandDependencies = {
+  createGitHubClient: createClient,
+  fetchLiveIssue: fetchGithubProjectIssueByRepositoryAndNumber,
+  getGitHubProjectDetail: getProjectDetail,
+  getGitHubTokenWithSource: getGhTokenWithSource,
+  resolveManagedProjectSelection: inspectManagedProjectSelection,
+  validateGitHubToken
+};
+function setWorkflowCommandDependenciesForTest(overrides) {
+  Object.assign(workflowCommandDependencies, overrides);
+}
+function resetWorkflowCommandDependenciesForTest() {
+  workflowCommandDependencies.createGitHubClient = createClient;
+  workflowCommandDependencies.fetchLiveIssue = fetchGithubProjectIssueByRepositoryAndNumber;
+  workflowCommandDependencies.getGitHubProjectDetail = getProjectDetail;
+  workflowCommandDependencies.getGitHubTokenWithSource = getGhTokenWithSource;
+  workflowCommandDependencies.resolveManagedProjectSelection = inspectManagedProjectSelection;
+  workflowCommandDependencies.validateGitHubToken = validateGitHubToken;
+}
 function parseWorkflowArgs(args) {
   const [subcommand, ...rest] = args;
   if (!subcommand) {
@@ -107,6 +139,21 @@ function parsePreviewFlags(args) {
         flags.sample = value;
         i += 1;
         break;
+      case "--issue":
+        if (!value || value.startsWith("-")) {
+          throw new Error("Option '--issue' argument missing");
+        }
+        flags.issue = value;
+        i += 1;
+        break;
+      case "--project-id":
+      case "--project":
+        if (!value || value.startsWith("-")) {
+          throw new Error(`Option '${arg}' argument missing`);
+        }
+        flags.projectId = value;
+        i += 1;
+        break;
       case "--attempt":
         if (!value || value.startsWith("-")) {
           throw new Error("Option '--attempt' argument missing");
@@ -136,12 +183,12 @@ function printWorkflowUsage() {
 Commands:
   init       Generate WORKFLOW.md and workflow support files
   validate   Parse and strictly validate a WORKFLOW.md file
-  preview    Render the final worker prompt from a sample issue
+  preview    Render the final worker prompt from a sample or live issue
 
 Options:
   workflow init [--non-interactive] [--project <id>] [--output <path>] [--skip-skills] [--skip-context] [--dry-run]
   workflow validate [--file <path>]
-  workflow preview [--file <path>] [--sample <json>] [--attempt <n>]
+  workflow preview [--file <path>] [--issue <owner/repo#number>] [--project-id <projectId>] [--sample <json>] [--attempt <n>]
 `);
 }
 async function loadWorkflowMarkdown(workflowPath) {
@@ -166,7 +213,10 @@ function normalizeIssue(value) {
     repositoryRecord.name,
     "repository.name"
   );
-  const repositoryUrl = readOptionalString(repositoryRecord.url, "repository.url");
+  const repositoryUrl = readOptionalString(
+    repositoryRecord.url,
+    "repository.url"
+  );
   return {
     id: readRequiredString(record.id, "id"),
     identifier: readRequiredString(record.identifier, "identifier"),
@@ -245,7 +295,9 @@ function readStringArray(value, field) {
     return [];
   }
   if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) {
-    throw new Error(`Sample JSON field '${field}' must be an array of strings.`);
+    throw new Error(
+      `Sample JSON field '${field}' must be an array of strings.`
+    );
   }
   return value;
 }
@@ -254,7 +306,9 @@ function readBlockers(value) {
     return [];
   }
   if (!Array.isArray(value)) {
-    throw new Error("Sample JSON field 'blockedBy/blocked_by' must be an array.");
+    throw new Error(
+      "Sample JSON field 'blockedBy/blocked_by' must be an array."
+    );
   }
   return value.map((entry, index) => {
     const record = asRecord(entry, `blockedBy/blocked_by[${index}]`);
@@ -313,6 +367,106 @@ async function loadSampleIssue(samplePath) {
     sampleSource: resolvedPath
   };
 }
+function parseIssueReference(value) {
+  const match = /^(?<owner>[A-Za-z0-9_.-]+)\/(?<name>[A-Za-z0-9_.-]+)#(?<number>\d+)$/.exec(
+    value.trim()
+  );
+  if (!match?.groups) {
+    throw new Error(
+      "Option '--issue' must be in the format 'owner/repo#number'."
+    );
+  }
+  return {
+    owner: match.groups.owner,
+    name: match.groups.name,
+    number: Number.parseInt(match.groups.number, 10),
+    identifier: `${match.groups.owner}/${match.groups.name}#${match.groups.number}`
+  };
+}
+function readGitHubProjectBinding(projectConfig) {
+  const bindingId = projectConfig.tracker.bindingId?.trim();
+  if (bindingId) {
+    return bindingId;
+  }
+  const settingsProjectId = projectConfig.tracker.settings?.projectId;
+  return typeof settingsProjectId === "string" && settingsProjectId.trim().length > 0 ? settingsProjectId.trim() : null;
+}
+function formatAuthError(error) {
+  return `GitHub authentication is required for live issue preview. ${error.message}`;
+}
+async function loadLiveIssue(issueReference, projectId, options) {
+  const issue = parseIssueReference(issueReference);
+  const selection = await workflowCommandDependencies.resolveManagedProjectSelection({
+    configDir: options.configDir,
+    requestedProjectId: projectId
+  });
+  if (selection.kind !== "resolved") {
+    throw new Error(selection.message);
+  }
+  const githubProjectId = readGitHubProjectBinding(selection.projectConfig);
+  if (!githubProjectId) {
+    throw new Error(
+      `Managed project "${selection.projectId}" is not bound to a GitHub Project. Re-run 'gh-symphony project add' and select a valid GitHub Project binding.`
+    );
+  }
+  let auth;
+  try {
+    const tokenResult = workflowCommandDependencies.getGitHubTokenWithSource();
+    auth = await workflowCommandDependencies.validateGitHubToken(
+      tokenResult.token,
+      tokenResult.source
+    );
+  } catch (error) {
+    if (error instanceof Error) {
+      throw new Error(formatAuthError(error));
+    }
+    throw error;
+  }
+  const client = workflowCommandDependencies.createGitHubClient(auth.token, {
+    apiUrl: selection.projectConfig.tracker.apiUrl
+  });
+  let detail;
+  try {
+    detail = await workflowCommandDependencies.getGitHubProjectDetail(
+      client,
+      githubProjectId
+    );
+  } catch (error) {
+    const message = error instanceof GitHubApiError ? error.message : error instanceof Error ? error.message : "Unknown GitHub API error.";
+    throw new Error(
+      `Failed to resolve the configured GitHub Project binding '${githubProjectId}': ${message}`
+    );
+  }
+  if (!findLinkedRepository(detail, issue.owner, issue.name)) {
+    throw new Error(
+      `Repository ${issue.owner}/${issue.name} is not linked to the configured GitHub Project "${detail.title}". Run 'gh-symphony repo add ${issue.owner}/${issue.name}' or re-run 'gh-symphony project add' with the correct project binding.`
+    );
+  }
+  const trackedIssue = await workflowCommandDependencies.fetchLiveIssue(
+    {
+      projectId: githubProjectId,
+      token: auth.token,
+      apiUrl: selection.projectConfig.tracker.apiUrl,
+      assignedOnly: selection.projectConfig.tracker.settings?.assignedOnly === true,
+      priorityFieldName: typeof selection.projectConfig.tracker.settings?.priorityFieldName === "string" ? selection.projectConfig.tracker.settings.priorityFieldName : void 0,
+      timeoutMs: typeof selection.projectConfig.tracker.settings?.timeoutMs === "number" ? selection.projectConfig.tracker.settings.timeoutMs : void 0
+    },
+    {
+      owner: issue.owner,
+      name: issue.name
+    },
+    issue.number
+  );
+  if (!trackedIssue) {
+    throw new Error(
+      `Issue ${issue.identifier} is not in the configured GitHub Project "${detail.title}". Add the issue to the project and re-run the preview.`
+    );
+  }
+  return {
+    issue: trackedIssue,
+    sampleSource: `live:${trackedIssue.identifier}`
+  };
+}
 function validateWorkflow(workflowPath, markdown) {
   const workflow = parseWorkflowMarkdown(markdown);
   const promptFreshVariables = buildPromptVariables(SAMPLE_ISSUE, {
@@ -420,9 +574,19 @@ async function runValidate(args, options) {
 }
 async function runPreview(args, options) {
   const flags = parsePreviewFlags(args);
+  if (flags.sample && flags.issue) {
+    throw new Error(
+      "Options '--sample' and '--issue' cannot be used together."
+    );
+  }
   const { workflowPath, markdown } = await loadWorkflowMarkdown(flags.file);
   const workflow = parseWorkflowMarkdown(markdown);
-  const { issue, sampleSource } = await loadSampleIssue(flags.sample);
+  if (flags.issue && workflow.tracker.kind !== "github-project") {
+    throw new Error(
+      "Live issue preview requires 'tracker.kind: github-project' in WORKFLOW.md."
+    );
+  }
+  const { issue, sampleSource } = flags.issue ? await loadLiveIssue(flags.issue, flags.projectId, options) : await loadSampleIssue(flags.sample);
   const variables = buildPromptVariables(issue, {
     attempt: flags.attempt
   });
@@ -493,5 +657,7 @@ var handler = async (args, options) => {
 };
 var workflow_default = handler;
 export {
-  workflow_default as default
+  workflow_default as default,
+  resetWorkflowCommandDependenciesForTest,
+  setWorkflowCommandDependenciesForTest
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gh-symphony/cli",
-  "version": "0.0.19",
+  "version": "0.0.21",
   "license": "MIT",
   "author": "hojinzs",
   "description": "Interactive CLI for GitHub Symphony orchestration",
@@ -41,11 +41,13 @@
   },
   "devDependencies": {
     "tsup": "^8.5.1",
+    "@gh-symphony/control-plane": "0.0.14",
     "@gh-symphony/core": "0.0.14",
     "@gh-symphony/orchestrator": "0.0.14",
     "@gh-symphony/dashboard": "0.0.14",
-    "@gh-symphony/worker": "0.0.14",
-    "@gh-symphony/tracker-github": "0.0.14"
+    "@gh-symphony/runtime-claude": "0.0.14",
+    "@gh-symphony/tracker-github": "0.0.14",
+    "@gh-symphony/worker": "0.0.14"
   },
   "scripts": {
     "build": "tsup",