workspai 0.43.1 → 0.44.0

package/contracts/infra-plan.v1.json

@@ -0,0 +1,189 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "workspacePath",
+    "strategy",
+    "composePath",
+    "envExamplePath",
+    "services",
+    "connectionEnv",
+    "sources",
+    "warnings"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "rapidkit.infra-plan.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "workspacePath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "workspaceName": {
+      "type": "string",
+      "minLength": 1
+    },
+    "contractPath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "strategy": {
+      "const": "sidecar"
+    },
+    "composePath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "envExamplePath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "services": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "id",
+          "displayName",
+          "category",
+          "image",
+          "ports",
+          "sources"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "displayName": {
+            "type": "string",
+            "minLength": 1
+          },
+          "category": {
+            "type": "string",
+            "minLength": 1
+          },
+          "image": {
+            "type": "string",
+            "minLength": 1
+          },
+          "ports": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "name",
+                "host",
+                "container"
+              ],
+              "properties": {
+                "name": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "host": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 65535
+                },
+                "container": {
+                  "type": "integer",
+                  "minimum": 1,
+                  "maximum": 65535
+                }
+              },
+              "additionalProperties": false
+            }
+          },
+          "sources": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": [
+                "kind",
+                "value"
+              ],
+              "properties": {
+                "kind": {
+                  "enum": [
+                    "module",
+                    "env-var",
+                    "override",
+                    "contract-env"
+                  ]
+                },
+                "value": {
+                  "type": "string",
+                  "minLength": 1
+                },
+                "project": {
+                  "type": "string",
+                  "minLength": 1
+                }
+              },
+              "additionalProperties": false
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "connectionEnv": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "sources": {
+      "type": "object",
+      "required": [
+        "modules",
+        "envVars",
+        "overrides"
+      ],
+      "properties": {
+        "modules": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "envVars": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "overrides": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "warnings": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "serviceEnvOverrides": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "string"
+        }
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/contracts/private-product-manifest.v1.json

@@ -0,0 +1,155 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "product",
+    "workspace",
+    "projects",
+    "factory"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "rapidkit.private-product-manifest.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "product": {
+      "type": "object",
+      "required": [
+        "rank",
+        "slug",
+        "title",
+        "category",
+        "tier",
+        "summary"
+      ],
+      "properties": {
+        "rank": {
+          "type": "number"
+        },
+        "slug": {
+          "type": "string",
+          "minLength": 1
+        },
+        "title": {
+          "type": "string",
+          "minLength": 1
+        },
+        "category": {
+          "type": "string",
+          "minLength": 1
+        },
+        "tier": {
+          "type": "string",
+          "minLength": 1
+        },
+        "summary": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "workspace": {
+      "type": "object",
+      "required": [
+        "name",
+        "profile",
+        "outputHint"
+      ],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1
+        },
+        "profile": {
+          "const": "enterprise"
+        },
+        "outputHint": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    },
+    "projects": {
+      "type": "array",
+      "minItems": 1,
+      "maxItems": 1,
+      "items": {
+        "type": "object",
+        "required": [
+          "slug",
+          "kit",
+          "runtime",
+          "framework",
+          "modules",
+          "moduleGaps"
+        ],
+        "properties": {
+          "slug": {
+            "const": "api"
+          },
+          "kit": {
+            "type": "string",
+            "minLength": 1
+          },
+          "runtime": {
+            "const": "python"
+          },
+          "framework": {
+            "const": "fastapi"
+          },
+          "modules": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "moduleGaps": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "factory": {
+      "type": "object",
+      "required": [
+        "sourceBacklogPath",
+        "manifestChecksum",
+        "requiredCommands",
+        "releaseEvidencePath"
+      ],
+      "properties": {
+        "sourceBacklogPath": {
+          "type": "string",
+          "minLength": 1
+        },
+        "manifestChecksum": {
+          "type": "string",
+          "pattern": "^sha256:[a-f0-9]{64}$"
+        },
+        "requiredCommands": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "releaseEvidencePath": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": true
+}

package/contracts/product-factory-plan.v1.json

@@ -0,0 +1,200 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "generatedAt",
+    "source",
+    "defaults",
+    "stats",
+    "products"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": "rapidkit.product-factory-plan.v1"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "source": {
+      "type": "object",
+      "required": [
+        "backlogPath",
+        "backlogSchemaVersion",
+        "purpose",
+        "publicationRule"
+      ],
+      "properties": {
+        "backlogPath": {
+          "type": "string",
+          "minLength": 1
+        },
+        "backlogSchemaVersion": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "purpose": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "publicationRule": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "additionalProperties": false
+    },
+    "defaults": {
+      "type": "object",
+      "required": [
+        "kit",
+        "workspaceProfile",
+        "projectSlug"
+      ],
+      "properties": {
+        "kit": {
+          "type": "string",
+          "minLength": 1
+        },
+        "workspaceProfile": {
+          "const": "enterprise"
+        },
+        "projectSlug": {
+          "const": "api"
+        }
+      },
+      "additionalProperties": false
+    },
+    "stats": {
+      "type": "object",
+      "required": [
+        "totalProducts",
+        "plannedProducts",
+        "readyProducts",
+        "blockedProducts",
+        "uniqueModules",
+        "knownModuleGaps"
+      ],
+      "properties": {
+        "totalProducts": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "plannedProducts": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "readyProducts": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "blockedProducts": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "uniqueModules": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "knownModuleGaps": {
+          "type": "integer",
+          "minimum": 0
+        }
+      },
+      "additionalProperties": false
+    },
+    "products": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "rank",
+          "slug",
+          "title",
+          "category",
+          "tier",
+          "summary",
+          "modules",
+          "moduleGaps",
+          "recommendedKit",
+          "workspaceProfile",
+          "readiness"
+        ],
+        "properties": {
+          "rank": {
+            "type": "number"
+          },
+          "slug": {
+            "type": "string",
+            "minLength": 1
+          },
+          "title": {
+            "type": "string",
+            "minLength": 1
+          },
+          "category": {
+            "type": "string",
+            "minLength": 1
+          },
+          "tier": {
+            "type": "string",
+            "minLength": 1
+          },
+          "summary": {
+            "type": "string"
+          },
+          "modules": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "moduleGaps": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            }
+          },
+          "recommendedKit": {
+            "type": "string",
+            "minLength": 1
+          },
+          "workspaceProfile": {
+            "const": "enterprise"
+          },
+          "readiness": {
+            "type": "object",
+            "required": [
+              "status",
+              "blockingGaps"
+            ],
+            "properties": {
+              "status": {
+                "enum": [
+                  "ready-for-private-manifest",
+                  "blocked-by-module-gaps"
+                ]
+              },
+              "blockingGaps": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "additionalProperties": false
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/contracts/project-archive.v1.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "required": [
+    "schema",
+    "projectName",
+    "originalPath",
+    "archivedPath",
+    "archivedAt"
+  ],
+  "properties": {
+    "schema": {
+      "const": "rapidkit-project-archive-v1"
+    },
+    "projectName": {
+      "type": "string",
+      "minLength": 1
+    },
+    "originalPath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "archivedPath": {
+      "type": "string",
+      "minLength": 1
+    },
+    "reason": {
+      "type": "string"
+    },
+    "archivedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "safetySnapshotPath": {
+      "type": "string",
+      "minLength": 1
+    }
+  },
+  "additionalProperties": false
+}

package/contracts/project-entry-capability.v1.json

@@ -0,0 +1,127 @@
+{
+  "schemaVersion": "workspai-project-entry-capability-v1",
+  "name": "Project Entry Capability",
+  "plainLanguageRule": "Any readable project can enter Workspace Intelligence through adopt/import. Runtime-specific detection improves understanding depth; it is not the permission gate.",
+  "entryRoutes": [
+    {
+      "id": "create",
+      "status": "available",
+      "purpose": "Start a new project only through native kits or available official generator paths listed in the create planner contract.",
+      "commands": [
+        "create workspace",
+        "create project"
+      ]
+    },
+    {
+      "id": "adopt",
+      "status": "available",
+      "purpose": "Register an existing local project in place without moving or rewriting its source.",
+      "commands": [
+        "adopt"
+      ]
+    },
+    {
+      "id": "import",
+      "status": "available",
+      "purpose": "Attach an existing project, repository folder, or imported path to a workspace inventory.",
+      "commands": [
+        "import",
+        "workspace import"
+      ]
+    }
+  ],
+  "universalExistingProjectEntry": {
+    "status": "available",
+    "appliesTo": [
+      "any readable repository",
+      "any readable local project folder",
+      "monorepos and multi-project workspaces",
+      "known runtimes, unknown runtimes, and mixed stacks"
+    ],
+    "minimumConditions": [
+      "The path is readable by the CLI.",
+      "The workspace can write Workspai metadata or record an external adopted path.",
+      "The project can be represented with at least a name, path, and entry record."
+    ],
+    "doesNotRequire": [
+      "native scaffold support",
+      "official generator support",
+      "module command support",
+      "a known runtime detector",
+      "moving source files into the workspace"
+    ],
+    "result": [
+      "project registry membership",
+      "workspace model participation",
+      "workspace context participation",
+      "governance and evidence participation according to available facts"
+    ]
+  },
+  "supportDepths": [
+    {
+      "id": "registered",
+      "label": "Registered",
+      "meaning": "The project is known to the workspace and can participate in inventory, context, and governance.",
+      "examples": [
+        "unknown runtime",
+        "custom stack",
+        "legacy service"
+      ]
+    },
+    {
+      "id": "detected",
+      "label": "Detected",
+      "meaning": "The CLI recognizes runtime or framework signals and can label the project with higher confidence.",
+      "examples": [
+        "node package.json",
+        "python pyproject.toml",
+        "php composer.json"
+      ]
+    },
+    {
+      "id": "operational",
+      "label": "Operational",
+      "meaning": "The CLI can infer or use lifecycle commands, health checks, or workspace run stages.",
+      "examples": [
+        "test script",
+        "build script",
+        "doctor evidence"
+      ]
+    },
+    {
+      "id": "deep",
+      "label": "Deep",
+      "meaning": "The project has stack-specific module, doctor, or scaffold support beyond generic Workspace Intelligence.",
+      "examples": [
+        "FastAPI module support",
+        "NestJS module support",
+        "native Workspai kit"
+      ]
+    }
+  ],
+  "runtimeSignals": {
+    "purpose": "Help the planner and model recognize common existing-project requests and improve labels.",
+    "examples": [
+      "php",
+      "ruby",
+      "rust",
+      "elixir",
+      "clojure",
+      "scala",
+      "kotlin"
+    ],
+    "rule": "Runtime signals are examples for detection and messaging, not a closed allowlist for adopt/import."
+  },
+  "boundaries": {
+    "allowedClaims": [
+      "Any readable project can enter Workspace Intelligence through adopt/import when it can be registered.",
+      "Known runtime and framework detectors improve confidence and depth, but unknown projects can still be registered.",
+      "Create support is limited to native kits and available official generator paths in the create planner contract."
+    ],
+    "forbiddenClaims": [
+      "Do not say adopt/import supports only the listed runtime signals.",
+      "Do not say every imported project receives deep runtime-specific module support.",
+      "Do not say Workspai can natively scaffold every language or framework."
+    ]
+  }
+}