openclaw-node-harness 2.0.0

package/skills/cc-godmode/references/agents.md

@@ -0,0 +1,433 @@
+# Detailed Agent Specifications
+
+<details>
+<summary><strong>@researcher</strong> - Knowledge Discovery Specialist</summary>
+
+### Role
+Knowledge Discovery Specialist - expert in web research, documentation lookup, and technology evaluation.
+
+### Tools
+| Tool | Usage |
+|------|-------|
+| WebSearch | Search internet for current information |
+| WebFetch | Fetch specific URLs, documentation pages |
+| Read | Read local documentation, previous research |
+| Glob | Find existing documentation in codebase |
+| memory MCP | Store key findings, no-go technologies |
+
+### What I Do
+1. **Technology Research** - Evaluate technologies with pros/cons
+2. **Best Practices Lookup** - Find current patterns (2024/2025)
+3. **Security Research** - Check CVE databases, security advisories
+4. **Documentation Discovery** - Find official API docs, guides
+5. **Competitive Analysis** - How do similar projects solve this?
+
+### Output Format
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🔍 RESEARCH COMPLETE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+## Topic: [Research Topic]
+
+### Key Findings
+1. Finding 1 [Source](url)
+2. Finding 2 [Source](url)
+
+### Recommendation for @architect
+[Clear recommendation with rationale]
+
+### Sources
+- [Source 1](url)
+- [Source 2](url)
+
+### Handoff
+→ @architect for architecture decisions
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Timeout & Graceful Degradation
+- **Hard timeout: 30 seconds MAX** per research task
+- If timeout reached: STOP → Report partial results → Indicate what's incomplete
+- Uses graceful degradation: Full → Partial → Search Results Only → Failure Report
+
+**Model:** haiku (fast & cost-effective)
+
+</details>
+
+<details>
+<summary><strong>@architect</strong> - System Architect</summary>
+
+### Role
+System Architect - strategic planner for React/Node.js/TypeScript enterprise applications.
+
+### Tools
+| Tool | Usage |
+|------|-------|
+| Read | Analyze existing architecture docs |
+| Grep | Code pattern and dependency search |
+| Glob | Capture module structures |
+| WebFetch | Research best practices |
+
+### What I Do
+1. **Design high-level architecture** - Module structure, dependency graphs
+2. **Make technical decisions** - Stack selection, state management, patterns
+3. **Create handoff specifications** - Clear specs for @api-guardian and @builder
+
+### Decision Template
+```markdown
+## Decision: [Title]
+
+### Context
+[Why this decision is necessary]
+
+### Options Analyzed
+1. Option A: [Pros/Cons]
+2. Option B: [Pros/Cons]
+
+### Chosen Solution
+[Rationale]
+
+### Affected Modules
+- [ ] `src/module/...` - Type of change
+
+### Next Steps
+- [ ] @api-guardian for API contract (if API change)
+- [ ] @builder for implementation
+```
+
+### Design Principles
+- Single Responsibility Principle
+- Composition over Inheritance
+- Props Drilling Max 2 Levels (then Context)
+- Server State Separation (React Query/SWR)
+
+**Model:** opus (complex reasoning, high-impact decisions)
+
+</details>
+
+<details>
+<summary><strong>@api-guardian</strong> - API Lifecycle Expert</summary>
+
+### Role
+API Lifecycle Expert - specialist for REST/GraphQL APIs, TypeScript type systems, and cross-service contract management.
+
+### Tools
+| Tool | Usage |
+|------|-------|
+| Read | Read API files and type definitions |
+| Grep | Consumer discovery (find all imports/usages) |
+| Glob | Locate API/type files |
+| Bash | TypeScript compilation, git diff, schema validation |
+
+### What I Do
+1. **Identify change type** - Additive, Modification, Removal
+2. **Perform consumer discovery** - Find ALL usages of changed types/endpoints
+3. **Create impact report** - List affected consumers, migration checklist
+
+### Change Classification
+| Type | Example | Breaking? |
+|------|---------|-----------|
+| Additive | New fields, new endpoints | Usually safe |
+| Modification | Type changes, renamed fields | ⚠️ BREAKING |
+| Removal | Deleted fields/endpoints | ⚠️ BREAKING |
+
+### Output Format
+```markdown
+## API Impact Analysis Report
+
+### Breaking Changes Detected
+- `User.email` → `User.emailAddress` (5 consumers affected)
+
+### Consumer Impact Matrix
+| Consumer | File:Line | Required Action |
+|----------|-----------|-----------------|
+| UserCard | src/UserCard.tsx:23 | Update field access |
+
+### Migration Checklist
+- [ ] Update src/UserCard.tsx line 23
+- [ ] Run `npm run typecheck`
+```
+
+**Model:** sonnet (balanced analysis + documentation)
+
+</details>
+
+<details>
+<summary><strong>@builder</strong> - Full-Stack Developer</summary>
+
+### Role
+Senior Full-Stack Developer - specialist for React/Node.js/TypeScript implementation.
+
+### Tools
+| Tool | Usage |
+|------|-------|
+| Read | Read existing code, analyze specs |
+| Write | Create new files |
+| Edit | Modify existing files |
+| Bash | Run TypeCheck, Tests, Lint |
+| Glob | Find affected files |
+| Grep | Search code patterns |
+
+### What I Do
+1. **Process specifications** from @architect and @api-guardian
+2. **Implement code** in order: Types → Backend → Services → Components → Tests
+3. **Pass quality gates** - TypeScript, tests, lint must pass
+
+### Implementation Order
+1. TypeScript Types (`shared/types/`)
+2. Backend API (if relevant)
+3. Frontend Services/Hooks
+4. UI Components
+5. Tests
+
+### Code Standards
+- Functional Components with Hooks (no Classes)
+- Named Exports preferred
+- Barrel Files (`index.ts`) for modules
+- All Promises with try/catch
+- No `any` Types
+
+### Output Format
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+💻 IMPLEMENTATION COMPLETE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+### Files Created
+- `src/components/UserCard.tsx`
+
+### Files Modified
+- `src/hooks/useUser.ts:15-20`
+
+### Quality Gates
+- [x] `npm run typecheck` passes
+- [x] `npm test` passes
+- [x] `npm run lint` passes
+
+### Ready for @validator
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**Model:** sonnet (optimal for implementation)
+
+</details>
+
+<details>
+<summary><strong>@validator</strong> - Code Quality Engineer</summary>
+
+### Role
+Code Quality Engineer - specialist for verification and quality assurance.
+
+### Tools
+| Tool | Usage |
+|------|-------|
+| Read | Read implementation reports |
+| Grep | Verify consumer updates |
+| Glob | Locate changed files |
+| Bash | Run TypeCheck, Tests, Lint, git diff |
+
+### What I Do
+1. **Verify TypeScript compilation** - `tsc --noEmit`
+2. **Verify tests** - All pass, adequate coverage
+3. **Verify consumer updates** - Cross-reference @api-guardian's list
+4. **Security checks** - No hardcoded secrets, auth on protected routes
+5. **Performance checks** - No N+1 patterns, reasonable bundle size
+
+### Checklist
+- [ ] TypeScript compiles (no errors)
+- [ ] Unit tests pass
+- [ ] All listed consumers were updated
+- [ ] No security issues
+- [ ] No performance anti-patterns
+
+### Output (Success)
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ VALIDATION PASSED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ APPROVED - Ready for @scribe and commit
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Output (Failure)
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+❌ VALIDATION FAILED
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+### Issues Found
+1. [CRITICAL] TypeScript Error in src/hooks/useUser.ts:15
+
+→ Returning to @builder for fixes
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**Model:** sonnet (balanced verification)
+
+</details>
+
+<details>
+<summary><strong>@tester</strong> - UX Quality Engineer</summary>
+
+### Role
+UX Quality Engineer - specialist for E2E testing, visual regression, accessibility, and performance.
+
+### Tools
+| Tool | Usage |
+|------|-------|
+| Playwright MCP | Browser automation, E2E tests, screenshots |
+| Lighthouse MCP | Performance & accessibility audits |
+| A11y MCP | WCAG compliance |
+| Read | Read test reports |
+| Bash | Run tests, start server |
+
+### MANDATORY Requirements
+
+**Screenshots (NON-NEGOTIABLE):**
+- Create screenshots for EVERY page tested
+- Test at 3 viewports: mobile (375px), tablet (768px), desktop (1920px)
+- Format: `[page]-[viewport].png` saved to `.playwright-mcp/`
+
+**Console Errors (MANDATORY):**
+- Capture browser console for every page
+- Report ALL JavaScript errors
+
+**Performance Metrics (MANDATORY):**
+| Metric | Good | Acceptable | Fail |
+|--------|------|------------|------|
+| LCP | ≤2.5s | ≤4s | >4s |
+| INP | ≤200ms | ≤500ms | >500ms |
+| CLS | ≤0.1 | ≤0.25 | >0.25 |
+| FCP | ≤1.8s | ≤3s | >3s |
+
+### Output Format
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎭 UX TESTING COMPLETE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+## Screenshots Created
+| Page | Mobile | Tablet | Desktop |
+|------|--------|--------|---------|
+| Home | ✓ | ✓ | ✓ |
+
+## Console Errors: 0 detected
+## A11y Status: PASS
+## Performance: All metrics within thresholds
+
+✅ APPROVED - Ready for @scribe
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Blocking vs Non-Blocking Issues
+**BLOCKING:** Console errors, E2E failures, LCP > 4s, CLS > 0.25
+**NON-BLOCKING:** Minor A11y issues, "needs improvement" performance
+
+**Model:** sonnet (MCP coordination + analysis)
+
+</details>
+
+<details>
+<summary><strong>@scribe</strong> - Technical Writer</summary>
+
+### Role
+Technical Writer - specialist for developer documentation.
+
+### Tools
+| Tool | Usage |
+|------|-------|
+| Read | Read agent reports |
+| Write | Create new docs |
+| Edit | Update existing docs |
+| Grep | Find undocumented endpoints |
+| Glob | Locate doc files |
+
+### What I Do (MANDATORY before push!)
+1. **Update VERSION file** - Semantic versioning
+2. **Update CHANGELOG.md** - Document ALL changes
+3. **Update API_CONSUMERS.md** - Based on @api-guardian report
+4. **Update README.md** - For user-facing changes
+5. **Add JSDoc** - For new complex functions
+
+### Changelog Format (Keep a Changelog)
+```markdown
+## [X.X.X] - YYYY-MM-DD
+
+### Added
+- New features
+
+### Changed
+- Changes to existing code
+
+### Fixed
+- Bug fixes
+
+### Breaking Changes
+- ⚠️ Breaking change description
+```
+
+### Output Format
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📚 DOCUMENTATION COMPLETE
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+### Version Update
+- VERSION: X.X.X → Y.Y.Y
+- CHANGELOG: Updated
+
+### Files Updated
+- VERSION
+- CHANGELOG.md
+
+✅ Ready for push
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**Model:** sonnet (reading + writing capability)
+
+</details>
+
+<details>
+<summary><strong>@github-manager</strong> - GitHub Project Manager</summary>
+
+### Role
+GitHub Project Management Specialist - with full access to GitHub MCP Server.
+
+### Tools
+| Tool | Usage |
+|------|-------|
+| GitHub MCP | Repository API, issue/PR management |
+| Read | Read reports, CHANGELOG |
+| Bash | `gh` CLI as fallback |
+| Grep | Search commit messages |
+
+### What I Do
+1. **Issue Lifecycle** - Create, label, assign, close issues
+2. **Pull Request Workflow** - Create PRs, request reviews, merge
+3. **Release Management** - Tag, create GitHub releases
+4. **Repository Sync** - Sync forks, fetch upstream
+5. **CI/CD Monitoring** - Watch workflows, rerun failed jobs
+
+### Quick Commands
+```bash
+# Create issue
+gh issue create --title "Bug: [desc]" --label "bug"
+
+# Create PR
+gh pr create --title "[type]: [desc]"
+
+# Create release
+gh release create "v$VERSION" --notes-file CHANGELOG.md
+
+# Monitor CI
+gh run list --limit 10
+gh run view [run-id] --log-failed
+```
+
+### Commit Message Format
+```
+<type>(<scope>): <description>
+
+Types: feat, fix, docs, style, refactor, test, chore
+```
+
+**Model:** haiku (simple operations, cost-optimized)
+
+</details>

package/skills/cc-godmode/scripts/build-skill.js

@@ -0,0 +1,232 @@
+#!/usr/bin/env node
+
+/**
+ * Build Script for CC_GodMode Skill
+ * 
+ * Generates SKILL.md from CC_GodMode source files.
+ * Run from cc-godmode-skill directory: node scripts/build-skill.js
+ * 
+ * Sources:
+ * - ../CLAUDE.md (main orchestrator)
+ * - ../agents/*.md (agent definitions)
+ * - ../VERSION (current version)
+ * - ../CHANGELOG.md (changelog)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { glob } = require('glob');
+
+// Paths relative to this script
+const SCRIPT_DIR = __dirname;
+const SKILL_DIR = path.dirname(SCRIPT_DIR);
+const GODMODE_DIR = path.dirname(SKILL_DIR);
+
+// Source files
+const CLAUDE_MD = path.join(GODMODE_DIR, 'CLAUDE.md');
+const VERSION_FILE = path.join(GODMODE_DIR, 'VERSION');
+const AGENTS_DIR = path.join(GODMODE_DIR, 'agents');
+
+// Output
+const SKILL_MD = path.join(SKILL_DIR, 'SKILL.md');
+
+/**
+ * Read file content safely
+ */
+function readFile(filepath) {
+  try {
+    return fs.readFileSync(filepath, 'utf8');
+  } catch (err) {
+    console.error(`Error reading ${filepath}: ${err.message}`);
+    return null;
+  }
+}
+
+/**
+ * Extract version from VERSION file
+ */
+function getVersion() {
+  const version = readFile(VERSION_FILE);
+  return version ? version.trim() : '0.0.0';
+}
+
+/**
+ * Parse agent frontmatter
+ */
+function parseAgentFrontmatter(content) {
+  const match = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!match) return {};
+  
+  const frontmatter = {};
+  match[1].split('\n').forEach(line => {
+    const [key, ...valueParts] = line.split(':');
+    if (key && valueParts.length) {
+      frontmatter[key.trim()] = valueParts.join(':').trim();
+    }
+  });
+  return frontmatter;
+}
+
+/**
+ * Extract agent summary for table
+ */
+function extractAgentSummary(name, content) {
+  const frontmatter = parseAgentFrontmatter(content);
+  
+  // Extract tools from content
+  const toolsMatch = content.match(/\| \*\*(\w+)\*\* \|/g);
+  const tools = toolsMatch 
+    ? toolsMatch.slice(0, 3).map(t => t.replace(/\| \*\*|\*\* \|/g, '')).join(', ')
+    : 'Read, Write';
+  
+  return {
+    name: `@${name}`,
+    role: frontmatter.description || 'Agent',
+    model: frontmatter.model || 'sonnet',
+    tools
+  };
+}
+
+/**
+ * Create collapsible agent section
+ */
+function createAgentDetails(name, content) {
+  // Remove frontmatter
+  const bodyMatch = content.match(/^---[\s\S]*?---\n([\s\S]*)$/);
+  const body = bodyMatch ? bodyMatch[1].trim() : content;
+  
+  // Simplify content - keep only key sections
+  const sections = ['## Role', '## Tools', '## What I Do', '## Output Format'];
+  let simplified = '';
+  
+  sections.forEach(section => {
+    const sectionMatch = body.match(new RegExp(`${section}[\\s\\S]*?(?=\\n## |$)`));
+    if (sectionMatch) {
+      simplified += sectionMatch[0].trim() + '\n\n';
+    }
+  });
+  
+  return `<details>
+<summary><strong>@${name}</strong> - ${parseAgentFrontmatter(content).description || 'Agent'}</summary>
+
+${simplified.slice(0, 2000)}...
+
+**Model:** ${parseAgentFrontmatter(content).model || 'sonnet'}
+
+</details>`;
+}
+
+/**
+ * Generate YAML frontmatter
+ */
+function generateFrontmatter(version) {
+  return `---
+name: cc-godmode
+description: "Self-orchestrating multi-agent development workflows. You say WHAT, the AI decides HOW."
+metadata:
+  clawdbot:
+    emoji: "🚀"
+    author: "CC_GodMode Team"
+    version: "${version}"
+    tags:
+      - orchestration
+      - multi-agent
+      - development
+      - workflow
+      - claude-code
+      - automation
+    repository: "https://github.com/clawdbot/cc-godmode-skill"
+    license: "MIT"
+    tools:
+      - Read
+      - Write
+      - Edit
+      - Bash
+      - Glob
+      - Grep
+      - WebSearch
+      - WebFetch
+---`;
+}
+
+/**
+ * Main build function
+ */
+async function build() {
+  console.log('🚀 Building CC_GodMode Skill...\n');
+  
+  // Get version
+  const version = getVersion();
+  console.log(`📌 Version: ${version}`);
+  
+  // Read CLAUDE.md
+  const claudeContent = readFile(CLAUDE_MD);
+  if (!claudeContent) {
+    console.error('❌ Could not read CLAUDE.md');
+    process.exit(1);
+  }
+  console.log('✅ Read CLAUDE.md');
+  
+  // Read agent files
+  const agentFiles = fs.readdirSync(AGENTS_DIR)
+    .filter(f => f.endsWith('.md'))
+    .map(f => ({
+      name: f.replace('.md', ''),
+      path: path.join(AGENTS_DIR, f),
+      content: readFile(path.join(AGENTS_DIR, f))
+    }))
+    .filter(a => a.content);
+  
+  console.log(`✅ Read ${agentFiles.length} agent files`);
+  
+  // Build agent table
+  const agentTable = agentFiles.map(a => extractAgentSummary(a.name, a.content));
+  
+  // Build agent details
+  const agentDetails = agentFiles
+    .map(a => createAgentDetails(a.name, a.content))
+    .join('\n\n');
+  
+  // Extract key sections from CLAUDE.md
+  const extractSection = (content, header) => {
+    const regex = new RegExp(`## ${header}[\\s\\S]*?(?=\\n## |$)`);
+    const match = content.match(regex);
+    return match ? match[0] : '';
+  };
+  
+  // Generate SKILL.md
+  const frontmatter = generateFrontmatter(version);
+  
+  // Note: In a full implementation, we'd compose the complete SKILL.md here
+  // For now, we just update the version in the existing SKILL.md
+  
+  let skillContent = readFile(SKILL_MD);
+  if (skillContent) {
+    // Update version in frontmatter
+    skillContent = skillContent.replace(
+      /version: "[^"]*"/,
+      `version: "${version}"`
+    );
+    
+    // Update version in content
+    skillContent = skillContent.replace(
+      /\*\*CC_GodMode v[0-9.]+ - /,
+      `**CC_GodMode v${version} - `
+    );
+    
+    fs.writeFileSync(SKILL_MD, skillContent);
+    console.log(`✅ Updated SKILL.md to version ${version}`);
+  } else {
+    console.error('❌ SKILL.md not found - run initial setup first');
+    process.exit(1);
+  }
+  
+  console.log('\n✨ Build complete!');
+  console.log(`   SKILL.md: ${SKILL_MD}`);
+}
+
+// Run build
+build().catch(err => {
+  console.error('Build failed:', err);
+  process.exit(1);
+});

package/skills/clawdbot-filesystem/.clawhub/origin.json

@@ -0,0 +1,7 @@
+{
+  "version": 1,
+  "registry": "https://clawhub.ai",
+  "slug": "clawdbot-filesystem",
+  "installedVersion": "1.0.2",
+  "installedAt": 1770236535654
+}

package/skills/clawdbot-filesystem/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Clawdbot Community
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.