@gaia-ai/gaia 0.6.1 → 0.6.2

package/README.md

@@ -26,6 +26,23 @@ spawn plugins (Claude, Codex, herdr, and a deterministic fake for tests). Point
 it at a control plane with a `conductor.config.js` (scaffold one with
 `gaia init`).
 
+## `gaia ui` deep links
+
+`gaia ui` is the interactive terminal cockpit, and it takes an optional target so you open
+the thing you are working on directly:
+
+```bash
+gaia ui GAIA-221                  # a ticket by identifier (case-insensitive)
+gaia ui project:gaia              # a project; also ticket:<uuid> · run:<uuid>
+gaia ui --here                    # this branch's ticket, else this repo's project
+gaia ui GAIA-221 --view teaser    # a compact block instead of the tabbed detail
+```
+
+At most **one** target source (the positional, `--ticket`, `--project`, `--run`, `--here`);
+two exit non-zero naming both. `--here` reads the current branch for a ticket identifier and
+otherwise resolves this repo's git remote against the projects that claim it — several
+claimants open a picker. `gaia ui --help` lists every form.
+
 ## Plugins
 
 The four spawn plugins ship **inside** this package — nothing extra to install.

package/dist/src/upgrade.d.ts

@@ -1,5 +1,20 @@
 import { type ProjectConnectionChoice } from '@gaia-ai/conductor';
 import type { Command } from 'commander';
+/** Where the running `gaia` resolved from and what it calls itself. */
+export interface GaiaInstallInfo {
+    /** The meta package version (`0.0.0` when the manifest is unreadable). */
+    version: string;
+    /** Absolute path of the package root this module was loaded from. */
+    root: string;
+    /** `global install` when that root sits inside `node_modules`, else `dev clone`. */
+    kind: 'dev clone' | 'global install';
+}
+/**
+ * Identify the running install from THIS module's own URL — walking up to the
+ * nearest `package.json` — rather than from `$PATH` or `process.argv`, so a shim
+ * that execs a checkout's build reports the checkout, not the shim.
+ */
+export declare function resolveInstallInfo(): GaiaInstallInfo;
 /**
  * GAIA-218 (AC-3, AC-4): resolve what to do with the PROJECT connection override.
  * Default no in every branch — only an explicit yes opts in. Non-interactive
@@ -13,9 +28,21 @@ export declare function resolveProjectConnectionChoice(opts: {
     isTTY: boolean;
     prompt: (question: string) => Promise<boolean>;
 }): Promise<ProjectConnectionChoice>;
+/**
+ * GAIA-230 (AC-9): the intro lines printed BEFORE the first migration step, on
+ * `--dry-run` too. `home` is where the schema `from` is read (the home connection
+ * config `~/.gaia/gaia.config.js`, the one every repo inherits); `to` is the
+ * version this gaia ships. Pure — returns the lines rather than printing them.
+ */
+export declare function renderUpgradeIntro(opts: {
+    cwd: string;
+    home: string;
+    install?: GaiaInstallInfo;
+}): string[];
 /** Register `gaia upgrade` on the host program. `deps` is injectable for tests. */
 export declare function registerUpgrade(program: Command, deps?: {
     prompt?: (question: string) => Promise<boolean>;
     isTTY?: boolean;
     cwd?: string;
+    home?: string;
 }): void;

package/dist/src/upgrade.js

@@ -1,11 +1,38 @@
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join, sep } from 'node:path';
 import { createInterface } from 'node:readline';
-import { hasProjectConnection, runUpgrade, } from '@gaia-ai/conductor';
-// GAIA-216: the `gaia upgrade` migration/seed routine was hoisted DOWN into the
-// engine (`@gaia-ai/conductor`) so `conductor init` can call it intra-package
-// without a host→engine→host cycle. The host keeps the thin CLI registration
-// below plus the GAIA-218 TTY interaction that resolves the PROJECT connection
-// decision. See `gaia-cli/conductor/src/cli/upgrade.ts` for `runUpgrade` +
-// `UpgradeReport`.
+import { fileURLToPath } from 'node:url';
+import { GAIA_CONFIG_SCHEMA_VERSION, hasProjectConnection, readConfigSchemaVersion, runUpgrade, } from '@gaia-ai/conductor';
+/**
+ * Identify the running install from THIS module's own URL — walking up to the
+ * nearest `package.json` — rather than from `$PATH` or `process.argv`, so a shim
+ * that execs a checkout's build reports the checkout, not the shim.
+ */
+export function resolveInstallInfo() {
+    let root = dirname(fileURLToPath(import.meta.url));
+    let version = '0.0.0';
+    for (;;) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
+            version = pkg.version ?? '0.0.0';
+            break;
+        }
+        catch {
+            const parent = dirname(root);
+            if (parent === root)
+                break;
+            root = parent;
+        }
+    }
+    return {
+        version,
+        root,
+        kind: root.includes(`${sep}node_modules${sep}`)
+            ? 'global install'
+            : 'dev clone',
+    };
+}
 /** Ask a yes/no question on the terminal; anything but an explicit yes is no. */
 async function promptYesNo(question) {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
@@ -36,22 +63,52 @@ export async function resolveProjectConnectionChoice(opts) {
     const yes = await opts.prompt('create a project connection override for this repo? [y/N] ');
     return yes ? 'create' : 'skip';
 }
+/**
+ * GAIA-230 (AC-9): the intro lines printed BEFORE the first migration step, on
+ * `--dry-run` too. `home` is where the schema `from` is read (the home connection
+ * config `~/.gaia/gaia.config.js`, the one every repo inherits); `to` is the
+ * version this gaia ships. Pure — returns the lines rather than printing them.
+ */
+export function renderUpgradeIntro(opts) {
+    const info = opts.install ?? resolveInstallInfo();
+    const homeConnection = join(opts.home, '.gaia', 'gaia.config.js');
+    const from = readConfigSchemaVersion(homeConnection);
+    return [
+        `gaia upgrade — gaia v${info.version} (${info.kind})`,
+        `  resolved from: ${info.root}`,
+        `  config schema: v${from} → v${GAIA_CONFIG_SCHEMA_VERSION} (${homeConnection})`,
+        `  the .gaia/ configs of ${opts.cwd} and of ${join(opts.home, '.gaia')} get migrated`,
+    ];
+}
 /** Register `gaia upgrade` on the host program. `deps` is injectable for tests. */
 export function registerUpgrade(program, deps = {}) {
     program
         .command('upgrade')
-        .description('migrate this install: the split config model (gaia.config.js connection + conductor.config.js engine; ~/.gaia/machine.config.js) and the GAIA-224 addon package names (@gaia-ai/plugin-*, @gaia-ai/core/builtins and @gaia-ai/core/plugins → @gaia-ai/addon-*). Prompts before creating/removing a project connection override.')
+        .description('migrate this install: the split config model (gaia.config.js connection + conductor.config.js engine; ~/.gaia/machine.config.js) and the GAIA-224 addon package names (@gaia-ai/plugin-*, @gaia-ai/core/builtins and the @gaia-ai/core/plugins + @gaia-ai/gaia/plugins host barrels → @gaia-ai/addon-*). Prompts before creating/removing a project connection override.')
         .option('--dry-run', 'print the migration plan without writing anything', false)
         .action(async (opts) => {
         const cwd = deps.cwd ?? process.cwd();
+        const home = deps.home ?? homedir();
         const isTTY = deps.isTTY ?? Boolean(process.stdin.isTTY);
         const prompt = deps.prompt ?? promptYesNo;
+        // GAIA-230 (AC-9): the intro comes first — before the connection prompt and
+        // before the first migration step, so it is on the record either way.
+        for (const line of renderUpgradeIntro({ cwd, home }))
+            console.log(line);
         const projectConnection = await resolveProjectConnectionChoice({
             existing: hasProjectConnection(cwd),
             isTTY,
             prompt,
         });
-        const report = runUpgrade({ dryRun: opts.dryRun, projectConnection });
+        // `cwd`/`home` are forwarded so an injected pair really scopes the run —
+        // without them `runUpgrade` reached for `process.cwd()`/`homedir()` and
+        // rewrote the developer's own `.gaia/` from a test.
+        const report = runUpgrade({
+            cwd,
+            home,
+            dryRun: opts.dryRun,
+            projectConnection,
+        });
         for (const line of report.actions)
             console.log(line);
         if (report.alreadyCurrent)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaia-ai/gaia",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "GAIA meta package: the `gaia` plugin-host CLI + all runtime plugins. Global install target.",
   "type": "module",
   "license": "MIT",
@@ -38,22 +38,22 @@
     "jsonapi"
   ],
   "dependencies": {
-    "@gaia-ai/addon-auth-basic": "^0.6.1",
-    "@gaia-ai/addon-claude": "^0.6.1",
-    "@gaia-ai/addon-codex": "^0.6.1",
-    "@gaia-ai/addon-deployment": "^0.6.1",
-    "@gaia-ai/addon-dropsh": "^0.6.1",
-    "@gaia-ai/addon-essentials": "^0.6.1",
-    "@gaia-ai/addon-gaia-ui": "^0.6.1",
-    "@gaia-ai/addon-herdr": "^0.6.1",
-    "@gaia-ai/addon-kimi": "^0.6.1",
-    "@gaia-ai/addon-opencode": "^0.6.1",
-    "@gaia-ai/addon-pi": "^0.6.1",
-    "@gaia-ai/addon-remote-drupal": "^0.6.1",
-    "@gaia-ai/addon-workspace-git": "^0.6.1",
-    "@gaia-ai/conductor": "^0.6.1",
-    "@gaia-ai/core": "^0.6.1",
-    "@gaia-ai/ui": "^0.6.1",
+    "@gaia-ai/addon-auth-basic": "^0.6.2",
+    "@gaia-ai/addon-claude": "^0.6.2",
+    "@gaia-ai/addon-codex": "^0.6.2",
+    "@gaia-ai/addon-deployment": "^0.6.2",
+    "@gaia-ai/addon-dropsh": "^0.6.2",
+    "@gaia-ai/addon-essentials": "^0.6.2",
+    "@gaia-ai/addon-gaia-ui": "^0.6.2",
+    "@gaia-ai/addon-herdr": "^0.6.2",
+    "@gaia-ai/addon-kimi": "^0.6.2",
+    "@gaia-ai/addon-opencode": "^0.6.2",
+    "@gaia-ai/addon-pi": "^0.6.2",
+    "@gaia-ai/addon-remote-drupal": "^0.6.2",
+    "@gaia-ai/addon-workspace-git": "^0.6.2",
+    "@gaia-ai/conductor": "^0.6.2",
+    "@gaia-ai/core": "^0.6.2",
+    "@gaia-ai/ui": "^0.6.2",
     "commander": "^12.1.0"
   }
 }