@astryxdesign/cli 0.6.3-canary.f22695a → 0.6.3

package/foundation/integrations/validate-contributions.mjs

@@ -39,9 +39,6 @@ import {discoverIntegrationThemes} from '../discovery/theme-discovery.mjs';
 /** Stable issue code for an invalid optional agent-doc contribution. */
 export const INVALID_AGENT_DOCS = 'invalid_agent_docs';
 
-/** Stable issue code for a package whose provider ID is already claimed. */
-export const DUPLICATE_PROVIDER = 'duplicate_provider';
-
 /** @param {string} code @param {string} message @returns {Issue} */
 export function issueError(code, message) {
   return {code, severity: 'error', message};
@@ -292,13 +289,6 @@ export async function validateLoadedIntegration(loaded) {
   /** @type {Issue[]} */
   const issues = [];
   if (!loaded || typeof loaded !== 'object') return issues;
-  // A package set aside for claiming another package's provider ID has no
-  // contribution roots to check; the conflict itself is what to report.
-  if (loaded.__providerConflict) {
-    return [
-      issueWarning(DUPLICATE_PROVIDER, loaded.__providerConflict.message),
-    ];
-  }
   // A manifest that threw on import (or failed the schema) carries a load-error
   // marker and no contribution roots, so every check below would find nothing
   // and report a clean integration — which is how a stale manifest used to go

package/foundation/response/json-contract.test.mjs

@@ -13,8 +13,6 @@
 
 import {describe, it, expect, beforeEach, afterEach, vi} from 'vitest';
 import {spawnSync} from 'node:child_process';
-import * as fs from 'node:fs';
-import * as os from 'node:os';
 import * as path from 'node:path';
 import {fileURLToPath} from 'node:url';
 import {
@@ -29,20 +27,10 @@ import {
 } from './json.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const CLI = path.resolve(
-  __dirname,
-  '..',
-  '..',
-  'clients',
-  'cli',
-  'bin',
-  'astryx.mjs',
-);
-
-/** @param {string[]} args @param {{cwd?: string}} [options] */
-function runCli(args, {cwd = process.cwd()} = {}) {
+const CLI = path.resolve(__dirname, '..', '..', 'clients', 'cli', 'bin', 'astryx.mjs');
+
+function runCli(args) {
   return spawnSync(process.execPath, [CLI, ...args], {
-    cwd,
     encoding: 'utf8',
     timeout: 20_000,
     stdio: ['ignore', 'pipe', 'pipe'],
@@ -54,9 +42,7 @@ describe('json envelope shape', () => {
   let logs;
   beforeEach(() => {
     logs = [];
-    vi.spyOn(console, 'log').mockImplementation((...a) =>
-      logs.push(a.join(' ')),
-    );
+    vi.spyOn(console, 'log').mockImplementation((...a) => logs.push(a.join(' ')));
     setJsonMode(false);
   });
   afterEach(() => {
@@ -94,13 +80,11 @@ describe('json envelope shape', () => {
   });
 
   it('toErrorEnvelope honors an explicit code argument', () => {
-    expect(toErrorEnvelope('boom', undefined, 'ERR_UNKNOWN_COMPONENT')).toEqual(
-      {
-        apiVersion: API_VERSION,
-        error: 'boom',
-        code: 'ERR_UNKNOWN_COMPONENT',
-      },
-    );
+    expect(toErrorEnvelope('boom', undefined, 'ERR_UNKNOWN_COMPONENT')).toEqual({
+      apiVersion: API_VERSION,
+      error: 'boom',
+      code: 'ERR_UNKNOWN_COMPONENT',
+    });
   });
 
   it('toErrorEnvelope reads a code carried on a thrown Error', () => {
@@ -125,12 +109,8 @@ describe('json envelope shape', () => {
     // The guard is `Array.isArray(...) && .length`, not a bare `?.length` — a
     // string ("hello".length === 5) or a `{length: n}` object must NOT slip
     // through as `suggestions`, which is contractually a Suggestion[].
-    expect(
-      'suggestions' in toErrorEnvelope('x', /** @type {any} */ ('hello')),
-    ).toBe(false);
-    expect(
-      'suggestions' in toErrorEnvelope('x', /** @type {any} */ ({length: 3})),
-    ).toBe(false);
+    expect('suggestions' in toErrorEnvelope('x', /** @type {any} */ ('hello'))).toBe(false);
+    expect('suggestions' in toErrorEnvelope('x', /** @type {any} */ ({length: 3}))).toBe(false);
   });
 });
 
@@ -139,12 +119,8 @@ describe('stdout discipline (humanLog / humanWarn)', () => {
   beforeEach(() => {
     logs = [];
     errs = [];
-    vi.spyOn(console, 'log').mockImplementation((...a) =>
-      logs.push(a.join(' ')),
-    );
-    vi.spyOn(console, 'error').mockImplementation((...a) =>
-      errs.push(a.join(' ')),
-    );
+    vi.spyOn(console, 'log').mockImplementation((...a) => logs.push(a.join(' ')));
+    vi.spyOn(console, 'error').mockImplementation((...a) => errs.push(a.join(' ')));
   });
   afterEach(() => {
     vi.restoreAllMocks();
@@ -198,15 +174,10 @@ describe('contract: every --json emission is valid JSON with apiVersion', () =>
   });
 
   it('init emits its install receipt', () => {
-    const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'astryx-json-contract-'));
-    try {
-      const r = runCli(['init', '--json'], {cwd});
-      const env = JSON.parse(r.stdout);
-      expect(env.apiVersion).toBe(API_VERSION);
-      expect(env.type).toBe('init.run');
-    } finally {
-      fs.rmSync(cwd, {recursive: true, force: true});
-    }
+    const r = runCli(['init', '--json']);
+    const env = JSON.parse(r.stdout);
+    expect(env.apiVersion).toBe(API_VERSION);
+    expect(env.type).toBe('init.run');
   });
 
   it('supported command (discover) emits clean JSON, no human chatter leak', () => {

package/foundation/response/response-types.doc.mjs

@@ -68,15 +68,10 @@ export const doc = {
       description:
         "One topic's full ReferenceDoc, with token-ref blocks inlined.",
     },
-    {
-      value: 'docs.index',
-      description:
-        "One topic's section index (--index): each section's key, title, and one-line summary.",
-    },
     {
       value: 'docs.detail.section',
       description:
-        'One ReferenceSection of a topic, found by key or title, with token-ref blocks inlined.',
+        'A single ReferenceSection of a topic: the first whose title contains the section query.',
     },
 
     // blog (read from the published RSS feed)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/cli",
-  "version": "0.6.3-canary.f22695a",
+  "version": "0.6.3",
   "displayName": "CLI",
   "description": "Scaffold projects, browse templates, generate themes, and get agent-ready docs from the command line.",
   "author": "Meta Open Source",
@@ -100,10 +100,11 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@astryxdesign/charts": "0.6.3-canary.f22695a",
-    "@astryxdesign/core": "0.6.3-canary.f22695a",
-    "@astryxdesign/lab": "0.6.3-canary.f22695a",
-    "@astryxdesign/theme-neutral": "0.6.3-canary.f22695a"
+    "@astryxdesign/charts": "*",
+    "@astryxdesign/core": "*",
+    "@astryxdesign/lab": "*",
+    "@astryxdesign/theme-neutral": "*",
+    "gpt-tokenizer": "^3.4.0"
   },
   "peerDependenciesMeta": {
     "@astryxdesign/charts": {
@@ -120,13 +121,14 @@
     }
   },
   "devDependencies": {
-    "@astryxdesign/charts": "0.6.3-canary.f22695a",
-    "@astryxdesign/core": "0.6.3-canary.f22695a",
-    "@astryxdesign/lab": "0.6.3-canary.f22695a",
-    "@astryxdesign/theme-neutral": "0.6.3-canary.f22695a",
+    "@astryxdesign/charts": "*",
+    "@astryxdesign/core": "*",
+    "@astryxdesign/lab": "*",
+    "@astryxdesign/theme-neutral": "*",
     "@heroicons/react": "^2.2.0",
     "@stylexjs/stylex": "^0.19.0",
     "@types/babel__core": "^7.20.5",
+    "gpt-tokenizer": "^3.4.0",
     "lucide-react": "^1.18.0",
     "recharts": "^3.9.2"
   },

package/api/docs/compiled-topics.test.mjs

@@ -1,78 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file Every shipped topic compiles to a plain-JSON node that answers every
- * docs read exactly as the live one does, and no read can change another read
- * of the same catalog.
- */
-
-import {describe, expect, it} from 'vitest';
-import {parseCompiledReferenceNode} from '../../foundation/doc-compiler/ir.mjs';
-import {detailView, indexView} from '../../foundation/doc-compiler/lenses.mjs';
-import {
-  compileTopic,
-  loadDocsCatalog,
-  lowerTopic,
-  overlayLanguages,
-} from './_adapter.mjs';
-
-const SLOW = 60_000;
-
-describe('every shipped topic compiles to plain JSON', () => {
-  it(
-    'survives a JSON round trip with identical responses in every language',
-    async () => {
-      const catalog = await loadDocsCatalog();
-      let compiled = 0;
-      for (const entry of catalog.entries()) {
-        for (const lang of [null, ...overlayLanguages(entry)]) {
-          const lowered = await lowerTopic(catalog, entry, lang);
-          expect(parseCompiledReferenceNode(lowered)).toBe(lowered);
-          const node = await compileTopic(catalog, entry, lang);
-          expect(parseCompiledReferenceNode(node)).toBe(node);
-          const copy = parseCompiledReferenceNode(
-            JSON.parse(JSON.stringify(node)),
-          );
-          expect(JSON.stringify(detailView(copy))).toBe(
-            JSON.stringify(detailView(node)),
-          );
-          expect(JSON.stringify(indexView(copy))).toBe(
-            JSON.stringify(indexView(node)),
-          );
-          compiled += 1;
-        }
-      }
-      expect(compiled).toBeGreaterThan(catalog.entries().length);
-    },
-    SLOW,
-  );
-});
-
-describe('reads that share a catalog', () => {
-  it(
-    'never let one read change another',
-    async () => {
-      const catalog = await loadDocsCatalog();
-      const tokens = catalog.resolve('tokens');
-      const first = detailView(await compileTopic(catalog, tokens));
-      for (const section of first.sections) {
-        section.title = 'EDITED';
-        for (const block of section.content) {
-          if (typeof block.text === 'string') block.text = 'EDITED';
-          if (Array.isArray(block.rows)) block.rows.push(['EDITED']);
-        }
-      }
-      const again = detailView(await compileTopic(catalog, tokens));
-      const index = indexView(await lowerTopic(catalog, tokens));
-      const spacing = detailView(
-        await compileTopic(catalog, catalog.resolve('spacing')),
-      );
-      for (const read of [again, index, spacing]) {
-        expect(JSON.stringify(read)).not.toContain('EDITED');
-      }
-      const lowered = await lowerTopic(catalog, tokens);
-      expect(Object.isFrozen(lowered.doc.sections[0].content)).toBe(true);
-    },
-    SLOW,
-  );
-});

package/api/docs/index/index.d.mts

@@ -1,18 +0,0 @@
-// @generated by scripts/sync-api-types.mjs from the JSDoc in api/**/*.mjs.
-// DO NOT EDIT — run `pnpm sync:api-types` to regenerate.
-
-/**
- * @param {string} topic
- * @param {object} [options]
- * @param {string} [options.lang]
- * @param {boolean} [options.zh]
- * @param {boolean} [options.dense]
- * @param {string} [options.cwd]
- * @returns {Promise<import('../docs.type.mjs').DocsIndexResponse>}
- */
-export function index(topic: string, options?: {
-    lang?: string | undefined;
-    zh?: boolean | undefined;
-    dense?: boolean | undefined;
-    cwd?: string | undefined;
-}): Promise<import("../docs.type.mjs").DocsIndexResponse>;

package/api/docs/index/index.mjs

@@ -1,32 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file docs.index leaf — the section index of one topic.
- *
- * @input A topic name plus optional {lang, zh, dense, cwd}. Resolves the topic
- *   via the shared adapter and reads its lowered compiled node; nothing is
- *   linked, since the index never inlines a token reference.
- * @output { type: 'docs.index', data: DocsIndex } — the topic's name, title and
- *   description and, for each section, the key it is read by, its title, and a
- *   one-line summary. Matches `astryx --json docs <topic> --index`.
- * @position Leaf under api/docs: a topic's opt-in progressive read. One section
- *   is the section leaf (`docs <topic> <key>`); the whole topic, a plain topic
- *   read, is the detail leaf.
- */
-
-import {indexView} from '../../../foundation/doc-compiler/lenses.mjs';
-import {resolveTopicDocs} from '../_adapter.mjs';
-
-/**
- * @param {string} topic
- * @param {object} [options]
- * @param {string} [options.lang]
- * @param {boolean} [options.zh]
- * @param {boolean} [options.dense]
- * @param {string} [options.cwd]
- * @returns {Promise<import('../docs.type.mjs').DocsIndexResponse>}
- */
-export async function index(topic, options = {}) {
-  const {node} = await resolveTopicDocs(topic, options);
-  return {type: 'docs.index', data: indexView(node)};
-}

package/api/docs/index/index.test.mjs

@@ -1,62 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-import {describe, expect, it} from 'vitest';
-import {docs} from '../docs.mjs';
-import {index} from './index.mjs';
-import {loadDocsCatalog} from '../_adapter.mjs';
-
-const SLOW = 60_000;
-
-describe('docs.index leaf', () => {
-  it('lists each section by key, title, and summary', async () => {
-    const res = await index('theme');
-    expect(res.type).toBe('docs.index');
-    expect(res.data).toMatchObject({name: 'theme', title: expect.any(String)});
-    const keys = res.data.sections.map(s => s.id);
-    expect(new Set(keys).size).toBe(keys.length);
-    for (const entry of res.data.sections) {
-      expect(Object.keys(entry)).toEqual(['id', 'title', 'summary']);
-      expect(entry.summary.length).toBeLessThanOrEqual(240);
-    }
-  }, SLOW);
-
-  it('names the sections the full topic has, with the same keys', async () => {
-    const full = await docs('theme');
-    const {data} = await index('theme');
-    expect(data.sections.map(s => [s.id, s.title])).toEqual(
-      full.data.sections.map(s => [s.id, s.title]),
-    );
-  }, SLOW);
-
-  it('keeps every key the same in every language', async () => {
-    const english = (await index('theme')).data.sections.map(s => s.id);
-    for (const lang of ['zh', 'dense']) {
-      const localized = await index('theme', {lang});
-      expect(localized.data.sections.map(s => s.id)).toEqual(english);
-    }
-  }, SLOW);
-
-  it('lists keys every section can be read by', async () => {
-    const catalog = await loadDocsCatalog();
-    for (const entry of catalog.entries()) {
-      const {data} = await index(entry.name);
-      for (const {id, title} of data.sections) {
-        const read = await docs(entry.name, id);
-        expect(read.data.title).toBe(title);
-      }
-    }
-  }, SLOW);
-});
-
-describe('docs() topic reads', () => {
-  it('returns the whole topic by default, as before', async () => {
-    const res = await docs('theme');
-    expect(res.type).toBe('docs.detail');
-    expect(res.data.sections[0].content.length).toBeGreaterThan(0);
-  }, SLOW);
-
-  it('returns the section index on request', async () => {
-    const res = await docs('theme', undefined, {index: true});
-    expect(res.type).toBe('docs.index');
-  }, SLOW);
-});

package/api/upgrade/project-context.test.mjs

@@ -1,272 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file `loadProjectContext` agrees with Project on provider identity, so
- * `astryx upgrade` never runs codemods from a package Project set aside.
- *
- * Fixtures live under a repo-local temp dir, not /tmp, because Vite refuses to
- * dynamically import a module from outside the project root.
- */
-
-import {afterEach, beforeEach, describe, expect, it} from 'vitest';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import {loadProjectContext, selectIntegrationCodemodsFor} from './_adapter.mjs';
-
-let tmpDir;
-let originalCwd;
-
-beforeEach(() => {
-  originalCwd = process.cwd();
-  tmpDir = fs.mkdtempSync(path.join(process.cwd(), '.astryx-upgrade-context-'));
-});
-
-afterEach(() => {
-  process.chdir(originalCwd);
-  fs.rmSync(tmpDir, {recursive: true, force: true});
-});
-
-/**
- * Install an integration package that ships one 0.2.0 codemod.
- * @param {string} name
- * @param {string} version
- * @param {Record<string, unknown>} [manifest]
- */
-function installWithCodemod(name, version, manifest = {}) {
-  const pkgDir = path.join(tmpDir, 'node_modules', ...name.split('/'));
-  const codemodDir = path.join(pkgDir, 'codemods', '0.2.0');
-  fs.mkdirSync(codemodDir, {recursive: true});
-  fs.writeFileSync(path.join(pkgDir, 'package.json'), JSON.stringify({name, version}));
-  fs.writeFileSync(
-    path.join(pkgDir, 'astryx.integration.mjs'),
-    `export default ${JSON.stringify({codemods: './codemods', ...manifest})};\n`,
-  );
-  fs.writeFileSync(
-    path.join(codemodDir, 'rename.mjs'),
-    "export default {type: 'code', title: 'Rename', transform: file => file.source};\n",
-  );
-}
-
-/** @param {string[]} integrations */
-function configure(integrations) {
-  fs.writeFileSync(
-    path.join(tmpDir, 'astryx.config.mjs'),
-    `export default ${JSON.stringify({integrations})};\n`,
-  );
-}
-
-describe('loadProjectContext provider identity', () => {
-  it('keeps codemods from a configured package the authored package sets aside', async () => {
-    installWithCodemod('@acme/widgets', '1.0.0');
-    configure(['@acme/widgets']);
-    fs.writeFileSync(
-      path.join(tmpDir, 'package.json'),
-      JSON.stringify({name: '@acme/renamed', version: '2.0.0-dev'}),
-    );
-    fs.writeFileSync(
-      path.join(tmpDir, 'astryx.integration.mjs'),
-      "export default {providerId: '@acme/widgets'};\n",
-    );
-
-    const {integrations} = await loadProjectContext(tmpDir);
-    expect(
-      integrations.map(integration => [
-        integration.name,
-        Boolean(integration.__providerConflict),
-      ]),
-    ).toEqual([['@acme/widgets', true]]);
-    expect(
-      await selectIntegrationCodemodsFor(integrations, '0.1.0', '0.3.0'),
-    ).toEqual([]);
-  });
-
-  it('still selects codemods from a configured package nothing else claims', async () => {
-    installWithCodemod('@acme/widgets', '1.0.0');
-    configure(['@acme/widgets']);
-    fs.writeFileSync(path.join(tmpDir, 'package.json'), JSON.stringify({name: 'consumer'}));
-
-    const {integrations} = await loadProjectContext(tmpDir);
-    const selected = await selectIntegrationCodemodsFor(integrations, '0.1.0', '0.3.0');
-    expect(selected.map(entry => entry.version)).toEqual(['0.2.0']);
-  });
-
-  it('sets aside an --integration extra that claims a configured provider ID', async () => {
-    installWithCodemod('@acme/widgets', '1.0.0');
-    installWithCodemod('@acme/other', '1.0.0', {providerId: '@acme/widgets'});
-    configure(['@acme/widgets']);
-    fs.writeFileSync(path.join(tmpDir, 'package.json'), JSON.stringify({name: 'consumer'}));
-    // `--integration` specs resolve from the process cwd, as they always have.
-    process.chdir(tmpDir);
-
-    const {integrations} = await loadProjectContext(tmpDir, ['@acme/other']);
-    expect(
-      integrations.map(integration => [
-        integration.name,
-        integration.__providerConflict?.claimedBy ?? null,
-      ]),
-    ).toEqual([
-      ['@acme/widgets', null],
-      ['@acme/other', '@acme/widgets'],
-    ]);
-  });
-
-  it('runs the installed copy of a package that lists itself, not its work in progress', async () => {
-    installWithCodemod('@acme/widgets', '1.0.0');
-    configure(['@acme/widgets']);
-    fs.writeFileSync(
-      path.join(tmpDir, 'package.json'),
-      JSON.stringify({name: '@acme/widgets', version: '3.0.0-dev'}),
-    );
-    fs.writeFileSync(
-      path.join(tmpDir, 'astryx.integration.mjs'),
-      "export default {codemods: './codemods'};\n",
-    );
-    fs.mkdirSync(path.join(tmpDir, 'codemods', '0.2.0'), {recursive: true});
-    fs.writeFileSync(
-      path.join(tmpDir, 'codemods', '0.2.0', 'local-wip.mjs'),
-      "export default {type: 'code', title: 'Local WIP', transform: file => file.source};\n",
-    );
-
-    const {integrations} = await loadProjectContext(tmpDir);
-    expect(
-      integrations.map(integration => [
-        integration.name,
-        integration.version,
-        Boolean(integration.__local),
-        Boolean(integration.__providerConflict),
-      ]),
-    ).toEqual([['@acme/widgets', '1.0.0', false, false]]);
-    const selected = JSON.stringify(
-      await selectIntegrationCodemodsFor(integrations, '0.1.0', '0.3.0'),
-    );
-    expect(selected).toContain('rename');
-    expect(selected).not.toContain('local-wip');
-  });
-
-  it('runs the installed copy when the authored package is named with --integration', async () => {
-    installWithCodemod('@acme/widgets', '1.0.0');
-    configure([]);
-    fs.writeFileSync(
-      path.join(tmpDir, 'package.json'),
-      JSON.stringify({name: '@acme/widgets', version: '3.0.0-dev'}),
-    );
-    fs.writeFileSync(
-      path.join(tmpDir, 'astryx.integration.mjs'),
-      "export default {codemods: './codemods'};\n",
-    );
-    fs.mkdirSync(path.join(tmpDir, 'codemods', '0.2.0'), {recursive: true});
-    fs.writeFileSync(
-      path.join(tmpDir, 'codemods', '0.2.0', 'local-wip.mjs'),
-      "export default {type: 'code', title: 'Local WIP', transform: file => file.source};\n",
-    );
-    process.chdir(tmpDir);
-
-    const {integrations} = await loadProjectContext(tmpDir, ['@acme/widgets']);
-    expect(
-      integrations.map(integration => [
-        integration.name,
-        integration.version,
-        Boolean(integration.__local),
-        integration.__providerConflict?.claimedBy ?? null,
-      ]),
-    ).toEqual([['@acme/widgets', '1.0.0', false, null]]);
-    const selected = JSON.stringify(
-      await selectIntegrationCodemodsFor(integrations, '0.1.0', '0.3.0'),
-    );
-    expect(selected).toContain('rename');
-    expect(selected).not.toContain('local-wip');
-  });
-
-  it("sets aside an --integration extra that claims an autolinked package's ID", async () => {
-    installWithCodemod('@acme/a', '1.0.0');
-    installWithCodemod('@acme/b', '1.0.0', {providerId: '@acme/a'});
-    configure([]);
-    fs.writeFileSync(
-      path.join(tmpDir, 'package.json'),
-      JSON.stringify({name: 'consumer', dependencies: {'@acme/a': '1.0.0'}}),
-    );
-    process.chdir(tmpDir);
-
-    const {integrations} = await loadProjectContext(tmpDir, ['@acme/b']);
-    expect(
-      integrations.map(integration => [
-        integration.name,
-        integration.__providerConflict?.claimedBy ?? null,
-      ]),
-    ).toEqual([['@acme/b', '@acme/a']]);
-    expect(
-      await selectIntegrationCodemodsFor(integrations, '0.1.0', '0.3.0'),
-    ).toEqual([]);
-  });
-
-  it('runs an autolinked package the user names with --integration', async () => {
-    installWithCodemod('@acme/a', '1.0.0');
-    fs.writeFileSync(
-      path.join(tmpDir, 'package.json'),
-      JSON.stringify({name: 'consumer', dependencies: {'@acme/a': '1.0.0'}}),
-    );
-    process.chdir(tmpDir);
-
-    const {integrations} = await loadProjectContext(tmpDir, ['@acme/a']);
-    expect(
-      integrations.map(integration => [
-        integration.name,
-        integration.__providerConflict?.claimedBy ?? null,
-      ]),
-    ).toEqual([['@acme/a', null]]);
-    const selected = await selectIntegrationCodemodsFor(integrations, '0.1.0', '0.3.0');
-    expect(selected.map(entry => entry.version)).toEqual(['0.2.0']);
-  });
-
-  it('never reports a claimant that every other command uses as set aside', async () => {
-    installWithCodemod('@acme/widgets', '1.0.0');
-    installWithCodemod('@acme/renamed', '2.0.0', {providerId: '@acme/widgets'});
-    configure(['@acme/widgets']);
-    fs.writeFileSync(
-      path.join(tmpDir, 'package.json'),
-      JSON.stringify({
-        name: '@acme/widgets',
-        version: '3.0.0-dev',
-        dependencies: {'@acme/renamed': '2.0.0'},
-      }),
-    );
-    fs.writeFileSync(
-      path.join(tmpDir, 'astryx.integration.mjs'),
-      "export default {providerId: '@acme/widgets-next'};\n",
-    );
-
-    const {integrations} = await loadProjectContext(tmpDir);
-    expect(
-      integrations.map(integration => [
-        integration.name,
-        integration.version,
-        integration.__providerConflict?.claimedBy ?? null,
-      ]),
-    ).toEqual([['@acme/widgets', '1.0.0', null]]);
-  });
-
-  it("sets aside an --integration extra that claims the authored package's ID", async () => {
-    installWithCodemod('@acme/widgets', '1.0.0');
-    configure([]);
-    fs.writeFileSync(
-      path.join(tmpDir, 'package.json'),
-      JSON.stringify({name: '@acme/renamed', version: '2.0.0-dev'}),
-    );
-    fs.writeFileSync(
-      path.join(tmpDir, 'astryx.integration.mjs'),
-      "export default {providerId: '@acme/widgets'};\n",
-    );
-    process.chdir(tmpDir);
-
-    const {integrations} = await loadProjectContext(tmpDir, ['@acme/widgets']);
-    expect(
-      integrations.map(integration => [
-        integration.name,
-        integration.__providerConflict?.claimedBy ?? null,
-      ]),
-    ).toEqual([['@acme/widgets', '@acme/renamed']]);
-    expect(
-      await selectIntegrationCodemodsFor(integrations, '0.1.0', '0.3.0'),
-    ).toEqual([]);
-  });
-});

package/assets/docs/authoring.doc.mjs

@@ -1,14 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file `astryx docs authoring`: every authoring schema, one section each.
- *
- * Built from the self-docs colocated under packages/cli/authoring, so it cannot
- * drift from the schemas it describes. `astryx doctor` names a self-doc this
- * topic cannot reach.
- */
-
-import {buildAuthoringTopic} from '../../foundation/discovery/authoring-self-docs.mjs';
-
-/** @type {import('@astryxdesign/cli/authoring').ReferenceDoc} */
-export const docs = await buildAuthoringTopic();