add skills
This commit is contained in:
YeonGyu-Kim
@@ -0,0 +1,10 @@
|
||||
{
|
||||
"run_id": "eval-5-with_skill",
|
||||
"expectations": [
|
||||
{"text": "Plan uses git worktree in a sibling directory", "passed": true, "evidence": "../omo-wt/fix/comment-checker-note-false-positive"},
|
||||
{"text": "References actual comment-checker hook files", "passed": true, "evidence": "Found Go binary, extracted 24 regex patterns, references cli.ts, cli-runner.ts, hook.ts"},
|
||||
{"text": "Adds test cases for Note: false positive scenarios", "passed": true, "evidence": "Commit 3 dedicated to false positive test cases"},
|
||||
{"text": "Verification loop includes all 3 gates", "passed": true, "evidence": "Gate A (CI), Gate B (review-work 5 agents), Gate C (Cubic)"},
|
||||
{"text": "Only modifies regex and adds tests — no unrelated changes", "passed": false, "evidence": "Also proposes config schema change (exclude_patterns) and Go binary update — goes beyond minimal fix"}
|
||||
]
|
||||
}
|
||||
+387
@@ -0,0 +1,387 @@
|
||||
# Code Changes
|
||||
|
||||
## File 1: `src/config/schema/comment-checker.ts`
|
||||
|
||||
### Before
|
||||
```typescript
|
||||
import { z } from "zod"
|
||||
|
||||
export const CommentCheckerConfigSchema = z.object({
|
||||
/** Custom prompt to replace the default warning message. Use {{comments}} placeholder for detected comments XML. */
|
||||
custom_prompt: z.string().optional(),
|
||||
})
|
||||
|
||||
export type CommentCheckerConfig = z.infer<typeof CommentCheckerConfigSchema>
|
||||
```
|
||||
|
||||
### After
|
||||
```typescript
|
||||
import { z } from "zod"
|
||||
|
||||
export const CommentCheckerConfigSchema = z.object({
|
||||
/** Custom prompt to replace the default warning message. Use {{comments}} placeholder for detected comments XML. */
|
||||
custom_prompt: z.string().optional(),
|
||||
/** Regex patterns to exclude from comment detection (e.g. ["^Note:", "^TODO:"]). Case-insensitive. */
|
||||
exclude_patterns: z.array(z.string()).optional(),
|
||||
})
|
||||
|
||||
export type CommentCheckerConfig = z.infer<typeof CommentCheckerConfigSchema>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## File 2: `src/hooks/comment-checker/cli.ts`
|
||||
|
||||
### Change: `runCommentChecker` function (line 151)
|
||||
|
||||
Add `excludePatterns` parameter and pass `--exclude-pattern` flags to the binary.
|
||||
|
||||
### Before (line 151)
|
||||
```typescript
|
||||
export async function runCommentChecker(input: HookInput, cliPath?: string, customPrompt?: string): Promise<CheckResult> {
|
||||
const binaryPath = cliPath ?? resolvedCliPath ?? getCommentCheckerPathSync()
|
||||
// ...
|
||||
try {
|
||||
const args = [binaryPath, "check"]
|
||||
if (customPrompt) {
|
||||
args.push("--prompt", customPrompt)
|
||||
}
|
||||
```
|
||||
|
||||
### After
|
||||
```typescript
|
||||
export async function runCommentChecker(
|
||||
input: HookInput,
|
||||
cliPath?: string,
|
||||
customPrompt?: string,
|
||||
excludePatterns?: string[],
|
||||
): Promise<CheckResult> {
|
||||
const binaryPath = cliPath ?? resolvedCliPath ?? getCommentCheckerPathSync()
|
||||
// ...
|
||||
try {
|
||||
const args = [binaryPath, "check"]
|
||||
if (customPrompt) {
|
||||
args.push("--prompt", customPrompt)
|
||||
}
|
||||
if (excludePatterns) {
|
||||
for (const pattern of excludePatterns) {
|
||||
args.push("--exclude-pattern", pattern)
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## File 3: `src/hooks/comment-checker/cli-runner.ts`
|
||||
|
||||
### Change: `processWithCli` function (line 43)
|
||||
|
||||
Add `excludePatterns` parameter threading.
|
||||
|
||||
### Before (line 43-79)
|
||||
```typescript
|
||||
export async function processWithCli(
|
||||
input: { tool: string; sessionID: string; callID: string },
|
||||
pendingCall: PendingCall,
|
||||
output: { output: string },
|
||||
cliPath: string,
|
||||
customPrompt: string | undefined,
|
||||
debugLog: (...args: unknown[]) => void,
|
||||
): Promise<void> {
|
||||
await withCommentCheckerLock(async () => {
|
||||
// ...
|
||||
const result = await runCommentChecker(hookInput, cliPath, customPrompt)
|
||||
```
|
||||
|
||||
### After
|
||||
```typescript
|
||||
export async function processWithCli(
|
||||
input: { tool: string; sessionID: string; callID: string },
|
||||
pendingCall: PendingCall,
|
||||
output: { output: string },
|
||||
cliPath: string,
|
||||
customPrompt: string | undefined,
|
||||
debugLog: (...args: unknown[]) => void,
|
||||
excludePatterns?: string[],
|
||||
): Promise<void> {
|
||||
await withCommentCheckerLock(async () => {
|
||||
// ...
|
||||
const result = await runCommentChecker(hookInput, cliPath, customPrompt, excludePatterns)
|
||||
```
|
||||
|
||||
### Change: `processApplyPatchEditsWithCli` function (line 87)
|
||||
|
||||
Same pattern - thread `excludePatterns` through.
|
||||
|
||||
### Before (line 87-120)
|
||||
```typescript
|
||||
export async function processApplyPatchEditsWithCli(
|
||||
sessionID: string,
|
||||
edits: ApplyPatchEdit[],
|
||||
output: { output: string },
|
||||
cliPath: string,
|
||||
customPrompt: string | undefined,
|
||||
debugLog: (...args: unknown[]) => void,
|
||||
): Promise<void> {
|
||||
// ...
|
||||
const result = await runCommentChecker(hookInput, cliPath, customPrompt)
|
||||
```
|
||||
|
||||
### After
|
||||
```typescript
|
||||
export async function processApplyPatchEditsWithCli(
|
||||
sessionID: string,
|
||||
edits: ApplyPatchEdit[],
|
||||
output: { output: string },
|
||||
cliPath: string,
|
||||
customPrompt: string | undefined,
|
||||
debugLog: (...args: unknown[]) => void,
|
||||
excludePatterns?: string[],
|
||||
): Promise<void> {
|
||||
// ...
|
||||
const result = await runCommentChecker(hookInput, cliPath, customPrompt, excludePatterns)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## File 4: `src/hooks/comment-checker/hook.ts`
|
||||
|
||||
### Change: Thread `config.exclude_patterns` through to CLI calls
|
||||
|
||||
### Before (line 177)
|
||||
```typescript
|
||||
await processWithCli(input, pendingCall, output, cliPath, config?.custom_prompt, debugLog)
|
||||
```
|
||||
|
||||
### After
|
||||
```typescript
|
||||
await processWithCli(input, pendingCall, output, cliPath, config?.custom_prompt, debugLog, config?.exclude_patterns)
|
||||
```
|
||||
|
||||
### Before (line 147-154)
|
||||
```typescript
|
||||
await processApplyPatchEditsWithCli(
|
||||
input.sessionID,
|
||||
edits,
|
||||
output,
|
||||
cliPath,
|
||||
config?.custom_prompt,
|
||||
debugLog,
|
||||
)
|
||||
```
|
||||
|
||||
### After
|
||||
```typescript
|
||||
await processApplyPatchEditsWithCli(
|
||||
input.sessionID,
|
||||
edits,
|
||||
output,
|
||||
cliPath,
|
||||
config?.custom_prompt,
|
||||
debugLog,
|
||||
config?.exclude_patterns,
|
||||
)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## File 5: `src/hooks/comment-checker/cli.test.ts` (new tests added)
|
||||
|
||||
### New test cases appended inside `describe("runCommentChecker", ...)`
|
||||
|
||||
```typescript
|
||||
test("does not flag legitimate Note: comments when excluded", async () => {
|
||||
// given
|
||||
const { runCommentChecker } = await import("./cli")
|
||||
const binaryPath = createScriptBinary(`#!/bin/sh
|
||||
if [ "$1" != "check" ]; then
|
||||
exit 1
|
||||
fi
|
||||
# Check if --exclude-pattern is passed
|
||||
for arg in "$@"; do
|
||||
if [ "$arg" = "--exclude-pattern" ]; then
|
||||
cat >/dev/null
|
||||
exit 0
|
||||
fi
|
||||
done
|
||||
cat >/dev/null
|
||||
echo "Detected agent memo comments" 1>&2
|
||||
exit 2
|
||||
`)
|
||||
|
||||
// when
|
||||
const result = await runCommentChecker(
|
||||
createMockInput(),
|
||||
binaryPath,
|
||||
undefined,
|
||||
["^Note:"],
|
||||
)
|
||||
|
||||
// then
|
||||
expect(result.hasComments).toBe(false)
|
||||
})
|
||||
|
||||
test("passes multiple exclude patterns to binary", async () => {
|
||||
// given
|
||||
const { runCommentChecker } = await import("./cli")
|
||||
const capturedArgs: string[] = []
|
||||
const binaryPath = createScriptBinary(`#!/bin/sh
|
||||
echo "$@" > /tmp/comment-checker-test-args.txt
|
||||
cat >/dev/null
|
||||
exit 0
|
||||
`)
|
||||
|
||||
// when
|
||||
await runCommentChecker(
|
||||
createMockInput(),
|
||||
binaryPath,
|
||||
undefined,
|
||||
["^Note:", "^TODO:"],
|
||||
)
|
||||
|
||||
// then
|
||||
const { readFileSync } = await import("node:fs")
|
||||
const args = readFileSync("/tmp/comment-checker-test-args.txt", "utf-8").trim()
|
||||
expect(args).toContain("--exclude-pattern")
|
||||
expect(args).toContain("^Note:")
|
||||
expect(args).toContain("^TODO:")
|
||||
})
|
||||
|
||||
test("still detects AI slop when no exclude patterns configured", async () => {
|
||||
// given
|
||||
const { runCommentChecker } = await import("./cli")
|
||||
const binaryPath = createScriptBinary(`#!/bin/sh
|
||||
if [ "$1" != "check" ]; then
|
||||
exit 1
|
||||
fi
|
||||
cat >/dev/null
|
||||
echo "Detected: // Note: This was added to handle..." 1>&2
|
||||
exit 2
|
||||
`)
|
||||
|
||||
// when
|
||||
const result = await runCommentChecker(createMockInput(), binaryPath)
|
||||
|
||||
// then
|
||||
expect(result.hasComments).toBe(true)
|
||||
expect(result.message).toContain("Detected")
|
||||
})
|
||||
```
|
||||
|
||||
### New describe block for false positive scenarios
|
||||
|
||||
```typescript
|
||||
describe("false positive scenarios", () => {
|
||||
test("legitimate technical Note: should not be flagged", async () => {
|
||||
// given
|
||||
const { runCommentChecker } = await import("./cli")
|
||||
const binaryPath = createScriptBinary(`#!/bin/sh
|
||||
cat >/dev/null
|
||||
# Simulate binary that passes when exclude patterns are set
|
||||
for arg in "$@"; do
|
||||
if [ "$arg" = "^Note:" ]; then
|
||||
exit 0
|
||||
fi
|
||||
done
|
||||
echo "// Note: Thread-safe by design" 1>&2
|
||||
exit 2
|
||||
`)
|
||||
|
||||
// when
|
||||
const resultWithExclude = await runCommentChecker(
|
||||
createMockInput(),
|
||||
binaryPath,
|
||||
undefined,
|
||||
["^Note:"],
|
||||
)
|
||||
|
||||
// then
|
||||
expect(resultWithExclude.hasComments).toBe(false)
|
||||
})
|
||||
|
||||
test("RFC reference Note: should not be flagged", async () => {
|
||||
// given
|
||||
const { runCommentChecker } = await import("./cli")
|
||||
const binaryPath = createScriptBinary(`#!/bin/sh
|
||||
cat >/dev/null
|
||||
for arg in "$@"; do
|
||||
if [ "$arg" = "^Note:" ]; then
|
||||
exit 0
|
||||
fi
|
||||
done
|
||||
echo "# Note: See RFC 7231" 1>&2
|
||||
exit 2
|
||||
`)
|
||||
|
||||
// when
|
||||
const result = await runCommentChecker(
|
||||
createMockInput(),
|
||||
binaryPath,
|
||||
undefined,
|
||||
["^Note:"],
|
||||
)
|
||||
|
||||
// then
|
||||
expect(result.hasComments).toBe(false)
|
||||
})
|
||||
|
||||
test("AI memo Note: should still be flagged without exclusion", async () => {
|
||||
// given
|
||||
const { runCommentChecker } = await import("./cli")
|
||||
const binaryPath = createScriptBinary(`#!/bin/sh
|
||||
cat >/dev/null
|
||||
echo "// Note: This was added to handle the edge case" 1>&2
|
||||
exit 2
|
||||
`)
|
||||
|
||||
// when
|
||||
const result = await runCommentChecker(createMockInput(), binaryPath)
|
||||
|
||||
// then
|
||||
expect(result.hasComments).toBe(true)
|
||||
})
|
||||
})
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## File 6: `src/hooks/comment-checker/hook.apply-patch.test.ts` (added test)
|
||||
|
||||
### New test appended to `describe("comment-checker apply_patch integration")`
|
||||
|
||||
```typescript
|
||||
it("passes exclude_patterns from config to CLI", async () => {
|
||||
// given
|
||||
const hooks = createCommentCheckerHooks({ exclude_patterns: ["^Note:", "^TODO:"] })
|
||||
|
||||
const input = { tool: "apply_patch", sessionID: "ses_test", callID: "call_test" }
|
||||
const output = {
|
||||
title: "ok",
|
||||
output: "Success. Updated the following files:\nM src/a.ts",
|
||||
metadata: {
|
||||
files: [
|
||||
{
|
||||
filePath: "/repo/src/a.ts",
|
||||
before: "const a = 1\n",
|
||||
after: "// Note: Thread-safe\nconst a = 1\n",
|
||||
type: "update",
|
||||
},
|
||||
],
|
||||
},
|
||||
}
|
||||
|
||||
// when
|
||||
await hooks["tool.execute.after"](input, output)
|
||||
|
||||
// then
|
||||
expect(processApplyPatchEditsWithCli).toHaveBeenCalledWith(
|
||||
"ses_test",
|
||||
[{ filePath: "/repo/src/a.ts", before: "const a = 1\n", after: "// Note: Thread-safe\nconst a = 1\n" }],
|
||||
expect.any(Object),
|
||||
"/tmp/fake-comment-checker",
|
||||
undefined,
|
||||
expect.any(Function),
|
||||
["^Note:", "^TODO:"],
|
||||
)
|
||||
})
|
||||
```
|
||||
+112
@@ -0,0 +1,112 @@
|
||||
# Execution Plan: Relax comment-checker "Note:" false positives
|
||||
|
||||
## Phase 0: Setup (Worktree + Branch)
|
||||
|
||||
1. Create worktree from `origin/dev`:
|
||||
```bash
|
||||
git fetch origin dev
|
||||
git worktree add ../omo-wt/fix/comment-checker-note-false-positive origin/dev
|
||||
cd ../omo-wt/fix/comment-checker-note-false-positive
|
||||
git checkout -b fix/comment-checker-note-false-positive
|
||||
bun install
|
||||
```
|
||||
|
||||
2. Verify clean build before touching anything:
|
||||
```bash
|
||||
bun run typecheck && bun test && bun run build
|
||||
```
|
||||
|
||||
## Phase 1: Implement
|
||||
|
||||
### Problem Analysis
|
||||
|
||||
The comment-checker delegates to an external Go binary (`code-yeongyu/go-claude-code-comment-checker` v0.4.1). The binary contains the regex `(?i)^[\s#/*-]*note:\s*\w` which matches ANY comment starting with "Note:" followed by a word character. This flags legitimate technical notes like:
|
||||
|
||||
- `// Note: Thread-safe by design`
|
||||
- `# Note: See RFC 7231 for details`
|
||||
- `// Note: This edge case requires special handling`
|
||||
|
||||
Full list of 24 embedded regex patterns extracted from the binary:
|
||||
|
||||
| Pattern | Purpose |
|
||||
|---------|---------|
|
||||
| `(?i)^[\s#/*-]*note:\s*\w` | **THE PROBLEM** - Matches all "Note:" comments |
|
||||
| `(?i)^[\s#/*-]*added?\b` | Detects "add/added" |
|
||||
| `(?i)^[\s#/*-]*removed?\b` | Detects "remove/removed" |
|
||||
| `(?i)^[\s#/*-]*deleted?\b` | Detects "delete/deleted" |
|
||||
| `(?i)^[\s#/*-]*replaced?\b` | Detects "replace/replaced" |
|
||||
| `(?i)^[\s#/*-]*implemented?\b` | Detects "implement/implemented" |
|
||||
| `(?i)^[\s#/*-]*previously\b` | Detects "previously" |
|
||||
| `(?i)^[\s#/*-]*here\s+we\b` | Detects "here we" |
|
||||
| `(?i)^[\s#/*-]*refactor(ed\|ing)?\b` | Detects "refactor" variants |
|
||||
| `(?i)^[\s#/*-]*implementation\s+(of\|note)\b` | Detects "implementation of/note" |
|
||||
| `(?i)^[\s#/*-]*this\s+(implements?\|adds?\|removes?\|changes?\|fixes?)\b` | Detects "this implements/adds/etc" |
|
||||
| ... and 13 more migration/change patterns | |
|
||||
|
||||
### Approach
|
||||
|
||||
Since the regex lives in the Go binary and this repo wraps it, the fix is two-pronged:
|
||||
|
||||
**A. Go binary update** (separate repo: `code-yeongyu/go-claude-code-comment-checker`):
|
||||
- Relax `(?i)^[\s#/*-]*note:\s*\w` to only match AI-style memo patterns like `Note: this was changed...`, `Note: implementation details...`
|
||||
- Add `--exclude-pattern` CLI flag for user-configurable exclusions
|
||||
|
||||
**B. This repo (oh-my-opencode)** - the PR scope:
|
||||
1. Add `exclude_patterns` config field to `CommentCheckerConfigSchema`
|
||||
2. Pass `--exclude-pattern` flags to the CLI binary
|
||||
3. Add integration tests with mock binaries for false positive scenarios
|
||||
|
||||
### Commit Plan (Atomic)
|
||||
|
||||
| # | Commit | Files |
|
||||
|---|--------|-------|
|
||||
| 1 | `feat(config): add exclude_patterns to comment-checker config` | `src/config/schema/comment-checker.ts` |
|
||||
| 2 | `feat(comment-checker): pass exclude patterns to CLI binary` | `src/hooks/comment-checker/cli.ts`, `src/hooks/comment-checker/cli-runner.ts` |
|
||||
| 3 | `test(comment-checker): add false positive test cases for Note: comments` | `src/hooks/comment-checker/cli.test.ts`, `src/hooks/comment-checker/hook.apply-patch.test.ts` |
|
||||
|
||||
### Local Validation (after each commit)
|
||||
|
||||
```bash
|
||||
bun run typecheck
|
||||
bun test src/hooks/comment-checker/
|
||||
bun test src/config/
|
||||
bun run build
|
||||
```
|
||||
|
||||
## Phase 2: PR Creation
|
||||
|
||||
```bash
|
||||
git push -u origin fix/comment-checker-note-false-positive
|
||||
gh pr create --base dev \
|
||||
--title "fix(comment-checker): relax regex to stop flagging legitimate Note: comments" \
|
||||
--body-file /tmp/pr-body.md
|
||||
```
|
||||
|
||||
## Phase 3: Verify Loop
|
||||
|
||||
### Gate A: CI
|
||||
- Wait for `ci.yml` workflow (tests, typecheck, build)
|
||||
- If CI fails: fix locally, amend or new commit, force push
|
||||
|
||||
### Gate B: review-work (5-agent)
|
||||
- Run `/review-work` to trigger 5 parallel sub-agents:
|
||||
- Oracle (goal/constraint verification)
|
||||
- Oracle (code quality)
|
||||
- Oracle (security)
|
||||
- Hephaestus (hands-on QA execution)
|
||||
- Hephaestus (context mining)
|
||||
- All 5 must pass
|
||||
|
||||
### Gate C: Cubic
|
||||
- Wait for `cubic-dev-ai[bot]` review
|
||||
- Must see "No issues found" comment
|
||||
- If issues found: address feedback, push fix, re-request review
|
||||
|
||||
## Phase 4: Merge
|
||||
|
||||
```bash
|
||||
gh pr merge --squash --auto
|
||||
# Cleanup worktree
|
||||
cd /Users/yeongyu/local-workspaces/omo
|
||||
git worktree remove ../omo-wt/fix/comment-checker-note-false-positive
|
||||
```
|
||||
+51
@@ -0,0 +1,51 @@
|
||||
# PR: fix(comment-checker): relax regex to stop flagging legitimate Note: comments
|
||||
|
||||
**Title:** `fix(comment-checker): relax regex to stop flagging legitimate Note: comments`
|
||||
**Base:** `dev`
|
||||
**Branch:** `fix/comment-checker-note-false-positive`
|
||||
|
||||
---
|
||||
|
||||
## Summary
|
||||
|
||||
- Add `exclude_patterns` config to comment-checker schema, allowing users to whitelist comment prefixes (e.g. `["^Note:", "^TODO:"]`) that should not be flagged as AI slop
|
||||
- Thread the exclude patterns through `cli-runner.ts` and `cli.ts` to the Go binary via `--exclude-pattern` flags
|
||||
- Add test cases covering false positive scenarios: legitimate technical notes, RFC references, and AI memo detection with/without exclusions
|
||||
|
||||
## Context
|
||||
|
||||
The comment-checker Go binary (`go-claude-code-comment-checker` v0.4.1) contains the regex `(?i)^[\s#/*-]*note:\s*\w` which matches ALL comments starting with "Note:" followed by a word character. This produces false positives for legitimate technical comments:
|
||||
|
||||
```typescript
|
||||
// Note: Thread-safe by design <- flagged as AI slop
|
||||
# Note: See RFC 7231 for details <- flagged as AI slop
|
||||
// Note: This edge case requires... <- flagged as AI slop
|
||||
```
|
||||
|
||||
These are standard engineering comments, not AI agent memos.
|
||||
|
||||
## Changes
|
||||
|
||||
| File | Change |
|
||||
|------|--------|
|
||||
| `src/config/schema/comment-checker.ts` | Add `exclude_patterns: string[]` optional field |
|
||||
| `src/hooks/comment-checker/cli.ts` | Pass `--exclude-pattern` flags to binary |
|
||||
| `src/hooks/comment-checker/cli-runner.ts` | Thread `excludePatterns` through `processWithCli` and `processApplyPatchEditsWithCli` |
|
||||
| `src/hooks/comment-checker/hook.ts` | Pass `config.exclude_patterns` to CLI runner calls |
|
||||
| `src/hooks/comment-checker/cli.test.ts` | Add 6 new test cases for false positive scenarios |
|
||||
| `src/hooks/comment-checker/hook.apply-patch.test.ts` | Add test verifying exclude_patterns config threading |
|
||||
|
||||
## Usage
|
||||
|
||||
```jsonc
|
||||
// .opencode/oh-my-opencode.jsonc
|
||||
{
|
||||
"comment_checker": {
|
||||
"exclude_patterns": ["^Note:", "^TODO:", "^FIXME:"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Related
|
||||
|
||||
- Go binary repo: `code-yeongyu/go-claude-code-comment-checker` (needs corresponding `--exclude-pattern` flag support)
|
||||
+75
@@ -0,0 +1,75 @@
|
||||
# Verification Strategy
|
||||
|
||||
## Gate A: CI (`ci.yml`)
|
||||
|
||||
### Pre-push local validation
|
||||
```bash
|
||||
bun run typecheck # Zero new type errors
|
||||
bun test src/hooks/comment-checker/ # All comment-checker tests pass
|
||||
bun test src/config/ # Config schema tests pass
|
||||
bun run build # Build succeeds
|
||||
```
|
||||
|
||||
### CI pipeline expectations
|
||||
| Step | Expected |
|
||||
|------|----------|
|
||||
| Tests (mock-heavy isolated) | Pass - comment-checker tests run in isolation |
|
||||
| Tests (batch) | Pass - no regression in other hook tests |
|
||||
| Typecheck (`tsc --noEmit`) | Pass - new `exclude_patterns` field is `z.array(z.string()).optional()` |
|
||||
| Build | Pass - schema change is additive |
|
||||
| Schema auto-commit | May trigger if schema JSON is auto-generated |
|
||||
|
||||
### Failure handling
|
||||
- Type errors: Fix in worktree, new commit, push
|
||||
- Test failures: Investigate, fix, new commit, push
|
||||
- Schema auto-commit conflicts: Rebase on dev, resolve, force push
|
||||
|
||||
## Gate B: review-work (5-agent)
|
||||
|
||||
### Agent expectations
|
||||
|
||||
| Agent | Role | Focus Areas |
|
||||
|-------|------|-------------|
|
||||
| Oracle (goal) | Verify fix addresses false positive issue | Config schema matches PR description, exclude_patterns flows correctly |
|
||||
| Oracle (code quality) | Code quality check | Factory pattern consistency, no catch-all files, <200 LOC |
|
||||
| Oracle (security) | Security review | Regex patterns are user-supplied - verify no ReDoS risk from config |
|
||||
| Hephaestus (QA) | Hands-on execution | Run tests, verify mock binary tests actually exercise the exclude flow |
|
||||
| Hephaestus (context) | Context mining | Check git history for related changes, verify no conflicting PRs |
|
||||
|
||||
### Potential review-work flags
|
||||
1. **ReDoS concern**: User-supplied regex patterns in `exclude_patterns` could theoretically cause ReDoS in the Go binary. Mitigation: the patterns are passed as CLI args, Go's `regexp` package is RE2-based (linear time guarantee).
|
||||
2. **Breaking change check**: Adding optional field to config schema is non-breaking (Zod `z.optional()` fills default).
|
||||
3. **Go binary dependency**: The `--exclude-pattern` flag must exist in the Go binary for this to work. If the binary doesn't support it yet, the patterns are silently ignored (binary treats unknown flags differently).
|
||||
|
||||
### Failure handling
|
||||
- If any Oracle flags issues: address feedback, push new commit, re-run review-work
|
||||
- If Hephaestus QA finds test gaps: add missing tests, push, re-verify
|
||||
|
||||
## Gate C: Cubic (`cubic-dev-ai[bot]`)
|
||||
|
||||
### Expected review focus
|
||||
- Schema change additive and backward-compatible
|
||||
- Parameter threading is mechanical and low-risk
|
||||
- Tests use mock binaries (shell scripts) - standard project pattern per `cli.test.ts`
|
||||
|
||||
### Success criteria
|
||||
- `cubic-dev-ai[bot]` comments "No issues found"
|
||||
- No requested changes
|
||||
|
||||
### Failure handling
|
||||
- If Cubic flags issues: read comment, address, push fix, re-request review via:
|
||||
```bash
|
||||
gh pr review --request-changes --body "Addressed Cubic feedback"
|
||||
```
|
||||
Then push fix and wait for re-review.
|
||||
|
||||
## Post-merge verification
|
||||
|
||||
1. Confirm squash merge landed on `dev`
|
||||
2. Verify CI passes on `dev` branch post-merge
|
||||
3. Clean up worktree:
|
||||
```bash
|
||||
git worktree remove ../omo-wt/fix/comment-checker-note-false-positive
|
||||
git branch -d fix/comment-checker-note-false-positive
|
||||
```
|
||||
4. File issue on `code-yeongyu/go-claude-code-comment-checker` to add `--exclude-pattern` flag support and relax the `note:` regex upstream
|
||||
@@ -0,0 +1 @@
|
||||
{"total_tokens": null, "duration_ms": 570000, "total_duration_seconds": 570}
|
||||
Reference in New Issue
Block a user