@craftsamo/github-tools 0.6.0 → 0.7.0

package/dist/cli.js

@@ -20586,11 +20586,18 @@ function listOf(names) {
   return names.length > 0 ? names.map((name) => `"${name}"`).join(", ") : "none";
 }
 function settableNames(fields) {
-  return listOf(fields.filter((field) => isSettable(field.type)).map((field) => field.name));
+  return listOf(fields.filter((field) => isSettable(field.type) && !field.issue_field).map((field) => field.name));
 }
-function settableField(fields, name) {
+function settableField(fields, name, action = "set") {
   const field = fields.find((candidate) => sameTitle(candidate.name, name));
   if (!field) throw invalid3(`The board has no field "${name}". Fields that can be set: ${settableNames(fields)}.`);
+  if (field.issue_field) {
+    const verb = action === "clear" ? "cleared" : "set";
+    const fix = action === "clear" ? "Clear it with clear_issue_fields in github_issue_edit." : "Set it with issue_fields in github_issue_edit or github_issue_create.";
+    throw invalid3(
+      `"${field.name}" mirrors the organization's issue field; its value is the issue's own and cannot be ${verb} on a board. ${fix} Fields that can be set: ${settableNames(fields)}.`
+    );
+  }
   if (!isSettable(field.type)) {
     const hint = ISSUE_FIELD_TYPES.includes(field.type) ? " github_issue_edit sets assignees, labels and milestone on the issue." : "";
     throw invalid3(
@@ -20670,7 +20677,7 @@ function planValue(field, value, now) {
 function planFieldValues(fields, values, now = /* @__PURE__ */ new Date()) {
   const writes = [];
   for (const [name, value] of Object.entries(values)) {
-    const field = settableField(fields, name);
+    const field = settableField(fields, name, "set");
     if (writes.some((write) => write.field.id === field.id)) {
       throw invalid3(`fields names "${field.name}" twice; field names are matched without regard to case.`);
     }
@@ -20681,7 +20688,7 @@ function planFieldValues(fields, values, now = /* @__PURE__ */ new Date()) {
 function planClears(fields, names) {
   const cleared = [];
   for (const name of names) {
-    const field = settableField(fields, name);
+    const field = settableField(fields, name, "clear");
     if (!cleared.some((each) => each.id === field.id)) cleared.push(field);
   }
   return cleared;
@@ -20696,38 +20703,43 @@ function isHeld(write, current) {
 
 // src/core/github/issue-fields.ts
 var issueFieldValuesSchema = external_exports.record(external_exports.string(), external_exports.union([external_exports.string(), external_exports.number(), external_exports.array(external_exports.string())]));
-var ISSUE_FIELD_VALUES_FRAGMENT = "issueFieldValues(first:25){nodes{__typename ... on IssueFieldValueCommon{field{... on IssueFieldCommon{name}}} ... on IssueFieldTextValue{value} ... on IssueFieldNumberValue{value} ... on IssueFieldDateValue{value} ... on IssueFieldSingleSelectValue{name} ... on IssueFieldMultiSelectValue{options{name}}}}";
+var ISSUE_FIELD_VALUE_SELECTION = "__typename ... on IssueFieldTextValue{value} ... on IssueFieldNumberValue{value} ... on IssueFieldDateValue{value} ... on IssueFieldSingleSelectValue{name} ... on IssueFieldMultiSelectValue{options{name}}";
+var ISSUE_FIELD_VALUES_FRAGMENT = `issueFieldValues(first:25){nodes{... on IssueFieldValueCommon{field{... on IssueFieldCommon{name}}} ${ISSUE_FIELD_VALUE_SELECTION}}}`;
+function issueFieldValueOf(node2) {
+  if (!node2) return void 0;
+  switch (node2.__typename) {
+    case "IssueFieldTextValue":
+      return typeof node2.value === "string" ? node2.value : void 0;
+    case "IssueFieldNumberValue":
+      return typeof node2.value === "number" && !Number.isNaN(node2.value) ? node2.value : void 0;
+    case "IssueFieldDateValue":
+      return typeof node2.value === "string" ? node2.value : void 0;
+    case "IssueFieldSingleSelectValue":
+      return typeof node2.name === "string" ? node2.name : void 0;
+    case "IssueFieldMultiSelectValue": {
+      const options = (node2.options ?? []).map((opt) => opt?.name).filter((name) => typeof name === "string");
+      return options.length > 0 ? options : void 0;
+    }
+    default:
+      return void 0;
+  }
+}
 function issueFieldValues(connection) {
   const values = {};
   for (const node2 of connection?.nodes ?? []) {
     if (!node2) continue;
     const fieldName = node2.field?.name?.trim();
     if (!fieldName) continue;
-    switch (node2.__typename) {
-      case "IssueFieldTextValue":
-        if (typeof node2.value === "string") values[fieldName] = node2.value;
-        break;
-      case "IssueFieldNumberValue":
-        if (typeof node2.value === "number" && !Number.isNaN(node2.value)) values[fieldName] = node2.value;
-        break;
-      case "IssueFieldDateValue":
-        if (typeof node2.value === "string") values[fieldName] = node2.value;
-        break;
-      case "IssueFieldSingleSelectValue":
-        if (typeof node2.name === "string") values[fieldName] = node2.name;
-        break;
-      case "IssueFieldMultiSelectValue": {
-        const options = (node2.options ?? []).map((opt) => opt?.name).filter((name) => typeof name === "string");
-        if (options.length > 0) values[fieldName] = options;
-        break;
-      }
-    }
+    const val = issueFieldValueOf(node2);
+    if (val !== void 0) values[fieldName] = val;
   }
   return values;
 }
 var SCHEMA_ERROR_PATTERNS = [
   /issueFieldValues.*(?:doesn['’]t exist on type|is not defined on type).*['"`]?Issue['"`]?/i,
-  /issueFields.*(?:doesn['’]t exist on type|is not defined on type).*['"`]?Repository['"`]?/i
+  /issueFields.*(?:doesn['’]t exist on type|is not defined on type).*['"`]?(?:Repository|Organization)['"`]?/i,
+  /(?:isIssueField|issueField).*(?:doesn['’]t exist on type|is not defined on type).*['"`]?ProjectV2/i,
+  /(?:No such type\s+['"`]?(?:ProjectV2ItemIssueFieldValue|ProjectV2IssueFieldValues)['"`]?|(?:ProjectV2ItemIssueFieldValue|ProjectV2IssueFieldValues).*(?:doesn['’]t exist|is not defined))/i
 ];
 function matchesSchemaError(text) {
   return SCHEMA_ERROR_PATTERNS.some((pattern) => pattern.test(text));
@@ -20744,7 +20756,9 @@ function isIssueFieldsMissingError(error62) {
 var issueFieldInputSchema = issueFieldValuesSchema;
 var ISSUE_FIELDS_ARGUMENT = `The organization's issue fields to set, by field name (without regard to case): {"Priority": "High", "Target date": "2026-12-01"}. Each takes a text, a number, a date as YYYY-MM-DD, an option name, or a list of option names for a multi-select field.`;
 var MAX_ISSUE_FIELDS = 25;
-var DEFINITIONS_QUERY = `query($owner:String!,$name:String!){repository(owner:$owner,name:$name){issueFields(first:${MAX_ISSUE_FIELDS}){nodes{__typename ... on IssueFieldCommon{name dataType} ... on IssueFieldText{id} ... on IssueFieldNumber{id} ... on IssueFieldDate{id} ... on IssueFieldSingleSelect{id options{id name}} ... on IssueFieldMultiSelect{id options{id name}}}}}}`;
+var DEFINITION_SELECTION = "__typename ... on IssueFieldCommon{name dataType} ... on IssueFieldText{id} ... on IssueFieldNumber{id} ... on IssueFieldDate{id} ... on IssueFieldSingleSelect{id options{id name}} ... on IssueFieldMultiSelect{id options{id name}}";
+var DEFINITIONS_QUERY = `query($owner:String!,$name:String!){repository(owner:$owner,name:$name){issueFields(first:${MAX_ISSUE_FIELDS}){nodes{${DEFINITION_SELECTION}}}}}`;
+var ORGANIZATION_DEFINITIONS_QUERY = `query($login:String!){repositoryOwner(login:$login){__typename ... on Organization{issueFields(first:${MAX_ISSUE_FIELDS}){nodes{${DEFINITION_SELECTION}}}}}}`;
 var VALUES_QUERY = `query($id:ID!){node(id:$id){... on Issue{${ISSUE_FIELD_VALUES_FRAGMENT}}}}`;
 var issueFieldTypes = {
   TEXT: "text",
@@ -20780,6 +20794,20 @@ async function readIssueFieldDefinitions(repo, ctx) {
   }
   return (data?.repository?.issueFields?.nodes ?? []).flatMap((raw) => definitionOf(raw) ?? []);
 }
+async function readOrganizationIssueFields(login, ctx) {
+  let data;
+  try {
+    data = await graphql(ORGANIZATION_DEFINITIONS_QUERY, { login }, ctx);
+  } catch (error62) {
+    if (isIssueFieldsMissingError(error62)) return null;
+    throw error62;
+  }
+  if (data?.repositoryOwner?.__typename !== "Organization") return null;
+  return (data.repositoryOwner.issueFields?.nodes ?? []).flatMap((raw) => definitionOf(raw) ?? []);
+}
+function findIssueField(definitions, name) {
+  return definitions.find((candidate) => sameTitle(candidate.name, name));
+}
 function invalid4(message) {
   return new ToolError("invalid_argument", message);
 }
@@ -20787,7 +20815,7 @@ function fieldNames(definitions) {
   return listOf(definitions.map((field) => field.name));
 }
 function fieldOf(repo, definitions, name) {
-  const field = definitions.find((candidate) => sameTitle(candidate.name, name));
+  const field = findIssueField(definitions, name);
   if (!field) throw invalid4(`${repo.full} has no issue field "${name}". Fields: ${fieldNames(definitions)}.`);
   return field;
 }
@@ -21665,12 +21693,18 @@ var issueComment = defineTool({
 // src/core/github/board-fields.ts
 var VIEW_LAYOUT_SUFFIX = /_LAYOUT$/;
 var FIELD_SELECTION = "__typename ... on ProjectV2FieldCommon{id name dataType} ... on ProjectV2SingleSelectField{options{id name color description}} ... on ProjectV2IterationField{configuration{iterations{id title startDate duration}}}";
-var FIELDS_QUERY2 = `query($id:ID!,$after:String){node(id:$id){... on ProjectV2{fields(first:${PAGE_SIZE},after:$after){${PAGE_INFO} nodes{${FIELD_SELECTION}}}}}}`;
+var ISSUE_FIELD_SELECTION = "isIssueField issueField{__typename ... on IssueFieldSingleSelect{options{id name color description}}}";
+var READ_FIELD_SELECTION = `${FIELD_SELECTION} ... on ProjectV2Field{${ISSUE_FIELD_SELECTION}} ... on ProjectV2SingleSelectField{${ISSUE_FIELD_SELECTION}}`;
+var FIELDS_QUERY2 = `query($id:ID!,$after:String){node(id:$id){... on ProjectV2{fields(first:${PAGE_SIZE},after:$after){${PAGE_INFO} nodes{${READ_FIELD_SELECTION}}}}}}`;
+var FALLBACK_FIELDS_QUERY = `query($id:ID!,$after:String){node(id:$id){... on ProjectV2{fields(first:${PAGE_SIZE},after:$after){${PAGE_INFO} nodes{${FIELD_SELECTION}}}}}}`;
 var VIEWS_QUERY = `query($id:ID!,$after:String){node(id:$id){... on ProjectV2{views(first:${PAGE_SIZE},after:$after){${PAGE_INFO} nodes{id number name layout filter}}}}}`;
 var boardFieldSchema = external_exports.object({
   id: external_exports.string(),
   name: external_exports.string(),
   type: external_exports.string().describe("GitHub's data type in lower case: text, number, date, single_select, iteration, title, assignees, \u2026"),
+  issue_field: external_exports.boolean().describe(
+    "Whether the column mirrors one of the organization's issue fields: its value is the issue's own, set with the issue tools, not on the board."
+  ),
   options: external_exports.array(external_exports.object({ id: external_exports.string(), name: external_exports.string(), color: external_exports.string(), description: external_exports.string() })).optional().describe("single_select: the options, in order."),
   iterations: external_exports.array(external_exports.object({ id: external_exports.string(), title: external_exports.string(), start_date: external_exports.string(), duration: external_exports.number().int() })).optional().describe("iteration: the iterations; duration is in days.")
 });
@@ -21681,9 +21715,16 @@ var boardViewSchema = external_exports.object({
   filter: external_exports.string().nullable()
 });
 function toField(raw) {
-  const field = { id: raw.id, name: raw.name ?? "", type: (raw.dataType ?? "").toLowerCase() };
-  if (raw.options) {
-    field.options = raw.options.map((option) => ({
+  const isIssueField = Boolean(raw.isIssueField);
+  const field = {
+    id: raw.id,
+    name: raw.name ?? "",
+    type: (raw.dataType ?? "").toLowerCase(),
+    issue_field: isIssueField
+  };
+  const rawOptions = isIssueField ? raw.issueField?.options ?? (field.type === "single_select" ? [] : void 0) : raw.options;
+  if (rawOptions) {
+    field.options = rawOptions.map((option) => ({
       id: option.id,
       name: option.name,
       color: option.color ?? "",
@@ -21701,11 +21742,21 @@ function toField(raw) {
   return field;
 }
 async function readBoardFields(projectId, ctx) {
-  const { items } = await paginate(FIELDS_QUERY2, { id: projectId }, (data) => data?.node?.fields, {
-    cwd: ctx.cwd,
-    signal: ctx.signal
-  });
-  return items.filter((raw) => Boolean(raw?.id)).map(toField);
+  const fetchFields = async (query) => {
+    const { items } = await paginate(query, { id: projectId }, (data) => data?.node?.fields, {
+      cwd: ctx.cwd,
+      signal: ctx.signal
+    });
+    return items.filter((raw) => Boolean(raw?.id)).map(toField);
+  };
+  try {
+    return await fetchFields(FIELDS_QUERY2);
+  } catch (error62) {
+    if (isIssueFieldsMissingError(error62)) {
+      return await fetchFields(FALLBACK_FIELDS_QUERY);
+    }
+    throw error62;
+  }
 }
 async function readBoardViewNodes(projectId, ctx) {
   const { items } = await paginate(VIEWS_QUERY, { id: projectId }, (data) => data?.node?.views, {
@@ -21935,6 +21986,7 @@ var STATUS_FIELD = "Status";
 var FIELD_REPLY = `projectV2Field{${FIELD_SELECTION}}`;
 var createFieldMutation = (type, options) => `mutation($project:ID!,$name:String!){createProjectV2Field(input:{projectId:$project,dataType:${type.toUpperCase()},name:$name${options}}){${FIELD_REPLY}}}`;
 var updateOptionsMutation = (options) => `mutation($field:ID!){updateProjectV2Field(input:{fieldId:$field,singleSelectOptions:${options}}){${FIELD_REPLY}}}`;
+var createIssueFieldColumnMutation = `mutation($project:ID!,$field:ID!){createProjectV2IssueField(input:{projectId:$project,issueFieldId:$field}){projectV2Field{${READ_FIELD_SELECTION}}}}`;
 function invalid7(message) {
   return new ToolError("invalid_argument", message);
 }
@@ -21947,6 +21999,29 @@ function fieldRequest(name, type, options) {
   }
   return { name: trimmed, type, options: parsed };
 }
+function issueFieldColumnRequest(name, type) {
+  const trimmed = name.trim();
+  if (!trimmed) throw invalid7("name cannot be blank.");
+  return { name: trimmed, type };
+}
+async function readOwnerIssueFields(owner, ctx) {
+  return owner.owner_type === "organization" ? readOrganizationIssueFields(owner.owner, ctx) : null;
+}
+function requireIssueField(owner, definitions, request2) {
+  if (owner.owner_type !== "organization") {
+    throw invalid7(`Issue fields belong to an organization; ${owner.owner} is a user.`);
+  }
+  if (!definitions) throw invalid7("This GitHub has no issue fields.");
+  const definition = findIssueField(definitions, request2.name);
+  if (!definition) {
+    const names = listOf(definitions.map((field) => field.name));
+    throw invalid7(`${owner.owner} has no issue field "${request2.name}". Issue fields: ${names}.`);
+  }
+  if (request2.type && request2.type !== definition.type) {
+    throw invalid7(`"${definition.name}" is ${definition.type}, not ${request2.type}.`);
+  }
+  return definition;
+}
 function optionsLiteral(options) {
   const items = options.map((option) => {
     if (!OPTION_COLORS.some((color) => color === option.color)) {
@@ -21991,6 +22066,11 @@ async function ensureField(board, fields, request2, policy, ctx) {
   if (request2.type !== "single_select" || request2.options.length === 0) return unchanged;
   const merge2 = (policy === "replace" ? replaceOptions : appendOptions)(existing.options ?? [], request2.options);
   if (!merge2.changed) return unchanged;
+  if (existing.issue_field) {
+    throw invalid7(
+      `"${existing.name}" mirrors the organization's issue field; its options are the organization's and cannot be changed on a board.`
+    );
+  }
   const data = await graphql(
     updateOptionsMutation(optionsLiteral(merge2.options)),
     { field: existing.id },
@@ -21999,6 +22079,23 @@ async function ensureField(board, fields, request2, policy, ctx) {
   const field = fieldOf2(data?.updateProjectV2Field ?? null, existing.name);
   return { field, created: false, added_options: merge2.added, updated_options: merge2.updated };
 }
+async function ensureIssueFieldColumn(board, fields, definitions, request2, ctx) {
+  const definition = requireIssueField(board, definitions, request2);
+  const existing = fields.find((field2) => sameTitle(field2.name, definition.name));
+  if (existing?.issue_field) return { field: existing, created: false, added_options: [], updated_options: [] };
+  if (existing) {
+    throw invalid7(
+      `The board has its own field "${existing.name}"; an issue field column cannot take the same name. Rename or delete the board's field in the web UI, or use the board's field.`
+    );
+  }
+  const data = await graphql(
+    createIssueFieldColumnMutation,
+    { project: board.id, field: definition.id },
+    ctx
+  );
+  const field = fieldOf2(data?.createProjectV2IssueField ?? null, definition.name);
+  return { field, created: true, added_options: [], updated_options: [] };
+}
 
 // src/core/projects/support.ts
 var BOARD_SELECTION = {
@@ -22022,60 +22119,65 @@ function boardSummary(board) {
 // src/core/projects/template.ts
 var STATUS_TODO = "Todo";
 var STATUS_WAITING = "Waiting";
-var START_FIELD = "Start";
-var TARGET_FIELD = "Target";
-var NOT_DONE = "-status:Done -status:Cancelled";
+var DATE_MODES = ["board", "issue_fields"];
+var BOARD_DATE_FIELDS = { start: "Start", target: "Target" };
+var ISSUE_DATE_FIELDS = { start: "Start date", target: "Target date" };
 var DEFAULT_VIEW_NAME = "View 1";
-var ROADMAP_NOTE = "Set the Roadmap view's date fields to Start and Target in the web UI; the API cannot set them.";
-var STANDARD_FIELDS = [
-  {
-    name: STATUS_FIELD,
-    type: "single_select",
-    options: [
-      { name: STATUS_TODO, color: "BLUE", description: "Ready to start; nothing is in the way." },
-      { name: "In Progress", color: "YELLOW", description: "Being worked on now." },
+function roadmapNote(dates) {
+  return `Set the Roadmap view's date fields to ${dates.start} and ${dates.target} in the web UI; the API cannot set them.`;
+}
+var ROADMAP_NOTE = roadmapNote(BOARD_DATE_FIELDS);
+var STATUS_REQUEST = {
+  name: STATUS_FIELD,
+  type: "single_select",
+  options: [
+    { name: STATUS_TODO, color: "BLUE", description: "Ready to start; nothing is in the way." },
+    { name: "In Progress", color: "YELLOW", description: "Being worked on now." },
+    {
+      name: STATUS_WAITING,
+      color: "GRAY",
+      description: "Cannot move until something else clears: an open blocking issue, a review or a reply."
+    },
+    { name: "Done", color: "PURPLE", description: "Finished." },
+    { name: "Cancelled", color: "RED", description: "Will not be done; kept for the record." }
+  ]
+};
+function standardTemplate(dates) {
+  const notDone = "-status:Done -status:Cancelled";
+  return {
+    roadmapNote: roadmapNote(dates),
+    views: [
+      { name: "Roadmap", layout: "roadmap", filter: "-status:Cancelled", sort_by: dates.start },
       {
-        name: STATUS_WAITING,
-        color: "GRAY",
-        description: "Cannot move until something else clears: an open blocking issue, a review or a reply."
+        name: "Kanban",
+        layout: "board",
+        filter: notDone,
+        column_by: STATUS_FIELD,
+        fields: ["Title", "Assignees", "Repository", "Parent issue", dates.target],
+        sort_by: dates.target
       },
-      { name: "Done", color: "PURPLE", description: "Finished." },
-      { name: "Cancelled", color: "RED", description: "Will not be done; kept for the record." }
+      {
+        name: "Backlog",
+        layout: "table",
+        filter: notDone,
+        fields: [
+          "Title",
+          STATUS_FIELD,
+          "Assignees",
+          "Repository",
+          "Milestone",
+          "Parent issue",
+          "Sub-issues progress",
+          dates.start,
+          dates.target,
+          "Linked pull requests"
+        ],
+        group_by: STATUS_FIELD,
+        sort_by: dates.target
+      }
     ]
-  },
-  { name: START_FIELD, type: "date", options: [] },
-  { name: TARGET_FIELD, type: "date", options: [] }
-];
-var STANDARD_VIEWS = [
-  { name: "Roadmap", layout: "roadmap", filter: "-status:Cancelled", sort_by: START_FIELD },
-  {
-    name: "Kanban",
-    layout: "board",
-    filter: NOT_DONE,
-    column_by: STATUS_FIELD,
-    fields: ["Title", "Assignees", "Repository", "Parent issue", TARGET_FIELD],
-    sort_by: TARGET_FIELD
-  },
-  {
-    name: "Backlog",
-    layout: "table",
-    filter: NOT_DONE,
-    fields: [
-      "Title",
-      STATUS_FIELD,
-      "Assignees",
-      "Repository",
-      "Milestone",
-      "Parent issue",
-      "Sub-issues progress",
-      START_FIELD,
-      TARGET_FIELD,
-      "Linked pull requests"
-    ],
-    group_by: STATUS_FIELD,
-    sort_by: TARGET_FIELD
-  }
-];
+  };
+}
 
 // src/core/projects/item-support.ts
 var ITEM_BOARD_SELECTION = {
@@ -22088,10 +22190,10 @@ var itemArgument = external_exports.string().describe(
   "The board item: its node ID (PVTI_\u2026), or an issue or pull request as 12, #12, owner/repo#12 or its URL, found on the board that project, owner and repo choose. A draft can only be named by its ID."
 );
 var ITEM_NOTE = "An item is named by its node ID (PVTI_\u2026), which also tells its board (a project given beside it must be that board), or by an issue or pull request (12, #12, owner/repo#12 or its URL) that is on the board the lookup finds. A draft can only be named by its ID.";
-var FIELDS_NOTE = "Field values are set by field name and option or iteration name, matched without regard to case: text as a string, number as a number or numeric string, date as YYYY-MM-DD, single select as an option name, iteration as an iteration title or @current (the iteration containing today, UTC). Only text, number, date, single select and iteration fields can be set; GitHub's own (Title, Assignees, Labels, Milestone, Repository, Linked pull requests, \u2026) are set on the issue, and github_issue_edit sets assignees, labels and milestone. Every field and value is checked before anything is written.";
+var FIELDS_NOTE = "Field values are set by field name and option or iteration name, matched without regard to case: text as a string, number as a number or numeric string, date as YYYY-MM-DD, single select as an option name, iteration as an iteration title or @current (the iteration containing today, UTC). Only text, number, date, single select and iteration fields can be set; a column that mirrors an issue field is set with the issue tools' issue_fields, not here. GitHub's own (Title, Assignees, Labels, Milestone, Repository, Linked pull requests, \u2026) are set on the issue, and github_issue_edit sets assignees, labels and milestone. Every field and value is checked before anything is written.";
 var fieldValuesSchema = external_exports.record(external_exports.string(), external_exports.union([external_exports.string(), external_exports.number()]));
 var fieldValuesArgument = fieldValuesSchema.optional().describe(
-  'Field values to set, by field name: {"Status": "Todo", "Target": "2026-12-01"}. Values are text, a number, a YYYY-MM-DD date, an option name or an iteration title (@current is the one containing today).'
+  `Field values to set, by field name: {"Status": "Todo", "Target": "2026-12-01"}. Values are text, a number, a YYYY-MM-DD date, an option name or an iteration title (@current is the one containing today). A column that mirrors an issue field is set with the issue tools' issue_fields, not here.`
 );
 var fieldsResultSchema = fieldValuesSchema.describe(
   "The values that were set, by field name as the board spells it: an option or iteration by its name, a number as a number."
@@ -23310,6 +23412,9 @@ var input10 = external_exports.object({
     "A board to copy, without its draft items, when the board has to be made: its number, owner/number or URL (a bare number or a title is looked up among owner's boards)."
   ),
   standard: external_exports.boolean().optional().describe("Bring the board to the standard template: its fields and views (default true)."),
+  dates: external_exports.enum(DATE_MODES).optional().describe(
+    `"board" (default) makes the board's own date fields Start and Target; "issue_fields" uses the organization's issue fields Start date and Target date instead, so an issue carries the same dates on every board and they are set with the issue tools (a pull request or draft has none). Organization boards only.`
+  ),
   link_repo: external_exports.string().optional().describe("owner/name of a repository to link the board to; needs write permission.")
 });
 var output10 = external_exports.object({
@@ -23341,23 +23446,41 @@ function openBoardTitled(boards, title) {
   }
   return matches[0];
 }
-async function applyFields(board, fresh, report, ctx) {
+async function applyFields(board, fresh, mode, dates, definitions, report, ctx) {
   const fields = await readBoardFields(board.id, ctx);
-  for (const request2 of STANDARD_FIELDS) {
-    const { field, created, added_options, updated_options } = await ensureField(
-      board,
-      fields,
-      request2,
-      fresh && request2.name === STATUS_FIELD ? "replace" : "append",
-      ctx
-    );
-    report.push({ field: field.name, created, added_options, updated_options });
+  const status = await ensureField(board, fields, STATUS_REQUEST, fresh ? "replace" : "append", ctx);
+  report.push({
+    field: status.field.name,
+    created: status.created,
+    added_options: status.added_options,
+    updated_options: status.updated_options
+  });
+  if (mode === "issue_fields") {
+    for (const name of [dates.start, dates.target]) {
+      const outcome = await ensureIssueFieldColumn(board, fields, definitions, { name, type: "date" }, ctx);
+      report.push({
+        field: outcome.field.name,
+        created: outcome.created,
+        added_options: outcome.added_options,
+        updated_options: outcome.updated_options
+      });
+    }
+  } else {
+    for (const name of [dates.start, dates.target]) {
+      const outcome = await ensureField(board, fields, { name, type: "date", options: [] }, "append", ctx);
+      report.push({
+        field: outcome.field.name,
+        created: outcome.created,
+        added_options: outcome.added_options,
+        updated_options: outcome.updated_options
+      });
+    }
   }
 }
-async function applyViews(board, report, notes, ctx) {
+async function applyViews(board, templateViews, roadmapNote2, report, notes, ctx) {
   const before = await readBoardViewNodes(board.id, ctx);
   const readers = viewFieldReaders(board, ctx);
-  for (const request2 of STANDARD_VIEWS) {
+  for (const request2 of templateViews) {
     if (before.some((view5) => sameTitle(view5.name, request2.name))) {
       report.push({ view: request2.name, created: false });
       continue;
@@ -23369,7 +23492,7 @@ async function applyViews(board, report, notes, ctx) {
       throw error62;
     }
     report.push({ view: request2.name, created: true });
-    if (request2.layout === "roadmap") notes.push(ROADMAP_NOTE);
+    if (request2.layout === "roadmap") notes.push(roadmapNote2);
   }
   return before;
 }
@@ -23379,6 +23502,7 @@ var projectCreate = defineTool({
   description: [
     `Create a project board for a user or organization, or reuse the open board of that owner and exact title (case-insensitive; several are invalid_argument), and bring it to the standard template. The title defaults to ${DEFAULT_BOARD_TITLE}. A board that has to be made is empty, or a copy of template without its draft items.`,
     "With standard (the default): the fields Status (Todo, In Progress, Waiting, Done, Cancelled, each with a color and a description), Start and Target (dates), and the views Roadmap, Kanban and Backlog. On a board this call made, Status gets exactly those options, keeping the ids of GitHub's own Todo, In Progress and Done, and GitHub's default view View 1 is deleted once the three views exist. On a reused or copied board only the missing fields, options and views are added, and nothing is deleted. A reused board must be one the viewer may update.",
+    `dates: "issue_fields" uses the organization's issue fields Start date and Target date as the board's dates, refused before the board is made when the owner is a user or lacks them.`,
     "link_repo links the board to a repository (needs write permission there) unless it is already linked. GitHub links only boards of the repository's own owner, so a repository of another owner is invalid_argument, before the board is made.",
     "Once the board exists, a failed step does not fail the call: it is listed in errors and the board is still returned.",
     `notes lists what the API cannot do, such as setting the Roadmap view's date fields. ${PROJECT_SCOPE_NOTE}`
@@ -23404,6 +23528,23 @@ var projectCreate = defineTool({
       linkRepo = await writableContext(repo, ctx);
     }
     const owner = await readBoardOwner(login, ctx);
+    const dateMode = args.dates ?? "board";
+    let dateNames = BOARD_DATE_FIELDS;
+    let definitions = null;
+    if (dateMode === "issue_fields") {
+      if (!standard) throw invalid5("dates applies only with standard.");
+      definitions = await readOwnerIssueFields({ owner: owner.login, owner_type: owner.type }, ctx);
+      const startDef = requireIssueField({ owner: owner.login, owner_type: owner.type }, definitions, {
+        name: ISSUE_DATE_FIELDS.start,
+        type: "date"
+      });
+      const targetDef = requireIssueField({ owner: owner.login, owner_type: owner.type }, definitions, {
+        name: ISSUE_DATE_FIELDS.target,
+        type: "date"
+      });
+      dateNames = { start: startDef.name, target: targetDef.name };
+    }
+    const template = standardTemplate(dateNames);
     const reused = openBoardTitled((await ownerBoards(owner.login, ctx, owner.type)).boards, title);
     if (reused) assertBoardWritable(reused);
     const source = reused || !templateRef ? void 0 : (await resolveBoard({ project: templateRef, owner: ownerArg }, ctx)).project;
@@ -23416,8 +23557,11 @@ var projectCreate = defineTool({
     const notes = [];
     let deletedDefaultView = false;
     if (standard) {
-      await steps.record("fields", () => applyFields(board, fresh, fields, ctx));
-      const before = await steps.record("views", () => applyViews(board, views, notes, ctx));
+      await steps.record("fields", () => applyFields(board, fresh, dateMode, dateNames, definitions, fields, ctx));
+      const before = await steps.record(
+        "views",
+        () => applyViews(board, template.views, template.roadmapNote, views, notes, ctx)
+      );
       const defaultView = fresh ? before?.find((view5) => view5.name === DEFAULT_VIEW_NAME) : void 0;
       if (defaultView) {
         deletedDefaultView = await steps.record("default_view", async () => {
@@ -23448,9 +23592,14 @@ var projectCreate = defineTool({
 var input11 = external_exports.object({
   ...BOARD_SELECTION,
   name: external_exports.string().describe("The field's name, matched without regard to case."),
-  type: external_exports.enum(FIELD_TYPES).describe("The field's type; a field of that name with another type is invalid_argument."),
+  type: external_exports.enum(FIELD_TYPES).optional().describe(
+    "The field's type; a field of that name with another type is invalid_argument. Required unless issue_field is true, where it only checks the issue field's type."
+  ),
   options: external_exports.array(external_exports.string()).optional().describe(
-    `single_select only: Name, Name:COLOR or Name:COLOR:Description (the description is everything after the second colon). COLOR is one of ${OPTION_COLORS.join(", ")}, in any case; the default is GRAY.`
+    `single_select only, not with issue_field: Name, Name:COLOR or Name:COLOR:Description (the description is everything after the second colon). COLOR is one of ${OPTION_COLORS.join(", ")}, in any case; the default is GRAY.`
+  ),
+  issue_field: external_exports.boolean().optional().describe(
+    "Add a column that mirrors the organization's issue field of that name instead of a field of the board's own; its options and values are the organization's and the issue's."
   )
 });
 var output11 = external_exports.object({
@@ -23459,12 +23608,25 @@ var output11 = external_exports.object({
   created: external_exports.boolean().describe("Whether this call made the field."),
   added_options: external_exports.array(external_exports.string()).describe("The names of the options this call added; [] when none.")
 });
+function planEnsure(args) {
+  if (args.issue_field) {
+    if (args.options && args.options.length > 0) {
+      throw new ToolError("invalid_argument", "options are the organization's with issue_field; leave them out.");
+    }
+    const request3 = issueFieldColumnRequest(args.name, args.type);
+    return async (board, fields, ctx) => ensureIssueFieldColumn(board, fields, await readOwnerIssueFields(board, ctx), request3, ctx);
+  }
+  if (!args.type) throw new ToolError("invalid_argument", "type is required unless issue_field is true.");
+  const request2 = fieldRequest(args.name, args.type, args.options);
+  return (board, fields, ctx) => ensureField(board, fields, request2, "append", ctx);
+}
 var projectFieldEnsure = defineTool({
   id: "github_project_field_ensure",
   title: "Ensure a GitHub project field",
   description: [
     "Make sure a field exists on a project board the viewer may update, without ever making a second one: a missing field is created, and the missing options of an existing single select are appended after its own, which keep their id, name, color, description and order, so nothing already set moves.",
     "A new single_select field needs options. Status can be extended but not created. A field of that name with another type, options on a field that is not single_select, a repeated option name and a color GitHub does not list are invalid_argument, before anything is written.",
+    "With issue_field: true (organization boards only) the column mirrors the organization's issue field of that name, such as Priority, Start date or Target date; it is added when the board lacks it, and a field of the board's own with that name is invalid_argument.",
     BOARD_LOOKUP_NOTE,
     PROJECT_SCOPE_NOTE
   ].join(" "),
@@ -23474,11 +23636,11 @@ var projectFieldEnsure = defineTool({
   input: input11,
   output: output11,
   async execute(args, ctx) {
-    const request2 = fieldRequest(args.name, args.type, args.options);
+    const ensure = planEnsure(args);
     const { project } = await resolveBoard(args, ctx);
     assertBoardWritable(project);
     const fields = await readBoardFields(project.id, ctx);
-    const { field, created, added_options } = await ensureField(project, fields, request2, "append", ctx);
+    const { field, created, added_options } = await ensure(project, fields, ctx);
     return { project: boardSummary(project), field, created, added_options };
   }
 });
@@ -23558,7 +23720,10 @@ var FIELD_LABELS = 20;
 var FIELD_USERS = 10;
 var FIELD_PULL_REQUESTS = 10;
 var FIELD_NAME = "field{... on ProjectV2FieldCommon{name}}";
-var ITEM_FIELDS = `id isArchived
+function itemFields(includeIssueFields = true) {
+  const issueFieldSelection = includeIssueFields ? `
+ ... on ProjectV2ItemIssueFieldValue{${FIELD_NAME} issueFieldValue{${ISSUE_FIELD_VALUE_SELECTION}}}` : "";
+  return `id isArchived
 fieldValues(first:${FIELD_VALUES}){nodes{
  ... on ProjectV2ItemFieldTextValue{text ${FIELD_NAME}}
  ... on ProjectV2ItemFieldNumberValue{number ${FIELD_NAME}}
@@ -23569,15 +23734,22 @@ fieldValues(first:${FIELD_VALUES}){nodes{
  ... on ProjectV2ItemFieldRepositoryValue{repository{nameWithOwner} ${FIELD_NAME}}
  ... on ProjectV2ItemFieldLabelValue{labels(first:${FIELD_LABELS}){nodes{name}} ${FIELD_NAME}}
  ... on ProjectV2ItemFieldUserValue{users(first:${FIELD_USERS}){nodes{login}} ${FIELD_NAME}}
- ... on ProjectV2ItemFieldPullRequestValue{pullRequests(first:${FIELD_PULL_REQUESTS}){nodes{number}} ${FIELD_NAME}}
+ ... on ProjectV2ItemFieldPullRequestValue{pullRequests(first:${FIELD_PULL_REQUESTS}){nodes{number}} ${FIELD_NAME}}${issueFieldSelection}
 }}
 content{__typename
  ... on DraftIssue{id title body}
  ... on Issue{number title url issueState: state repository{nameWithOwner} issueType{name} labels(first:${CONTENT_LABELS}){nodes{name}} assignees(first:${CONTENT_ASSIGNEES}){nodes{login}} parent{number repository{nameWithOwner}} subIssuesSummary{total completed}}
  ... on PullRequest{number title url pullRequestState: state repository{nameWithOwner} labels(first:${CONTENT_LABELS}){nodes{name}} assignees(first:${CONTENT_ASSIGNEES}){nodes{login}}}
 }`;
-var ITEMS_QUERY = `query($id:ID!,$after:String){node(id:$id){... on ProjectV2{items(first:${PAGE_SIZE2},after:$after){pageInfo{hasNextPage endCursor} nodes{${ITEM_FIELDS}}}}}}`;
-var ITEM_QUERY = `query($id:ID!){node(id:$id){... on ProjectV2Item{${ITEM_FIELDS}}}}`;
+}
+var ITEM_FIELDS = itemFields(true);
+var ITEM_FIELDS_WITHOUT_ISSUE_FIELDS = itemFields(false);
+var itemsQuery = (fields) => `query($id:ID!,$after:String){node(id:$id){... on ProjectV2{items(first:${PAGE_SIZE2},after:$after){pageInfo{hasNextPage endCursor} nodes{${fields}}}}}}`;
+var itemQuery = (fields) => `query($id:ID!){node(id:$id){... on ProjectV2Item{${fields}}}}`;
+var ITEMS_QUERY = itemsQuery(ITEM_FIELDS);
+var ITEMS_QUERY_WITHOUT_ISSUE_FIELDS = itemsQuery(ITEM_FIELDS_WITHOUT_ISSUE_FIELDS);
+var ITEM_QUERY = itemQuery(ITEM_FIELDS);
+var ITEM_QUERY_WITHOUT_ISSUE_FIELDS = itemQuery(ITEM_FIELDS_WITHOUT_ISSUE_FIELDS);
 var iterationValueSchema = external_exports.object({
   title: external_exports.string(),
   start_date: external_exports.string(),
@@ -23608,7 +23780,7 @@ var boardItemSchema = external_exports.object({
   item_id: external_exports.string(),
   archived: external_exports.boolean(),
   fields: external_exports.record(external_exports.string(), itemFieldValueSchema).describe(
-    "Values by field name: text, number, date and single select as they are (the option's name), iteration as { title, start_date, duration }, milestone as its title, repository as owner/name, labels as names, users as logins, linked pull requests as numbers."
+    "Values by field name: text, number, date and single select as they are (the option's name), a column mirroring an organization issue field as the issue's value (an option's name, or a list of names for a multi-select), iteration as { title, start_date, duration }, milestone as its title, repository as owner/name, labels as names, users as logins, linked pull requests as numbers."
   ),
   content: itemContentSchema.nullable().describe("What the item stands for; null when GitHub did not return it.")
 });
@@ -23616,6 +23788,7 @@ function nodesOf2(connection) {
   return (connection?.nodes ?? []).filter((node2) => node2 != null);
 }
 function fieldValue(raw) {
+  if ("issueFieldValue" in raw) return issueFieldValueOf(raw.issueFieldValue);
   if ("text" in raw) return raw.text ?? null;
   if ("number" in raw) return raw.number ?? null;
   if ("date" in raw) return raw.date ?? null;
@@ -23679,16 +23852,34 @@ function toItem(raw) {
   };
 }
 async function readBoardItems(projectId, ctx) {
-  const { items, truncated } = await paginate(
-    ITEMS_QUERY,
-    { id: projectId },
-    (data) => data?.node?.items,
-    { cwd: ctx.cwd, signal: ctx.signal, limit: MAX_BOARD_ITEMS }
-  );
-  return { items: items.filter((raw) => raw != null).map(toItem), truncated };
+  const run = (query) => paginate(query, { id: projectId }, (data) => data?.node?.items, {
+    cwd: ctx.cwd,
+    signal: ctx.signal,
+    limit: MAX_BOARD_ITEMS
+  });
+  let result;
+  try {
+    result = await run(ITEMS_QUERY);
+  } catch (error62) {
+    if (isIssueFieldsMissingError(error62)) {
+      result = await run(ITEMS_QUERY_WITHOUT_ISSUE_FIELDS);
+    } else {
+      throw error62;
+    }
+  }
+  return { items: result.items.filter((raw) => raw != null).map(toItem), truncated: result.truncated };
 }
 async function readBoardItem(itemId, ctx) {
-  const data = await graphql(ITEM_QUERY, { id: itemId }, ctx);
+  let data;
+  try {
+    data = await graphql(ITEM_QUERY, { id: itemId }, ctx);
+  } catch (error62) {
+    if (isIssueFieldsMissingError(error62)) {
+      data = await graphql(ITEM_QUERY_WITHOUT_ISSUE_FIELDS, { id: itemId }, ctx);
+    } else {
+      throw error62;
+    }
+  }
   const raw = data?.node;
   if (!raw?.id) return null;
   return { item: toItem(raw), draftId: raw.content?.__typename === "DraftIssue" ? raw.content.id ?? null : null };
@@ -23913,7 +24104,9 @@ var input16 = external_exports.object({
   item: itemArgument,
   ...ITEM_BOARD_SELECTION,
   fields: fieldValuesArgument,
-  clear_fields: external_exports.array(external_exports.string()).optional().describe("Names of the fields to empty."),
+  clear_fields: external_exports.array(external_exports.string()).optional().describe(
+    "Names of the fields to empty. A column that mirrors an issue field is cleared with clear_issue_fields in github_issue_edit, not here."
+  ),
   title: external_exports.string().optional().describe("Drafts only: the new title."),
   body: external_exports.string().optional().describe("Drafts only: the new body, which replaces the whole old one; empty clears it."),
   append_body: external_exports.string().optional().describe("Drafts only: text added after the current body, set off by a blank line.")
@@ -24221,7 +24414,7 @@ var projectRead = defineTool({
   id: "github_project_read",
   title: "Read GitHub project boards",
   description: [
-    'Read GitHub project boards (Projects v2). method "view": the board the lookup finds, its fields (with single-select options and iterations) and its views, with the route that found it and what every route considered.',
+    'Read GitHub project boards (Projects v2). method "view": the board the lookup finds, its fields (with single-select options and iterations; a field mirroring an issue field is marked issue_field) and its views, with the route that found it and what every route considered.',
     `method "list": an owner's boards (owner, a login or @me) or the boards linked to a repository (repo, default the working tree's), open ones unless include_closed; truncated says more matched than limit (default ${DEFAULT_LIST_LIMIT}).`,
     `method "item_list": the board's items, filtered here by status (names, comma-separated, "-Name" leaves one out), content_type (issue, pr, draft), content_repo, search in the title and include_archived, with field values flattened by field name; truncated says the board holds more than ${MAX_BOARD_ITEMS} items or more matched than limit (default ${DEFAULT_ITEM_LIMIT}).`,
     "A board is named by project: its number, owner/number or its URL, used as it is (closed too); a bare number takes owner, else the owner of repo or of the working tree's repository.",