@c-d-cc/reap 0.16.3 → 0.16.5

package/dist/adapters/opencode/plugin/reap-plugin.ts

@@ -0,0 +1,69 @@
+/**
+ * REAP OpenCode plugin.
+ *
+ * Purpose:
+ *   - On `session.created`, refresh `.reap/.session-state.md` so that
+ *     OpenCode's `instructions`-based static loading picks up the current
+ *     REAP state for the next session/tool turn.
+ *   - On `tool.execute.before`, refresh once if not already done in this
+ *     plugin instance (handles the "resume" case where `session.created`
+ *     does not fire).
+ *
+ * Failure mode: best-effort. If `reap` CLI is missing, not a REAP project,
+ * or any other error occurs, the plugin silently swallows it — never blocks
+ * the user's session.
+ *
+ * Plugin API target: OpenCode plugin spec as of 2026-05
+ *   - signature: `async ({ project, client, $, directory, worktree }) => hooks`
+ *   - hooks used: `session.created`, `tool.execute.before`
+ *
+ * For typed development, install `@opencode-ai/plugin` and replace the
+ * inline parameter type with `import type { Plugin } from "@opencode-ai/plugin"`.
+ */
+
+type ShellTagFn = (strings: TemplateStringsArray, ...values: unknown[]) => {
+  cwd(dir: string): ShellResult;
+  quiet?(): ShellResult;
+};
+
+type ShellResult = {
+  cwd?(dir: string): ShellResult;
+  quiet?(): ShellResult;
+  then<T = unknown>(onfulfilled?: ((v: unknown) => T) | null, onrejected?: ((r: unknown) => T) | null): Promise<T>;
+};
+
+interface PluginContext {
+  $: ShellTagFn;
+  directory: string;
+  // Other fields (project, client, worktree) are unused by this plugin.
+  [k: string]: unknown;
+}
+
+export const reapPlugin = async ({ $, directory }: PluginContext) => {
+  let dumpedThisSession = false;
+
+  const dump = async () => {
+    try {
+      // `reap dump-state --silent` writes .reap/.session-state.md and
+      // exits 0 even when the project is not a REAP project (silent mode).
+      const cmd = $`reap dump-state --silent`.cwd(directory);
+      // Prefer quiet() if available to suppress incidental stdout.
+      const runnable = typeof cmd.quiet === "function" ? cmd.quiet() : cmd;
+      await runnable;
+      dumpedThisSession = true;
+    } catch {
+      // REAP not installed, not a REAP project, or transient error — ignore.
+    }
+  };
+
+  return {
+    "session.created": async () => {
+      await dump();
+    },
+    "tool.execute.before": async () => {
+      if (!dumpedThisSession) await dump();
+    },
+  };
+};
+
+export default reapPlugin;

package/dist/adapters/opencode/templates/agents.md

@@ -0,0 +1,40 @@
+# REAP Project
+
+This project uses REAP (Recursive Evolutionary Autonomous Pipeline). All work must follow genome principles in `.reap/genome/` and respect `.reap/genome/invariants.md` as absolute constraints.
+
+## Knowledge Loading
+
+Static knowledge (genome, environment, vision, memory) is auto-loaded via `opencode.json`'s `instructions` field — no manual action required.
+
+Dynamic state (current generation, stage, strict mode, language directive) is dumped to `.reap/.session-state.md` by the REAP OpenCode plugin (`.opencode/plugins/reap-plugin.ts`) on `session.created` and `tool.execute.before` hooks. That file is also listed in `instructions`, so it is auto-loaded into every session.
+
+If state appears stale (e.g., after long inactivity or external state change), run:
+
+- `reap status` — verify current state
+- `reap dump-state` — manually refresh `.reap/.session-state.md`
+
+## REAP Workflow Reference
+
+For REAP CLI usage, lifecycle stages, memory model, and behavioral rules, see `~/.reap/reap-guide.md` (installed by `reap install-skills`).
+
+When running REAP commands, follow the structured lifecycle (`reap run <stage>`). Do not edit `.reap/life/current.yml` directly — REAP uses signature-based locking and direct edits will produce errors.
+
+## Slash Commands
+
+REAP installs `/reap.*` slash commands into `~/.config/opencode/commands/` when `reap install-skills` (or `reap update`) runs with `agentClient: opencode`. Available commands include:
+
+- `/reap.evolve` — Run a full generation lifecycle
+- `/reap.start`, `/reap.next`, `/reap.back` — Lifecycle control
+- `/reap.status` — Show current generation state
+- `/reap.early-close`, `/reap.abort` — Termination paths
+- `/reap.knowledge`, `/reap.config` — Knowledge / configuration
+- `/reap.merge`, `/reap.pull`, `/reap.push` — Collaboration
+- `/reap.update`, `/reap.help`, `/reap.report` — Maintenance
+
+The `reap.` prefix (with the literal dot) is reserved by REAP — any file matching `reap.*.md` in that directory will be overwritten on the next install. User-defined commands should use a different prefix (e.g., `mytool.md`, `team-review.md`).
+
+## Plugin Compatibility
+
+The bundled plugin (`.opencode/plugins/reap-plugin.ts`) targets the OpenCode plugin API as of 2026-05. Plugin signature: `async ({ $, directory }) => hooksObject`. If your OpenCode version changes the plugin API, rerun `reap install-skills` to refresh the plugin file.
+
+For typed plugin development, optionally install `@opencode-ai/plugin` and import the `Plugin` type — the bundled plugin uses inline types to avoid forcing this dependency.