@atlashub/smartstack-cli 2.2.0 → 2.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlashub/smartstack-cli",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "SmartStack Claude Code automation toolkit - GitFlow, APEX, EF Core migrations, prompts and more",
   "author": {
     "name": "SmartStack",
@@ -76,20 +76,20 @@
     "test:mcp:coverage": "vitest run --config vitest.mcp.config.ts --coverage"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "axios": "^1.7.0",
     "bcryptjs": "^2.4.3",
     "chalk": "^5.3.0",
     "cli-table3": "^0.6.3",
     "commander": "^12.0.0",
     "fs-extra": "^11.2.0",
     "glob": "^11.0.0",
+    "handlebars": "^4.7.8",
     "inquirer": "^9.2.12",
     "jsonwebtoken": "^9.0.3",
     "mssql": "^11.0.1",
     "ora": "^8.0.1",
-    "zod": "^3.25.0",
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "handlebars": "^4.7.8",
-    "axios": "^1.7.0"
+    "zod": "^3.25.0"
   },
   "devDependencies": {
     "@types/bcryptjs": "^2.4.6",
@@ -100,11 +100,14 @@
     "@types/node": "^20.10.6",
     "@typescript-eslint/eslint-plugin": "^6.18.0",
     "@typescript-eslint/parser": "^6.18.0",
+    "@vitest/coverage-v8": "^2.1.0",
     "eslint": "^8.56.0",
     "prettier": "^3.2.4",
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
-    "vitest": "^2.1.0",
-    "@vitest/coverage-v8": "^2.1.0"
+    "vitest": "^2.1.0"
+  },
+  "optionalDependencies": {
+    "msnodesqlv8": "^5.1.3"
   }
 }

package/templates/skills/business-analyse/questionnaire/03-scope.md

@@ -12,7 +12,7 @@
 | Q3.1 | List ESSENTIAL features (Must-Have) | List |
 | Q3.2 | List DESIRED features (Should-Have) | List |
 | Q3.3 | List OPTIONAL features (Could-Have) | List |
-| Q3.4 | Any known constraints limiting v1 scope? | List of constraints |
+| Q3.4 | Any known constraints limiting scope? | List of constraints |
 
 ## 3.2 Business Process
 
@@ -29,10 +29,10 @@
 
 | Priority | Criterion |
 |----------|-----------|
-| Must | Without this feature, the module has no value |
-| Should | Brings significant value but can wait for v2 |
-| Could | Nice-to-have, can be implemented if time available |
-| Won't | Deferred — will be considered for future versions |
+| Must | Without this feature, the module has no value — implement first |
+| Should | Brings significant value — implement right after Must items |
+| Could | Nice-to-have — implement if no technical blocker |
+| Won't | Out of scope for this feature — belongs to a different module or feature |
 
 ## Elicitation Guide
 
@@ -40,9 +40,9 @@
 
 | Question | If answer is vague/insufficient | Probe |
 |----------|-------------------------------|-------|
-| Q3.1 (Must-Have) | > 10 items listed | "Si vous ne pouviez en garder que 3 pour la v1, lesquels ? Les autres sont peut-être Should-Have." |
+| Q3.1 (Must-Have) | > 10 items listed | "Si vous ne pouviez en garder que 3 à implémenter en premier, lesquels ? Les autres sont peut-être Should-Have." |
 | Q3.1 (Must-Have) | Mélange CRUD + complexe | "Le CRUD de base (liste, création, modification, suppression) est-il un Must, ou certaines actions sont Could ?" |
-| Q3.2 (Should-Have) | Vide | "Y a-t-il des fonctionnalités utiles mais qui peuvent attendre une v2 ? Export, filtres avancés, notifications ?" |
+| Q3.2 (Should-Have) | Vide | "Y a-t-il des fonctionnalités utiles mais moins critiques ? Export, filtres avancés, notifications ?" |
 | Q3.4 (limites) | Vide | "Y a-t-il des contraintes connues qui pourraient limiter le périmètre ? (budget, délai, dépendance)" |
 | Q3.5 (main flow) | < 3 étapes | "Détaillez : l'utilisateur arrive sur l'écran → que voit-il ? → que clique-t-il ? → que se passe-t-il ?" |
 | Q3.7 (alt flows) | "Il n'y en a pas" | "Que se passe-t-il si l'utilisateur annule ? S'il n'a pas la permission ? Si les données sont invalides ?" |

package/templates/skills/business-analyse/questionnaire/12-migration.md

@@ -55,4 +55,4 @@
 | "On saisira tout à la main" | **Migration non planifiée** | Si > 100 enregistrements, l'import automatisé est indispensable |
 | Pas de validation post-migration | **Données non vérifiées** | Prévoir un rapport de migration : importés / rejetés / à corriger |
 | Aucun rollback plan | **Risque de perte de données** | Toujours faire un backup avant migration + possibilité de rollback |
-| "On migrera plus tard" | **Dette technique** | Si la migration est nécessaire, la planifier dès la v1 même si simplifiée |
+| "On migrera plus tard" | **Dette technique** | Si la migration est nécessaire, la planifier dès le départ même si simplifiée |

package/templates/skills/business-analyse/react/schema.md

@@ -137,7 +137,7 @@ export interface EntityAttribute {
 
 export interface EntityRelationship {
   target: string;
-  type: 'OneToMany' | 'ManyToOne' | 'ManyToMany' | 'OneToOne';
+  type: '1:1' | '1:N' | 'N:1' | 'N:M';
   description: string;
 }
 
@@ -158,9 +158,88 @@ export interface FeatureSpecification {
   navigation: NavigationHierarchy;
   gherkinScenarios: GherkinScenario[];
   apiEndpoints: ApiEndpoint[];
+  validations: ValidationRule[];
+  wireframes: Wireframe[];
+  messages: BusinessMessage[];
+  lifeCycles: EntityLifeCycle[];
+  seedDataCore: SeedDataCore;
   i18nKeys: I18nKey[];
 }
 
+export interface ValidationRule {
+  field: string;
+  rules: string;
+  errorMessage: string;
+}
+
+export interface Wireframe {
+  screen: string;
+  description: string;
+  elements: string[];
+  actions: string[];
+  permissionsRequired: string[];
+}
+
+export interface BusinessMessage {
+  code: string;                // SCREAMING_SNAKE_CASE
+  type: 'success' | 'error' | 'warning' | 'info';
+  title: string;
+  message: string;             // User-facing with {placeholders}
+  i18nKey: string;             // Dot-separated key
+}
+
+export interface EntityLifeCycle {
+  entity: string;              // PascalCase entity name
+  states: LifeCycleState[];
+}
+
+export interface LifeCycleState {
+  id: string;                  // State code (Draft, Active, etc.)
+  displayName: string;
+  description?: string;
+  allowedTransitions: string[];
+  isTerminal: boolean;
+}
+
+export interface SeedDataCore {
+  navigationModules: SeedDataNavModule[];
+  navigationTranslations: SeedDataNavTranslation[];
+  permissions: SeedDataPermission[];
+  rolePermissions: SeedDataRolePermission[];
+  permissionConstants: SeedDataPermissionConstant[];
+}
+
+export interface SeedDataNavModule {
+  code: string;
+  label: string;
+  icon: string;
+  route: string;
+  parentCode: string | null;
+  sort: number;
+}
+
+export interface SeedDataNavTranslation {
+  moduleCode: string;
+  language: 'fr' | 'en' | 'it' | 'de';
+  label: string;
+}
+
+export interface SeedDataPermission {
+  path: string;                // Full path: business.{app}.{module}.{resource}.{action}
+  action: string;
+  description?: string;
+}
+
+export interface SeedDataRolePermission {
+  role: string;
+  permissionPath: string;      // Must match permissions[].path
+}
+
+export interface SeedDataPermissionConstant {
+  constantName: string;        // PascalCase (e.g., VehiclesRead)
+  path: string;                // Matching permission path
+}
+
 export interface Actor {
   name: string;
   description: string;
@@ -244,54 +323,112 @@ export interface I18nKey {
 // --- Validation ---
 
 export interface FeatureValidation {
-  decision: 'APPROVED' | 'REJECTED';
-  completeness: Record<string, { score: string; issues: string[] }>;
-  consistency: Record<string, 'OK' | 'FAIL'>;
-  conventions: Record<string, 'OK' | 'FAIL'>;
-  risks: ValidatedRisk[];
-  issues: ValidationIssue[];
+  validatedAt: string | null;
+  completenessChecks: CompletenessCheck[];
+  consistencyChecks: ConsistencyCheck[];
+  conventionChecks: ConventionCheck[];
+  riskAssessments: RiskAssessment[];
+  warnings: string[];
+  decision: ValidationDecision;
 }
 
-export interface ValidatedRisk {
+export interface CompletenessCheck {
+  section: string;
+  count: number;
+  minimum: number;
+  status: 'PASS' | 'FAIL' | 'WARNING';
+}
+
+export interface ConsistencyCheck {
+  check: string;
+  passed: number;
+  warnings: number;
+  errors: number;
+  status: 'PASS' | 'FAIL' | 'WARNING';
+}
+
+export interface ConventionCheck {
+  check: string;
+  status: 'PASS' | 'FAIL' | 'WARNING';
+  details: string;
+}
+
+export interface RiskAssessment {
   risk: string;
-  severity: 'High' | 'Medium' | 'Low';
-  mitigation: string;
-  status: 'Mitigated' | 'Accepted' | 'Open';
+  value: number;
+  threshold: number;
+  status: 'ACCEPTABLE' | 'WARNING' | 'CRITICAL' | 'MONITORED';
 }
 
-export interface ValidationIssue {
-  severity: 'critical' | 'warning' | 'info';
-  section: string;
-  message: string;
+export interface ValidationDecision {
+  approved: boolean;
+  reason: string;
+  approvalMode: 'standard' | 'micro' | 'delta' | 'force';
+  approvedBy: string;
+  approvedAt: string;
 }
 
 // --- Handoff ---
 
 export interface FeatureHandoff {
-  complexity: 'Simple' | 'Medium' | 'Complex';
-  filesToCreate: FileSpec[];
+  complexity: 'simple' | 'medium' | 'complex';
+  complexityDetails?: {
+    entities: number;
+    useCases: number;
+    businessRules: number;
+    calculated: string;
+  };
+  filesToCreate: FilesToCreate;
   brToCodeMapping: BrToCodeMapping[];
-  ralphPrd: object | null;  // .ralph/prd.json content
+  apiEndpointSummary: ApiEndpointSummaryEntry[];
+  ralphPrd: object | null;     // .ralph/prd.json content
+}
+
+export interface FilesToCreate {
+  domain: FileSpec[];
+  application: FileSpec[];
+  infrastructure: FileSpec[];
+  api: FileSpec[];
+  frontend: FileSpec[];
+  seedData: FileSpec[];
+  tests: FileSpec[];
 }
 
 export interface FileSpec {
   path: string;
-  layer: string;
-  type: string;
-  description: string;
+  type: string;                // Entity, Service, DTO, HasData, Constants, ApiController, Page, Component, etc.
+  linkedFRs?: string[];        // FR-XXX references
+  linkedUCs?: string[];        // UC-XXX references
+  category?: 'core' | 'business';  // For seedData files
+  source?: string;             // Derivation source in feature.json
+  description?: string;
 }
 
 export interface BrToCodeMapping {
-  brId: string;
-  rule: string;
-  implementation: string;
-  file: string;
+  ruleId: string;              // BR-XXX from analysis.businessRules
+  title: string;
+  implementationPoints: ImplementationPoint[];
+}
+
+export interface ImplementationPoint {
+  layer: string;               // Domain, Application, Infrastructure, API, Frontend
+  component: string;           // File name
+  method: string;              // Method or attribute
+  implementation: string;      // How the rule is enforced
+}
+
+export interface ApiEndpointSummaryEntry {
+  operation: string;
+  method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+  route: string;               // MUST match specification.apiEndpoints[].path
+  linkedUC: string;
+  permissions: string;
 }
 
 // --- Suggestions & Changelog ---
 
 export interface FeatureSuggestion {
-  type: 'module' | 'section' | 'integration';
+  type: 'module' | 'section' | 'integration' | 'enhancement';
   code: string;
   title: string;
   reason: string;
@@ -299,9 +436,13 @@ export interface FeatureSuggestion {
 }
 
 export interface ChangelogEntry {
-  version: string;
+  step?: string;               // step-01-analyse, step-02-specify, etc.
+  version?: string;
   timestamp: string;
+  author?: string;
   changes: string[];
+  warnings?: string[];
+  decision?: string;
 }
 ```
 
@@ -364,6 +505,13 @@ export type {
   FunctionalRequirement,
   Entity,
   PermissionMatrix,
+  BusinessMessage,
+  EntityLifeCycle,
+  SeedDataCore,
+  FilesToCreate,
+  FileSpec,
+  BrToCodeMapping,
+  ValidationDecision,
   FeatureSuggestion,
   ChangelogEntry
 } from './business-analyse';