@really-knows-ai/foundry 3.2.5 → 3.2.7

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

@@ -6,6 +6,7 @@ import path from 'path';
 import { execFileSync } from 'child_process';
 import { mkdirSync, readdirSync, readFileSync, writeFileSync, unlinkSync, existsSync } from 'fs';
 import { createHash } from 'crypto';
+import { resolveOpenCode } from '../../../scripts/lib/tool-paths.js';
 
 const AGENT_FRONTMATTER_TEMPLATE = `---
 description: "Foundry stage agent using MODEL_ID"
@@ -25,7 +26,7 @@ function buildAgentContent(modelId) {
 }
 
 function listModels(worktree) {
-  const stdout = execFileSync('opencode', ['models'], {
+  const stdout = execFileSync(resolveOpenCode(), ['models'], {
     cwd: worktree,
     encoding: 'utf8',
     stdio: ['pipe', 'pipe', 'pipe'],

package/dist/.opencode/plugins/foundry-tools/helpers.js

@@ -92,9 +92,11 @@ export function listFlows(foundryDir) {
 
 function buildFoundryNotInitializedMessage() {
   return `<FOUNDRY_CONTEXT>
-Foundry is installed but not initialised in this project. There is no foundry/ directory.
-
-To set up Foundry, initialise the project first. Initialisation creates the foundry/ directory structure, installs the user-facing Foundry agent, and generates model-routing stage agents. After initialisation, restart OpenCode and switch to the Foundry agent.
+Foundry is installed but not yet initialised in this project — there is no foundry/ directory.
+The plugin will bootstrap the directory structure, generate stage agents, and install the
+Foundry guide agent automatically on the next startup. The user may just need to restart
+OpenCode for this to happen. Once initialised, direct the user to restart again so the new
+agents register, then switch to the Foundry agent.
 </FOUNDRY_CONTEXT>`;
 }
 
@@ -110,8 +112,9 @@ function buildFlowList(flows) {
 
 function buildFoundryInitializedMessage(flowList, packageRoot) {
   return `<FOUNDRY_CONTEXT>
-Foundry is active in this project. The foundry/ directory contains the project's artefact definitions,
-laws, appraisers, cycles, and flows.
+Foundry is active in this project. The foundry/ directory contains the project's artefact
+definitions, laws, appraisers, cycles, and flows. The user should switch to the Foundry agent
+to author and run workflows.
 
 Foundry is a skill-driven framework for governed artefact generation and evaluation.
 The pipeline: assay (populate memory) → forge (produce) → quench (deterministic checks) → appraise (subjective evaluation) → human-appraise (human review) → iterate.
@@ -142,7 +145,10 @@ Scripts are located at: ${path.join(packageRoot, 'scripts')}
 export function getBootstrapContent(directory, packageRoot, restartNeeded = false) {
   if (restartNeeded) {
     return `<FOUNDRY_CONTEXT>
-Foundry initialised. Restart OpenCode so the Foundry agent and model-routing agents register. After restart, switch to the Foundry agent to author and run workflows.
+Foundry has just been initialised in this project. The directory structure, stage agent files,
+and Foundry guide agent have all been created. Tell the user to restart OpenCode now so the new
+agents register. After restarting, the user should switch to the Foundry agent to author and
+run workflows.
 </FOUNDRY_CONTEXT>`;
   }
 

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

@@ -13,6 +13,7 @@
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { execFileSync } from 'child_process';
 import { tool } from '@opencode-ai/plugin';
 import { createPendingStore } from '../../scripts/lib/pending.js';
 import { getBootstrapContent } from './foundry-tools/helpers.js';
@@ -35,6 +36,7 @@ import { createMemoryAdminTools } from './foundry-tools/memory-admin-tools.js';
 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';
+import { resolveGit } from '../../scripts/lib/tool-paths.js';
 
 function findPackageRoot(startDir) {
   let dir = startDir;
@@ -81,7 +83,7 @@ function bootstrapGitignore(worktree) {
   }
   content = ensureNewlineSuffix(content);
   const existingLines = content.split('\n').map(l => l.trim());
-  const lines = ['.snapshots/', 'node_modules/', '.DS_Store'];
+  const lines = ['.snapshots/', '.foundry/', 'node_modules/', '.DS_Store'];
   for (const line of lines) {
     if (existingLines.includes(line)) continue;
     content += `${line}\n`;
@@ -89,6 +91,18 @@ function bootstrapGitignore(worktree) {
   writeFileSync(gitignorePath, content, 'utf8');
 }
 
+function initGitRepo(worktree) {
+  if (existsSync(path.join(worktree, '.git'))) return;
+  try {
+    const git = resolveGit();
+    execFileSync(git, ['init'], { cwd: worktree, stdio: 'pipe' });
+    execFileSync(git, ['add', '.'], { cwd: worktree, stdio: 'pipe' });
+    execFileSync(git, ['commit', '-m', 'chore: initialise Foundry'], { cwd: worktree, stdio: 'pipe' });
+  } catch (err) {
+    console.error('Foundry git init error:', err.message);
+  }
+}
+
 function runBootstrapSequence(worktree, pkgRoot) {
   bootstrapDirectories(worktree);
   bootstrapGitignore(worktree);
@@ -96,6 +110,7 @@ function runBootstrapSequence(worktree, pkgRoot) {
   writeFoundryGuideAgent(worktree, pkgRoot);
   const pkg = JSON.parse(readFileSync(path.join(pkgRoot, 'package.json'), 'utf8'));
   writeFileSync(path.join(worktree, 'foundry', 'VERSION'), pkg.version, 'utf8');
+  initGitRepo(worktree);
 }
 
 function checkVersionMatch(foundryDir, pkgRoot) {

package/dist/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## [3.2.7] - 2026-05-14
+
+### Added
+
+- **Git repo initialisation during bootstrap.** If the worktree has no
+  `.git` directory, Foundry now runs `git init`, `git add .`, and
+  `git commit` after creating the initial directory structure. Projects
+  start with a clean initial commit of the generated configuration.
+- **Tool path resolution from PATH.** A new `tool-paths.js` module
+  resolves `git` and `opencode` from `PATH` on each call instead of
+  executing bare command names. Overridable via `FOUNDRY_GIT_PATH` and
+  `FOUNDRY_OPENCODE_PATH` environment variables. Removed
+  `sonarjs/no-os-command-from-path` lint overrides for `foundry.js`
+  and `agent-refresh.js`.
+
+### Changed
+
+- **`.foundry/` added to default `.gitignore`.** The runtime state
+  directory was previously created but not ignored by default.
+
+## [3.2.6] - 2026-05-14
+
+### Fixed
+
+- **Bootstrap context messages confused the AI.** The injected `FOUNDRY_CONTEXT`
+  messages were written as direct user instructions ("Restart OpenCode..."),
+  but the AI reads them as system context and interprets them as commands to
+  itself. Rewritten as AI-facing framing: "Tell the user to restart...",
+  "The user should switch to the Foundry agent...".
+
 ## [3.2.5] - 2026-05-14
 
 ### Changed

package/dist/scripts/lib/tool-paths.js

@@ -0,0 +1,21 @@
+import { existsSync } from 'fs';
+import path from 'path';
+
+function resolveFromPath(name) {
+  const dirs = (process.env.PATH || '').split(path.delimiter);
+  for (const dir of dirs) {
+    const candidate = path.join(dir, name);
+    if (existsSync(candidate)) return candidate;
+  }
+  return name;
+}
+
+function resolveGit() {
+  return process.env.FOUNDRY_GIT_PATH || resolveFromPath('git');
+}
+
+function resolveOpenCode() {
+  return process.env.FOUNDRY_OPENCODE_PATH || resolveFromPath('opencode');
+}
+
+export { resolveGit, resolveOpenCode };

package/package.json

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