@pukujan/create-modular-monolith 2.0.0 → 2.2.0

package/template/backend/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "modular-monolith-starter-backend",
+  "name": "legal-prmpt-eng-backend",
   "private": true,
   "version": "1.0.0",
   "type": "module",
@@ -8,13 +8,23 @@
     "start": "node src/core/server.js",
     "lint:boundaries": "node scripts/check-module-boundaries.mjs",
     "lint:layers": "node scripts/check-module-layers.mjs",
-    "lint:architecture": "npm run lint:boundaries && npm run lint:layers",
+    "lint:api-docs": "node ../scripts/check-api-docs.mjs",
+    "lint:architecture": "npm run lint:boundaries && npm run lint:layers && npm run lint:api-docs",
     "test": "node --test 'src/modules/**/tests/**/*.test.js'",
+    "condense-models": "node ../scripts/condense-models.mjs",
+    "condense-prompts": "node ../scripts/condense-prompts.mjs",
+    "condense-file-structure": "node ../scripts/condense-file-structure.mjs",
     "test:evals": "node ../scripts/run-module-evals.mjs"
   },
   "dependencies": {
+    "@napi-rs/canvas": "^1.0.0",
     "cors": "^2.8.5",
     "dotenv": "^16.4.5",
-    "express": "^4.19.2"
+    "express": "^4.19.2",
+    "mammoth": "^1.12.0",
+    "multer": "^2.1.1",
+    "pdf-parse": "^2.4.5",
+    "pdfjs-dist": "^4.10.38",
+    "word-extractor": "^1.0.4"
   }
-}
+}

package/template/backend/scripts/check-module-boundaries.mjs

@@ -22,6 +22,9 @@ for (const app of apps) {
     .map((d) => d.name);
 
   for (const moduleName of moduleNames) {
+    // model-condenser embeds repo path strings in schema inventory metadata only (no imports).
+    if (moduleName === "model-condenser") continue;
+
     const moduleRoot = join(modulesDir, moduleName);
     const files = walk(moduleRoot).filter((f) =>
       [".js", ".mjs", ".jsx"].some((ext) => f.endsWith(ext))

package/template/backend/src/modules/model-condenser/README.md

@@ -0,0 +1,7 @@
+# Model condenser
+
+Scans the repo and writes `models/consolidated-models.json` (JSON schema inventory).
+
+**HTTP API:** [docs/model-condenser/API.md](../../../docs/model-condenser/API.md) · [All modules](../../../docs/API.md)
+
+**CLI:** `npm run condense-models` (from `backend/`)

package/template/backend/src/modules/model-condenser/config/index.js

@@ -0,0 +1,20 @@
+import { join } from "path";
+import { fileURLToPath } from "url";
+
+const repoRoot = join(fileURLToPath(new URL(".", import.meta.url)), "../../../../..");
+
+export function getModuleConfig() {
+  const modelsDir =
+    process.env.MODEL_CONDENSER_OUTPUT_DIR || join(repoRoot, "models");
+  return {
+    name: "model-condenser",
+    label: "Model Condenser",
+    repoRoot,
+    modelsDir,
+    consolidatedFileName:
+      process.env.MODEL_CONDENSER_OUTPUT_FILE || "consolidated-models.json"
+  };
+}
+
+/** @deprecated Prefer getModuleConfig() */
+export const moduleConfig = getModuleConfig();

package/template/backend/src/modules/model-condenser/events/index.js

@@ -0,0 +1 @@
+export function registerModuleEvents(_context) {}

package/template/backend/src/modules/model-condenser/index.js

@@ -0,0 +1,12 @@
+import { createModuleRouter } from "./routes/index.js";
+import { registerModuleEvents } from "./events/index.js";
+import { getModuleConfig } from "./config/index.js";
+import { createModelCondenserFacade } from "./services/modelCondenser.facade.js";
+
+export function register(app, context) {
+  const config = getModuleConfig();
+  const modelCondenser = createModelCondenserFacade({ config });
+  const router = createModuleRouter({ config, modelCondenser });
+  app.use("/api/model-condenser", router);
+  registerModuleEvents(context);
+}

package/template/backend/src/modules/model-condenser/routes/health.routes.js

@@ -0,0 +1,10 @@
+import { Router } from "express";
+import { getHealth } from "../services/health.service.js";
+
+export function createHealthRoutes({ config }) {
+  const router = Router();
+  router.get("/health", (_req, res) => {
+    res.json(getHealth(config));
+  });
+  return router;
+}

package/template/backend/src/modules/model-condenser/routes/index.js

@@ -0,0 +1,10 @@
+import { Router } from "express";
+import { createHealthRoutes } from "./health.routes.js";
+import { createModelCondenserRoutes } from "./modelCondenser.routes.js";
+
+export function createModuleRouter({ config, modelCondenser }) {
+  const router = Router();
+  router.use(createHealthRoutes({ config }));
+  router.use(createModelCondenserRoutes({ config, modelCondenser }));
+  return router;
+}

package/template/backend/src/modules/model-condenser/routes/modelCondenser.routes.js

@@ -0,0 +1,44 @@
+import { Router } from "express";
+import { AppError } from "../../../shared/http/errors.js";
+
+export function createModelCondenserRoutes({ config, modelCondenser }) {
+  const router = Router();
+
+  router.post("/condense", async (req, res, next) => {
+    try {
+      const includePayload = Boolean(req.body?.includePayload);
+      const result = await modelCondenser.condense({
+        includePayload
+      });
+      res.status(201).json(result);
+    } catch (error) {
+      next(error);
+    }
+  });
+
+  router.get("/consolidated", async (req, res, next) => {
+    try {
+      const includePayload = req.query.includePayload === "true";
+      const summary = await modelCondenser.getStatus();
+
+      if (!summary.exists) {
+        throw new AppError(
+          "Consolidated models file not found. POST /api/model-condenser/condense first.",
+          404
+        );
+      }
+
+      if (!includePayload) {
+        res.json(summary);
+        return;
+      }
+
+      const consolidated = await modelCondenser.readConsolidated();
+      res.json({ ...summary, consolidated });
+    } catch (error) {
+      next(error);
+    }
+  });
+
+  return router;
+}

package/template/backend/src/modules/model-condenser/services/health.service.js

@@ -0,0 +1,8 @@
+export function getHealth(config) {
+  return {
+    status: "ok",
+    module: config.name,
+    label: config.label,
+    outputRelativePath: `models/${config.consolidatedFileName}`
+  };
+}

package/template/backend/src/modules/model-condenser/services/modelCondenser.facade.js

@@ -0,0 +1,58 @@
+import { access } from "fs/promises";
+import { join } from "path";
+import {
+  buildConsolidatedModels,
+  condenseModels,
+  readConsolidatedModels
+} from "./modelCondenser.service.js";
+
+export function createModelCondenserFacade({ config }) {
+  async function condense({ includePayload = false } = {}) {
+    return condenseModels({
+      repoRoot: config.repoRoot,
+      modelsDir: config.modelsDir,
+      consolidatedFileName: config.consolidatedFileName,
+      includePayload
+    });
+  }
+
+  async function readConsolidated() {
+    return readConsolidatedModels({
+      modelsDir: config.modelsDir,
+      consolidatedFileName: config.consolidatedFileName
+    });
+  }
+
+  async function getStatus() {
+    const outputPath = join(config.modelsDir, config.consolidatedFileName);
+    let exists = false;
+    let generatedAt = null;
+    let modelCount = null;
+
+    try {
+      await access(outputPath);
+      exists = true;
+      const data = await readConsolidated();
+      generatedAt = data.meta?.generatedAt ?? null;
+      modelCount = data.inventory?.length ?? null;
+    } catch {
+      exists = false;
+    }
+
+    return {
+      status: exists ? "ready" : "missing",
+      exists,
+      outputPath,
+      outputRelativePath: `models/${config.consolidatedFileName}`,
+      generatedAt,
+      modelCount
+    };
+  }
+
+  return {
+    condense,
+    readConsolidated,
+    getStatus,
+    buildConsolidatedModels: () => buildConsolidatedModels({ repoRoot: config.repoRoot })
+  };
+}