@gh-symphony/cli 0.1.4 → 0.2.2

package/dist/{chunk-RHLUIMBN.js → chunk-PLBG7TZA.js}

@@ -7,15 +7,16 @@ import {
   discoverUserProjects,
   getGhTokenWithSource,
   getProjectDetail,
+  listRepositoryLabels,
   listUserProjects,
   resolveGitHubAuth,
   validateToken
-} from "./chunk-Z3NZOPLZ.js";
+} from "./chunk-BOM2BYZQ.js";
 import {
   formatClaudePreflightText,
   resolveClaudeCommandBinary,
   runClaudePreflight
-} from "./chunk-EWTMSDCE.js";
+} from "./chunk-3SKN5L3I.js";
 
 // src/mapping/smart-defaults.ts
 var ROLE_PATTERNS = [
@@ -347,9 +348,7 @@ function buildFrontMatter(input) {
   lines.push("  kind: github-project");
   lines.push(`  project_id: ${input.projectId}`);
   lines.push(`  state_field: ${input.stateFieldName}`);
-  if (input.priorityFieldName) {
-    lines.push(`  priority_field: ${input.priorityFieldName}`);
-  }
+  lines.push(...buildPriorityFrontMatter(input));
   if (input.lifecycle.activeStates.length > 0) {
     lines.push("  active_states:");
     for (const state of input.lifecycle.activeStates) {
@@ -381,6 +380,67 @@ function buildFrontMatter(input) {
   lines.push(...buildRuntimeFrontMatter(input.runtime));
   return lines.join("\n") + "\n";
 }
+function buildPriorityFrontMatter(input) {
+  const lines = [];
+  if (!input.priority) {
+    return lines;
+  }
+  if (input.priority.source === "disabled") {
+    lines.push(
+      "  # Priority dispatch is disabled until an operator chooses one explicit source."
+    );
+  } else {
+    lines.push(
+      "  # Priority is explicit. Numbers below are editable policy (lower = higher priority)."
+    );
+  }
+  lines.push(
+    "  # See docs/adr/2026-05-18_explicit-dispatch-priority-mappings.md"
+  );
+  lines.push("  priority:");
+  if (input.priority.source === "project-field") {
+    lines.push("    source: project-field");
+    lines.push(`    field: ${formatYamlScalar(input.priority.field)}`);
+    lines.push("    values:");
+    for (const [name, value] of Object.entries(input.priority.values)) {
+      lines.push(`      ${formatYamlKey(name)}: ${value}`);
+    }
+    return lines;
+  }
+  if (input.priority.source === "labels") {
+    lines.push("    source: labels");
+    lines.push("    labels:");
+    for (const [name, value] of Object.entries(input.priority.labels)) {
+      lines.push(`      ${formatYamlKey(name)}: ${value}`);
+    }
+    return lines;
+  }
+  lines.push("    source: disabled");
+  if (input.includePriorityTemplates) {
+    lines.push("");
+    lines.push("  # Optional template: project-field priority source.");
+    lines.push("  # priority:");
+    lines.push("  #   source: project-field");
+    lines.push("  #   field: Priority");
+    lines.push("  #   values:");
+    lines.push("  #     Urgent: 0");
+    lines.push("  #     High: 1");
+    lines.push("");
+    lines.push("  # Optional template: labels priority source.");
+    lines.push("  # priority:");
+    lines.push("  #   source: labels");
+    lines.push("  #   labels:");
+    lines.push("  #     P0: 0");
+    lines.push("  #     P1: 1");
+  }
+  return lines;
+}
+function formatYamlScalar(value) {
+  return JSON.stringify(value);
+}
+function formatYamlKey(value) {
+  return JSON.stringify(value);
+}
 function buildPromptBody(input) {
   const statusMap = generateStatusMapWithDescriptions(input.mappings);
   const validationGuidance = buildRepositoryValidationGuidance(
@@ -917,11 +977,7 @@ function generateReferenceWorkflow(input) {
   lines.push("  kind: github-project");
   lines.push(`  project_id: ${input.projectId}`);
   lines.push("  state_field: Status");
-  if (input.priorityFieldName) {
-    lines.push(`  priority_field: ${input.priorityFieldName}`);
-  } else {
-    lines.push("  # priority_field: Priority");
-  }
+  lines.push(...buildReferencePriorityLines(input.priority));
   lines.push("");
   const activeColumns = input.statusColumns.filter((c) => c.role === "active");
   const waitColumns = input.statusColumns.filter((c) => c.role === "wait");
@@ -952,6 +1008,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("");
@@ -1210,6 +1282,58 @@ function generateReferenceWorkflow(input) {
   lines.push("");
   return lines.join("\n");
 }
+function buildReferencePriorityLines(priority) {
+  const lines = [];
+  if (priority?.source === "project-field" || priority?.source === "labels") {
+    lines.push(
+      "  # Priority is explicit. Numbers below are editable policy (lower = higher priority)."
+    );
+  } else {
+    lines.push(
+      "  # Priority dispatch is disabled until an operator chooses one explicit source."
+    );
+  }
+  lines.push(
+    "  # See docs/adr/2026-05-18_explicit-dispatch-priority-mappings.md"
+  );
+  if (priority?.source === "project-field") {
+    lines.push("  priority:");
+    lines.push("    source: project-field");
+    lines.push(`    field: ${JSON.stringify(priority.field)}`);
+    lines.push("    values:");
+    for (const [name, value] of Object.entries(priority.values)) {
+      lines.push(`      ${JSON.stringify(name)}: ${value}`);
+    }
+    return lines;
+  }
+  if (priority?.source === "labels") {
+    lines.push("  priority:");
+    lines.push("    source: labels");
+    lines.push("    labels:");
+    for (const [name, value] of Object.entries(priority.labels)) {
+      lines.push(`      ${JSON.stringify(name)}: ${value}`);
+    }
+    return lines;
+  }
+  lines.push("  priority:");
+  lines.push("    source: disabled");
+  lines.push("");
+  lines.push("  # Optional template: project-field priority source.");
+  lines.push("  # priority:");
+  lines.push("  #   source: project-field");
+  lines.push("  #   field: Priority");
+  lines.push("  #   values:");
+  lines.push("  #     Urgent: 0");
+  lines.push("  #     High: 1");
+  lines.push("");
+  lines.push("  # Optional template: labels priority source.");
+  lines.push("  # priority:");
+  lines.push("  #   source: labels");
+  lines.push("  #   labels:");
+  lines.push("  #     P0: 0");
+  lines.push("  #     P1: 1");
+  return lines;
+}
 function resolveRoleAction(role) {
   switch (role) {
     case "active":
@@ -2021,6 +2145,35 @@ function resolvePriorityField(projectDetail, statusField) {
   }
   return { field: null, ambiguous: [] };
 }
+function buildProjectFieldPriority(field) {
+  return {
+    source: "project-field",
+    field: field.name,
+    values: Object.fromEntries(
+      field.options.map((option, index) => [option.name, index])
+    )
+  };
+}
+function buildDisabledPriority() {
+  return { source: "disabled" };
+}
+async function collectPriorityLabelNames(client, repositories) {
+  const labels = /* @__PURE__ */ new Set();
+  for (const repository of repositories) {
+    try {
+      const repoLabels = await listRepositoryLabels(
+        client,
+        repository.owner,
+        repository.name
+      );
+      for (const label of repoLabels) {
+        labels.add(label.name);
+      }
+    } catch {
+    }
+  }
+  return [...labels].sort((a, b) => a.localeCompare(b));
+}
 async function promptPriorityField(priorityCandidates, options) {
   if (priorityCandidates.length === 0) {
     return null;
@@ -2037,7 +2190,7 @@ async function promptPriorityField(priorityCandidates, options) {
         {
           value: "__skip_priority_field__",
           label: "Skip priority-aware dispatch",
-          hint: "Leave tracker.priority_field unset"
+          hint: "Write source: disabled"
         }
       ]
     })
@@ -2047,6 +2200,97 @@ async function promptPriorityField(priorityCandidates, options) {
   }
   return priorityCandidates.find((field) => field.id === selectedFieldId) ?? null;
 }
+async function promptProjectFieldPriorityValues(field) {
+  const values = {};
+  for (const [index, option] of field.options.entries()) {
+    const rawValue = await abortIfCancelled(
+      p.text({
+        message: `Priority value for option "${option.name}"`,
+        placeholder: String(index),
+        initialValue: String(index),
+        validate: validatePriorityInteger
+      })
+    );
+    values[option.name] = Number(rawValue);
+  }
+  return values;
+}
+async function promptPriorityConfig(input) {
+  const hasProjectField = Boolean(input.priorityResolution.field) || input.priorityResolution.ambiguous.length > 0;
+  const hasLabels = input.labelNames.length > 0;
+  const selectedSource = await abortIfCancelled(
+    p.select({
+      message: `${input.stepLabel ?? "Priority"} \u2014 Choose one priority source:`,
+      options: [
+        ...hasProjectField ? [
+          {
+            value: "project-field",
+            label: "GitHub Project field",
+            hint: "Map single-select options to explicit numbers"
+          }
+        ] : [],
+        ...hasLabels ? [
+          {
+            value: "labels",
+            label: "GitHub labels",
+            hint: "Map existing repository labels to explicit numbers"
+          }
+        ] : [],
+        {
+          value: "disabled",
+          label: "Disabled",
+          hint: "Write source: disabled"
+        }
+      ]
+    })
+  );
+  if (selectedSource === "disabled") {
+    return { priority: buildDisabledPriority(), priorityField: null };
+  }
+  if (selectedSource === "labels") {
+    const selectedLabels = await abortIfCancelled(
+      p.multiselect({
+        message: "Select priority labels to map:",
+        options: input.labelNames.map((label) => ({
+          value: label,
+          label
+        })),
+        required: true
+      })
+    );
+    const labels = {};
+    for (const [index, label] of selectedLabels.entries()) {
+      const rawValue = await abortIfCancelled(
+        p.text({
+          message: `Priority value for label "${label}"`,
+          placeholder: String(index),
+          initialValue: String(index),
+          validate: validatePriorityInteger
+        })
+      );
+      labels[label] = Number(rawValue);
+    }
+    return { priority: { source: "labels", labels }, priorityField: null };
+  }
+  const priorityField = input.priorityResolution.ambiguous.length > 0 ? await promptPriorityField(input.priorityResolution.ambiguous, {
+    stepLabel: "Priority field"
+  }) : input.priorityResolution.field;
+  if (!priorityField) {
+    return { priority: buildDisabledPriority(), priorityField: null };
+  }
+  return {
+    priority: {
+      source: "project-field",
+      field: priorityField.name,
+      values: await promptProjectFieldPriorityValues(priorityField)
+    },
+    priorityField
+  };
+}
+function validatePriorityInteger(value) {
+  const trimmed = value.trim();
+  return trimmed !== "" && Number.isInteger(Number(trimmed)) ? void 0 : "Enter an integer.";
+}
 async function promptStateMappings(statusField, options) {
   const mappings = {};
   const inferred = inferAllStateRoles(statusField.options.map((o) => o.name));
@@ -2076,10 +2320,12 @@ async function promptStateMappings(statusField, options) {
 }
 async function planWorkflowArtifacts(opts) {
   const environment = opts.environment ?? await detectEnvironment(opts.cwd);
+  const priority = opts.priority ?? (opts.priorityField ? buildProjectFieldPriority(opts.priorityField) : buildDisabledPriority());
   const workflowMd = generateWorkflowMarkdown({
     projectId: opts.projectDetail.id,
     stateFieldName: opts.statusField.name,
-    priorityFieldName: opts.priorityField?.name ?? null,
+    priority,
+    includePriorityTemplates: opts.includePriorityTemplates ?? priority.source === "disabled",
     mappings: opts.mappings,
     lifecycle: toWorkflowLifecycleConfig(opts.statusField.name, opts.mappings),
     runtime: opts.runtime,
@@ -2096,6 +2342,8 @@ async function planWorkflowArtifacts(opts) {
     projectDetail: opts.projectDetail,
     statusField: opts.statusField,
     priorityField: opts.priorityField,
+    priority,
+    includePriorityTemplates: opts.includePriorityTemplates ?? priority.source === "disabled",
     runtime: opts.runtime,
     skipSkills: opts.skipSkills,
     skipContext: opts.skipContext,
@@ -2130,6 +2378,7 @@ async function planEcosystem(opts) {
     skipSkills,
     skipContext
   } = opts;
+  const priority = opts.priority ?? (priorityField ? buildProjectFieldPriority(priorityField) : buildDisabledPriority());
   const ghSymphonyDir = join3(cwd, ".gh-symphony");
   const environment = opts.environment ?? await detectEnvironment(cwd);
   const files = [];
@@ -2168,7 +2417,7 @@ async function planEcosystem(opts) {
       role: null
     })),
     projectId: projectDetail.id,
-    priorityFieldName: priorityField?.name ?? null,
+    priority,
     detectedEnvironment: environment
   });
   files.push(
@@ -2219,7 +2468,7 @@ async function planEcosystem(opts) {
     projectId: projectDetail.id,
     githubProjectTitle: projectDetail.title,
     runtime,
-    priorityFieldName: priorityField?.name ?? null,
+    priority,
     skillsDir,
     skipSkills,
     environment,
@@ -2268,7 +2517,7 @@ async function writeEcosystem(opts) {
     projectId: plan.projectId,
     githubProjectTitle: plan.githubProjectTitle,
     runtime: plan.runtime,
-    priorityFieldName: plan.priorityFieldName,
+    priority: plan.priority,
     skillsDir: plan.skillsDir,
     skipSkills: plan.skipSkills,
     afterCreateHookWritten,
@@ -2278,6 +2527,23 @@ async function writeEcosystem(opts) {
     skillsSkipped: skillsSkipped.sort()
   };
 }
+function formatPrioritySummaryLines(priority) {
+  if (priority.source === "disabled") {
+    return ["Priority source   disabled"];
+  }
+  if (priority.source === "project-field") {
+    const mapping2 = Object.entries(priority.values).map(([name, value]) => `${name}=${value}`).join(", ");
+    return [
+      "Priority source   project-field",
+      `Priority mapping  ${priority.field}: ${mapping2 || "none"}`
+    ];
+  }
+  const mapping = Object.entries(priority.labels).map(([name, value]) => `${name}=${value}`).join(", ");
+  return [
+    "Priority source   labels",
+    `Priority mapping  ${mapping || "none"}`
+  ];
+}
 function printEcosystemSummary(result, workflowPath, opts) {
   const cwd = process.cwd();
   const relWorkflow = relative(cwd, workflowPath) || "WORKFLOW.md";
@@ -2286,9 +2552,7 @@ function printEcosystemSummary(result, workflowPath, opts) {
     `GitHub Project   ${result.githubProjectTitle}  (${result.projectId})`
   );
   lines.push(`Runtime   ${result.runtime}`);
-  if (result.priorityFieldName) {
-    lines.push(`Priority field   ${result.priorityFieldName}`);
-  }
+  lines.push(...formatPrioritySummaryLines(result.priority));
   lines.push("");
   lines.push("Generated files");
   lines.push(`  \u2713 WORKFLOW.md                          ${relWorkflow}`);
@@ -2342,9 +2606,7 @@ function renderDryRunPreview(workflowPath, workflowPlan, ecosystemPlan) {
     `GitHub Project   ${ecosystemPlan.githubProjectTitle}  (${ecosystemPlan.projectId})`
   );
   lines.push(`Runtime   ${ecosystemPlan.runtime}`);
-  if (ecosystemPlan.priorityFieldName) {
-    lines.push(`Priority field   ${ecosystemPlan.priorityFieldName}`);
-  }
+  lines.push(...formatPrioritySummaryLines(ecosystemPlan.priority));
   lines.push("");
   lines.push("Planned file changes");
   lines.push(
@@ -2372,7 +2634,7 @@ function buildDryRunJsonResult(workflowPath, workflowPlan, ecosystemPlan) {
     projectId: ecosystemPlan.projectId,
     githubProjectTitle: ecosystemPlan.githubProjectTitle,
     runtime: ecosystemPlan.runtime,
-    priorityFieldName: ecosystemPlan.priorityFieldName,
+    priority: ecosystemPlan.priority,
     files: [workflowPlan, ...ecosystemPlan.files].map((file) => ({
       path: file.path,
       label: file.label,
@@ -2460,10 +2722,11 @@ async function runNonInteractive(flags, options) {
   const { field: autoPriorityField, ambiguous: ambiguousPriorityFields } = resolvePriorityField(githubProject, statusField);
   if (ambiguousPriorityFields.length > 0) {
     process.stderr.write(
-      `Warning: Multiple priority-like single-select fields found (${ambiguousPriorityFields.map((field) => `"${field.name}"`).join(", ")}). Skipping tracker.priority_field in non-interactive mode.
+      `Warning: Multiple priority-like single-select fields found (${ambiguousPriorityFields.map((field) => `"${field.name}"`).join(", ")}). Writing disabled priority scaffold in non-interactive mode.
 `
     );
   }
+  const priority = autoPriorityField ? buildProjectFieldPriority(autoPriorityField) : buildDisabledPriority();
   const validation = validateStateMapping(mappings);
   if (!validation.valid) {
     process.stderr.write(
@@ -2481,6 +2744,8 @@ Run without --non-interactive for manual mapping.
     projectDetail: githubProject,
     statusField,
     priorityField: autoPriorityField,
+    priority,
+    includePriorityTemplates: !autoPriorityField,
     mappings,
     runtime,
     skipSkills: flags.skipSkills,
@@ -2504,6 +2769,8 @@ Run without --non-interactive for manual mapping.
     projectDetail: githubProject,
     statusField,
     priorityField: autoPriorityField,
+    priority,
+    includePriorityTemplates: !autoPriorityField,
     runtime,
     skipSkills: flags.skipSkills,
     skipContext: flags.skipContext
@@ -2610,15 +2877,18 @@ async function runInteractiveStandalone(flags, _options) {
     return;
   }
   const priorityResolution = resolvePriorityField(projectDetail, statusField);
+  const priorityLabelNames = await collectPriorityLabelNames(
+    client,
+    projectDetail.linkedRepositories
+  );
   const mappings = await promptStateMappings(statusField, {
-    stepLabel: priorityResolution.ambiguous.length > 0 ? "Step 3/4" : "Step 3/3"
+    stepLabel: "Step 3/4"
+  });
+  const { priority, priorityField } = await promptPriorityConfig({
+    priorityResolution,
+    labelNames: priorityLabelNames,
+    stepLabel: "Step 4/4"
   });
-  let priorityField = priorityResolution.field;
-  if (priorityResolution.ambiguous.length > 0) {
-    priorityField = await promptPriorityField(priorityResolution.ambiguous, {
-      stepLabel: "Step 4/4"
-    });
-  }
   const validation = validateStateMapping(mappings);
   if (!validation.valid) {
     p.log.error("Mapping validation failed:");
@@ -2638,6 +2908,8 @@ async function runInteractiveStandalone(flags, _options) {
     projectDetail,
     statusField,
     priorityField,
+    priority,
+    includePriorityTemplates: priority.source === "disabled",
     mappings,
     runtime,
     skipSkills: flags.skipSkills,
@@ -2653,6 +2925,8 @@ async function runInteractiveStandalone(flags, _options) {
     projectDetail,
     statusField,
     priorityField,
+    priority,
+    includePriorityTemplates: priority.source === "disabled",
     runtime,
     skipSkills: flags.skipSkills,
     skipContext: flags.skipContext
@@ -2670,6 +2944,8 @@ export {
   resolveStatusField,
   buildAutomaticStateMappings,
   resolvePriorityField,
+  collectPriorityLabelNames,
+  promptPriorityConfig,
   promptStateMappings,
   planWorkflowArtifacts,
   writeWorkflowPlan,

package/dist/{chunk-6I753NYO.js → chunk-RZ3WO7OV.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   REPO_RUNTIME_DIR
-} from "./chunk-WOVNN5NW.js";
+} from "./chunk-4ICDSQCJ.js";
 
 // src/orchestrator-runtime.ts
 import { resolve } from "path";