@voodocs/cli 0.1.0

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@voodocs/cli",
+  "version": "0.1.0",
+  "description": "AI-Native Documentation System - Generate docs, tests, and API specs from @voodocs annotations using the DarkArts language",
+  "main": "cli.py",
+  "bin": {
+    "voodocs": "./cli.py"
+  },
+  "scripts": {
+    "postinstall": "cd lib/darkarts/parsers/typescript && npm install && npm run build",
+    "test": "python3 -m pytest",
+    "build-ts-parser": "cd lib/darkarts/parsers/typescript && npm install && npm run build"
+  },
+  "keywords": [
+    "documentation",
+    "ai",
+    "voodocs",
+    "darkarts",
+    "testing",
+    "api-spec",
+    "openapi",
+    "code-generation",
+    "ai-assistant",
+    "cursor",
+    "claude",
+    "property-based-testing",
+    "hypothesis"
+  ],
+  "author": "3vilEnterprises <contact@3vil.enterprises>",
+  "license": "Commercial",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/3vilEnterprises/vooodooo-magic.git",
+    "directory": "packages/voodocs"
+  },
+  "bugs": {
+    "url": "https://github.com/3vilEnterprises/vooodooo-magic/issues"
+  },
+  "homepage": "https://voodocs.com",
+  "engines": {
+    "node": ">=16.0.0",
+    "python": ">=3.7.0"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "files": [
+    "cli.py",
+    "lib/darkarts/annotations/",
+    "lib/darkarts/core/",
+    "lib/darkarts/exceptions.py",
+    "lib/darkarts/parsers/typescript/dist/",
+    "lib/darkarts/parsers/typescript/src/",
+    "lib/darkarts/parsers/typescript/package.json",
+    "lib/darkarts/parsers/typescript/package-lock.json",
+    "lib/darkarts/parsers/typescript/tsconfig.json",
+    "lib/darkarts/plugins/voodocs/",
+    "lib/darkarts/__init__.py",
+    "examples/",
+    "templates/",
+    "README.md",
+    "LICENSE",
+    "USAGE.md",
+    "requirements.txt"
+  ],
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
+}

package/requirements.txt

@@ -0,0 +1,13 @@
+# VooDocs Python Dependencies
+# Python 3.7+ required
+# Install with: pip3 install -r requirements.txt
+
+# YAML processing for API spec generation
+PyYAML>=6.0.0
+
+# Optional dependencies for development and testing:
+# pytest>=7.0.0  # For running unit tests
+# hypothesis>=6.0.0  # For property-based testing (used in generated tests)
+
+# Note: VooDocs core uses only Python standard library.
+# PyYAML is the only required external dependency for API spec generation.

package/templates/ci/github-actions.yml

@@ -0,0 +1,73 @@
+name: VooDocs Validation
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v3
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+    
+    - name: Set up Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '18'
+    
+    - name: Install VooDocs
+      run: |
+        pip install pyyaml
+        # TODO: Replace with: pip install voodocs
+        # For now, clone and install locally
+    
+    - name: Validate Annotations
+      run: |
+        voodocs validate . --strict --format json > validation-report.json
+    
+    - name: Check Coverage
+      run: |
+        voodocs check --min-coverage 80 --min-quality 70
+    
+    - name: Upload Validation Report
+      if: always()
+      uses: actions/upload-artifact@v3
+      with:
+        name: voodocs-validation-report
+        path: validation-report.json
+    
+    - name: Comment PR with Results
+      if: github.event_name == 'pull_request'
+      uses: actions/github-script@v6
+      with:
+        script: |
+          const fs = require('fs');
+          const report = JSON.parse(fs.readFileSync('validation-report.json', 'utf8'));
+          
+          const comment = `## VooDocs Validation Report
+          
+          📊 **Summary**
+          - Files validated: ${report.files_validated}
+          - Files with issues: ${report.files_with_issues}
+          - Total issues: ${report.summary.total}
+            - Errors: ${report.summary.errors}
+            - Warnings: ${report.summary.warnings}
+            - Info: ${report.summary.info}
+          
+          ${report.summary.errors > 0 ? '❌ Validation failed' : report.summary.warnings > 0 ? '⚠️ Validation passed with warnings' : '✅ Validation passed'}
+          `;
+          
+          github.rest.issues.createComment({
+            issue_number: context.issue.number,
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            body: comment
+          });

package/templates/ci/gitlab-ci.yml

@@ -0,0 +1,35 @@
+stages:
+  - validate
+  - check
+
+voodocs-validate:
+  stage: validate
+  image: python:3.11
+  before_script:
+    - apt-get update && apt-get install -y nodejs npm
+    - pip install pyyaml
+    # TODO: Replace with: pip install voodocs
+  script:
+    - voodocs validate . --strict --format json > validation-report.json
+  artifacts:
+    reports:
+      junit: validation-report.json
+    paths:
+      - validation-report.json
+    expire_in: 1 week
+  allow_failure: false
+
+voodocs-check:
+  stage: check
+  image: python:3.11
+  before_script:
+    - apt-get update && apt-get install -y nodejs npm
+    - pip install pyyaml
+    # TODO: Replace with: pip install voodocs
+  script:
+    - voodocs check --min-coverage 80 --min-quality 70
+  allow_failure: false
+  only:
+    - main
+    - develop
+    - merge_requests

package/templates/ci/pre-commit-hook.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# VooDocs Pre-Commit Hook
+# Validates annotations before allowing commit
+
+echo "🔍 VooDocs: Validating annotations..."
+
+# Get list of staged Python/TypeScript files
+STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(py|ts|js)$')
+
+if [ -z "$STAGED_FILES" ]; then
+    echo "✅ No code files to validate"
+    exit 0
+fi
+
+# Run validation
+voodocs validate $STAGED_FILES --strict
+
+if [ $? -ne 0 ]; then
+    echo ""
+    echo "❌ VooDocs validation failed!"
+    echo "   Fix the annotation issues above or use 'git commit --no-verify' to skip validation."
+    exit 1
+fi
+
+echo "✅ VooDocs validation passed!"
+exit 0