@aiwg/cli 2026.7.19 → 2026.7.21

package/dist/src/storage/subsystem-cli.js

@@ -20,6 +20,7 @@
  */
 import { getLoadedConfig, resolveStorage } from './index.js';
 import { resolveSubsystemRootRuntime } from './config.js';
+import { projectAiwgPath, resolveProjectAiwgDir } from '../config/project-artifacts.js';
 export async function runSubsystemCli(subsystem, args, opts = {}) {
     const subcommand = args[0];
     const subArgs = args.slice(1);
@@ -177,6 +178,9 @@ async function readStdin() {
     return Buffer.concat(chunks).toString('utf-8');
 }
 function printUsage(subsystem, display) {
+    const projectRoot = process.cwd();
+    const subsystemPath = projectAiwgPath(projectRoot, subsystem);
+    const configPath = projectAiwgPath(projectRoot, 'storage.config');
     console.log(`Usage: aiwg ${display} <subcommand>
 
 Subcommands:
@@ -195,7 +199,8 @@ Examples:
   echo "# page" | aiwg ${display} put some/page.md
   echo '{"event":"x"}' | aiwg ${display} append-log some/log.jsonl
 
-The ${display} subsystem persists at .aiwg/${subsystem}/ on the default fs backend.
-Configure .aiwg/storage.config to redirect (#934).`);
+The ${display} subsystem persists at ${subsystemPath} on the default fs backend
+(artifact root: ${resolveProjectAiwgDir(projectRoot)}).
+Configure ${configPath} to redirect (#934).`);
 }
 //# sourceMappingURL=subsystem-cli.js.map

package/dist/src/update/notifier.mjs

@@ -218,7 +218,7 @@ export function maybePrintNotice() {
   const cache = readCache();
   if (!cache?.hasUpdate || !cache.current || !cache.latest) return;
   // One-line, non-intrusive. Users who want to update run `aiwg update`.
-  const msg = `aiwg: update available ${cache.current} → ${cache.latest} (run: npm install -g aiwg)`;
+  const msg = `aiwg: update available ${cache.current} → ${cache.latest} (run: aiwg update)`;
   process.stderr.write(`\n${msg}\n`);
 }
 

package/dist/src/update/service.mjs

@@ -0,0 +1,123 @@
+/**
+ * Install-aware AIWG update service.
+ *
+ * This is the single package-update primitive shared by `aiwg update` and
+ * `aiwg refresh`. It deliberately keeps provider/framework redeployment in
+ * the calling handlers.
+ */
+
+import { execFileSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { getPackageRoot, loadConfig } from '../channel/manager.mjs';
+
+const VALID_MODES = new Set(['npm', 'web', 'source']);
+
+function readPackageName(packageRoot) {
+  try {
+    return JSON.parse(readFileSync(path.join(packageRoot, 'package.json'), 'utf8')).name;
+  } catch {
+    return null;
+  }
+}
+
+export async function detectInstallMode(options = {}) {
+  const packageRoot = options.packageRoot ?? getPackageRoot();
+  const override = options.env?.AIWG_INSTALL_MODE ?? process.env.AIWG_INSTALL_MODE;
+  if (override) {
+    if (!VALID_MODES.has(override)) {
+      throw new Error(`AIWG_INSTALL_MODE must be one of: ${[...VALID_MODES].join(', ')}`);
+    }
+    return { mode: override, packageRoot, packageName: readPackageName(packageRoot) };
+  }
+
+  const config = options.config ?? await loadConfig();
+  const packageName = readPackageName(packageRoot);
+  if (packageName === '@aiwg/cli') return { mode: 'web', packageRoot, packageName };
+  if (config.devMode || config.channel === 'edge' || existsSync(path.join(packageRoot, '.git'))) {
+    return { mode: 'source', packageRoot, packageName };
+  }
+  return { mode: 'npm', packageRoot, packageName };
+}
+
+function npmTag(channel) {
+  if (channel === 'next') return 'next';
+  if (channel === 'nightly') return 'nightly';
+  return 'latest';
+}
+
+/**
+ * Update the active distribution.
+ *
+ * `web` means the lightweight CLI's signed resource distribution. Its
+ * resources resolve the selected signed channel on demand; it must not replace
+ * itself with the full global npm package. `source` is intentionally manual.
+ */
+export async function updateInstallation(options = {}) {
+  const config = options.config ?? await loadConfig();
+  const detected = await detectInstallMode({ ...options, config });
+  const channel = options.channel ?? config.channel ?? 'stable';
+  const dryRun = options.dryRun === true;
+  const offline = options.offline === true;
+
+  if (detected.mode === 'web') {
+    if (offline) {
+      return {
+        ...detected,
+        channel,
+        status: 'unsupported-offline',
+        changed: false,
+        message: 'Web-backed AIWG cannot refresh signed resources while offline; verified cached resources remain available.',
+      };
+    }
+    if (dryRun) {
+      return {
+        ...detected,
+        channel,
+        status: 'dry-run',
+        changed: false,
+        message: `Would refresh the verified signed '${channel}' web resource release; no global package install would be attempted.`,
+      };
+    }
+    const refreshWebResources = options.refreshWebResources ?? (async (selector) => {
+      const { resolveWebRelease } = await import('../resources/web-release.js');
+      return resolveWebRelease({ selector });
+    });
+    const release = await refreshWebResources(channel);
+    return {
+      ...detected,
+      channel,
+      version: release.version,
+      status: 'updated',
+      changed: true,
+      message: `Refreshed the verified signed '${channel}' web resource release${release.version ? ` (${release.version})` : ''}; no global package install was attempted.`,
+    };
+  }
+
+  if (detected.mode === 'source') {
+    return {
+      ...detected,
+      channel,
+      status: 'manual',
+      changed: false,
+      message: `Source checkout detected at ${detected.packageRoot}. Update it with 'git pull --ff-only', then run 'npm ci && npm run build'; AIWG will not overwrite it with npm.`,
+    };
+  }
+
+  const tag = npmTag(channel);
+  const command = ['install', '--global', `aiwg@${tag}`];
+  if (!dryRun) {
+    const execute = options.execute ?? ((file, args) => execFileSync(file, args, { stdio: 'inherit' }));
+    execute('npm', command);
+  }
+  return {
+    ...detected,
+    channel,
+    status: dryRun ? 'dry-run' : 'updated',
+    changed: !dryRun,
+    command: `npm ${command.join(' ')}`,
+    message: dryRun
+      ? `Would update the full AIWG npm distribution on the '${tag}' channel.`
+      : `Updated the full AIWG npm distribution on the '${tag}' channel.`,
+  };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiwg/cli",
-  "version": "2026.7.19",
+  "version": "2026.7.21",
   "description": "Lightweight AIWG CLI for signed, versioned web-backed resources.",
   "type": "module",
   "license": "MIT",
@@ -56,7 +56,7 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@fortemi/core": "2026.7.11",
+    "@fortemi/core": "2026.7.14",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "chalk": "^4.1.2",
     "chokidar": "^3.6.0",
@@ -66,6 +66,7 @@
     "js-yaml": "^4.1.0",
     "listr2": "^8.2.5",
     "ora": "^5.4.1",
+    "semver": "^7.8.5",
     "yaml": "^2.8.1",
     "zod": "^3.25.0"
   },