gh-axi 0.1.16 → 0.1.18

package/README.md

@@ -30,6 +30,7 @@ hooks. Those hooks invoke `gh-axi` directly from the packaged production build.
 ```bash
 gh-axi                          # dashboard - live state, no args needed
 gh-axi issue list               # list issues in current repo
+gh-axi issue subissue list 16   # list sub-issues for issue #16
 gh-axi pr view 42               # view pull request #42
 gh-axi run list -R owner/repo   # list workflow runs for a specific repo
 gh-axi run view 123456 --job 789012       # inspect a single job within a run
@@ -38,17 +39,17 @@ gh-axi run view --job 789012 --log-failed # show failed log lines for one job
 
 ### Commands
 
-| Command    | Description                                               |
-| ---------- | --------------------------------------------------------- |
-| `issue`    | Issues — list, view, create, edit, close, reopen, comment |
-| `pr`       | Pull requests — list, view, create, merge, review, checks |
-| `run`      | Workflow runs — list, view, rerun, cancel, watch          |
-| `workflow` | Workflows — list, view, run, enable, disable              |
-| `release`  | Releases — list, view, create, edit, delete               |
-| `repo`     | Repositories — list, view, create, edit, clone, fork      |
-| `label`    | Labels — list, create, edit, delete                       |
-| `search`   | Search issues, PRs, repos, commits, code                  |
-| `api`      | Raw GitHub API access                                     |
+| Command    | Description                                                         |
+| ---------- | ------------------------------------------------------------------- |
+| `issue`    | Issues — list, view, create, edit, close, reopen, comment, subissue |
+| `pr`       | Pull requests — list, view, create, merge, review, checks           |
+| `run`      | Workflow runs — list, view, rerun, cancel, watch                    |
+| `workflow` | Workflows — list, view, run, enable, disable                        |
+| `release`  | Releases — list, view, create, edit, delete                         |
+| `repo`     | Repositories — list, view, create, edit, clone, fork                |
+| `label`    | Labels — list, create, edit, delete                                 |
+| `search`   | Search issues, PRs, repos, commits, code                            |
+| `api`      | Raw GitHub API access                                               |
 
 ### Global flags
 

package/dist/src/commands/issue.d.ts

@@ -1,3 +1,4 @@
 import type { RepoContext } from "../context.js";
-export declare const ISSUE_HELP = "usage: gh-axi issue <subcommand> [flags]\nsubcommands[13]:\n  list, view <number>, create, edit <number>, close <number>, reopen <number>, comment <number>, delete <number>, lock <number>, unlock <number>, pin <number>, unpin <number>, transfer <number>\nflags{list}:\n  --state <open|closed|all>, --label <name>, --assignee <login>, --author <login>, --milestone <name>, --sort <created|updated|comments>, --limit <n> (default 30), --fields <a,b,c>\nflags{view}:\n  --comments, --full (show complete body without truncation)\nflags{create}:\n  --title <text> (required), --body <text>, --assignee <login>, --label <name>, --milestone <name>\nflags{edit}:\n  --title, --body, --add-label, --remove-label, --add-assignee, --remove-assignee, --milestone\nflags{close}:\n  --reason <completed|not_planned>, --comment <text>\nflags{comment}:\n  --body <text> (required)\nflags{transfer}:\n  --to-repo <owner/name> (required)\nexamples:\n  gh-axi issue list --state closed --label bug\n  gh-axi issue view 42 --comments\n  gh-axi issue create --title \"Fix login\" --body \"Steps to reproduce...\"\n  gh-axi issue close 42 --reason completed\n  gh-axi issue transfer 42 -R source/repo --to-repo dest/repo";
+export declare const ISSUE_HELP = "usage: gh-axi issue <subcommand> [flags]\nsubcommands[14]:\n  list, view <number>, create, edit <number>, close <number>, reopen <number>, comment <number>, delete <number>, lock <number>, unlock <number>, pin <number>, unpin <number>, transfer <number>, subissue <add|remove|list>\nflags{list}:\n  --state <open|closed|all>, --label <name>, --assignee <login>, --author <login>, --milestone <name>, --sort <created|updated|comments>, --limit <n> (default 30), --fields <a,b,c>\nflags{view}:\n  --comments, --full (show complete body without truncation)\nflags{create}:\n  --title <text> (required), --body <text>, --assignee <login>, --label <name>, --milestone <name>, --type <name>\nflags{edit}:\n  --title, --body, --add-label, --remove-label, --add-assignee, --remove-assignee, --milestone, --type <name>, --no-type\nflags{close}:\n  --reason <completed|not_planned>, --comment <text>\nflags{comment}:\n  --body <text> (required)\nflags{transfer}:\n  --to-repo <owner/name> (required)\nsubissue:\n  add <parent> <child> [<child> ...], remove <parent> <child>, list <parent>\nexamples:\n  gh-axi issue list --state closed --label bug\n  gh-axi issue view 42 --comments\n  gh-axi issue create --title \"Fix login\" --body \"Steps to reproduce...\"\n  gh-axi issue close 42 --reason completed\n  gh-axi issue transfer 42 -R source/repo --to-repo dest/repo\n  gh-axi issue subissue add 16 20 101 125\n  gh-axi issue subissue list 16";
+export declare const SUBISSUE_HELP = "usage: gh-axi issue subissue <add|remove|list> <parent> [child...]\nsubcommands[3]:\n  add <parent> <child> [<child> ...], remove <parent> <child>, list <parent>\nexamples:\n  gh-axi issue subissue add 16 20 101 125\n  gh-axi issue subissue remove 16 101\n  gh-axi issue subissue list 16";
 export declare function issueCommand(args: string[], ctx?: RepoContext): Promise<string>;

package/dist/src/commands/issue.js

@@ -1,7 +1,7 @@
 import { ghJson, ghExec, ghRaw } from "../gh.js";
-import { AxiError } from "../errors.js";
+import { AxiError, mapGhError } from "../errors.js";
 import { getSuggestions } from "../suggestions.js";
-import { getFlag, hasFlag, getPositional, requireNumber, takeFlag, } from "../args.js";
+import { getFlag, hasFlag, getPositional, requireNumber, takeFlag, takeBoolFlag, } from "../args.js";
 import { truncateBody } from "../body.js";
 import { parseFields } from "../fields.js";
 import { formatCountLine } from "../format.js";
@@ -10,28 +10,39 @@ import { field, pluck, joinArray, relativeTime, lower, custom, renderList, rende
 // Help
 // ---------------------------------------------------------------------------
 export const ISSUE_HELP = `usage: gh-axi issue <subcommand> [flags]
-subcommands[13]:
-  list, view <number>, create, edit <number>, close <number>, reopen <number>, comment <number>, delete <number>, lock <number>, unlock <number>, pin <number>, unpin <number>, transfer <number>
+subcommands[14]:
+  list, view <number>, create, edit <number>, close <number>, reopen <number>, comment <number>, delete <number>, lock <number>, unlock <number>, pin <number>, unpin <number>, transfer <number>, subissue <add|remove|list>
 flags{list}:
   --state <open|closed|all>, --label <name>, --assignee <login>, --author <login>, --milestone <name>, --sort <created|updated|comments>, --limit <n> (default 30), --fields <a,b,c>
 flags{view}:
   --comments, --full (show complete body without truncation)
 flags{create}:
-  --title <text> (required), --body <text>, --assignee <login>, --label <name>, --milestone <name>
+  --title <text> (required), --body <text>, --assignee <login>, --label <name>, --milestone <name>, --type <name>
 flags{edit}:
-  --title, --body, --add-label, --remove-label, --add-assignee, --remove-assignee, --milestone
+  --title, --body, --add-label, --remove-label, --add-assignee, --remove-assignee, --milestone, --type <name>, --no-type
 flags{close}:
   --reason <completed|not_planned>, --comment <text>
 flags{comment}:
   --body <text> (required)
 flags{transfer}:
   --to-repo <owner/name> (required)
+subissue:
+  add <parent> <child> [<child> ...], remove <parent> <child>, list <parent>
 examples:
   gh-axi issue list --state closed --label bug
   gh-axi issue view 42 --comments
   gh-axi issue create --title "Fix login" --body "Steps to reproduce..."
   gh-axi issue close 42 --reason completed
-  gh-axi issue transfer 42 -R source/repo --to-repo dest/repo`;
+  gh-axi issue transfer 42 -R source/repo --to-repo dest/repo
+  gh-axi issue subissue add 16 20 101 125
+  gh-axi issue subissue list 16`;
+export const SUBISSUE_HELP = `usage: gh-axi issue subissue <add|remove|list> <parent> [child...]
+subcommands[3]:
+  add <parent> <child> [<child> ...], remove <parent> <child>, list <parent>
+examples:
+  gh-axi issue subissue add 16 20 101 125
+  gh-axi issue subissue remove 16 101
+  gh-axi issue subissue list 16`;
 // ---------------------------------------------------------------------------
 // Field schemas
 // ---------------------------------------------------------------------------
@@ -42,17 +53,31 @@ const listSchema = [
     pluck("author", "login", "author"),
     relativeTime("createdAt", "created"),
 ];
+const issueTypeField = custom("type", (item) => {
+    const it = item.issueType;
+    if (it && typeof it === "object") {
+        const name = it.name;
+        if (typeof name === "string" && name.length > 0)
+            return name;
+    }
+    return "none";
+});
 const viewSchema = [
     field("number"),
     field("title"),
     lower("state"),
     pluck("author", "login", "author"),
     relativeTime("createdAt", "created"),
+    issueTypeField,
     custom("body", (item) => truncateBody(item.body, 500)),
 ];
+const viewSchemaWithoutType = viewSchema.filter((f) => f !== issueTypeField);
 const viewSchemaFull = viewSchema.map((f) => "as" in f && f.as === "body"
     ? custom("body", (item) => typeof item.body === "string" ? item.body : "")
     : f);
+const viewSchemaFullWithoutType = viewSchemaWithoutType.map((f) => "as" in f && f.as === "body"
+    ? custom("body", (item) => typeof item.body === "string" ? item.body : "")
+    : f);
 const createResultSchema = [
     field("number"),
     field("title"),
@@ -179,18 +204,132 @@ async function viewIssue(args, ctx) {
     const num = requireNumber(getPositional(args, 1), "issue");
     const withComments = hasFlag(args, "--comments");
     const full = hasFlag(args, "--full");
-    const fields = "number,title,state,author,createdAt,body" +
+    const baseFields = "number,title,state,author,createdAt,body" +
         (withComments ? ",comments" : "");
+    const fields = baseFields + ",issueType";
     const ghArgs = ["issue", "view", String(num), "--json", fields];
-    const item = await ghJson(ghArgs, ctx);
-    const blocks = [
-        renderDetail("issue", item, full ? viewSchemaFull : viewSchema),
-    ];
+    let item;
+    let supportsIssueType = true;
+    try {
+        item = await ghJson(ghArgs, ctx);
+    }
+    catch (e) {
+        if (e instanceof AxiError && /issueType/i.test(e.message)) {
+            supportsIssueType = false;
+            item = await ghJson(["issue", "view", String(num), "--json", baseFields], ctx);
+        }
+        else {
+            throw e;
+        }
+    }
+    const baseSchema = supportsIssueType
+        ? full
+            ? viewSchemaFull
+            : viewSchema
+        : full
+            ? viewSchemaFullWithoutType
+            : viewSchemaWithoutType;
+    // Best-effort augmentation with sub-issue relationships. The sub-issues API
+    // is only available via GraphQL and requires repo context; failures here
+    // should not block the primary view output.
+    let parentNum = null;
+    let childNums = [];
+    if (ctx) {
+        try {
+            const rel = await fetchSubIssueRelationships(num, ctx);
+            parentNum = rel.parent;
+            childNums = rel.subIssues;
+        }
+        catch {
+            // Sub-issues are a preview feature on some repos; ignore failures.
+        }
+    }
+    const schema = [...baseSchema];
+    const augmented = { ...item };
+    if (childNums.length > 0) {
+        augmented._subissues = childNums.map((n) => `#${n}`);
+        schema.push(custom("subissues", (it) => it._subissues));
+    }
+    if (parentNum != null) {
+        augmented._parent = `#${parentNum}`;
+        schema.push(custom("parent", (it) => it._parent));
+    }
+    const blocks = [renderDetail("issue", augmented, schema)];
     if (withComments && Array.isArray(item.comments)) {
         blocks.push(renderList("comments", item.comments, commentResultSchema.filter((d) => "key" in d ? d.key !== "number" : true)));
     }
     return renderOutput(blocks);
 }
+function getOptionalRequiredFlag(args, name) {
+    if (!hasFlag(args, name))
+        return undefined;
+    const value = getFlag(args, name);
+    if (value === undefined || value.trim() === "" || value.startsWith("--")) {
+        throw new AxiError(`${name} requires a value`, "VALIDATION_ERROR");
+    }
+    return value;
+}
+async function getOwnerName(ctx) {
+    if (ctx)
+        return { owner: ctx.owner, name: ctx.name };
+    const repo = await ghJson([
+        "repo",
+        "view",
+        "--json",
+        "owner,name",
+    ]);
+    return { owner: repo.owner.login, name: repo.name };
+}
+async function resolveIssueType(typeName, ctx) {
+    const { owner, name } = await getOwnerName(ctx);
+    const query = "query($owner:String!,$name:String!){repository(owner:$owner,name:$name){issueTypes(first:25){nodes{id name}}}}";
+    const result = await ghRaw([
+        "api",
+        "graphql",
+        "-f",
+        `owner=${owner}`,
+        "-f",
+        `name=${name}`,
+        "-f",
+        `query=${query}`,
+    ]);
+    if (result.exitCode !== 0) {
+        throw mapGhError(result.stderr, result.exitCode);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(result.stdout);
+    }
+    catch {
+        throw new AxiError("Unable to resolve issue types from GitHub", "UNKNOWN");
+    }
+    const nodes = parsed?.data?.repository?.issueTypes?.nodes;
+    if (!Array.isArray(nodes) || nodes.length === 0) {
+        throw new AxiError(`Issue types are not configured for this repository. Enable them in repo settings before using --type.`, "VALIDATION_ERROR");
+    }
+    const wanted = typeName.toLowerCase();
+    const match = nodes.find((n) => typeof n?.name === "string" && n.name.toLowerCase() === wanted);
+    if (!match) {
+        const available = nodes
+            .map((n) => n?.name)
+            .filter((s) => typeof s === "string");
+        throw new AxiError(`Unknown issue type "${typeName}". Available types: ${available.join(", ")}`, "VALIDATION_ERROR");
+    }
+    return { id: match.id, name: match.name };
+}
+async function applyIssueType(issueNodeId, typeId) {
+    const mutation = typeId === null
+        ? `mutation($id:ID!){updateIssue(input:{id:$id,issueTypeId:null}){issue{id}}}`
+        : `mutation($id:ID!,$typeId:ID!){updateIssue(input:{id:$id,issueTypeId:$typeId}){issue{id}}}`;
+    const args = ["api", "graphql", "-f", `id=${issueNodeId}`];
+    if (typeId !== null)
+        args.push("-f", `typeId=${typeId}`);
+    args.push("-f", `query=${mutation}`);
+    const result = await ghRaw(args);
+    if (result.exitCode !== 0) {
+        throw mapGhError(result.stderr, result.exitCode);
+    }
+}
 async function createIssue(args, ctx) {
     const title = getFlag(args, "--title");
     if (!title)
@@ -200,6 +339,12 @@ async function createIssue(args, ctx) {
     const label = getFlag(args, "--label");
     const milestone = getFlag(args, "--milestone");
     const project = getFlag(args, "--project");
+    const typeName = getOptionalRequiredFlag(args, "--type");
+    // Resolve type up front so an invalid value fails before creating the issue.
+    let resolvedType;
+    if (typeName) {
+        resolvedType = await resolveIssueType(typeName, ctx);
+    }
     const ghArgs = ["issue", "create", "--title", title];
     if (body)
         ghArgs.push("--body", body);
@@ -218,9 +363,19 @@ async function createIssue(args, ctx) {
     const url = urlMatch ? urlMatch[0] : output.trim();
     const numMatch = url.match(/\/issues\/(\d+)/);
     const num = numMatch ? parseInt(numMatch[1], 10) : 0;
-    // Fetch the created issue for structured output
-    const item = await ghJson(["issue", "view", String(num), "--json", "number,title,state,url"], ctx);
-    const blocks = [renderDetail("issue", item, createResultSchema)];
+    // Fetch the created issue for structured output; include id for type mutation
+    const item = await ghJson(["issue", "view", String(num), "--json", "number,title,state,url,id"], ctx);
+    if (resolvedType) {
+        const issueNodeId = item.id;
+        if (typeof issueNodeId === "string" && issueNodeId.length > 0) {
+            await applyIssueType(issueNodeId, resolvedType.id);
+        }
+        item.issueType = { name: resolvedType.name };
+    }
+    const schema = resolvedType
+        ? [...createResultSchema, issueTypeField]
+        : createResultSchema;
+    const blocks = [renderDetail("issue", item, schema)];
     const help = getSuggestions({
         domain: "issue",
         action: "create",
@@ -239,6 +394,14 @@ async function editIssue(args, ctx) {
     const addAssignee = getFlag(args, "--add-assignee");
     const removeAssignee = getFlag(args, "--remove-assignee");
     const milestone = getFlag(args, "--milestone");
+    const clearType = takeBoolFlag(args, "--no-type");
+    const typeName = getOptionalRequiredFlag(args, "--type");
+    const clearTypeFlag = clearType;
+    // Resolve type up front so an invalid value fails before mutating the issue.
+    let resolvedType;
+    if (typeName) {
+        resolvedType = await resolveIssueType(typeName, ctx);
+    }
     const ghArgs = ["issue", "edit", String(num)];
     if (title)
         ghArgs.push("--title", title);
@@ -254,16 +417,30 @@ async function editIssue(args, ctx) {
         ghArgs.push("--remove-assignee", removeAssignee);
     if (milestone)
         ghArgs.push("--milestone", milestone);
-    await ghExec(ghArgs, ctx);
-    // Fetch updated issue
+    // Only call `gh issue edit` if there is a non-type field to update; otherwise
+    // calling with just the issue number errors out.
+    if (ghArgs.length > 3) {
+        await ghExec(ghArgs, ctx);
+    }
+    // Fetch updated issue (include id for type mutation)
     const item = await ghJson([
         "issue",
         "view",
         String(num),
         "--json",
-        "number,title,state,labels,assignees",
+        "number,title,state,labels,assignees,id",
     ], ctx);
-    const blocks = [renderDetail("issue", item, editResultSchema)];
+    if (resolvedType || clearTypeFlag) {
+        const issueNodeId = item.id;
+        if (typeof issueNodeId === "string" && issueNodeId.length > 0) {
+            await applyIssueType(issueNodeId, resolvedType ? resolvedType.id : null);
+        }
+        item.issueType = resolvedType ? { name: resolvedType.name } : null;
+    }
+    const schema = resolvedType || clearTypeFlag
+        ? [...editResultSchema, issueTypeField]
+        : editResultSchema;
+    const blocks = [renderDetail("issue", item, schema)];
     const help = getSuggestions({
         domain: "issue",
         action: "edit",
@@ -573,11 +750,178 @@ async function transferIssue(args, ctx) {
     blocks.push(renderHelp(help));
     return renderOutput(blocks);
 }
+function requireRepo(ctx) {
+    if (!ctx) {
+        throw new AxiError("Could not determine repository — pass --repo <owner/name> or run inside a git checkout", "VALIDATION_ERROR");
+    }
+    return ctx;
+}
+async function gqlRequest(query, ctx) {
+    // Don't pass ctx through to ghJson — `gh api graphql` ignores --repo, and
+    // passing it produces a deprecation warning. The owner/name are baked into
+    // the query string instead.
+    void ctx;
+    const data = await ghJson([
+        "api",
+        "graphql",
+        "-f",
+        `query=${query}`,
+    ]);
+    return data.data;
+}
+async function resolveIssueIds(parent, children, ctx) {
+    const childFields = children
+        .map((n, i) => `c${i}: issue(number: ${n}) { id number }`)
+        .join(" ");
+    const query = `query { repository(owner: "${ctx.owner}", name: "${ctx.name}") { parent: issue(number: ${parent}) { id number } ${childFields} } }`;
+    const result = await gqlRequest(query, ctx);
+    const repo = result.repository ?? {};
+    const parentNode = repo.parent;
+    if (!parentNode) {
+        throw new AxiError(`Issue #${parent} not found in ${ctx.nwo}`, "NOT_FOUND");
+    }
+    const childNodes = [];
+    for (let i = 0; i < children.length; i++) {
+        const node = repo[`c${i}`];
+        if (!node) {
+            throw new AxiError(`Issue #${children[i]} not found in ${ctx.nwo}`, "NOT_FOUND");
+        }
+        childNodes.push(node);
+    }
+    return { parent: parentNode, children: childNodes };
+}
+async function subissueAdd(args, ctx) {
+    const repo = requireRepo(ctx);
+    const parentRaw = args[2];
+    const childRaw = args.slice(3).filter((a) => !a.startsWith("--"));
+    const parentNum = requireNumber(parentRaw, "parent");
+    if (childRaw.length === 0) {
+        throw new AxiError("subissue add requires at least one child issue number", "VALIDATION_ERROR");
+    }
+    const childNums = childRaw.map((r) => requireNumber(r, "child"));
+    const { parent, children } = await resolveIssueIds(parentNum, childNums, repo);
+    const addedNumbers = [];
+    for (const child of children) {
+        const mutation = `mutation { addSubIssue(input: { issueId: "${parent.id}", subIssueId: "${child.id}" }) { subIssue { number } } }`;
+        let result;
+        try {
+            result = await gqlRequest(mutation, repo);
+        }
+        catch (error) {
+            if (addedNumbers.length === 0)
+                throw error;
+            const added = addedNumbers.map((n) => `#${n}`).join(", ");
+            if (error instanceof AxiError) {
+                throw new AxiError(`${error.message}\nAdded before failure: ${added}`, error.code);
+            }
+            throw new AxiError(`Failed to add sub-issue #${child.number}\nAdded before failure: ${added}`, "UNKNOWN");
+        }
+        const r = result.addSubIssue;
+        if (r?.subIssue?.number != null)
+            addedNumbers.push(r.subIssue.number);
+        else
+            addedNumbers.push(child.number);
+    }
+    const item = {
+        parent: `#${parent.number}`,
+        added: addedNumbers.map((n) => `#${n}`),
+    };
+    const blocks = [
+        renderDetail("subissue_add", item, [
+            field("parent"),
+            custom("added", (it) => it.added),
+        ]),
+    ];
+    blocks.push(renderHelp([
+        `Run \`gh-axi issue view ${parent.number}\` to see the parent with its sub-issues`,
+    ]));
+    return renderOutput(blocks);
+}
+async function subissueRemove(args, ctx) {
+    const repo = requireRepo(ctx);
+    const parentRaw = args[2];
+    const childRaw = args[3];
+    const parentNum = requireNumber(parentRaw, "parent");
+    if (!childRaw) {
+        throw new AxiError("subissue remove requires a child issue number", "VALIDATION_ERROR");
+    }
+    const childNum = requireNumber(childRaw, "child");
+    const { parent, children } = await resolveIssueIds(parentNum, [childNum], repo);
+    const child = children[0];
+    const mutation = `mutation { removeSubIssue(input: { issueId: "${parent.id}", subIssueId: "${child.id}" }) { issue { number } } }`;
+    await gqlRequest(mutation, repo);
+    const item = {
+        parent: `#${parent.number}`,
+        removed: `#${child.number}`,
+    };
+    const blocks = [
+        renderDetail("subissue_remove", item, [field("parent"), field("removed")]),
+    ];
+    blocks.push(renderHelp([
+        `Run \`gh-axi issue subissue list ${parent.number}\` to see remaining sub-issues`,
+    ]));
+    return renderOutput(blocks);
+}
+async function subissueList(args, ctx) {
+    const repo = requireRepo(ctx);
+    const parentRaw = args[2];
+    const parentNum = requireNumber(parentRaw, "parent");
+    const query = `query { repository(owner: "${repo.owner}", name: "${repo.name}") { issue(number: ${parentNum}) { subIssues(first: 100) { totalCount nodes { number title state } } } } }`;
+    const data = await gqlRequest(query, repo);
+    const issue = data.repository?.issue;
+    if (!issue) {
+        throw new AxiError(`Issue #${parentNum} not found in ${repo.nwo}`, "NOT_FOUND");
+    }
+    const nodes = issue.subIssues.nodes ?? [];
+    const totalCount = issue.subIssues.totalCount ?? nodes.length;
+    const countLine = formatCountLine({
+        count: nodes.length,
+        limit: 100,
+        totalCount,
+    });
+    const schema = [field("number"), field("title"), lower("state")];
+    const blocks = [
+        `parent: #${parentNum}`,
+        countLine,
+        renderList("subissues", nodes, schema),
+    ];
+    return renderOutput(blocks);
+}
+async function fetchSubIssueRelationships(num, ctx) {
+    const query = `query { repository(owner: "${ctx.owner}", name: "${ctx.name}") { issue(number: ${num}) { parent { number } subIssues(first: 100) { totalCount nodes { number } } } } }`;
+    const data = await gqlRequest(query, ctx);
+    const issue = data.repository?.issue;
+    if (!issue)
+        return { parent: null, subIssues: [] };
+    return {
+        parent: issue.parent?.number ?? null,
+        subIssues: (issue.subIssues?.nodes ?? []).map((n) => n.number),
+    };
+}
+async function subissueCommand(args, ctx) {
+    const sub = args[1];
+    if (!sub || hasFlag(args, "--help")) {
+        return renderOutput([SUBISSUE_HELP]);
+    }
+    switch (sub) {
+        case "add":
+            return subissueAdd(args, ctx);
+        case "remove":
+            return subissueRemove(args, ctx);
+        case "list":
+            return subissueList(args, ctx);
+        default:
+            return renderError(`Unknown subissue subcommand: ${sub}`, "VALIDATION_ERROR", ["Run `gh-axi issue subissue --help` for usage"]);
+    }
+}
 // ---------------------------------------------------------------------------
 // Main dispatcher
 // ---------------------------------------------------------------------------
 export async function issueCommand(args, ctx) {
     const sub = args[0];
+    if (sub === "subissue") {
+        return subissueCommand(args, ctx);
+    }
     if (!sub || hasFlag(args, "--help")) {
         const blocks = [ISSUE_HELP];
         const help = getSuggestions({ domain: "issue", action: "help", repo: ctx });