@sanity/cli 8.22.1 → 8.23.0

package/dist/commands/context/entries/rebuild.js

@@ -0,0 +1,95 @@
+import { Args, Flags } from '@oclif/core';
+import { exitCodes, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { spinner } from '@sanity/cli-core/ux';
+import { isHttpError } from '@sanity/client';
+import { formatJobFailure, watchJob } from '../../../actions/context/watchJob.js';
+import { formatKeyValue } from '../../../actions/debug/output.js';
+import { rebuildEntry } from '../../../services/context.js';
+const rebuildEntryDebug = subdebug('context:entries:rebuild');
+export class RebuildEntryCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        }),
+        path: Args.string({
+            description: 'Entry path, as listed by `sanity context entries list`',
+            required: true
+        })
+    };
+    static description = 'Rebuild one entry from its sources';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 billing/refunds',
+            description: 'Start a rebuild and return the job ID'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 billing/refunds --watch',
+            description: 'Rebuild an entry and wait for it to finish (non-zero exit on failure)'
+        }
+    ];
+    static flags = {
+        watch: Flags.boolean({
+            default: false,
+            description: 'Wait for the rebuild to finish, exiting non-zero if it fails'
+        })
+    };
+    async run() {
+        const { knowledgeBaseId, path } = this.args;
+        const { watch } = this.flags;
+        let accepted;
+        const spin = spinner('Starting rebuild').start();
+        try {
+            accepted = await rebuildEntry(knowledgeBaseId, path);
+            spin.succeed('Rebuild started');
+        } catch (error) {
+            spin.fail();
+            rebuildEntryDebug('Error starting rebuild', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Entry "${path}" not found on knowledge base "${knowledgeBaseId}"`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to start rebuild: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        const { affectedEntries, jobId } = accepted;
+        const padTo = 19 // "Shares sources with" is the longest key
+        ;
+        this.log(formatKeyValue('Job ID', jobId, {
+            padTo
+        }));
+        // Other entries citing the same sources can change when they are next rebuilt
+        if (affectedEntries.length > 0) {
+            const paths = affectedEntries.map((entry)=>entry.path).join(', ');
+            this.log(formatKeyValue('Shares sources with', paths, {
+                padTo
+            }));
+        }
+        this.log(`Track it with: sanity context jobs get ${knowledgeBaseId} ${jobId}`);
+        if (!watch) {
+            return;
+        }
+        let job;
+        try {
+            job = await watchJob(knowledgeBaseId, jobId, {
+                label: 'Rebuilding entry',
+                successText: 'Entry rebuilt'
+            });
+        } catch (error) {
+            rebuildEntryDebug('Error watching rebuild job', error);
+            this.error(`Failed to watch rebuild job: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        if (job.status !== 'succeeded') {
+            this.error(formatJobFailure('Rebuild', job), {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=rebuild.js.map

package/dist/commands/context/entries/rebuild.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/entries/rebuild.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {type FlagInput} from '@oclif/core/interfaces'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {spinner} from '@sanity/cli-core/ux'\nimport {isHttpError} from '@sanity/client'\n\nimport {formatJobFailure, watchJob} from '../../../actions/context/watchJob.js'\nimport {formatKeyValue} from '../../../actions/debug/output.js'\nimport {rebuildEntry} from '../../../services/context.js'\n\nconst rebuildEntryDebug = subdebug('context:entries:rebuild')\n\nexport class RebuildEntryCommand extends SanityCommand<typeof RebuildEntryCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n    path: Args.string({\n      description: 'Entry path, as listed by `sanity context entries list`',\n      required: true,\n    }),\n  }\n\n  static override description = 'Rebuild one entry from its sources'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 billing/refunds',\n      description: 'Start a rebuild and return the job ID',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 billing/refunds --watch',\n      description: 'Rebuild an entry and wait for it to finish (non-zero exit on failure)',\n    },\n  ]\n\n  static override flags = {\n    watch: Flags.boolean({\n      default: false,\n      description: 'Wait for the rebuild to finish, exiting non-zero if it fails',\n    }),\n  } satisfies FlagInput\n\n  public async run(): Promise<void> {\n    const {knowledgeBaseId, path} = this.args\n    const {watch} = this.flags\n\n    let accepted\n    const spin = spinner('Starting rebuild').start()\n    try {\n      accepted = await rebuildEntry(knowledgeBaseId, path)\n      spin.succeed('Rebuild started')\n    } catch (error) {\n      spin.fail()\n      rebuildEntryDebug('Error starting rebuild', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Entry \"${path}\" not found on knowledge base \"${knowledgeBaseId}\"`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to start rebuild: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    const {affectedEntries, jobId} = accepted\n    const padTo = 19 // \"Shares sources with\" is the longest key\n    this.log(formatKeyValue('Job ID', jobId, {padTo}))\n    // Other entries citing the same sources can change when they are next rebuilt\n    if (affectedEntries.length > 0) {\n      const paths = affectedEntries.map((entry) => entry.path).join(', ')\n      this.log(formatKeyValue('Shares sources with', paths, {padTo}))\n    }\n    this.log(`Track it with: sanity context jobs get ${knowledgeBaseId} ${jobId}`)\n\n    if (!watch) {\n      return\n    }\n\n    let job\n    try {\n      job = await watchJob(knowledgeBaseId, jobId, {\n        label: 'Rebuilding entry',\n        successText: 'Entry rebuilt',\n      })\n    } catch (error) {\n      rebuildEntryDebug('Error watching rebuild job', error)\n      this.error(`Failed to watch rebuild job: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (job.status !== 'succeeded') {\n      this.error(formatJobFailure('Rebuild', job), {exit: exitCodes.RUNTIME_ERROR})\n    }\n  }\n}\n"],"names":["Args","Flags","exitCodes","SanityCommand","subdebug","getErrorMessage","spinner","isHttpError","formatJobFailure","watchJob","formatKeyValue","rebuildEntry","rebuildEntryDebug","RebuildEntryCommand","args","knowledgeBaseId","string","description","required","path","examples","command","flags","watch","boolean","default","run","accepted","spin","start","succeed","error","fail","statusCode","exit","RUNTIME_ERROR","affectedEntries","jobId","padTo","log","length","paths","map","entry","join","job","label","successText","status"],"mappings":"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"}

package/dist/commands/context/issues/apply.js

@@ -0,0 +1,86 @@
+import { Args, Flags } from '@oclif/core';
+import { exitCodes, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { spinner } from '@sanity/cli-core/ux';
+import { isHttpError } from '@sanity/client';
+import { formatJobFailure, watchJob } from '../../../actions/context/watchJob.js';
+import { formatKeyValue } from '../../../actions/debug/output.js';
+import { applyIssues } from '../../../services/context.js';
+const applyIssuesDebug = subdebug('context:issues:apply');
+export class ApplyIssuesCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        }),
+        // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first
+        issueId: Args.string({
+            description: "ID of an issue to accept and apply (pass several to apply them in one batch). Conflicts can't be applied; resolve them with `sanity context issues resolve`",
+            multiple: true,
+            required: true
+        })
+    };
+    static description = 'Accept and apply issues to a knowledge base';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456 issue.ghi789',
+            description: 'Accept and apply two issues in one batch'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456 --watch',
+            description: 'Apply an issue and wait for it to finish (non-zero exit on failure)'
+        }
+    ];
+    static flags = {
+        watch: Flags.boolean({
+            default: false,
+            description: 'Wait for the apply to finish, exiting non-zero if it fails'
+        })
+    };
+    async run() {
+        const { issueId: issueIds, knowledgeBaseId } = this.args;
+        const { watch } = this.flags;
+        let jobId;
+        const spin = spinner('Starting apply').start();
+        try {
+            const accepted = await applyIssues(knowledgeBaseId, issueIds);
+            jobId = accepted.jobId;
+            spin.succeed('Apply started');
+        } catch (error) {
+            spin.fail();
+            applyIssuesDebug('Error applying issues', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Knowledge base "${knowledgeBaseId}" not found`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to apply issues: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        this.log(formatKeyValue('Job ID', jobId));
+        this.log(`Track it with: sanity context jobs get ${knowledgeBaseId} ${jobId}`);
+        if (!watch) {
+            return;
+        }
+        let job;
+        try {
+            job = await watchJob(knowledgeBaseId, jobId, {
+                label: 'Applying issues',
+                successText: 'Issues applied'
+            });
+        } catch (error) {
+            applyIssuesDebug('Error watching apply job', error);
+            this.error(`Failed to watch apply job: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        if (job.status !== 'succeeded') {
+            this.error(formatJobFailure('Apply', job), {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+    }
+}
+
+//# sourceMappingURL=apply.js.map

package/dist/commands/context/issues/apply.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/issues/apply.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {type FlagInput} from '@oclif/core/interfaces'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {spinner} from '@sanity/cli-core/ux'\nimport {isHttpError} from '@sanity/client'\n\nimport {formatJobFailure, watchJob} from '../../../actions/context/watchJob.js'\nimport {formatKeyValue} from '../../../actions/debug/output.js'\nimport {applyIssues} from '../../../services/context.js'\n\nconst applyIssuesDebug = subdebug('context:issues:apply')\n\nexport class ApplyIssuesCommand extends SanityCommand<typeof ApplyIssuesCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n    // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first\n    issueId: Args.string({\n      description:\n        \"ID of an issue to accept and apply (pass several to apply them in one batch). Conflicts can't be applied; resolve them with `sanity context issues resolve`\",\n      multiple: true,\n      required: true,\n    }),\n  }\n\n  static override description = 'Accept and apply issues to a knowledge base'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456 issue.ghi789',\n      description: 'Accept and apply two issues in one batch',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456 --watch',\n      description: 'Apply an issue and wait for it to finish (non-zero exit on failure)',\n    },\n  ]\n\n  static override flags = {\n    watch: Flags.boolean({\n      default: false,\n      description: 'Wait for the apply to finish, exiting non-zero if it fails',\n    }),\n  } satisfies FlagInput\n\n  public async run(): Promise<void> {\n    const {issueId: issueIds, knowledgeBaseId} = this.args\n    const {watch} = this.flags\n\n    let jobId: string\n    const spin = spinner('Starting apply').start()\n    try {\n      const accepted = await applyIssues(knowledgeBaseId, issueIds)\n      jobId = accepted.jobId\n      spin.succeed('Apply started')\n    } catch (error) {\n      spin.fail()\n      applyIssuesDebug('Error applying issues', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Knowledge base \"${knowledgeBaseId}\" not found`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to apply issues: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    this.log(formatKeyValue('Job ID', jobId))\n    this.log(`Track it with: sanity context jobs get ${knowledgeBaseId} ${jobId}`)\n\n    if (!watch) {\n      return\n    }\n\n    let job\n    try {\n      job = await watchJob(knowledgeBaseId, jobId, {\n        label: 'Applying issues',\n        successText: 'Issues applied',\n      })\n    } catch (error) {\n      applyIssuesDebug('Error watching apply job', error)\n      this.error(`Failed to watch apply job: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (job.status !== 'succeeded') {\n      this.error(formatJobFailure('Apply', job), {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n  }\n}\n"],"names":["Args","Flags","exitCodes","SanityCommand","subdebug","getErrorMessage","spinner","isHttpError","formatJobFailure","watchJob","formatKeyValue","applyIssues","applyIssuesDebug","ApplyIssuesCommand","args","knowledgeBaseId","string","description","required","issueId","multiple","examples","command","flags","watch","boolean","default","run","issueIds","jobId","spin","start","accepted","succeed","error","fail","statusCode","exit","RUNTIME_ERROR","log","job","label","successText","status"],"mappings":"AAAA,SAAQA,IAAI,EAAEC,KAAK,QAAO,cAAa;AAEvC,SAAQC,SAAS,EAAEC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACnE,SAAQC,eAAe,QAAO,0BAAyB;AACvD,SAAQC,OAAO,QAAO,sBAAqB;AAC3C,SAAQC,WAAW,QAAO,iBAAgB;AAE1C,SAAQC,gBAAgB,EAAEC,QAAQ,QAAO,uCAAsC;AAC/E,SAAQC,cAAc,QAAO,mCAAkC;AAC/D,SAAQC,WAAW,QAAO,+BAA8B;AAExD,MAAMC,mBAAmBR,SAAS;AAElC,OAAO,MAAMS,2BAA2BV;IACtC,OAAgBW,OAAO;QACrBC,iBAAiBf,KAAKgB,MAAM,CAAC;YAC3BC,aAAa;YACbC,UAAU;QACZ;QACA,gGAAgG;QAChGC,SAASnB,KAAKgB,MAAM,CAAC;YACnBC,aACE;YACFG,UAAU;YACVF,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,8CAA6C;IAE3E,OAAgBI,WAAW;QACzB;YACEC,SAAS;YACTL,aAAa;QACf;QACA;YACEK,SAAS;YACTL,aAAa;QACf;KACD,CAAA;IAED,OAAgBM,QAAQ;QACtBC,OAAOvB,MAAMwB,OAAO,CAAC;YACnBC,SAAS;YACTT,aAAa;QACf;IACF,EAAqB;IAErB,MAAaU,MAAqB;QAChC,MAAM,EAACR,SAASS,QAAQ,EAAEb,eAAe,EAAC,GAAG,IAAI,CAACD,IAAI;QACtD,MAAM,EAACU,KAAK,EAAC,GAAG,IAAI,CAACD,KAAK;QAE1B,IAAIM;QACJ,MAAMC,OAAOxB,QAAQ,kBAAkByB,KAAK;QAC5C,IAAI;YACF,MAAMC,WAAW,MAAMrB,YAAYI,iBAAiBa;YACpDC,QAAQG,SAASH,KAAK;YACtBC,KAAKG,OAAO,CAAC;QACf,EAAE,OAAOC,OAAO;YACdJ,KAAKK,IAAI;YACTvB,iBAAiB,yBAAyBsB;YAC1C,IAAI3B,YAAY2B,UAAUA,MAAME,UAAU,KAAK,KAAK;gBAClD,IAAI,CAACF,KAAK,CAAC,CAAC,gBAAgB,EAAEnB,gBAAgB,WAAW,CAAC,EAAE;oBAC1DsB,MAAMnC,UAAUoC,aAAa;gBAC/B;YACF;YACA,IAAI,CAACJ,KAAK,CAAC,CAAC,wBAAwB,EAAE7B,gBAAgB6B,QAAQ,EAAE;gBAC9DG,MAAMnC,UAAUoC,aAAa;YAC/B;QACF;QAEA,IAAI,CAACC,GAAG,CAAC7B,eAAe,UAAUmB;QAClC,IAAI,CAACU,GAAG,CAAC,CAAC,uCAAuC,EAAExB,gBAAgB,CAAC,EAAEc,OAAO;QAE7E,IAAI,CAACL,OAAO;YACV;QACF;QAEA,IAAIgB;QACJ,IAAI;YACFA,MAAM,MAAM/B,SAASM,iBAAiBc,OAAO;gBAC3CY,OAAO;gBACPC,aAAa;YACf;QACF,EAAE,OAAOR,OAAO;YACdtB,iBAAiB,4BAA4BsB;YAC7C,IAAI,CAACA,KAAK,CAAC,CAAC,2BAA2B,EAAE7B,gBAAgB6B,QAAQ,EAAE;gBACjEG,MAAMnC,UAAUoC,aAAa;YAC/B;QACF;QAEA,IAAIE,IAAIG,MAAM,KAAK,aAAa;YAC9B,IAAI,CAACT,KAAK,CAAC1B,iBAAiB,SAASgC,MAAM;gBACzCH,MAAMnC,UAAUoC,aAAa;YAC/B;QACF;IACF;AACF"}

package/dist/commands/context/issues/dismiss.js

@@ -0,0 +1,52 @@
+import { Args } from '@oclif/core';
+import { exitCodes, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { isHttpError } from '@sanity/client';
+import { dismissIssue } from '../../../services/context.js';
+const dismissIssueDebug = subdebug('context:issues:dismiss');
+export class DismissIssueCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        }),
+        // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first
+        issueId: Args.string({
+            description: 'Issue ID',
+            required: true
+        })
+    };
+    static description = "Dismiss an issue\n\nDismissing is permanent: dismissed issues can't be reopened.";
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456',
+            description: 'Dismiss an issue'
+        }
+    ];
+    async run() {
+        const { issueId, knowledgeBaseId } = this.args;
+        let dismissed;
+        try {
+            dismissed = await dismissIssue(knowledgeBaseId, issueId);
+        } catch (error) {
+            dismissIssueDebug('Error dismissing issue', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Issue "${issueId}" not found on knowledge base "${knowledgeBaseId}"`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to dismiss issue: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        // The API returns the issue unchanged when it already left triage
+        if (dismissed.status !== 'rejected') {
+            this.error(`Issue "${issueId}" is accepted (resolved or applied) and cannot be dismissed`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        this.log('Issue dismissed');
+    }
+}
+
+//# sourceMappingURL=dismiss.js.map

package/dist/commands/context/issues/dismiss.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/issues/dismiss.ts"],"sourcesContent":["import {Args} from '@oclif/core'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {isHttpError} from '@sanity/client'\n\nimport {dismissIssue} from '../../../services/context.js'\n\nconst dismissIssueDebug = subdebug('context:issues:dismiss')\n\nexport class DismissIssueCommand extends SanityCommand<typeof DismissIssueCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n    // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first\n    issueId: Args.string({\n      description: 'Issue ID',\n      required: true,\n    }),\n  }\n\n  static override description =\n    \"Dismiss an issue\\n\\nDismissing is permanent: dismissed issues can't be reopened.\"\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456',\n      description: 'Dismiss an issue',\n    },\n  ]\n\n  public async run(): Promise<void> {\n    const {issueId, knowledgeBaseId} = this.args\n\n    let dismissed\n    try {\n      dismissed = await dismissIssue(knowledgeBaseId, issueId)\n    } catch (error) {\n      dismissIssueDebug('Error dismissing issue', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Issue \"${issueId}\" not found on knowledge base \"${knowledgeBaseId}\"`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to dismiss issue: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    // The API returns the issue unchanged when it already left triage\n    if (dismissed.status !== 'rejected') {\n      this.error(`Issue \"${issueId}\" is accepted (resolved or applied) and cannot be dismissed`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    this.log('Issue dismissed')\n  }\n}\n"],"names":["Args","exitCodes","SanityCommand","subdebug","getErrorMessage","isHttpError","dismissIssue","dismissIssueDebug","DismissIssueCommand","args","knowledgeBaseId","string","description","required","issueId","examples","command","run","dismissed","error","statusCode","exit","RUNTIME_ERROR","status","log"],"mappings":"AAAA,SAAQA,IAAI,QAAO,cAAa;AAChC,SAAQC,SAAS,EAAEC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACnE,SAAQC,eAAe,QAAO,0BAAyB;AACvD,SAAQC,WAAW,QAAO,iBAAgB;AAE1C,SAAQC,YAAY,QAAO,+BAA8B;AAEzD,MAAMC,oBAAoBJ,SAAS;AAEnC,OAAO,MAAMK,4BAA4BN;IACvC,OAAgBO,OAAO;QACrBC,iBAAiBV,KAAKW,MAAM,CAAC;YAC3BC,aAAa;YACbC,UAAU;QACZ;QACA,gGAAgG;QAChGC,SAASd,KAAKW,MAAM,CAAC;YACnBC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cACd,mFAAkF;IAEpF,OAAgBG,WAAW;QACzB;YACEC,SAAS;YACTJ,aAAa;QACf;KACD,CAAA;IAED,MAAaK,MAAqB;QAChC,MAAM,EAACH,OAAO,EAAEJ,eAAe,EAAC,GAAG,IAAI,CAACD,IAAI;QAE5C,IAAIS;QACJ,IAAI;YACFA,YAAY,MAAMZ,aAAaI,iBAAiBI;QAClD,EAAE,OAAOK,OAAO;YACdZ,kBAAkB,0BAA0BY;YAC5C,IAAId,YAAYc,UAAUA,MAAMC,UAAU,KAAK,KAAK;gBAClD,IAAI,CAACD,KAAK,CAAC,CAAC,OAAO,EAAEL,QAAQ,+BAA+B,EAAEJ,gBAAgB,CAAC,CAAC,EAAE;oBAChFW,MAAMpB,UAAUqB,aAAa;gBAC/B;YACF;YACA,IAAI,CAACH,KAAK,CAAC,CAAC,yBAAyB,EAAEf,gBAAgBe,QAAQ,EAAE;gBAC/DE,MAAMpB,UAAUqB,aAAa;YAC/B;QACF;QAEA,kEAAkE;QAClE,IAAIJ,UAAUK,MAAM,KAAK,YAAY;YACnC,IAAI,CAACJ,KAAK,CAAC,CAAC,OAAO,EAAEL,QAAQ,2DAA2D,CAAC,EAAE;gBACzFO,MAAMpB,UAAUqB,aAAa;YAC/B;QACF;QAEA,IAAI,CAACE,GAAG,CAAC;IACX;AACF"}

package/dist/commands/context/issues/get.js

@@ -0,0 +1,105 @@
+import { Args } from '@oclif/core';
+import { exitCodes, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { isHttpError } from '@sanity/client';
+import { formatKeyValue } from '../../../actions/debug/output.js';
+import { getIssue } from '../../../services/context.js';
+const getIssueDebug = subdebug('context:issues:get');
+export class GetIssueCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        }),
+        // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first
+        issueId: Args.string({
+            description: 'Issue ID',
+            required: true
+        })
+    };
+    static description = 'Get details of an issue';
+    static enableJsonFlag = true;
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456',
+            description: 'Get details of a specific issue'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456 --json',
+            description: 'Output the issue as JSON'
+        }
+    ];
+    async run() {
+        const { issueId, knowledgeBaseId } = this.args;
+        const { json } = this.flags;
+        let issue;
+        try {
+            issue = await getIssue(knowledgeBaseId, issueId);
+        } catch (error) {
+            getIssueDebug('Error getting issue', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Knowledge base "${knowledgeBaseId}" not found`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to get issue: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        if (!issue) {
+            this.error(`Issue "${issueId}" not found on knowledge base "${knowledgeBaseId}"`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        if (json) {
+            this.logJson(issue);
+            return;
+        }
+        const { content } = issue;
+        const padTo = 13 // "Suggested fix" is the longest key
+        ;
+        this.log(formatKeyValue('ID', issue._id, {
+            padTo
+        }));
+        this.log(formatKeyValue('Kind', content.kind, {
+            padTo
+        }));
+        this.log(formatKeyValue('Severity', content.severity, {
+            padTo
+        }));
+        this.log(formatKeyValue('Status', issue.status, {
+            padTo
+        }));
+        this.log(formatKeyValue('Scope', content.scopePath, {
+            padTo
+        }));
+        this.log(formatKeyValue('Issue', content.issue, {
+            padTo
+        }));
+        this.log(formatKeyValue('Suggested fix', content.suggestedFix, {
+            padTo
+        }));
+        // Sides are labeled with the 0-based index that `issues resolve --side` takes
+        if (content.kind === 'conflict') {
+            for (const [index, side] of content.sides.entries()){
+                const entryPaths = side.entryPaths?.length ? ` (${side.entryPaths.join(', ')})` : '';
+                this.log(formatKeyValue(`Side [${index}]`, `${side.claim}${entryPaths}`, {
+                    padTo
+                }));
+            }
+            if (content.suggested !== undefined) {
+                this.log(formatKeyValue('Suggested', `[${content.suggested}]`, {
+                    padTo
+                }));
+            }
+        }
+        this.log(formatKeyValue('Resolution', issue.resolution === null ? '-' : `[${issue.resolution}]`, {
+            padTo
+        }));
+        this.log(formatKeyValue('Created', issue._createdAt, {
+            padTo
+        }));
+    }
+}
+
+//# sourceMappingURL=get.js.map

package/dist/commands/context/issues/get.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/issues/get.ts"],"sourcesContent":["import {Args} from '@oclif/core'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {isHttpError} from '@sanity/client'\n\nimport {formatKeyValue} from '../../../actions/debug/output.js'\nimport {getIssue} from '../../../services/context.js'\n\nconst getIssueDebug = subdebug('context:issues:get')\n\nexport class GetIssueCommand extends SanityCommand<typeof GetIssueCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n    // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first\n    issueId: Args.string({\n      description: 'Issue ID',\n      required: true,\n    }),\n  }\n\n  static override description = 'Get details of an issue'\n\n  static override enableJsonFlag = true\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456',\n      description: 'Get details of a specific issue',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456 --json',\n      description: 'Output the issue as JSON',\n    },\n  ]\n\n  public async run(): Promise<void> {\n    const {issueId, knowledgeBaseId} = this.args\n    const {json} = this.flags\n\n    let issue\n    try {\n      issue = await getIssue(knowledgeBaseId, issueId)\n    } catch (error) {\n      getIssueDebug('Error getting issue', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Knowledge base \"${knowledgeBaseId}\" not found`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to get issue: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (!issue) {\n      this.error(`Issue \"${issueId}\" not found on knowledge base \"${knowledgeBaseId}\"`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (json) {\n      this.logJson(issue)\n      return\n    }\n\n    const {content} = issue\n    const padTo = 13 // \"Suggested fix\" is the longest key\n    this.log(formatKeyValue('ID', issue._id, {padTo}))\n    this.log(formatKeyValue('Kind', content.kind, {padTo}))\n    this.log(formatKeyValue('Severity', content.severity, {padTo}))\n    this.log(formatKeyValue('Status', issue.status, {padTo}))\n    this.log(formatKeyValue('Scope', content.scopePath, {padTo}))\n    this.log(formatKeyValue('Issue', content.issue, {padTo}))\n    this.log(formatKeyValue('Suggested fix', content.suggestedFix, {padTo}))\n    // Sides are labeled with the 0-based index that `issues resolve --side` takes\n    if (content.kind === 'conflict') {\n      for (const [index, side] of content.sides.entries()) {\n        const entryPaths = side.entryPaths?.length ? ` (${side.entryPaths.join(', ')})` : ''\n        this.log(formatKeyValue(`Side [${index}]`, `${side.claim}${entryPaths}`, {padTo}))\n      }\n      if (content.suggested !== undefined) {\n        this.log(formatKeyValue('Suggested', `[${content.suggested}]`, {padTo}))\n      }\n    }\n    this.log(\n      formatKeyValue('Resolution', issue.resolution === null ? '-' : `[${issue.resolution}]`, {\n        padTo,\n      }),\n    )\n    this.log(formatKeyValue('Created', issue._createdAt, {padTo}))\n  }\n}\n"],"names":["Args","exitCodes","SanityCommand","subdebug","getErrorMessage","isHttpError","formatKeyValue","getIssue","getIssueDebug","GetIssueCommand","args","knowledgeBaseId","string","description","required","issueId","enableJsonFlag","examples","command","run","json","flags","issue","error","statusCode","exit","RUNTIME_ERROR","logJson","content","padTo","log","_id","kind","severity","status","scopePath","suggestedFix","index","side","sides","entries","entryPaths","length","join","claim","suggested","undefined","resolution","_createdAt"],"mappings":"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"}

package/dist/commands/context/issues/list.js

@@ -0,0 +1,128 @@
+import { Args, Flags } from '@oclif/core';
+import { exitCodes, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { isHttpError } from '@sanity/client';
+import { listIssues } from '../../../services/context.js';
+const listIssuesDebug = subdebug('context:issues:list');
+export class ListIssuesCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        })
+    };
+    static description = 'List issues found by knowledge base builds';
+    static enableJsonFlag = true;
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123',
+            description: 'List all issues for a knowledge base'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 --status open',
+            description: 'List issues awaiting triage'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 --kind conflict --severity critical',
+            description: 'List critical conflicts'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 --scope billing',
+            description: 'List issues about entries under billing/'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 --json',
+            description: 'Output issues as JSON'
+        }
+    ];
+    static flags = {
+        kind: Flags.custom({
+            description: 'Only list issues of this kind',
+            // A Record forces every kind the client knows to be listed, so the options can't drift
+            options: Object.keys({
+                add_entry: true,
+                conflict: true,
+                gap: true,
+                merge_entry: true,
+                remove_entry: true,
+                split_entry: true,
+                update_required: true
+            })
+        })(),
+        scope: Flags.string({
+            description: 'Only list issues about this entry path or anything under it (`*` for knowledge-base-wide issues)',
+            helpValue: '<path>',
+            parse: async (input)=>{
+                const trimmed = input.trim().replace(/\/+$/, '');
+                if (trimmed === '') {
+                    throw new Error('`--scope` cannot be empty if provided');
+                }
+                return trimmed;
+            }
+        }),
+        severity: Flags.custom({
+            description: 'Only list issues of this severity',
+            options: [
+                'critical',
+                'suggestion'
+            ]
+        })(),
+        status: Flags.custom({
+            description: 'Only list issues with this status (rejected = dismissed, accepted = resolved or applied)',
+            options: [
+                'open',
+                'accepted',
+                'rejected'
+            ]
+        })()
+    };
+    async run() {
+        const { knowledgeBaseId } = this.args;
+        const { json, kind, scope, severity, status } = this.flags;
+        let issues;
+        try {
+            issues = await listIssues(knowledgeBaseId, status);
+        } catch (error) {
+            listIssuesDebug('Error listing issues', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Knowledge base "${knowledgeBaseId}" not found`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to list issues: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        // The client only filters on status; the rest are applied here
+        const matches = issues.filter(({ content })=>(kind === undefined || content.kind === kind) && (severity === undefined || content.severity === severity) && (scope === undefined || content.scopePath === scope || content.scopePath.startsWith(`${scope}/`)));
+        if (json) {
+            this.logJson(matches);
+            return;
+        }
+        if (matches.length === 0) {
+            this.log('No issues found');
+            return;
+        }
+        // Two lines per issue so long IDs never wrap: ID and metadata, then the summary cut to fit
+        const width = Math.max(process.stdout.columns ?? 100, 40);
+        const blocks = matches.map(({ _id, content, status: issueStatus })=>{
+            const meta = [
+                content.kind,
+                content.severity,
+                issueStatus,
+                content.scopePath
+            ].join(' · ');
+            return `${_id}  ${meta}\n  ${truncate(content.issue, width - 2)}`;
+        });
+        this.log(blocks.join('\n\n'));
+    }
+}
+function truncate(text, maxLength) {
+    // Count characters, not UTF-16 units, so an emoji at the cut point isn't split
+    const chars = [
+        ...text.replaceAll(/\s+/g, ' ').trim()
+    ];
+    return chars.length <= maxLength ? chars.join('') : `${chars.slice(0, maxLength - 1).join('')}…`;
+}
+
+//# sourceMappingURL=list.js.map

package/dist/commands/context/issues/list.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/issues/list.ts"],"sourcesContent":["import {Args, Flags} from '@oclif/core'\nimport {type FlagInput} from '@oclif/core/interfaces'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {type Context, isHttpError} from '@sanity/client'\n\nimport {listIssues} from '../../../services/context.js'\n\nconst listIssuesDebug = subdebug('context:issues:list')\n\nexport class ListIssuesCommand extends SanityCommand<typeof ListIssuesCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n  }\n\n  static override description = 'List issues found by knowledge base builds'\n\n  static override enableJsonFlag = true\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123',\n      description: 'List all issues for a knowledge base',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --status open',\n      description: 'List issues awaiting triage',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --kind conflict --severity critical',\n      description: 'List critical conflicts',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --scope billing',\n      description: 'List issues about entries under billing/',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --json',\n      description: 'Output issues as JSON',\n    },\n  ]\n\n  static override flags = {\n    kind: Flags.custom<IssueKind>({\n      description: 'Only list issues of this kind',\n      // A Record forces every kind the client knows to be listed, so the options can't drift\n      options: Object.keys({\n        add_entry: true,\n        conflict: true,\n        gap: true,\n        merge_entry: true,\n        remove_entry: true,\n        split_entry: true,\n        update_required: true,\n      } satisfies Record<IssueKind, true>),\n    })(),\n    scope: Flags.string({\n      description:\n        'Only list issues about this entry path or anything under it (`*` for knowledge-base-wide issues)',\n      helpValue: '<path>',\n      parse: async (input: string) => {\n        const trimmed = input.trim().replace(/\\/+$/, '')\n        if (trimmed === '') {\n          throw new Error('`--scope` cannot be empty if provided')\n        }\n        return trimmed\n      },\n    }),\n    severity: Flags.custom<Context.IssueDoc['content']['severity']>({\n      description: 'Only list issues of this severity',\n      options: ['critical', 'suggestion'],\n    })(),\n    status: Flags.custom<Context.IssueDoc['status']>({\n      description:\n        'Only list issues with this status (rejected = dismissed, accepted = resolved or applied)',\n      options: ['open', 'accepted', 'rejected'],\n    })(),\n  } satisfies FlagInput\n\n  public async run(): Promise<void> {\n    const {knowledgeBaseId} = this.args\n    const {json, kind, scope, severity, status} = this.flags\n\n    let issues\n    try {\n      issues = await listIssues(knowledgeBaseId, status)\n    } catch (error) {\n      listIssuesDebug('Error listing issues', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Knowledge base \"${knowledgeBaseId}\" not found`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to list issues: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    // The client only filters on status; the rest are applied here\n    const matches = issues.filter(\n      ({content}) =>\n        (kind === undefined || content.kind === kind) &&\n        (severity === undefined || content.severity === severity) &&\n        (scope === undefined ||\n          content.scopePath === scope ||\n          content.scopePath.startsWith(`${scope}/`)),\n    )\n\n    if (json) {\n      this.logJson(matches)\n      return\n    }\n\n    if (matches.length === 0) {\n      this.log('No issues found')\n      return\n    }\n\n    // Two lines per issue so long IDs never wrap: ID and metadata, then the summary cut to fit\n    const width = Math.max(process.stdout.columns ?? 100, 40)\n    const blocks = matches.map(({_id, content, status: issueStatus}) => {\n      const meta = [content.kind, content.severity, issueStatus, content.scopePath].join(' · ')\n      return `${_id}  ${meta}\\n  ${truncate(content.issue, width - 2)}`\n    })\n    this.log(blocks.join('\\n\\n'))\n  }\n}\n\ntype IssueKind = Context.IssueDoc['content']['kind']\n\nfunction truncate(text: string, maxLength: number): string {\n  // Count characters, not UTF-16 units, so an emoji at the cut point isn't split\n  const chars = [...text.replaceAll(/\\s+/g, ' ').trim()]\n  return chars.length <= maxLength ? chars.join('') : `${chars.slice(0, maxLength - 1).join('')}…`\n}\n"],"names":["Args","Flags","exitCodes","SanityCommand","subdebug","getErrorMessage","isHttpError","listIssues","listIssuesDebug","ListIssuesCommand","args","knowledgeBaseId","string","description","required","enableJsonFlag","examples","command","flags","kind","custom","options","Object","keys","add_entry","conflict","gap","merge_entry","remove_entry","split_entry","update_required","scope","helpValue","parse","input","trimmed","trim","replace","Error","severity","status","run","json","issues","error","statusCode","exit","RUNTIME_ERROR","matches","filter","content","undefined","scopePath","startsWith","logJson","length","log","width","Math","max","process","stdout","columns","blocks","map","_id","issueStatus","meta","join","truncate","issue","text","maxLength","chars","replaceAll","slice"],"mappings":"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"}

package/dist/commands/context/issues/reopen.js

@@ -0,0 +1,53 @@
+import { Args } from '@oclif/core';
+import { exitCodes, SanityCommand, subdebug } from '@sanity/cli-core';
+import { getErrorMessage } from '@sanity/cli-core/errors';
+import { isHttpError } from '@sanity/client';
+import { reopenIssue } from '../../../services/context.js';
+const reopenIssueDebug = subdebug('context:issues:reopen');
+export class ReopenIssueCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        }),
+        // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first
+        issueId: Args.string({
+            description: 'Issue ID',
+            required: true
+        })
+    };
+    static description = 'Reopen a resolved conflict issue';
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456',
+            description: 'Return a resolved conflict issue to triage'
+        }
+    ];
+    async run() {
+        const { issueId, knowledgeBaseId } = this.args;
+        let reopened;
+        try {
+            reopened = await reopenIssue(knowledgeBaseId, issueId);
+        } catch (error) {
+            reopenIssueDebug('Error reopening issue', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Issue "${issueId}" not found on knowledge base "${knowledgeBaseId}"`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to reopen issue: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        // The API returns the issue unchanged when it cannot be reopened
+        if (reopened.status !== 'open') {
+            const status = reopened.status === 'rejected' ? 'rejected (dismissed)' : 'accepted (resolved or applied)';
+            this.error(`Issue "${issueId}" is ${status} and cannot be reopened.\nOnly resolved conflict issues can be reopened.`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        this.log('Issue reopened');
+    }
+}
+
+//# sourceMappingURL=reopen.js.map

package/dist/commands/context/issues/reopen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/issues/reopen.ts"],"sourcesContent":["import {Args} from '@oclif/core'\nimport {exitCodes, SanityCommand, subdebug} from '@sanity/cli-core'\nimport {getErrorMessage} from '@sanity/cli-core/errors'\nimport {isHttpError} from '@sanity/client'\n\nimport {reopenIssue} from '../../../services/context.js'\n\nconst reopenIssueDebug = subdebug('context:issues:reopen')\n\nexport class ReopenIssueCommand extends SanityCommand<typeof ReopenIssueCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n    // eslint-disable-next-line perfectionist/sort-objects -- positional order: knowledge base first\n    issueId: Args.string({\n      description: 'Issue ID',\n      required: true,\n    }),\n  }\n\n  static override description = 'Reopen a resolved conflict issue'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 issue.def456',\n      description: 'Return a resolved conflict issue to triage',\n    },\n  ]\n\n  public async run(): Promise<void> {\n    const {issueId, knowledgeBaseId} = this.args\n\n    let reopened\n    try {\n      reopened = await reopenIssue(knowledgeBaseId, issueId)\n    } catch (error) {\n      reopenIssueDebug('Error reopening issue', error)\n      if (isHttpError(error) && error.statusCode === 404) {\n        this.error(`Issue \"${issueId}\" not found on knowledge base \"${knowledgeBaseId}\"`, {\n          exit: exitCodes.RUNTIME_ERROR,\n        })\n      }\n      this.error(`Failed to reopen issue: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    // The API returns the issue unchanged when it cannot be reopened\n    if (reopened.status !== 'open') {\n      const status =\n        reopened.status === 'rejected' ? 'rejected (dismissed)' : 'accepted (resolved or applied)'\n      this.error(\n        `Issue \"${issueId}\" is ${status} and cannot be reopened.\\nOnly resolved conflict issues can be reopened.`,\n        {exit: exitCodes.RUNTIME_ERROR},\n      )\n    }\n\n    this.log('Issue reopened')\n  }\n}\n"],"names":["Args","exitCodes","SanityCommand","subdebug","getErrorMessage","isHttpError","reopenIssue","reopenIssueDebug","ReopenIssueCommand","args","knowledgeBaseId","string","description","required","issueId","examples","command","run","reopened","error","statusCode","exit","RUNTIME_ERROR","status","log"],"mappings":"AAAA,SAAQA,IAAI,QAAO,cAAa;AAChC,SAAQC,SAAS,EAAEC,aAAa,EAAEC,QAAQ,QAAO,mBAAkB;AACnE,SAAQC,eAAe,QAAO,0BAAyB;AACvD,SAAQC,WAAW,QAAO,iBAAgB;AAE1C,SAAQC,WAAW,QAAO,+BAA8B;AAExD,MAAMC,mBAAmBJ,SAAS;AAElC,OAAO,MAAMK,2BAA2BN;IACtC,OAAgBO,OAAO;QACrBC,iBAAiBV,KAAKW,MAAM,CAAC;YAC3BC,aAAa;YACbC,UAAU;QACZ;QACA,gGAAgG;QAChGC,SAASd,KAAKW,MAAM,CAAC;YACnBC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,mCAAkC;IAEhE,OAAgBG,WAAW;QACzB;YACEC,SAAS;YACTJ,aAAa;QACf;KACD,CAAA;IAED,MAAaK,MAAqB;QAChC,MAAM,EAACH,OAAO,EAAEJ,eAAe,EAAC,GAAG,IAAI,CAACD,IAAI;QAE5C,IAAIS;QACJ,IAAI;YACFA,WAAW,MAAMZ,YAAYI,iBAAiBI;QAChD,EAAE,OAAOK,OAAO;YACdZ,iBAAiB,yBAAyBY;YAC1C,IAAId,YAAYc,UAAUA,MAAMC,UAAU,KAAK,KAAK;gBAClD,IAAI,CAACD,KAAK,CAAC,CAAC,OAAO,EAAEL,QAAQ,+BAA+B,EAAEJ,gBAAgB,CAAC,CAAC,EAAE;oBAChFW,MAAMpB,UAAUqB,aAAa;gBAC/B;YACF;YACA,IAAI,CAACH,KAAK,CAAC,CAAC,wBAAwB,EAAEf,gBAAgBe,QAAQ,EAAE;gBAC9DE,MAAMpB,UAAUqB,aAAa;YAC/B;QACF;QAEA,iEAAiE;QACjE,IAAIJ,SAASK,MAAM,KAAK,QAAQ;YAC9B,MAAMA,SACJL,SAASK,MAAM,KAAK,aAAa,yBAAyB;YAC5D,IAAI,CAACJ,KAAK,CACR,CAAC,OAAO,EAAEL,QAAQ,KAAK,EAAES,OAAO,wEAAwE,CAAC,EACzG;gBAACF,MAAMpB,UAAUqB,aAAa;YAAA;QAElC;QAEA,IAAI,CAACE,GAAG,CAAC;IACX;AACF"}