aw-ecc 1.4.21

package/.opencode/prompts/agents/tdd-guide.txt

@@ -0,0 +1,211 @@
+You are a Test-Driven Development (TDD) specialist who ensures all code is developed test-first with comprehensive coverage.
+
+## Your Role
+
+- Enforce tests-before-code methodology
+- Guide developers through TDD Red-Green-Refactor cycle
+- Ensure 80%+ test coverage
+- Write comprehensive test suites (unit, integration, E2E)
+- Catch edge cases before implementation
+
+## TDD Workflow
+
+### Step 1: Write Test First (RED)
+```typescript
+// ALWAYS start with a failing test
+describe('searchMarkets', () => {
+  it('returns semantically similar markets', async () => {
+    const results = await searchMarkets('election')
+
+    expect(results).toHaveLength(5)
+    expect(results[0].name).toContain('Trump')
+    expect(results[1].name).toContain('Biden')
+  })
+})
+```
+
+### Step 2: Run Test (Verify it FAILS)
+```bash
+npm test
+# Test should fail - we haven't implemented yet
+```
+
+### Step 3: Write Minimal Implementation (GREEN)
+```typescript
+export async function searchMarkets(query: string) {
+  const embedding = await generateEmbedding(query)
+  const results = await vectorSearch(embedding)
+  return results
+}
+```
+
+### Step 4: Run Test (Verify it PASSES)
+```bash
+npm test
+# Test should now pass
+```
+
+### Step 5: Refactor (IMPROVE)
+- Remove duplication
+- Improve names
+- Optimize performance
+- Enhance readability
+
+### Step 6: Verify Coverage
+```bash
+npm run test:coverage
+# Verify 80%+ coverage
+```
+
+## Test Types You Must Write
+
+### 1. Unit Tests (Mandatory)
+Test individual functions in isolation:
+
+```typescript
+import { calculateSimilarity } from './utils'
+
+describe('calculateSimilarity', () => {
+  it('returns 1.0 for identical embeddings', () => {
+    const embedding = [0.1, 0.2, 0.3]
+    expect(calculateSimilarity(embedding, embedding)).toBe(1.0)
+  })
+
+  it('returns 0.0 for orthogonal embeddings', () => {
+    const a = [1, 0, 0]
+    const b = [0, 1, 0]
+    expect(calculateSimilarity(a, b)).toBe(0.0)
+  })
+
+  it('handles null gracefully', () => {
+    expect(() => calculateSimilarity(null, [])).toThrow()
+  })
+})
+```
+
+### 2. Integration Tests (Mandatory)
+Test API endpoints and database operations:
+
+```typescript
+import { NextRequest } from 'next/server'
+import { GET } from './route'
+
+describe('GET /api/markets/search', () => {
+  it('returns 200 with valid results', async () => {
+    const request = new NextRequest('http://localhost/api/markets/search?q=trump')
+    const response = await GET(request, {})
+    const data = await response.json()
+
+    expect(response.status).toBe(200)
+    expect(data.success).toBe(true)
+    expect(data.results.length).toBeGreaterThan(0)
+  })
+
+  it('returns 400 for missing query', async () => {
+    const request = new NextRequest('http://localhost/api/markets/search')
+    const response = await GET(request, {})
+
+    expect(response.status).toBe(400)
+  })
+})
+```
+
+### 3. E2E Tests (For Critical Flows)
+Test complete user journeys with Playwright:
+
+```typescript
+import { test, expect } from '@playwright/test'
+
+test('user can search and view market', async ({ page }) => {
+  await page.goto('/')
+
+  // Search for market
+  await page.fill('input[placeholder="Search markets"]', 'election')
+  await page.waitForTimeout(600) // Debounce
+
+  // Verify results
+  const results = page.locator('[data-testid="market-card"]')
+  await expect(results).toHaveCount(5, { timeout: 5000 })
+
+  // Click first result
+  await results.first().click()
+
+  // Verify market page loaded
+  await expect(page).toHaveURL(/\/markets\//)
+  await expect(page.locator('h1')).toBeVisible()
+})
+```
+
+## Edge Cases You MUST Test
+
+1. **Null/Undefined**: What if input is null?
+2. **Empty**: What if array/string is empty?
+3. **Invalid Types**: What if wrong type passed?
+4. **Boundaries**: Min/max values
+5. **Errors**: Network failures, database errors
+6. **Race Conditions**: Concurrent operations
+7. **Large Data**: Performance with 10k+ items
+8. **Special Characters**: Unicode, emojis, SQL characters
+
+## Test Quality Checklist
+
+Before marking tests complete:
+
+- [ ] All public functions have unit tests
+- [ ] All API endpoints have integration tests
+- [ ] Critical user flows have E2E tests
+- [ ] Edge cases covered (null, empty, invalid)
+- [ ] Error paths tested (not just happy path)
+- [ ] Mocks used for external dependencies
+- [ ] Tests are independent (no shared state)
+- [ ] Test names describe what's being tested
+- [ ] Assertions are specific and meaningful
+- [ ] Coverage is 80%+ (verify with coverage report)
+
+## Test Smells (Anti-Patterns)
+
+### Testing Implementation Details
+```typescript
+// DON'T test internal state
+expect(component.state.count).toBe(5)
+```
+
+### Test User-Visible Behavior
+```typescript
+// DO test what users see
+expect(screen.getByText('Count: 5')).toBeInTheDocument()
+```
+
+### Tests Depend on Each Other
+```typescript
+// DON'T rely on previous test
+test('creates user', () => { /* ... */ })
+test('updates same user', () => { /* needs previous test */ })
+```
+
+### Independent Tests
+```typescript
+// DO setup data in each test
+test('updates user', () => {
+  const user = createTestUser()
+  // Test logic
+})
+```
+
+## Coverage Report
+
+```bash
+# Run tests with coverage
+npm run test:coverage
+
+# View HTML report
+open coverage/lcov-report/index.html
+```
+
+Required thresholds:
+- Branches: 80%
+- Functions: 80%
+- Lines: 80%
+- Statements: 80%
+
+**Remember**: No code without tests. Tests are not optional. They are the safety net that enables confident refactoring, rapid development, and production reliability.

package/.opencode/tools/check-coverage.ts

@@ -0,0 +1,170 @@
+/**
+ * Check Coverage Tool
+ *
+ * Custom OpenCode tool to analyze test coverage and report on gaps.
+ * Supports common coverage report formats.
+ */
+
+import { tool } from "@opencode-ai/plugin/tool"
+import * as path from "path"
+import * as fs from "fs"
+
+export default tool({
+  description:
+    "Check test coverage against a threshold and identify files with low coverage. Reads coverage reports from common locations.",
+  args: {
+    threshold: tool.schema
+      .number()
+      .optional()
+      .describe("Minimum coverage percentage required (default: 80)"),
+    showUncovered: tool.schema
+      .boolean()
+      .optional()
+      .describe("Show list of uncovered files (default: true)"),
+    format: tool.schema
+      .enum(["summary", "detailed", "json"])
+      .optional()
+      .describe("Output format (default: summary)"),
+  },
+  async execute(args, context) {
+    const threshold = args.threshold ?? 80
+    const showUncovered = args.showUncovered ?? true
+    const format = args.format ?? "summary"
+    const cwd = context.worktree || context.directory
+
+    // Look for coverage reports
+    const coveragePaths = [
+      "coverage/coverage-summary.json",
+      "coverage/lcov-report/index.html",
+      "coverage/coverage-final.json",
+      ".nyc_output/coverage.json",
+    ]
+
+    let coverageData: CoverageSummary | null = null
+    let coverageFile: string | null = null
+
+    for (const coveragePath of coveragePaths) {
+      const fullPath = path.join(cwd, coveragePath)
+      if (fs.existsSync(fullPath) && coveragePath.endsWith(".json")) {
+        try {
+          const content = JSON.parse(fs.readFileSync(fullPath, "utf-8"))
+          coverageData = parseCoverageData(content)
+          coverageFile = coveragePath
+          break
+        } catch {
+          // Continue to next file
+        }
+      }
+    }
+
+    if (!coverageData) {
+      return JSON.stringify({
+        success: false,
+        error: "No coverage report found",
+        suggestion:
+          "Run tests with coverage first: npm test -- --coverage",
+        searchedPaths: coveragePaths,
+      })
+    }
+
+    const passed = coverageData.total.percentage >= threshold
+    const uncoveredFiles = coverageData.files.filter(
+      (f) => f.percentage < threshold
+    )
+
+    const result: CoverageResult = {
+      success: passed,
+      threshold,
+      coverageFile,
+      total: coverageData.total,
+      passed,
+    }
+
+    if (format === "detailed" || (showUncovered && uncoveredFiles.length > 0)) {
+      result.uncoveredFiles = uncoveredFiles.slice(0, 20) // Limit to 20 files
+      result.uncoveredCount = uncoveredFiles.length
+    }
+
+    if (format === "json") {
+      result.rawData = coverageData
+    }
+
+    if (!passed) {
+      result.suggestion = `Coverage is ${coverageData.total.percentage.toFixed(1)}% which is below the ${threshold}% threshold. Focus on these files:\n${uncoveredFiles
+        .slice(0, 5)
+        .map((f) => `- ${f.file}: ${f.percentage.toFixed(1)}%`)
+        .join("\n")}`
+    }
+
+    return JSON.stringify(result)
+  },
+})
+
+interface CoverageSummary {
+  total: {
+    lines: number
+    covered: number
+    percentage: number
+  }
+  files: Array<{
+    file: string
+    lines: number
+    covered: number
+    percentage: number
+  }>
+}
+
+interface CoverageResult {
+  success: boolean
+  threshold: number
+  coverageFile: string | null
+  total: CoverageSummary["total"]
+  passed: boolean
+  uncoveredFiles?: CoverageSummary["files"]
+  uncoveredCount?: number
+  rawData?: CoverageSummary
+  suggestion?: string
+}
+
+function parseCoverageData(data: unknown): CoverageSummary {
+  // Handle istanbul/nyc format
+  if (typeof data === "object" && data !== null && "total" in data) {
+    const istanbulData = data as Record<string, unknown>
+    const total = istanbulData.total as Record<string, { total: number; covered: number }>
+
+    const files: CoverageSummary["files"] = []
+
+    for (const [key, value] of Object.entries(istanbulData)) {
+      if (key !== "total" && typeof value === "object" && value !== null) {
+        const fileData = value as Record<string, { total: number; covered: number }>
+        if (fileData.lines) {
+          files.push({
+            file: key,
+            lines: fileData.lines.total,
+            covered: fileData.lines.covered,
+            percentage: fileData.lines.total > 0
+              ? (fileData.lines.covered / fileData.lines.total) * 100
+              : 100,
+          })
+        }
+      }
+    }
+
+    return {
+      total: {
+        lines: total.lines?.total || 0,
+        covered: total.lines?.covered || 0,
+        percentage: total.lines?.total
+          ? (total.lines.covered / total.lines.total) * 100
+          : 0,
+      },
+      files,
+    }
+  }
+
+  // Default empty result
+  return {
+    total: { lines: 0, covered: 0, percentage: 0 },
+    files: [],
+  }
+}

package/.opencode/tools/format-code.ts

@@ -0,0 +1,68 @@
+/**
+ * ECC Custom Tool: Format Code
+ *
+ * Returns the formatter command that should be run for a given file.
+ * This avoids shell execution assumptions while still giving precise guidance.
+ */
+
+import { tool } from "@opencode-ai/plugin/tool"
+import * as path from "path"
+import * as fs from "fs"
+
+type Formatter = "biome" | "prettier" | "black" | "gofmt" | "rustfmt"
+
+export default tool({
+  description:
+    "Detect formatter for a file and return the exact command to run (Biome, Prettier, Black, gofmt, rustfmt).",
+  args: {
+    filePath: tool.schema.string().describe("Path to the file to format"),
+    formatter: tool.schema
+      .enum(["biome", "prettier", "black", "gofmt", "rustfmt"])
+      .optional()
+      .describe("Optional formatter override"),
+  },
+  async execute(args, context) {
+    const cwd = context.worktree || context.directory
+    const ext = args.filePath.split(".").pop()?.toLowerCase() || ""
+    const detected = args.formatter || detectFormatter(cwd, ext)
+
+    if (!detected) {
+      return JSON.stringify({
+        success: false,
+        message: `No formatter detected for .${ext} files`,
+      })
+    }
+
+    const command = buildFormatterCommand(detected, args.filePath)
+    return JSON.stringify({
+      success: true,
+      formatter: detected,
+      command,
+      instructions: `Run this command:\n\n${command}`,
+    })
+  },
+})
+
+function detectFormatter(cwd: string, ext: string): Formatter | null {
+  if (["ts", "tsx", "js", "jsx", "json", "css", "scss", "md", "yaml", "yml"].includes(ext)) {
+    if (fs.existsSync(path.join(cwd, "biome.json")) || fs.existsSync(path.join(cwd, "biome.jsonc"))) {
+      return "biome"
+    }
+    return "prettier"
+  }
+  if (["py", "pyi"].includes(ext)) return "black"
+  if (ext === "go") return "gofmt"
+  if (ext === "rs") return "rustfmt"
+  return null
+}
+
+function buildFormatterCommand(formatter: Formatter, filePath: string): string {
+  const commands: Record<Formatter, string> = {
+    biome: `npx @biomejs/biome format --write ${filePath}`,
+    prettier: `npx prettier --write ${filePath}`,
+    black: `black ${filePath}`,
+    gofmt: `gofmt -w ${filePath}`,
+    rustfmt: `rustfmt ${filePath}`,
+  }
+  return commands[formatter]
+}

package/.opencode/tools/git-summary.ts

@@ -0,0 +1,54 @@
+/**
+ * ECC Custom Tool: Git Summary
+ *
+ * Returns branch/status/log/diff details for the active repository.
+ */
+
+import { tool } from "@opencode-ai/plugin/tool"
+import { execSync } from "child_process"
+
+export default tool({
+  description:
+    "Generate git summary with branch, status, recent commits, and optional diff stats.",
+  args: {
+    depth: tool.schema
+      .number()
+      .optional()
+      .describe("Number of recent commits to include (default: 5)"),
+    includeDiff: tool.schema
+      .boolean()
+      .optional()
+      .describe("Include diff stats against base branch (default: true)"),
+    baseBranch: tool.schema
+      .string()
+      .optional()
+      .describe("Base branch for diff comparison (default: main)"),
+  },
+  async execute(args, context) {
+    const cwd = context.worktree || context.directory
+    const depth = args.depth ?? 5
+    const includeDiff = args.includeDiff ?? true
+    const baseBranch = args.baseBranch ?? "main"
+
+    const result: Record<string, string> = {
+      branch: run("git branch --show-current", cwd) || "unknown",
+      status: run("git status --short", cwd) || "clean",
+      log: run(`git log --oneline -${depth}`, cwd) || "no commits found",
+    }
+
+    if (includeDiff) {
+      result.stagedDiff = run("git diff --cached --stat", cwd) || ""
+      result.branchDiff = run(`git diff ${baseBranch}...HEAD --stat`, cwd) || `unable to diff against ${baseBranch}`
+    }
+
+    return JSON.stringify(result)
+  },
+})
+
+function run(command: string, cwd: string): string {
+  try {
+    return execSync(command, { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).trim()
+  } catch {
+    return ""
+  }
+}

package/.opencode/tools/index.ts

@@ -0,0 +1,13 @@
+/**
+ * ECC Custom Tools for OpenCode
+ *
+ * These tools extend OpenCode with additional capabilities.
+ */
+
+// Re-export all tools
+export { default as runTests } from "./run-tests.js"
+export { default as checkCoverage } from "./check-coverage.js"
+export { default as securityAudit } from "./security-audit.js"
+export { default as formatCode } from "./format-code.js"
+export { default as lintCheck } from "./lint-check.js"
+export { default as gitSummary } from "./git-summary.js"

package/.opencode/tools/lint-check.ts

@@ -0,0 +1,85 @@
+/**
+ * ECC Custom Tool: Lint Check
+ *
+ * Detects the appropriate linter and returns a runnable lint command.
+ */
+
+import { tool } from "@opencode-ai/plugin/tool"
+import * as path from "path"
+import * as fs from "fs"
+
+type Linter = "biome" | "eslint" | "ruff" | "pylint" | "golangci-lint"
+
+export default tool({
+  description:
+    "Detect linter for a target path and return command for check/fix runs.",
+  args: {
+    target: tool.schema
+      .string()
+      .optional()
+      .describe("File or directory to lint (default: current directory)"),
+    fix: tool.schema
+      .boolean()
+      .optional()
+      .describe("Enable auto-fix mode"),
+    linter: tool.schema
+      .enum(["biome", "eslint", "ruff", "pylint", "golangci-lint"])
+      .optional()
+      .describe("Optional linter override"),
+  },
+  async execute(args, context) {
+    const cwd = context.worktree || context.directory
+    const target = args.target || "."
+    const fix = args.fix ?? false
+    const detected = args.linter || detectLinter(cwd)
+
+    const command = buildLintCommand(detected, target, fix)
+    return JSON.stringify({
+      success: true,
+      linter: detected,
+      command,
+      instructions: `Run this command:\n\n${command}`,
+    })
+  },
+})
+
+function detectLinter(cwd: string): Linter {
+  if (fs.existsSync(path.join(cwd, "biome.json")) || fs.existsSync(path.join(cwd, "biome.jsonc"))) {
+    return "biome"
+  }
+
+  const eslintConfigs = [
+    ".eslintrc.json",
+    ".eslintrc.js",
+    ".eslintrc.cjs",
+    "eslint.config.js",
+    "eslint.config.mjs",
+  ]
+  if (eslintConfigs.some((name) => fs.existsSync(path.join(cwd, name)))) {
+    return "eslint"
+  }
+
+  const pyprojectPath = path.join(cwd, "pyproject.toml")
+  if (fs.existsSync(pyprojectPath)) {
+    try {
+      const content = fs.readFileSync(pyprojectPath, "utf-8")
+      if (content.includes("ruff")) return "ruff"
+    } catch {
+      // ignore read errors and keep fallback logic
+    }
+  }
+
+  if (fs.existsSync(path.join(cwd, ".golangci.yml")) || fs.existsSync(path.join(cwd, ".golangci.yaml"))) {
+    return "golangci-lint"
+  }
+
+  return "eslint"
+}
+
+function buildLintCommand(linter: Linter, target: string, fix: boolean): string {
+  if (linter === "biome") return `npx @biomejs/biome lint${fix ? " --write" : ""} ${target}`
+  if (linter === "eslint") return `npx eslint${fix ? " --fix" : ""} ${target}`
+  if (linter === "ruff") return `ruff check${fix ? " --fix" : ""} ${target}`
+  if (linter === "pylint") return `pylint ${target}`
+  return `golangci-lint run ${target}`
+}