claudecode-omc 5.6.4 → 5.6.6

package/bundled/upstream/anthropic-skills/skills/claude-api/typescript/agent-sdk/patterns.md

@@ -1,209 +0,0 @@
-# Agent SDK Patterns — TypeScript
-
-## Basic Agent
-
-```typescript
-import { query } from "@anthropic-ai/claude-agent-sdk";
-
-async function main() {
-  for await (const message of query({
-    prompt: "Explain what this repository does",
-    options: {
-      cwd: "/path/to/project",
-      allowedTools: ["Read", "Glob", "Grep"],
-    },
-  })) {
-    if ("result" in message) {
-      console.log(message.result);
-    }
-  }
-}
-
-main();
-```
-
----
-
-## Hooks
-
-### After Tool Use Hook
-
-```typescript
-import { query, HookCallback } from "@anthropic-ai/claude-agent-sdk";
-import { appendFileSync } from "fs";
-
-const logFileChange: HookCallback = async (input) => {
-  const filePath = (input as any).tool_input?.file_path ?? "unknown";
-  appendFileSync(
-    "./audit.log",
-    `${new Date().toISOString()}: modified ${filePath}\n`,
-  );
-  return {};
-};
-
-for await (const message of query({
-  prompt: "Refactor utils.py to improve readability",
-  options: {
-    allowedTools: ["Read", "Edit", "Write"],
-    permissionMode: "acceptEdits",
-    hooks: {
-      PostToolUse: [{ matcher: "Edit|Write", hooks: [logFileChange] }],
-    },
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
----
-
-## Subagents
-
-```typescript
-import { query } from "@anthropic-ai/claude-agent-sdk";
-
-for await (const message of query({
-  prompt: "Use the code-reviewer agent to review this codebase",
-  options: {
-    allowedTools: ["Read", "Glob", "Grep", "Agent"],
-    agents: {
-      "code-reviewer": {
-        description: "Expert code reviewer for quality and security reviews.",
-        prompt: "Analyze code quality and suggest improvements.",
-        tools: ["Read", "Glob", "Grep"],
-      },
-    },
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
----
-
-## MCP Server Integration
-
-### Browser Automation (Playwright)
-
-```typescript
-for await (const message of query({
-  prompt: "Open example.com and describe what you see",
-  options: {
-    mcpServers: {
-      playwright: { command: "npx", args: ["@playwright/mcp@latest"] },
-    },
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
----
-
-## Session Resumption
-
-```typescript
-import { query } from "@anthropic-ai/claude-agent-sdk";
-
-let sessionId: string | undefined;
-
-// First query: capture the session ID
-for await (const message of query({
-  prompt: "Read the authentication module",
-  options: { allowedTools: ["Read", "Glob"] },
-})) {
-  if (message.type === "system" && message.subtype === "init") {
-    sessionId = message.session_id;
-  }
-}
-
-// Resume with full context from the first query
-for await (const message of query({
-  prompt: "Now find all places that call it",
-  options: { resume: sessionId },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```
-
----
-
-## Session History
-
-```typescript
-import { listSessions, getSessionMessages, getSessionInfo } from "@anthropic-ai/claude-agent-sdk";
-
-async function main() {
-  // List past sessions (supports pagination via limit/offset)
-  const sessions = await listSessions();
-  for (const session of sessions) {
-    console.log(`Session ${session.sessionId} in ${session.cwd} (tag: ${session.tag})`);
-  }
-
-  // Get metadata for a single session
-  if (sessions.length > 0) {
-    const info = await getSessionInfo(sessions[0].sessionId);
-    console.log(`Created: ${info.createdAt}, Tag: ${info.tag}`);
-  }
-
-  // Retrieve messages from the most recent session
-  if (sessions.length > 0) {
-    const messages = await getSessionMessages(sessions[0].sessionId, { limit: 50 });
-    for (const msg of messages) {
-      console.log(msg);
-    }
-  }
-}
-
-main();
-```
-
----
-
-## Session Mutations
-
-```typescript
-import { renameSession, tagSession, forkSession } from "@anthropic-ai/claude-agent-sdk";
-
-async function main() {
-  const sessionId = "your-session-id";
-
-  // Rename a session
-  await renameSession(sessionId, "Refactoring auth module");
-
-  // Tag a session for filtering
-  await tagSession(sessionId, "experiment-v2");
-
-  // Clear a tag
-  await tagSession(sessionId, null);
-
-  // Fork a conversation to branch from a point
-  const { sessionId: forkedId } = await forkSession(sessionId);
-  console.log(`Forked session: ${forkedId}`);
-}
-
-main();
-```
-
----
-
-## Custom System Prompt
-
-```typescript
-import { query } from "@anthropic-ai/claude-agent-sdk";
-
-for await (const message of query({
-  prompt: "Review this code",
-  options: {
-    allowedTools: ["Read", "Glob", "Grep"],
-    systemPrompt: `You are a senior code reviewer focused on:
-1. Security vulnerabilities
-2. Performance issues
-3. Code maintainability
-
-Always provide specific line numbers and suggestions for improvement.`,
-  },
-})) {
-  if ("result" in message) console.log(message.result);
-}
-```

package/bundled/upstream/ecc/commands/agent-sort.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the agent-sort skill. Prefer the skill directly.
----
-
-# Agent Sort (Legacy Shim)
-
-Use this only if you still invoke `/agent-sort`. The maintained workflow lives in `skills/agent-sort/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `agent-sort` skill directly.
-- Keep this file only as a compatibility entry point.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `agent-sort` skill.
-- Classify ECC surfaces with concrete repo evidence.
-- Keep the result to DAILY vs LIBRARY.
-- If an install change is needed afterward, hand off to `configure-ecc` instead of re-implementing install logic here.

package/bundled/upstream/ecc/commands/claw.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the nanoclaw-repl skill. Prefer the skill directly.
----
-
-# Claw Command (Legacy Shim)
-
-Use this only if you still reach for `/claw` from muscle memory. The maintained implementation lives in `skills/nanoclaw-repl/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `nanoclaw-repl` skill directly.
-- Keep this file only as a compatibility entry point while command-first usage is retired.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `nanoclaw-repl` skill and keep the response focused on operating or extending `scripts/claw.js`.
-- If the user wants to run it, use `node scripts/claw.js` or `npm run claw`.
-- If the user wants to extend it, preserve the zero-dependency and markdown-backed session model.
-- If the request is really about long-running orchestration rather than NanoClaw itself, redirect to `dmux-workflows` or `autonomous-agent-harness`.

package/bundled/upstream/ecc/commands/context-budget.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the context-budget skill. Prefer the skill directly.
----
-
-# Context Budget Optimizer (Legacy Shim)
-
-Use this only if you still invoke `/context-budget`. The maintained workflow lives in `skills/context-budget/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `context-budget` skill directly.
-- Keep this file only as a compatibility entry point.
-
-## Arguments
-
-$ARGUMENTS
-
-## Delegation
-
-Apply the `context-budget` skill.
-- Pass through `--verbose` if the user supplied it.
-- Assume a 200K context window unless the user specified otherwise.
-- Return the skill's inventory, issue detection, and prioritized savings report without re-implementing the scan here.

package/bundled/upstream/ecc/commands/devfleet.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the claude-devfleet skill. Prefer the skill directly.
----
-
-# DevFleet (Legacy Shim)
-
-Use this only if you still call `/devfleet`. The maintained workflow lives in `skills/claude-devfleet/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `claude-devfleet` skill directly.
-- Keep this file only as a compatibility entry point while command-first usage is retired.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `claude-devfleet` skill.
-- Plan from the user's description, show the DAG, and get approval before dispatch unless the user already said to proceed.
-- Prefer polling status over blocking waits for long missions.
-- Report mission IDs, files changed, failures, and next steps from structured mission reports.

package/bundled/upstream/ecc/commands/docs.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the documentation-lookup skill. Prefer the skill directly.
----
-
-# Docs Command (Legacy Shim)
-
-Use this only if you still reach for `/docs`. The maintained workflow lives in `skills/documentation-lookup/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `documentation-lookup` skill directly.
-- Keep this file only as a compatibility entry point.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `documentation-lookup` skill.
-- If the library or the question is missing, ask for the missing part.
-- Use live documentation through Context7 instead of training data.
-- Return only the current answer and the minimum code/example surface needed.

package/bundled/upstream/ecc/commands/e2e.md

@@ -1,268 +0,0 @@
----
-description: Legacy slash-entry shim for the e2e-testing skill. Prefer the skill directly.
----
-
-# E2E Command (Legacy Shim)
-
-Use this only if you still invoke `/e2e`. The maintained workflow lives in `skills/e2e-testing/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `e2e-testing` skill directly.
-- Keep this file only as a compatibility entry point.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `e2e-testing` skill.
-- Generate or update Playwright coverage for the requested user flow.
-- Run only the relevant tests unless the user explicitly asked for the entire suite.
-- Capture the usual artifacts and report failures, flake risk, and next fixes without duplicating the full skill body here.
-    await marketsPage.searchMarkets('xyznonexistentmarket123456')
-
-    // Verify empty state
-    await expect(page.locator('[data-testid="no-results"]')).toBeVisible()
-    await expect(page.locator('[data-testid="no-results"]')).toContainText(
-      /no.*results|no.*markets/i
-    )
-
-    const marketCount = await marketsPage.marketCards.count()
-    expect(marketCount).toBe(0)
-  })
-
-  test('can clear search and see all markets again', async ({ page }) => {
-    const marketsPage = new MarketsPage(page)
-    await marketsPage.goto()
-
-    // Initial market count
-    const initialCount = await marketsPage.marketCards.count()
-
-    // Perform search
-    await marketsPage.searchMarkets('trump')
-    await page.waitForLoadState('networkidle')
-
-    // Verify filtered results
-    const filteredCount = await marketsPage.marketCards.count()
-    expect(filteredCount).toBeLessThan(initialCount)
-
-    // Clear search
-    await marketsPage.searchInput.clear()
-    await page.waitForLoadState('networkidle')
-
-    // Verify all markets shown again
-    const finalCount = await marketsPage.marketCards.count()
-    expect(finalCount).toBe(initialCount)
-  })
-})
-```
-
-## Running Tests
-
-```bash
-# Run the generated test
-npx playwright test tests/e2e/markets/search-and-view.spec.ts
-
-Running 3 tests using 3 workers
-
-  ✓  [chromium] › search-and-view.spec.ts:5:3 › user can search markets and view details (4.2s)
-  ✓  [chromium] › search-and-view.spec.ts:52:3 › search with no results shows empty state (1.8s)
-  ✓  [chromium] › search-and-view.spec.ts:67:3 › can clear search and see all markets again (2.9s)
-
-  3 passed (9.1s)
-
-Artifacts generated:
-- artifacts/search-results.png
-- artifacts/market-details.png
-- playwright-report/index.html
-```
-
-## Test Report
-
-```
-╔══════════════════════════════════════════════════════════════╗
-║                    E2E Test Results                          ║
-╠══════════════════════════════════════════════════════════════╣
-║ Status:     PASS: ALL TESTS PASSED                              ║
-║ Total:      3 tests                                          ║
-║ Passed:     3 (100%)                                         ║
-║ Failed:     0                                                ║
-║ Flaky:      0                                                ║
-║ Duration:   9.1s                                             ║
-╚══════════════════════════════════════════════════════════════╝
-
-Artifacts:
- Screenshots: 2 files
- Videos: 0 files (only on failure)
- Traces: 0 files (only on failure)
- HTML Report: playwright-report/index.html
-
-View report: npx playwright show-report
-```
-
-PASS: E2E test suite ready for CI/CD integration!
-```
-
-## Test Artifacts
-
-When tests run, the following artifacts are captured:
-
-**On All Tests:**
-- HTML Report with timeline and results
-- JUnit XML for CI integration
-
-**On Failure Only:**
-- Screenshot of the failing state
-- Video recording of the test
-- Trace file for debugging (step-by-step replay)
-- Network logs
-- Console logs
-
-## Viewing Artifacts
-
-```bash
-# View HTML report in browser
-npx playwright show-report
-
-# View specific trace file
-npx playwright show-trace artifacts/trace-abc123.zip
-
-# Screenshots are saved in artifacts/ directory
-open artifacts/search-results.png
-```
-
-## Flaky Test Detection
-
-If a test fails intermittently:
-
-```
-WARNING:  FLAKY TEST DETECTED: tests/e2e/markets/trade.spec.ts
-
-Test passed 7/10 runs (70% pass rate)
-
-Common failure:
-"Timeout waiting for element '[data-testid="confirm-btn"]'"
-
-Recommended fixes:
-1. Add explicit wait: await page.waitForSelector('[data-testid="confirm-btn"]')
-2. Increase timeout: { timeout: 10000 }
-3. Check for race conditions in component
-4. Verify element is not hidden by animation
-
-Quarantine recommendation: Mark as test.fixme() until fixed
-```
-
-## Browser Configuration
-
-Tests run on multiple browsers by default:
-- PASS: Chromium (Desktop Chrome)
-- PASS: Firefox (Desktop)
-- PASS: WebKit (Desktop Safari)
-- PASS: Mobile Chrome (optional)
-
-Configure in `playwright.config.ts` to adjust browsers.
-
-## CI/CD Integration
-
-Add to your CI pipeline:
-
-```yaml
-# .github/workflows/e2e.yml
-- name: Install Playwright
-  run: npx playwright install --with-deps
-
-- name: Run E2E tests
-  run: npx playwright test
-
-- name: Upload artifacts
-  if: always()
-  uses: actions/upload-artifact@v3
-  with:
-    name: playwright-report
-    path: playwright-report/
-```
-
-## PMX-Specific Critical Flows
-
-For PMX, prioritize these E2E tests:
-
-**CRITICAL (Must Always Pass):**
-1. User can connect wallet
-2. User can browse markets
-3. User can search markets (semantic search)
-4. User can view market details
-5. User can place trade (with test funds)
-6. Market resolves correctly
-7. User can withdraw funds
-
-**IMPORTANT:**
-1. Market creation flow
-2. User profile updates
-3. Real-time price updates
-4. Chart rendering
-5. Filter and sort markets
-6. Mobile responsive layout
-
-## Best Practices
-
-**DO:**
-- PASS: Use Page Object Model for maintainability
-- PASS: Use data-testid attributes for selectors
-- PASS: Wait for API responses, not arbitrary timeouts
-- PASS: Test critical user journeys end-to-end
-- PASS: Run tests before merging to main
-- PASS: Review artifacts when tests fail
-
-**DON'T:**
-- FAIL: Use brittle selectors (CSS classes can change)
-- FAIL: Test implementation details
-- FAIL: Run tests against production
-- FAIL: Ignore flaky tests
-- FAIL: Skip artifact review on failures
-- FAIL: Test every edge case with E2E (use unit tests)
-
-## Important Notes
-
-**CRITICAL for PMX:**
-- E2E tests involving real money MUST run on testnet/staging only
-- Never run trading tests against production
-- Set `test.skip(process.env.NODE_ENV === 'production')` for financial tests
-- Use test wallets with small test funds only
-
-## Integration with Other Commands
-
-- Use `/plan` to identify critical journeys to test
-- Use `/tdd` for unit tests (faster, more granular)
-- Use `/e2e` for integration and user journey tests
-- Use `/code-review` to verify test quality
-
-## Related Agents
-
-This command invokes the `e2e-runner` agent provided by ECC.
-
-For manual installs, the source file lives at:
-`agents/e2e-runner.md`
-
-## Quick Commands
-
-```bash
-# Run all E2E tests
-npx playwright test
-
-# Run specific test file
-npx playwright test tests/e2e/markets/search.spec.ts
-
-# Run in headed mode (see browser)
-npx playwright test --headed
-
-# Debug test
-npx playwright test --debug
-
-# Generate test code
-npx playwright codegen http://localhost:3000
-
-# View report
-npx playwright show-report
-```

package/bundled/upstream/ecc/commands/eval.md

@@ -1,23 +0,0 @@
----
-description: Legacy slash-entry shim for the eval-harness skill. Prefer the skill directly.
----
-
-# Eval Command (Legacy Shim)
-
-Use this only if you still invoke `/eval`. The maintained workflow lives in `skills/eval-harness/SKILL.md`.
-
-## Canonical Surface
-
-- Prefer the `eval-harness` skill directly.
-- Keep this file only as a compatibility entry point.
-
-## Arguments
-
-`$ARGUMENTS`
-
-## Delegation
-
-Apply the `eval-harness` skill.
-- Support the same user intents as before: define, check, report, list, and cleanup.
-- Keep evals capability-first, regression-backed, and evidence-based.
-- Use the skill as the canonical evaluator instead of maintaining a separate command-specific playbook.