@gh-symphony/cli 0.2.0 → 0.2.3

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

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   workflow_init_default
-} from "./chunk-F46FTZJE.js";
+} from "./chunk-PLBG7TZA.js";
 import {
   fetchGithubProjectIssueByRepositoryAndNumber,
   inspectManagedProjectSelection,
   resolveTrackerAdapter
-} from "./chunk-CTTFIZYG.js";
+} from "./chunk-ZGNAAHLD.js";
 import {
   GitHubApiError,
   createClient,
@@ -14,19 +14,198 @@ import {
   getGhTokenWithSource,
   getProjectDetail,
   validateGitHubToken
-} from "./chunk-Z3NZOPLZ.js";
+} from "./chunk-BOM2BYZQ.js";
 import {
   buildPromptVariables,
   parseWorkflowMarkdown,
   renderPrompt
-} from "./chunk-Q3UEPUE3.js";
+} from "./chunk-3SKN5L3I.js";
 import {
   loadActiveProjectConfig
-} from "./chunk-WOVNN5NW.js";
+} from "./chunk-4ICDSQCJ.js";
 
 // src/commands/workflow.ts
 import { readFile } from "fs/promises";
 import { resolve } from "path";
+
+// src/priority-diagnostics.ts
+function buildPriorityConfigDiagnostics(workflow) {
+  const diagnostics = [];
+  if (workflow.tracker.priorityFieldName) {
+    if (workflow.tracker.priority) {
+      diagnostics.push({
+        title: "Priority mapping precedence",
+        summary: "Both legacy tracker.priority_field and explicit tracker.priority are configured; explicit tracker.priority wins.",
+        remediation: "Remove tracker.priority_field after confirming the explicit tracker.priority mapping is correct.",
+        details: {
+          priorityFieldName: workflow.tracker.priorityFieldName,
+          explicitSource: workflow.tracker.priority.source
+        }
+      });
+    } else {
+      diagnostics.push({
+        title: "Legacy priority mapping",
+        summary: "tracker.priority_field is deprecated and still supported with legacy Project option-order semantics.",
+        remediation: "Migrate to tracker.priority with an explicit project-field, labels, or disabled source.",
+        details: {
+          priorityFieldName: workflow.tracker.priorityFieldName
+        }
+      });
+    }
+  }
+  return diagnostics;
+}
+function buildPriorityDriftDiagnostics(input) {
+  const priority = input.workflow.tracker.priority;
+  if (!priority || priority.source === "disabled") {
+    return [];
+  }
+  if (priority.source === "project-field") {
+    return buildProjectFieldDriftDiagnostics({
+      priority,
+      projectDetail: input.projectDetail,
+      activeIssues: input.activeIssues
+    });
+  }
+  return buildLabelDriftDiagnostics({
+    priority,
+    repositoryLabels: input.repositoryLabels,
+    activeIssues: input.activeIssues
+  });
+}
+function buildProjectFieldDriftDiagnostics(input) {
+  const diagnostics = [];
+  const field = input.projectDetail.statusFields.find(
+    (candidate) => candidate.name === input.priority.field
+  );
+  if (!field) {
+    diagnostics.push({
+      title: "Priority Project field drift",
+      summary: `Configured priority field "${input.priority.field}" was not found in the GitHub Project schema.`,
+      remediation: "Update tracker.priority.field to the exact live Project V2 single-select field name, or disable priority mapping.",
+      details: {
+        field: input.priority.field,
+        availableFields: input.projectDetail.statusFields.map(
+          (candidate) => candidate.name
+        )
+      }
+    });
+    return diagnostics;
+  }
+  const liveOptions = new Set(field.options.map((option) => option.name));
+  const mappedOptions = new Set(Object.keys(input.priority.values));
+  const unmappedLiveOptions = [...liveOptions].filter(
+    (option) => !mappedOptions.has(option)
+  );
+  const missingConfiguredOptions = [...mappedOptions].filter(
+    (option) => !liveOptions.has(option)
+  );
+  if (unmappedLiveOptions.length > 0) {
+    diagnostics.push({
+      title: "Unmapped priority Project options",
+      summary: `Priority field "${field.name}" has live option(s) not mapped in tracker.priority.values: ${unmappedLiveOptions.join(", ")}.`,
+      remediation: "Add explicit numeric mappings for these options or accept that issues holding them resolve to priority = null.",
+      details: { field: field.name, unmappedLiveOptions }
+    });
+  }
+  if (missingConfiguredOptions.length > 0) {
+    diagnostics.push({
+      title: "Missing priority Project options",
+      summary: `tracker.priority.values references option(s) that do not exist in priority field "${field.name}": ${missingConfiguredOptions.join(", ")}.`,
+      remediation: "Rename the mapping keys to match live Project option display names or remove stale mappings.",
+      details: { field: field.name, missingConfiguredOptions }
+    });
+  }
+  const activeUnmapped = input.activeIssues.flatMap((issue) => {
+    const rawValue = issue.metadata?.[field.name];
+    return typeof rawValue === "string" && rawValue.length > 0 && !mappedOptions.has(rawValue) ? [{ issue: issue.identifier, value: rawValue }] : [];
+  });
+  if (activeUnmapped.length > 0) {
+    diagnostics.push({
+      title: "Active issues with unmapped priority values",
+      summary: `Active issue(s) currently hold unmapped "${field.name}" value(s); they resolve to priority = null.`,
+      remediation: "Map the live value in tracker.priority.values, change the issue value, or leave it unmapped intentionally.",
+      details: { field: field.name, activeUnmapped }
+    });
+  }
+  return diagnostics;
+}
+function buildLabelDriftDiagnostics(input) {
+  const diagnostics = [];
+  const configuredLabels = Object.keys(input.priority.labels);
+  if (input.repositoryLabels) {
+    const missingByRepository = input.repositoryLabels.flatMap((snapshot) => {
+      const live = new Set(snapshot.labels);
+      const missing = configuredLabels.filter((label) => !live.has(label));
+      return missing.length > 0 ? [{ repository: snapshot.repository, missing }] : [];
+    });
+    if (missingByRepository.length > 0) {
+      diagnostics.push({
+        title: "Missing configured priority labels",
+        summary: "One or more configured tracker.priority.labels entries are absent from linked repositories.",
+        remediation: "Create the labels in each linked repository, rename the mapping keys to exact live labels, or remove stale mappings.",
+        details: { missingByRepository }
+      });
+    }
+    const liveLabels = new Set(
+      input.repositoryLabels.flatMap((snapshot) => snapshot.labels)
+    );
+    const missingEverywhere = configuredLabels.filter(
+      (label) => !liveLabels.has(label)
+    );
+    if (missingEverywhere.length > 0) {
+      diagnostics.push({
+        title: "Stale priority label mappings",
+        summary: `tracker.priority.labels references label(s) that do not exist in any linked repository: ${missingEverywhere.join(", ")}.`,
+        remediation: "Rename the mapping keys to exact live labels, create those labels, or remove stale mappings.",
+        details: { missingEverywhere }
+      });
+    }
+  }
+  const configuredLabelByNormalized = new Map(
+    configuredLabels.map((label) => [normalizeLabelForComparison(label), label])
+  );
+  const activeConflicts = input.activeIssues.flatMap((issue) => {
+    const matches = issue.labels.flatMap((label) => {
+      const configuredLabel = configuredLabelByNormalized.get(
+        normalizeLabelForComparison(label)
+      );
+      return configuredLabel ? [configuredLabel] : [];
+    });
+    return matches.length > 1 ? [{ issue: issue.identifier, labels: matches }] : [];
+  });
+  if (activeConflicts.length > 0) {
+    diagnostics.push({
+      title: "Active issues with multiple priority labels",
+      summary: "Active issue(s) have multiple configured priority labels; runtime chooses the lowest numeric value and emits priority.label_conflict_resolved.",
+      remediation: "Remove extra priority labels from the issue if only one priority label should apply.",
+      details: { activeConflicts }
+    });
+  }
+  const activeUnmapped = input.activeIssues.flatMap((issue) => {
+    const labels = issue.labels.filter(
+      (label) => isPriorityLikeLabel(label) && !configuredLabelByNormalized.has(normalizeLabelForComparison(label))
+    );
+    return labels.length > 0 ? [{ issue: issue.identifier, labels }] : [];
+  });
+  if (activeUnmapped.length > 0) {
+    diagnostics.push({
+      title: "Active issues with unmapped priority labels",
+      summary: "Active issue(s) have priority-like labels not mapped by tracker.priority.labels; those labels do not affect dispatch priority.",
+      remediation: "Add explicit mappings for these labels, rename the issue labels, or leave them unmapped intentionally.",
+      details: { activeUnmapped }
+    });
+  }
+  return diagnostics;
+}
+function isPriorityLikeLabel(label) {
+  return /^(p\d+|priority[:/\s_-].+|prio[:/\s_-].+)$/i.test(label.trim());
+}
+function normalizeLabelForComparison(label) {
+  return label.trim().toLowerCase();
+}
+
+// src/commands/workflow.ts
 var SAMPLE_ISSUE = {
   id: "issue-157-sample",
   identifier: "octo/hello-world#157",
@@ -416,7 +595,7 @@ function renderIssueWorkflowPreview(input) {
 function formatAuthError(error) {
   return `GitHub authentication is required for live issue preview. ${error.message}`;
 }
-async function loadLiveIssue(issueReference, projectId, options) {
+async function loadLiveIssue(issueReference, projectId, workflow, options) {
   const issue = parseIssueReference(issueReference);
   const selection = await workflowCommandDependencies.resolveManagedProjectSelection({
     configDir: options.configDir,
@@ -470,6 +649,7 @@ async function loadLiveIssue(issueReference, projectId, options) {
       token: auth.token,
       apiUrl: selection.projectConfig.tracker.apiUrl,
       assignedOnly: selection.projectConfig.tracker.settings?.assignedOnly === true,
+      priority: workflow.tracker.priority,
       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
     },
@@ -564,6 +744,7 @@ function validateWorkflow(workflowPath, markdown) {
       promptRetry: "pass",
       continuationGuidance: continuationGuidanceStatus
     },
+    warnings: buildPriorityConfigDiagnostics(workflow),
     summary: {
       trackerKind: workflow.tracker.kind,
       githubProjectId: workflow.githubProjectId,
@@ -634,6 +815,17 @@ Hooks
   before_remove=${report.summary.hooks.beforeRemove ?? "unset"}
   hooks.timeout_ms=${report.summary.hooks.timeoutMs}
 `);
+  if (report.warnings.length > 0) {
+    process.stdout.write("\nWarnings\n");
+    for (const warning of report.warnings) {
+      process.stdout.write(`  ${warning.title}: ${warning.summary}
+`);
+      if (warning.remediation) {
+        process.stdout.write(`    Fix: ${warning.remediation}
+`);
+      }
+    }
+  }
 }
 async function runValidate(args, options) {
   const flags = parseValidateFlags(args);
@@ -660,7 +852,7 @@ async function runPreview(args, options) {
       "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 ? workflow.tracker.kind === "linear" ? await loadLinearIssue(flags.issue, workflow, options) : 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, workflow, options) : await loadSampleIssue(flags.sample);
   const renderedPrompt = renderIssueWorkflowPreview({
     workflow,
     issue,
@@ -731,6 +923,8 @@ var handler = async (args, options) => {
 var workflow_default = handler;
 
 export {
+  buildPriorityConfigDiagnostics,
+  buildPriorityDriftDiagnostics,
   setWorkflowCommandDependenciesForTest,
   resetWorkflowCommandDependenciesForTest,
   parseIssueReference,

package/dist/{chunk-Z3NZOPLZ.js → chunk-BOM2BYZQ.js}

@@ -32,6 +32,48 @@ function createClient(token, options) {
     fetchImpl: options?.fetchImpl ?? fetch
   };
 }
+async function listRepositoryLabels(client, owner, name) {
+  const restUrl = client.apiUrl.replace("/graphql", "");
+  const baseUrl = restUrl === client.apiUrl ? REST_API_URL : restUrl;
+  const labels = [];
+  let page = 1;
+  while (true) {
+    const response = await client.fetchImpl(
+      `${baseUrl}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(name)}/labels?per_page=100&page=${page}`,
+      {
+        headers: {
+          authorization: `Bearer ${client.token}`,
+          accept: "application/vnd.github+json"
+        }
+      }
+    );
+    if (!response.ok) {
+      const payload = await response.json().catch(() => null);
+      const message = payload?.message?.trim() || response.statusText;
+      throw new GitHubApiError(
+        `GitHub label lookup failed for ${owner}/${name}: ${response.status} ${message}`.trim(),
+        response.status
+      );
+    }
+    const pageLabels = await response.json();
+    labels.push(
+      ...pageLabels.flatMap(
+        (label) => typeof label.name === "string" ? [
+          {
+            name: label.name,
+            color: label.color ?? null,
+            description: label.description ?? null
+          }
+        ] : []
+      )
+    );
+    if (pageLabels.length < 100) {
+      break;
+    }
+    page += 1;
+  }
+  return labels;
+}
 async function validateToken(client) {
   const restUrl = client.apiUrl.replace("/graphql", "");
   const baseUrl = restUrl === client.apiUrl ? REST_API_URL : restUrl;
@@ -739,6 +781,7 @@ export {
   GitHubApiError,
   GitHubScopeError,
   createClient,
+  listRepositoryLabels,
   validateToken,
   checkRequiredScopes,
   discoverUserProjects,

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

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   resolveRepoRuntimeRoot
-} from "./chunk-6I753NYO.js";
+} from "./chunk-RZ3WO7OV.js";
 import {
   parseWorkflowMarkdown
-} from "./chunk-Q3UEPUE3.js";
+} from "./chunk-3SKN5L3I.js";
 import {
   saveGlobalConfig,
   saveProjectConfig
-} from "./chunk-WOVNN5NW.js";
+} from "./chunk-4ICDSQCJ.js";
 
 // src/repo-runtime.ts
 import { execFileSync } from "child_process";
@@ -68,8 +68,8 @@ async function initRepoRuntime(flags) {
     ...trackerAdapter === "linear" ? { activeStates: workflow.tracker.activeStates.join("\n") } : {},
     repository: `${repository.owner}/${repository.name}`
   };
-  if (flags.assignedOnly) {
-    trackerSettings.assignedOnly = true;
+  if (workflow.tracker.priorityFieldName) {
+    trackerSettings.priorityFieldName = workflow.tracker.priorityFieldName;
   }
   if (trackerAdapter === "file") {
     if (!process.env.GH_SYMPHONY_FILE_TRACKER_ISSUES_PATH) {
@@ -89,6 +89,7 @@ async function initRepoRuntime(flags) {
       adapter: trackerAdapter,
       bindingId: trackerBindingId,
       ...workflow.tracker.endpoint ? { apiUrl: workflow.tracker.endpoint } : {},
+      priority: workflow.tracker.priority,
       settings: trackerSettings
     }
   };

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

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