@astrale-os/cli 1.0.0-beta.16 → 1.0.0-beta.17

package/dist/astrale.js

@@ -2578,7 +2578,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@astrale-os/cli",
-    version: "1.0.0-beta.16",
+    version: "1.0.0-beta.17",
     description: "Astrale CLI — connect to existing Astrale kernels",
     keywords: [
       "astrale",
@@ -84408,7 +84408,7 @@ var init_add = __esm(() => {
     ],
     afterHelpText: `
 Installed source belongs to the application. Ordinary add never overwrites local edits.
-Use diff first, then --overwrite --yes when replacement is intentional.
+Run astrale ui doctor before intentionally replacing local source with --overwrite --yes.
 `,
     action: async (items, options) => runUiCommand(options, async () => {
       let selected2 = items;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrale-os/cli",
-  "version": "1.0.0-beta.16",
+  "version": "1.0.0-beta.17",
   "description": "Astrale CLI — connect to existing Astrale kernels",
   "keywords": [
     "astrale",

package/src/commands/ui/add.ts

@@ -25,7 +25,7 @@ export default {
     UI_JSON_OPTION,
   ],
   afterHelpText:
-    '\nInstalled source belongs to the application. Ordinary add never overwrites local edits.\nUse diff first, then --overwrite --yes when replacement is intentional.\n',
+    '\nInstalled source belongs to the application. Ordinary add never overwrites local edits.\nRun astrale ui doctor before intentionally replacing local source with --overwrite --yes.\n',
   action: async (items: string[], options: Options) =>
     runUiCommand(options, async () => {
       let selected = items

package/src/program/__tests__/program.test.ts

@@ -312,6 +312,24 @@ describe('help contract — connect-only command surface', () => {
 })
 
 describe('help contract — UI is project tooling', () => {
+  test('add recovery guidance uses only registered UI commands', async () => {
+    const program = await buildProgram()
+    const uiAdd = program.commands
+      .find((command) => command.name() === 'ui')
+      ?.commands.find((command) => command.name() === 'add')
+    let help = ''
+    uiAdd?.configureOutput({
+      writeOut: (chunk) => {
+        help += chunk ?? ''
+      },
+    })
+    uiAdd?.outputHelp()
+
+    expect(help).toContain('astrale ui doctor')
+    expect(help).toContain('--overwrite --yes')
+    expect(help).not.toMatch(/\b(?:astrale ui )?diff\b/u)
+  })
+
   test('keeps the documented root version alias operational', async () => {
     const program = await buildProgram()
     let stdout = ''