@atlashub/smartstack-cli 3.33.0 → 3.35.0

package/templates/skills/business-analyse/schemas/project-schema.json

@@ -0,0 +1,490 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "project-schema.json",
+  "title": "SmartStack Business Analysis - Project Level",
+  "description": "Master feature.json for multi-application project analysis. Published to docs/business-analyse/v{X.Y}/feature.json. Only created when 2+ applications are identified.",
+  "type": "object",
+  "required": ["id", "version", "status", "scope", "metadata"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^PROJ-\\d{3,}$",
+      "description": "Unique project identifier (e.g., PROJ-001)"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+$",
+      "description": "Document version (e.g., 1.0, 1.1)"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "framed", "decomposed", "specified", "consolidated", "handed-off"],
+      "description": "Project-level lifecycle status"
+    },
+    "scope": {
+      "type": "string",
+      "const": "project",
+      "description": "Marks this as a project-level feature.json (multi-application)"
+    },
+
+    "metadata": {
+      "type": "object",
+      "required": ["createdAt", "updatedAt", "projectName", "language"],
+      "properties": {
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": { "type": "string", "format": "date-time" },
+        "projectName": { "type": "string", "description": "Project name (e.g., Enterprise HR Platform)" },
+        "language": { "type": "string", "enum": ["fr", "en", "it", "de"] },
+        "featureDescription": { "type": "string", "description": "Original user description/brief" },
+        "workflowType": {
+          "type": "string",
+          "enum": ["new", "update"],
+          "description": "Whether this is a new project or an update"
+        },
+        "mcpAvailable": { "type": "boolean" },
+        "analysisMode": {
+          "type": "string",
+          "const": "interactive",
+          "description": "Analysis mode — always interactive"
+        },
+        "workflow": {
+          "type": "object",
+          "description": "Multi-application loop state",
+          "properties": {
+            "mode": { "type": "string", "const": "project" },
+            "applicationOrder": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Topologically sorted application codes"
+            },
+            "currentApplicationIndex": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Index into applicationOrder for current application being processed"
+            },
+            "completedApplications": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Application codes that have been fully specified (all modules done)"
+            },
+            "currentApplication": {
+              "type": ["string", "null"],
+              "description": "Code of the application currently being processed"
+            }
+          }
+        },
+        "steps": {
+          "type": "object",
+          "description": "Progress tracking per step",
+          "properties": {
+            "init": { "$ref": "#/$defs/stepStatus" },
+            "cadrage": { "$ref": "#/$defs/stepStatus" },
+            "applicationDecomposition": { "$ref": "#/$defs/stepStatus" },
+            "specify": { "$ref": "#/$defs/stepStatus" },
+            "consolidation": { "$ref": "#/$defs/stepStatus" },
+            "handoff": { "$ref": "#/$defs/stepStatus" }
+          }
+        }
+      }
+    },
+
+    "cadrage": {
+      "type": "object",
+      "description": "Enriched by step-01-cadrage: project-level global framing",
+      "properties": {
+        "problem": { "type": "string", "description": "Global business problem to solve" },
+        "asIs": { "type": "string", "description": "Current situation across all domains" },
+        "toBe": { "type": "string", "description": "Target situation for the full project" },
+        "trigger": { "type": "string", "description": "What triggered this project" },
+        "stakeholders": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["role"],
+            "properties": {
+              "role": { "type": "string" },
+              "function": { "type": "string" },
+              "involvement": { "type": "string", "enum": ["approver", "decision-maker", "consulted", "informed", "end-user"] },
+              "tasks": { "type": "array", "items": { "type": "string" } },
+              "frequency": { "type": "string" },
+              "painPoints": { "type": "array", "items": { "type": "string" } },
+              "applications": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "Application codes this stakeholder is involved in (empty = all)"
+              }
+            }
+          }
+        },
+        "globalScope": {
+          "type": "object",
+          "description": "Project-wide MoSCoW scope",
+          "properties": {
+            "mustHave": { "type": "array", "items": { "type": "string" } },
+            "shouldHave": { "type": "array", "items": { "type": "string" } },
+            "couldHave": { "type": "array", "items": { "type": "string" } },
+            "outOfScope": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "globalRoles": {
+          "type": "array",
+          "description": "Cross-application roles (may span multiple applications)",
+          "items": {
+            "type": "object",
+            "required": ["role", "level"],
+            "properties": {
+              "role": { "type": "string", "description": "Role name (e.g., System Admin)" },
+              "description": { "type": "string" },
+              "level": { "type": "string", "enum": ["admin", "manager", "contributor", "viewer"] },
+              "applications": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "Application codes this role applies to (empty = all)"
+              }
+            }
+          }
+        },
+        "risks": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "type", "description"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^RISK-\\d{3}$" },
+              "type": { "type": "string", "enum": ["business", "technical", "organizational"] },
+              "description": { "type": "string" },
+              "probability": { "type": "string", "enum": ["high", "medium", "low"] },
+              "impact": { "type": "string", "enum": ["high", "medium", "low"] },
+              "priority": { "type": "string", "enum": ["critical", "medium", "low"] },
+              "mitigation": { "type": "string" },
+              "applications": {
+                "type": "array",
+                "items": { "type": "string" },
+                "description": "Affected application codes (empty = project-wide)"
+              }
+            }
+          }
+        },
+        "acceptanceCriteria": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "criterion"],
+            "properties": {
+              "id": { "type": "string", "pattern": "^AC-\\d{3}$" },
+              "criterion": { "type": "string" },
+              "validated": { "type": "boolean", "default": false }
+            }
+          }
+        },
+        "codebaseContext": {
+          "type": "string",
+          "description": "Summary of existing applications/modules found during pre-research"
+        },
+        "coverageMatrix": {
+          "type": "array",
+          "description": "Maps every requirement to an application and optionally a module",
+          "items": {
+            "type": "object",
+            "required": ["item", "category"],
+            "properties": {
+              "item": { "type": "string", "description": "Requirement from the original brief" },
+              "category": { "type": "string", "enum": ["mustHave", "shouldHave", "couldHave", "outOfScope", "implicit"] },
+              "application": { "type": ["string", "null"], "description": "Application code (null if cross-cutting)" },
+              "module": { "type": ["string", "null"], "description": "Module code (null if application-level)" },
+              "notes": { "type": "string" },
+              "anticipatedSections": {
+                "type": "array",
+                "items": { "type": "string" }
+              },
+              "anticipatedResources": {
+                "type": "array",
+                "items": { "type": "string" }
+              }
+            }
+          }
+        },
+        "deploymentModel": {
+          "type": "string",
+          "enum": ["together", "phased"],
+          "description": "Whether applications are deployed together or in phases"
+        },
+        "sharedInfrastructure": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Shared infrastructure concerns (e.g., SSO, notifications, shared DB)"
+        }
+      }
+    },
+
+    "applications": {
+      "type": "array",
+      "description": "Enriched by step-01b-applications: application registry",
+      "items": {
+        "type": "object",
+        "required": ["code", "name", "context"],
+        "properties": {
+          "code": { "type": "string", "description": "Application code (PascalCase, e.g., HumanResources)" },
+          "name": { "type": "string", "description": "Display name (e.g., Ressources Humaines)" },
+          "context": {
+            "type": "string",
+            "enum": ["business", "platform", "personal"],
+            "description": "Navigation context for this application"
+          },
+          "tablePrefix": {
+            "type": "string",
+            "pattern": "^[a-z]{2,5}_$",
+            "description": "Table prefix for this application (e.g., rh_, ess_)"
+          },
+          "icon": { "type": "string", "description": "Icon identifier for navigation" },
+          "description": { "type": "string" },
+          "applicationRoles": {
+            "type": "array",
+            "description": "Application-specific roles (inherited from globalRoles + specialized)",
+            "items": {
+              "type": "object",
+              "required": ["role", "level"],
+              "properties": {
+                "role": { "type": "string" },
+                "description": { "type": "string" },
+                "level": { "type": "string", "enum": ["admin", "manager", "contributor", "viewer"] },
+                "permissionPattern": { "type": "string" }
+              }
+            }
+          },
+          "scope": {
+            "type": "object",
+            "description": "Application-specific scope (subset of global scope)",
+            "properties": {
+              "mustHave": { "type": "array", "items": { "type": "string" } },
+              "shouldHave": { "type": "array", "items": { "type": "string" } },
+              "couldHave": { "type": "array", "items": { "type": "string" } }
+            }
+          },
+          "modules": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Module codes belonging to this application (populated during step-02)"
+          },
+          "dependencies": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Application codes this application depends on"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["pending", "in-progress", "decomposed", "specified", "consolidated"],
+            "description": "Application processing status within the project"
+          },
+          "featureJsonPath": {
+            "type": ["string", "null"],
+            "description": "Path to the application-level feature.json once created"
+          },
+          "estimatedComplexity": {
+            "type": "string",
+            "enum": ["simple", "medium", "complex"]
+          }
+        }
+      }
+    },
+
+    "applicationDependencyGraph": {
+      "type": "object",
+      "description": "Enriched by step-01b-applications: inter-application dependency graph",
+      "properties": {
+        "edges": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["from", "to", "type"],
+            "properties": {
+              "from": { "type": "string", "description": "Dependent application code" },
+              "to": { "type": "string", "description": "Dependency application code" },
+              "type": {
+                "type": "string",
+                "enum": ["data-dependency", "shared-entity", "event", "auth-dependency"],
+                "description": "Nature of the inter-application dependency"
+              },
+              "description": { "type": "string" }
+            }
+          }
+        },
+        "topologicalOrder": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Applications sorted by dependency (foundations first)"
+        },
+        "layers": {
+          "type": "array",
+          "description": "Applications grouped by dependency depth",
+          "items": {
+            "type": "object",
+            "properties": {
+              "layer": { "type": "integer" },
+              "applications": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    },
+
+    "consolidation": {
+      "type": "object",
+      "description": "Enriched by step-04: cross-application and cross-module validation",
+      "properties": {
+        "crossApplicationInteractions": {
+          "type": "array",
+          "description": "Interactions between different applications",
+          "items": {
+            "type": "object",
+            "properties": {
+              "fromApplication": { "type": "string" },
+              "toApplication": { "type": "string" },
+              "interactionType": { "type": "string", "enum": ["shared-entity", "FK-reference", "event", "auth-delegation", "data-sync"] },
+              "description": { "type": "string" },
+              "entities": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "crossModuleInteractions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "fromApplication": { "type": "string" },
+              "fromModule": { "type": "string" },
+              "toApplication": { "type": "string" },
+              "toModule": { "type": "string" },
+              "interactionType": { "type": "string", "enum": ["FK-reference", "event-publish", "event-subscribe", "shared-lookup", "cascade-delete", "cascade-update"] },
+              "description": { "type": "string" },
+              "entities": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "sharedEntities": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "entity": { "type": "string" },
+              "ownerApplication": { "type": "string" },
+              "ownerModule": { "type": "string" },
+              "referencedBy": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "application": { "type": "string" },
+                    "module": { "type": "string" }
+                  }
+                }
+              },
+              "sharedFields": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "permissionCoherence": {
+          "type": "object",
+          "properties": {
+            "rolesConsistent": { "type": "boolean" },
+            "pathFormatConsistent": { "type": "boolean" },
+            "hierarchyRespected": { "type": "boolean" },
+            "crossAppConflicts": { "type": "array", "items": { "type": "string" } },
+            "warnings": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "e2eFlows": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string" },
+              "applications": { "type": "array", "items": { "type": "string" } },
+              "modules": { "type": "array", "items": { "type": "string" } },
+              "steps": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "application": { "type": "string" },
+                    "module": { "type": "string" },
+                    "action": { "type": "string" },
+                    "permission": { "type": "string" },
+                    "dataFlow": { "type": "string" }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "globalRiskAssessment": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "risk": { "type": "string" },
+              "category": { "type": "string", "enum": ["coupling", "complexity", "dependency-chain", "security", "scope", "cross-app-coupling"] },
+              "severity": { "type": "string", "enum": ["critical", "high", "medium", "low"] },
+              "mitigation": { "type": "string" }
+            }
+          }
+        },
+        "decision": {
+          "type": "object",
+          "properties": {
+            "approved": { "type": "boolean" },
+            "reason": { "type": "string" },
+            "approvedBy": { "type": "string" },
+            "approvedAt": { "type": "string", "format": "date-time" }
+          }
+        }
+      }
+    },
+
+    "suggestions": {
+      "type": "array",
+      "description": "Proactive AI suggestions for complementary applications/modules",
+      "items": {
+        "type": "object",
+        "required": ["type", "code", "reason"],
+        "properties": {
+          "type": { "type": "string", "enum": ["application", "module", "integration", "enhancement"] },
+          "code": { "type": "string" },
+          "title": { "type": "string" },
+          "reason": { "type": "string" },
+          "targetApplication": { "type": ["string", "null"], "description": "Application code for module-level suggestions" },
+          "accepted": { "type": ["boolean", "null"] }
+        }
+      }
+    },
+
+    "changelog": {
+      "type": "array",
+      "description": "Version history and change tracking",
+      "items": {
+        "type": "object",
+        "required": ["timestamp", "changes"],
+        "properties": {
+          "step": { "type": "string" },
+          "version": { "type": "string" },
+          "timestamp": { "type": "string", "format": "date-time" },
+          "author": { "type": "string" },
+          "changes": { "type": "array", "items": { "type": "string" } },
+          "warnings": { "type": "array", "items": { "type": "string" } },
+          "decision": { "type": "string" }
+        }
+      }
+    }
+  },
+
+  "$defs": {
+    "stepStatus": {
+      "type": "object",
+      "properties": {
+        "status": { "type": "string", "enum": ["pending", "in-progress", "completed", "skipped"] },
+        "startedAt": { "type": ["string", "null"], "format": "date-time" },
+        "completedAt": { "type": ["string", "null"], "format": "date-time" }
+      }
+    }
+  }
+}

package/templates/skills/business-analyse/schemas/sections/metadata-schema.json

@@ -13,7 +13,8 @@
         "updatedAt": { "type": "string", "format": "date-time" },
         "application": { "type": "string", "description": "Application name (PascalCase)" },
         "module": { "type": "string", "description": "Module name (PascalCase)" },
-        "context": { "type": "string", "const": "business" },
+        "context": { "type": "string", "enum": ["business", "platform", "personal"], "description": "Navigation context (inherited from application)" },
+        "projectRef": { "type": ["string", "null"], "description": "Parent project ID (PROJ-XXX) when part of a multi-application project" },
         "language": { "type": "string", "enum": ["fr", "en", "it", "de"] },
         "featureDescription": { "type": "string" },
         "featureType": {