@atlashub/smartstack-cli 3.7.0 → 3.9.0

package/dist/index.js

@@ -126749,6 +126749,334 @@ mcpCommand.command("remove").description("Unregister MCP servers from CLI and VS
 var import_fs_extra9 = __toESM(require_lib());
 var import_path11 = require("path");
 
+// src/utils/task-generator.ts
+var LAYER_ORDER = [
+  { key: "domain", category: "domain" },
+  { key: "infrastructure", category: "infrastructure" },
+  { key: "application", category: "application" },
+  { key: "api", category: "api" },
+  { key: "frontend", category: "frontend" },
+  { key: "seedData", category: "infrastructure" },
+  { key: "tests", category: "test" }
+];
+function createTask(ctx, category, description, deps, acceptanceCriteria, filesCreated = [], meta) {
+  const task = {
+    id: ctx.nextId++,
+    description,
+    status: "pending",
+    category,
+    dependencies: [...new Set(deps)],
+    acceptance_criteria: acceptanceCriteria,
+    started_at: null,
+    completed_at: null,
+    iteration: null,
+    commit_hash: null,
+    files_changed: { created: filesCreated, modified: [] },
+    validation: null,
+    error: null,
+    module: ctx.moduleCode,
+    ...meta ?? {}
+  };
+  ctx.lastIdByCategory[category] = task.id;
+  return task;
+}
+function generateFilesTasks(prd, ctx, frontendFiles, i18nFiles, testFiles) {
+  const tasks = [];
+  const filesToCreate = prd.implementation?.filesToCreate ?? {};
+  const allFRs = prd.requirements?.functionalRequirements ?? [];
+  const permMatrix = prd.architecture?.permissionMatrix;
+  for (const layer of LAYER_ORDER) {
+    const files = filesToCreate[layer.key] ?? [];
+    if (layer.category === "frontend") {
+      frontendFiles.push(...files);
+      continue;
+    }
+    if (layer.category === "test") {
+      testFiles.push(...files);
+      continue;
+    }
+    for (const fileSpec of files) {
+      if (fileSpec.path?.includes("i18n/") || fileSpec.path?.includes("/locales/")) {
+        i18nFiles.push(fileSpec);
+        continue;
+      }
+      const depIds = [];
+      if (ctx.lastIdByCategory[layer.category]) depIds.push(ctx.lastIdByCategory[layer.category]);
+      if (layer.category === "api" && ctx.lastIdByCategory["application"]) depIds.push(ctx.lastIdByCategory["application"]);
+      const linkedFRs = (fileSpec.linkedFRs ?? []).map(
+        (frId) => allFRs.find((f) => f.id === frId)?.statement ?? frId
+      );
+      let criteria = linkedFRs.length > 0 ? `Implements: ${linkedFRs.join("; ")}` : `File ${fileSpec.path} created and compiles`;
+      if (layer.category === "api" && (permMatrix?.permissions?.length ?? 0) > 0) {
+        criteria += "; MANDATORY: [RequirePermission] on every endpoint (NOT [Authorize])";
+      }
+      const description = fileSpec.description ? `[${layer.category}] ${fileSpec.description} \u2192 ${fileSpec.path}` : `[${layer.category}] Create ${fileSpec.type}: ${fileSpec.path}`;
+      tasks.push(createTask(ctx, layer.category, description, depIds, criteria, [fileSpec.path]));
+    }
+  }
+  return tasks;
+}
+function generateFrontendTask(prd, ctx, frontendFiles) {
+  if (frontendFiles.length === 0) return [];
+  const apiDepId = ctx.lastIdByCategory["api"] ?? ctx.lastIdByCategory["application"];
+  const ctxName = capitalize(prd.project?.application ? "Business" : "Business");
+  const app = prd.project?.application ?? ctx.moduleCode;
+  const wireframes = [...new Set(frontendFiles.flatMap((f) => f.linkedWireframes ?? []))];
+  return [createTask(
+    ctx,
+    "frontend",
+    `[frontend] Generate COMPLETE frontend for module ${ctx.moduleCode} via MCP (${frontendFiles.length} files)`,
+    apiDepId ? [apiDepId] : [],
+    `Pages in src/pages/${ctxName}/${app}/${ctx.moduleCode}/; MCP scaffold_api_client + scaffold_routes; SmartTable for lists; CSS variables ONLY; 4-language i18n; npm run typecheck passes`,
+    frontendFiles.map((f) => f.path),
+    {
+      _frontendMeta: {
+        wireframes,
+        filesToCreate: frontendFiles.map((f) => ({ path: f.path, type: f.type }))
+      }
+    }
+  )];
+}
+function generateI18nTask(ctx, i18nFiles) {
+  if (i18nFiles.length === 0) return [];
+  const frontendDepId = ctx.lastIdByCategory["frontend"];
+  return [createTask(
+    ctx,
+    "i18n",
+    `[i18n] Generate i18n for module ${ctx.moduleCode} (4 languages)`,
+    frontendDepId ? [frontendDepId] : [],
+    "4 JSON files (fr, en, it, de) with identical keys",
+    i18nFiles.map((f) => f.path)
+  )];
+}
+function generateTestTasks(prd, ctx, testFiles) {
+  const tasks = [];
+  const allFRs = prd.requirements?.functionalRequirements ?? [];
+  for (const fileSpec of testFiles) {
+    const depIds = [];
+    if (ctx.lastIdByCategory["test"]) depIds.push(ctx.lastIdByCategory["test"]);
+    const migDepId = ctx.lastIdByCategory["migration"] ?? ctx.lastIdByCategory["api"] ?? ctx.lastIdByCategory["application"];
+    if (migDepId) depIds.push(migDepId);
+    const linkedFRs = (fileSpec.linkedFRs ?? []).map(
+      (frId) => allFRs.find((f) => f.id === frId)?.statement ?? frId
+    );
+    const criteria = linkedFRs.length > 0 ? `Implements: ${linkedFRs.join("; ")}` : `File ${fileSpec.path} created and compiles`;
+    const description = fileSpec.description ? `[test] ${fileSpec.description} \u2192 ${fileSpec.path}` : `[test] Create ${fileSpec.type}: ${fileSpec.path}`;
+    tasks.push(createTask(ctx, "test", description, depIds, criteria, [fileSpec.path]));
+  }
+  return tasks;
+}
+function applyGuardrails(prd, ctx, tasks, frontendFiles, i18nFiles) {
+  const injected = [];
+  const filesToCreate = prd.implementation?.filesToCreate ?? {};
+  const testFileSpecs = filesToCreate["tests"] ?? [];
+  const entities = prd.architecture?.entities ?? [];
+  const apiEndpoints = prd.architecture?.apiEndpoints ?? [];
+  const sections = prd.architecture?.sections ?? [];
+  const permMatrix = prd.architecture?.permissionMatrix;
+  if (!tasks.some((t) => t.category === "infrastructure") && entities.length > 0) {
+    injected.push(createTask(
+      ctx,
+      "infrastructure",
+      `[infrastructure] Create EF Core configs and seed data for ${ctx.moduleCode} (${entities.length} entities)`,
+      ctx.lastIdByCategory["domain"] ? [ctx.lastIdByCategory["domain"]] : [],
+      `EF configs for ${entities.length} entities; DbSet in ExtensionsDbContext; DI registration`
+    ));
+  }
+  if (!tasks.some((t) => t.category === "api") && apiEndpoints.length > 0) {
+    const depId = ctx.lastIdByCategory["application"] ?? ctx.lastIdByCategory["infrastructure"];
+    const permCriteria = (permMatrix?.permissions?.length ?? 0) > 0 ? "[RequirePermission] on every endpoint" : "Authorization";
+    injected.push(createTask(
+      ctx,
+      "api",
+      `[api] Create controllers for ${ctx.moduleCode} (${apiEndpoints.length} endpoints)`,
+      depId ? [depId] : [],
+      `${apiEndpoints.length} endpoints; ${permCriteria}; Swagger`
+    ));
+  }
+  if (frontendFiles.length === 0 && !tasks.some((t) => t.category === "frontend") && (sections.length > 0 || apiEndpoints.length > 0)) {
+    const ctxName = "Business";
+    const app = prd.project?.application ?? ctx.moduleCode;
+    const derivedFiles = sections.map((s) => ({
+      path: `web/src/pages/${ctxName}/${app}/${ctx.moduleCode}/${s.code}.tsx`,
+      type: "Page"
+    }));
+    if (apiEndpoints.length > 0) {
+      derivedFiles.push({ path: `web/src/services/api/${ctx.moduleCode}Api.ts`, type: "ApiService" });
+    }
+    const depId = ctx.lastIdByCategory["api"] ?? ctx.lastIdByCategory["application"];
+    injected.push(createTask(
+      ctx,
+      "frontend",
+      `[frontend] Generate COMPLETE frontend for ${ctx.moduleCode} via MCP (${derivedFiles.length} files)`,
+      depId ? [depId] : [],
+      `Pages in src/pages/${ctxName}/${app}/${ctx.moduleCode}/; SmartTable for lists; CSS variables ONLY; 4-language i18n; npm run typecheck passes`,
+      derivedFiles.map((f) => f.path),
+      {
+        _frontendMeta: {
+          wireframes: sections.map((s) => s.code),
+          filesToCreate: derivedFiles,
+          source: "guardrail-derived"
+        }
+      }
+    ));
+    if (i18nFiles.length === 0 && !tasks.some((t) => t.category === "i18n")) {
+      injected.push(createTask(
+        ctx,
+        "i18n",
+        `[i18n] Generate i18n for ${ctx.moduleCode} (4 languages)`,
+        [ctx.lastIdByCategory["frontend"]],
+        "4 JSON files (fr, en, it, de) with identical keys"
+      ));
+    }
+  }
+  if (testFileSpecs.length === 0 && !tasks.some((t) => t.category === "test") && !injected.some((t) => t.category === "test") && entities.length > 0) {
+    ctx.lastIdByCategory["_needsGuardrailTest"] = 1;
+  }
+  const coreSeedData = prd.seedData?.core;
+  const hasSeedDataInTasks = [...tasks, ...injected].some(
+    (t) => t.description?.includes("SeedData") || t.description?.includes("seed data")
+  );
+  if (coreSeedData && coreSeedData.length > 0 && !hasSeedDataInTasks) {
+    const infraDepId = ctx.lastIdByCategory["infrastructure"] ?? ctx.lastIdByCategory["domain"];
+    const navCount = coreSeedData.filter((s) => s.entity === "NavigationModule").reduce((n, s) => n + (s.count ?? 1), 0);
+    const permCount = coreSeedData.filter((s) => s.entity === "Permission").reduce((n, s) => n + (s.count ?? 1), 0);
+    const roleCount = coreSeedData.filter((s) => s.entity === "RolePermission").reduce((n, s) => n + (s.count ?? 1), 0);
+    const navRoute = `business.${(prd.project?.application ?? "app").toLowerCase()}.${ctx.moduleCode.toLowerCase()}`;
+    injected.push(createTask(
+      ctx,
+      "infrastructure",
+      `[infrastructure] Create core seed data for ${ctx.moduleCode}: NavigationModuleSeedData, PermissionsSeedData, RolesSeedData`,
+      infraDepId ? [infraDepId] : [],
+      `NavigationModuleSeedData (${navCount} nav); PermissionsSeedData (${permCount} perms); RolesSeedData (${roleCount} roles); SeedConstants; dotnet build passes`,
+      [],
+      {
+        _seedDataMeta: {
+          source: "guardrail-derived",
+          coreSeedData,
+          navRoute,
+          contextCode: "business",
+          appCode: prd.project?.application,
+          appLabels: null
+        }
+      }
+    ));
+  }
+  const hasProvider = [...tasks, ...injected].some(
+    (t) => t.description?.includes("IClientSeedDataProvider") || t.description?.includes("SeedDataProvider")
+  );
+  const seedDataFiles = filesToCreate["seedData"] ?? [];
+  if (!hasProvider && (seedDataFiles.length > 0 || coreSeedData && coreSeedData.length > 0)) {
+    const depId = ctx.lastIdByCategory["infrastructure"] ?? ctx.lastIdByCategory["domain"];
+    const navRoute = `business.${(prd.project?.application ?? "app").toLowerCase()}.${ctx.moduleCode.toLowerCase()}`;
+    injected.push(createTask(
+      ctx,
+      "infrastructure",
+      "[infrastructure] Create IClientSeedDataProvider for core seed data injection",
+      depId ? [depId] : [],
+      "SeedNavigationAsync + SeedPermissionsAsync + SeedRolePermissionsAsync; DI registered; idempotent",
+      [],
+      {
+        _providerMeta: {
+          navRoute,
+          contextCode: "business",
+          appCode: prd.project?.application
+        }
+      }
+    ));
+  }
+  const allTasks = [...tasks, ...injected];
+  const hasEntities = entities.length > 0 || allTasks.some((t) => t.category === "domain");
+  const hasMigration = allTasks.some((t) => t.description?.toLowerCase().includes("migration"));
+  if (hasEntities && !hasMigration) {
+    const depId = ctx.lastIdByCategory["infrastructure"];
+    injected.push(createTask(
+      ctx,
+      "infrastructure",
+      `[infrastructure] Create EF Core migration for ${ctx.moduleCode}`,
+      depId ? [depId] : [],
+      "MCP suggest_migration \u2192 name; dotnet ef migrations add; dotnet ef database update; dotnet build passes",
+      [],
+      {
+        _migrationMeta: {
+          entities: entities.map((e) => e.name),
+          moduleCode: ctx.moduleCode
+        }
+      }
+    ));
+    ctx.lastIdByCategory["migration"] = ctx.nextId - 1;
+  }
+  if (ctx.lastIdByCategory["_needsGuardrailTest"]) {
+    delete ctx.lastIdByCategory["_needsGuardrailTest"];
+    const migDepId = ctx.lastIdByCategory["migration"] ?? ctx.lastIdByCategory["api"] ?? ctx.lastIdByCategory["application"];
+    injected.push(createTask(
+      ctx,
+      "test",
+      `[test] Create unit and integration tests for ${ctx.moduleCode}`,
+      migDepId ? [migDepId] : [],
+      "Domain + service + controller tests; dotnet test passes; coverage >= 80%"
+    ));
+  }
+  return injected;
+}
+function generateValidationTask(ctx) {
+  const allCategoryTails = Object.values(ctx.lastIdByCategory).filter((id) => id != null);
+  return createTask(
+    ctx,
+    "validation",
+    `[validation] Build, test, and MCP validate module ${ctx.moduleCode}`,
+    allCategoryTails,
+    "dotnet build succeeds; dotnet test passes; MCP validate_conventions clean"
+  );
+}
+function generateTasks(prd) {
+  const moduleCode = prd.project.module;
+  const ctx = {
+    moduleCode,
+    lastIdByCategory: {},
+    nextId: 1
+  };
+  const frontendFiles = [];
+  const i18nFiles = [];
+  const testFiles = [];
+  const fileTasks = generateFilesTasks(prd, ctx, frontendFiles, i18nFiles, testFiles);
+  const frontendTask = generateFrontendTask(prd, ctx, frontendFiles);
+  const i18nTask = generateI18nTask(ctx, i18nFiles);
+  const coreTasks = [...fileTasks, ...frontendTask, ...i18nTask];
+  const guardrailTasks = applyGuardrails(prd, ctx, coreTasks, frontendFiles, i18nFiles);
+  const testTasks = generateTestTasks(prd, ctx, testFiles);
+  const allTasks = [...coreTasks, ...guardrailTasks, ...testTasks];
+  const validationTask = generateValidationTask(ctx);
+  return [...allTasks, validationTask];
+}
+function validateTaskIntegrity(tasks) {
+  const errors = [];
+  const taskIds = new Set(tasks.map((t) => t.id));
+  for (const task of tasks) {
+    for (const depId of task.dependencies) {
+      if (!taskIds.has(depId)) {
+        errors.push(`Task ${task.id}: dependency ${depId} does not exist`);
+      }
+    }
+    for (const depId of task.dependencies) {
+      if (depId >= task.id) {
+        errors.push(`Task ${task.id}: forward dependency to ${depId}`);
+      }
+    }
+    if (!task.description) errors.push(`Task ${task.id}: missing description`);
+    if (!task.category) errors.push(`Task ${task.id}: missing category`);
+    if (!task.acceptance_criteria) errors.push(`Task ${task.id}: missing acceptance_criteria`);
+    if (!task.module) errors.push(`Task ${task.id}: missing module`);
+  }
+  if (tasks.length < 2) {
+    errors.push(`Only ${tasks.length} task(s) generated (minimum 2 expected)`);
+  }
+  return errors;
+}
+function capitalize(s) {
+  return s.charAt(0).toUpperCase() + s.slice(1);
+}
+
 // src/utils/prd-extractor.ts
 function extractPrd(moduleFeature, featureJsonPath, namespace) {
   const { metadata, analysis, specification, handoff } = moduleFeature;
@@ -126938,6 +127266,26 @@ function validatePrdCompleteness(prd, feature) {
   }
   return warnings;
 }
+function extractUnifiedPrd(moduleFeature, featureJsonPath, namespace, cliVersion) {
+  const prdJson = extractPrd(moduleFeature, featureJsonPath, namespace);
+  const tasks = generateTasks(prdJson);
+  return {
+    $version: "3.0.0",
+    source: prdJson.source,
+    project: prdJson.project,
+    requirements: prdJson.requirements,
+    businessRules: prdJson.businessRules,
+    architecture: prdJson.architecture,
+    implementation: prdJson.implementation,
+    seedData: prdJson.seedData,
+    tasks,
+    metadata: {
+      generatedBy: "ss-derive-prd",
+      cliVersion: cliVersion ?? "unknown",
+      moduleCode: prdJson.project.module
+    }
+  };
+}
 function getPrdFileCounts(prd) {
   const ftc = prd.implementation.filesToCreate;
   return {
@@ -127028,7 +127376,14 @@ Processing module: ${source_default.bold(moduleName)}`));
         continue;
       }
     }
+    let cliVersion = "unknown";
+    try {
+      const pkg2 = import_fs_extra9.default.readJsonSync((0, import_path11.join)(__dirname, "..", "..", "package.json"));
+      cliVersion = pkg2.version ?? "unknown";
+    } catch {
+    }
     const relativePath = (0, import_path11.relative)(process.cwd(), entry.path);
+    const unified = extractUnifiedPrd(featureJson, relativePath, namespace, cliVersion);
     const prd = extractPrd(featureJson, relativePath, namespace);
     let outputPath;
     if (options.output && !entry.isApplicationMode) {
@@ -127036,7 +127391,7 @@ Processing module: ${source_default.bold(moduleName)}`));
     } else {
       outputPath = (0, import_path11.join)(ralphDir, `prd-${moduleName}.json`);
     }
-    await import_fs_extra9.default.writeJson(outputPath, prd, { spaces: 2 });
+    await import_fs_extra9.default.writeJson(outputPath, unified, { spaces: 2 });
     totalGenerated++;
     const completenessWarnings = validatePrdCompleteness(prd, featureJson);
     if (completenessWarnings.length > 0) {
@@ -127050,13 +127405,21 @@ Processing module: ${source_default.bold(moduleName)}`));
         continue;
       }
     }
+    const taskErrors = validateTaskIntegrity(unified.tasks);
+    if (taskErrors.length > 0) {
+      console.log(source_default.yellow(`  Task integrity warnings:`));
+      for (const te of taskErrors) {
+        console.log(source_default.yellow(`    - ${te}`));
+      }
+    }
     const relOutput = (0, import_path11.relative)(process.cwd(), outputPath);
-    console.log(source_default.green(`  Generated: ${relOutput}`));
+    console.log(source_default.green(`  Generated: ${relOutput} (unified v3)`));
     console.log(source_default.gray(`    UCs: ${prd.requirements.useCases.length} | FRs: ${prd.requirements.functionalRequirements.length} | BRs: ${prd.businessRules.length}`));
     console.log(source_default.gray(`    Endpoints: ${prd.architecture.apiEndpoints.length} | Sections: ${prd.architecture.sections.length}`));
     const counts = getPrdFileCounts(prd);
     const totalFiles = Object.values(counts).reduce((s, n) => s + n, 0);
     console.log(source_default.gray(`    Files to create: ${totalFiles} (domain: ${counts.domain}, app: ${counts.application}, infra: ${counts.infrastructure}, api: ${counts.api}, frontend: ${counts.frontend}, seed: ${counts.seedData}, tests: ${counts.tests})`));
+    console.log(source_default.gray(`    Tasks: ${unified.tasks.length} (${unified.tasks.filter((t) => t.category === "validation").length} validation)`));
     console.log(source_default.gray(`    BR mappings: ${prd.implementation.brToCodeMapping.length}`));
   }
   console.log();