oh-my-imagicma 0.1.0

package/README.md

@@ -0,0 +1,121 @@
+# Oh My Imagicma
+
+A minimal OpenCode plugin with Ralph Loop - self-referential development loop until task completion.
+
+## Features
+
+- **`/ralph-loop`** - Start a self-referential development loop that continues until task completion
+- **`/ulw-loop`** - Start an ultrawork loop that continues until task completion
+- **`/cancel-ralph`** - Cancel the currently active Ralph Loop
+
+## Installation
+
+```bash
+# Install the plugin
+bun add oh-my-imagicma
+# or
+npm install oh-my-imagicma
+```
+
+Add to your OpenCode config (`~/.config/opencode/opencode.json`):
+
+```json
+{
+  "plugin": ["oh-my-imagicma"]
+}
+```
+
+## Usage
+
+### Ralph Loop
+
+Start a loop that continues until the task is complete:
+
+```
+/ralph-loop "Build a REST API with authentication"
+/ralph-loop "Refactor the payment module" --max-iterations=50
+/ralph-loop "Fix all TypeScript errors" --completion-promise=ALL_FIXED
+```
+
+**How it works:**
+1. The agent works on the provided task
+2. When the session goes idle, the system checks if the completion promise was output
+3. If not complete, the agent is prompted to continue
+4. This repeats until:
+   - The completion promise is detected: `<promise>DONE</promise>`
+   - Maximum iterations reached (default: 100)
+   - User cancels with `/cancel-ralph`
+
+### Ultrawork Loop
+
+Start an ultrawork loop that runs at maximum intensity until completion:
+
+```
+/ulw-loop "Build a REST API with authentication"
+/ulw-loop "Refactor the payment module" --max-iterations=50
+/ulw-loop "Fix all TypeScript errors" --completion-promise=ALL_FIXED
+```
+
+### Cancel Ralph Loop
+
+```
+/cancel-ralph
+```
+
+## Configuration
+
+Create a config file at `.opencode/oh-my-imagicma.json` (project) or `~/.config/opencode/oh-my-imagicma.json` (user):
+
+```json
+{
+  "ralph_loop": {
+    "enabled": true,
+    "default_max_iterations": 100,
+    "state_dir": ".imagicma/ralph-loop.local.md"
+  },
+  "disabled_hooks": []
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Type check
+bun run typecheck
+
+# Build
+bun run build
+
+# Run tests
+bun test
+```
+
+## Publishing
+
+1. **登录 npm**（若未登录）：
+   ```bash
+   npm login
+   ```
+   按提示输入 npm 用户名、密码和邮箱（或使用 2FA）。
+
+2. **确认版本**：在 `package.json` 里改好 `version`，或使用：
+   ```bash
+   npm version patch   # 0.1.0 -> 0.1.1
+   npm version minor   # 0.1.0 -> 0.2.0
+   npm version major   # 0.1.0 -> 1.0.0
+   ```
+
+3. **发布**：
+   ```bash
+   npm publish
+   ```
+   发布前会自动执行 `prepublishOnly`（clean + build），因此会先构建再上传。
+
+首次发布前请确认 [npmjs.com](https://www.npmjs.com/) 上还没有同名包 `oh-my-imagicma`，否则需要换包名或使用 scope（如 `@your-username/oh-my-imagicma`）。
+
+## License
+
+MIT

package/dist/config/index.d.ts

@@ -0,0 +1 @@
+export type { RalphLoopConfig, OhMyImagicmaConfig } from "./types";

package/dist/config/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Configuration types for oh-my-imagicma
+ */
+export interface RalphLoopConfig {
+    /** Enable/disable Ralph Loop feature */
+    enabled?: boolean;
+    /** Default maximum iterations before stopping (default: 100) */
+    default_max_iterations?: number;
+    /** Custom state file path (default: .imagicma/ralph-loop.local.md) */
+    state_dir?: string;
+}
+export interface OhMyImagicmaConfig {
+    /** Ralph Loop configuration */
+    ralph_loop?: RalphLoopConfig;
+    /** Disabled hooks */
+    disabled_hooks?: string[];
+}

package/dist/hooks/index.d.ts

@@ -0,0 +1 @@
+export { createRalphLoopHook, type RalphLoopHook, type RalphLoopState, type RalphLoopOptions, HOOK_NAME as RALPH_LOOP_HOOK_NAME, DEFAULT_MAX_ITERATIONS, DEFAULT_COMPLETION_PROMISE, } from "./ralph-loop";

package/dist/hooks/ralph-loop/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const HOOK_NAME = "ralph-loop";
+export declare const DEFAULT_STATE_FILE = ".imagicma/ralph-loop.local.md";
+export declare const COMPLETION_TAG_PATTERN: RegExp;
+export declare const DEFAULT_MAX_ITERATIONS = 100;
+export declare const DEFAULT_COMPLETION_PROMISE = "DONE";

package/dist/hooks/ralph-loop/index.d.ts

@@ -0,0 +1,21 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+import type { RalphLoopState, RalphLoopOptions } from "./types";
+export * from "./types";
+export * from "./constants";
+export { readState, writeState, clearState, incrementIteration } from "./storage";
+export interface RalphLoopHook {
+    event: (input: {
+        event: {
+            type: string;
+            properties?: unknown;
+        };
+    }) => Promise<void>;
+    startLoop: (sessionID: string, prompt: string, options?: {
+        maxIterations?: number;
+        completionPromise?: string;
+        ultrawork?: boolean;
+    }) => boolean;
+    cancelLoop: (sessionID: string) => boolean;
+    getState: () => RalphLoopState | null;
+}
+export declare function createRalphLoopHook(ctx: PluginInput, options?: RalphLoopOptions): RalphLoopHook;

package/dist/hooks/ralph-loop/storage.d.ts

@@ -0,0 +1,21 @@
+import type { RalphLoopState } from "./types";
+/**
+ * Get the full path to the state file
+ */
+export declare function getStateFilePath(directory: string, customPath?: string): string;
+/**
+ * Read the current Ralph Loop state from disk
+ */
+export declare function readState(directory: string, customPath?: string): RalphLoopState | null;
+/**
+ * Write Ralph Loop state to disk
+ */
+export declare function writeState(directory: string, state: RalphLoopState, customPath?: string): boolean;
+/**
+ * Clear the Ralph Loop state file
+ */
+export declare function clearState(directory: string, customPath?: string): boolean;
+/**
+ * Increment the iteration counter and save state
+ */
+export declare function incrementIteration(directory: string, customPath?: string): RalphLoopState | null;

package/dist/hooks/ralph-loop/types.d.ts

@@ -0,0 +1,28 @@
+import type { RalphLoopConfig } from "../../config";
+export interface RalphLoopState {
+    /** Whether the loop is currently active */
+    active: boolean;
+    /** Current iteration number */
+    iteration: number;
+    /** Maximum iterations before stopping */
+    max_iterations: number;
+    /** The promise text that signals completion */
+    completion_promise: string;
+    /** ISO timestamp when the loop started */
+    started_at: string;
+    /** The original task prompt */
+    prompt: string;
+    /** Session ID associated with this loop */
+    session_id?: string;
+    ultrawork?: boolean;
+}
+export interface RalphLoopOptions {
+    /** Ralph loop configuration */
+    config?: RalphLoopConfig;
+    /** Custom function to get transcript path */
+    getTranscriptPath?: (sessionId: string) => string;
+    /** API timeout in milliseconds */
+    apiTimeout?: number;
+    /** Function to check if a session exists */
+    checkSessionExists?: (sessionId: string) => Promise<boolean>;
+}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { Plugin } from "@opencode-ai/plugin";
+declare const OhMyImagicmaPlugin: Plugin;
+export default OhMyImagicmaPlugin;
+export type { OhMyImagicmaConfig, RalphLoopConfig } from "./config";
+export type { RalphLoopState, RalphLoopOptions } from "./hooks";