@really-knows-ai/foundry 3.2.1 → 3.2.3

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

@@ -143,6 +143,44 @@ function runPluginBootstrap(worktree, pkgRoot) {
   }
 }
 
+const defaultSleep = ms => new Promise(resolve => { setTimeout(resolve, ms); });
+
+function resolveOpt(opts, key, fallback) {
+  return (opts && opts[key] !== undefined) ? opts[key] : fallback;
+}
+
+const STARTUP_MSG_MAX_MS = 3000;
+
+async function retryUntilReady(fn, opts) {
+  const sleep = resolveOpt(opts, 'sleep', defaultSleep);
+  const now = resolveOpt(opts, 'now', Date.now);
+  const maxMs = resolveOpt(opts, 'maxMs', STARTUP_MSG_MAX_MS);
+  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) {
@@ -179,7 +217,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();
 
@@ -194,6 +232,8 @@ export const FoundryPlugin = async ({ directory }) => {
       }
 
       restartNeeded = runPluginBootstrap(directory, packageRoot);
+      // Fire-and-forget: don't block startup. messages.transform is the fallback.
+      showStartupMessage(restartNeeded, directory, client);
     },
 
     'experimental.chat.messages.transform': async (_input, output) => {

package/dist/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## [3.2.3] - 2026-05-14
+
+### Fixed
+
+- **Config hook blocked startup waiting for TUI client.** `showStartupMessage`
+  was awaited in the config hook, and its `retryUntilReady` loop could block
+  opencode startup for up to 30 seconds if the TUI client wasn't immediately
+  available. The call is now fire-and-forget: the config hook returns
+  immediately, and the message either shows within the 3-second retry window
+  or falls back to the `messages.transform` hook.
+
+## [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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@really-knows-ai/foundry",
-  "version": "3.2.1",
+  "version": "3.2.3",
   "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",