ai-eng-system 0.0.5 → 0.0.6

package/dist/.claude-plugin/commands/clean.md

@@ -11,10 +11,45 @@ Router command for removing AI-generated verbosity and redundancy from various c
 ## Usage
 
 ```bash
-/clean <content-or-file> --type=<type> [options]
-/clean slop <content> [options]                # Shortcut for --type=slop
-/clean comments <file-or-dir> [options]        # Shortcut for --type=comments  
-/clean docs <file-or-dir> [options]            # Shortcut for --type=docs
+/clean --help                         # Show help and available types
+/clean <content-or-file>             # Auto-detect and clean content
+/clean <content> --slop              # Remove AI filler patterns
+/clean <file-or-dir> --comments      # Optimize code comments (recursive)
+/clean <file-or-dir> --docs          # Clean documentation (recursive)
+/clean <content> --type=<type>       # Explicit type flag
+```
+
+## Help
+
+When `--help` is passed, display:
+
+```
+CLEAN COMMAND - Remove AI-generated verbosity
+
+USAGE:
+  /clean <content-or-file> [--type]   Auto-detect and clean content
+  /clean <content> --slop             Remove AI conversational filler
+  /clean <path> --comments            Optimize code comments (recursive)
+  /clean <path> --docs                Clean documentation verbosity (recursive)
+
+TYPES:
+  --slop          AI filler: "Certainly!", "I'd be happy to help", hedging
+  --comments      Code comments: redundant, verbose, obvious explanations
+  --docs          Documentation: conversational tone, excessive politeness
+  --all           Apply all cleanup techniques
+
+OPTIONS:
+  -m, --mode      Aggressiveness: conservative | moderate | aggressive
+  -p, --preview   Show changes without applying
+  -a, --apply     Apply confirmed changes
+  -v, --verbose   Show detailed analysis
+  --help          Show this help
+
+EXAMPLES:
+  /clean "Certainly! I'd be happy to help..." --slop --preview
+  /clean src/ --comments --apply
+  /clean docs/README.md --docs --mode=aggressive
+  /clean ./docs --docs --recursive
 ```
 
 ## Types

package/dist/.claude-plugin/commands/optimize.md

@@ -11,11 +11,55 @@ Interactive optimization tool that enhances content using research-backed techni
 ## Usage
 
 ```bash
-/optimize <content> --type=<type> [options]
-/optimize "Help me debug this slow query" --prompt
-/optimize "SELECT * FROM users WHERE active = true" --query  
-/optimize "function to calculate total" --code
-/optimize "Fix authentication bug in production" --commit
+/optimize --help                         # Show help and available types
+/optimize <content-or-file>              # Auto-detect type and optimize
+/optimize <content> --prompt             # Optimize AI prompts
+/optimize <content> --query              # Enhance database/search queries
+/optimize <content> --code               # Improve code quality
+/optimize <content> --commit             # Optimize commit messages
+/optimize <content> --docs               # Enhance documentation
+/optimize <content> --email              # Improve communication
+/optimize <content> --type=<type>        # Explicit type flag
+```
+
+## Help
+
+When `--help` is passed, display:
+
+```
+OPTIMIZE COMMAND - Enhance content using research-backed techniques
+
+USAGE:
+  /optimize <content-or-file> [--type]   Auto-detect and optimize content
+  /optimize <content> --prompt           Optimize AI prompts
+  /optimize <content> --query            Enhance database/search queries
+  /optimize <content> --code             Improve code quality
+  /optimize <content> --commit           Optimize commit messages
+  /optimize <content> --docs             Enhance documentation
+  /optimize <content> --email            Improve communication
+
+TYPES:
+  --prompt        AI prompts: structure, personas, reasoning chains
+  --query         Database/search: indexes, execution plans, caching
+  --code          Source code: performance, readability, error handling
+  --commit        Git messages: clarity, conventional format
+  --docs          Documentation: structure, examples, clarity
+  --email         Communication: tone, clarity, call-to-action
+
+OPTIONS:
+  -m, --mode      Approach: conservative | moderate | aggressive
+  -p, --preview   Show changes without applying
+  -a, --apply     Apply confirmed optimizations
+  -i, --interactive   Enable clarifying questions
+  -s, --source    Research sources: anthropic | openai | opencode | all
+  -v, --verbose   Show detailed process
+  --help          Show this help
+
+EXAMPLES:
+  /optimize "Help me debug auth" --prompt --interactive
+  /optimize "SELECT * FROM users" --query --preview
+  /optimize src/auth.js --code --apply
+  /optimize "fix: resolve login bug" --commit
 ```
 
 ## Types

package/dist/.claude-plugin/marketplace.json

@@ -14,7 +14,7 @@
       "name": "ai-eng-system",
       "source": "./plugins/ai-eng-system",
       "description": "AI Engineering System with context engineering, research orchestration, 15 commands, 29 specialized agents, and 4 skill packs for Claude Code & OpenCode",
-      "version": "0.0.3",
+       "version": "0.0.6",
       "author": {
         "name": "v1truv1us",
         "email": "contact@v1truv1us.dev"

package/dist/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-eng-system",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "AI Engineering System with context engineering and research orchestration for Claude Code",
   "author": "v1truv1us",
   "license": "MIT",
@@ -20,9 +20,6 @@
     "./commands/plan.md",
     "./commands/research.md",
     "./commands/review.md",
-    "./commands/clean.md",
-    "./commands/clean-slop.md",
-    "./commands/clean-comments.md",
-    "./commands/clean-docs.md"
+    "./commands/clean.md"
   ]
 }

package/dist/.opencode/command/ai-eng/clean.md

@@ -11,10 +11,45 @@ Router command for removing AI-generated verbosity and redundancy from various c
 ## Usage
 
 ```bash
-/clean <content-or-file> --type=<type> [options]
-/clean slop <content> [options]                # Shortcut for --type=slop
-/clean comments <file-or-dir> [options]        # Shortcut for --type=comments  
-/clean docs <file-or-dir> [options]            # Shortcut for --type=docs
+/clean --help                         # Show help and available types
+/clean <content-or-file>             # Auto-detect and clean content
+/clean <content> --slop              # Remove AI filler patterns
+/clean <file-or-dir> --comments      # Optimize code comments (recursive)
+/clean <file-or-dir> --docs          # Clean documentation (recursive)
+/clean <content> --type=<type>       # Explicit type flag
+```
+
+## Help
+
+When `--help` is passed, display:
+
+```
+CLEAN COMMAND - Remove AI-generated verbosity
+
+USAGE:
+  /clean <content-or-file> [--type]   Auto-detect and clean content
+  /clean <content> --slop             Remove AI conversational filler
+  /clean <path> --comments            Optimize code comments (recursive)
+  /clean <path> --docs                Clean documentation verbosity (recursive)
+
+TYPES:
+  --slop          AI filler: "Certainly!", "I'd be happy to help", hedging
+  --comments      Code comments: redundant, verbose, obvious explanations
+  --docs          Documentation: conversational tone, excessive politeness
+  --all           Apply all cleanup techniques
+
+OPTIONS:
+  -m, --mode      Aggressiveness: conservative | moderate | aggressive
+  -p, --preview   Show changes without applying
+  -a, --apply     Apply confirmed changes
+  -v, --verbose   Show detailed analysis
+  --help          Show this help
+
+EXAMPLES:
+  /clean "Certainly! I'd be happy to help..." --slop --preview
+  /clean src/ --comments --apply
+  /clean docs/README.md --docs --mode=aggressive
+  /clean ./docs --docs --recursive
 ```
 
 ## Types

package/dist/.opencode/command/ai-eng/optimize.md

@@ -11,11 +11,55 @@ Interactive optimization tool that enhances content using research-backed techni
 ## Usage
 
 ```bash
-/optimize <content> --type=<type> [options]
-/optimize "Help me debug this slow query" --prompt
-/optimize "SELECT * FROM users WHERE active = true" --query  
-/optimize "function to calculate total" --code
-/optimize "Fix authentication bug in production" --commit
+/optimize --help                         # Show help and available types
+/optimize <content-or-file>              # Auto-detect type and optimize
+/optimize <content> --prompt             # Optimize AI prompts
+/optimize <content> --query              # Enhance database/search queries
+/optimize <content> --code               # Improve code quality
+/optimize <content> --commit             # Optimize commit messages
+/optimize <content> --docs               # Enhance documentation
+/optimize <content> --email              # Improve communication
+/optimize <content> --type=<type>        # Explicit type flag
+```
+
+## Help
+
+When `--help` is passed, display:
+
+```
+OPTIMIZE COMMAND - Enhance content using research-backed techniques
+
+USAGE:
+  /optimize <content-or-file> [--type]   Auto-detect and optimize content
+  /optimize <content> --prompt           Optimize AI prompts
+  /optimize <content> --query            Enhance database/search queries
+  /optimize <content> --code             Improve code quality
+  /optimize <content> --commit           Optimize commit messages
+  /optimize <content> --docs             Enhance documentation
+  /optimize <content> --email            Improve communication
+
+TYPES:
+  --prompt        AI prompts: structure, personas, reasoning chains
+  --query         Database/search: indexes, execution plans, caching
+  --code          Source code: performance, readability, error handling
+  --commit        Git messages: clarity, conventional format
+  --docs          Documentation: structure, examples, clarity
+  --email         Communication: tone, clarity, call-to-action
+
+OPTIONS:
+  -m, --mode      Approach: conservative | moderate | aggressive
+  -p, --preview   Show changes without applying
+  -a, --apply     Apply confirmed optimizations
+  -i, --interactive   Enable clarifying questions
+  -s, --source    Research sources: anthropic | openai | opencode | all
+  -v, --verbose   Show detailed process
+  --help          Show this help
+
+EXAMPLES:
+  /optimize "Help me debug auth" --prompt --interactive
+  /optimize "SELECT * FROM users" --query --preview
+  /optimize src/auth.js --code --apply
+  /optimize "fix: resolve login bug" --commit
 ```
 
 ## Types

package/dist/.opencode/opencode.jsonc

@@ -2,8 +2,5 @@
   "$schema": "https://opencode.ai/config.json",
 
   // AI Engineering System configuration
-  // Loaded by OpenCode when you install this project as a config directory.
-  //
-  // Commands and agents are provided by markdown config under:
-  // .opencode/command and .opencode/agent in the built distribution.
+  // Plugins are auto-loaded from .opencode/plugin/ directory
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "ai-eng-system",
-    "version": "0.0.5",
+    "version": "0.0.6",
     "description": "Compounding engineering system for Claude Code and OpenCode. Shared agents, commands, skills, and plugin development tools.",
     "type": "module",
     "main": "./dist/index.js",
@@ -13,6 +13,7 @@
     },
     "files": [
         "dist/",
+        "scripts/",
         "index.js",
         "index.d.ts",
         "README.md",
@@ -26,6 +27,7 @@
         "typecheck": "tsc --noEmit",
         "typecheck:plugin": "tsc -p tsconfig.plugin.json",
         "prepublishOnly": "bun build.ts",
+        "postinstall": "node scripts/install.js --global",
         "test": "bun test tests/build.test.ts"
     },
     "publishConfig": {

package/scripts/AGENTS.md

@@ -0,0 +1,49 @@
+# Scripts Context
+
+**Hierarchy Level:** Build automation and deployment utilities
+**Parent:** [../AGENTS.md](../AGENTS.md) — Agent coordination
+**Philosophy:** [../CLAUDE.md](../CLAUDE.md) — Compounding Engineering philosophy
+
+Build scripts and installation utilities that support the agent infrastructure defined in AGENTS.md.
+
+## Project Overview
+Build and installation utilities for the Ferg Engineering System.
+
+## Technology Stack
+- **Runtime**: Bun (ES modules)
+- **Language**: JavaScript/TypeScript
+- **Shebang**: `#!/usr/bin/env bun`
+
+## Build Commands
+```bash
+# Main build process
+bun run build
+
+# Watch mode for development
+bun run build:watch
+
+# Clean build artifacts
+bun run clean
+
+# Validate build
+bun run validate
+
+# Installation scripts
+bun scripts/install.js --global  # Global installation
+bun scripts/install.js --local    # Local installation
+```
+
+## Code Style
+- Use ES modules (`import`/`export`)
+- Follow Bun best practices
+- Include proper shebang for executable scripts
+- Use JSDoc comments for documentation
+
+## Key Files
+- `install.js` - Main installation script (global/local support)
+- `build.ts` - TypeScript build configuration (in root)
+
+## Integration Notes
+- Scripts integrate with package.json build pipeline
+- Must support both global and local OpenCode installation
+- Handle dependency resolution and file copying

package/scripts/install.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env bun
+
+/**
+ * AI Engineering System Installation Script (OpenCode)
+ *
+ * Installs the pre-built OpenCode distribution (dist/.opencode + dist/skills)
+ * into either:
+ * - global: ~/.config/opencode (default)
+ * - local:  ./.opencode (in the target project)
+ */
+
+import fs from 'fs'
+import path from 'path'
+import { fileURLToPath } from 'url'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+const packageRoot = path.dirname(__dirname)
+
+// Namespace configuration for OpenCode installations
+const NAMESPACE_PREFIX = 'ai-eng'
+
+function printUsage(exitCode = 1) {
+  console.log('AI Engineering System Installer (OpenCode)')
+  console.log('========================================\n')
+  console.log('Usage:')
+  console.log('  bun scripts/install.js             # Install globally to ~/.config/opencode (default)')
+  console.log('  bun scripts/install.js --global    # Install globally to ~/.config/opencode')
+  console.log('  bun scripts/install.js --local     # Install locally to ./.opencode (in current dir)')
+  process.exit(exitCode)
+}
+
+function parseArgs(argv) {
+  const args = argv.slice(2)
+
+  if (args.includes('--help') || args.includes('-h')) {
+    printUsage(0)
+  }
+
+  const allowed = new Set(['--global', '--local', '--help', '-h'])
+
+  for (const a of args) {
+    if (!allowed.has(a)) {
+      console.error(`Unknown flag: ${a}`)
+      printUsage(1)
+    }
+  }
+
+  const wantsGlobal = args.includes('--global')
+  const wantsLocal = args.includes('--local')
+
+  if (wantsGlobal && wantsLocal) {
+    console.error('Cannot use both --global and --local')
+    printUsage(1)
+  }
+
+  // If no args specified, check if we're running during npm install
+  if (!wantsGlobal && !wantsLocal) {
+    const isPostInstall = process.env.npm_lifecycle_event === 'postinstall'
+    return { mode: isPostInstall ? 'global' : 'global' }
+  }
+
+  return { mode: wantsLocal ? 'local' : 'global' }
+}
+
+function copyRecursive(src, dest) {
+  const stat = fs.statSync(src)
+
+  if (stat.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true })
+    for (const entry of fs.readdirSync(src)) {
+      copyRecursive(path.join(src, entry), path.join(dest, entry))
+    }
+    return
+  }
+
+  fs.mkdirSync(path.dirname(dest), { recursive: true })
+  fs.copyFileSync(src, dest)
+}
+
+function installOpenCode(targetDir, description) {
+  const isPostInstall = process.env.npm_lifecycle_event === 'postinstall'
+  if (!isPostInstall) {
+    console.log(`Installing to ${description}...`)
+  }
+
+  const distOpenCodeRoot = path.join(packageRoot, 'dist', '.opencode')
+  const distSkillsRoot = path.join(packageRoot, 'dist', 'skills')
+
+  // Check if OpenCode is installed (look for config directory)
+  const openCodeConfigDir = path.join(process.env.HOME || '', '.config', 'opencode')
+  if (!fs.existsSync(openCodeConfigDir)) {
+    if (isPostInstall) {
+      // Silently skip if OpenCode not installed during npm install
+      return
+    } else {
+      console.error('Error: OpenCode not found. Please install OpenCode first:')
+      console.error('curl -fsSL https://opencode.ai/install | bash')
+      process.exit(1)
+    }
+  }
+
+  if (!fs.existsSync(distOpenCodeRoot)) {
+    console.error('Error: dist/.opencode not found.')
+    console.error('Run "bun run build" first (or install from a pre-built package).')
+    process.exit(1)
+  }
+
+  // Copy OpenCode config
+  const configSrc = path.join(distOpenCodeRoot, 'opencode.jsonc')
+  if (fs.existsSync(configSrc)) {
+    fs.mkdirSync(targetDir, { recursive: true })
+    fs.copyFileSync(configSrc, path.join(targetDir, 'opencode.jsonc'))
+  }
+
+  // Copy plugin script
+  const pluginSrc = path.join(distOpenCodeRoot, 'plugin', 'ai-eng-system.ts')
+  if (fs.existsSync(pluginSrc)) {
+    copyRecursive(pluginSrc, path.join(targetDir, 'plugin', 'ai-eng-system.ts'))
+  }
+
+  // Copy commands (ai-eng subdirectory)
+  const commandsSrc = path.join(distOpenCodeRoot, 'command', NAMESPACE_PREFIX)
+  if (fs.existsSync(commandsSrc)) {
+    copyRecursive(commandsSrc, path.join(targetDir, 'command', NAMESPACE_PREFIX))
+  }
+
+  // Copy agents (MUST be recursive; categories are subfolders)
+  const agentsSrc = path.join(distOpenCodeRoot, 'agent', NAMESPACE_PREFIX)
+  if (fs.existsSync(agentsSrc)) {
+    copyRecursive(agentsSrc, path.join(targetDir, 'agent', NAMESPACE_PREFIX))
+  }
+
+  // Copy skills
+  if (fs.existsSync(distSkillsRoot)) {
+    copyRecursive(distSkillsRoot, path.join(targetDir, 'skills'))
+  }
+
+  if (!isPostInstall) {
+    console.log('Installation complete.')
+    console.log(`Namespace: ${NAMESPACE_PREFIX}`)
+  }
+}
+
+const { mode } = parseArgs(process.argv)
+
+if (mode === 'global') {
+  const globalDir = path.join(process.env.HOME || '', '.config', 'opencode')
+  installOpenCode(globalDir, 'global ~/.config/opencode')
+} else {
+  const localDir = path.join(process.cwd(), '.opencode')
+  installOpenCode(localDir, 'local ./.opencode')
+}