impulso 0.19.1

package/harnesses/opencode/sync-commands.js

@@ -0,0 +1,98 @@
+// Regenerate commands/<name>.md from skills/<name>/SKILL.md.
+//
+// Each command body = full SKILL.md content inlined verbatim, so the model
+// receives the actual workflow as its prompt when the user types `/<name>`
+// — not a meta-instruction to "go load the skill". Pattern lifted from
+// waybarrios/opencode-power-pack.
+//
+// Output format per command file:
+//   ---
+//   description: <single-line description flattened from SKILL.md frontmatter>
+//   ---
+//
+//   <full SKILL.md body, frontmatter stripped>
+//
+//   ---
+//
+//   **User arguments:** $ARGUMENTS
+//
+// Run: npm run sync:commands
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseFrontmatter } from './frontmatter.js';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(here, '..', '..');
+const skillsDir = path.join(repoRoot, 'skills');
+const commandsDir = path.join(repoRoot, 'commands');
+
+function escapeYamlDoubleQuoted(s) {
+  return s.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, ' ');
+}
+
+function formatCommand({ description, body }) {
+  const trimmedBody = body.replace(/^\s+/, '').replace(/\s+$/, '');
+  return (
+    `---\n` +
+    `description: "${escapeYamlDoubleQuoted(description)}"\n` +
+    `---\n\n` +
+    `${trimmedBody}\n\n` +
+    `---\n\n` +
+    `**User arguments:** $ARGUMENTS\n`
+  );
+}
+
+function main() {
+  if (!fs.existsSync(skillsDir)) {
+    console.error(`skills dir not found: ${skillsDir}`);
+    process.exit(1);
+  }
+
+  const skillDirs = fs
+    .readdirSync(skillsDir, { withFileTypes: true })
+    .filter((e) => e.isDirectory())
+    .map((e) => e.name)
+    .sort();
+
+  fs.mkdirSync(commandsDir, { recursive: true });
+
+  const synced = [];
+  for (const name of skillDirs) {
+    const skillPath = path.join(skillsDir, name, 'SKILL.md');
+    if (!fs.existsSync(skillPath)) {
+      console.warn(`! skills/${name}/ has no SKILL.md — skipping`);
+      continue;
+    }
+    try {
+      const content = fs.readFileSync(skillPath, 'utf8');
+      const parsed = parseFrontmatter(content);
+      if (parsed.name !== name) {
+        console.warn(
+          `! skills/${name}/SKILL.md has name "${parsed.name}" — dir name wins for command filename`,
+        );
+      }
+      const out = formatCommand(parsed);
+      const cmdPath = path.join(commandsDir, `${name}.md`);
+      fs.writeFileSync(cmdPath, out);
+      synced.push(`${name}.md`);
+    } catch (err) {
+      console.error(`! failed to sync skills/${name}: ${err.message} — skipping`);
+    }
+  }
+
+  const cmds = fs.readdirSync(commandsDir).filter((f) => f.endsWith('.md') && f !== '.gitkeep');
+  const skillSet = new Set(skillDirs);
+  const orphans = cmds.filter((f) => !skillSet.has(f.replace(/\.md$/, '')));
+  for (const orphan of orphans) {
+    console.warn(`! commands/${orphan} has no matching skill (orphan)`);
+  }
+
+  console.log(`synced ${synced.length} command(s):` + synced.map((s) => `\n  - ${s}`).join(''));
+  if (orphans.length > 0) {
+    console.log(`flagged ${orphans.length} orphan command(s)`);
+  }
+}
+
+main();

package/harnesses/opencode/uninstall.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Impulso opencode uninstall — removes the isolated profile created by
+# install.sh. Global gitignore entries (.tokensave/, .rtk/) are left in
+# place — they are protective and harmless; remove manually if unwanted.
+
+PROFILE_DIR="${HOME}/.config/impulso-profile/opencode"
+
+echo "==> Impulso uninstall (opencode)"
+echo "    Profile: ${PROFILE_DIR}"
+
+if [[ -d "${PROFILE_DIR}" ]]; then
+  rm -rf "${PROFILE_DIR}"
+  echo "    Removed isolated profile dir"
+else
+  echo "    Nothing to do — profile dir does not exist."
+fi
+
+rmdir "${HOME}/.config/impulso-profile" 2>/dev/null || true
+
+# impulso-hub binary: remove if it exists.
+GATE_DST="${HOME}/.local/bin/impulso-hub"
+if [[ -f "${GATE_DST}" || -L "${GATE_DST}" ]]; then
+  rm -f "${GATE_DST}"
+  echo "    Removed impulso-hub binary"
+fi
+
+# Remove old impulso-gate binary if present (renamed to impulso-hub)
+OLD_GATE="${HOME}/.local/bin/impulso-gate"
+if [[ -f "${OLD_GATE}" || -L "${OLD_GATE}" ]]; then
+  rm -f "${OLD_GATE}"
+  echo "    Removed old impulso-gate binary"
+fi
+
+echo "==> Done. Global gitignore entries (.tokensave/, .rtk/) left in place."

package/opencode/opencode.jsonc

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "small_model": "opencode/big-pickle",
+  "model": "proxycli/deepseek-v4-flash",
+  "instructions": ["AGENTS.md"],
+  "plugin": ["../harnesses/opencode/plugin.js", "../harnesses/opencode/rtk/rtk.ts"],
+  "mcp": {
+    "tokensave": {
+      "type": "local",
+      "command": ["tokensave", "serve"],
+      "enabled": true,
+    },
+  },
+  "experimental": { "disable_paste_summary": true },
+  "provider": {
+    "proxycli": {
+      "npm": "@ai-sdk/openai-compatible",
+      "name": "Proxy CLI",
+      "options": {
+        "baseURL": "{env:CLI_PROXY_URL}",
+        "apiKey": "{env:CLI_PROXY_API_KEY}",
+      },
+      "models": {
+        "deepseek-v4-flash": { "name": "DeepSeek V4 Flash" },
+        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
+        "glm-5.2": { "name": "GLM-5.2" },
+        "glm-5.2-fast": { "name": "GLM-5.2-fast" },
+        "glm-5.2-flex": { "name": "GLM-5.2-flex" },
+        "kimi-k2.7-code": { "name": "Kimi K2.7 Code" },
+        "claude-opus-4-6-thinking": { "name": "Claude OPUS" },
+        "nvidia/nemotron-3-super-120b-a12b": { "name": "Nemotron 3 Super 120B" },
+      },
+    },
+  },
+}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "impulso",
+  "version": "0.19.1",
+  "description": "Impulso — plugin bundle for opencode and Claude Code: Plannotator skills + Impulso-DirectSpeech (rethemed ex-Caveman) + RTK. Harness-neutral repo; per-harness glue under harnesses/.",
+  "type": "module",
+  "main": "harnesses/opencode/plugin.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install-hub.js",
+    "install:opencode": "harnesses/opencode/install.sh",
+    "install:claude": "harnesses/claude/install.sh",
+    "uninstall:opencode": "harnesses/opencode/uninstall.sh",
+    "uninstall:claude": "harnesses/claude/uninstall.sh",
+    "doctor": "./doctor.sh",
+    "sync:commands": "node harnesses/opencode/sync-commands.js && prettier --write commands/",
+    "sync:agents": "node scripts/sync-agents.cjs",
+    "check:canaries": "node scripts/check-canaries.cjs",
+    "check:hooks": "node scripts/check-hooks-parity.cjs",
+    "test": "node shared/tests.cjs && node harnesses/claude/tests.cjs && node harnesses/opencode/tests.js && node scripts/impulso-bench.test.cjs && cd gate && go test ./...",
+    "coverage": "c8 --check-coverage --lines 90 --functions 92 --branches 68 --reporter=text --reporter=text-summary npm test",
+    "lint": "eslint shared/ harnesses/",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "bench": "node scripts/impulso-bench.cjs",
+    "release": "semantic-release",
+    "update:opencode": "./update.sh opencode",
+    "update:claude": "./update.sh claude",
+    "prepare": "husky || true"
+  },
+  "files": [
+    "agents",
+    "commands",
+    "harnesses/claude/hooks",
+    "harnesses/claude/install.sh",
+    "harnesses/claude/merge-settings.cjs",
+    "harnesses/claude/uninstall.sh",
+    "harnesses/opencode/bin",
+    "harnesses/opencode/commands-loader.js",
+    "harnesses/opencode/compose.js",
+    "harnesses/opencode/directspeech",
+    "harnesses/opencode/frontmatter.js",
+    "harnesses/opencode/install.sh",
+    "harnesses/opencode/orchestration",
+    "harnesses/opencode/plugin.js",
+    "harnesses/opencode/rtk",
+    "harnesses/opencode/session-name",
+    "harnesses/opencode/sync-commands.js",
+    "harnesses/opencode/uninstall.sh",
+    "opencode",
+    "scripts/bump-plugin-version.cjs",
+    "scripts/install-hub.js",
+    "scripts/sync-agents.cjs",
+    "shared/directspeech-config.cjs",
+    "shared/orchestration-config.cjs",
+    "shared/orchestration-data.json",
+    "shared/state-guard.cjs",
+    "shared/tokensave-freshness.cjs",
+    "skills",
+    "package.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.17.14"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/exec": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "c8": "^12.0.0",
+    "eslint": "^9.39.4",
+    "globals": "^17.7.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.2.0",
+    "prettier": "^3.9.4",
+    "semantic-release": "^24.2.9"
+  },
+  "keywords": [
+    "opencode",
+    "claude-code",
+    "plannotator",
+    "impulso",
+    "directspeech",
+    "rtk",
+    "plugin"
+  ],
+  "license": "MIT",
+  "lint-staged": {
+    "*.{js,cjs,jsx,ts,tsx,json,jsonc,md,yml,yaml,css,html}": "prettier --write",
+    "shared/**/*.{js,cjs}": "eslint --fix",
+    "harnesses/**/*.{js,cjs}": "eslint --fix",
+    "skills/*/SKILL.md": "npm run sync:commands && git add commands/"
+  }
+}

package/scripts/bump-plugin-version.cjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+// bump-plugin-version — sets .claude-plugin/plugin.json's version field.
+//
+// Invoked by semantic-release's @semantic-release/exec prepareCmd with the
+// computed next version, keeping plugin.json in lockstep with package.json
+// (the pair's parity is asserted by shared/tests.cjs, not enforced here).
+//
+// Usage: bump-plugin-version.cjs <version> [pluginJsonPath]
+// pluginJsonPath defaults to <repo>/.claude-plugin/plugin.json; the second
+// arg exists so tests can point it at a tmp fixture.
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const version = process.argv[2];
+const pluginPath = process.argv[3] || path.join(__dirname, '..', '.claude-plugin', 'plugin.json');
+
+if (!version) {
+  console.error('Usage: bump-plugin-version.cjs <version> [pluginJsonPath]');
+  process.exit(1);
+}
+
+const plugin = JSON.parse(fs.readFileSync(pluginPath, 'utf8'));
+plugin.version = version;
+fs.writeFileSync(pluginPath, JSON.stringify(plugin, null, 2) + '\n');
+console.log(`Bumped ${pluginPath} to ${version}`);

package/scripts/install-hub.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+import { chmod, copyFile, mkdir, mkdtemp, readFile, rename, rm, stat } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+
+const execFileAsync = promisify(execFile);
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+
+export function platformTarget(platform = process.platform, arch = process.arch) {
+  const platforms = { linux: 'linux', darwin: 'darwin' };
+  const architectures = { x64: 'amd64', arm64: 'arm64' };
+  const osName = platforms[platform];
+  const architecture = architectures[arch];
+  if (!osName || !architecture) {
+    throw new Error(`Unsupported impulso-hub platform: ${platform}/${arch}`);
+  }
+  return `${osName}-${architecture}`;
+}
+
+export function bundledBinaryPath(packageRoot = PACKAGE_ROOT, target = platformTarget()) {
+  return path.join(packageRoot, 'harnesses', 'opencode', 'bin', target, 'impulso-hub');
+}
+
+async function installedVersion(destination) {
+  try {
+    await stat(destination);
+    const result = await execFileAsync(destination, ['version'], { timeout: 5000 });
+    return result.stdout.trim();
+  } catch (_error) {
+    return null;
+  }
+}
+
+export async function installHub({
+  packageRoot = PACKAGE_ROOT,
+  destination = path.join(os.homedir(), '.local', 'bin', 'impulso-hub'),
+  version,
+  platform = process.platform,
+  arch = process.arch,
+} = {}) {
+  const packageJson = JSON.parse(await readFile(path.join(packageRoot, 'package.json'), 'utf8'));
+  const packageVersion = version || packageJson.version;
+  const target = platformTarget(platform, arch);
+  const source = bundledBinaryPath(packageRoot, target);
+  await stat(source);
+
+  if ((await installedVersion(destination)) === packageVersion) {
+    return { target, updated: false, destination, version: packageVersion };
+  }
+
+  await mkdir(path.dirname(destination), { recursive: true });
+  const tempDir = await mkdtemp(path.join(path.dirname(destination), '.impulso-hub-'));
+  const temporary = path.join(tempDir, 'impulso-hub');
+  try {
+    await copyFile(source, temporary);
+    await chmod(temporary, 0o755);
+    await rename(temporary, destination);
+  } finally {
+    await rm(tempDir, { recursive: true, force: true });
+  }
+  return { target, updated: true, destination, version: packageVersion };
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  try {
+    const result = await installHub();
+    const action = result.updated ? 'Installed' : 'Already installed';
+    console.log(
+      `    ${action} impulso-hub ${result.version} (${result.target}) -> ${result.destination}`,
+    );
+  } catch (error) {
+    console.error(`ERROR: ${error.message}`);
+    process.exitCode = 1;
+  }
+}

package/scripts/sync-agents.cjs

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+// impulso sync:agents — validate agents/ roster against orchestration-config.cjs
+//
+// Validation pass (no derived copies needed — Claude Code auto-discovers agents/,
+// opencode reads bodies at runtime via Task 7's orchestration module). This
+// script is the CI entry point for ensuring agents/ and ROSTER stay in sync.
+//
+// Checks:
+//   - ROSTER → file parity: every ROSTER entry has agents/<name>.md
+//   - file → ROSTER parity: every agents/*.md has a matching ROSTER entry
+//   - frontmatter: name = filename, permission-class ∈ PERMISSION_CLASSES,
+//     model: mirrors DEFAULT_MODELS exactly (orchestrator: forbidden — stays
+//     unpinned), description non-empty,
+//     effort: (optional; Claude Code static per-agent effort) ∈ EFFORT_LEVELS
+//
+// Optional argv[2]: root dir (defaults to repo root). Used by tests so they can
+// point the script at a tmp tree without touching the real repo.
+//
+// Exit 0 = all checks pass. Exit 1 = violations (listed on stderr).
+//
+// Location justification: scripts/ (not harnesses/) because this is a
+// harness-neutral validation pass. sync-commands.js lives under
+// harnesses/opencode/ because it generates opencode-specific derived files.
+// sync-agents generates nothing — it only validates the canonical source.
+
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const { ROSTER, PERMISSION_CLASSES, EFFORT_LEVELS, DEFAULT_MODELS } = require(
+  path.join(__dirname, '..', 'shared', 'orchestration-config.cjs'),
+);
+
+// ---------------------------------------------------------------------------
+// parseFrontmatter
+// Returns object of key/value pairs, or null on parse failure.
+// ---------------------------------------------------------------------------
+function parseFrontmatter(content) {
+  const lines = content.split('\n');
+  if (lines[0].trim() !== '---') return null;
+  const end = lines.indexOf('---', 1);
+  if (end === -1) return null;
+  const fm = {};
+  for (let i = 1; i < end; i++) {
+    const m = lines[i].match(/^([^:]+):\s*(.*)$/);
+    if (m) fm[m[1].trim()] = m[2].trim();
+  }
+  return fm;
+}
+
+// ---------------------------------------------------------------------------
+// validateAgents
+// Exported so tests can call it directly if needed (avoids logic duplication).
+// @param {string} rootDir — repo root; agents/ is at rootDir/agents/
+// @returns {string[]} violation messages (empty = all OK)
+// ---------------------------------------------------------------------------
+function validateAgents(rootDir) {
+  const agentsDir = path.join(rootDir, 'agents');
+  const violations = [];
+
+  if (!fs.existsSync(agentsDir)) {
+    violations.push(`agents/ directory not found at ${agentsDir}`);
+    return violations;
+  }
+
+  // Roster → file parity
+  for (const name of Object.keys(ROSTER)) {
+    const agentPath = path.join(agentsDir, `${name}.md`);
+    if (!fs.existsSync(agentPath)) {
+      violations.push(`agents/${name}.md missing (ROSTER entry has no file)`);
+    }
+  }
+
+  // File → roster parity + frontmatter validation
+  const files = fs.readdirSync(agentsDir).filter((f) => f.endsWith('.md'));
+  for (const file of files) {
+    const name = file.replace(/\.md$/, '');
+
+    if (ROSTER[name] === undefined) {
+      violations.push(`agents/${file}: orphan file — no matching ROSTER entry`);
+      continue; // skip frontmatter check for orphans
+    }
+
+    const content = fs.readFileSync(path.join(agentsDir, file), 'utf8');
+    const fm = parseFrontmatter(content);
+
+    if (fm === null) {
+      violations.push(`agents/${file}: missing or malformed frontmatter delimiters`);
+      continue;
+    }
+
+    if (fm.name !== name) {
+      violations.push(
+        `agents/${file}: frontmatter name "${fm.name}" does not match filename "${name}"`,
+      );
+    }
+
+    if (!fm['permission-class']) {
+      violations.push(`agents/${file}: missing permission-class in frontmatter`);
+    } else if (PERMISSION_CLASSES[fm['permission-class']] === undefined) {
+      violations.push(
+        `agents/${file}: unknown permission-class "${fm['permission-class']}" — must be one of: ${Object.keys(PERMISSION_CLASSES).join(', ')}`,
+      );
+    }
+
+    // model: frontmatter is the Claude Code fallback for direct invocations
+    // (no dispatch param → frontmatter → inherit session). It must exactly
+    // mirror DEFAULT_MODELS so the shipped default can't drift from the
+    // config; ladder overrides still win via the dispatch-time param.
+    // ImpulsoOrchestrator stays model-less (unpinned; inherits the session).
+    if (name === 'ImpulsoOrchestrator') {
+      if (Object.prototype.hasOwnProperty.call(fm, 'model')) {
+        violations.push(
+          `agents/${file}: orchestrator must not carry a model: key (stays unpinned)`,
+        );
+      }
+    } else {
+      const expected = DEFAULT_MODELS.claude[name];
+      if (!Object.prototype.hasOwnProperty.call(fm, 'model')) {
+        violations.push(
+          `agents/${file}: missing model: key in frontmatter (must be "${expected}" — direct invocations fall back to frontmatter, not the ladder)`,
+        );
+      } else if (fm.model !== expected) {
+        violations.push(
+          `agents/${file}: model "${fm.model}" drifts from DEFAULT_MODELS ("${expected}") — update shared/orchestration-config.cjs and the frontmatter together`,
+        );
+      }
+    }
+
+    // effort: is allowed (Claude Code's only per-subagent effort mechanism —
+    // no dispatch-time parameter exists) but must be a known level.
+    if (Object.prototype.hasOwnProperty.call(fm, 'effort') && !EFFORT_LEVELS.includes(fm.effort)) {
+      violations.push(
+        `agents/${file}: invalid effort "${fm.effort}" — must be one of: ${EFFORT_LEVELS.join(', ')}`,
+      );
+    }
+
+    if (!fm.description || fm.description.trim() === '') {
+      violations.push(`agents/${file}: missing or empty description in frontmatter`);
+    }
+  }
+
+  return violations;
+}
+
+module.exports = { validateAgents, parseFrontmatter };
+
+// ---------------------------------------------------------------------------
+// CLI entry point
+// ---------------------------------------------------------------------------
+if (require.main === module) {
+  const rootDir = process.argv[2] ? path.resolve(process.argv[2]) : path.resolve(__dirname, '..');
+  const violations = validateAgents(rootDir);
+
+  if (violations.length === 0) {
+    const n = Object.keys(ROSTER).length;
+    console.log(`sync:agents — ${n} ROSTER entries OK, all frontmatter valid`);
+    process.exit(0);
+  } else {
+    process.stderr.write(`sync:agents — ${violations.length} violation(s):\n`);
+    for (const v of violations) {
+      process.stderr.write(`  ${v}\n`);
+    }
+    process.exit(1);
+  }
+}

package/shared/directspeech-config.cjs

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+// impulso-directspeech — shared reinforcement line
+//
+// DirectSpeech is always on: no modes, no toggles, no flag files. Both
+// harnesses inject this line every turn (Claude Code: UserPromptSubmit hook;
+// opencode: experimental.chat.system.transform). The full ruleset lives in
+// shared/AGENTS.md; this is the per-turn reminder that survives long
+// conversations and compaction.
+
+function reinforcementLine() {
+  return (
+    'IMPULSO DIRECT SPEECH MODE ACTIVE. ' +
+    'Terse, technical, no filler. Fragments OK. ' +
+    'Code/commits/security: write normal.'
+  );
+}
+
+module.exports = { reinforcementLine };