@sanity/cli 8.22.0 → 8.23.0

package/dist/commands/context/build.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/commands/context/build.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 {watchJob} from '../../actions/context/watchJob.js'\nimport {formatKeyValue} from '../../actions/debug/output.js'\nimport {buildKnowledgeBase, cancelKnowledgeBaseBuild} from '../../services/context.js'\n\nconst buildContextDebug = subdebug('context:build')\n\nexport class BuildKnowledgeBaseCommand extends SanityCommand<typeof BuildKnowledgeBaseCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n  }\n\n  static override description = 'Build a knowledge base from its imported content'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123',\n      description: 'Start a build and return the job ID',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --watch',\n      description: 'Start a build and wait for it to finish (non-zero exit on failure)',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --cancel',\n      description: 'Cancel the running build, if any',\n    },\n  ]\n\n  static override flags = {\n    cancel: Flags.boolean({\n      default: false,\n      description: 'Cancel the running build instead of starting one',\n      exclusive: ['watch'],\n    }),\n    watch: Flags.boolean({\n      default: false,\n      description: 'Wait for the build to finish, exiting non-zero if it fails',\n    }),\n  } satisfies FlagInput\n\n  public async run(): Promise<void> {\n    const {knowledgeBaseId} = this.args\n    const {cancel, watch} = this.flags\n\n    if (cancel) {\n      await this.cancelBuild(knowledgeBaseId)\n      return\n    }\n\n    let jobId: string\n    const spin = spinner('Starting build').start()\n    try {\n      const accepted = await buildKnowledgeBase(knowledgeBaseId)\n      jobId = accepted.jobId\n      spin.succeed('Build started')\n    } catch (error) {\n      spin.fail()\n      buildContextDebug('Error starting build', 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 start build: ${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: 'Building knowledge base',\n        successText: 'Build succeeded',\n      })\n    } catch (error) {\n      buildContextDebug('Error watching build job', error)\n      this.error(`Failed to watch build job: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (job.status !== 'succeeded') {\n      this.error(`Build ${job.status}${job.error ? `: ${job.error}` : ''}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n  }\n\n  private async cancelBuild(knowledgeBaseId: string): Promise<void> {\n    try {\n      const {cancelled} = await cancelKnowledgeBaseBuild(knowledgeBaseId)\n      this.log(cancelled ? 'Build cancelled' : 'No running build to cancel')\n    } catch (error) {\n      buildContextDebug('Error cancelling build', 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 cancel build: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n  }\n}\n"],"names":["Args","Flags","exitCodes","SanityCommand","subdebug","getErrorMessage","spinner","isHttpError","watchJob","formatKeyValue","buildKnowledgeBase","cancelKnowledgeBaseBuild","buildContextDebug","BuildKnowledgeBaseCommand","args","knowledgeBaseId","string","description","required","examples","command","flags","cancel","boolean","default","exclusive","watch","run","cancelBuild","jobId","spin","start","accepted","succeed","error","fail","statusCode","exit","RUNTIME_ERROR","log","job","label","successText","status","cancelled"],"mappings":"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"}
+{"version":3,"sources":["../../../src/commands/context/build.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 {buildKnowledgeBase, cancelKnowledgeBaseBuild} from '../../services/context.js'\n\nconst buildContextDebug = subdebug('context:build')\n\nexport class BuildKnowledgeBaseCommand extends SanityCommand<typeof BuildKnowledgeBaseCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n  }\n\n  static override description = 'Build a knowledge base from its imported content'\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123',\n      description: 'Start a build and return the job ID',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --watch',\n      description: 'Start a build and wait for it to finish (non-zero exit on failure)',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --cancel',\n      description: 'Cancel the running build, if any',\n    },\n  ]\n\n  static override flags = {\n    cancel: Flags.boolean({\n      default: false,\n      description: 'Cancel the running build instead of starting one',\n      exclusive: ['watch'],\n    }),\n    watch: Flags.boolean({\n      default: false,\n      description: 'Wait for the build to finish, exiting non-zero if it fails',\n    }),\n  } satisfies FlagInput\n\n  public async run(): Promise<void> {\n    const {knowledgeBaseId} = this.args\n    const {cancel, watch} = this.flags\n\n    if (cancel) {\n      await this.cancelBuild(knowledgeBaseId)\n      return\n    }\n\n    let jobId: string\n    const spin = spinner('Starting build').start()\n    try {\n      const accepted = await buildKnowledgeBase(knowledgeBaseId)\n      jobId = accepted.jobId\n      spin.succeed('Build started')\n    } catch (error) {\n      spin.fail()\n      buildContextDebug('Error starting build', 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 start build: ${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: 'Building knowledge base',\n        successText: 'Build succeeded',\n      })\n    } catch (error) {\n      buildContextDebug('Error watching build job', error)\n      this.error(`Failed to watch build job: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (job.status !== 'succeeded') {\n      this.error(formatJobFailure('Build', job), {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n  }\n\n  private async cancelBuild(knowledgeBaseId: string): Promise<void> {\n    try {\n      const {cancelled} = await cancelKnowledgeBaseBuild(knowledgeBaseId)\n      this.log(cancelled ? 'Build cancelled' : 'No running build to cancel')\n    } catch (error) {\n      buildContextDebug('Error cancelling build', 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 cancel build: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n  }\n}\n"],"names":["Args","Flags","exitCodes","SanityCommand","subdebug","getErrorMessage","spinner","isHttpError","formatJobFailure","watchJob","formatKeyValue","buildKnowledgeBase","cancelKnowledgeBaseBuild","buildContextDebug","BuildKnowledgeBaseCommand","args","knowledgeBaseId","string","description","required","examples","command","flags","cancel","boolean","default","exclusive","watch","run","cancelBuild","jobId","spin","start","accepted","succeed","error","fail","statusCode","exit","RUNTIME_ERROR","log","job","label","successText","status","cancelled"],"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,oCAAmC;AAC5E,SAAQC,cAAc,QAAO,gCAA+B;AAC5D,SAAQC,kBAAkB,EAAEC,wBAAwB,QAAO,4BAA2B;AAEtF,MAAMC,oBAAoBT,SAAS;AAEnC,OAAO,MAAMU,kCAAkCX;IAC7C,OAAgBY,OAAO;QACrBC,iBAAiBhB,KAAKiB,MAAM,CAAC;YAC3BC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,mDAAkD;IAEhF,OAAgBE,WAAW;QACzB;YACEC,SAAS;YACTH,aAAa;QACf;QACA;YACEG,SAAS;YACTH,aAAa;QACf;QACA;YACEG,SAAS;YACTH,aAAa;QACf;KACD,CAAA;IAED,OAAgBI,QAAQ;QACtBC,QAAQtB,MAAMuB,OAAO,CAAC;YACpBC,SAAS;YACTP,aAAa;YACbQ,WAAW;gBAAC;aAAQ;QACtB;QACAC,OAAO1B,MAAMuB,OAAO,CAAC;YACnBC,SAAS;YACTP,aAAa;QACf;IACF,EAAqB;IAErB,MAAaU,MAAqB;QAChC,MAAM,EAACZ,eAAe,EAAC,GAAG,IAAI,CAACD,IAAI;QACnC,MAAM,EAACQ,MAAM,EAAEI,KAAK,EAAC,GAAG,IAAI,CAACL,KAAK;QAElC,IAAIC,QAAQ;YACV,MAAM,IAAI,CAACM,WAAW,CAACb;YACvB;QACF;QAEA,IAAIc;QACJ,MAAMC,OAAOzB,QAAQ,kBAAkB0B,KAAK;QAC5C,IAAI;YACF,MAAMC,WAAW,MAAMtB,mBAAmBK;YAC1Cc,QAAQG,SAASH,KAAK;YACtBC,KAAKG,OAAO,CAAC;QACf,EAAE,OAAOC,OAAO;YACdJ,KAAKK,IAAI;YACTvB,kBAAkB,wBAAwBsB;YAC1C,IAAI5B,YAAY4B,UAAUA,MAAME,UAAU,KAAK,KAAK;gBAClD,IAAI,CAACF,KAAK,CAAC,CAAC,gBAAgB,EAAEnB,gBAAgB,WAAW,CAAC,EAAE;oBAC1DsB,MAAMpC,UAAUqC,aAAa;gBAC/B;YACF;YACA,IAAI,CAACJ,KAAK,CAAC,CAAC,uBAAuB,EAAE9B,gBAAgB8B,QAAQ,EAAE;gBAC7DG,MAAMpC,UAAUqC,aAAa;YAC/B;QACF;QAEA,IAAI,CAACC,GAAG,CAAC9B,eAAe,UAAUoB;QAClC,IAAI,CAACU,GAAG,CAAC,CAAC,uCAAuC,EAAExB,gBAAgB,CAAC,EAAEc,OAAO;QAE7E,IAAI,CAACH,OAAO;YACV;QACF;QAEA,IAAIc;QACJ,IAAI;YACFA,MAAM,MAAMhC,SAASO,iBAAiBc,OAAO;gBAC3CY,OAAO;gBACPC,aAAa;YACf;QACF,EAAE,OAAOR,OAAO;YACdtB,kBAAkB,4BAA4BsB;YAC9C,IAAI,CAACA,KAAK,CAAC,CAAC,2BAA2B,EAAE9B,gBAAgB8B,QAAQ,EAAE;gBACjEG,MAAMpC,UAAUqC,aAAa;YAC/B;QACF;QAEA,IAAIE,IAAIG,MAAM,KAAK,aAAa;YAC9B,IAAI,CAACT,KAAK,CAAC3B,iBAAiB,SAASiC,MAAM;gBACzCH,MAAMpC,UAAUqC,aAAa;YAC/B;QACF;IACF;IAEA,MAAcV,YAAYb,eAAuB,EAAiB;QAChE,IAAI;YACF,MAAM,EAAC6B,SAAS,EAAC,GAAG,MAAMjC,yBAAyBI;YACnD,IAAI,CAACwB,GAAG,CAACK,YAAY,oBAAoB;QAC3C,EAAE,OAAOV,OAAO;YACdtB,kBAAkB,0BAA0BsB;YAC5C,IAAI5B,YAAY4B,UAAUA,MAAME,UAAU,KAAK,KAAK;gBAClD,IAAI,CAACF,KAAK,CAAC,CAAC,gBAAgB,EAAEnB,gBAAgB,WAAW,CAAC,EAAE;oBAC1DsB,MAAMpC,UAAUqC,aAAa;gBAC/B;YACF;YACA,IAAI,CAACJ,KAAK,CAAC,CAAC,wBAAwB,EAAE9B,gBAAgB8B,QAAQ,EAAE;gBAC9DG,MAAMpC,UAAUqC,aAAa;YAC/B;QACF;IACF;AACF"}

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

@@ -0,0 +1,83 @@
+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 { getEntry } from '../../../services/context.js';
+const getEntryDebug = subdebug('context:entries:get');
+export class GetEntryCommand 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 = 'Get an entry and its content';
+    static enableJsonFlag = true;
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 billing/refunds',
+            description: 'Print an entry and its content'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 billing/refunds --json',
+            description: 'Output the entry, including citations, as JSON'
+        }
+    ];
+    async run() {
+        const { knowledgeBaseId, path } = this.args;
+        const { json } = this.flags;
+        let entry;
+        try {
+            entry = await getEntry(knowledgeBaseId, path);
+        } catch (error) {
+            getEntryDebug('Error getting entry', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Knowledge base "${knowledgeBaseId}" not found`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to get entry: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        if (!entry) {
+            this.error(`Entry "${path}" not found on knowledge base "${knowledgeBaseId}"`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        if (json) {
+            this.logJson(entry);
+            return;
+        }
+        const padTo = 9 // "Citations" and "Generated" are the longest keys
+        ;
+        this.log(formatKeyValue('Path', entry.path, {
+            padTo
+        }));
+        this.log(formatKeyValue('Title', entry.title, {
+            padTo
+        }));
+        this.log(formatKeyValue('Status', entry.status, {
+            padTo
+        }));
+        this.log(formatKeyValue('Scope', entry.tldr?.scope ?? '-', {
+            padTo
+        }));
+        this.log(formatKeyValue('Citations', String(entry.citations?.length ?? 0), {
+            padTo
+        }));
+        this.log(formatKeyValue('Generated', entry.generatedAt, {
+            padTo
+        }));
+        if (entry.body) {
+            this.log(`\n${entry.body}`);
+        }
+    }
+}
+
+//# sourceMappingURL=get.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/entries/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 {getEntry} from '../../../services/context.js'\n\nconst getEntryDebug = subdebug('context:entries:get')\n\nexport class GetEntryCommand extends SanityCommand<typeof GetEntryCommand> {\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 = 'Get an entry and its content'\n\n  static override enableJsonFlag = true\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 billing/refunds',\n      description: 'Print an entry and its content',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 billing/refunds --json',\n      description: 'Output the entry, including citations, as JSON',\n    },\n  ]\n\n  public async run(): Promise<void> {\n    const {knowledgeBaseId, path} = this.args\n    const {json} = this.flags\n\n    let entry\n    try {\n      entry = await getEntry(knowledgeBaseId, path)\n    } catch (error) {\n      getEntryDebug('Error getting entry', 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 entry: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (!entry) {\n      this.error(`Entry \"${path}\" not found on knowledge base \"${knowledgeBaseId}\"`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (json) {\n      this.logJson(entry)\n      return\n    }\n\n    const padTo = 9 // \"Citations\" and \"Generated\" are the longest keys\n    this.log(formatKeyValue('Path', entry.path, {padTo}))\n    this.log(formatKeyValue('Title', entry.title, {padTo}))\n    this.log(formatKeyValue('Status', entry.status, {padTo}))\n    this.log(formatKeyValue('Scope', entry.tldr?.scope ?? '-', {padTo}))\n    this.log(formatKeyValue('Citations', String(entry.citations?.length ?? 0), {padTo}))\n    this.log(formatKeyValue('Generated', entry.generatedAt, {padTo}))\n\n    if (entry.body) {\n      this.log(`\\n${entry.body}`)\n    }\n  }\n}\n"],"names":["Args","exitCodes","SanityCommand","subdebug","getErrorMessage","isHttpError","formatKeyValue","getEntry","getEntryDebug","GetEntryCommand","args","knowledgeBaseId","string","description","required","path","enableJsonFlag","examples","command","run","json","flags","entry","error","statusCode","exit","RUNTIME_ERROR","logJson","padTo","log","title","status","tldr","scope","String","citations","length","generatedAt","body"],"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,cAAc,QAAO,mCAAkC;AAC/D,SAAQC,QAAQ,QAAO,+BAA8B;AAErD,MAAMC,gBAAgBL,SAAS;AAE/B,OAAO,MAAMM,wBAAwBP;IACnC,OAAgBQ,OAAO;QACrBC,iBAAiBX,KAAKY,MAAM,CAAC;YAC3BC,aAAa;YACbC,UAAU;QACZ;QACAC,MAAMf,KAAKY,MAAM,CAAC;YAChBC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,+BAA8B;IAE5D,OAAgBG,iBAAiB,KAAI;IAErC,OAAgBC,WAAW;QACzB;YACEC,SAAS;YACTL,aAAa;QACf;QACA;YACEK,SAAS;YACTL,aAAa;QACf;KACD,CAAA;IAED,MAAaM,MAAqB;QAChC,MAAM,EAACR,eAAe,EAAEI,IAAI,EAAC,GAAG,IAAI,CAACL,IAAI;QACzC,MAAM,EAACU,IAAI,EAAC,GAAG,IAAI,CAACC,KAAK;QAEzB,IAAIC;QACJ,IAAI;YACFA,QAAQ,MAAMf,SAASI,iBAAiBI;QAC1C,EAAE,OAAOQ,OAAO;YACdf,cAAc,uBAAuBe;YACrC,IAAIlB,YAAYkB,UAAUA,MAAMC,UAAU,KAAK,KAAK;gBAClD,IAAI,CAACD,KAAK,CAAC,CAAC,gBAAgB,EAAEZ,gBAAgB,WAAW,CAAC,EAAE;oBAC1Dc,MAAMxB,UAAUyB,aAAa;gBAC/B;YACF;YACA,IAAI,CAACH,KAAK,CAAC,CAAC,qBAAqB,EAAEnB,gBAAgBmB,QAAQ,EAAE;gBAC3DE,MAAMxB,UAAUyB,aAAa;YAC/B;QACF;QAEA,IAAI,CAACJ,OAAO;YACV,IAAI,CAACC,KAAK,CAAC,CAAC,OAAO,EAAER,KAAK,+BAA+B,EAAEJ,gBAAgB,CAAC,CAAC,EAAE;gBAC7Ec,MAAMxB,UAAUyB,aAAa;YAC/B;QACF;QAEA,IAAIN,MAAM;YACR,IAAI,CAACO,OAAO,CAACL;YACb;QACF;QAEA,MAAMM,QAAQ,EAAE,mDAAmD;;QACnE,IAAI,CAACC,GAAG,CAACvB,eAAe,QAAQgB,MAAMP,IAAI,EAAE;YAACa;QAAK;QAClD,IAAI,CAACC,GAAG,CAACvB,eAAe,SAASgB,MAAMQ,KAAK,EAAE;YAACF;QAAK;QACpD,IAAI,CAACC,GAAG,CAACvB,eAAe,UAAUgB,MAAMS,MAAM,EAAE;YAACH;QAAK;QACtD,IAAI,CAACC,GAAG,CAACvB,eAAe,SAASgB,MAAMU,IAAI,EAAEC,SAAS,KAAK;YAACL;QAAK;QACjE,IAAI,CAACC,GAAG,CAACvB,eAAe,aAAa4B,OAAOZ,MAAMa,SAAS,EAAEC,UAAU,IAAI;YAACR;QAAK;QACjF,IAAI,CAACC,GAAG,CAACvB,eAAe,aAAagB,MAAMe,WAAW,EAAE;YAACT;QAAK;QAE9D,IAAIN,MAAMgB,IAAI,EAAE;YACd,IAAI,CAACT,GAAG,CAAC,CAAC,EAAE,EAAEP,MAAMgB,IAAI,EAAE;QAC5B;IACF;AACF"}

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

@@ -0,0 +1,82 @@
+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 { listEntries } from '../../../services/context.js';
+import { Table } from '../../../util/responsiveTable.js';
+const listEntriesDebug = subdebug('context:entries:list');
+export class ListEntriesCommand extends SanityCommand {
+    static args = {
+        knowledgeBaseId: Args.string({
+            description: 'Knowledge base ID',
+            required: true
+        })
+    };
+    static description = 'List the entries a knowledge base build produced';
+    static enableJsonFlag = true;
+    static examples = [
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123',
+            description: 'List all entries for a knowledge base'
+        },
+        {
+            command: '<%= config.bin %> <%= command.id %> kb-abc123 --json',
+            description: 'Output entries as JSON'
+        }
+    ];
+    async run() {
+        const { knowledgeBaseId } = this.args;
+        const { json } = this.flags;
+        let entries;
+        try {
+            entries = await listEntries(knowledgeBaseId);
+        } catch (error) {
+            listEntriesDebug('Error listing entries', error);
+            if (isHttpError(error) && error.statusCode === 404) {
+                this.error(`Knowledge base "${knowledgeBaseId}" not found`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+            this.error(`Failed to list entries: ${getErrorMessage(error)}`, {
+                exit: exitCodes.RUNTIME_ERROR
+            });
+        }
+        if (json) {
+            this.logJson(entries);
+            return;
+        }
+        if (entries.length === 0) {
+            this.log('No entries found');
+            return;
+        }
+        const table = new Table({
+            columns: [
+                {
+                    alignment: 'left',
+                    name: 'path',
+                    title: 'Path'
+                },
+                {
+                    alignment: 'left',
+                    name: 'title',
+                    title: 'Title'
+                },
+                {
+                    alignment: 'left',
+                    name: 'status',
+                    title: 'Status'
+                }
+            ]
+        });
+        for (const { path, status, title } of entries){
+            table.addRow({
+                path,
+                status,
+                title
+            });
+        }
+        this.log(table.render());
+    }
+}
+
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/commands/context/entries/list.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 {listEntries} from '../../../services/context.js'\nimport {Table} from '../../../util/responsiveTable.js'\n\nconst listEntriesDebug = subdebug('context:entries:list')\n\nexport class ListEntriesCommand extends SanityCommand<typeof ListEntriesCommand> {\n  static override args = {\n    knowledgeBaseId: Args.string({\n      description: 'Knowledge base ID',\n      required: true,\n    }),\n  }\n\n  static override description = 'List the entries a knowledge base build produced'\n\n  static override enableJsonFlag = true\n\n  static override examples = [\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123',\n      description: 'List all entries for a knowledge base',\n    },\n    {\n      command: '<%= config.bin %> <%= command.id %> kb-abc123 --json',\n      description: 'Output entries as JSON',\n    },\n  ]\n\n  public async run(): Promise<void> {\n    const {knowledgeBaseId} = this.args\n    const {json} = this.flags\n\n    let entries\n    try {\n      entries = await listEntries(knowledgeBaseId)\n    } catch (error) {\n      listEntriesDebug('Error listing entries', 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 entries: ${getErrorMessage(error)}`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n\n    if (json) {\n      this.logJson(entries)\n      return\n    }\n\n    if (entries.length === 0) {\n      this.log('No entries found')\n      return\n    }\n\n    const table = new Table({\n      columns: [\n        {alignment: 'left', name: 'path', title: 'Path'},\n        {alignment: 'left', name: 'title', title: 'Title'},\n        {alignment: 'left', name: 'status', title: 'Status'},\n      ],\n    })\n\n    for (const {path, status, title} of entries) {\n      table.addRow({path, status, title})\n    }\n\n    this.log(table.render())\n  }\n}\n"],"names":["Args","exitCodes","SanityCommand","subdebug","getErrorMessage","isHttpError","listEntries","Table","listEntriesDebug","ListEntriesCommand","args","knowledgeBaseId","string","description","required","enableJsonFlag","examples","command","run","json","flags","entries","error","statusCode","exit","RUNTIME_ERROR","logJson","length","log","table","columns","alignment","name","title","path","status","addRow","render"],"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;AACxD,SAAQC,KAAK,QAAO,mCAAkC;AAEtD,MAAMC,mBAAmBL,SAAS;AAElC,OAAO,MAAMM,2BAA2BP;IACtC,OAAgBQ,OAAO;QACrBC,iBAAiBX,KAAKY,MAAM,CAAC;YAC3BC,aAAa;YACbC,UAAU;QACZ;IACF,EAAC;IAED,OAAgBD,cAAc,mDAAkD;IAEhF,OAAgBE,iBAAiB,KAAI;IAErC,OAAgBC,WAAW;QACzB;YACEC,SAAS;YACTJ,aAAa;QACf;QACA;YACEI,SAAS;YACTJ,aAAa;QACf;KACD,CAAA;IAED,MAAaK,MAAqB;QAChC,MAAM,EAACP,eAAe,EAAC,GAAG,IAAI,CAACD,IAAI;QACnC,MAAM,EAACS,IAAI,EAAC,GAAG,IAAI,CAACC,KAAK;QAEzB,IAAIC;QACJ,IAAI;YACFA,UAAU,MAAMf,YAAYK;QAC9B,EAAE,OAAOW,OAAO;YACdd,iBAAiB,yBAAyBc;YAC1C,IAAIjB,YAAYiB,UAAUA,MAAMC,UAAU,KAAK,KAAK;gBAClD,IAAI,CAACD,KAAK,CAAC,CAAC,gBAAgB,EAAEX,gBAAgB,WAAW,CAAC,EAAE;oBAC1Da,MAAMvB,UAAUwB,aAAa;gBAC/B;YACF;YACA,IAAI,CAACH,KAAK,CAAC,CAAC,wBAAwB,EAAElB,gBAAgBkB,QAAQ,EAAE;gBAC9DE,MAAMvB,UAAUwB,aAAa;YAC/B;QACF;QAEA,IAAIN,MAAM;YACR,IAAI,CAACO,OAAO,CAACL;YACb;QACF;QAEA,IAAIA,QAAQM,MAAM,KAAK,GAAG;YACxB,IAAI,CAACC,GAAG,CAAC;YACT;QACF;QAEA,MAAMC,QAAQ,IAAItB,MAAM;YACtBuB,SAAS;gBACP;oBAACC,WAAW;oBAAQC,MAAM;oBAAQC,OAAO;gBAAM;gBAC/C;oBAACF,WAAW;oBAAQC,MAAM;oBAASC,OAAO;gBAAO;gBACjD;oBAACF,WAAW;oBAAQC,MAAM;oBAAUC,OAAO;gBAAQ;aACpD;QACH;QAEA,KAAK,MAAM,EAACC,IAAI,EAAEC,MAAM,EAAEF,KAAK,EAAC,IAAIZ,QAAS;YAC3CQ,MAAMO,MAAM,CAAC;gBAACF;gBAAMC;gBAAQF;YAAK;QACnC;QAEA,IAAI,CAACL,GAAG,CAACC,MAAMQ,MAAM;IACvB;AACF"}

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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"}