@craftsamo/github-tools 0.6.0 → 0.6.1

package/.antigravity-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "github-tools",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "GitHub tools for coding agents: issues, project boards, pull requests, repositories, releases and Actions.",
   "author": {
     "name": "craftsamo",

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "github-tools",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "GitHub tools for coding agents: issues, project boards, pull requests, repositories, releases and Actions.",
   "author": {
     "name": "craftsamo",

package/README.md

@@ -217,7 +217,9 @@ none is given), and found among the boards linked to the repository, then its
 organization's, then the viewer's. The token needs the `project` scope
 (`gh auth refresh -s project`). No API sets a roadmap view's date fields, so
 after `github_project_create` set the Roadmap view's "Date fields" to Start and
-Target in the web UI.
+Target in the web UI. A column that mirrors an organization's issue field is
+read like any other, but its value is the issue's own: the board tools refuse
+to set or clear it, and `github_issue_edit` does both.
 
 ## Reads and writes
 

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['"`]?/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));
@@ -21665,12 +21677,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 +21699,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 +21726,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, {
@@ -21991,6 +22026,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 },
@@ -22088,10 +22128,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."
@@ -23558,7 +23598,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 +23612,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 +23658,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 +23666,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 +23730,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 +23982,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 +24292,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.",

package/dist/mcp.js

@@ -29679,11 +29679,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(
@@ -29763,7 +29770,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.`);
     }
@@ -29774,7 +29781,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;
@@ -29789,38 +29796,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['"`]?/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));
@@ -30633,12 +30645,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.")
 });
@@ -30649,9 +30667,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 ?? "",
@@ -30669,11 +30694,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, {
@@ -30959,6 +30994,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 },
@@ -31056,10 +31096,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."
@@ -32526,7 +32566,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}}
@@ -32537,15 +32580,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(),
@@ -32576,7 +32626,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.")
 });
@@ -32584,6 +32634,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;
@@ -32647,16 +32698,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 };
@@ -32881,7 +32950,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.")
@@ -33189,7 +33260,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.",
@@ -37896,7 +37967,7 @@ async function main() {
     const settings = parseSettings(process.argv.slice(2), process.env);
     server = createServer(ALL_TOOLS, settings, {
       ownDir: packageRoot(import.meta.url),
-      version: true ? "0.6.0" : void 0
+      version: true ? "0.6.1" : void 0
     });
   } catch (error62) {
     if (!isToolError(error62)) throw error62;

package/dist/opencode.js

@@ -20585,11 +20585,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(
@@ -20669,7 +20676,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.`);
     }
@@ -20680,7 +20687,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;
@@ -20695,38 +20702,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['"`]?/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));
@@ -21651,12 +21663,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.")
 });
@@ -21667,9 +21685,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 ?? "",
@@ -21687,11 +21712,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, {
@@ -21977,6 +22012,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 },
@@ -22074,10 +22114,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."
@@ -23544,7 +23584,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}}
@@ -23555,15 +23598,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(),
@@ -23594,7 +23644,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.")
 });
@@ -23602,6 +23652,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;
@@ -23665,16 +23716,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 };
@@ -23899,7 +23968,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.")
@@ -24207,7 +24278,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.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@craftsamo/github-tools",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "GitHub tools for coding agents: issues, project boards, pull requests, repositories, releases and Actions.",
   "author": "craftsamo",
   "license": "MIT",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "github-tools",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "GitHub tools for coding agents: issues, project boards, pull requests, repositories, releases and Actions.",
   "author": {
     "name": "craftsamo",

package/plugin.yaml

@@ -1,5 +1,5 @@
 name: github-tools
-version: 0.6.0
+version: 0.6.1
 description: "GitHub tools for coding agents: issues, project boards, pull requests, repositories, releases and Actions."
 manifest_version: 1
 requires_hermes: ">=0.22"

package/skills/github-projects/SKILL.md

@@ -48,11 +48,13 @@ if GitHub reports missing scopes, the user runs `gh auth refresh -s project`.
 
 - **`view`** returns the board, its fields (with single-select options and
   iterations) and its views. Read it before setting values you are unsure of:
-  field and option names come from there.
+  field and option names come from there. A field with `issue_field: true`
+  mirrors one of the organization's issue fields (see Field values).
 - **`list`** returns an `owner`'s boards, or the boards linked to `repo`;
   closed ones only with `include_closed`.
 - **`item_list`** returns a board's items with their field values by field
-  name and their content (issue, pull request or draft). Filter with `status`
+  name and their content (issue, pull request or draft); a column that
+  mirrors an issue field shows the issue's value. Filter with `status`
   (`"Todo,In Progress"`, or `"-Done"` to leave one out), `content_type`,
   `content_repo`, `search` (part of the title) and `include_archived`.
   `truncated: true` means more matched than `limit` (default 100, at most
@@ -135,7 +137,12 @@ them; names, options and iterations match without regard to case.
 
 Title, Assignees, Labels, Milestone, Repository, Linked pull requests and
 GitHub's other own fields belong to the issue, not the board: set them with
-`github_issue_edit`. Every field and value is checked before anything is
+`github_issue_edit`. A column that mirrors one of the organization's issue
+fields (`issue_field: true` in `github_project_read`, such as Priority or
+Target date) holds the issue's own value, the same on every board: set it
+with `issue_fields` and clear it with `clear_issue_fields` in
+`github_issue_edit` (or `issue_fields` in `github_issue_create`); the board
+tools refuse it. Every field and value is checked before anything is
 written, so a refused call wrote nothing.
 
 ### Editing and archiving