@xelth/eck-snapshot 2.2.0 → 4.0.0

package/setup.json

@@ -0,0 +1,805 @@
+{
+  "_comment": "Central configuration file for eck-snapshot. ALL settings are configured here.",
+  "projectContext": {
+    "name": "eckasse",
+    "type": "monorepo",
+    "architecture": {
+      "workspaces": [
+        "@eckasse/core",
+        "@eckasse/desktop",
+        "@eckasse/adapters",
+        "@eckasse/shared-frontend"
+      ],
+      "stack": [
+        "Node.js",
+        "Express",
+        "Electron",
+        "PostgreSQL",
+        "WebSocket"
+      ],
+      "aiIntegration": "Google Gemini for POS natural language control"
+    }
+  },
+  "projectDetection": {
+    "_comment": "Automatic project type detection based on file structure",
+    "patterns": {
+      "android": {
+        "files": [
+          "build.gradle",
+          "build.gradle.kts",
+          "settings.gradle",
+          "settings.gradle.kts"
+        ],
+        "directories": [
+          "app/src/main",
+          "app/src/androidTest"
+        ],
+        "manifestFiles": [
+          "AndroidManifest.xml"
+        ],
+        "priority": 10
+      },
+      "nodejs-monorepo": {
+        "files": [
+          "package.json"
+        ],
+        "directories": [
+          "packages",
+          "apps",
+          "libs"
+        ],
+        "patterns": [
+          "workspaces",
+          "lerna",
+          "nx",
+          "rush"
+        ],
+        "priority": 7
+      },
+      "nodejs": {
+        "files": [
+          "package.json"
+        ],
+        "directories": [
+          "node_modules"
+        ],
+        "priority": 6
+      },
+      "python-poetry": {
+        "files": [
+          "pyproject.toml"
+        ],
+        "patterns": [
+          "tool.poetry"
+        ],
+        "priority": 9
+      },
+      "python-pip": {
+        "files": [
+          "requirements.txt",
+          "setup.py",
+          "setup.cfg"
+        ],
+        "directories": [
+          "__pycache__",
+          "venv",
+          ".venv"
+        ],
+        "priority": 7
+      },
+      "python-conda": {
+        "files": [
+          "environment.yml",
+          "environment.yaml",
+          "conda.yml"
+        ],
+        "priority": 8
+      },
+      "django": {
+        "files": [
+          "manage.py"
+        ],
+        "patterns": [
+          "django",
+          "Django"
+        ],
+        "priority": 9
+      },
+      "flask": {
+        "files": [
+          "app.py",
+          "application.py"
+        ],
+        "patterns": [
+          "flask",
+          "Flask"
+        ],
+        "priority": 8
+      },
+      "flutter": {
+        "files": [
+          "pubspec.yaml"
+        ],
+        "directories": [
+          "lib",
+          "android",
+          "ios"
+        ],
+        "priority": 8
+      },
+      "react-native": {
+        "files": [
+          "package.json"
+        ],
+        "directories": [
+          "android",
+          "ios"
+        ],
+        "patterns": [
+          "react-native"
+        ],
+        "priority": 8
+      },
+      "rust": {
+        "files": [
+          "Cargo.toml"
+        ],
+        "directories": [
+          "src",
+          "target"
+        ],
+        "priority": 9
+      },
+      "go": {
+        "files": [
+          "go.mod",
+          "go.sum"
+        ],
+        "directories": [
+          "cmd",
+          "pkg",
+          "internal"
+        ],
+        "priority": 7
+      },
+      "dotnet": {
+        "files": [
+          "*.csproj",
+          "*.sln",
+          "*.fsproj",
+          "*.vbproj"
+        ],
+        "directories": [
+          "bin",
+          "obj"
+        ],
+        "priority": 7
+      },
+      "c": {
+        "files": [
+          "Makefile",
+          "CMakeLists.txt",
+          "*.c",
+          "*.h"
+        ],
+        "directories": [
+          "src",
+          "include",
+          "lib"
+        ],
+        "priority": 6
+      }
+    }
+  },
+  "environmentDetection": {
+    "_comment": "Cross-platform environment detection",
+    "scanCommand": "node -e \"console.log(['ENV', process.platform+'/'+require('os').arch(), process.version, require('fs').existsSync('*.sqlite*')?'SQLite':'none', require('path').basename(process.cwd())].join('|'))\"",
+    "responseFormat": "ENV|OS/arch|NodeVersion|Database|ProjectFolder",
+    "platformMarkers": {
+      "development": {
+        "paths": [
+          "/home/",
+          "/Users/",
+          "\\Users\\",
+          "WSL"
+        ],
+        "database": [
+          "SQLite",
+          "*.sqlite*"
+        ],
+        "process": [
+          "npm",
+          "node"
+        ]
+      },
+      "production": {
+        "paths": [
+          "/var/www/",
+          "/opt/",
+          "/srv/"
+        ],
+        "database": [
+          "PostgreSQL",
+          "eckwms"
+        ],
+        "process": [
+          "PM2",
+          "systemd"
+        ]
+      }
+    }
+  },
+  "contextProfiles": {
+    "backend": {
+      "description": "Backend API, database, business logic",
+      "include": [
+        "packages/backend/**",
+        "packages/core/**",
+        "knexfile.js",
+        "migrations/**"
+      ],
+      "exclude": [
+        "**/*.test.*",
+        "**/*.sqlite*",
+        "node_modules/**"
+      ]
+    },
+    "frontend": {
+      "description": "Electron app and frontend components",
+      "include": [
+        "packages/desktop/**",
+        "packages/shared-frontend/**",
+        "packages/adapters/**"
+      ],
+      "exclude": [
+        "**/dist/**",
+        "**/build/**",
+        "**/node_modules/**"
+      ]
+    },
+    "android-core": {
+      "description": "Android app source code and resources",
+      "include": [
+        "app/src/main/java/**",
+        "app/src/main/kotlin/**",
+        "app/src/main/res/**",
+        "app/src/main/AndroidManifest.xml",
+        "build.gradle*",
+        "settings.gradle*"
+      ],
+      "exclude": [
+        "**/build/**",
+        "**/.gradle/**",
+        "**/generated/**",
+        "app/src/androidTest/**",
+        "app/src/test/**"
+      ]
+    },
+    "android-tests": {
+      "description": "Android test code and configurations",
+      "include": [
+        "app/src/test/**",
+        "app/src/androidTest/**",
+        "**/test/**"
+      ],
+      "exclude": [
+        "**/build/**"
+      ]
+    },
+    "android-config": {
+      "description": "Android build configuration and dependencies",
+      "include": [
+        "build.gradle*",
+        "settings.gradle*",
+        "gradle.properties",
+        "local.properties",
+        "proguard-rules.pro",
+        "gradle/libs.versions.toml"
+      ]
+    },
+    "database": {
+      "description": "Database schema and migrations only",
+      "include": [
+        "**/migrations/**",
+        "**/knexfile.js",
+        "**/schema.sql"
+      ]
+    },
+    "deployment": {
+      "description": "Deployment and PM2 configuration",
+      "include": [
+        "ecosystem.config.js",
+        "pm2.json",
+        ".github/workflows/**"
+      ]
+    },
+    "test-frontend": {
+      "description": "Test frontend profile",
+      "include": [
+        "frontend/**"
+      ],
+      "exclude": []
+    },
+    "test-backend": {
+      "description": "Test backend profile",
+      "include": [
+        "backend/**"
+      ],
+      "exclude": []
+    }
+  },
+  "fileFiltering": {
+    "filesToIgnore": [
+      "package-lock.json",
+      "npm-shrinkwrap.json",
+      "yarn.lock",
+      "pnpm-lock.yaml",
+      "*.log",
+      "*.tmp",
+      ".env",
+      ".env.local",
+      ".env.production",
+      "eckasse_*.sqlite*",
+      "README*",
+      "readme*",
+      "LICENSE*"
+    ],
+    "extensionsToIgnore": [
+      ".sqlite3",
+      ".sqlite",
+      ".db",
+      ".DS_Store",
+      ".env",
+      ".pyc",
+      ".class",
+      ".jar",
+      ".aar",
+      ".apk",
+      ".aab",
+      ".dex",
+      ".o",
+      ".so",
+      ".dylib",
+      ".log",
+      ".tmp",
+      ".bak",
+      ".swp",
+      ".ico",
+      ".png",
+      ".jpg",
+      ".jpeg",
+      ".gif",
+      ".svg"
+    ],
+    "dirsToIgnore": [
+      "node_modules/",
+      ".git/",
+      ".eck/",
+      "dist/",
+      "build/",
+      ".next/",
+      ".nuxt/",
+      "target/",
+      "bin/",
+      "obj/",
+      ".idea/",
+      "coverage/",
+      "create-snapshot/"
+    ],
+    "includeHidden": false,
+    "projectSpecific": {
+      "android": {
+        "filesToIgnore": [
+          "gradle-wrapper.jar",
+          "local.properties",
+          "*.iml",
+          "*.apk",
+          "*.aab",
+          "*.aar",
+          "*.jar",
+          "*.dex",
+          "R.java",
+          "BuildConfig.java"
+        ],
+        "dirsToIgnore": [
+          "build/",
+          ".gradle/",
+          ".idea/",
+          "app/build/",
+          "app/.cxx/",
+          "**/generated/",
+          "**/intermediates/",
+          "**/outputs/",
+          "**/tmp/"
+        ],
+        "extensionsToIgnore": [
+          ".apk",
+          ".aab",
+          ".aar",
+          ".jar",
+          ".dex",
+          ".pro",
+          ".ap_",
+          ".aidl"
+        ]
+      },
+      "nodejs": {
+        "filesToIgnore": [
+          "package-lock.json",
+          "yarn.lock",
+          "pnpm-lock.yaml"
+        ],
+        "dirsToIgnore": [
+          "node_modules/",
+          "dist/",
+          ".next/"
+        ]
+      },
+      "python": {
+        "filesToIgnore": [
+          "*.pyc",
+          "*.pyo",
+          "*.pyd",
+          "__pycache__",
+          "*.egg-info",
+          ".coverage"
+        ],
+        "dirsToIgnore": [
+          "__pycache__/",
+          ".pytest_cache/",
+          ".coverage/",
+          "venv/",
+          ".venv/",
+          "env/",
+          ".env/",
+          "dist/",
+          "build/",
+          "*.egg-info/",
+          ".tox/",
+          ".mypy_cache/"
+        ],
+        "extensionsToIgnore": [
+          ".pyc",
+          ".pyo",
+          ".pyd"
+        ]
+      },
+      "rust": {
+        "filesToIgnore": [
+          "Cargo.lock"
+        ],
+        "dirsToIgnore": [
+          "target/",
+          "debug/",
+          "release/"
+        ]
+      },
+      "go": {
+        "filesToIgnore": [
+          "go.sum"
+        ],
+        "dirsToIgnore": [
+          "vendor/"
+        ]
+      },
+      "dotnet": {
+        "filesToIgnore": [
+          "*.user",
+          "*.suo",
+          "*.cache"
+        ],
+        "dirsToIgnore": [
+          "bin/",
+          "obj/",
+          ".vs/",
+          "packages/"
+        ]
+      },
+      "c": {
+        "filesToIgnore": [
+          "*.o",
+          "*.a",
+          "*.so",
+          "*.out",
+          "*.exe"
+        ],
+        "dirsToIgnore": [
+          "build/",
+          "cmake-build-debug/",
+          "cmake-build-release/",
+          ".cmake/"
+        ],
+        "extensionsToIgnore": [
+          ".o",
+          ".a",
+          ".so",
+          ".out"
+        ]
+      }
+    }
+  },
+  "performance": {
+    "maxFileSize": "10MB",
+    "maxTotalSize": "100MB",
+    "maxDepth": 10,
+    "concurrency": 10
+  },
+  "output": {
+    "defaultFormat": "md",
+    "defaultPath": "./.eck/snapshots",
+    "includeTree": true,
+    "_comment": "Default output format for snapshots: md, json, or txt. defaultPath is the output directory. includeTree controls whether to include directory structure."
+  },
+  "aiInstructions": {
+    "architectPersona": {
+      "role": "Project Manager and Solution Architect AI",
+      "goal": "Translate user requests into technical plans and generate precise commands for execution agents",
+      "contextRequirement": "ALWAYS check environment context before generating commands",
+      "workflow": [
+        "Request ENV scan from agent",
+        "Analyze User Request in their native language",
+        "Formulate environment-appropriate technical plan",
+        "Propose the plan and await user confirmation",
+        "Generate environment-specific JSON command block",
+        "Communicate with user in their language, commands in ENGLISH"
+      ]
+    },
+    "executionAgents": {
+      "local_dev": {
+        "active": true,
+        "name": "Local Development Agent (AGENT_LOCAL_DEV)",
+        "description": "Cross-platform local development with SQLite",
+        "guiSupport": true,
+        "identification": {
+          "markers": [
+            "WSL",
+            "/home/",
+            "/Users/",
+            "\\Users\\",
+            "SQLite"
+          ]
+        },
+        "capabilities": [
+          "npm install",
+          "npm run dev",
+          "npm run dev:backend",
+          "git operations",
+          "sqlite3 commands",
+          "electron debug",
+          "file editing",
+          "testing commands",
+          "browser automation"
+        ],
+        "restrictions": [
+          "no PM2 commands",
+          "no PostgreSQL production operations",
+          "no systemctl",
+          "no production deployments"
+        ]
+      },
+      "production_server": {
+        "active": true,
+        "name": "Production Server Agent (AGENT_PROD_SERVER)",
+        "description": "Linux production server with PostgreSQL and PM2, with development capabilities",
+        "guiSupport": false,
+        "identification": {
+          "markers": [
+            "/var/www/",
+            "PostgreSQL",
+            "PM2",
+            "eckwms"
+          ]
+        },
+        "capabilities": [
+          "pm2 restart/reload/stop/start",
+          "postgresql queries",
+          "knex migrations --env production",
+          "systemctl",
+          "log analysis",
+          "nginx operations",
+          "deployment scripts",
+          "file editing",
+          "npm install",
+          "git operations"
+        ],
+        "restrictions": [
+          "no electron",
+          "no GUI apps",
+          "no direct DB schema changes without migrations",
+          "always backup before migrations"
+        ]
+      },
+      "android_wsl_dev": {
+        "active": true,
+        "name": "Android WSL Development Agent (AGENT_ANDROID_WSL)",
+        "description": "Android development in Windows Subsystem for Linux with Gradle and ADB support",
+        "guiSupport": false,
+        "identification": {
+          "markers": [
+            "WSL",
+            "build.gradle.kts",
+            "/mnt/c/Users",
+            "app/src/main",
+            "AndroidManifest.xml"
+          ]
+        },
+        "capabilities": [
+          "./gradlew build",
+          "./gradlew assembleDebug",
+          "./gradlew assembleRelease",
+          "./gradlew clean",
+          "./gradlew lint",
+          "./gradlew test",
+          "adb devices",
+          "adb install",
+          "adb logcat",
+          "adb shell",
+          "git operations",
+          "file editing",
+          "gradle tasks",
+          "gradle wrapper operations"
+        ],
+        "restrictions": [
+          "no direct GUI access (Android Studio)",
+          "requires /mnt/c/ path for Windows file system access",
+          "no Android emulator control (emulator runs on Windows host)",
+          "limited USB device access through WSL",
+          "no hardware debugging interfaces"
+        ]
+      },
+      "ci_cd": {
+        "active": false,
+        "name": "CI/CD Pipeline Agent (AGENT_CI_CD)",
+        "description": "Automated testing and deployment pipeline",
+        "guiSupport": false,
+        "capabilities": [
+          "npm ci",
+          "npm test",
+          "npm run build",
+          "docker build",
+          "artifact generation"
+        ],
+        "restrictions": [
+          "no interactive commands",
+          "no GUI applications",
+          "no watch modes",
+          "no development servers"
+        ]
+      },
+      "gemini_wsl": {
+        "active": true,
+        "name": "Gemini WSL Agent (Junior Architect)",
+        "description": "Gemini, running in WSL. Can access all WSL tools and delegate to other agents like claude.",
+        "guiSupport": false,
+        "identification": {
+          "markers": [
+            "WSL",
+            "gemini",
+            "claude"
+          ]
+        },
+        "capabilities": [
+          "git operations",
+          "npm install",
+          "file editing",
+          "gemini (self)",
+          "claude (delegate)"
+        ],
+        "restrictions": [
+          "Runs only inside the WSL environment"
+        ]
+      },
+      "gemini_windows": {
+        "active": true,
+        "name": "Gemini Windows Agent (Standalone)",
+        "description": "Gemini, running in native Windows (PowerShell). Can only access Windows tools.",
+        "guiSupport": true,
+        "identification": {
+          "markers": [
+            "Windows",
+            "gemini",
+            "!WSL"
+          ]
+        },
+        "capabilities": [
+          "git operations",
+          "npm install",
+          "file editing",
+          "gemini (self)"
+        ],
+        "restrictions": [
+          "Runs only in native Windows",
+          "Cannot access WSL-only tools like claude"
+        ]
+      }
+    },
+    "header": {
+      "defaultEnabled": true,
+      "_comment": "Controls whether AI instruction headers are included by default in snapshots"
+    },
+    "promptTemplates": {
+      "envScanRequest": "src/templates/envScanRequest.md",
+      "gitWorkflow": "src/templates/gitWorkflow.md",
+      "multiAgent": "src/templates/multiAgent.md",
+      "vectorMode": "src/templates/vectorMode.md",
+      "agent": "src/templates/agent-prompt.template.md"
+    }
+  },
+  "consilium": {
+    "enabled": true,
+    "votingMode": "blind-first",
+    "autoTrigger": {
+      "conditions": [
+        "database migration",
+        "production deployment",
+        "architecture changes",
+        "security updates"
+      ]
+    },
+    "phases": {
+      "blind": {
+        "enabled": true,
+        "timeout": "3m"
+      },
+      "debate": {
+        "enabled": true,
+        "triggerDivergence": 0.3,
+        "rounds": 2
+      }
+    },
+    "defaultMembers": {
+      "architect": {
+        "active": true,
+        "modelName": "Claude/Gemini",
+        "role": "System Architecture",
+        "strengths": [
+          "monorepo structure",
+          "workspace dependencies",
+          "API design"
+        ]
+      },
+      "database_expert": {
+        "active": true,
+        "modelName": "GPT-4/Claude",
+        "role": "Database Specialist",
+        "strengths": [
+          "PostgreSQL optimization",
+          "Knex migrations",
+          "data integrity"
+        ]
+      },
+      "devops": {
+        "active": true,
+        "modelName": "Any Available",
+        "role": "Deployment & Operations",
+        "strengths": [
+          "PM2 configuration",
+          "environment management",
+          "monitoring"
+        ]
+      }
+    },
+    "complexityThresholds": {
+      "low": [
+        "bug fixes",
+        "simple features",
+        "documentation"
+      ],
+      "medium": [
+        "feature implementation",
+        "refactoring",
+        "integration"
+      ],
+      "high": [
+        "architecture changes",
+        "system redesign",
+        "performance optimization",
+        "security implementation"
+      ]
+    },
+    "prompts": {
+      "requestTemplate": "\n# Consilium Request\n\n## Task Overview\n- **Complexity:** {{complexity}}\n- **Domain:** {{domain}}\n- **Requesting Agent:** {{requestingAgent}}\n- **Environment:** {{envContext}}\n\n## Problem Description\n{{problemDescription}}\n\n## Questions for Consilium\n{{#each questions}}\n- {{this}}\n{{/each}}\n\n## Available Context\n{{contextDescription}}\n\n---\n",
+      "responseTemplate": "\n# Consilium Response - {{modelName}}\n\n## Analysis\n{{analysis}}\n\n## Recommendations\n{{recommendations}}\n\n## Implementation Steps\n{{implementationSteps}}\n\n## Risks and Considerations\n{{risks}}\n\n## Success Metrics\n{{successMetrics}}\n\n---\n"
+    }
+  }
+}