@atlashub/smartstack-cli 4.80.0 → 5.0.0

package/templates/skills/business-analyse/create-plan-development/cli/create-plan-development/__tests__/parse.test.ts

@@ -0,0 +1,177 @@
+/**
+ * parse.test.ts — Tests for entité.md parsing and dependency extraction.
+ */
+import { describe, it, expect } from 'vitest';
+import { parseEntities } from '../parse.js';
+
+// We test parseEntities directly (exported) and use snapshot-style
+// content strings to test the full module parsing flow indirectly.
+
+describe('parseEntities', () => {
+  it('extracts a single entity with classification', () => {
+    const content = `### ENT-001 — Opportunity (agrégat racine)
+- **Préfixe table** : \`pipeline_\`
+`;
+    const entities = parseEntities(content);
+    expect(entities).toHaveLength(1);
+    expect(entities[0]).toEqual({
+      code: 'ENT-001',
+      name: 'Opportunity',
+      classification: 'agrégat racine',
+    });
+  });
+
+  it('extracts multiple entities', () => {
+    const content = `### ENT-001 — Opportunity (agrégat racine)
+- **Préfixe table** : \`pipeline_\`
+
+### ENT-002 — OpportunitySequence (technical)
+- **Préfixe table** : \`pipeline_\`
+
+### ENT-003 — Deal (composant)
+- **Préfixe table** : \`pipeline_\`
+`;
+    const entities = parseEntities(content);
+    expect(entities).toHaveLength(3);
+    expect(entities[0].name).toBe('Opportunity');
+    expect(entities[1].name).toBe('OpportunitySequence');
+    expect(entities[1].classification).toBe('technical');
+    expect(entities[2].name).toBe('Deal');
+  });
+
+  it('handles entity without classification', () => {
+    const content = `### ENT-001 — Contact
+- **Préfixe table** : \`crm_\`
+`;
+    const entities = parseEntities(content);
+    expect(entities).toHaveLength(1);
+    expect(entities[0]).toEqual({
+      code: 'ENT-001',
+      name: 'Contact',
+      classification: undefined,
+    });
+  });
+
+  it('returns empty array for placeholder content', () => {
+    const content = `<!-- ba:entité level=module code=PIPELINE -->
+_À définir lors de la phase « modèle de données »._
+`;
+    const entities = parseEntities(content);
+    expect(entities).toHaveLength(0);
+  });
+
+  it('returns empty array for empty content', () => {
+    expect(parseEntities('')).toHaveLength(0);
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Cross-module FK extraction (tested via content patterns)
+// ---------------------------------------------------------------------------
+
+describe('cross-module FK patterns', () => {
+  // These tests verify the regex patterns used in parse.ts by matching
+  // against representative content snippets.
+
+  const CROSS_MODULE_FK_RE =
+    /FK\s+cross[- ]?module\s+vers\s+([A-Z][A-Z0-9_-]*)\/([A-Z][A-Z0-9_-]*)\.(\w+)/i;
+
+  const CORE_REF_RE =
+    /(?:FK\s+(?:Core\s+)?)?(?:cross[- ]?module\s+vers\s+)?(auth_\w+|nav_\w+|tnt_\w+)/i;
+
+  it('matches standard cross-module FK', () => {
+    const line = 'FK cross-module vers CRM/CONTACTS.Contact';
+    const match = CROSS_MODULE_FK_RE.exec(line);
+    expect(match).not.toBeNull();
+    expect(match![1]).toBe('CRM');
+    expect(match![2]).toBe('CONTACTS');
+    expect(match![3]).toBe('Contact');
+  });
+
+  it('matches without hyphen (cross module)', () => {
+    const line = 'FK cross module vers BILLING/INVOICES.Invoice';
+    const match = CROSS_MODULE_FK_RE.exec(line);
+    expect(match).not.toBeNull();
+    expect(match![1]).toBe('BILLING');
+    expect(match![2]).toBe('INVOICES');
+    expect(match![3]).toBe('Invoice');
+  });
+
+  it('matches crossmodule (no space)', () => {
+    const line = 'FK crossmodule vers HR/EMPLOYEES.Employee';
+    const match = CROSS_MODULE_FK_RE.exec(line);
+    expect(match).not.toBeNull();
+    expect(match![1]).toBe('HR');
+    expect(match![2]).toBe('EMPLOYEES');
+    expect(match![3]).toBe('Employee');
+  });
+
+  it('matches Core auth_ ref', () => {
+    const line = 'FK Core auth_Users';
+    const match = CORE_REF_RE.exec(line);
+    expect(match).not.toBeNull();
+    expect(match![1]).toBe('auth_Users');
+  });
+
+  it('matches nav_ ref', () => {
+    const line = 'FK cross-module vers nav_Applications';
+    const match = CORE_REF_RE.exec(line);
+    expect(match).not.toBeNull();
+    expect(match![1]).toBe('nav_Applications');
+  });
+
+  it('matches tnt_ ref', () => {
+    const line = 'tnt_Tenants';
+    const match = CORE_REF_RE.exec(line);
+    expect(match).not.toBeNull();
+    expect(match![1]).toBe('tnt_Tenants');
+  });
+
+  it('does not match regular FK description', () => {
+    const line = '≥ 0';
+    expect(CROSS_MODULE_FK_RE.exec(line)).toBeNull();
+  });
+
+  it('does not match PK', () => {
+    const line = 'PK';
+    expect(CROSS_MODULE_FK_RE.exec(line)).toBeNull();
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Readiness verdict parsing
+// ---------------------------------------------------------------------------
+
+describe('readiness verdict regex', () => {
+  const VERDICT_RE =
+    /Verdict\s*:\s*(GO|NO-GO)(?:.*?score\s+(\d+))?(?:.*?(\d+)\s+err)?(?:.*?(\d+)\s+warn)?/;
+
+  it('parses GO verdict with full details', () => {
+    const line = '_2026-05-25 · Verdict : GO · score 88/100 · 0 err · 2 warn · 15 ok_';
+    const match = VERDICT_RE.exec(line);
+    expect(match).not.toBeNull();
+    expect(match![1]).toBe('GO');
+    expect(match![2]).toBe('88');
+    expect(match![3]).toBe('0');
+    expect(match![4]).toBe('2');
+  });
+
+  it('parses NO-GO verdict', () => {
+    const line = '_2026-05-25 · Verdict : NO-GO · score 52/100 · 3 err · 5 warn · 8 ok_';
+    const match = VERDICT_RE.exec(line);
+    expect(match).not.toBeNull();
+    expect(match![1]).toBe('NO-GO');
+    expect(match![2]).toBe('52');
+    expect(match![3]).toBe('3');
+    expect(match![4]).toBe('5');
+  });
+
+  it('parses GO without score', () => {
+    const line = '_2026-05-25 · Verdict : GO · 0 err · 1 warn_';
+    const match = VERDICT_RE.exec(line);
+    expect(match).not.toBeNull();
+    expect(match![1]).toBe('GO');
+    expect(match![2]).toBeUndefined();
+    expect(match![3]).toBe('0');
+  });
+});

package/templates/skills/business-analyse/create-plan-development/cli/create-plan-development/generate.ts

@@ -0,0 +1,317 @@
+/**
+ * generate.ts — Generate the development plan as a Markdown file.
+ *
+ * Produces:
+ * - Summary table
+ * - Wave 0 (external prerequisites) if applicable
+ * - Wave 1+ development tables
+ * - Mermaid dependency graph
+ * - Warnings
+ * - Next steps
+ */
+import type {
+  DevelopmentPlan,
+  GeneratedFile,
+  Wave,
+  WaveModule,
+  ModuleKey,
+} from './types.js';
+
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+
+/**
+ * Generate the plan markdown from the computed DevelopmentPlan.
+ * Returns a single GeneratedFile for `_plan/dev-plan.md`.
+ */
+export function generatePlan(
+  plan: DevelopmentPlan,
+  outputPath: string,
+): GeneratedFile {
+  const lines: string[] = [];
+
+  lines.push(anchor(plan));
+  lines.push('');
+  lines.push(heading(plan));
+  lines.push('');
+  lines.push(summary(plan));
+  lines.push('');
+
+  // Wave 0 — external prerequisites
+  const wave0 = plan.waves.find((w) => w.level === 0);
+  if (wave0 && wave0.modules.length > 0) {
+    lines.push(externalPrereqs(wave0));
+    lines.push('');
+  }
+
+  // Wave 1+ — development waves
+  const devWaves = plan.waves.filter((w) => w.level > 0);
+  for (const wave of devWaves) {
+    lines.push(waveSection(wave, devWaves.length));
+    lines.push('');
+  }
+
+  // Mermaid graph
+  lines.push(mermaidGraph(plan));
+  lines.push('');
+
+  // Cycles
+  if (plan.cycles.length > 0) {
+    lines.push(cyclesSection(plan.cycles));
+    lines.push('');
+  }
+
+  // Warnings
+  if (plan.warnings.length > 0) {
+    lines.push(warningsSection(plan.warnings));
+    lines.push('');
+  }
+
+  // Next steps
+  lines.push(nextSteps(plan));
+  lines.push('');
+
+  return { path: outputPath, content: lines.join('\n') };
+}
+
+// ---------------------------------------------------------------------------
+// Section generators
+// ---------------------------------------------------------------------------
+
+function anchor(plan: DevelopmentPlan): string {
+  return `<!-- ba:plan kind=dev-plan generated=${plan.generatedAt} apps=${plan.apps.join(',')} -->`;
+}
+
+function heading(plan: DevelopmentPlan): string {
+  const devWaves = plan.waves.filter((w) => w.level > 0);
+  const inScopeModules = devWaves.reduce((sum, w) => sum + w.modules.length, 0);
+  return [
+    `# Plan de développement — ${plan.apps.join(', ')}`,
+    '',
+    `_Généré le ${plan.generatedAt} · ${inScopeModules} modules · ${devWaves.length} vagues_`,
+  ].join('\n');
+}
+
+function summary(plan: DevelopmentPlan): string {
+  const wave0 = plan.waves.find((w) => w.level === 0);
+  const devWaves = plan.waves.filter((w) => w.level > 0);
+  const externalCount = wave0?.modules.length ?? 0;
+  const inScopeModules = devWaves.reduce((sum, w) => sum + w.modules.length, 0);
+
+  // Count dev-ready modules
+  const allDevModules = devWaves.flatMap((w) => w.modules);
+  const readyCount = allDevModules.filter(
+    (m) => m.readiness?.verdict === 'GO',
+  ).length;
+  const readyStr = allDevModules.some((m) => m.readiness)
+    ? `${readyCount}/${inScopeModules}`
+    : 'N/A';
+
+  return [
+    '## Résumé',
+    '',
+    '| Métrique | Valeur |',
+    '|----------|--------|',
+    `| Applications | ${plan.apps.length} (${plan.apps.join(', ')}) |`,
+    `| Modules dans le scope | ${inScopeModules} |`,
+    `| Prérequis externes | ${externalCount}${externalCount > 0 ? ' ⚠️' : ''} |`,
+    `| Vagues de développement | ${devWaves.length} |`,
+    `| Dépendances cross-module | ${plan.totalCrossModuleDeps} |`,
+    `| Cycles détectés | ${plan.cycles.length}${plan.cycles.length > 0 ? ' ⚠️' : ''} |`,
+    `| Modules dev-ready (GO) | ${readyStr} |`,
+  ].join('\n');
+}
+
+function externalPrereqs(wave0: Wave): string {
+  const lines = [
+    '## ⚠️ Wave 0 — Prérequis externes',
+    '',
+    '> Modules hors scope référencés comme FK cross-module.',
+    '> Doivent être développés ou stubbés avant Wave 1.',
+    '',
+    '| Module | Requis par |',
+    '|--------|------------|',
+  ];
+
+  for (const mod of wave0.modules) {
+    const refs = mod.referencedBy?.join(', ') ?? '—';
+    lines.push(`| ${mod.key} | ${refs} |`);
+  }
+
+  return lines.join('\n');
+}
+
+function waveSection(wave: Wave, totalWaves: number): string {
+  const subtitle =
+    wave.level === 1
+      ? ' — Fondations (aucune dépendance intra-scope)'
+      : '';
+
+  const lines = [
+    `## Wave ${wave.level}${subtitle}`,
+    '',
+    '| Module | Entités | Dépend de | Audit PRD |',
+    '|--------|---------|-----------|-----------|',
+  ];
+
+  for (const mod of wave.modules) {
+    const deps = mod.dependsOn.length > 0 ? mod.dependsOn.join(', ') : '—';
+    const readiness = formatReadiness(mod);
+    const notes = mod.warnings.length > 0 ? ` ⚠️ ${mod.warnings.join('; ')}` : '';
+    lines.push(
+      `| ${mod.key} | ${mod.entityCount} | ${deps} | ${readiness}${notes} |`,
+    );
+  }
+
+  return lines.join('\n');
+}
+
+function formatReadiness(mod: WaveModule): string {
+  if (!mod.readiness) return '—';
+
+  switch (mod.readiness.verdict) {
+    case 'GO': {
+      const score = mod.readiness.score != null ? ` (${mod.readiness.score})` : '';
+      return `✅ GO${score}`;
+    }
+    case 'NO-GO': {
+      const score = mod.readiness.score != null ? ` (${mod.readiness.score})` : '';
+      const errs =
+        mod.readiness.errCount != null ? ` — ${mod.readiness.errCount} err` : '';
+      return `❌ NO-GO${score}${errs}`;
+    }
+    case 'UNKNOWN':
+      return '⬜ non audité';
+  }
+}
+
+function mermaidGraph(plan: DevelopmentPlan): string {
+  const lines = ['## Graphe de dépendances', '', '```mermaid', 'graph LR'];
+
+  // Collect all edges and nodes per wave
+  const allWaves = plan.waves;
+  for (const wave of allWaves) {
+    const label =
+      wave.level === 0
+        ? 'Wave 0 — External'
+        : `Wave ${wave.level}`;
+    lines.push(`  subgraph "${label}"`);
+
+    for (const mod of wave.modules) {
+      const nodeId = mermaidNodeId(mod.key);
+      const prefix = mod.isExternal ? '⚠️ ' : '';
+      lines.push(`    ${nodeId}["${prefix}${mod.key}"]`);
+    }
+
+    lines.push('  end');
+  }
+
+  // Collect edges: dependent → dependency
+  // Arrow means "depends on" so A --> B reads "A needs B first"
+  const edges = new Set<string>();
+  const devWaves = allWaves.filter((w) => w.level > 0);
+  for (const wave of devWaves) {
+    for (const mod of wave.modules) {
+      for (const dep of mod.dependsOn) {
+        const fromId = mermaidNodeId(dep);
+        const toId = mermaidNodeId(mod.key);
+        const edge = `  ${fromId} --> ${toId}`;
+        edges.add(edge);
+      }
+    }
+  }
+
+  // Also add edges from externals to their dependents
+  const wave0 = allWaves.find((w) => w.level === 0);
+  if (wave0) {
+    for (const ext of wave0.modules) {
+      for (const ref of ext.referencedBy ?? []) {
+        const fromId = mermaidNodeId(ext.key);
+        const toId = mermaidNodeId(ref);
+        const edge = `  ${fromId} --> ${toId}`;
+        edges.add(edge);
+      }
+    }
+  }
+
+  for (const edge of edges) {
+    lines.push(edge);
+  }
+
+  lines.push('```');
+  return lines.join('\n');
+}
+
+/** Convert MODULE_KEY (APP/MODULE) to a valid Mermaid node ID. */
+function mermaidNodeId(key: ModuleKey | string): string {
+  return key.replace(/\//g, '_').replace(/-/g, '_');
+}
+
+function cyclesSection(cycles: ModuleKey[][]): string {
+  const lines = [
+    '## ⚠️ Dépendances cycliques',
+    '',
+    '> Les modules dans un cycle ont des dépendances mutuelles.',
+    '> Ils sont placés dans la même vague et doivent être co-développés.',
+    '',
+  ];
+
+  for (let i = 0; i < cycles.length; i++) {
+    lines.push(`${i + 1}. ${cycles[i].join(' ↔ ')}`);
+  }
+
+  return lines.join('\n');
+}
+
+function warningsSection(warnings: string[]): string {
+  const lines = ['## ⚠️ Avertissements', ''];
+  for (const w of warnings) {
+    lines.push(`- ${w}`);
+  }
+  return lines.join('\n');
+}
+
+function nextSteps(plan: DevelopmentPlan): string {
+  const lines = ['## Prochaines étapes', ''];
+  let step = 1;
+
+  const wave0 = plan.waves.find((w) => w.level === 0);
+  if (wave0 && wave0.modules.length > 0) {
+    lines.push(
+      `${step++}. **Wave 0** : développer ou stubber les prérequis externes (${wave0.modules.map((m) => m.key).join(', ')})`,
+    );
+  }
+
+  const devWaves = plan.waves.filter((w) => w.level > 0);
+  for (const wave of devWaves) {
+    const moduleList = wave.modules.map((m) => `\`${m.key}\``).join(', ');
+    const parallel = wave.modules.length > 1 ? ' (parallélisable)' : '';
+    lines.push(
+      `${step++}. **Wave ${wave.level}** : \`/ba-develop\` pour ${moduleList}${parallel}`,
+    );
+  }
+
+  // Flag NO-GO or unaudited modules
+  const allDevModules = devWaves.flatMap((w) => w.modules);
+  const noGo = allDevModules.filter(
+    (m) => m.readiness?.verdict === 'NO-GO',
+  );
+  const unaudited = allDevModules.filter(
+    (m) => m.readiness?.verdict === 'UNKNOWN',
+  );
+
+  if (noGo.length > 0) {
+    lines.push(
+      `${step++}. ❌ Corriger les erreurs d'audit pour : ${noGo.map((m) => `\`${m.key}\``).join(', ')} avant \`/ba-develop\``,
+    );
+  }
+
+  if (unaudited.length > 0) {
+    lines.push(
+      `${step++}. ⬜ Lancer \`/ba-create-prd\` + \`/ba-audit-prd\` pour : ${unaudited.map((m) => `\`${m.key}\``).join(', ')}`,
+    );
+  }
+
+  return lines.join('\n');
+}