impulso 0.19.1

package/harnesses/claude/uninstall.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Impulso claude uninstall — reverses install.sh. Targeted removals only:
+# strips impulso hooks from settings.json, removes the ruleset file and its
+# CLAUDE.md import line, removes only repo-owned symlinks, deregisters the
+# tokensave MCP. Foreign content is never touched. Never rm -rf's ~/.claude.
+#
+# Default profile dir: ~/.config/impulso-profile/claude
+# Override with: IMPULSO_CLAUDE_PROFILE=/some/dir ./uninstall.sh
+
+REPO="$(cd "$(dirname "$0")/../.." && pwd)"
+DEFAULT_PROFILE="${HOME}/.config/impulso-profile/claude"
+PROFILE_DIR="${IMPULSO_CLAUDE_PROFILE:-${DEFAULT_PROFILE}}"
+
+echo "==> Impulso uninstall (claude)"
+echo "    Profile: ${PROFILE_DIR}"
+
+if [[ ! -d "${PROFILE_DIR}" ]]; then
+  echo "    Nothing to do — profile dir does not exist."
+  exit 0
+fi
+
+# Deregister tokensave MCP (user scope in this profile).
+if command -v claude >/dev/null 2>&1 \
+  && CLAUDE_CONFIG_DIR="${PROFILE_DIR}" claude mcp get tokensave >/dev/null 2>&1; then
+  CLAUDE_CONFIG_DIR="${PROFILE_DIR}" claude mcp remove --scope user tokensave >/dev/null 2>&1 || true
+  echo "    Deregistered tokensave MCP"
+fi
+
+# Strip impulso hooks from settings.json (foreign hooks/keys survive).
+if [[ -f "${PROFILE_DIR}/settings.json" ]]; then
+  node "${REPO}/harnesses/claude/merge-settings.cjs" --remove "${PROFILE_DIR}/settings.json"
+  echo "    Removed impulso hooks from settings.json"
+fi
+
+# Ruleset + CLAUDE.md import line.
+rm -f "${PROFILE_DIR}/IMPULSO-AGENTS.md" "${PROFILE_DIR}/AGENTS.md"
+if [[ -f "${PROFILE_DIR}/CLAUDE.md" ]]; then
+  grep -vF '@IMPULSO-AGENTS.md' "${PROFILE_DIR}/CLAUDE.md" | grep -vFx '@AGENTS.md' > "${PROFILE_DIR}/CLAUDE.md.tmp" || true
+  if [[ -s "${PROFILE_DIR}/CLAUDE.md.tmp" ]] && grep -q '[^[:space:]]' "${PROFILE_DIR}/CLAUDE.md.tmp"; then
+    mv "${PROFILE_DIR}/CLAUDE.md.tmp" "${PROFILE_DIR}/CLAUDE.md"
+    echo "    Removed import line from CLAUDE.md"
+  else
+    rm -f "${PROFILE_DIR}/CLAUDE.md.tmp" "${PROFILE_DIR}/CLAUDE.md"
+    echo "    Removed CLAUDE.md (contained only the impulso import)"
+  fi
+fi
+
+# skills/, commands/, and agents/: remove only symlinks pointing into this repo.
+for sub in skills commands agents; do
+  p="${PROFILE_DIR}/${sub}"
+  if [[ -L "$p" && "$(readlink "$p")" == "${REPO}/"* ]]; then
+    rm "$p"
+    echo "    Removed ${sub} symlink"
+  elif [[ -d "$p" ]]; then
+    for entry in "$p"/*; do
+      [[ -L "$entry" && "$(readlink "$entry")" == "${REPO}/"* ]] && rm "$entry"
+    done
+    echo "    Removed repo-owned entries from ${sub}/"
+  fi
+done
+
+# impulso-hub binary: remove if it exists.
+GATE_DST="${HOME}/.local/bin/impulso-hub"
+if [[ -f "${GATE_DST}" ]]; then
+  rm -f "${GATE_DST}"
+  echo "    Removed impulso-hub binary"
+
+# 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
+fi
+# Also clean up stale symlink from old CJS installer
+if [[ -L "${GATE_DST}" ]]; then
+  rm -f "${GATE_DST}"
+  echo "    Removed stale impulso-hub symlink"
+fi
+
+# Only the default isolated profile dir is removed wholesale — and never
+# ~/.claude, even if someone points IMPULSO_CLAUDE_PROFILE at it.
+if [[ "${PROFILE_DIR}" == "${DEFAULT_PROFILE}" && "${PROFILE_DIR}" != "${HOME}/.claude" ]]; then
+  rm -rf "${PROFILE_DIR}"
+  echo "    Removed isolated profile dir"
+fi
+
+echo "==> Done."

package/harnesses/opencode/commands-loader.js

@@ -0,0 +1,101 @@
+// impulso — runtime commands loader
+//
+// Reads bundled commands/*.md files at plugin load time and registers each
+// as a config.command[name] inline template. This avoids requiring users to
+// symlink command files manually.
+//
+// Each command .md file has frontmatter (--- delimiters) with at minimum a
+// description: field, followed by the body. The existing trailer
+//   ---
+//   **User arguments:** $ARGUMENTS
+// is stripped from the body and re-appended, matching the format produced by
+// sync-commands.js.
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * Parse a command .md file. Command frontmatter only has a description: field;
+ * the command name is derived from the filename (minus .md extension).
+ * @returns {{ description: string, body: string } | null}
+ */
+function parseCommandFile(content) {
+  const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/.exec(content);
+  if (!m) return null;
+
+  const raw = m[1];
+  const body = m[2];
+
+  const lines = raw.split(/\r?\n/);
+  let description = null;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const descMatch = /^description:\s*(.*)$/.exec(line);
+    if (descMatch) {
+      const rest = descMatch[1].trim();
+      if (rest === '>' || rest === '|' || rest === '') {
+        const parts = [];
+        for (let j = i + 1; j < lines.length; j++) {
+          if (/^\s/.test(lines[j])) {
+            parts.push(lines[j].trim());
+          } else if (lines[j] === '') {
+            continue;
+          } else {
+            break;
+          }
+        }
+        description = parts.filter(Boolean).join(' ');
+      } else {
+        // Strip quotes if prettier added them
+        description = rest.replace(/^['"]|['"]$/g, '');
+      }
+      break;
+    }
+  }
+
+  if (!description) return null;
+  return { description, body };
+}
+
+/**
+ * Read commands/*.md from the given directory and register each as an
+ * inline config.command entry.
+ * @param {object} config — the opencode Config object (mutated in place)
+ * @param {string} commandsDir — absolute path to the commands/ directory
+ */
+export function registerCommands(config, commandsDir) {
+  let files;
+  try {
+    files = fs.readdirSync(commandsDir).filter((f) => f.endsWith('.md'));
+  } catch (e) {
+    return;
+  }
+
+  config.command = config.command || {};
+
+  for (const filename of files) {
+    const name = filename.replace(/\.md$/, '');
+    if (config.command[name]) continue;
+
+    try {
+      const raw = fs.readFileSync(path.join(commandsDir, filename), 'utf8');
+      const parsed = parseCommandFile(raw);
+      if (!parsed) {
+        console.warn(`[impulso] failed to parse command ${filename}: missing description`);
+        continue;
+      }
+
+      const { description, body } = parsed;
+      const cleanedBody = body
+        .replace(/^---\r?\n\*\*User arguments:\*\* \$ARGUMENTS\s*$/m, '')
+        .replace(/\s+$/, '');
+
+      const template = cleanedBody + '\n\n---\n\n**User arguments:** $ARGUMENTS';
+
+      config.command[name] = { template, description };
+    } catch (e) {
+      console.warn(`[impulso] failed to register command ${filename}:`, e.message);
+    }
+  }
+}

package/harnesses/opencode/compose.js

@@ -0,0 +1,111 @@
+// impulso — plugin hook composer
+//
+// Merges an array of Hooks objects into one. For hook keys that accept
+// (input, output) — e.g. chat.message, experimental.chat.system.transform,
+// command.execute.before, tool.definition, experimental.chat.messages.transform —
+// each sub-plugin's handler is called in sequence with the same input/output pair.
+//
+// For `event`, handlers are called sequentially with the event.
+// For `config`, handlers are called sequentially mutating config in place.
+// For `tool`, definitions are shallow-merged (last-write-wins per name).
+
+/**
+ * Hook keys that receive (input, output) pairs. Names match
+ * @opencode-ai/plugin Hooks interface.
+ */
+const OUTPUT_HOOKS = [
+  'chat.message',
+  'chat.params',
+  'chat.headers',
+  'experimental.chat.messages.transform',
+  'experimental.chat.system.transform',
+  'experimental.session.compacting',
+  'experimental.compaction.autocontinue',
+  'experimental.text.complete',
+  'experimental.provider.small_model',
+  'tool.definition',
+  'tool.execute.before',
+  'tool.execute.after',
+  'command.execute.before',
+  'shell.env',
+  'permission.ask',
+];
+
+/**
+ * Hook keys that receive a single config object.
+ */
+const CONFIG_HOOKS = ['config'];
+
+/**
+ * Hook keys that receive a single input object.
+ */
+const INPUT_HOOKS = ['event'];
+
+/**
+ * Hook keys whose values are objects (merged via shallow assign rather than
+ * called in sequence).
+ */
+const MERGE_HOOKS = ['tool'];
+
+/**
+ * @param {Array<import('@opencode-ai/plugin').Hooks>} hooksList
+ * @returns {import('@opencode-ai/plugin').Hooks}
+ */
+export function composeHooks(hooksList) {
+  const merged = {};
+
+  // Collect handlers per strategy
+  const outputMap = {};
+  const inputList = [];
+  const configList = [];
+  const mergeMap = {};
+
+  for (const hooks of hooksList) {
+    for (const key of OUTPUT_HOOKS) {
+      if (hooks[key]) {
+        outputMap[key] = outputMap[key] || [];
+        outputMap[key].push(hooks[key]);
+      }
+    }
+    for (const key of INPUT_HOOKS) {
+      if (hooks[key]) inputList.push(hooks[key]);
+    }
+    for (const key of CONFIG_HOOKS) {
+      if (hooks[key]) configList.push(hooks[key]);
+    }
+    for (const key of MERGE_HOOKS) {
+      if (hooks[key]) {
+        mergeMap[key] = mergeMap[key] || {};
+        Object.assign(mergeMap[key], hooks[key]);
+      }
+    }
+  }
+
+  // Build callers for (input, output) hooks
+  for (const [key, handlers] of Object.entries(outputMap)) {
+    merged[key] = async (input, output) => {
+      for (const fn of handlers) await fn(input, output);
+    };
+  }
+
+  // Build caller for single-input hooks (event)
+  if (inputList.length > 0) {
+    merged.event = async (input) => {
+      for (const fn of inputList) await fn(input);
+    };
+  }
+
+  // Build caller for single-config hooks
+  if (configList.length > 0) {
+    merged.config = async (config) => {
+      for (const fn of configList) await fn(config);
+    };
+  }
+
+  // Merge object hooks (tool) into the result
+  for (const [key, obj] of Object.entries(mergeMap)) {
+    merged[key] = obj;
+  }
+
+  return merged;
+}

package/harnesses/opencode/directspeech/README.md

@@ -0,0 +1,43 @@
+# Impulso-DirectSpeech (opencode harness)
+
+DirectSpeech is **always on**. No modes, no toggles, no flag files.
+
+Two layers:
+
+1. **Ruleset** — the Impulso mode block in `shared/AGENTS.md`, loaded into every
+   session via the profile `AGENTS.md`.
+2. **Per-turn reinforcement** — this plugin pushes one line into the system
+   prompt each turn (`experimental.chat.system.transform` hook) so the style
+   survives long conversations and compaction:
+
+```
+IMPULSO DIRECT SPEECH MODE ACTIVE. Terse, technical, no filler. Fragments OK.
+Code/commits/security: write normal.
+```
+
+The line lives in `shared/directspeech-config.cjs` — shared with the Claude Code
+harness, which injects it via a UserPromptSubmit hook.
+
+Escape hatches are model-level, not machinery: Auto-Clarity drops terseness for
+security warnings and irreversible actions; code/commits/PRs are always written
+normal.
+
+## File overview
+
+```
+harnesses/opencode/directspeech/
+└── plugin.js    # opencode plugin (ESM, loaded via profile plugins array)
+shared/
+└── directspeech-config.cjs    # reinforcement line (CJS, shared across harnesses)
+```
+
+`directspeech-config.cjs` is loaded by hand (not via module loader) because the
+opencode Bun binary rejects `require()` of on-disk files and `await import()` of
+CJS yields an empty namespace. `plugin.js` evaluates it through `new Function()`
+— a deliberate choice for this sibling file only, not a general mechanism.
+
+## Skills relationship
+
+The independent skills (`/impulso-directspeech-compress`, `-stats`, `-help`) are
+regular bundled skills with their own slash commands — they don't interact with
+the reinforcement line.

package/harnesses/opencode/directspeech/plugin.js

@@ -0,0 +1,47 @@
+// impulso-directspeech — opencode plugin
+//
+// DirectSpeech is always on: inject the per-turn reinforcement line into the
+// system prompt, unconditionally. No flags, no toggles, no modes. The full
+// ruleset comes from the profile AGENTS.md; this is the drift guard.
+//
+// Bun ESM module; loads the shared reinforcement line from
+// shared/directspeech-config.cjs via a Function-constructor CJS shim
+// (the Bun binary rejects require() of on-disk CJS, and await import()
+// of CJS yields an empty namespace).
+//
+// Hook mapping (opencode >= 1.15.x):
+//   - experimental.chat.system.transform: inject reinforcement
+
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { readFileSync } from 'node:fs';
+
+const here = dirname(fileURLToPath(import.meta.url));
+
+function loadConfig() {
+  const target = join(here, '../../../shared/directspeech-config.cjs');
+  const code = readFileSync(target, 'utf8').replace(/^#![^\n]*\n/, '');
+  const mod = { exports: {} };
+  new Function('module', 'exports', 'require', '__dirname', '__filename', code)(
+    mod,
+    mod.exports,
+    createRequire(import.meta.url),
+    dirname(target),
+    target,
+  );
+  return mod.exports;
+}
+
+const { reinforcementLine } = loadConfig();
+
+export const ImpulsoDirectSpeechPlugin = async (_ctx) => {
+  return {
+    'experimental.chat.system.transform': async (_input, output) => {
+      if (!output || !Array.isArray(output.system)) return;
+      output.system.push(reinforcementLine());
+    },
+  };
+};
+
+export default ImpulsoDirectSpeechPlugin;

package/harnesses/opencode/frontmatter.js

@@ -0,0 +1,60 @@
+// Shared frontmatter parser — used by sync-commands.js (build-time) and
+// commands-loader.js (runtime plugin).
+
+/**
+ * Parse YAML frontmatter from a SKILL.md or command .md file.
+ * Returns { name, description, body }.
+ * Throws on missing/malformed frontmatter.
+ */
+export function parseFrontmatter(content) {
+  const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/.exec(content);
+  if (!m) {
+    throw new Error('missing or malformed frontmatter (--- delimiters)');
+  }
+  const raw = m[1];
+  const body = m[2];
+
+  const lines = raw.split(/\r?\n/);
+  let name = null;
+  let description = null;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const nameMatch = /^name:\s*(.*)$/.exec(line);
+    if (nameMatch) {
+      name = nameMatch[1].trim();
+      continue;
+    }
+    const descMatch = /^description:\s*(.*)$/.exec(line);
+    if (descMatch) {
+      const rest = descMatch[1].trim();
+      if (rest === '>' || rest === '|' || rest === '') {
+        // Folded/literal block (`>` / `|`) OR multi-line plain scalar with
+        // value on continuation lines (prettier sometimes rewrote `>` blocks
+        // into this form). Either way, collect indented following lines.
+        const parts = [];
+        for (let j = i + 1; j < lines.length; j++) {
+          if (/^\s/.test(lines[j])) {
+            parts.push(lines[j].trim());
+          } else if (lines[j] === '') {
+            continue;
+          } else {
+            break;
+          }
+        }
+        description = parts.filter(Boolean).join(' ');
+      } else {
+        description = rest;
+      }
+      continue;
+    }
+  }
+
+  if (!name) {
+    throw new Error('frontmatter missing `name:`');
+  }
+  if (!description) {
+    throw new Error('frontmatter missing `description:`');
+  }
+  return { name, description, body };
+}

package/harnesses/opencode/install.sh

@@ -0,0 +1,121 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Impulso opencode install — creates the isolated profile dir, symlinks
+# skills/commands from this repo, writes opencode.jsonc + AGENTS.md.
+# Idempotent — safe to rerun.
+
+REPO="$(cd "$(dirname "$0")/../.." && pwd)"
+PROFILE_DIR="${HOME}/.config/impulso-profile/opencode"
+
+echo "==> Impulso install (opencode)"
+echo "    Repo:  ${REPO}"
+echo "    Profile: ${PROFILE_DIR}"
+
+# --- Preflight: hard-required binaries -------------------------------------
+# Impulso is opinionated: tokensave (MCP server) and rtk (CLI token-filter
+# proxy) must be on PATH. Missing either aborts install before touching
+# the filesystem.
+
+require_bin() {
+  local bin="$1"
+  local hint="$2"
+  if ! command -v "$bin" >/dev/null 2>&1; then
+    echo "ERROR: '$bin' not found on PATH. Impulso requires it." >&2
+    echo "  $hint" >&2
+    exit 1
+  fi
+}
+
+require_bin rtk        "Install: brew install rtk-ai/tap/rtk  (see https://www.rtk-ai.app)"
+require_bin tokensave  "Install: brew install aovestdipaperino/tap/tokensave  (or: cargo install tokensave)"
+
+# --- Global gitignore for tool artifacts ------------------------------------
+# .tokensave/ (per-project SQLite code graph) and .rtk/ (cache) must never
+# land in a target repo. Write to a global git excludesfile so any repo
+# the user touches with Impulso is protected. Prompted; default yes.
+
+ensure_global_gitignore() {
+  local ignore_file="${HOME}/.config/git/ignore"
+  local entries=(".tokensave/" ".rtk/")
+  local answer="y"
+
+  echo
+  echo "Impulso can add .tokensave/ and .rtk/ to a global git excludesfile"
+  echo "so they are never committed to any target repo."
+  printf "Write to %s? [Y/n] " "${ignore_file}"
+  read -r answer || answer=""
+
+  # ${answer,,} is bash 4+; macOS ships bash 3.2 — use case instead.
+  case "${answer}" in
+    '' | [Yy]) ;;
+    *)
+      echo "    Skipped. Add these lines manually if you change your mind:"
+      printf "    %s\n" "${entries[@]}"
+      echo "    then: git config --global core.excludesfile <path>"
+      return 0
+      ;;
+  esac
+
+  mkdir -p "$(dirname "${ignore_file}")"
+  touch "${ignore_file}"
+
+  local entry
+  for entry in "${entries[@]}"; do
+    if ! grep -Fxq -- "${entry}" "${ignore_file}" 2>/dev/null; then
+      printf '%s\n' "${entry}" >> "${ignore_file}"
+      echo "    Added: ${entry}"
+    else
+      echo "    Already present: ${entry}"
+    fi
+  done
+
+  git config --global core.excludesfile "${ignore_file}"
+  echo "    core.excludesfile = ${ignore_file}"
+}
+
+ensure_global_gitignore
+
+# --- Profile setup ----------------------------------------------------------
+
+mkdir -p "${PROFILE_DIR}"
+
+# Symlink skills/ and commands/ into the profile. Use -sfn (force, no-deref
+# target) so we don't follow into the target when replacing.
+for sub in skills commands; do
+  link_path="${PROFILE_DIR}/${sub}"
+  target="${REPO}/${sub}"
+  if [[ -L "${link_path}" ]] || [[ -e "${link_path}" ]]; then
+    rm -rf "${link_path}"
+  fi
+  ln -sfn "${target}" "${link_path}"
+  echo "    Linked ${sub} -> ${target}"
+done
+
+# Copy AGENTS.md from the canonical shared/ source (copy, not symlink —
+# profile self-contained).
+cp -f "${REPO}/shared/AGENTS.md" "${PROFILE_DIR}/AGENTS.md"
+echo "    Copied AGENTS.md"
+
+# Generate opencode.jsonc from the self-boot config (single source of truth):
+# the self-boot file resolves plugins relative to the config dir ("../...");
+# the profile pins them to this repo's absolute path instead.
+sed "s|\"\.\./|\"${REPO}/|g" "${REPO}/opencode/opencode.jsonc" > "${PROFILE_DIR}/opencode.jsonc"
+echo "    Wrote opencode.jsonc (plugins -> ${REPO}/harnesses/opencode)"
+
+# --- impulso-hub binary — copy matching bundled package binary -------------
+node "${REPO}/scripts/install-hub.js"
+
+if ! command -v impulso-hub >/dev/null 2>&1; then
+  echo "    NOTE: ~/.local/bin may not be on PATH. Add to your shell profile:"
+  echo '      export PATH="$HOME/.local/bin:$PATH"'
+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. Launch with:"
+echo "    XDG_CONFIG_HOME=${HOME}/.config/impulso-profile opencode"