toolcraft 0.0.22 → 0.0.24

package/node_modules/@poe-code/task-list/dist/backends/gh-issues.js

@@ -11,7 +11,7 @@ export const PROJECT_ORGANIZATION_QUERY = `query Project($owner: String!, $numbe
         ... on ProjectV2SingleSelectField {
           id
           name
-          options { id name }
+          options { id name color description }
         }
       }
       fields(first: 100) {
@@ -19,7 +19,7 @@ export const PROJECT_ORGANIZATION_QUERY = `query Project($owner: String!, $numbe
           ... on ProjectV2SingleSelectField {
             id
             name
-            options { id name }
+            options { id name color description }
           }
         }
       }
@@ -35,7 +35,7 @@ export const PROJECT_USER_QUERY = `query Project($owner: String!, $number: Int!)
         ... on ProjectV2SingleSelectField {
           id
           name
-          options { id name }
+          options { id name color description }
         }
       }
       fields(first: 100) {
@@ -43,7 +43,7 @@ export const PROJECT_USER_QUERY = `query Project($owner: String!, $number: Int!)
           ... on ProjectV2SingleSelectField {
             id
             name
-            options { id name }
+            options { id name color description }
           }
         }
       }
@@ -80,9 +80,28 @@ const PROJECT_ITEMS_QUERY = `query Items($projectId: ID!, $after: String) {
     }
   }
 }`;
-const ISSUE_QUERY = `query Issue($owner: String!, $repo: String!, $number: Int!) {
+const REPOSITORY_ISSUES_QUERY = `query Issues($owner: String!, $repo: String!, $labels: [String!], $after: String) {
+  repository(owner: $owner, name: $repo) {
+    issues(first: 100, after: $after, labels: $labels, states: OPEN) {
+      nodes {
+        __typename
+        number
+        title
+        body
+        url
+        createdAt
+        labels(first: 50) { nodes { name } }
+        assignees(first: 20) { nodes { login } }
+        milestone { title }
+      }
+      pageInfo { hasNextPage endCursor }
+    }
+  }
+}`;
+const ISSUE_QUERY = `query Issue($owner: String!, $repo: String!, $number: Int!, $after: String) {
   repository(owner: $owner, name: $repo) {
     issue(number: $number) {
+      id
       number
       title
       body
@@ -91,7 +110,7 @@ const ISSUE_QUERY = `query Issue($owner: String!, $repo: String!, $number: Int!)
       labels(first: 50) { nodes { name } }
       assignees(first: 20) { nodes { login } }
       milestone { title }
-      projectItems(first: 10) {
+      projectItems(first: 100, after: $after) {
         nodes {
           id
           project { id }
@@ -101,40 +120,80 @@ const ISSUE_QUERY = `query Issue($owner: String!, $repo: String!, $number: Int!)
             }
           }
         }
+        pageInfo { hasNextPage endCursor }
       }
     }
   }
 }`;
-const REPOSITORY_QUERY = `query Repository($owner: String!, $repo: String!) {
-  repository(owner: $owner, name: $repo) {
-    id
-  }
-}`;
-const ISSUE_ID_QUERY = `query IssueId($owner: String!, $repo: String!, $number: Int!) {
+const REPOSITORY_ISSUE_QUERY = `query Issue($owner: String!, $repo: String!, $number: Int!) {
   repository(owner: $owner, name: $repo) {
     issue(number: $number) {
       id
+      number
+      title
+      body
+      url
+      createdAt
+      labels(first: 50) { nodes { name } }
+      assignees(first: 20) { nodes { login } }
+      milestone { title }
     }
   }
 }`;
-const ISSUE_PROJECT_ITEM_QUERY = `query IssueProjectItem($owner: String!, $repo: String!, $number: Int!) {
+const ISSUE_STATE_LABELS_QUERY = `query IssueStateLabels($owner: String!, $repo: String!, $number: Int!, $after: String) {
   repository(owner: $owner, name: $repo) {
     issue(number: $number) {
       id
-      projectItems(first: 10) {
+      labels(first: 50) { nodes { id name } }
+      projectItems(first: 100, after: $after) {
         nodes {
           id
           project { id }
         }
+        pageInfo { hasNextPage endCursor }
       }
     }
   }
 }`;
+const REPOSITORY_ISSUE_STATE_LABELS_QUERY = `query IssueStateLabels($owner: String!, $repo: String!, $number: Int!) {
+  repository(owner: $owner, name: $repo) {
+    issue(number: $number) {
+      id
+      labels(first: 50) { nodes { id name } }
+    }
+  }
+}`;
+const REPOSITORY_QUERY = `query Repository($owner: String!, $repo: String!) {
+  repository(owner: $owner, name: $repo) {
+    id
+  }
+}`;
+const ISSUE_ID_QUERY = `query IssueId($owner: String!, $repo: String!, $number: Int!) {
+  repository(owner: $owner, name: $repo) {
+    issue(number: $number) {
+      id
+    }
+  }
+}`;
+const REPOSITORY_LABEL_QUERY = `query RepositoryLabel($owner: String!, $repo: String!, $name: String!) {
+  repository(owner: $owner, name: $repo) {
+    label(name: $name) {
+      id
+    }
+  }
+}`;
 const CREATE_ISSUE_MUTATION = `mutation CreateIssue($input: CreateIssueInput!) {
   createIssue(input: $input) {
     issue {
       id
       number
+      title
+      body
+      url
+      createdAt
+      labels(first: 50) { nodes { name } }
+      assignees(first: 20) { nodes { login } }
+      milestone { title }
     }
   }
 }`;
@@ -159,6 +218,16 @@ const UPDATE_ISSUE_MUTATION = `mutation UpdateIssue($input: UpdateIssueInput!) {
     }
   }
 }`;
+const ADD_LABELS_MUTATION = `mutation AddLabels($input: AddLabelsToLabelableInput!) {
+  addLabelsToLabelable(input: $input) {
+    clientMutationId
+  }
+}`;
+const REMOVE_LABELS_MUTATION = `mutation RemoveLabels($input: RemoveLabelsFromLabelableInput!) {
+  removeLabelsFromLabelable(input: $input) {
+    clientMutationId
+  }
+}`;
 const ADD_COMMENT_MUTATION = `mutation AddComment($input: AddCommentInput!) {
   addComment(input: $input) {
     commentEdge {
@@ -179,39 +248,52 @@ const DELETE_PROJECT_ITEM_MUTATION = `mutation DeleteProjectItem($input: DeleteP
   }
 }`;
 export async function ghIssuesBackend(deps) {
+    if (deps.state?.labelPrefix === "") {
+        throw new Error("gh-issues state.labelPrefix must be a non-empty string when configured.");
+    }
     const client = createGhClient({
         token: deps.token,
         endpoint: deps.endpoint,
         fetch: deps.fetch
     });
-    const listName = `${deps.project.owner}/${deps.project.number}`;
-    const variables = {
-        owner: deps.project.owner,
-        number: deps.project.number
-    };
-    const organizationResult = await client.graphql(PROJECT_ORGANIZATION_QUERY, variables);
-    let project = organizationResult.organization?.projectV2 ?? null;
-    if (project === null) {
-        const userResult = await client.graphql(PROJECT_USER_QUERY, variables);
-        project = userResult.user?.projectV2 ?? null;
-    }
-    if (project === null) {
-        throw new Error(`Project ${listName} not found or inaccessible.`);
-    }
-    const field = project.field;
-    if (!isStatusField(field)) {
-        throw new Error(`Project ${listName} has no Status field; gh-issues requires one.`);
+    const repoParts = parseRepo(deps.repo);
+    const project = deps.project;
+    let listName;
+    let session;
+    if (project === undefined) {
+        if (deps.state?.labelPrefix === undefined || deps.stateMachine === undefined) {
+            throw new Error("gh-issues requires project or label-backed stateMachine configuration.");
+        }
+        listName = deps.repo;
+        session = createLabelSession(deps.stateMachine, deps.state.labelPrefix);
     }
-    if (field.options.length === 0) {
-        throw new Error(`Project ${listName} Status field has no options.`);
+    else {
+        listName = `${project.owner}/${project.number}`;
+        const variables = { owner: project.owner, number: project.number };
+        const organizationResult = await client.graphql(PROJECT_ORGANIZATION_QUERY, variables);
+        let resolvedProject = organizationResult.organization?.projectV2 ?? null;
+        if (resolvedProject === null) {
+            const userResult = await client.graphql(PROJECT_USER_QUERY, variables);
+            resolvedProject = userResult.user?.projectV2 ?? null;
+        }
+        if (resolvedProject === null) {
+            throw new Error(`Project ${listName} not found or inaccessible.`);
+        }
+        const field = resolvedProject.field;
+        if (!isStatusField(field)) {
+            throw new Error(`Project ${listName} has no Status field; gh-issues requires one.`);
+        }
+        if (field.options.length === 0) {
+            throw new Error(`Project ${listName} Status field has no options.`);
+        }
+        session = createProjectSession(resolvedProject, field, deps.state?.labelPrefix);
     }
-    const session = createSession(project, field);
-    const repoParts = parseRepo(deps.repo);
     const context = {
         client,
         repoOwner: repoParts.owner,
         repoName: repoParts.name,
-        issueIds: new Map()
+        issueIds: new Map(),
+        labels: resolveLabelsFilter(deps.filter)
     };
     function list(name) {
         assertSingleList(name, listName);
@@ -234,7 +316,7 @@ export async function ghIssuesBackend(deps) {
         }
     };
 }
-function createSession(project, field) {
+function createProjectSession(project, field, labelPrefix) {
     const statusOptions = new Map(field.options.map((option) => [option.name, option.id]));
     const states = field.options.map((option) => option.name);
     const events = Object.fromEntries(states.map((state) => [state, Object.freeze({ from: "*", to: state })]));
@@ -247,7 +329,17 @@ function createSession(project, field) {
         projectId: project.id,
         statusFieldId: field.id,
         statusOptions,
-        stateMachine
+        stateMachine,
+        labelPrefix,
+        labelIds: new Map()
+    });
+}
+function createLabelSession(stateMachine, labelPrefix) {
+    return Object.freeze({
+        statusOptions: new Map(stateMachine.states.map((state) => [state, state])),
+        stateMachine,
+        labelPrefix,
+        labelIds: new Map()
     });
 }
 function createTasksView(name, session, context) {
@@ -258,7 +350,7 @@ function createTasksView(name, session, context) {
             if (filter?.includeArchived === true) {
                 return [];
             }
-            const tasks = await fetchProjectTasks(name, session, context);
+            const tasks = await fetchTasks(name, session, context);
             const filteredTasks = filter?.state === undefined ? tasks : tasks.filter((task) => task.state === filter.state);
             if (filter?.order === "alphabetical") {
                 return sortTasks(filteredTasks);
@@ -281,34 +373,83 @@ function createTasksView(name, session, context) {
          */
         async create(input) {
             const repositoryId = await resolveRepositoryId(context);
+            const labelIds = await resolveConfiguredLabelIds(session, context);
             const created = await context.client.graphql(CREATE_ISSUE_MUTATION, {
                 input: {
                     repositoryId,
                     title: input.name,
-                    body: input.description ?? ""
+                    body: input.description ?? "",
+                    ...(labelIds.length === 0 ? {} : { labelIds })
                 }
             });
             const issue = created.createIssue?.issue;
             const issueId = issue?.id ?? null;
             const issueNumber = issue?.number ?? null;
-            if (issueId === null || issueNumber === null) {
+            if (issue === undefined || issue === null || issueId === null || issueNumber === null) {
                 throw new Error("GitHub createIssue response did not include issue id and number.");
             }
             context.issueIds.set(issueNumber, issueId);
-            const added = await context.client.graphql(ADD_PROJECT_ITEM_MUTATION, {
-                input: {
-                    projectId: session.projectId,
-                    contentId: issueId
+            let projectItemId;
+            try {
+                if (session.projectId !== undefined) {
+                    const added = await context.client.graphql(ADD_PROJECT_ITEM_MUTATION, {
+                        input: {
+                            projectId: session.projectId,
+                            contentId: issueId
+                        }
+                    });
+                    projectItemId = added.addProjectV2ItemById?.item?.id ?? undefined;
+                    if (projectItemId === undefined) {
+                        throw new Error("GitHub addProjectV2ItemById response did not include project item id.");
+                    }
                 }
-            });
-            const projectItemId = added.addProjectV2ItemById?.item?.id ?? null;
-            if (projectItemId === null) {
-                throw new Error("GitHub addProjectV2ItemById response did not include project item id.");
+                if (session.labelPrefix === undefined) {
+                    if (projectItemId === undefined) {
+                        throw new Error("gh-issues project-backed state requires a project item id.");
+                    }
+                    await updateProjectItemStatus(projectItemId, session.stateMachine.initial, session, context);
+                }
+                else {
+                    await addStateLabel(issueId, session.stateMachine.initial, session, context);
+                }
+            }
+            catch (error) {
+                if (projectItemId !== undefined && session.projectId !== undefined) {
+                    await context.client.graphql(DELETE_PROJECT_ITEM_MUTATION, {
+                        input: { projectId: session.projectId, itemId: projectItemId }
+                    });
+                }
+                await context.client.graphql(UPDATE_ISSUE_MUTATION, {
+                    input: { id: issueId, state: "CLOSED" }
+                });
+                throw error;
             }
-            await updateProjectItemStatus(projectItemId, session.stateMachine.initial, session, context);
-            return fetchIssueTask(String(issueNumber), name, session, context);
+            const task = mapIssueToTask({
+                issue: {
+                    ...issue,
+                    number: issueNumber,
+                    title: input.name,
+                    body: input.description ?? "",
+                    url: issue.url,
+                    createdAt: issue.createdAt,
+                    labels: {
+                        nodes: [
+                            ...(context.labels ?? []).map((label) => ({ name: label })),
+                            ...(session.labelPrefix === undefined
+                                ? []
+                                : [{ name: `${session.labelPrefix}${session.stateMachine.initial}` }])
+                        ]
+                    }
+                },
+                projectItemId,
+                statusName: session.stateMachine.initial,
+                listName: name,
+                session
+            });
+            return session.labelPrefix === undefined ? task : { ...task, state: session.stateMachine.initial };
         },
         async update(id, patch) {
+            const task = await fetchIssueTask(id, name, session, context);
             const input = {};
             if (patch.name !== undefined) {
                 input.title = patch.name;
@@ -323,7 +464,11 @@ function createTasksView(name, session, context) {
                     input
                 });
             }
-            return fetchIssueTask(id, name, session, context);
+            return {
+                ...task,
+                name: patch.name ?? task.name,
+                description: patch.description ?? task.description
+            };
         },
         async fire(id, event, _opts) {
             if (!session.statusOptions.has(event)) {
@@ -333,12 +478,28 @@ function createTasksView(name, session, context) {
                     reason: `Unknown gh-issues Status state "${event}".`
                 });
             }
-            const projectItemId = await resolveProjectItemId(id, name, session, context);
+            const task = await fetchIssueTask(id, name, session, context);
+            const transition = findEvent(session.stateMachine, task.state, event);
+            if (transition === undefined) {
+                throw new InvalidTransitionError({
+                    task,
+                    event,
+                    to: event,
+                    reason: `Cannot fire event "${event}" from task state "${task.state}".`
+                });
+            }
             // opts.metadataPatch writes are out of scope for v1 on gh-issues.
-            await updateProjectItemStatus(projectItemId, event, session, context);
-            return fetchIssueTask(id, name, session, context);
+            if (session.labelPrefix === undefined) {
+                const projectItemId = projectItemIdFromTask(task);
+                await updateProjectItemStatus(projectItemId, event, session, context);
+            }
+            else {
+                await updateIssueStateLabel(id, name, event, session, context);
+            }
+            return { ...task, state: event };
         },
         async comment(id, body) {
+            await fetchIssueTask(id, name, session, context);
             await context.client.graphql(ADD_COMMENT_MUTATION, {
                 input: {
                     subjectId: await resolveIssueId(id, name, context),
@@ -347,12 +508,23 @@ function createTasksView(name, session, context) {
             });
         },
         async canFire(id, event) {
-            return findEvent(session.stateMachine, id, event) !== undefined;
+            const task = await fetchIssueTask(id, name, session, context);
+            return findEvent(session.stateMachine, task.state, event) !== undefined;
         },
         async events(id) {
-            return eventsFromState(session.stateMachine, id);
+            const task = await fetchIssueTask(id, name, session, context);
+            return eventsFromState(session.stateMachine, task.state);
         },
         async delete(id) {
+            if (session.projectId === undefined) {
+                await context.client.graphql(UPDATE_ISSUE_MUTATION, {
+                    input: {
+                        id: await resolveIssueId(id, name, context),
+                        state: "CLOSED"
+                    }
+                });
+                return;
+            }
             const projectItemId = await resolveProjectItemId(id, name, session, context);
             await context.client.graphql(DELETE_PROJECT_ITEM_MUTATION, {
                 input: {
@@ -362,12 +534,15 @@ function createTasksView(name, session, context) {
             });
         },
         async move(id, anchor) {
-            const projectItemId = await resolveProjectItemId(id, name, session, context);
+            assertProjectBacked(session, "move");
+            const task = await fetchIssueTask(id, name, session, context);
+            const projectItemId = projectItemIdFromTask(task);
             const afterId = await resolveMoveAfterId(id, anchor, name, session, context);
             await updateProjectItemPosition(projectItemId, afterId, session, context);
-            return fetchIssueTask(id, name, session, context);
+            return task;
         },
         async reorder(ids) {
+            assertProjectBacked(session, "reorder");
             const currentTasks = await fetchProjectTasks(name, session, context);
             const currentIds = currentTasks.map((task) => task.id);
             const currentSet = new Set(currentIds);
@@ -389,18 +564,32 @@ function createTasksView(name, session, context) {
             }
             const itemIdsByTaskId = new Map(currentTasks.map((task) => [task.id, projectItemIdFromTask(task)]));
             let afterId = null;
-            for (const id of ids) {
-                const projectItemId = itemIdsByTaskId.get(id);
-                if (projectItemId === undefined) {
-                    throw new OrderMismatchError({ missing: [id], extra: [] });
+            try {
+                for (const id of ids) {
+                    const projectItemId = itemIdsByTaskId.get(id);
+                    if (projectItemId === undefined) {
+                        throw new OrderMismatchError({ missing: [id], extra: [] });
+                    }
+                    await updateProjectItemPosition(projectItemId, afterId, session, context);
+                    afterId = projectItemId;
                 }
-                await updateProjectItemPosition(projectItemId, afterId, session, context);
-                afterId = projectItemId;
+            }
+            catch (error) {
+                await restoreProjectOrder(currentTasks, session, context);
+                throw error;
             }
             return fetchProjectTasks(name, session, context);
         }
     };
 }
+async function restoreProjectOrder(tasks, session, context) {
+    let afterId = null;
+    for (const task of tasks) {
+        const projectItemId = projectItemIdFromTask(task);
+        await updateProjectItemPosition(projectItemId, afterId, session, context);
+        afterId = projectItemId;
+    }
+}
 async function resolveRepositoryId(context) {
     if (context.repositoryId !== undefined) {
         return context.repositoryId;
@@ -435,26 +624,36 @@ async function resolveIssueId(id, listName, context) {
     return issueId;
 }
 async function resolveProjectItemId(id, listName, session, context) {
+    assertProjectBacked(session, "resolve project item");
     const issueNumber = parseIssueNumber(id, listName);
-    const result = await context.client.graphql(ISSUE_PROJECT_ITEM_QUERY, {
-        owner: context.repoOwner,
-        repo: context.repoName,
-        number: issueNumber
-    });
-    const issue = result.repository?.issue ?? null;
-    if (issue === null) {
-        throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
-    }
-    if (issue.id !== undefined && issue.id !== null) {
-        context.issueIds.set(issueNumber, issue.id);
-    }
-    const projectItem = issue.projectItems?.nodes?.find((item) => item.project?.id === session.projectId) ?? null;
-    if (projectItem === null) {
-        throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
+    let after;
+    while (true) {
+        const result = await context.client.graphql(ISSUE_STATE_LABELS_QUERY, {
+            owner: context.repoOwner,
+            repo: context.repoName,
+            number: issueNumber,
+            after
+        });
+        const issue = result.repository?.issue ?? null;
+        if (issue === null) {
+            throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
+        }
+        if (issue.id !== undefined && issue.id !== null) {
+            context.issueIds.set(issueNumber, issue.id);
+        }
+        const projectItem = issue.projectItems?.nodes?.find((item) => item.project?.id === session.projectId) ?? null;
+        if (projectItem !== null) {
+            return projectItem.id;
+        }
+        const pageInfo = issue.projectItems?.pageInfo;
+        if (pageInfo?.hasNextPage !== true || pageInfo.endCursor === undefined || pageInfo.endCursor === null) {
+            throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
+        }
+        after = pageInfo.endCursor;
     }
-    return projectItem.id;
 }
 async function updateProjectItemStatus(projectItemId, state, session, context) {
+    assertProjectBacked(session, "set project status");
     const optionId = session.statusOptions.get(state);
     if (optionId === undefined) {
         throw new InvalidTransitionError({
@@ -473,7 +672,103 @@ async function updateProjectItemStatus(projectItemId, state, session, context) {
         }
     });
 }
+async function addStateLabel(issueId, state, session, context) {
+    const labelId = await resolveStateLabelId(state, session, context);
+    await context.client.graphql(ADD_LABELS_MUTATION, {
+        input: {
+            labelableId: issueId,
+            labelIds: [labelId]
+        }
+    });
+}
+async function updateIssueStateLabel(id, listName, state, session, context) {
+    const issueNumber = parseIssueNumber(id, listName);
+    let after;
+    let issue = null;
+    let isInProject = session.projectId === undefined;
+    while (true) {
+        const result = await context.client.graphql(session.projectId === undefined
+            ? REPOSITORY_ISSUE_STATE_LABELS_QUERY
+            : ISSUE_STATE_LABELS_QUERY, {
+            owner: context.repoOwner,
+            repo: context.repoName,
+            number: issueNumber,
+            after
+        });
+        const currentIssue = result.repository?.issue ?? null;
+        if (currentIssue === null) {
+            throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
+        }
+        if (typeof currentIssue.id === "string") {
+            context.issueIds.set(issueNumber, currentIssue.id);
+        }
+        issue ??= currentIssue;
+        if (session.projectId === undefined) {
+            break;
+        }
+        if (currentIssue.projectItems?.nodes?.some((item) => item.project?.id === session.projectId)) {
+            isInProject = true;
+            break;
+        }
+        const pageInfo = currentIssue.projectItems?.pageInfo;
+        if (pageInfo?.hasNextPage !== true || pageInfo.endCursor === undefined || pageInfo.endCursor === null) {
+            break;
+        }
+        after = pageInfo.endCursor;
+    }
+    if (issue === null) {
+        throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
+    }
+    const issueId = issue.id ?? null;
+    if (issueId === null) {
+        throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
+    }
+    if (!isInProject) {
+        throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
+    }
+    const targetLabel = `${session.labelPrefix}${state}`;
+    const stateLabels = (issue.labels?.nodes ?? []).filter((node) => node !== null && node.name.startsWith(session.labelPrefix ?? ""));
+    const targetNode = stateLabels.find((node) => node.name === targetLabel);
+    if (targetNode === undefined) {
+        await addStateLabel(issueId, state, session, context);
+    }
+    const labelIdsToRemove = stateLabels
+        .filter((node) => node.name !== targetLabel && node.id !== undefined)
+        .map((node) => node.id);
+    if (labelIdsToRemove.length > 0) {
+        await context.client.graphql(REMOVE_LABELS_MUTATION, {
+            input: {
+                labelableId: issueId,
+                labelIds: labelIdsToRemove
+            }
+        });
+    }
+}
+async function resolveStateLabelId(state, session, context) {
+    return resolveLabelId(`${session.labelPrefix}${state}`, session, context);
+}
+async function resolveConfiguredLabelIds(session, context) {
+    return Promise.all((context.labels ?? []).map((name) => resolveLabelId(name, session, context)));
+}
+async function resolveLabelId(name, session, context) {
+    const cachedLabelId = session.labelIds.get(name);
+    if (cachedLabelId !== undefined) {
+        return cachedLabelId;
+    }
+    const result = await context.client.graphql(REPOSITORY_LABEL_QUERY, {
+        owner: context.repoOwner,
+        repo: context.repoName,
+        name
+    });
+    const labelId = result.repository?.label?.id ?? null;
+    if (labelId === null) {
+        throw new Error(`GitHub label "${name}" not found or inaccessible.`);
+    }
+    session.labelIds.set(name, labelId);
+    return labelId;
+}
 async function updateProjectItemPosition(projectItemId, afterId, session, context) {
+    assertProjectBacked(session, "update project position");
     await context.client.graphql(UPDATE_PROJECT_ITEM_POSITION_MUTATION, {
         input: {
             projectId: session.projectId,
@@ -524,6 +819,7 @@ async function resolveMoveAfterId(movingId, anchor, listName, session, context)
     return null;
 }
 async function fetchProjectTasks(listName, session, context) {
+    assertProjectBacked(session, "list project items");
     const tasks = [];
     let after = null;
     do {
@@ -542,27 +838,67 @@ async function fetchProjectTasks(listName, session, context) {
     } while (after !== null);
     return tasks;
 }
+async function fetchTasks(listName, session, context) {
+    if (session.projectId !== undefined) {
+        return fetchProjectTasks(listName, session, context);
+    }
+    const tasks = [];
+    let after = null;
+    do {
+        const result = await context.client.graphql(REPOSITORY_ISSUES_QUERY, {
+            owner: context.repoOwner,
+            repo: context.repoName,
+            labels: context.labels,
+            after
+        });
+        const issues = result.repository?.issues;
+        for (const issue of issues?.nodes ?? []) {
+            tasks.push(mapIssueToTask({ issue, statusName: null, listName, session }));
+        }
+        after = issues?.pageInfo?.hasNextPage === true ? (issues.pageInfo.endCursor ?? null) : null;
+    } while (after !== null);
+    return tasks;
+}
 async function fetchIssueTask(id, listName, session, context) {
     const issueNumber = parseIssueNumber(id, listName);
-    const result = await context.client.graphql(ISSUE_QUERY, {
-        owner: context.repoOwner,
-        repo: context.repoName,
-        number: issueNumber
-    });
-    const issue = result.repository?.issue ?? null;
-    if (issue === null) {
-        throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
-    }
-    const projectItem = issue.projectItems?.nodes?.find((item) => item.project?.id === session.projectId) ?? null;
-    if (projectItem === null) {
-        throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
+    let after;
+    let issue = null;
+    let projectItem = null;
+    while (true) {
+        const result = await context.client.graphql(session.projectId === undefined ? REPOSITORY_ISSUE_QUERY : ISSUE_QUERY, {
+            owner: context.repoOwner,
+            repo: context.repoName,
+            number: issueNumber,
+            after
+        });
+        const currentIssue = result.repository?.issue ?? null;
+        if (currentIssue === null) {
+            throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
+        }
+        if (currentIssue.id !== undefined) {
+            context.issueIds.set(issueNumber, currentIssue.id);
+        }
+        issue ??= currentIssue;
+        if (session.projectId === undefined) {
+            break;
+        }
+        projectItem =
+            currentIssue.projectItems?.nodes?.find((item) => item.project?.id === session.projectId) ?? null;
+        if (projectItem !== null) {
+            break;
+        }
+        const pageInfo = currentIssue.projectItems?.pageInfo;
+        if (pageInfo?.hasNextPage !== true || pageInfo.endCursor === undefined || pageInfo.endCursor === null) {
+            throw new TaskNotFoundError(`Task "${listName}/${id}" not found.`);
+        }
+        after = pageInfo.endCursor;
     }
     return mapIssueToTask({
         issue,
-        projectItemId: projectItem.id,
-        statusName: projectItem.fieldValueByName?.name ?? null,
+        projectItemId: projectItem?.id,
+        statusName: projectItem?.fieldValueByName?.name ?? null,
         listName,
-        initialState: session.stateMachine.initial
+        session
     });
 }
 function parseIssueNumber(id, listName) {
@@ -582,7 +918,7 @@ function mapProjectItemToTask(item, listName, session) {
         projectItemId: item.id,
         statusName: item.fieldValueByName?.name ?? null,
         listName,
-        initialState: session.stateMachine.initial
+        session
     });
 }
 function isIssueNode(value) {
@@ -607,17 +943,23 @@ function mapIssueToTask(options) {
         qualifiedId: `${options.listName}#${id}`,
         name: options.issue.title,
         description: options.issue.body ?? "",
-        state: options.statusName ?? options.initialState,
+        state: resolveTaskState(labels, options.statusName, options.session),
         metadata: {
             url: options.issue.url,
             labels,
             assignees,
             milestone: options.issue.milestone?.title ?? null,
-            projectItemId: options.projectItemId,
+            ...(options.projectItemId === undefined ? {} : { projectItemId: options.projectItemId }),
             created: options.issue.createdAt
         }
     };
 }
+function resolveTaskState(labels, statusName, session) {
+    if (session.labelPrefix === undefined) {
+        return statusName ?? session.stateMachine.initial;
+    }
+    return (session.stateMachine.states.find((state) => labels.includes(`${session.labelPrefix}${state}`)) ?? session.stateMachine.initial);
+}
 function projectItemIdFromTask(task) {
     const projectItemId = task.metadata.projectItemId;
     if (typeof projectItemId !== "string") {
@@ -625,6 +967,25 @@ function projectItemIdFromTask(task) {
     }
     return projectItemId;
 }
+function assertProjectBacked(session, operation) {
+    if (session.projectId === undefined || session.statusFieldId === undefined) {
+        throw new Error(`gh-issues ${operation} requires a configured GitHub Project.`);
+    }
+}
+function resolveLabelsFilter(filter) {
+    if (filter === undefined) {
+        return undefined;
+    }
+    const prefix = "label:";
+    if (!filter.startsWith(prefix)) {
+        throw new Error('gh-issues filter currently supports only "label:<name>".');
+    }
+    const label = filter.slice(prefix.length).trim();
+    if (label.length === 0) {
+        throw new Error('gh-issues filter requires a non-empty label after "label:".');
+    }
+    return [label];
+}
 function parseRepo(repo) {
     const parts = repo.split("/");
     if (parts.length !== 2 || parts[0] === "" || parts[1] === "") {