@inneranimalmedia/agentsam-sdk 2.6.8 → 2.6.9

package/packages/theme-fuelnfree-site/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inneranimalmedia/theme-ember",
-  "version": "2.6.7",
-  "description": "Real Fuel & Free Time legacy storefront pages — home, shop, about, and community.",
+  "version": "2.6.9",
+  "description": "Real Fuel & Free Time legacy storefront pages \u2014 home, shop, about, and community.",
   "type": "module",
   "main": "./src/index.js",
   "exports": {
@@ -37,6 +37,5 @@
     "type": "git",
     "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
     "directory": "packages/theme-fuelnfree-site"
-  },
-  "private": true
+  }
 }

package/packages/theme-fuelnfree-site/src/index.js

@@ -8,7 +8,7 @@ const THEME = {
   "version": "0.1.0",
   "kind": "gallery-theme",
   "icon": "theme",
-  "package": "@inneranimalmedia/theme-fuelnfree-site",
+  "package": "@inneranimalmedia/theme-ember",
   "category": "Commerce",
   "industries": [
     "Retail",

package/packages/theme-fuelnfree-site/test/theme.test.mjs

@@ -8,7 +8,7 @@ test('fuelnfree-site theme package exports harvested (not installable) contract'
   assert.equal(theme.installable, false);
   assert.equal(theme.lineage, "fnf");
   assert.equal(theme.family, "editorial-commerce");
-  assert.equal(theme.package, "@inneranimalmedia/theme-fuelnfree-site");
+  assert.equal(theme.package, "@inneranimalmedia/theme-ember");
   assert.ok(Array.isArray(theme.pages));
 });
 

package/packages/theme-handyman-site/README.md

@@ -1,10 +1,10 @@
-# @inneranimalmedia/theme-handyman-site
+# @inneranimalmedia/theme-forge
 
 Installable AgentSam theme: **Primeaux Handyman Services**.
 
 Gallery preview source: `apps/theme-gallery-preview/themes/handyman-site`.
 
 ```js
-import { createTheme } from "@inneranimalmedia/theme-handyman-site";
+import { createTheme } from "@inneranimalmedia/theme-forge";
 const theme = createTheme();
 ```

package/packages/theme-handyman-site/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inneranimalmedia/theme-forge",
-  "version": "2.6.7",
-  "description": "Real Primeaux Handyman PWA build — mobile-first service site with estimates and project proof.",
+  "version": "2.6.9",
+  "description": "Real Primeaux Handyman PWA build \u2014 mobile-first service site with estimates and project proof.",
   "type": "module",
   "main": "./src/index.js",
   "exports": {
@@ -37,6 +37,5 @@
     "type": "git",
     "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
     "directory": "packages/theme-handyman-site"
-  },
-  "private": true
+  }
 }

package/packages/theme-handyman-site/src/index.js

@@ -8,7 +8,7 @@ const THEME = {
   "version": "0.1.0",
   "kind": "gallery-theme",
   "icon": "theme",
-  "package": "@inneranimalmedia/theme-handyman-site",
+  "package": "@inneranimalmedia/theme-forge",
   "category": "Services",
   "industries": [
     "Home Services",

package/packages/theme-handyman-site/test/theme.test.mjs

@@ -8,7 +8,7 @@ test('handyman-site theme package exports harvested (not installable) contract',
   assert.equal(theme.installable, false);
   assert.equal(theme.lineage, "phs");
   assert.equal(theme.family, "trade-services");
-  assert.equal(theme.package, "@inneranimalmedia/theme-handyman-site");
+  assert.equal(theme.package, "@inneranimalmedia/theme-forge");
   assert.ok(Array.isArray(theme.pages));
 });
 

package/packages/theme-insurance-site/README.md

@@ -1,10 +1,10 @@
-# @inneranimalmedia/theme-insurance-site
+# @inneranimalmedia/theme-harbor
 
 Installable AgentSam theme: **Chrystal Clear Insurance**.
 
 Gallery preview source: `apps/theme-gallery-preview/themes/insurance-site`.
 
 ```js
-import { createTheme } from "@inneranimalmedia/theme-insurance-site";
+import { createTheme } from "@inneranimalmedia/theme-harbor";
 const theme = createTheme();
 ```

package/packages/theme-insurance-site/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inneranimalmedia/theme-harbor",
-  "version": "2.6.7",
-  "description": "Real Chrystal Clear Insurance build — editorial insurance storefront with coverage storytelling and quote capture.",
+  "version": "2.6.9",
+  "description": "Real Chrystal Clear Insurance build \u2014 editorial insurance storefront with coverage storytelling and quote capture.",
   "type": "module",
   "main": "./src/index.js",
   "exports": {
@@ -37,6 +37,5 @@
     "type": "git",
     "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
     "directory": "packages/theme-insurance-site"
-  },
-  "private": true
+  }
 }

package/packages/theme-insurance-site/src/index.js

@@ -8,7 +8,7 @@ const THEME = {
   "version": "0.1.0",
   "kind": "gallery-theme",
   "icon": "theme",
-  "package": "@inneranimalmedia/theme-insurance-site",
+  "package": "@inneranimalmedia/theme-harbor",
   "category": "Professional",
   "industries": [
     "Insurance",

package/packages/theme-insurance-site/test/theme.test.mjs

@@ -8,7 +8,7 @@ test('insurance-site theme package exports harvested (not installable) contract'
   assert.equal(theme.installable, false);
   assert.equal(theme.lineage, "cci");
   assert.equal(theme.family, "professional-leadgen");
-  assert.equal(theme.package, "@inneranimalmedia/theme-insurance-site");
+  assert.equal(theme.package, "@inneranimalmedia/theme-harbor");
   assert.ok(Array.isArray(theme.pages));
 });
 

package/packages/theme-scenes/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/theme-scenes",
-  "version": "2.6.7",
+  "version": "2.6.9",
   "description": "Reusable scene / shell / block vocabulary for branded website experiences. BrandPack owns look; theme-scenes owns composition.",
   "type": "module",
   "license": "MIT",

package/packages/theme-shinshu-site/README.md

@@ -1,10 +1,10 @@
-# @inneranimalmedia/theme-shinshu-site
+# @inneranimalmedia/theme-summit
 
 Installable AgentSam theme: **Shinshu Solutions**.
 
 Gallery preview source: `apps/theme-gallery-preview/themes/shinshu-site`.
 
 ```js
-import { createTheme } from "@inneranimalmedia/theme-shinshu-site";
+import { createTheme } from "@inneranimalmedia/theme-summit";
 const theme = createTheme();
 ```

package/packages/theme-shinshu-site/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@inneranimalmedia/theme-summit",
-  "version": "2.6.7",
-  "description": "Real Shinshu Solutions static archive — services, gallery, and CMS-ready pages.",
+  "version": "2.6.9",
+  "description": "Real Shinshu Solutions static archive \u2014 services, gallery, and CMS-ready pages.",
   "type": "module",
   "main": "./src/index.js",
   "exports": {
@@ -37,6 +37,5 @@
     "type": "git",
     "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
     "directory": "packages/theme-shinshu-site"
-  },
-  "private": true
+  }
 }

package/packages/theme-shinshu-site/src/index.js

@@ -8,7 +8,7 @@ const THEME = {
   "version": "0.1.0",
   "kind": "gallery-theme",
   "icon": "theme",
-  "package": "@inneranimalmedia/theme-shinshu-site",
+  "package": "@inneranimalmedia/theme-summit",
   "category": "Professional",
   "industries": [
     "Consulting",

package/packages/theme-shinshu-site/test/theme.test.mjs

@@ -8,7 +8,7 @@ test('shinshu-site theme package exports harvested (not installable) contract',
   assert.equal(theme.installable, false);
   assert.equal(theme.lineage, "shin");
   assert.equal(theme.family, "consulting-portfolio");
-  assert.equal(theme.package, "@inneranimalmedia/theme-shinshu-site");
+  assert.equal(theme.package, "@inneranimalmedia/theme-summit");
   assert.ok(Array.isArray(theme.pages));
 });
 

package/packages/work-graph/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-work-graph",
-  "version": "2.6.7",
+  "version": "2.6.9",
   "description": "Core AgentSam work-graph primitive: one graph model (WorkItem, Dependency, TimelineEvent, Artifact, Evidence, Actor) powering an engineering adapter (git/MCP/tests/deploys) and a business adapter (projects/clients/approvals/milestones), with Gantt/timeline rendering as a pure projection over the graph rather than its own source of truth.",
   "type": "module",
   "main": "./src/index.js",
@@ -25,5 +25,6 @@
   },
   "files": [
     "src"
-  ]
+  ],
+  "license": "MIT"
 }

package/protocol/local-engine/benchmark.v1.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "agentsam.engine.benchmark.v1",
+  "type": "object",
+  "required": ["schema_version", "engine_id", "runs", "summary"],
+  "properties": {
+    "schema_version": { "const": "agentsam.engine.benchmark.v1" },
+    "engine_id": { "type": "string" },
+    "model": { "type": ["string", "null"] },
+    "runs": { "type": "array" },
+    "summary": { "type": "object" },
+    "resource": { "type": "object" }
+  }
+}

package/protocol/local-engine/engine.v1.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "agentsam.local-engine.v1",
+  "type": "object",
+  "required": ["schema_version", "engine_id", "status", "capabilities"],
+  "properties": {
+    "schema_version": { "const": "agentsam.local-engine.v1" },
+    "engine_id": { "type": "string", "minLength": 1 },
+    "version": { "type": ["string", "null"] },
+    "model": { "type": ["string", "null"] },
+    "status": { "enum": ["installed", "available", "unavailable", "unknown", "completed", "unsupported"] },
+    "capabilities": { "type": "object", "additionalProperties": { "type": "boolean" } },
+    "evidence": { "type": "array" },
+    "warnings": { "type": "array", "items": { "type": "string" } }
+  },
+  "additionalProperties": true
+}

package/src/cli/command-catalog.js

@@ -14,6 +14,7 @@ export const CLI_COMMAND_CATALOG = Object.freeze([
   { id: 'dev', summary: 'Run this project’s npm dev script', topic: 'work', skill: 'agentsam-app-fundamentals' },
   { id: 'inspect', summary: 'Bounded repository inspect / authority view', topic: 'work', skill: 'agentsam-app-fundamentals', operation: 'repository.inspect', common: true },
   { id: 'machine', summary: 'Deterministic local machine perception (inspect / asset discovery)', topic: 'work', skill: 'agentsam-app-fundamentals', operation: 'machine.inspect', common: true },
+  { id: 'engine', summary: 'Discover, audit, benchmark, and govern local AI engines', topic: 'runtime', skill: 'agentsam-app-fundamentals', operation: 'engine.audit', common: true },
   { id: 'package', summary: 'Audit, verify, and plan publication of distributable packages', topic: 'work', skill: 'agentsam-progression-guard', operation: 'package.audit', common: true, usage: ['agentsam package audit [--public] [--offline] [--json]', 'agentsam package status <name> [--offline] [--json]', 'agentsam package verify <name> [--offline] [--json]', 'agentsam package publish-plan [--offline] [--json]'] },
   { id: 'capabilities', summary: 'Inspect capability contracts', topic: 'create', skill: 'agentsam-app-fundamentals' },
   {

package/src/cli.js

@@ -36,6 +36,7 @@ import { runPackage } from './commands/package.js';
 import { runRecon } from './commands/recon.js';
 import { runCad } from './commands/cad.js';
 import { runMachine } from './commands/machine.js';
+import { runEngine } from './commands/engine.js';
 import { runSkills } from './commands/skills.js';
 import { runSkill } from './commands/skill.js';
 import { runEval } from './commands/eval.js';
@@ -99,6 +100,7 @@ function printLegacyHelp() {
     agentsam dev               Run this project's existing npm dev script
     agentsam inspect [--json]  Bounded repository index by default; use --view full for authority envelope
     agentsam machine inspect   Native deterministic perception + asset discovery (--json)
+    agentsam engine status|audit|benchmark|assets  Local AI engine + compute tooling
     agentsam brand [scan|…]    Deterministic brand intelligence on repository.snapshot authority
     agentsam plan brand        Composable brand normalization plan (--goap optional)
     agentsam deploy            Graduate an AgentSam project intentionally
@@ -454,6 +456,14 @@ if (command === '--version' || command === '-v') {
 } else if (command === 'inspect') {
   try { await runInspect(rest); }
   catch (e) { reportCliError(e); process.exitCode = 1; }
+} else if (command === 'engine') {
+  try {
+    const code = await runEngine(rest);
+    if (typeof code === 'number' && code !== 0) process.exitCode = code;
+  } catch (e) {
+    reportCliError(e);
+    process.exitCode = e?.exitCode || 1;
+  }
 } else if (command === 'machine') {
   try {
     const code = await runMachine(rest);

package/src/commands/app.js

@@ -365,6 +365,7 @@ export async function runApp(argv = [], options = {}) {
       'agentsam app doctor <id>',
       'agentsam app preview <id>',
       'agentsam app scaffold <id> <dir>',
+      'agentsam app package <id> [--dry-run]',
       '',
     ].join('\n'));
     return;
@@ -424,6 +425,15 @@ export async function runApp(argv = [], options = {}) {
     write('  app_id is stable product identity. Pass --app-id explicitly; no AGENTSAM_DEFAULT_APP.\n\n');
     return { id: app.id, curl, command: npmCmd };
   }
+  if (command === 'package') {
+    const dryRun = rest.includes('--dry-run') || !rest.includes('--write');
+    const packArgs = ['pack', ...(dryRun ? ['--dry-run', '--ignore-scripts'] : []), '--json'];
+    const result = spawnSync('npm', packArgs, { cwd: app.dir, encoding: 'utf8', env: process.env });
+    if (result.status !== 0) throw new Error(String(result.stderr || result.stdout || `npm pack failed for ${app.id}`).trim());
+    const metadata = JSON.parse(result.stdout)[0];
+    write(`${JSON.stringify({ app_id: app.id, package: metadata.name, version: metadata.version, filename: metadata.filename, size: metadata.size, dry_run: dryRun }, null, 2)}\n`);
+    return metadata;
+  }
   if (command === 'doctor' || command === 'preview') {
     runAppBin(app, [command, ...rest], options);
     return;

package/src/commands/engine.js

@@ -0,0 +1,10 @@
+import path from 'node:path';
+import { createLocalEngineRegistry } from '../local-engine/index.js';
+import { auditLocalCompute } from '../local-engine/audit.js';
+import { auditAssets } from '../local-engine/assets.js';
+import { benchmarkEngine } from '../local-engine/benchmark.js';
+
+function parse(argv = []) { const out = { action: argv[0] || 'status', engine: null, model: null, json: argv.includes('--json'), runs: 1, cwd: process.cwd() }; for (let i = 1; i < argv.length; i += 1) { const arg = argv[i]; if (arg === '--model') out.model = argv[++i]; else if (arg === '--runs') out.runs = Number(argv[++i]) || 1; else if (arg === '--cwd') out.cwd = path.resolve(argv[++i] || out.cwd); else if (arg === '--engine') out.engine = argv[++i]; } return out; }
+function emit(value, json) { if (json) console.log(JSON.stringify(value)); else console.log(JSON.stringify(value, null, 2)); }
+function usage() { return `agentsam engine <status|audit|benchmark|assets> [options]\n\n  status                 Discover local engines and models\n  audit                  Read-only Apple hardware + engine inventory\n  benchmark              Measure a selected engine/model\n  assets audit           Audit adopted model references without copying weights\n\n  --engine <id>          ollama | mlx-lm | llama.cpp\n  --model <id>           Engine model identifier\n  --runs <n>             Benchmark repetitions (default 1)\n  --cwd <path>           Project context\n  --json                 Machine-readable output\n`; }
+export async function runEngine(argv = []) { const args = parse(argv); if (args.action === '--help' || args.action === 'help') { console.log(usage()); return 0; } const registry = createLocalEngineRegistry(); if (args.action === 'status') { emit({ schema_version: 'agentsam.local-engine.v1', engines: await registry.discover() }, args.json); return 0; } if (args.action === 'audit') { emit(auditLocalCompute(), args.json); return 0; } if (args.action === 'assets' && argv[1] === 'audit') { emit(auditAssets(), args.json); return 0; } if (args.action === 'benchmark') { if (!args.engine || !args.model) throw new Error('engine benchmark requires --engine <id> and --model <id>'); const result = await benchmarkEngine(registry.get(args.engine), { model: args.model, runs: args.runs }); emit(result, args.json); return 0; } console.log(usage()); return 1; }

package/src/commands/machine.js

@@ -2,7 +2,9 @@
  * agentsam machine — deterministic native Machine lifecycle + perception.
  */
 
+import os from 'node:os';
 import path from 'node:path';
+import pc from 'picocolors';
 import { resolveMachineBinary, spawnMachine } from './machine-binary.js';
 import {
   installManagedMachine,
@@ -12,23 +14,35 @@ import {
 } from './machine-runtime.js';
 
 function usage() {
-  return 'agentsam machine — deterministic local perception (native engine)\n\n' +
-    'Usage:\n' +
-    '  agentsam machine status [--json]\n' +
-    '  agentsam machine doctor [--json]\n' +
-    '  agentsam machine install [--version <semver>] [--force] [--json]\n' +
-    '  agentsam machine update [--force] [--json]\n' +
-    '  agentsam machine inspect <path> [--json] [--run-id <id>] [--include-generated]\n' +
-    '  agentsam machine --help\n\n' +
-    'Runtime authority:\n' +
-    '  AgentSam manages one user-level Machine runtime under ~/.agentsam/runtimes/machine/.\n' +
-    '  Every repository uses that managed runtime first; PATH and SDK source are fallbacks only.\n' +
-    '  Install/update are explicit and never run merely because you entered a repository.\n\n' +
-    'Notes:\n' +
-    '  Default inspect is read-only and network-free.\n' +
-    '  Large detail is externalized under <target>/.agentsam/machine/runs/<run_id>/.\n' +
-    '  Generated/cache trees are summarized unless --include-generated is set.\n' +
-    '  Current registry distribution uses crates.io and therefore requires Cargo for install/update.\n';
+  return [
+    `${pc.bold('agentsam machine')} — deterministic local perception (native engine)`,
+    '',
+    pc.bold('Usage'),
+    `  ${pc.cyan('agentsam machine status')}                         Show the active runtime`,
+    `  ${pc.cyan('agentsam machine doctor')}                         Diagnose runtime resolution`,
+    `  ${pc.cyan('agentsam machine install')} [--version <semver>]   Install the managed runtime`,
+    `  ${pc.cyan('agentsam machine update')}                        Update the managed runtime`,
+    `  ${pc.cyan('agentsam machine inspect <path>')}                Inspect a repository or directory`,
+    '',
+    pc.bold('Options'),
+    `  ${pc.dim('--json')}                  Machine-readable output`,
+    `  ${pc.dim('--force')}                 Replace an existing managed version`,
+    `  ${pc.dim('--run-id <id>')}           Reuse an externalized inspection run`,
+    `  ${pc.dim('--include-generated')}    Include generated and cache trees`,
+    `  ${pc.dim('--help')}                 Show this help`,
+    '',
+    pc.bold('Runtime authority'),
+    '  AgentSam manages one user-level Machine runtime under ~/.agentsam/runtimes/machine/.',
+    '  Resolution order: managed runtime → explicit override → PATH → SDK source.',
+    '  Install and update are explicit; entering a repository never changes the host.',
+    '',
+    pc.bold('Behavior'),
+    '  Inspect is read-only and network-free by default.',
+    '  Large detail is externalized under <target>/.agentsam/machine/runs/<run_id>/.',
+    '  Generated and cache trees are summarized unless --include-generated is set.',
+    '  Install/update use the crates.io distribution and require Cargo.',
+    '',
+  ].join('\n');
 }
 
 function parseArgs(argv = []) {
@@ -86,44 +100,63 @@ function statusPayload() {
   };
 }
 
+function compactPath(value) {
+  const raw = String(value || '—');
+  const home = os.homedir();
+  return home && (raw === home || raw.startsWith(home + path.sep))
+    ? '~' + raw.slice(home.length)
+    : raw;
+}
+
+function stateLabel(installed) {
+  return installed ? pc.green('installed') : pc.yellow('not installed');
+}
+
 function printTextStatus(payload) {
-  console.log('AgentSam Machine');
+  const managed = payload.managed;
+  const effective = payload.effective;
+  console.log(pc.bold('AgentSam Machine'));
+  console.log(pc.dim('Deterministic local perception · native runtime'));
+  console.log('');
+  console.log(pc.bold('Managed runtime'));
+  console.log(`  status       ${stateLabel(managed.installed)}`);
+  console.log(`  version      ${managed.current_version || pc.dim('—')}`);
+  console.log(`  runtime      ${compactPath(managed.runtime_root)}`);
+  console.log(`  binary       ${compactPath(managed.binary)}`);
   console.log('');
-  console.log('  managed      ' + (payload.managed.installed ? 'installed' : 'not installed'));
-  console.log('  version      ' + (payload.managed.current_version || '—'));
-  console.log('  binary       ' + (payload.managed.binary || '—'));
-  console.log('  runtime      ' + payload.managed.runtime_root);
-  console.log('  effective    ' + payload.effective.source);
-  console.log('  effective v  ' + (payload.effective.version || 'unknown'));
-  console.log('  cargo        ' + (payload.managed.cargo.available ? payload.managed.cargo.path : 'not found'));
-  if (!payload.managed.installed) {
+  console.log(pc.bold('Active resolution'));
+  console.log(`  source       ${effective.source || pc.dim('unavailable')}`);
+  console.log(`  version      ${effective.version || pc.dim('unknown')}`);
+  console.log(`  cargo        ${managed.cargo.available ? compactPath(managed.cargo.path) : pc.dim('not found')}`);
+  if (!managed.installed) {
     console.log('');
-    console.log('  Run agentsam machine install to adopt the user-managed runtime.');
+    console.log(`  ${pc.yellow('Next step')}  agentsam machine install`);
   }
 }
 
 function printTextDoctor(payload) {
   printTextStatus(payload);
   console.log('');
+  console.log(pc.bold('Doctor'));
   if (payload.effective.kind === 'missing') {
-    console.log('  ✕ Machine unavailable');
-    console.log('  tried        ' + (payload.effective.tried || []).join(', '));
+    console.log(`  ${pc.red('✕')} Machine unavailable`);
+    console.log(`    tried      ${(payload.effective.tried || []).map(compactPath).join(', ') || pc.dim('none')}`);
   } else if (payload.managed.installed) {
-    console.log('  ✓ managed Machine runtime is available');
+    console.log(`  ${pc.green('✓')} Managed Machine runtime is available`);
   } else {
-    console.log('  ○ Machine works through fallback source: ' + payload.effective.source);
-    console.log('  ○ install the managed runtime to make resolution consistent across repositories');
+    console.log(`  ${pc.yellow('○')} Fallback runtime is active: ${payload.effective.source}`);
+    console.log('    install the managed runtime for consistent resolution across repositories');
   }
 }
 
 function printInstallResult(action, result) {
-  console.log('AgentSam Machine ' + action);
+  console.log(pc.bold(`AgentSam Machine · ${action}`));
   console.log('');
-  console.log('  version      ' + result.version);
-  console.log('  binary       ' + result.binary);
-  console.log('  alias        ' + result.alias);
-  console.log('  source       ' + result.source);
-  console.log('  changed      ' + (result.changed ? 'yes' : 'no'));
+  console.log(`  ${pc.green('✓')} Runtime ${result.changed ? 'installed' : 'already current'}`);
+  console.log(`  version      ${result.version}`);
+  console.log(`  source       ${result.source}`);
+  console.log(`  binary       ${compactPath(result.binary)}`);
+  console.log(`  alias        ${compactPath(result.alias)}`);
 }
 
 export async function runMachine(argv = []) {

package/src/commands/package.js

@@ -3,6 +3,7 @@ import path from 'node:path';
 import { execFile, spawnSync } from 'node:child_process';
 import { promisify } from 'node:util';
 import { fileURLToPath } from 'node:url';
+import { findCliProjectRoot } from '../lib/cli-preferences.js';
 
 const execFileAsync = promisify(execFile);
 const SDK_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
@@ -403,6 +404,10 @@ function parseArgs(argv) {
   return { positional, flags };
 }
 
+export function resolvePackageRoot(cwd = process.cwd()) {
+  return findCliProjectRoot(cwd);
+}
+
 function printHelp() {
   console.log(`agentsam package — audit and graduate distributable packages
 
@@ -474,6 +479,7 @@ export async function runPackage(argv = []) {
   const sub = positional[0];
   const json = flags.has('--json');
   const offline = flags.has('--offline');
+  const root = resolvePackageRoot(process.cwd());
 
   if (!sub || flags.has('--help') || flags.has('-h')) {
     printHelp();
@@ -482,6 +488,7 @@ export async function runPackage(argv = []) {
 
   if (sub === 'audit') {
     const report = await auditPackages({
+      root,
       publicOnly: flags.has('--public'),
       offline,
     });
@@ -495,7 +502,7 @@ export async function runPackage(argv = []) {
     const name = positional[1];
     if (!name) throw new Error('package status requires a package name');
 
-    const pkg = collectPackageManifests().find((item) => item.name === name);
+    const pkg = collectPackageManifests(root).find((item) => item.name === name);
     if (!pkg) throw new Error(`Unknown @inneranimalmedia package: ${name}`);
 
     const status = classifyPackage(pkg, await registryLookup(pkg, offline));
@@ -509,7 +516,7 @@ export async function runPackage(argv = []) {
     const name = positional[1];
     if (!name) throw new Error('package verify requires a package name');
 
-    const report = await verifyPackage(name, { offline });
+    const report = await verifyPackage(name, { root, offline });
 
     if (json) console.log(JSON.stringify(report, null, 2));
     else printVerify(report);
@@ -519,7 +526,7 @@ export async function runPackage(argv = []) {
   }
 
   if (sub === 'publish-plan') {
-    const plan = await buildPublishPlan({ offline });
+    const plan = await buildPublishPlan({ root, offline });
 
     if (json) console.log(JSON.stringify(plan, null, 2));
     else printPlan(plan);

package/src/commands/runtime.js

@@ -101,6 +101,15 @@ async function probeAgentsamd() {
   }
 }
 
+async function waitForAgentsamd({ attempts = 8, delayMs = 250 } = {}) {
+  let last = await probeAgentsamd();
+  for (let attempt = 1; attempt < attempts && !last.ok; attempt += 1) {
+    await new Promise((resolve) => setTimeout(resolve, delayMs));
+    last = await probeAgentsamd();
+  }
+  return last;
+}
+
 async function startAgentsamd(home, write) {
   const bin = agentsamdPath(home);
   if (!fs.existsSync(bin)) throw new Error('agentsamd_not_installed');
@@ -109,8 +118,7 @@ async function startAgentsamd(home, write) {
     try {
       await startWindowsScheduledTask();
       writeLine(write, `  Started Scheduled Task · ${listenAddr()}`);
-      await new Promise((r) => setTimeout(r, 600));
-      return probeAgentsamd();
+      return waitForAgentsamd();
     } catch (err) {
       writeLine(write, `  ○ Scheduled Task start failed (${err.message || err}); falling back to spawn`);
     }
@@ -122,8 +130,7 @@ async function startAgentsamd(home, write) {
       const boot = await bootstrapDarwinLaunchAgent(plist);
       if (boot.ok) {
         writeLine(write, `  Loaded LaunchAgent ${DARWIN_LAUNCH_LABEL}`);
-        await new Promise((r) => setTimeout(r, 400));
-        return probeAgentsamd();
+        return waitForAgentsamd();
       }
     }
   }
@@ -138,8 +145,7 @@ async function startAgentsamd(home, write) {
   ensureRuntimeStateDir(home);
   fs.writeFileSync(pidPath(home), String(child.pid));
   writeLine(write, `  Started agentsamd pid ${child.pid} · ${listenAddr()}`);
-  await new Promise((r) => setTimeout(r, 400));
-  return probeAgentsamd();
+  return waitForAgentsamd();
 }
 
 async function stopAgentsamd(home, write) {
@@ -218,12 +224,21 @@ export async function runRuntime(argv = [], options = {}) {
         writeLine(write, `  Impl       ${probe.body.implementation}`);
       }
       writeLine(write, '');
-      writeLine(write, '  Next');
-      writeLine(write, '    agentsam setup runtime');
-      writeLine(write, '    agentsam runtime install --yes');
+      if (probe.ok) {
+        writeLine(write, sub === 'doctor' ? '  Doctor     ✓ healthy; no repair needed' : '  State      ✓ ready');
+        writeLine(write, '  Next       agentsam terminal --help');
+      } else if (facts.agentsamd.installed) {
+        writeLine(write, '  Repair');
+        writeLine(write, '    agentsam runtime start');
+        writeLine(write, '    agentsam runtime install --yes   # rebuild only if start still fails');
+      } else {
+        writeLine(write, '  Next');
+        writeLine(write, '    agentsam setup runtime');
+        writeLine(write, '    agentsam runtime install --yes');
+      }
       writeLine(write, '');
     }
-    return probe.ok || facts.agentsamd.installed ? 0 : (sub === 'doctor' ? 2 : 0);
+    return sub === 'doctor' ? (probe.ok ? 0 : 2) : 0;
   }
 
   if (sub === 'probe') {