@astryxdesign/cli 0.7.12-canary.f36bd72 → 0.7.12

package/api/doctor/doctor.mjs

@@ -27,7 +27,10 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 
-import {MIN_NODE_VERSION, isNodeVersionSupported} from '../../foundation/env/node-version.mjs';
+import {
+  MIN_NODE_VERSION,
+  isNodeVersionSupported,
+} from '../../foundation/env/node-version.mjs';
 import {
   AGENT_DOC_PATHS,
   holdsAstryxBlock,
@@ -37,9 +40,21 @@ import {
   assertAgentDocsTarget,
   resolveAgentDocsRoot,
 } from '../../foundation/agent-docs/agent-docs.mjs';
-import {CLI_ROOT, findProjectCoreDir, findInstalledPackage} from '../../foundation/fs/paths.mjs';
-import {explainPackageManager, formatCliCommand, getCliInvocation, guessCliInvocation} from '../../foundation/env/package-manager.mjs';
-import {chooseDeclaredCliCommand, declaredCliCommandsOf} from '../../foundation/env/cli-command.mjs';
+import {
+  CLI_ROOT,
+  findProjectCoreDir,
+  findInstalledPackage,
+} from '../../foundation/fs/paths.mjs';
+import {
+  explainPackageManager,
+  formatCliCommand,
+  getCliInvocation,
+  guessCliInvocation,
+} from '../../foundation/env/package-manager.mjs';
+import {
+  chooseDeclaredCliCommand,
+  declaredCliCommandsOf,
+} from '../../foundation/env/cli-command.mjs';
 import {
   findConfigPath,
   Project,
@@ -64,15 +79,40 @@ import {
 import {typedEdges} from '../docs/node/node.mjs';
 import {detailView, indexView} from '../../foundation/doc-compiler/lenses.mjs';
 import {isExperimentalTreeNode} from '../../foundation/doc-compiler/tree.mjs';
-import {semverCompare, isValidSemver, satisfiesRange} from '../../foundation/env/semver.mjs';
+import {
+  semverCompare,
+  isValidSemver,
+  satisfiesRange,
+} from '../../foundation/env/semver.mjs';
 import {
   checkAppThemes,
   checkThemes,
   themeImportWiring,
 } from './theme-checks.mjs';
-import {availableLine, RUN_FROM_PROJECT, upgradeLine} from '../../foundation/release/notices.mjs';
-import {COMPUTER_COMMAND, COMPUTER_INSTALL_STEP} from '../../foundation/agent-docs/computer-agent-text.mjs';
-import {alignCommand, addCliCommandFor, computerAgentTextState, installCommandFor, insideProjectElsewhere, projectCoreVersion, projectHasOwnCli, computerIntegrationsOutside, computerIntegrationsToAdd, displayHomePath, outsideProject, releaseFacts, builtIntegrationPackages} from './_adapter.mjs';
+import {
+  availableLine,
+  RUN_FROM_PROJECT,
+  upgradeLine,
+} from '../../foundation/release/notices.mjs';
+import {
+  COMPUTER_COMMAND,
+  COMPUTER_INSTALL_STEP,
+} from '../../foundation/agent-docs/computer-agent-text.mjs';
+import {
+  alignCommand,
+  addCliCommandFor,
+  computerAgentTextState,
+  installCommandFor,
+  insideProjectElsewhere,
+  projectCoreVersion,
+  projectHasOwnCli,
+  computerIntegrationsOutside,
+  computerIntegrationsToAdd,
+  displayHomePath,
+  outsideProject,
+  releaseFacts,
+  builtIntegrationPackages,
+} from './_adapter.mjs';
 import {checkBuilt} from './built-checks.mjs';
 
 /**
@@ -248,7 +288,9 @@ export function checkCoreInstalled(ctx) {
       : '@astryxdesign/core could not be resolved from this project.',
     ...(found
       ? {}
-      : {fix: 'Install the design system: `npm install @astryxdesign/core` (or yarn/pnpm/bun).'}),
+      : {
+          fix: 'Install the design system: `npm install @astryxdesign/core` (or yarn/pnpm/bun).',
+        }),
   };
 }
 
@@ -272,7 +314,8 @@ export function checkVersionAlignment(ctx) {
       id: 'version-alignment',
       label: '@astryxdesign/core <-> @astryxdesign/cli alignment',
       status: 'info',
-      message: 'Skipped — could not read both @astryxdesign/core and @astryxdesign/cli versions.',
+      message:
+        'Skipped — could not read both @astryxdesign/core and @astryxdesign/cli versions.',
     };
   }
 
@@ -386,7 +429,10 @@ export async function checkConfig(ctx) {
     const {pathToFileURL} = await import('node:url');
     const mod = await import(pathToFileURL(ctx.configPath).href);
     const config = mod.default;
-    if (config !== undefined && (typeof config !== 'object' || config === null)) {
+    if (
+      config !== undefined &&
+      (typeof config !== 'object' || config === null)
+    ) {
       return {
         id: 'config',
         label: 'astryx.config.mjs',
@@ -438,9 +484,13 @@ export async function checkConfig(ctx) {
 function describeNoImplicit(integrations) {
   const own = integrations.filter(integration => integration.__local);
   const configured = integrations.length - own.length;
-  const ownNames = own.map(integration => integration.name ?? 'this package').join(', ');
-  if (own.length === 0) return 'None — every loaded integration is named in astryx.config.';
-  if (configured === 0) return `None — the only loaded integration is this package's own manifest (${ownNames}).`;
+  const ownNames = own
+    .map(integration => integration.name ?? 'this package')
+    .join(', ');
+  if (own.length === 0)
+    return 'None — every loaded integration is named in astryx.config.';
+  if (configured === 0)
+    return `None — the only loaded integration is this package's own manifest (${ownNames}).`;
   return `None — every loaded integration is named in astryx.config or is this package's own manifest (${ownNames}).`;
 }
 
@@ -476,7 +526,10 @@ export function checkImplicitIntegrations(ctx) {
       id,
       label,
       status: 'info',
-      message: skippedBecause(ctx, 'the project configuration could not be read'),
+      message: skippedBecause(
+        ctx,
+        'the project configuration could not be read',
+      ),
     };
   }
 
@@ -491,7 +544,9 @@ export function checkImplicitIntegrations(ctx) {
     // A record that carries `__loadError` (the package's own manifest, or a
     // configured one, that failed to load) loaded nothing, so it is not named
     // as loaded beside the line reporting that it could not be loaded.
-    const loaded = ctx.integrations.filter(integration => !integration.__loadError);
+    const loaded = ctx.integrations.filter(
+      integration => !integration.__loadError,
+    );
     return {
       id,
       label,
@@ -533,12 +588,16 @@ export function checkImplicitIntegrations(ctx) {
         typeof integration.__packageDir === 'string'
           ? integration.__packageDir
           : (ctx.cwd ?? process.cwd());
-      return !fs.existsSync(path.isAbsolute(dir) ? dir : path.resolve(base, dir));
+      return !fs.existsSync(
+        path.isAbsolute(dir) ? dir : path.resolve(base, dir),
+      );
     });
     const roots = declared.filter(root => !missing.includes(root));
     const contributes = roots.length > 0 ? roots.join(', ') : 'nothing';
     const absent =
-      missing.length > 0 ? ` (declared ${missing.join(', ')} missing on disk)` : '';
+      missing.length > 0
+        ? ` (declared ${missing.join(', ')} missing on disk)`
+        : '';
     return `${integration.name}${version}${alias} from ${integration.__dependencyField}, contributing ${contributes}${absent}`;
   });
 
@@ -610,7 +669,10 @@ export function checkConfiguredIntegrations(ctx) {
       id,
       label,
       status: 'info',
-      message: skippedBecause(ctx, 'the project configuration could not be read'),
+      message: skippedBecause(
+        ctx,
+        'the project configuration could not be read',
+      ),
     };
   }
   // What counts as configured is what astryx.config names, read from the
@@ -676,7 +738,9 @@ function agentDocsRefusal(cwd) {
     assertAgentDocsTarget(agentDocsTargetDir(cwd));
     return null;
   } catch (err) {
-    return err instanceof Error && err.name === 'AgentDocsHomeError' ? err.message : null;
+    return err instanceof Error && err.name === 'AgentDocsHomeError'
+      ? err.message
+      : null;
   }
 }
 
@@ -691,9 +755,11 @@ export function checkAgentDocs(ctx) {
   // src/ or a nested package, the docs sit at the root.
   const dirs = [
     ...new Set(
-      [ctx.cwd, projectRootOf(ctx), resolveAgentDocsRoot(ctx.cwd) ?? ctx.cwd].map(dir =>
-        path.resolve(dir),
-      ),
+      [
+        ctx.cwd,
+        projectRootOf(ctx),
+        resolveAgentDocsRoot(ctx.cwd) ?? ctx.cwd,
+      ].map(dir => path.resolve(dir)),
     ),
   ];
   const present = dirs.flatMap(dir =>
@@ -736,8 +802,10 @@ export function checkAgentDocs(ctx) {
   const withMarkers = present.filter(abs => {
     const content = read(abs);
     return (
-      (content.includes('<!-- ASTRYX:START -->') || content.includes('<!-- XDS:START -->')) &&
-      (content.includes('<!-- ASTRYX:END -->') || content.includes('<!-- XDS:END -->')) &&
+      (content.includes('<!-- ASTRYX:START -->') ||
+        content.includes('<!-- XDS:START -->')) &&
+      (content.includes('<!-- ASTRYX:END -->') ||
+        content.includes('<!-- XDS:END -->')) &&
       holdsAstryxBlock(content)
     );
   });
@@ -746,7 +814,9 @@ export function checkAgentDocs(ctx) {
   // of AGENTS.md) is broken when that file holds no block: the agents that
   // read either file get no Astryx docs.
   const dangling = present.flatMap(abs => {
-    const match = /<!-- ASTRYX:START -->\s*@(\S+)\s*<!-- ASTRYX:END -->/.exec(read(abs));
+    const match = /<!-- ASTRYX:START -->\s*@(\S+)\s*<!-- ASTRYX:END -->/.exec(
+      read(abs),
+    );
     if (match == null) return [];
     const target = path.resolve(path.dirname(abs), match[1]);
     return holdsAstryxBlock(read(target)) ? [] : [{abs, target}];
@@ -848,8 +918,12 @@ export function checkPeerDeps(ctx) {
     // Pin the required range for anything wrong so the hint fixes it even when a
     // stale consumer range would otherwise resolve an incompatible version.
     // Quote targets containing shell metacharacters (e.g. `react@>=19.0.0`).
-    const quote = (/** @type {string} */ s) => (/[<>|() ]/.test(s) ? `'${s}'` : s);
-    const targets = [...missing, ...mismatched.map(m => `${m.name}@${m.want}`)].map(quote);
+    const quote = (/** @type {string} */ s) =>
+      /[<>|() ]/.test(s) ? `'${s}'` : s;
+    const targets = [
+      ...missing,
+      ...mismatched.map(m => `${m.name}@${m.want}`),
+    ].map(quote);
     return {
       id: 'peer-deps',
       label: '@astryxdesign/core peer dependencies',
@@ -1060,7 +1134,10 @@ export function checkProviderIdentity(ctx) {
       id,
       label,
       status: 'info',
-      message: skippedBecause(ctx, 'the project configuration could not be read'),
+      message: skippedBecause(
+        ctx,
+        'the project configuration could not be read',
+      ),
     };
   }
 
@@ -1241,7 +1318,8 @@ export async function checkAuthoringDocs(_ctx, options = {}) {
     const audit = await auditAuthoringSelfDocs({root, sources});
     const problems = [
       ...audit.unreachable.map(
-        source => `${source} is not in \`${formatCliCommand('docs authoring/field-reference')}\``,
+        source =>
+          `${source} is not in \`${formatCliCommand('docs authoring/field-reference')}\``,
       ),
       ...audit.failed.map(
         ({source, error}) => `${source} failed to load: ${error}`,
@@ -1257,7 +1335,9 @@ export async function checkAuthoringDocs(_ctx, options = {}) {
         : {keys: options.topicKeys};
     const surface = [
       ...('error' in topic
-        ? [`\`${formatCliCommand('docs authoring/field-reference')}\` could not be read: ${topic.error}`]
+        ? [
+            `\`${formatCliCommand('docs authoring/field-reference')}\` could not be read: ${topic.error}`,
+          ]
         : []),
       ...surfaceProblems(
         await auditAuthoringSurface({root, sources, topicKeys: topic.keys}),
@@ -1299,7 +1379,7 @@ export async function checkAuthoringDocs(_ctx, options = {}) {
 
 /** How the CLI-docs audit's problems are fixed. */
 const CLI_DOCS_FIX =
-  "Set `namespace` on each CLI doc to the one that reads it: cli/commands for a command, cli/api for an API function or the output schema, error codes, and response types, and authoring for a file an author writes (and list it in AUTHORING_SELF_DOCS).";
+  'Set `namespace` on each CLI doc to the one that reads it: cli/commands for a command, cli/api for an API function or the output schema, error codes, and response types, and authoring for a file an author writes (and list it in AUTHORING_SELF_DOCS).';
 
 /** How the docs-tree check's problems are fixed. */
 const DOCS_TREE_FIX =
@@ -1381,8 +1461,7 @@ export async function checkDocsTree(_ctx, options = {}) {
   const id = 'docs-tree';
   const label = 'Docs tree';
   try {
-    const catalog =
-      /** @type {any} */ (_ctx)?.docsCatalog ?? builtinCatalog();
+    const catalog = /** @type {any} */ (_ctx)?.docsCatalog ?? builtinCatalog();
     const tree = options.tree ?? (await projectTree(catalog, {fresh: true}));
     const problems = tree.diagnostics
       .filter(d => d.severity === 'error')
@@ -1397,7 +1476,9 @@ export async function checkDocsTree(_ctx, options = {}) {
       );
       for (const {source, doc} of (await loadCliSelfDocs()).loaded) {
         if (CLI_DOC_NAMESPACES[doc.namespace]?.reader !== 'tree') continue;
-        if (!placed.has(`@astryxdesign/cli\u0000${doc.type}\u0000${doc.name}`)) {
+        if (
+          !placed.has(`@astryxdesign/cli\u0000${doc.type}\u0000${doc.name}`)
+        ) {
           problems.push(
             `${source} has namespace "${doc.namespace}", but no docs-tree namespace adopts it`,
           );
@@ -1450,7 +1531,6 @@ export async function checkDocsTree(_ctx, options = {}) {
   }
 }
 
-
 /**
  * Every topic reads progressively, in every language it ships: it loads, its
  * section index and each of its sections fit in one read, and no contributed
@@ -1465,7 +1545,9 @@ export async function checkDocsProgressiveDisclosure(ctx) {
   /** @type {string[]} */
   const problems = [];
   if (ctx.docsCatalogError) {
-    problems.push(`The docs catalog could not be built: ${ctx.docsCatalogError}`);
+    problems.push(
+      `The docs catalog could not be built: ${ctx.docsCatalogError}`,
+    );
   }
   for (const issue of ctx.docsCatalogIssues ?? []) {
     problems.push(`${issue.package ?? 'a contributed doc'}: ${issue.message}`);
@@ -1581,14 +1663,14 @@ export function checkCliCommand(ctx) {
  * @property {{cli: string, core: string | null, copy: string}} answeredBy
  * @property {string | null} latest the newest release known, or null
  * @property {Array<{path: string, state: import('../../foundation/agent-docs/computer-agent-text.mjs').ComputerAgentTextState}>} [agentText]
-  *   each file of the computer-level agent text against this release's rendering
+ *   each file of the computer-level agent text against this release's rendering
  * @property {import('../../foundation/env/user-settings.mjs').ComputerAgentTextSettings} [agentTextSettings]
  *   the person's choices about the computer-level agent text
  * @property {string | null} [agentTextCommand] the command the skill file
  *   tells agents to run, or null
  * @property {string | null} [agentTextInstall] the install step the skill
  *   file records for when that command is not found, or null
-  * @property {string} [cwd] the folder doctor runs in, for the printed fix
+ * @property {string} [cwd] the folder doctor runs in, for the printed fix
  * @property {import('../../foundation/release/notices.mjs').GlobalBehind | null} [globalBehind]
  *   the CLI installed for the computer, when it is older than the newest
  *   release (outside a project)
@@ -1600,7 +1682,7 @@ export function checkCliCommand(ctx) {
  *   the newest update notice that did not print, and why (diagnostic only)
  * @property {{pid: number | null, host: string | null, since: number} | null} [stateLock]
  *   who holds the state file's lock now (diagnostic only)
-  * @property {Array<import('../../foundation/env/search-path.mjs').SearchPathCommand & {upgrade?: string | null, runner?: boolean}>} [searchPathCommands]
+ * @property {Array<import('../../foundation/env/search-path.mjs').SearchPathCommand & {upgrade?: string | null, runner?: boolean}>} [searchPathCommands]
  *   every `astryx` on the search path, with the command that upgrades it
  *   the `astryx` commands on the search path, in order
  * @property {import('../../foundation/integrations/computer-integrations.mjs').ComputerIntegrationCandidate[]} [computerIntegrations]
@@ -1649,7 +1731,9 @@ export function checkNewestRelease(ctx) {
     skipNote(ctx.lastNoticeSkip),
     lockNote(ctx.stateLock),
   ].filter(Boolean);
-  return notes.length > 0 ? {...check, message: [check.message, ...notes].join(' ')} : check;
+  return notes.length > 0
+    ? {...check, message: [check.message, ...notes].join(' ')}
+    : check;
 }
 
 /**
@@ -1660,7 +1744,10 @@ export function checkNewestRelease(ctx) {
  */
 function lockNote(lock) {
   if (!lock) return null;
-  const by = lock.pid == null ? '' : ` by process ${lock.pid}${lock.host ? ` on ${lock.host}` : ''}`;
+  const by =
+    lock.pid == null
+      ? ''
+      : ` by process ${lock.pid}${lock.host ? ` on ${lock.host}` : ''}`;
   return `The state file's lock is held${by} since ${new Date(lock.since).toISOString()}.`;
 }
 
@@ -1687,7 +1774,8 @@ function checkFailureNote(failed) {
 const SKIP_REASONS = {
   'already-shown': 'it had already printed that day',
   'no-newer': 'no newer release was known',
-  'no-project': 'the folder belongs to no Astryx project, so no install command fits',
+  'no-project':
+    'the folder belongs to no Astryx project, so no install command fits',
 };
 
 /**
@@ -1698,7 +1786,9 @@ const SKIP_REASONS = {
  */
 function skipNote(skip) {
   if (!skip) return null;
-  const why = /** @type {Record<string, string>} */ (SKIP_REASONS)[skip.reason] ?? skip.reason;
+  const why =
+    /** @type {Record<string, string>} */ (SKIP_REASONS)[skip.reason] ??
+    skip.reason;
   return `Last update notice skipped ${new Date(skip.at).toISOString()} (${skip.key}): ${why}.`;
 }
 
@@ -1710,7 +1800,11 @@ function skipNote(skip) {
 function newestReleaseCheck(ctx) {
   const {latest, globalBehind: behind, projectLag: lag} = ctx;
   const {cli} = ctx.answeredBy;
-  const base = {id: 'newest-release', label: 'Newest release', status: /** @type {const} */ ('info')};
+  const base = {
+    id: 'newest-release',
+    label: 'Newest release',
+    status: /** @type {const} */ ('info'),
+  };
   if (behind) {
     return {
       ...base,
@@ -1728,16 +1822,24 @@ function newestReleaseCheck(ctx) {
   if (!latest) {
     return {
       ...base,
-      message: 'Update check: not run yet, so the newest release is not known here; it runs in the background once a day, after a command.',
+      message:
+        'Update check: not run yet, so the newest release is not known here; it runs in the background once a day, after a command.',
     };
   }
-  if (isValidSemver(latest) && isValidSemver(cli) && semverCompare(latest, cli) > 0) {
+  if (
+    isValidSemver(latest) &&
+    isValidSemver(cli) &&
+    semverCompare(latest, cli) > 0
+  ) {
     return {
       ...base,
       message: `Release ${latest} is newer than ${cli}, the release that answered.`,
     };
   }
-  return {...base, message: `No newer release is known: the newest is ${latest}.`};
+  return {
+    ...base,
+    message: `No newer release is known: the newest is ${latest}.`,
+  };
 }
 
 /**
@@ -1750,16 +1852,24 @@ function newestReleaseCheck(ctx) {
 export function checkCliOnPath(ctx) {
   const rows = ctx.searchPathCommands ?? [];
   const base = {id: 'cli-on-path', label: '`astryx` on the search path'};
-  const describe = (/** @type {import('../../foundation/env/search-path.mjs').SearchPathCommand} */ row) =>
-    row.astryx ? `${row.file} (CLI ${row.version ?? 'of unknown version'})` : `${row.file} (not the Astryx CLI)`;
+  const describe = (
+    /** @type {import('../../foundation/env/search-path.mjs').SearchPathCommand} */ row,
+  ) =>
+    row.astryx
+      ? `${row.file} (CLI ${row.version ?? 'of unknown version'})`
+      : `${row.file} (not the Astryx CLI)`;
   const others = rows.slice(1);
-  const othersNote = others.length > 0 ? ` Later on the search path: ${others.map(describe).join(', ')}.` : '';
+  const othersNote =
+    others.length > 0
+      ? ` Later on the search path: ${others.map(describe).join(', ')}.`
+      : '';
   const [first] = rows;
   if (!first) {
     return {
       ...base,
       status: 'info',
-      message: 'No `astryx` command on the search path, so `astryx` runs only through a package manager.',
+      message:
+        'No `astryx` command on the search path, so `astryx` runs only through a package manager.',
       fix: 'To run the CLI in any folder, install it for the computer: `npm i -g @astryxdesign/cli`.',
     };
   }
@@ -1796,8 +1906,11 @@ export function checkCliOnPath(ctx) {
  * @returns {DoctorCheck}
  */
 export function checkComputerAgentText(ctx) {
-  const state = ctx.agentTextSettings && ctx.agentText ? null : computerAgentTextState();
-  const settings = ctx.agentTextSettings ?? /** @type {NonNullable<typeof state>} */ (state).settings;
+  const state =
+    ctx.agentTextSettings && ctx.agentText ? null : computerAgentTextState();
+  const settings =
+    ctx.agentTextSettings ??
+    /** @type {NonNullable<typeof state>} */ (state).settings;
   const base = {
     id: 'computer-agent-text',
     label: 'Computer-level agent text',
@@ -1806,26 +1919,41 @@ export function checkComputerAgentText(ctx) {
   if (!settings.install) {
     return {
       ...base,
-      message: 'The computer-level agent text is turned off (`astryx init --user --remove-agents`), so the CLI installed for the computer does not write it.',
+      message:
+        'The computer-level agent text is turned off (`astryx init --user --remove-agents`), so the CLI installed for the computer does not write it.',
       fix: `To turn it back on, run \`${formatCliCommand('astryx init --user', ctx.cwd)}\`.`,
     };
   }
-  const entries = ctx.agentText ?? /** @type {NonNullable<typeof state>} */ (state).entries;
-  const command = ctx.agentText ? (ctx.agentTextCommand ?? null) : /** @type {NonNullable<typeof state>} */ (state).command;
-  const recorded = (ctx.agentText ? ctx.agentTextInstall : /** @type {NonNullable<typeof state>} */ (state).install) ?? null;
+  const entries =
+    ctx.agentText ?? /** @type {NonNullable<typeof state>} */ (state).entries;
+  const command = ctx.agentText
+    ? (ctx.agentTextCommand ?? null)
+    : /** @type {NonNullable<typeof state>} */ (state).command;
+  const recorded =
+    (ctx.agentText
+      ? ctx.agentTextInstall
+      : /** @type {NonNullable<typeof state>} */ (state).install) ?? null;
   const fix = `Run \`${formatCliCommand('astryx init --user', ctx.cwd)}\`.`;
   const [file, ...links] = entries;
   const home = (/** @type {{path: string}} */ e) => displayHomePath(e.path);
   const linked = links.filter(l => l.state === 'linked').map(home);
   const copied = links.filter(l => l.state === 'current').map(home);
-  const skipped = links.filter(l => l.state === 'foreign' || l.state === 'edited').map(home);
+  const skipped = links
+    .filter(l => l.state === 'foreign' || l.state === 'edited')
+    .map(home);
   const dangling = links.filter(l => l.state === 'dangling').map(home);
-  const missing = links.filter(l => l.state === 'absent' || l.state === 'differs').map(home);
+  const missing = links
+    .filter(l => l.state === 'absent' || l.state === 'differs')
+    .map(home);
   const linkNote =
     (linked.length > 0 ? ` Linked into: ${linked.join(', ')}.` : '') +
     (copied.length > 0 ? ` Copied into: ${copied.join(', ')}.` : '') +
-    (skipped.length > 0 ? ` Not linked, because something Astryx did not create is there: ${skipped.join(', ')}.` : '') +
-    (dangling.length > 0 ? ` Linked, but the skill folder the link points to is not there, so agents reading it see nothing (as in a container that mounts only that folder): ${dangling.join(', ')}.` : '') +
+    (skipped.length > 0
+      ? ` Not linked, because something Astryx did not create is there: ${skipped.join(', ')}.`
+      : '') +
+    (dangling.length > 0
+      ? ` Linked, but the skill folder the link points to is not there, so agents reading it see nothing (as in a container that mounts only that folder): ${dangling.join(', ')}.`
+      : '') +
     (missing.length > 0 ? ` Not linked yet: ${missing.join(', ')}.` : '');
   if (file.state === 'foreign' || file.state === 'edited') {
     return {
@@ -1878,15 +2006,20 @@ export function checkComputerAgentText(ctx) {
 export function checkComputerIntegrations(ctx) {
   const found = ctx.computerIntegrations ?? [];
   const loaded = new Set(ctx.loadedComputerIntegrations ?? []);
-  const base = {id: 'computer-integrations', label: 'Integrations installed for this computer'};
+  const base = {
+    id: 'computer-integrations',
+    label: 'Integrations installed for this computer',
+  };
   if (found.length === 0) {
     return {
       ...base,
       status: 'info',
-      message: 'No integration is installed beside the CLI installed for this computer.',
+      message:
+        'No integration is installed beside the CLI installed for this computer.',
     };
   }
-  const label = (/** @type {{name: string, version?: string}} */ c) => (c.version ? `${c.name}@${c.version}` : c.name);
+  const label = (/** @type {{name: string, version?: string}} */ c) =>
+    c.version ? `${c.name}@${c.version}` : c.name;
   const own = new Set(ctx.folderIntegrations ?? []);
   const shadowed = found.filter(c => own.has(c.name));
   const rest = found.filter(c => !own.has(c.name));
@@ -1894,14 +2027,24 @@ export function checkComputerIntegrations(ctx) {
   const skipped = rest.filter(c => c.incompatible);
   const failed = rest.filter(c => !c.incompatible && !loaded.has(c.name));
   const notes = [
-    used.length > 0 ? `Used outside a project: ${used.map(label).join(', ')}.` : '',
-    ...shadowed.map(c => `${label(c)} is not used here: this folder loads its own copy of ${c.name}.`),
+    used.length > 0
+      ? `Used outside a project: ${used.map(label).join(', ')}.`
+      : '',
+    ...shadowed.map(
+      c =>
+        `${label(c)} is not used here: this folder loads its own copy of ${c.name}.`,
+    ),
     ...skipped.map(c => `Skipped ${label(c)}: ${c.incompatible}.`),
     ...failed.map(c => `${label(c)} could not be loaded.`),
   ].filter(Boolean);
   const fixes = [
-    ...skipped.map(c => `install a release of ${c.name} that supports this CLI`),
-    ...failed.map(c => `run \`${formatCliCommand(`astryx doctor integration validate ${c.name}`, ctx.cwd)}\``),
+    ...skipped.map(
+      c => `install a release of ${c.name} that supports this CLI`,
+    ),
+    ...failed.map(
+      c =>
+        `run \`${formatCliCommand(`astryx doctor integration validate ${c.name}`, ctx.cwd)}\``,
+    ),
   ];
   return {
     ...base,
@@ -1922,18 +2065,33 @@ export function checkComputerIntegrations(ctx) {
  *   fix points at the project's folder
  * @returns {DoctorCheck}
  */
-export function checkComputerIntegrationsAvailable({installed, candidates, install, elsewhere = false}) {
+export function checkComputerIntegrationsAvailable({
+  installed,
+  candidates,
+  install,
+  elsewhere = false,
+}) {
   const available = candidates.filter(c => !installed.has(c.name));
-  const base = {id: 'computer-integrations', label: 'Integrations installed for this computer', status: /** @type {const} */ ('info')};
+  const base = {
+    id: 'computer-integrations',
+    label: 'Integrations installed for this computer',
+    status: /** @type {const} */ ('info'),
+  };
   if (available.length === 0) {
-    return {...base, message: 'No integration installed for this computer is missing from this project.'};
+    return {
+      ...base,
+      message:
+        'No integration installed for this computer is missing from this project.',
+    };
   }
   const add = install;
   return {
     ...base,
     message: `Installed for this computer but not in this project, so not used here: ${available.map(c => c.name).join(', ')}.`,
     ...(add
-      ? {fix: `To use one in this project, run ${available.map(c => `\`${add(c.name)}\``).join(' or ')}.`}
+      ? {
+          fix: `To use one in this project, run ${available.map(c => `\`${add(c.name)}\``).join(' or ')}.`,
+        }
       : elsewhere
         ? {fix: NO_PROJECT_FIX}
         : {}),
@@ -1952,9 +2110,9 @@ export const COMPUTER_CHECKS = [
       coreDir: null,
       configPath: null,
     }),
-    checkAnsweringRelease,
+  checkAnsweringRelease,
   checkNewestRelease,
-    checkCliOnPath,
+  checkCliOnPath,
   checkComputerIntegrations,
   checkComputerAgentText,
 ];
@@ -2016,7 +2174,10 @@ export async function runChecks(options = {}) {
     const cwd = rest.cwd ?? process.cwd();
     const checks = [
       ...report.checks,
-      ...checkBuilt(built, {cwd, packages: builtIntegrationPackages(built, cwd)}),
+      ...checkBuilt(built, {
+        cwd,
+        packages: builtIntegrationPackages(built, cwd),
+      }),
     ];
     const summary = {pass: 0, warn: 0, fail: 0, info: 0};
     for (const c of checks) summary[c.status] += 1;
@@ -2222,9 +2383,18 @@ export async function runChecks(options = {}) {
     }),
   );
   {
-    const loadedNames = (project?.loadedIntegrations ?? []).map((/** @type {{name: string}} */ i) => i.name);
+    const loadedNames = (project?.loadedIntegrations ?? []).map(
+      (/** @type {{name: string}} */ i) => i.name,
+    );
     const candidates = await computerIntegrationsToAdd(cwd, loadedNames);
-    checks.push(checkComputerIntegrationsAvailable({installed: new Set(loadedNames), candidates, install: installCommandFor(cwd), elsewhere: insideProjectElsewhere(cwd)}));
+    checks.push(
+      checkComputerIntegrationsAvailable({
+        installed: new Set(loadedNames),
+        candidates,
+        install: installCommandFor(cwd),
+        elsewhere: insideProjectElsewhere(cwd),
+      }),
+    );
   }
   checks.push(await checkAuthoringDocs(ctx));
   checks.push(await checkCliDocs(ctx));