@atlashub/smartstack-cli 2.3.0 → 2.4.0

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

@@ -0,0 +1,389 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "application-schema.json",
+  "title": "SmartStack Business Analysis - Application Level",
+  "description": "Master feature.json for multi-module application analysis. Published to docs/business/{app}/business-analyse/v{X.Y}/feature.json",
+  "type": "object",
+  "required": ["id", "version", "status", "scope", "metadata"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^FEAT-\\d{3,}$",
+      "description": "Unique feature identifier (e.g., FEAT-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": "Application-level lifecycle status"
+    },
+    "scope": {
+      "type": "string",
+      "const": "application",
+      "description": "Marks this as an application-level feature.json"
+    },
+
+    "metadata": {
+      "type": "object",
+      "required": ["createdAt", "updatedAt", "application", "context", "language", "featureDescription"],
+      "properties": {
+        "createdAt": { "type": "string", "format": "date-time" },
+        "updatedAt": { "type": "string", "format": "date-time" },
+        "application": { "type": "string", "description": "Application name (PascalCase)" },
+        "context": { "type": "string", "const": "business" },
+        "language": { "type": "string", "enum": ["fr", "en", "it", "de"] },
+        "featureDescription": { "type": "string" },
+        "useCase": {
+          "type": "string",
+          "enum": ["application", "new", "refactoring"],
+          "description": "Which use case triggered this analysis"
+        },
+        "mcpAvailable": { "type": "boolean" },
+        "economyMode": { "type": "boolean" },
+        "workflow": {
+          "type": "object",
+          "description": "Iterative module loop state",
+          "properties": {
+            "mode": { "type": "string", "enum": ["application", "module"] },
+            "moduleOrder": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Topologically sorted module codes"
+            },
+            "currentModuleIndex": {
+              "type": "integer",
+              "minimum": 0,
+              "description": "Index into moduleOrder for current module being specified"
+            },
+            "completedModules": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Module codes that have been fully specified"
+            },
+            "currentModule": {
+              "type": ["string", "null"],
+              "description": "Code of the module currently being specified"
+            }
+          }
+        },
+        "steps": {
+          "type": "object",
+          "description": "Progress tracking per step",
+          "properties": {
+            "init": { "$ref": "#/$defs/stepStatus" },
+            "cadrage": { "$ref": "#/$defs/stepStatus" },
+            "decomposition": { "$ref": "#/$defs/stepStatus" },
+            "specify": { "$ref": "#/$defs/stepStatus" },
+            "consolidation": { "$ref": "#/$defs/stepStatus" },
+            "handoff": { "$ref": "#/$defs/stepStatus" }
+          }
+        }
+      }
+    },
+
+    "cadrage": {
+      "type": "object",
+      "description": "Enriched by step-01-cadrage: application-level framing",
+      "properties": {
+        "problem": { "type": "string", "description": "Business problem to solve" },
+        "asIs": { "type": "string", "description": "Current situation" },
+        "toBe": { "type": "string", "description": "Target situation" },
+        "trigger": { "type": "string", "description": "What triggered this need" },
+        "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" } }
+            }
+          }
+        },
+        "globalScope": {
+          "type": "object",
+          "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" } }
+          }
+        },
+        "applicationRoles": {
+          "type": "array",
+          "description": "Application-level roles (defined once, inherited by all modules)",
+          "items": {
+            "type": "object",
+            "required": ["role", "level"],
+            "properties": {
+              "role": { "type": "string", "description": "Role name (e.g., Sales Admin)" },
+              "description": { "type": "string" },
+              "level": { "type": "string", "enum": ["admin", "manager", "contributor", "viewer"], "description": "Permission hierarchy level" },
+              "permissionPattern": { "type": "string", "description": "Permission pattern (e.g., business.sales.* for admin)" }
+            }
+          }
+        },
+        "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" }
+            }
+          }
+        },
+        "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 modules/patterns found during pre-research"
+        }
+      }
+    },
+
+    "modules": {
+      "type": "array",
+      "description": "Enriched by step-02-decomposition: module registry with dependencies",
+      "items": {
+        "type": "object",
+        "required": ["code", "description"],
+        "properties": {
+          "code": { "type": "string", "description": "Module code (PascalCase, e.g., Customers)" },
+          "description": { "type": "string" },
+          "featureType": {
+            "type": "string",
+            "enum": ["data-centric", "integration", "ui-centric", "workflow", "reporting", "full-module"],
+            "description": "Estimated module type"
+          },
+          "dependencies": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Module codes this module depends on (FK, events)"
+          },
+          "dependents": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Module codes that depend on this module"
+          },
+          "status": {
+            "type": "string",
+            "enum": ["pending", "in-progress", "specified", "validated"],
+            "description": "Module specification status within the iterative loop"
+          },
+          "featureJsonPath": {
+            "type": ["string", "null"],
+            "description": "Path to the module-level feature.json once created"
+          },
+          "priority": {
+            "type": "string",
+            "enum": ["must", "should", "could"],
+            "description": "MoSCoW priority from global scope"
+          },
+          "sortOrder": {
+            "type": "integer",
+            "description": "Position in topological order (0-based)"
+          },
+          "entities": {
+            "type": "array",
+            "items": { "type": "string" },
+            "description": "Anticipated entity names (from decomposition, refined in specification)"
+          },
+          "estimatedComplexity": {
+            "type": "string",
+            "enum": ["simple", "medium", "complex"]
+          }
+        }
+      }
+    },
+
+    "dependencyGraph": {
+      "type": "object",
+      "description": "Enriched by step-02-decomposition: module dependency graph",
+      "properties": {
+        "edges": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["from", "to", "type"],
+            "properties": {
+              "from": { "type": "string", "description": "Dependent module code" },
+              "to": { "type": "string", "description": "Dependency module code" },
+              "type": { "type": "string", "enum": ["FK", "event", "shared-entity", "lookup"], "description": "Nature of the dependency" }
+            }
+          }
+        },
+        "topologicalOrder": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Modules sorted by dependency (foundations first)"
+        },
+        "layers": {
+          "type": "array",
+          "description": "Modules grouped by dependency depth",
+          "items": {
+            "type": "object",
+            "properties": {
+              "layer": { "type": "integer" },
+              "modules": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        }
+      }
+    },
+
+    "consolidation": {
+      "type": "object",
+      "description": "Enriched by step-04-consolidation: cross-module validation",
+      "properties": {
+        "crossModuleInteractions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "fromModule": { "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" },
+              "ownerModule": { "type": "string" },
+              "referencedBy": { "type": "array", "items": { "type": "string" } },
+              "sharedFields": { "type": "array", "items": { "type": "string" } }
+            }
+          }
+        },
+        "permissionCoherence": {
+          "type": "object",
+          "properties": {
+            "rolesConsistent": { "type": "boolean" },
+            "pathFormatConsistent": { "type": "boolean" },
+            "hierarchyRespected": { "type": "boolean" },
+            "conflicts": { "type": "array", "items": { "type": "string" } },
+            "warnings": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "e2eFlows": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": { "type": "string", "description": "Flow name (e.g., Create Order to Invoice)" },
+              "modules": { "type": "array", "items": { "type": "string" } },
+              "steps": {
+                "type": "array",
+                "items": {
+                  "type": "object",
+                  "properties": {
+                    "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"] },
+              "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 modules/sections",
+      "items": {
+        "type": "object",
+        "required": ["type", "code", "reason"],
+        "properties": {
+          "type": { "type": "string", "enum": ["module", "section", "integration", "enhancement"] },
+          "code": { "type": "string" },
+          "title": { "type": "string" },
+          "reason": { "type": "string" },
+          "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/feature-schema.json

@@ -18,9 +18,15 @@
     },
     "status": {
       "type": "string",
-      "enum": ["draft", "analysed", "specified", "approved", "handed-off"],
+      "enum": ["draft", "framed", "analysed", "specified", "approved", "consolidated", "handed-off"],
       "description": "Current lifecycle status, enriched by each step"
     },
+    "scope": {
+      "type": "string",
+      "enum": ["application", "module"],
+      "default": "module",
+      "description": "Scope of this feature.json: application (master) or module (detailed)"
+    },
 
     "metadata": {
       "type": "object",
@@ -57,12 +63,35 @@
         },
         "mcpAvailable": { "type": "boolean" },
         "economyMode": { "type": "boolean" },
+        "scope": {
+          "type": "string",
+          "enum": ["application", "module"],
+          "default": "module",
+          "description": "Explicitly marks this as module-scope"
+        },
+        "applicationRef": {
+          "type": ["string", "null"],
+          "description": "Reference to parent application feature ID (FEAT-XXX) when part of multi-module analysis"
+        },
+        "applicationPath": {
+          "type": ["string", "null"],
+          "description": "Path to the parent application-level feature.json"
+        },
+        "moduleIndex": {
+          "type": ["integer", "null"],
+          "description": "Position in topological order within the application (0-based)"
+        },
+        "inheritsRoles": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether roles are inherited from application-level (true for multi-module)"
+        },
         "steps": {
           "type": "object",
           "description": "Progress tracking per step",
           "properties": {
             "init": { "$ref": "#/$defs/stepStatus" },
-            "analyse": { "$ref": "#/$defs/stepStatus" },
+            "cadrage": { "$ref": "#/$defs/stepStatus" },
             "specify": { "$ref": "#/$defs/stepStatus" },
             "validate": { "$ref": "#/$defs/stepStatus" },
             "handoff": { "$ref": "#/$defs/stepStatus" }
@@ -71,6 +100,35 @@
       }
     },
 
+    "applicationContext": {
+      "type": "object",
+      "description": "Inherited from parent application feature.json when part of multi-module analysis",
+      "properties": {
+        "applicationRoles": {
+          "type": "array",
+          "description": "Copied from master feature.json for reference",
+          "items": {
+            "type": "object",
+            "properties": {
+              "role": { "type": "string" },
+              "description": { "type": "string" },
+              "level": { "type": "string", "enum": ["admin", "manager", "contributor", "viewer"] },
+              "permissionPattern": { "type": "string" }
+            }
+          }
+        },
+        "permissionBase": {
+          "type": "string",
+          "description": "Application-level permission base (e.g., business.sales)"
+        },
+        "relatedModules": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Other modules in the same application"
+        }
+      }
+    },
+
     "discovery": {
       "type": "object",
       "description": "Enriched by step-01-analyse (discovery part)",
@@ -518,7 +576,20 @@
               "description": { "type": "string" },
               "elements": { "type": "array", "items": { "type": "string" } },
               "actions": { "type": "array", "items": { "type": "string" } },
-              "permissionsRequired": { "type": "array", "items": { "type": "string" } }
+              "permissionsRequired": { "type": "array", "items": { "type": "string" } },
+              "mockupFormat": {
+                "type": "string",
+                "enum": ["ascii", "svg"],
+                "description": "Format of the mockup: ascii (rendered in <pre>) or svg (rendered as inline SVG)"
+              },
+              "mockup": {
+                "type": "string",
+                "description": "ASCII art or SVG markup of the wireframe"
+              },
+              "section": {
+                "type": "string",
+                "description": "Navigation section this wireframe belongs to (e.g., list, detail, create)"
+              }
             }
           }
         },