opencodekit 0.0.1

package/dist/template/.opencode/superpowers/tests/opencode/test-tools.sh

@@ -0,0 +1,104 @@
+#!/usr/bin/env bash
+# Test: Tools Functionality
+# Verifies that use_skill and find_skills tools work correctly
+# NOTE: These tests require OpenCode to be installed and configured
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+echo "=== Test: Tools Functionality ==="
+
+# Source setup to create isolated environment
+source "$SCRIPT_DIR/setup.sh"
+
+# Trap to cleanup on exit
+trap cleanup_test_env EXIT
+
+# Check if opencode is available
+if ! command -v opencode &> /dev/null; then
+    echo "  [SKIP] OpenCode not installed - skipping integration tests"
+    echo "  To run these tests, install OpenCode: https://opencode.ai"
+    exit 0
+fi
+
+# Test 1: Test find_skills tool via direct invocation
+echo "Test 1: Testing find_skills tool..."
+echo "  Running opencode with find_skills request..."
+
+# Use timeout to prevent hanging, capture both stdout and stderr
+output=$(timeout 60s opencode run --print-logs "Use the find_skills tool to list available skills. Just call the tool and show me the raw output." 2>&1) || {
+    exit_code=$?
+    if [ $exit_code -eq 124 ]; then
+        echo "  [FAIL] OpenCode timed out after 60s"
+        exit 1
+    fi
+    echo "  [WARN] OpenCode returned non-zero exit code: $exit_code"
+}
+
+# Check for expected patterns in output
+if echo "$output" | grep -qi "superpowers:brainstorming\|superpowers:using-superpowers\|Available skills"; then
+    echo "  [PASS] find_skills tool discovered superpowers skills"
+else
+    echo "  [FAIL] find_skills did not return expected skills"
+    echo "  Output was:"
+    echo "$output" | head -50
+    exit 1
+fi
+
+# Check if personal test skill was found
+if echo "$output" | grep -qi "personal-test"; then
+    echo "  [PASS] find_skills found personal test skill"
+else
+    echo "  [WARN] personal test skill not found in output (may be ok if tool returned subset)"
+fi
+
+# Test 2: Test use_skill tool
+echo ""
+echo "Test 2: Testing use_skill tool..."
+echo "  Running opencode with use_skill request..."
+
+output=$(timeout 60s opencode run --print-logs "Use the use_skill tool to load the personal-test skill and show me what you get." 2>&1) || {
+    exit_code=$?
+    if [ $exit_code -eq 124 ]; then
+        echo "  [FAIL] OpenCode timed out after 60s"
+        exit 1
+    fi
+    echo "  [WARN] OpenCode returned non-zero exit code: $exit_code"
+}
+
+# Check for the skill marker we embedded
+if echo "$output" | grep -qi "PERSONAL_SKILL_MARKER_12345\|Personal Test Skill\|Launching skill"; then
+    echo "  [PASS] use_skill loaded personal-test skill content"
+else
+    echo "  [FAIL] use_skill did not load personal-test skill correctly"
+    echo "  Output was:"
+    echo "$output" | head -50
+    exit 1
+fi
+
+# Test 3: Test use_skill with superpowers: prefix
+echo ""
+echo "Test 3: Testing use_skill with superpowers: prefix..."
+echo "  Running opencode with superpowers:brainstorming skill..."
+
+output=$(timeout 60s opencode run --print-logs "Use the use_skill tool to load superpowers:brainstorming and tell me the first few lines of what you received." 2>&1) || {
+    exit_code=$?
+    if [ $exit_code -eq 124 ]; then
+        echo "  [FAIL] OpenCode timed out after 60s"
+        exit 1
+    fi
+    echo "  [WARN] OpenCode returned non-zero exit code: $exit_code"
+}
+
+# Check for expected content from brainstorming skill
+if echo "$output" | grep -qi "brainstorming\|Launching skill\|skill.*loaded"; then
+    echo "  [PASS] use_skill loaded superpowers:brainstorming skill"
+else
+    echo "  [FAIL] use_skill did not load superpowers:brainstorming correctly"
+    echo "  Output was:"
+    echo "$output" | head -50
+    exit 1
+fi
+
+echo ""
+echo "=== All tools tests passed ==="

package/dist/template/.opencode/tool/memory-read.ts

@@ -0,0 +1,66 @@
+import { tool } from "@opencode-ai/plugin";
+import fs from "fs/promises";
+import path from "path";
+
+export default tool({
+  description:
+    "Read memory files for persistent cross-session context. Returns current project state, learnings, and active tasks. Supports subdirectories (e.g., 'research/opencode-sessions').",
+  args: {
+    file: tool.schema
+      .string()
+      .optional()
+      .describe(
+        "Memory file to read: handoffs/YYYY-MM-DD-phase, research/YYYY-MM-DD-topic, _templates/task-prd, _templates/task-spec, _templates/task-review, _templates/research, _templates/handoff",
+      ),
+  },
+  execute: async (args: { file?: string }) => {
+    const fileName = args.file || "memory";
+
+    // Normalize: strip .md extension if present
+    const normalizedFile = fileName.replace(/\.md$/i, "");
+
+    // Location priority: project > global > legacy
+    const locations = [
+      path.join(process.cwd(), ".opencode/memory", `${normalizedFile}.md`),
+      path.join(
+        process.env.HOME || "",
+        ".config/opencode/memory",
+        `${normalizedFile}.md`,
+      ),
+      path.join(
+        process.cwd(),
+        ".config/opencode/memory",
+        `${normalizedFile}.md`,
+      ),
+    ];
+
+    // Try each location in order
+    for (const filePath of locations) {
+      try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const locationLabel = filePath.includes(".opencode/memory")
+          ? "project"
+          : filePath.includes(process.env.HOME || "")
+            ? "global"
+            : "legacy";
+        return `[Read from ${locationLabel}: ${filePath}]\n\n${content}`;
+      } catch (error) {
+        // Continue to next location if file not found
+        if (
+          error instanceof Error &&
+          "code" in error &&
+          error.code === "ENOENT"
+        ) {
+          continue;
+        }
+        // Other errors should be reported
+        if (error instanceof Error) {
+          return `Error reading memory from ${filePath}: ${error.message}`;
+        }
+      }
+    }
+
+    // No file found in any location
+    return `Memory file '${normalizedFile}.md' not found in any location.\nSearched:\n- ${locations.join("\n- ")}\n\nStructure:\n- handoffs/YYYY-MM-DD-phase (phase transitions)\n- research/YYYY-MM-DD-topic (research findings)\n- _templates/ (prd, spec, review, research, handoff)`;
+  },
+});

package/dist/template/.opencode/tool/memory-update.ts

@@ -0,0 +1,61 @@
+import { tool } from "@opencode-ai/plugin";
+import fs from "fs/promises";
+import path from "path";
+
+export default tool({
+  description:
+    "Update memory files with new learnings, progress, or context. Appends or replaces content based on mode. Supports subdirectories for organization (e.g., 'research/opencode-sessions' creates .opencode/memory/research/opencode-sessions.md).",
+  args: {
+    file: tool.schema
+      .string()
+      .describe(
+        "Memory file to update: handoffs/YYYY-MM-DD-phase, research/YYYY-MM-DD-topic. Use _templates/ for reference only.",
+      ),
+    content: tool.schema
+      .string()
+      .describe("Content to write or append to the memory file"),
+    mode: tool.schema
+      .string()
+      .optional()
+      .default("replace")
+      .describe(
+        "Update mode: 'replace' (overwrite file) or 'append' (add to end).",
+      ),
+  },
+  execute: async (args: { file: string; content: string; mode?: string }) => {
+    // Always write to project memory (.opencode/memory/)
+    const memoryDir = path.join(process.cwd(), ".opencode/memory");
+
+    // Normalize file path: strip existing .md extension, handle subdirectories
+    let normalizedFile = args.file.replace(/\.md$/i, ""); // Remove .md if present
+    const filePath = path.join(memoryDir, `${normalizedFile}.md`);
+    const mode = args.mode || "replace";
+
+    try {
+      // Ensure parent directory exists (handles subdirectories)
+      const fileDir = path.dirname(filePath);
+      await fs.mkdir(fileDir, { recursive: true });
+
+      if (mode === "append") {
+        const timestamp = new Date().toISOString();
+        const appendContent = `\n\n---\n**Updated:** ${timestamp}\n\n${args.content}`;
+        await fs.appendFile(filePath, appendContent, "utf-8");
+        return `Successfully appended to ${normalizedFile}.md\n[Written to: ${filePath}]`;
+      } else {
+        // Replace mode - update timestamp
+        const timestamp = new Date().toISOString();
+        const updatedContent = args.content.replace(
+          /\*\*Last Updated:\*\* \[Timestamp\]/,
+          `**Last Updated:** ${timestamp}`,
+        );
+        await fs.writeFile(filePath, updatedContent, "utf-8");
+        return `Successfully updated ${normalizedFile}.md\n[Written to: ${filePath}]`;
+      }
+    } catch (error) {
+      if (error instanceof Error) {
+        return `Error updating memory: ${error.message}`;
+      }
+      return `Unknown error updating memory file`;
+    }
+  },
+});

package/dist/template/.opencode/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "strict": false,
+    "noEmit": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./",
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "types": ["node"]
+  },
+  "include": ["plugin/**/*.ts", "tool/**/*.ts", "agent/**/*.ts", "*.ts"],
+  "exclude": ["node_modules", "dist", "**/*.js", "**/*.test.ts"]
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+	"name": "opencodekit",
+	"version": "0.0.1",
+	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
+	"type": "module",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/opencodekit/opencodekit-template.git"
+	},
+	"publishConfig": {
+		"access": "public",
+		"registry": "https://registry.npmjs.org"
+	},
+	"bin": {
+		"ock": "dist/index.js"
+	},
+	"files": ["dist", "README.md"],
+	"scripts": {
+		"dev": "bun run src/index.ts",
+		"build": "bun build src/index.ts --outdir dist --target node && mkdir -p dist/template && rsync -av --exclude=node_modules --exclude=dist --exclude=.git --exclude=coverage --exclude=.next --exclude=.turbo --exclude=logs --exclude=package-lock.json .opencode/ dist/template/.opencode/",
+		"compile": "bun build src/index.ts --compile --outfile ock",
+		"compile:binary": "bun build src/index.ts --compile --outfile bin/ock",
+		"typecheck": "tsc --noEmit",
+		"test": "bun test",
+		"test:watch": "bun test --watch",
+		"lint": "biome check .",
+		"lint:fix": "biome check --fix ."
+	},
+	"keywords": ["cli", "opencodekit", "template", "agents", "mcp", "opencode"],
+	"author": "OpenCodeKit",
+	"license": "MIT",
+	"engines": {
+		"bun": ">=1.3.2"
+	},
+	"dependencies": {
+		"@clack/prompts": "^0.7.0",
+		"@opencode-ai/plugin": "^1.0.141",
+		"cac": "^6.7.14",
+		"cli-table3": "^0.6.5",
+		"ora": "^9.0.0",
+		"picocolors": "^1.1.1",
+		"zod": "^3.23.8"
+	},
+	"devDependencies": {
+		"@beads/bd": "^0.29.0",
+		"@biomejs/biome": "^1.9.4",
+		"@types/bun": "latest",
+		"@types/node": "^22.10.1",
+		"typescript": "^5.7.2"
+	},
+	"trustedDependencies": ["@beads/bd"]
+}