@astryxdesign/cli 0.1.2-canary.e85eff3 → 0.1.2-canary.eeff948

package/README.md

@@ -62,6 +62,7 @@ Options:
 | `upgrade`     | Run codemods to migrate between versions                                                             |
 | `theme build` | Compile a defineTheme file to production CSS and JS                                                  |
 | `discover`    | Discover external packages and components                                                            |
+| `gap-report`  | Report a gap when a component doesn't meet your needs                                                |
 | `doctor`      | Diagnose your XDS setup and report problems with fixes (CI-friendly via exit code)                   |
 
 ### Global options
@@ -160,6 +161,7 @@ if (isError(result)) {
 | `ERR_INVALID_VERSION`    | A `--from`/`--to` value was not a valid semver string.                                 |
 | `ERR_DEP_MISSING`        | A required external dependency (e.g. jscodeshift) is missing.                          |
 | `ERR_GH_CLI`             | GitHub CLI (`gh`) is not installed or not authenticated.                               |
+| `ERR_GAP_REPORT_FAILED`  | Filing a gap report failed (disabled, or the integration errored).                     |
 
 ## Capability manifest (agent discovery)
 
@@ -356,6 +358,8 @@ Every response has a `type` string that uniquely identifies it:
 | `xds --json theme build <file>`                | `theme.build`               | `ThemeBuildResponse`              |
 | `xds --json upgrade --list`                    | `upgrade.list`              | `UpgradeListResponse`             |
 | `xds --json upgrade [--apply]`                 | `upgrade.run`               | `UpgradeRunResponse`              |
+| `xds --json gap-report --list-categories`      | `gap-report.categories`     | `GapReportCategoriesResponse`     |
+| `xds --json gap-report --component X ...`      | `gap-report.file`           | `GapReportFileResponse`           |
 | `xds --json doctor`                            | `doctor`                    | `DoctorResponse`                  |
 | any error                                      | —                           | `CLIError`                        |
 | unsupported command                            | —                           | `CLIUnsupportedError`             |
@@ -430,6 +434,8 @@ export default {
   templates: {
     get: async id => fetchTemplateFromAPI(id),
   },
-  issuesUrl: 'https://github.com/your-org/your-repo/issues',
+  gapReport: {
+    url: 'https://your-api.com/gaps',
+  },
 };
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/cli",
-  "version": "0.1.2-canary.e85eff3",
+  "version": "0.1.2-canary.eeff948",
   "displayName": "CLI",
   "description": "Scaffold projects, browse templates, generate themes, and get agent-ready docs from the command line.",
   "author": "Meta Open Source",
@@ -75,9 +75,9 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@astryxdesign/core": "0.1.2-canary.e85eff3",
-    "@astryxdesign/lab": "0.1.2-canary.e85eff3",
-    "@astryxdesign/theme-neutral": "0.1.2-canary.e85eff3",
+    "@astryxdesign/core": "0.1.2-canary.eeff948",
+    "@astryxdesign/lab": "0.1.2-canary.eeff948",
+    "@astryxdesign/theme-neutral": "0.1.2-canary.eeff948",
     "gpt-tokenizer": "^2.0.0"
   },
   "peerDependenciesMeta": {
@@ -92,9 +92,9 @@
     }
   },
   "devDependencies": {
-    "@astryxdesign/core": "0.1.2-canary.e85eff3",
-    "@astryxdesign/lab": "0.1.2-canary.e85eff3",
-    "@astryxdesign/theme-neutral": "0.1.2-canary.e85eff3",
+    "@astryxdesign/core": "0.1.2-canary.eeff948",
+    "@astryxdesign/lab": "0.1.2-canary.eeff948",
+    "@astryxdesign/theme-neutral": "0.1.2-canary.eeff948",
     "gpt-tokenizer": "^2.0.0"
   },
   "scripts": {

package/src/commands/agent-docs.mjs

@@ -207,7 +207,7 @@ export function generateCompressedIndex(version, {coreDir, runPrefix = getRunPre
       .sort();
     if (topics.length > 0) lines.push(`  docs <topic>       ${topics.join(', ')}`);
   }
-  lines.push('  swizzle <Name>     eject component source for deep customization');
+  lines.push('  swizzle <Name>     eject component source (--gap reports why)');
   lines.push('  upgrade --apply    run after any @astryxdesign/core bump');
   lines.push(MARKER_END);