@sanity/cli 8.22.1 → 8.23.0

package/dist/actions/media/pullAspects.js

@@ -0,0 +1,225 @@
+import { validateMediaLibraryAssetAspect } from '@sanity/schema/_internal';
+import startCase from 'lodash-es/startCase.js';
+import { VALID_ASPECT_NAME } from './aspectName.js';
+/** Keys whose object members are schema definitions, printed wrapped in a definer call. */ const DEFINER_BY_PARENT_KEY = {
+    fields: 'defineField',
+    of: 'defineArrayMember'
+};
+const IDENTIFIER_KEY = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+/** Scalar arrays shorter than this print inline (e.g. `options.list`). */ const INLINE_ARRAY_MAX_WIDTH = 60;
+/**
+ * Convert a page of stored aspect documents into field modules, one per field
+ * name. Two stored documents can resolve to the same name (a legacy document
+ * whose `_id` predates its `definition.name`), which would otherwise produce
+ * the same module twice — the document whose `_id` matches the name wins, the
+ * rest are reported as skipped. Shared by `sanity media pull-aspects` and the
+ * init-time pull offer.
+ *
+ * @internal
+ */ export function convertAspectDocuments(documents) {
+    const skipped = [];
+    // First pass: convert every stored document.
+    const candidates = [];
+    for (const doc of documents){
+        const outcome = aspectDocumentToFieldModule(doc);
+        if (outcome.status === 'skipped') {
+            skipped.push(outcome);
+        } else {
+            candidates.push({
+                module: outcome,
+                sourceId: String(doc._id)
+            });
+        }
+    }
+    // Second pass: pick one winner per name.
+    const byName = new Map();
+    for (const candidate of candidates){
+        const group = byName.get(candidate.module.name) ?? [];
+        group.push(candidate);
+        byName.set(candidate.module.name, group);
+    }
+    const modules = [];
+    for (const [name, group] of byName){
+        const winner = group.find((candidate)=>candidate.sourceId === name) ?? group[0];
+        modules.push(winner.module);
+        for (const loser of group){
+            if (loser === winner) continue;
+            skipped.push({
+                id: loser.sourceId,
+                reasons: [
+                    `Also defines "${name}" — generated from "${winner.sourceId}" instead`
+                ],
+                status: 'skipped',
+                validationErrors: []
+            });
+        }
+    }
+    return {
+        modules,
+        skipped
+    };
+}
+/**
+ * Codegen one stored aspect document into a `src/fields/<name>.tsx` field
+ * module for a Media Library config app.
+ *
+ * Stored aspects are migration-ready by construction: `definition` is the
+ * JSON-serialized `defineField(...)` value with functions and component
+ * references already stripped, so generation is mechanical pretty-printing
+ * into a `defineField({...})` call (nested `fields`/`of` members wrapped in
+ * `defineField`/`defineArrayMember`, matching hand-authored style).
+ *
+ * Edge cases handled here, not silently:
+ *
+ * - `_id` vs `definition.name` mismatch: the module is generated under
+ *   `definition.name` — the `aspects.<name>` key existing asset data lives
+ *   under. Normalizing onto `_id` instead would silently orphan that data.
+ *   The old document (keyed `_id`) is reported for manual deletion.
+ * - `assetType` has no equivalent in the config model; a document carrying it
+ *   generates with a warning that the scoping is lost.
+ * - Definitions failing current schema validation are skipped with the
+ *   validation errors, mirroring `sanity media deploy-aspect`.
+ *
+ * Pure (no I/O): the command decides where modules are written.
+ *
+ * @internal
+ */ export function aspectDocumentToFieldModule(doc) {
+    const { _id } = doc;
+    if (!isRecord(doc.definition)) {
+        return {
+            id: _id,
+            reasons: [
+                'The stored document has no field definition object'
+            ],
+            status: 'skipped',
+            validationErrors: []
+        };
+    }
+    const definitionName = typeof doc.definition.name === 'string' ? doc.definition.name : undefined;
+    const name = definitionName ?? _id;
+    if (!VALID_ASPECT_NAME.test(name)) {
+        return {
+            id: _id,
+            reasons: [
+                `"${name}" is not a valid field name (${VALID_ASPECT_NAME}) — it becomes the module name and the aspects.<name> key on assets`
+            ],
+            status: 'skipped',
+            validationErrors: []
+        };
+    }
+    const warnings = [];
+    if (definitionName === undefined) {
+        warnings.push(`The stored definition has no name — using the document _id "${_id}"`);
+    } else if (definitionName !== _id) {
+        warnings.push(`Stored _id "${_id}" and definition name "${definitionName}" differ. Generated as ` + `"${definitionName}" — the aspects.<name> key existing asset data lives under; using ` + `"${_id}" would orphan that data. Deploying the config creates "${definitionName}" ` + `and deletes the old "${_id}" document.`);
+    }
+    if (doc.assetType !== undefined && doc.assetType !== null) {
+        warnings.push(`The stored document scopes the aspect by assetType (${JSON.stringify(doc.assetType)}), ` + `which has no equivalent in the config model — the generated field applies to all ` + `asset types, and syncing the config drops the scoping.`);
+    }
+    // Normalize the name in before validating, so a document that only carries
+    // its name as `_id` isn't rejected for the missing property.
+    const definition = definitionName ? doc.definition : {
+        name,
+        ...doc.definition
+    };
+    const [valid, validationErrors] = validateMediaLibraryAssetAspect(definition);
+    if (!valid) {
+        return {
+            id: _id,
+            reasons: [
+                'The stored definition fails schema validation'
+            ],
+            status: 'skipped',
+            validationErrors
+        };
+    }
+    return {
+        // .tsx although the generated content has no JSX: field modules are
+        // expected to grow custom input components (the one thing the stored
+        // aspect could not carry), and a later rename would also mean fixing the
+        // `src:` entry in sanity.cli.ts. Matches the template's example modules.
+        filename: `${name}.tsx`,
+        name,
+        ...typeof doc.public === 'boolean' ? {
+            public: doc.public
+        } : {},
+        source: printFieldModule(definition),
+        status: 'generated',
+        title: typeof definition.title === 'string' ? definition.title : startCase(name),
+        warnings
+    };
+}
+/**
+ * The paste-ready `fields: [...]` entries for `sanity.cli.ts`, one line per
+ * generated module. When `writtenPaths` (module name to root-relative path)
+ * has an entry for a module, that path wins — the module may have replaced an
+ * existing file (e.g. a `.tsx` variant) rather than landing at the default
+ * `<srcDir>/<filename>` location.
+ *
+ * @internal
+ */ export function formatFieldEntries(modules, srcDir, writtenPaths) {
+    const dir = srcDir.replaceAll('\\', '/').replace(/\/+$/, '');
+    return modules.map((module)=>{
+        const src = writtenPaths?.get(module.name)?.replaceAll('\\', '/') ?? `${dir}/${module.filename}`;
+        const publicPart = module.public === undefined ? '' : `, public: ${module.public}`;
+        return `{name: '${module.name}', src: './${src}', title: ${quote(module.title)}${publicPart}},`;
+    }).join('\n');
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function printFieldModule(definition) {
+    const state = {
+        usesDefineArrayMember: false
+    };
+    const literal = printObject(definition, '', state);
+    const imports = state.usesDefineArrayMember ? 'defineArrayMember, defineField' : 'defineField';
+    return `import {${imports}} from 'sanity'\n\nexport default defineField(${literal})\n`;
+}
+function quote(value) {
+    const escaped = value.replaceAll('\\', '\\\\').replaceAll("'", String.raw`\'`).replaceAll('\n', String.raw`\n`).replaceAll('\r', String.raw`\r`).replaceAll('\t', String.raw`\t`);
+    return `'${escaped}'`;
+}
+function printKey(key) {
+    return IDENTIFIER_KEY.test(key) ? key : quote(key);
+}
+function printValue(value, indent, parentKey, state) {
+    if (value === null) return 'null';
+    if (typeof value === 'string') return quote(value);
+    if (typeof value === 'number' || typeof value === 'boolean') return String(value);
+    if (Array.isArray(value)) return printArray(value, indent, parentKey, state);
+    if (isRecord(value)) return printObject(value, indent, state);
+    // Stored definitions are JSON documents; anything else cannot occur.
+    throw new TypeError(`Cannot print value of type ${typeof value}`);
+}
+function printArray(items, indent, parentKey, state) {
+    if (items.length === 0) return '[]';
+    const allScalar = items.every((item)=>item === null || [
+            'boolean',
+            'number',
+            'string'
+        ].includes(typeof item));
+    if (allScalar) {
+        const inline = `[${items.map((item)=>printValue(item, indent, null, state)).join(', ')}]`;
+        if (inline.length <= INLINE_ARRAY_MAX_WIDTH) return inline;
+    }
+    const definer = parentKey === null ? undefined : DEFINER_BY_PARENT_KEY[parentKey];
+    const innerIndent = `${indent}  `;
+    const lines = items.map((item)=>{
+        if (definer !== undefined && isRecord(item)) {
+            if (definer === 'defineArrayMember') state.usesDefineArrayMember = true;
+            return `${innerIndent}${definer}(${printObject(item, innerIndent, state)}),`;
+        }
+        return `${innerIndent}${printValue(item, innerIndent, null, state)},`;
+    });
+    return `[\n${lines.join('\n')}\n${indent}]`;
+}
+function printObject(obj, indent, state) {
+    const entries = Object.entries(obj).filter(([, value])=>value !== undefined);
+    if (entries.length === 0) return '{}';
+    const innerIndent = `${indent}  `;
+    const lines = entries.map(([key, value])=>`${innerIndent}${printKey(key)}: ${printValue(value, innerIndent, key, state)},`);
+    return `{\n${lines.join('\n')}\n${indent}}`;
+}
+
+//# sourceMappingURL=pullAspects.js.map

package/dist/actions/media/pullAspects.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/media/pullAspects.ts"],"sourcesContent":["import {validateMediaLibraryAssetAspect} from '@sanity/schema/_internal'\nimport {type SchemaValidationProblem} from '@sanity/types'\nimport startCase from 'lodash-es/startCase.js'\n\nimport {type StoredAspectDocument} from '../../services/mediaLibraries.js'\nimport {VALID_ASPECT_NAME} from './aspectName.js'\n\n/** Keys whose object members are schema definitions, printed wrapped in a definer call. */\nconst DEFINER_BY_PARENT_KEY: Record<string, string> = {\n  fields: 'defineField',\n  of: 'defineArrayMember',\n}\n\nconst IDENTIFIER_KEY = /^[A-Za-z_$][A-Za-z0-9_$]*$/\n\n/** Scalar arrays shorter than this print inline (e.g. `options.list`). */\nconst INLINE_ARRAY_MAX_WIDTH = 60\n\n/**\n * The stored `sanity.asset.aspect` document shape this migration reads.\n * Deliberately loose: documents may predate the config model (authored via\n * `sanity media deploy-aspect` or by hand) and carry fields the model has no\n * equivalent for.\n */\nexport type PullableAspectDocument = StoredAspectDocument\n\nexport interface GeneratedFieldModule {\n  filename: string\n  /** The `aspects.<name>` data key — module filename and config entry name. */\n  name: string\n  source: string\n  status: 'generated'\n  title: string\n  warnings: string[]\n\n  public?: boolean\n}\n\nexport interface SkippedAspect {\n  id: string\n  reasons: string[]\n  status: 'skipped'\n  validationErrors: SchemaValidationProblem[][]\n}\n\nexport type PullAspectOutcome = GeneratedFieldModule | SkippedAspect\n\n/**\n * Convert a page of stored aspect documents into field modules, one per field\n * name. Two stored documents can resolve to the same name (a legacy document\n * whose `_id` predates its `definition.name`), which would otherwise produce\n * the same module twice — the document whose `_id` matches the name wins, the\n * rest are reported as skipped. Shared by `sanity media pull-aspects` and the\n * init-time pull offer.\n *\n * @internal\n */\nexport function convertAspectDocuments(documents: PullableAspectDocument[]): {\n  modules: GeneratedFieldModule[]\n  skipped: SkippedAspect[]\n} {\n  const skipped: SkippedAspect[] = []\n\n  // First pass: convert every stored document.\n  const candidates: Array<{module: GeneratedFieldModule; sourceId: string}> = []\n  for (const doc of documents) {\n    const outcome = aspectDocumentToFieldModule(doc)\n    if (outcome.status === 'skipped') {\n      skipped.push(outcome)\n    } else {\n      candidates.push({module: outcome, sourceId: String(doc._id)})\n    }\n  }\n\n  // Second pass: pick one winner per name.\n  const byName = new Map<string, Array<{module: GeneratedFieldModule; sourceId: string}>>()\n  for (const candidate of candidates) {\n    const group = byName.get(candidate.module.name) ?? []\n    group.push(candidate)\n    byName.set(candidate.module.name, group)\n  }\n  const modules: GeneratedFieldModule[] = []\n  for (const [name, group] of byName) {\n    const winner = group.find((candidate) => candidate.sourceId === name) ?? group[0]\n    modules.push(winner.module)\n    for (const loser of group) {\n      if (loser === winner) continue\n      skipped.push({\n        id: loser.sourceId,\n        reasons: [`Also defines \"${name}\" — generated from \"${winner.sourceId}\" instead`],\n        status: 'skipped',\n        validationErrors: [],\n      })\n    }\n  }\n\n  return {modules, skipped}\n}\n\n/**\n * Codegen one stored aspect document into a `src/fields/<name>.tsx` field\n * module for a Media Library config app.\n *\n * Stored aspects are migration-ready by construction: `definition` is the\n * JSON-serialized `defineField(...)` value with functions and component\n * references already stripped, so generation is mechanical pretty-printing\n * into a `defineField({...})` call (nested `fields`/`of` members wrapped in\n * `defineField`/`defineArrayMember`, matching hand-authored style).\n *\n * Edge cases handled here, not silently:\n *\n * - `_id` vs `definition.name` mismatch: the module is generated under\n *   `definition.name` — the `aspects.<name>` key existing asset data lives\n *   under. Normalizing onto `_id` instead would silently orphan that data.\n *   The old document (keyed `_id`) is reported for manual deletion.\n * - `assetType` has no equivalent in the config model; a document carrying it\n *   generates with a warning that the scoping is lost.\n * - Definitions failing current schema validation are skipped with the\n *   validation errors, mirroring `sanity media deploy-aspect`.\n *\n * Pure (no I/O): the command decides where modules are written.\n *\n * @internal\n */\nexport function aspectDocumentToFieldModule(doc: PullableAspectDocument): PullAspectOutcome {\n  const {_id} = doc\n\n  if (!isRecord(doc.definition)) {\n    return {\n      id: _id,\n      reasons: ['The stored document has no field definition object'],\n      status: 'skipped',\n      validationErrors: [],\n    }\n  }\n\n  const definitionName = typeof doc.definition.name === 'string' ? doc.definition.name : undefined\n  const name = definitionName ?? _id\n\n  if (!VALID_ASPECT_NAME.test(name)) {\n    return {\n      id: _id,\n      reasons: [\n        `\"${name}\" is not a valid field name (${VALID_ASPECT_NAME}) — it becomes the module name and the aspects.<name> key on assets`,\n      ],\n      status: 'skipped',\n      validationErrors: [],\n    }\n  }\n\n  const warnings: string[] = []\n\n  if (definitionName === undefined) {\n    warnings.push(`The stored definition has no name — using the document _id \"${_id}\"`)\n  } else if (definitionName !== _id) {\n    warnings.push(\n      `Stored _id \"${_id}\" and definition name \"${definitionName}\" differ. Generated as ` +\n        `\"${definitionName}\" — the aspects.<name> key existing asset data lives under; using ` +\n        `\"${_id}\" would orphan that data. Deploying the config creates \"${definitionName}\" ` +\n        `and deletes the old \"${_id}\" document.`,\n    )\n  }\n\n  if (doc.assetType !== undefined && doc.assetType !== null) {\n    warnings.push(\n      `The stored document scopes the aspect by assetType (${JSON.stringify(doc.assetType)}), ` +\n        `which has no equivalent in the config model — the generated field applies to all ` +\n        `asset types, and syncing the config drops the scoping.`,\n    )\n  }\n\n  // Normalize the name in before validating, so a document that only carries\n  // its name as `_id` isn't rejected for the missing property.\n  const definition: Record<string, unknown> = definitionName\n    ? doc.definition\n    : {name, ...doc.definition}\n\n  const [valid, validationErrors] = validateMediaLibraryAssetAspect(definition)\n  if (!valid) {\n    return {\n      id: _id,\n      reasons: ['The stored definition fails schema validation'],\n      status: 'skipped',\n      validationErrors,\n    }\n  }\n\n  return {\n    // .tsx although the generated content has no JSX: field modules are\n    // expected to grow custom input components (the one thing the stored\n    // aspect could not carry), and a later rename would also mean fixing the\n    // `src:` entry in sanity.cli.ts. Matches the template's example modules.\n    filename: `${name}.tsx`,\n    name,\n    ...(typeof doc.public === 'boolean' ? {public: doc.public} : {}),\n    source: printFieldModule(definition),\n    status: 'generated',\n    title: typeof definition.title === 'string' ? definition.title : startCase(name),\n    warnings,\n  }\n}\n\n/**\n * The paste-ready `fields: [...]` entries for `sanity.cli.ts`, one line per\n * generated module. When `writtenPaths` (module name to root-relative path)\n * has an entry for a module, that path wins — the module may have replaced an\n * existing file (e.g. a `.tsx` variant) rather than landing at the default\n * `<srcDir>/<filename>` location.\n *\n * @internal\n */\nexport function formatFieldEntries(\n  modules: GeneratedFieldModule[],\n  srcDir: string,\n  writtenPaths?: Map<string, string>,\n): string {\n  const dir = srcDir.replaceAll('\\\\', '/').replace(/\\/+$/, '')\n  return modules\n    .map((module) => {\n      const src =\n        writtenPaths?.get(module.name)?.replaceAll('\\\\', '/') ?? `${dir}/${module.filename}`\n      const publicPart = module.public === undefined ? '' : `, public: ${module.public}`\n      return `{name: '${module.name}', src: './${src}', title: ${quote(module.title)}${publicPart}},`\n    })\n    .join('\\n')\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\ninterface PrinterState {\n  usesDefineArrayMember: boolean\n}\n\nfunction printFieldModule(definition: Record<string, unknown>): string {\n  const state: PrinterState = {usesDefineArrayMember: false}\n  const literal = printObject(definition, '', state)\n  const imports = state.usesDefineArrayMember ? 'defineArrayMember, defineField' : 'defineField'\n\n  return `import {${imports}} from 'sanity'\\n\\nexport default defineField(${literal})\\n`\n}\n\nfunction quote(value: string): string {\n  const escaped = value\n    .replaceAll('\\\\', '\\\\\\\\')\n    .replaceAll(\"'\", String.raw`\\'`)\n    .replaceAll('\\n', String.raw`\\n`)\n    .replaceAll('\\r', String.raw`\\r`)\n    .replaceAll('\\t', String.raw`\\t`)\n  return `'${escaped}'`\n}\n\nfunction printKey(key: string): string {\n  return IDENTIFIER_KEY.test(key) ? key : quote(key)\n}\n\nfunction printValue(\n  value: unknown,\n  indent: string,\n  parentKey: string | null,\n  state: PrinterState,\n): string {\n  if (value === null) return 'null'\n  if (typeof value === 'string') return quote(value)\n  if (typeof value === 'number' || typeof value === 'boolean') return String(value)\n  if (Array.isArray(value)) return printArray(value, indent, parentKey, state)\n  if (isRecord(value)) return printObject(value, indent, state)\n  // Stored definitions are JSON documents; anything else cannot occur.\n  throw new TypeError(`Cannot print value of type ${typeof value}`)\n}\n\nfunction printArray(\n  items: unknown[],\n  indent: string,\n  parentKey: string | null,\n  state: PrinterState,\n): string {\n  if (items.length === 0) return '[]'\n\n  const allScalar = items.every(\n    (item) => item === null || ['boolean', 'number', 'string'].includes(typeof item),\n  )\n  if (allScalar) {\n    const inline = `[${items.map((item) => printValue(item, indent, null, state)).join(', ')}]`\n    if (inline.length <= INLINE_ARRAY_MAX_WIDTH) return inline\n  }\n\n  const definer = parentKey === null ? undefined : DEFINER_BY_PARENT_KEY[parentKey]\n  const innerIndent = `${indent}  `\n  const lines = items.map((item) => {\n    if (definer !== undefined && isRecord(item)) {\n      if (definer === 'defineArrayMember') state.usesDefineArrayMember = true\n      return `${innerIndent}${definer}(${printObject(item, innerIndent, state)}),`\n    }\n    return `${innerIndent}${printValue(item, innerIndent, null, state)},`\n  })\n  return `[\\n${lines.join('\\n')}\\n${indent}]`\n}\n\nfunction printObject(obj: Record<string, unknown>, indent: string, state: PrinterState): string {\n  const entries = Object.entries(obj).filter(([, value]) => value !== undefined)\n  if (entries.length === 0) return '{}'\n\n  const innerIndent = `${indent}  `\n  const lines = entries.map(\n    ([key, value]) =>\n      `${innerIndent}${printKey(key)}: ${printValue(value, innerIndent, key, state)},`,\n  )\n  return `{\\n${lines.join('\\n')}\\n${indent}}`\n}\n"],"names":["validateMediaLibraryAssetAspect","startCase","VALID_ASPECT_NAME","DEFINER_BY_PARENT_KEY","fields","of","IDENTIFIER_KEY","INLINE_ARRAY_MAX_WIDTH","convertAspectDocuments","documents","skipped","candidates","doc","outcome","aspectDocumentToFieldModule","status","push","module","sourceId","String","_id","byName","Map","candidate","group","get","name","set","modules","winner","find","loser","id","reasons","validationErrors","isRecord","definition","definitionName","undefined","test","warnings","assetType","JSON","stringify","valid","filename","public","source","printFieldModule","title","formatFieldEntries","srcDir","writtenPaths","dir","replaceAll","replace","map","src","publicPart","quote","join","value","Array","isArray","state","usesDefineArrayMember","literal","printObject","imports","escaped","raw","printKey","key","printValue","indent","parentKey","printArray","TypeError","items","length","allScalar","every","item","includes","inline","definer","innerIndent","lines","obj","entries","Object","filter"],"mappings":"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"}

package/dist/actions/media/resolveMediaLibraryId.js

@@ -0,0 +1,83 @@
+import { CLIError } from '@oclif/core/errors';
+import { exitCodes } from '@sanity/cli-core';
+import { promptForMediaLibrary } from '../../prompts/promptForMediaLibrary.js';
+import { getMediaLibrariesForOrganization } from '../../services/mediaLibraries.js';
+/** @see MediaLibraryResolution */ export async function resolveMediaLibrary(options) {
+    const { mediaLibraryIdFlag, organizationId } = options;
+    const libraries = await getMediaLibrariesForOrganization(organizationId);
+    const libraryIds = libraries.map((library)=>library.id);
+    if (mediaLibraryIdFlag) {
+        if (!libraryIds.includes(mediaLibraryIdFlag)) {
+            return {
+                message: `Media library ${mediaLibraryIdFlag} is not an active library of organization ` + `${organizationId} (found: ${libraryIds.join(', ') || 'none'})`,
+                solution: 'Pass --media-library-id with one of the active library ids',
+                type: 'invalid-flag'
+            };
+        }
+        return {
+            mediaLibraryId: mediaLibraryIdFlag,
+            type: 'resolved'
+        };
+    }
+    if (libraries.length === 0) {
+        return {
+            message: `Organization ${organizationId} has no active media library`,
+            solution: 'Install the Media Library for the organization first',
+            type: 'none-active'
+        };
+    }
+    if (libraries.length > 1) {
+        return {
+            libraries,
+            message: `Organization ${organizationId} has ${libraries.length} active media libraries ` + `(${libraryIds.join(', ')})`,
+            solution: 'Pass --media-library-id with the library this config belongs to',
+            type: 'ambiguous'
+        };
+    }
+    return {
+        mediaLibraryId: libraries[0].id,
+        type: 'resolved'
+    };
+}
+/**
+ * Command-facing resolution: ambiguity prompts when interactive (Ctrl+C there
+ * raises `ExitPromptError`, which callers must let propagate to
+ * `SanityCommand.catch`); misuse — a bad flag value, a missing required flag
+ * in unattended mode — exits with the usage code. No active library is an
+ * environment problem, not misuse, so it keeps the runtime code.
+ */ export async function resolveMediaLibraryId(options) {
+    const { mediaLibraryIdFlag, organizationId, unattended } = options;
+    const resolution = await resolveMediaLibrary({
+        mediaLibraryIdFlag,
+        organizationId
+    });
+    switch(resolution.type){
+        case 'ambiguous':
+            {
+                if (!unattended) return promptForMediaLibrary({
+                    mediaLibraries: resolution.libraries
+                });
+                throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {
+                    exit: exitCodes.USAGE_ERROR
+                });
+            }
+        case 'invalid-flag':
+            {
+                throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {
+                    exit: exitCodes.USAGE_ERROR
+                });
+            }
+        case 'none-active':
+            {
+                throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {
+                    exit: exitCodes.RUNTIME_ERROR
+                });
+            }
+        default:
+            {
+                return resolution.mediaLibraryId;
+            }
+    }
+}
+
+//# sourceMappingURL=resolveMediaLibraryId.js.map

package/dist/actions/media/resolveMediaLibraryId.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/actions/media/resolveMediaLibraryId.ts"],"sourcesContent":["import {CLIError} from '@oclif/core/errors'\nimport {exitCodes} from '@sanity/cli-core'\n\nimport {promptForMediaLibrary} from '../../prompts/promptForMediaLibrary.js'\nimport {getMediaLibrariesForOrganization, type MediaLibrary} from '../../services/mediaLibraries.js'\n\n/**\n * The target-library resolution config-app media operations share: the flag\n * wins (validated against the organization's active libraries), a single\n * active library is unambiguous, anything else is a verdict the caller turns\n * into its own failure shape — a prompt, a usage error, or a deploy check.\n */\nexport type MediaLibraryResolution =\n  | {\n      /** The active libraries a prompt would offer. */\n      libraries: MediaLibrary[]\n      message: string\n      solution: string\n      type: 'ambiguous'\n    }\n  | {mediaLibraryId: string; type: 'resolved'}\n  | {message: string; solution: string; type: 'invalid-flag'}\n  | {message: string; solution: string; type: 'none-active'}\n\n/** @see MediaLibraryResolution */\nexport async function resolveMediaLibrary(options: {\n  mediaLibraryIdFlag: string | undefined\n  organizationId: string\n}): Promise<MediaLibraryResolution> {\n  const {mediaLibraryIdFlag, organizationId} = options\n  const libraries = await getMediaLibrariesForOrganization(organizationId)\n  const libraryIds = libraries.map((library) => library.id)\n\n  if (mediaLibraryIdFlag) {\n    if (!libraryIds.includes(mediaLibraryIdFlag)) {\n      return {\n        message:\n          `Media library ${mediaLibraryIdFlag} is not an active library of organization ` +\n          `${organizationId} (found: ${libraryIds.join(', ') || 'none'})`,\n        solution: 'Pass --media-library-id with one of the active library ids',\n        type: 'invalid-flag',\n      }\n    }\n    return {mediaLibraryId: mediaLibraryIdFlag, type: 'resolved'}\n  }\n\n  if (libraries.length === 0) {\n    return {\n      message: `Organization ${organizationId} has no active media library`,\n      solution: 'Install the Media Library for the organization first',\n      type: 'none-active',\n    }\n  }\n  if (libraries.length > 1) {\n    return {\n      libraries,\n      message:\n        `Organization ${organizationId} has ${libraries.length} active media libraries ` +\n        `(${libraryIds.join(', ')})`,\n      solution: 'Pass --media-library-id with the library this config belongs to',\n      type: 'ambiguous',\n    }\n  }\n  return {mediaLibraryId: libraries[0].id, type: 'resolved'}\n}\n\n/**\n * Command-facing resolution: ambiguity prompts when interactive (Ctrl+C there\n * raises `ExitPromptError`, which callers must let propagate to\n * `SanityCommand.catch`); misuse — a bad flag value, a missing required flag\n * in unattended mode — exits with the usage code. No active library is an\n * environment problem, not misuse, so it keeps the runtime code.\n */\nexport async function resolveMediaLibraryId(options: {\n  mediaLibraryIdFlag: string | undefined\n  organizationId: string\n  unattended: boolean\n}): Promise<string> {\n  const {mediaLibraryIdFlag, organizationId, unattended} = options\n  const resolution = await resolveMediaLibrary({mediaLibraryIdFlag, organizationId})\n\n  switch (resolution.type) {\n    case 'ambiguous': {\n      if (!unattended) return promptForMediaLibrary({mediaLibraries: resolution.libraries})\n      throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {\n        exit: exitCodes.USAGE_ERROR,\n      })\n    }\n    case 'invalid-flag': {\n      throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {\n        exit: exitCodes.USAGE_ERROR,\n      })\n    }\n    case 'none-active': {\n      throw new CLIError(`${resolution.message}. ${resolution.solution}.`, {\n        exit: exitCodes.RUNTIME_ERROR,\n      })\n    }\n    default: {\n      return resolution.mediaLibraryId\n    }\n  }\n}\n"],"names":["CLIError","exitCodes","promptForMediaLibrary","getMediaLibrariesForOrganization","resolveMediaLibrary","options","mediaLibraryIdFlag","organizationId","libraries","libraryIds","map","library","id","includes","message","join","solution","type","mediaLibraryId","length","resolveMediaLibraryId","unattended","resolution","mediaLibraries","exit","USAGE_ERROR","RUNTIME_ERROR"],"mappings":"AAAA,SAAQA,QAAQ,QAAO,qBAAoB;AAC3C,SAAQC,SAAS,QAAO,mBAAkB;AAE1C,SAAQC,qBAAqB,QAAO,yCAAwC;AAC5E,SAAQC,gCAAgC,QAA0B,mCAAkC;AAoBpG,gCAAgC,GAChC,OAAO,eAAeC,oBAAoBC,OAGzC;IACC,MAAM,EAACC,kBAAkB,EAAEC,cAAc,EAAC,GAAGF;IAC7C,MAAMG,YAAY,MAAML,iCAAiCI;IACzD,MAAME,aAAaD,UAAUE,GAAG,CAAC,CAACC,UAAYA,QAAQC,EAAE;IAExD,IAAIN,oBAAoB;QACtB,IAAI,CAACG,WAAWI,QAAQ,CAACP,qBAAqB;YAC5C,OAAO;gBACLQ,SACE,CAAC,cAAc,EAAER,mBAAmB,0CAA0C,CAAC,GAC/E,GAAGC,eAAe,SAAS,EAAEE,WAAWM,IAAI,CAAC,SAAS,OAAO,CAAC,CAAC;gBACjEC,UAAU;gBACVC,MAAM;YACR;QACF;QACA,OAAO;YAACC,gBAAgBZ;YAAoBW,MAAM;QAAU;IAC9D;IAEA,IAAIT,UAAUW,MAAM,KAAK,GAAG;QAC1B,OAAO;YACLL,SAAS,CAAC,aAAa,EAAEP,eAAe,4BAA4B,CAAC;YACrES,UAAU;YACVC,MAAM;QACR;IACF;IACA,IAAIT,UAAUW,MAAM,GAAG,GAAG;QACxB,OAAO;YACLX;YACAM,SACE,CAAC,aAAa,EAAEP,eAAe,KAAK,EAAEC,UAAUW,MAAM,CAAC,wBAAwB,CAAC,GAChF,CAAC,CAAC,EAAEV,WAAWM,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9BC,UAAU;YACVC,MAAM;QACR;IACF;IACA,OAAO;QAACC,gBAAgBV,SAAS,CAAC,EAAE,CAACI,EAAE;QAAEK,MAAM;IAAU;AAC3D;AAEA;;;;;;CAMC,GACD,OAAO,eAAeG,sBAAsBf,OAI3C;IACC,MAAM,EAACC,kBAAkB,EAAEC,cAAc,EAAEc,UAAU,EAAC,GAAGhB;IACzD,MAAMiB,aAAa,MAAMlB,oBAAoB;QAACE;QAAoBC;IAAc;IAEhF,OAAQe,WAAWL,IAAI;QACrB,KAAK;YAAa;gBAChB,IAAI,CAACI,YAAY,OAAOnB,sBAAsB;oBAACqB,gBAAgBD,WAAWd,SAAS;gBAAA;gBACnF,MAAM,IAAIR,SAAS,GAAGsB,WAAWR,OAAO,CAAC,EAAE,EAAEQ,WAAWN,QAAQ,CAAC,CAAC,CAAC,EAAE;oBACnEQ,MAAMvB,UAAUwB,WAAW;gBAC7B;YACF;QACA,KAAK;YAAgB;gBACnB,MAAM,IAAIzB,SAAS,GAAGsB,WAAWR,OAAO,CAAC,EAAE,EAAEQ,WAAWN,QAAQ,CAAC,CAAC,CAAC,EAAE;oBACnEQ,MAAMvB,UAAUwB,WAAW;gBAC7B;YACF;QACA,KAAK;YAAe;gBAClB,MAAM,IAAIzB,SAAS,GAAGsB,WAAWR,OAAO,CAAC,EAAE,EAAEQ,WAAWN,QAAQ,CAAC,CAAC,CAAC,EAAE;oBACnEQ,MAAMvB,UAAUyB,aAAa;gBAC/B;YACF;QACA;YAAS;gBACP,OAAOJ,WAAWJ,cAAc;YAClC;IACF;AACF"}

package/dist/commands/context/build.js

@@ -3,7 +3,7 @@ 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 { watchJob } from '../../actions/context/watchJob.js';
+import { formatJobFailure, watchJob } from '../../actions/context/watchJob.js';
 import { formatKeyValue } from '../../actions/debug/output.js';
 import { buildKnowledgeBase, cancelKnowledgeBaseBuild } from '../../services/context.js';
 const buildContextDebug = subdebug('context:build');
@@ -85,7 +85,7 @@ export class BuildKnowledgeBaseCommand extends SanityCommand {
             });
         }
         if (job.status !== 'succeeded') {
-            this.error(`Build ${job.status}${job.error ? `: ${job.error}` : ''}`, {
+            this.error(formatJobFailure('Build', job), {
                 exit: exitCodes.RUNTIME_ERROR
             });
         }

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

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