@really-knows-ai/foundry 3.2.3 → 3.2.5

package/README.md

@@ -103,9 +103,18 @@ Add the plugin to `opencode.json`:
 }
 ```
 
-Restart OpenCode so the plugin registers its tools and skills. You will see new
-tools and skills become available in OpenCode's command palette once the restart
-completes. Flow-management tools are now ready to use.
+Restart OpenCode so the plugin registers. On startup, Foundry bootstraps the
+directory structure, generates stage agents, and installs the Foundry guide
+agent automatically.
+
+After restart, type **hello foundry**. The assistant will tell you whether a
+further restart is needed and when to switch to the Foundry agent.
+
+Optionally, to make the package available to your project's local `node_modules`:
+
+```sh
+pnpm add -D @really-knows-ai/foundry
+```
 
 ---
 
@@ -121,29 +130,17 @@ The upgrade process asks clarifying questions for ambiguous routing, input contr
 
 ### Phase 1 — Install
 
-Add the plugin to `opencode.json` (see Install section above):
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["@really-knows-ai/foundry"]
-}
-```
-
-Then restart OpenCode so the plugin registers its tools and skills. You will see new
-tools and skills become available in OpenCode's command palette once the restart
-completes. Flow-management tools are now ready to use.
+Add the plugin to `opencode.json` (see Install section above), then restart
+OpenCode.
 
-### Phase 2 — Initialise
+Type **hello foundry**. The assistant will guide you through any remaining
+setup. If Foundry was just initialised, it will ask you to restart and switch
+to the **Foundry** agent. If Foundry is already set up, it will tell you to
+switch to the Foundry agent directly.
 
-Restart OpenCode after adding the plugin. On boot, the plugin's config hook runs
-a decision tree: if `foundry/` is missing or its VERSION does not match the
-installed plugin version, it bootstraps the directory structure, generates
-`foundry-<model>` stage agent files, installs the user-facing `Foundry` guide
-agent, and tells you to restart again.
+### Phase 2 — Switch to the Foundry agent
 
-Restart OpenCode a second time so the new agents register. After the restart,
-switch to the **Foundry** agent. The Foundry agent is the normal interface for
+Switch to the **Foundry** agent. The Foundry agent is the normal interface for
 authoring and running Foundry workflows.
 
 ### Phase 3 — Ask the Foundry agent for a flow

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

@@ -36,8 +36,18 @@ import { createSnapshotTools } from './foundry-tools/snapshot-tools.js';
 import { createAttestationTools } from './foundry-tools/attestation-tools.js';
 import { createRefreshAgentsTool } from './foundry-tools/refresh-agents-tool.js';
 
+function findPackageRoot(startDir) {
+  let dir = startDir;
+  const root = path.parse(dir).root;
+  while (dir !== root) {
+    if (existsSync(path.join(dir, 'package.json'))) return dir;
+    dir = path.dirname(dir);
+  }
+  return startDir;
+}
+
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const packageRoot = path.resolve(__dirname, '../..');
+const packageRoot = findPackageRoot(__dirname);
 const allSkillsDir = path.join(packageRoot, 'skills');
 
 // Module-level flag shared between config and message-transform hooks.
@@ -143,44 +153,6 @@ 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) {
@@ -217,7 +189,7 @@ function getFirstUserWithParts(output) {
   return firstUser;
 }
 
-export const FoundryPlugin = async ({ directory, client }) => {
+export const FoundryPlugin = async ({ directory }) => {
   // Pending store is per-plugin-instance (shared across all tool invocations).
   const pending = createPendingStore();
 
@@ -232,8 +204,6 @@ export const FoundryPlugin = async ({ directory, client }) => {
       }
 
       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,32 @@
 # Changelog
 
+## [3.2.5] - 2026-05-14
+
+### Changed
+
+- **Startup flow simplified to "hello foundry".** Removed the TUI client
+  retry approach for startup messages. Users now type **hello foundry**
+  after restarting; the AI reads the injected `FOUNDRY_CONTEXT` and responds
+  with restart instructions or readiness confirmation. This replaces the
+  silent double-restart dance.
+- **E2E tests no longer depend on Python or `dd`.** The SIGTERM trap test
+  now uses shell builtins (`trap`/`echo`/`while`). The output cap tests use
+  small Node.js scripts instead of `dd` piped to `tr`. Tests are faster and
+  have no external dependencies.
+- **Install docs updated** (`README.md`, `docs/getting-started.md`) to
+  reflect the "hello foundry" flow.
+
+## [3.2.4] - 2026-05-14
+
+### Fixed
+
+- **Bootstrap error in cached npm installs.** The `packageRoot` was resolved
+  from `__dirname` using a hardcoded relative path (`../..`) that only worked
+  in the source tree. In the dist tree (`dist/.opencode/plugins/`), the same
+  path resolved to `dist/` instead of the package root, causing
+  `ENOENT: package.json` errors. The resolution now walks up from `__dirname`
+  until it finds `package.json`.
+
 ## [3.2.3] - 2026-05-14
 
 ### Fixed

package/dist/README.md

@@ -103,9 +103,18 @@ Add the plugin to `opencode.json`:
 }
 ```
 
-Restart OpenCode so the plugin registers its tools and skills. You will see new
-tools and skills become available in OpenCode's command palette once the restart
-completes. Flow-management tools are now ready to use.
+Restart OpenCode so the plugin registers. On startup, Foundry bootstraps the
+directory structure, generates stage agents, and installs the Foundry guide
+agent automatically.
+
+After restart, type **hello foundry**. The assistant will tell you whether a
+further restart is needed and when to switch to the Foundry agent.
+
+Optionally, to make the package available to your project's local `node_modules`:
+
+```sh
+pnpm add -D @really-knows-ai/foundry
+```
 
 ---
 
@@ -121,29 +130,17 @@ The upgrade process asks clarifying questions for ambiguous routing, input contr
 
 ### Phase 1 — Install
 
-Add the plugin to `opencode.json` (see Install section above):
-
-```json
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["@really-knows-ai/foundry"]
-}
-```
-
-Then restart OpenCode so the plugin registers its tools and skills. You will see new
-tools and skills become available in OpenCode's command palette once the restart
-completes. Flow-management tools are now ready to use.
+Add the plugin to `opencode.json` (see Install section above), then restart
+OpenCode.
 
-### Phase 2 — Initialise
+Type **hello foundry**. The assistant will guide you through any remaining
+setup. If Foundry was just initialised, it will ask you to restart and switch
+to the **Foundry** agent. If Foundry is already set up, it will tell you to
+switch to the Foundry agent directly.
 
-Restart OpenCode after adding the plugin. On boot, the plugin's config hook runs
-a decision tree: if `foundry/` is missing or its VERSION does not match the
-installed plugin version, it bootstraps the directory structure, generates
-`foundry-<model>` stage agent files, installs the user-facing `Foundry` guide
-agent, and tells you to restart again.
+### Phase 2 — Switch to the Foundry agent
 
-Restart OpenCode a second time so the new agents register. After the restart,
-switch to the **Foundry** agent. The Foundry agent is the normal interface for
+Switch to the **Foundry** agent. The Foundry agent is the normal interface for
 authoring and running Foundry workflows.
 
 ### Phase 3 — Ask the Foundry agent for a flow

package/dist/docs/getting-started.md

@@ -21,7 +21,12 @@ Add Foundry to `opencode.json`:
 }
 ```
 
-OpenCode resolves the package itself — `npm install` is **not** required. Restart OpenCode (or reload plugins) so the plugin registers its tools and skills.
+Restart OpenCode so the plugin registers. On startup, Foundry bootstraps the
+directory structure, generates stage agents, and installs the Foundry guide
+agent automatically.
+
+After restart, type **hello foundry**. The assistant will tell you whether a
+further restart is needed and when to switch to the Foundry agent.
 
 Optionally, if you want the package available to your project's local node_modules (for editor tooling or scripts), run:
 
@@ -31,11 +36,20 @@ pnpm add -D @really-knows-ai/foundry
 
 ## Initialise
 
-Restart OpenCode after adding the plugin. On boot, the plugin's config hook checks project state: if `foundry/` is missing or its VERSION does not match the installed plugin version, it bootstraps the directory structure, generates model-routing `foundry-*` stage agents, installs the user-facing `Foundry` guide agent, and prompts a second restart.
+After restarting OpenCode with the plugin, type **hello foundry**. The
+assistant will read the Foundry bootstrap context and respond with guidance:
+
+- If Foundry was just initialised: it will tell you to restart again and switch
+  to the Foundry agent.
+- If Foundry is already set up: it will tell you to switch to the Foundry agent
+  directly.
 
-Restart OpenCode again so the new agents register. Then switch to the **Foundry** agent before authoring flows. The Foundry agent understands Foundry's authoring workflow and handles dependent setup such as artefact types, laws, validators, appraisers, cycles, and config branches.
+switch to the **Foundry** agent before authoring flows. The Foundry agent
+understands Foundry's authoring workflow and handles dependent setup such as
+artefact types, laws, validators, appraisers, cycles, and config branches.
 
-The `.foundry/` runtime directory (holding `.secret` for stage tokens) is created automatically on first plugin boot and added to `.gitignore`.
+The `.foundry/` runtime directory (holding `.secret` for stage tokens) is
+created automatically on first plugin boot and added to `.gitignore`.
 
 ---
 

package/package.json

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