@atlashub/smartstack-cli 3.32.0 → 3.34.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": {

package/templates/skills/business-analyse/steps/step-00-init.md

@@ -85,7 +85,8 @@ mcp__smartstack__validate_conventions({ checks: ["tables"] })
 
 Execute workflow detection algorithm:
 1. **Review Mode Detection:** Check if `{feature_description}` starts with `-review`
-2. **Existing Applications Scanner:** Glob `docs/business/*/business-analyse/*/feature.json`
+2. **Existing Projects Scanner:** Glob `docs/business-analyse/*/feature.json` (project-level)
+2b. **Existing Applications Scanner:** Glob `docs/business/*/business-analyse/*/feature.json` + `docs/platform/*/business-analyse/*/feature.json` + `docs/personal/*/business-analyse/*/feature.json`
 3. **Similarity Analysis:** Score user intent against existing apps (>= 80 = strong match)
 4. **Decision Tree:** Prompt user with relevant options
 
@@ -119,11 +120,15 @@ ELSE:
 ```yaml
 workflow_type: "new" | "update" | "review"
 existing_feature_id: string | null
+existing_project_id: string | null  # PROJ-NNN if resuming a project
 version: "1.0" (new) | "1.1"+ (update)
 review_json_path: string | null (review only)
 existing_apps: array of { app, featureId, description, version }
+existing_projects: array of { projectName, projectId, applications[], version }
 ```
 
+> **Project Resume Detection:** If a project-level feature.json is found at `docs/business-analyse/*/feature.json`, check its `metadata.workflow` to determine resume point. The project may have partially completed applications.
+
 ## Step 4: Determine Application Name
 
 ```
@@ -372,9 +377,11 @@ version: string
 
 If initialization was interrupted:
 
-1. Check `.business-analyse/config.json` for currentFeature
-2. If feature ID exists, search for feature.json in `docs/business/`
-3. If found, check status and `metadata.workflow.lastCompletedStep`:
+1. Check `.business-analyse/config.json` for currentFeature or currentProject
+2. If project ID exists, search for project feature.json in `docs/business-analyse/`
+   - If found with scope = "project": resume project mode (see Project Resume below)
+3. If feature ID exists, search for feature.json in `docs/business/`, `docs/platform/`, `docs/personal/`
+4. If found, check status and `metadata.workflow.lastCompletedStep`:
 
    **Status-based resume routing (check in this order):**
 
@@ -401,3 +408,22 @@ If initialization was interrupted:
    - Otherwise: offer to resume from last completed step
 
 4. If not found, create fresh feature.json
+
+**Project Resume (project mode):**
+
+If a project-level feature.json is found (scope = "project"):
+
+   - If status = `"draft"` or `"framed"`:
+     → Resume at `step-01-cadrage.md` or `step-01b-applications.md`
+
+   - If status = `"decomposed"`:
+     → Check `metadata.workflow.currentApplicationIndex` and `completedApplications[]`
+     → Resume module specification for current application (step-02 or step-03)
+
+   - If status = `"specified"`:
+     → All applications specified → Resume at `step-04a-collect.md`
+
+   - If status = `"consolidated"`:
+     → Resume at `step-05a-handoff.md`
+
+   Follow `_module-loop.md` "Project Mode (multi app)" resume logic for detailed routing.

package/templates/skills/business-analyse/steps/step-01-cadrage.md

@@ -720,7 +720,66 @@ ba-writer.enrichSection({
 ba-writer.updateStatus({feature_id}, "framed")
 ```
 
-### 9. Display Summary
+### 9. Multi-Application Detection (NEW)
+
+> **Analyze whether the project spans multiple independent applications.**
+
+After coverage matrix is validated, check if the identified functional domains suggest multiple applications:
+
+**Detection triggers (ANY of these = suggest multi-app):**
+- Coverage matrix entries reference different navigation contexts (business + personal + platform)
+- User mentioned "multiple applications", "several apps", "cross-platform"
+- Functional domains form clearly independent applications with separate user bases
+- Stakeholders only interact with specific domains (not shared across all)
+
+**IF detection triggers matched:**
+
+Display analysis as markdown:
+```
+{language == "fr"
+  ? "### Analyse multi-application\n\nD'après mon analyse, ce projet couvre plusieurs domaines fonctionnels qui pourraient former des applications indépendantes :\n\n"
+  : "### Multi-Application Analysis\n\nBased on my analysis, this project spans multiple functional domains that could form independent applications:\n\n"}
+
+| Domain | Suggested Context | Suggested Application | Key Modules |
+|--------|-------------------|----------------------|-------------|
+{for each identified domain: domain name | business/platform/personal | PascalCase name | top modules}
+```
+
+Ask via AskUserQuestion:
+```
+question: "{language == 'fr' ? 'Ce projet constitue-t-il une seule application ou plusieurs applications distinctes ?' : 'Is this a single application or multiple independent applications?'}"
+header: "Architecture"
+options:
+  - label: "{language == 'fr' ? 'Application unique' : 'Single application'}"
+    description: "{language == 'fr' ? 'Tous les domaines forment une seule application avec plusieurs modules' : 'All domains form one application with multiple modules'}"
+  - label: "{language == 'fr' ? 'Applications multiples' : 'Multiple applications'}"
+    description: "{language == 'fr' ? 'Chaque domaine est une application indépendante (navigation, rôles et préfixe de table séparés)' : 'Each domain is an independent application (separate navigation, roles, and table prefix)'}"
+```
+
+**IF "Multiple applications":**
+1. Create project-level feature.json:
+```
+ba-writer.createProjectFeature({
+  metadata: {
+    projectName: {project_name derived from feature_description},
+    language: {language},
+    featureDescription: {feature_description}
+  },
+  cadrage: {cadrage data already collected in this step}
+})
+```
+2. Set `workflow.mode = "project"` in project feature.json
+3. Load `questionnaire/00b-project.md` for additional project-level questions
+4. Load `steps/step-01b-applications.md` for application decomposition
+5. **STOP — DO NOT load step-02**
+
+**IF "Single application":**
+→ Continue to step 10 (display summary) and step-02 as usual.
+
+**IF no detection triggers matched:**
+→ Skip this section entirely — continue to step 10 (display summary).
+
+### 10. Display Summary
 
 ```
 ## Cadrage Complete - {feature_id}
@@ -748,4 +807,5 @@ ba-writer.updateStatus({feature_id}, "framed")
 
 ## NEXT STEP
 
-Load: `./step-02-decomposition.md`
+**IF workflow.mode === "project":** Load: `./step-01b-applications.md`
+**ELSE:** Load: `./step-02-decomposition.md`