workspai 0.43.0

package/contracts/doctor-workspace-evidence.v1.json

@@ -0,0 +1,315 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://getrapidkit.com/schemas/doctor-workspace-evidence.v1.json",
+  "title": "RapidKit Doctor Workspace Evidence",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "evidenceType",
+    "generatedAt",
+    "workspacePath",
+    "summary",
+    "projects"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "doctor-workspace-evidence-v1"
+    },
+    "evidenceType": {
+      "const": "workspace"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "workspacePath": { "type": "string", "minLength": 1 },
+    "workspaceName": { "type": "string" },
+    "projectScanCached": { "type": "boolean" },
+    "projectScanSignature": { "type": "string" },
+    "cachePath": { "type": ["string", "null"] },
+    "healthScore": { "type": "object", "additionalProperties": true },
+    "evidenceFreshness": { "$ref": "#/$defs/evidenceFreshness" },
+    "system": { "type": "object", "additionalProperties": true },
+    "projects": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "probes": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/probe" }
+          },
+          "repairCapabilities": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/repairCapability" }
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "summary": {
+      "type": "object",
+      "required": ["totalProjects", "totalIssues", "hasSystemErrors"],
+      "properties": {
+        "totalProjects": { "type": "integer", "minimum": 0 },
+        "totalIssues": { "type": "integer", "minimum": 0 },
+        "projectAdvisoryWarningProjects": { "type": "integer", "minimum": 0 },
+        "projectAdvisoryWarnings": { "type": "integer", "minimum": 0 },
+        "hasSystemErrors": { "type": "boolean" },
+        "scopeProvenance": { "type": "object", "additionalProperties": true }
+      },
+      "additionalProperties": true
+    },
+    "driftDelta": { "type": "object", "additionalProperties": true },
+    "scoreBreakdown": {
+      "type": "array",
+      "items": { "type": "object", "additionalProperties": true }
+    },
+    "contract": { "type": "object", "additionalProperties": true },
+    "policyProfile": { "$ref": "#/$defs/policyProfile" }
+  },
+  "$defs": {
+    "freshness": {
+      "type": "object",
+      "required": [
+        "category",
+        "generatedAt",
+        "ttlSeconds",
+        "status",
+        "verifyBeforeUse",
+        "reason"
+      ],
+      "properties": {
+        "category": { "enum": ["structure", "verification", "state"] },
+        "generatedAt": { "type": "string", "format": "date-time" },
+        "ttlSeconds": { "type": ["integer", "null"], "minimum": 0 },
+        "expiresAt": { "type": "string", "format": "date-time" },
+        "status": { "enum": ["fresh", "stale", "unknown"] },
+        "verifyBeforeUse": { "type": "boolean" },
+        "reason": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "evidenceFreshness": {
+      "type": "object",
+      "required": [
+        "generatedAt",
+        "status",
+        "staleProbeCount",
+        "unknownProbeCount",
+        "liveStateProbeCount",
+        "verifyBeforeUseProbeCount"
+      ],
+      "properties": {
+        "generatedAt": { "type": "string", "format": "date-time" },
+        "status": { "enum": ["fresh", "stale", "unknown"] },
+        "staleProbeCount": { "type": "integer", "minimum": 0 },
+        "unknownProbeCount": { "type": "integer", "minimum": 0 },
+        "liveStateProbeCount": { "type": "integer", "minimum": 0 },
+        "verifyBeforeUseProbeCount": { "type": "integer", "minimum": 0 },
+        "oldestProbeGeneratedAt": { "type": "string", "format": "date-time" }
+      },
+      "additionalProperties": false
+    },
+    "repairIntent": {
+      "type": "object",
+      "required": [
+        "mode",
+        "confidence",
+        "primaryActionLabel",
+        "requiresApproval",
+        "requiresFreshEvidence",
+        "reason",
+        "relatedCommands"
+      ],
+      "properties": {
+        "mode": {
+          "enum": [
+            "none",
+            "run-command",
+            "edit-file",
+            "review-required",
+            "verify-before-fix",
+            "refresh-evidence",
+            "manual-guidance"
+          ]
+        },
+        "confidence": { "enum": ["high", "medium", "low"] },
+        "primaryActionLabel": { "type": "string" },
+        "requiresApproval": { "type": "boolean" },
+        "requiresFreshEvidence": { "type": "boolean" },
+        "reason": { "type": "string" },
+        "relatedCommands": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": false
+    },
+    "policyProfile": {
+      "type": "object",
+      "required": [
+        "name",
+        "exitOnErrors",
+        "exitOnWarnings",
+        "warningExitCode",
+        "advisoryWarningsBlockRelease",
+        "description"
+      ],
+      "properties": {
+        "name": { "enum": ["local", "ci", "release", "enterprise-strict"] },
+        "exitOnErrors": { "const": true },
+        "exitOnWarnings": { "type": "boolean" },
+        "warningExitCode": { "enum": [0, 1, 2] },
+        "advisoryWarningsBlockRelease": { "type": "boolean" },
+        "description": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "probe": {
+      "type": "object",
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["pass", "warn", "fail"] },
+        "severity": { "enum": ["info", "warn", "error"] },
+        "scope": { "type": "string" },
+        "reason": { "type": "string" },
+        "recommendation": { "type": "string" },
+        "freshness": { "$ref": "#/$defs/freshness" },
+        "issueClass": {
+          "enum": [
+            "dependency",
+            "environment",
+            "security",
+            "test",
+            "quality",
+            "container",
+            "deployment",
+            "runtime",
+            "workspace-contract",
+            "source-tree",
+            "framework",
+            "configuration",
+            "custom",
+            "unknown"
+          ]
+        },
+        "operationalImpact": {
+          "enum": [
+            "none",
+            "developer-friction",
+            "ci-risk",
+            "release-risk",
+            "security-risk",
+            "runtime-risk",
+            "customer-risk"
+          ]
+        },
+        "repairIntent": { "$ref": "#/$defs/repairIntent" },
+        "repairCapability": { "$ref": "#/$defs/repairCapability" }
+      },
+      "additionalProperties": true
+    },
+    "repairCapability": {
+      "type": "object",
+      "required": [
+        "id",
+        "issueId",
+        "title",
+        "status",
+        "fixKind",
+        "risk",
+        "canAutoFix",
+        "canEditFiles",
+        "requiresApproval",
+        "requiresReview",
+        "files",
+        "refreshCommands",
+        "reason"
+      ],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "issueId": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["available", "manual", "blocked"] },
+        "fixKind": {
+          "enum": [
+            "package-json-script",
+            "file-create",
+            "file-append",
+            "file-copy",
+            "dependency-sync",
+            "command",
+            "manual"
+          ]
+        },
+        "risk": { "enum": ["safe", "guarded", "invasive"] },
+        "canAutoFix": { "type": "boolean" },
+        "canEditFiles": { "type": "boolean" },
+        "requiresApproval": { "type": "boolean" },
+        "requiresReview": { "type": "boolean" },
+        "files": { "type": "array", "items": { "type": "string" } },
+        "command": { "type": "string" },
+        "operation": { "$ref": "#/$defs/repairOperation" },
+        "verifyCommand": { "type": "string" },
+        "refreshCommands": { "type": "array", "items": { "type": "string" } },
+        "reason": { "type": "string" },
+        "limitations": { "type": "array", "items": { "type": "string" } }
+      },
+      "additionalProperties": true
+    },
+    "repairOperation": {
+      "type": "object",
+      "required": ["type", "path"],
+      "properties": {
+        "type": {
+          "enum": [
+            "file-create",
+            "file-append",
+            "file-copy",
+            "package-json-script",
+            "json-edit",
+            "env-key-add",
+            "makefile-target"
+          ]
+        },
+        "sourcePath": { "type": "string", "minLength": 1 },
+        "path": { "type": "string", "minLength": 1 },
+        "content": { "type": "string" },
+        "overwrite": { "type": "boolean" },
+        "lines": { "type": "array", "items": { "type": "string" } },
+        "ensureNewline": { "type": "boolean" },
+        "scriptName": { "type": "string" },
+        "scriptValue": { "type": "string" },
+        "edits": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["pointer", "value"],
+            "properties": {
+              "pointer": { "type": "string" },
+              "value": { "type": ["string", "number", "boolean", "null"] }
+            },
+            "additionalProperties": false
+          }
+        },
+        "keys": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["name", "value"],
+            "properties": {
+              "name": { "type": "string" },
+              "value": { "type": "string" },
+              "comment": { "type": "string" }
+            },
+            "additionalProperties": false
+          }
+        },
+        "target": { "type": "string" },
+        "command": { "type": "string" },
+        "phony": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": true
+}

package/contracts/extension-cli-compatibility.v1.json

@@ -0,0 +1,26 @@
+{
+  "schemaVersion": "rapidkit-extension-cli-compatibility.v1",
+  "cli": "workspai",
+  "minimumVerifiedCliVersion": "0.42.0",
+  "publishedContractSchemas": {
+    "runtimeCommandSurface": "rapidkit-runtime-command-surface-v1",
+    "cliLogEvent": "cli-log-event-v1",
+    "freshnessMetadata": "rapidkit-freshness-metadata-v1",
+    "factFreshness": "rapidkit-fact-freshness-v1",
+    "blockerResolution": "rapidkit-blocker-resolution-v1",
+    "workspaceModel": "workspace-model.v1",
+    "workspaceImpact": "workspace-impact.v1",
+    "workspaceVerify": "workspace-verify.v1",
+    "workspaceContext": "workspace-context.v1",
+    "workspaceDependencyGraph": "workspace-dependency-graph.v1",
+    "workspaceIntelligenceHistory": "workspace-intelligence-history.v1",
+    "agentCustomizationPack": "rapidkit-agent-customization-pack.v1",
+    "workspaceOperationalSkill": "workspace-operational-skill.v1",
+    "workspaceSkillsIndex": "workspace-skills-index.v1",
+    "workspaceExplain": "workspace-explain.v1",
+    "agentActionOutcome": "agent-action-outcome.v1",
+    "doctorRemediationPlan": "doctor-remediation-plan-v2",
+    "artifactRemediationPlan": "artifact-remediation-plan-v1",
+    "doctorFixResult": "rapidkit-doctor-fix-result-v1"
+  }
+}

package/contracts/infra-stack.v1.json

@@ -0,0 +1,305 @@
+{
+  "schemaVersion": "rapidkit.infra-stack.v1",
+  "description": "Canonical workspace infrastructure service catalog and module/env resolution rules.",
+  "futureProfiles": [
+    "frontend-dev",
+    "edge-proxy"
+  ],
+  "services": {
+    "postgres": {
+      "displayName": "PostgreSQL",
+      "category": "database",
+      "image": "postgres:16-alpine",
+      "ports": [
+        {
+          "name": "sql",
+          "host": 5432,
+          "container": 5432
+        }
+      ],
+      "env": {
+        "POSTGRES_USER": "rapidkit",
+        "POSTGRES_PASSWORD": "rapidkit",
+        "POSTGRES_DB": "rapidkit"
+      },
+      "volumes": [
+        "postgres_data:/var/lib/postgresql/data"
+      ],
+      "healthcheck": {
+        "test": [
+          "CMD-SHELL",
+          "pg_isready -U rapidkit -d rapidkit"
+        ],
+        "interval": "10s",
+        "timeout": "5s",
+        "retries": 5
+      },
+      "connectionEnv": {
+        "DATABASE_URL": "postgresql://rapidkit:rapidkit@localhost:5432/rapidkit",
+        "RAPIDKIT_DB_POSTGRES_URL": "postgresql://rapidkit:rapidkit@localhost:5432/rapidkit"
+      }
+    },
+    "redis": {
+      "displayName": "Redis",
+      "category": "cache",
+      "image": "redis:7-alpine",
+      "ports": [
+        {
+          "name": "redis",
+          "host": 6379,
+          "container": 6379
+        }
+      ],
+      "command": [
+        "redis-server",
+        "--appendonly",
+        "yes"
+      ],
+      "volumes": [
+        "redis_data:/data"
+      ],
+      "healthcheck": {
+        "test": [
+          "CMD",
+          "redis-cli",
+          "ping"
+        ],
+        "interval": "10s",
+        "timeout": "3s",
+        "retries": 5
+      },
+      "connectionEnv": {
+        "REDIS_URL": "redis://localhost:6379/0",
+        "CELERY_BROKER_URL": "redis://localhost:6379/0",
+        "CELERY_RESULT_BACKEND": "redis://localhost:6379/1"
+      }
+    },
+    "mongo": {
+      "displayName": "MongoDB",
+      "category": "database",
+      "image": "mongo:7",
+      "ports": [
+        {
+          "name": "mongo",
+          "host": 27017,
+          "container": 27017
+        }
+      ],
+      "volumes": [
+        "mongo_data:/data/db"
+      ],
+      "connectionEnv": {
+        "MONGODB_URI": "mongodb://localhost:27017/rapidkit",
+        "MONGO_URL": "mongodb://localhost:27017/rapidkit"
+      }
+    },
+    "mysql": {
+      "displayName": "MySQL",
+      "category": "database",
+      "image": "mysql:8.4",
+      "ports": [
+        {
+          "name": "mysql",
+          "host": 3306,
+          "container": 3306
+        }
+      ],
+      "env": {
+        "MYSQL_ROOT_PASSWORD": "rapidkit",
+        "MYSQL_DATABASE": "rapidkit",
+        "MYSQL_USER": "rapidkit",
+        "MYSQL_PASSWORD": "rapidkit"
+      },
+      "healthcheck": {
+        "test": [
+          "CMD",
+          "mysqladmin",
+          "ping",
+          "-h",
+          "127.0.0.1",
+          "-urapidkit",
+          "-prapidkit"
+        ],
+        "interval": "10s",
+        "timeout": "5s",
+        "retries": 5
+      },
+      "connectionEnv": {
+        "DATABASE_URL": "mysql://rapidkit:rapidkit@localhost:3306/rapidkit"
+      }
+    },
+    "rabbitmq": {
+      "displayName": "RabbitMQ",
+      "category": "queue",
+      "image": "rabbitmq:3-management-alpine",
+      "ports": [
+        {
+          "name": "amqp",
+          "host": 5672,
+          "container": 5672
+        },
+        {
+          "name": "management",
+          "host": 15672,
+          "container": 15672
+        }
+      ],
+      "healthcheck": {
+        "test": [
+          "CMD",
+          "rabbitmq-diagnostics",
+          "-q",
+          "ping"
+        ],
+        "interval": "15s",
+        "timeout": "10s",
+        "retries": 5
+      },
+      "connectionEnv": {
+        "CELERY_BROKER_URL": "amqp://guest:guest@localhost:5672//",
+        "RABBITMQ_URL": "amqp://guest:guest@localhost:5672//"
+      }
+    },
+    "mailpit": {
+      "displayName": "Mailpit (SMTP dev)",
+      "category": "communication",
+      "image": "axllent/mailpit:latest",
+      "ports": [
+        {
+          "name": "smtp",
+          "host": 1025,
+          "container": 1025
+        },
+        {
+          "name": "ui",
+          "host": 8025,
+          "container": 8025
+        }
+      ],
+      "connectionEnv": {
+        "SMTP_HOST": "localhost",
+        "SMTP_PORT": "1025",
+        "MAIL_URL": "smtp://localhost:1025"
+      }
+    },
+    "minio": {
+      "displayName": "MinIO (S3-compatible)",
+      "category": "storage",
+      "image": "minio/minio:latest",
+      "ports": [
+        {
+          "name": "s3",
+          "host": 9000,
+          "container": 9000
+        },
+        {
+          "name": "console",
+          "host": 9001,
+          "container": 9001
+        }
+      ],
+      "command": [
+        "server",
+        "/data",
+        "--console-address",
+        ":9001"
+      ],
+      "env": {
+        "MINIO_ROOT_USER": "rapidkit",
+        "MINIO_ROOT_PASSWORD": "rapidkit-dev"
+      },
+      "volumes": [
+        "minio_data:/data"
+      ],
+      "connectionEnv": {
+        "AWS_S3_ENDPOINT": "http://localhost:9000",
+        "S3_ENDPOINT_URL": "http://localhost:9000"
+      }
+    }
+  },
+  "moduleMappings": {
+    "free/database/db_postgres": [
+      "postgres"
+    ],
+    "free/database/db_mongo": [
+      "mongo"
+    ],
+    "free/database/db_mysql": [
+      "mysql"
+    ],
+    "free/cache/redis": [
+      "redis"
+    ],
+    "free/tasks/celery": [
+      "redis"
+    ],
+    "free/tasks/workflow_engine": [
+      "postgres",
+      "redis"
+    ],
+    "free/tasks/queue_platform": [
+      "redis"
+    ],
+    "free/tasks/event_bus": [
+      "redis"
+    ],
+    "free/communication/webhook_platform": [
+      "postgres",
+      "redis"
+    ],
+    "free/communication/email": [
+      "mailpit"
+    ],
+    "free/business/storage": [
+      "minio"
+    ],
+    "free/security/audit_policy": [
+      "postgres"
+    ],
+    "free/business/approval_engine": [
+      "postgres",
+      "redis"
+    ]
+  },
+  "envVarMappings": {
+    "DATABASE_URL": [
+      "postgres"
+    ],
+    "RAPIDKIT_DB_POSTGRES_URL": [
+      "postgres"
+    ],
+    "REDIS_URL": [
+      "redis"
+    ],
+    "CELERY_BROKER_URL": [
+      "redis"
+    ],
+    "CELERY_RESULT_BACKEND": [
+      "redis"
+    ],
+    "MONGODB_URI": [
+      "mongo"
+    ],
+    "MONGO_URL": [
+      "mongo"
+    ],
+    "MYSQL_URL": [
+      "mysql"
+    ],
+    "RABBITMQ_URL": [
+      "rabbitmq"
+    ],
+    "SMTP_HOST": [
+      "mailpit"
+    ],
+    "MAIL_URL": [
+      "mailpit"
+    ],
+    "AWS_S3_ENDPOINT": [
+      "minio"
+    ],
+    "S3_ENDPOINT_URL": [
+      "minio"
+    ]
+  }
+}

package/contracts/module-layout.v1.json

@@ -0,0 +1,34 @@
+{
+  "schemaVersion": "rapidkit.module-layout.v1",
+  "canonicalModuleRoot": "src/modules/free",
+  "pathPattern": "src/modules/free/{category}/{module}",
+  "slugPattern": "free/{category}/{module}",
+  "frameworks": {
+    "fastapi": {
+      "moduleCommands": true,
+      "injectAnchors": [
+        "src/routing/__init__.py",
+        "src/modules/__init__.py"
+      ],
+      "moduleMarkerFiles": [
+        "__init__.py"
+      ]
+    },
+    "nestjs": {
+      "moduleCommands": true,
+      "injectAnchors": [
+        "src/app.module.ts",
+        "src/modules/index.ts"
+      ],
+      "moduleMarkerFiles": [
+        "index.ts",
+        "module.ts"
+      ]
+    }
+  },
+  "unsupportedModuleFrameworks": [
+    "go",
+    "springboot",
+    "dotnet"
+  ]
+}