@really-knows-ai/foundry 3.2.0 → 3.2.2

package/dist/.opencode/plugins/foundry-tools/agent-refresh.js

@@ -29,6 +29,7 @@ function listModels(worktree) {
     cwd: worktree,
     encoding: 'utf8',
     stdio: ['pipe', 'pipe', 'pipe'],
+    env: { ...process.env, FOUNDRY_SKIP_BOOTSTRAP: '1' },
   });
   return stdout
     .split('\n')

package/dist/.opencode/plugins/foundry.js

@@ -131,6 +131,54 @@ function runConfigBootstrap(worktree, pkgRoot) {
   return changed || guideWritten;
 }
 
+function runPluginBootstrap(worktree, pkgRoot) {
+  // Skip if FOUNDRY_SKIP_BOOTSTRAP is set to prevent infinite recursion
+  // when this plugin spawns `opencode models` as a child process.
+  if (process.env.FOUNDRY_SKIP_BOOTSTRAP === '1') return false;
+  try {
+    return runConfigBootstrap(worktree, pkgRoot);
+  } catch (err) {
+    console.error('Foundry bootstrap error:', err.message);
+    return false;
+  }
+}
+
+const defaultSleep = ms => new Promise(resolve => { setTimeout(resolve, ms); });
+
+function resolveOpt(opts, key, fallback) {
+  return (opts && opts[key] !== undefined) ? opts[key] : fallback;
+}
+
+async function retryUntilReady(fn, opts) {
+  const sleep = resolveOpt(opts, 'sleep', defaultSleep);
+  const now = resolveOpt(opts, 'now', Date.now);
+  const maxMs = resolveOpt(opts, 'maxMs', 30000);
+  const deadline = now() + maxMs;
+  while (now() < deadline) {
+    try {
+      await fn();
+      return;
+    } catch {
+      await sleep(500);
+    }
+  }
+}
+
+async function showStartupMessage(needsRestart, directory, client, timerFns) {
+  if (!client) return;
+  if (needsRestart) {
+    await retryUntilReady(() => client.tui.appendPrompt({
+      body: { text: 'Foundry initialised. Restart OpenCode so the Foundry agent registers, then switch to it to author and run workflows.' },
+    }), timerFns);
+    return;
+  }
+  if (existsSync(path.join(directory, 'foundry'))) {
+    await retryUntilReady(() => client.tui.showToast({
+      body: { message: 'Foundry is active', variant: 'info' },
+    }), timerFns);
+  }
+}
+
 export { buildCyclePromptExtras } from './foundry-tools/helpers.js';
 
 function buildTools(createTool, pending) {
@@ -167,7 +215,7 @@ function getFirstUserWithParts(output) {
   return firstUser;
 }
 
-export const FoundryPlugin = async ({ directory }) => {
+export const FoundryPlugin = async ({ directory, client }) => {
   // Pending store is per-plugin-instance (shared across all tool invocations).
   const pending = createPendingStore();
 
@@ -181,12 +229,8 @@ export const FoundryPlugin = async ({ directory }) => {
         config.skills.paths.push(allSkillsDir);
       }
 
-      // Boot decision tree: bootstrap or detect changes, then set restart flag
-      try {
-        restartNeeded = runConfigBootstrap(directory, packageRoot);
-      } catch (err) {
-        console.error('Foundry bootstrap error:', err.message);
-      }
+      restartNeeded = runPluginBootstrap(directory, packageRoot);
+      await showStartupMessage(restartNeeded, directory, client);
     },
 
     'experimental.chat.messages.transform': async (_input, output) => {

package/dist/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [3.2.2] - 2026-05-14
+
+### Added
+
+- **Immediate startup feedback via TUI.** Instead of waiting for the first
+  user prompt to inject the Foundry context message, the config hook now
+  shows feedback immediately. When a restart is needed, the message is
+  appended directly to the prompt bar via `client.tui.appendPrompt`. When
+  Foundry is already active, a non-intrusive toast notification confirms
+  readiness via `client.tui.showToast`. The `messages.transform` hook
+  remains as a fallback for AI context injection.
+- **Injectable timer for startup retry logic.** `retryUntilReady` accepts
+  injectable `sleep`, `now`, and `maxMs` functions so tests can control
+  timing without real delays. `showStartupMessage` bails early when the
+  TUI client is unavailable to avoid hanging in environments without a
+  client.
+
+## [3.2.1] - 2026-05-14
+
+### Fixed
+
+- **Plugin hangs on startup due to infinite recursion.** The config hook's
+  `refreshAgents` call spawns `opencode models` via `execFileSync`. When the
+  project directory has the foundry plugin configured, the child process
+  loads plugins too, triggering another `opencode models` — infinite
+  synchronous recursion that hangs the parent. The plugin now sets
+  `FOUNDRY_SKIP_BOOTSTRAP=1` in the child process environment and skips the
+  bootstrap in the config hook when that variable is set.
+
 ## [3.2.0] - 2026-05-14
 
 Plugin auto-bootstrapping release. Foundry now ensures the guide agent is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@really-knows-ai/foundry",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "A skill-driven framework for governed artefact generation with AI coding tools. Define your own artefact types, laws, and flows — Foundry handles the forge → quench → appraise pipeline with deterministic routing, quality gates, and iterative refinement.",
   "type": "module",
   "main": "dist/.opencode/plugins/foundry.js",