@pukujan/create-modular-monolith 2.0.0 → 2.2.0

package/template/file-exchange/exports/consolidated-models.json

@@ -0,0 +1,625 @@
+{
+  "meta": {
+    "generatedAt": "2026-05-23T17:33:00.382Z",
+    "repositoryRoot": "/private/tmp/create-modular-monolith/template",
+    "condensedBy": "model-condenser",
+    "description": "Consolidated inventory of JSON shapes used by the legal-prmpt-eng case filing pipeline."
+  },
+  "inventory": [
+    {
+      "id": "CaseModel",
+      "name": "CaseModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js"
+      ],
+      "description": "Top-level case identity and phase tracking.",
+      "hasSchema": true,
+      "hasExample": true,
+      "exampleSourcePath": "data/case-filing-ai/examples/case.json"
+    },
+    {
+      "id": "DocumentModel",
+      "name": "DocumentModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js",
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/db/migrations/001_case_filing_ai_schema.sql"
+      ],
+      "description": "A filing document linked to a case (NYSCEF-style metadata).",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": null
+    },
+    {
+      "id": "DocumentTextVersionModel",
+      "name": "DocumentTextVersionModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js"
+      ],
+      "description": "Versioned extracted or reviewed text for a document (filing-text-vault).",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": null
+    },
+    {
+      "id": "TaskModel",
+      "name": "TaskModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js"
+      ],
+      "description": "Docketing task with due date and workflow status.",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": null
+    },
+    {
+      "id": "HumanReviewItemModel",
+      "name": "HumanReviewItemModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js"
+      ],
+      "description": "Mandatory human review queue item (OCR, handwriting, stamps, etc.).",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": null
+    },
+    {
+      "id": "CaseStateSnapshotModel",
+      "name": "CaseStateSnapshotModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js",
+        "backend/src/modules/case-filing-ai/services/localJsonStore.service.js"
+      ],
+      "description": "Rolling case state after each processed document.",
+      "hasSchema": true,
+      "hasExample": true,
+      "exampleSourcePath": "data/case-filing-ai/examples/case-snapshot.json"
+    },
+    {
+      "id": "EmptyCaseStateSnapshot",
+      "name": "EmptyCaseStateSnapshot",
+      "category": "runtime_default",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/localJsonStore.service.js"
+      ],
+      "description": "Initial snapshot written when a new batch is created.",
+      "hasSchema": true,
+      "hasExample": true,
+      "exampleSourcePath": null
+    },
+    {
+      "id": "MasterCaseFilingPromptOutput",
+      "name": "MasterCaseFilingPromptOutput",
+      "category": "prompt_output",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/prompts/master-case-filing.prompt.md",
+        "work-log/handoffs/002_2026-05-23_00-42_handoff_second.md"
+      ],
+      "description": "Strict JSON returned by the master case-filing LLM prompt per document.",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": null
+    },
+    {
+      "id": "PartRuleParsed",
+      "name": "PartRuleParsed",
+      "category": "prompt_output",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/prompts/rule-parse.prompt.md"
+      ],
+      "description": "Structured part/judge rules after parsing user-supplied rule text.",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": "data/case-filing-ai/batches/batch-002/rule/part-rules-parsed.json"
+    },
+    {
+      "id": "PartRuleStoredRecord",
+      "name": "PartRuleStoredRecord",
+      "category": "pipeline_storage",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/uploadBatch.service.js"
+      ],
+      "description": "part-rules-parsed.json on disk: PartRuleParsed plus batch metadata.",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": null
+    },
+    {
+      "id": "PartRuleExtraction",
+      "name": "PartRuleExtraction",
+      "category": "pipeline_storage",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/uploadBatch.service.js"
+      ],
+      "description": "part-rules-extraction.json: file upload metadata for a part rule file.",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": "data/case-filing-ai/batches/batch-002/rule/part-rules-extraction.json"
+    },
+    {
+      "id": "ExtractionQuality",
+      "name": "ExtractionQuality",
+      "category": "pipeline_runtime",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/documentText.service.js"
+      ],
+      "description": "Text extraction quality flags for uploads and filings.",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": null
+    },
+    {
+      "id": "DocumentProcessingOutput",
+      "name": "DocumentProcessingOutput",
+      "category": "pipeline_storage",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/uploadBatch.service.js",
+        "data/case-filing-ai/batches/batch-002/outputs/doc-001.json"
+      ],
+      "description": "Per-document JSON saved under data/.../outputs/doc-NNN.json after LLM processing.",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": "data/case-filing-ai/batches/batch-002/outputs/doc-001.json"
+    },
+    {
+      "id": "BatchProcessingResult",
+      "name": "BatchProcessingResult",
+      "category": "api_response",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/uploadBatch.service.js"
+      ],
+      "description": "POST /process-batch and GET /batches/:id/results response body.",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": null
+    },
+    {
+      "id": "BatchStatus",
+      "name": "BatchStatus",
+      "category": "api_response",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/uploadBatch.service.js"
+      ],
+      "description": "GET /batches/:id/status response body.",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": null
+    },
+    {
+      "id": "RuleTextExtractResponse",
+      "name": "RuleTextExtractResponse",
+      "category": "api_response",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/ruleText.service.js",
+        "backend/src/modules/case-filing-ai/routes/caseFiling.routes.js"
+      ],
+      "description": "POST /extract-rule-text response body.",
+      "hasSchema": true,
+      "hasExample": false,
+      "exampleSourcePath": null
+    }
+  ],
+  "definitions": {
+    "CaseModel": {
+      "name": "CaseModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js"
+      ],
+      "description": "Top-level case identity and phase tracking.",
+      "schema": {
+        "caseId": "string",
+        "county": "string | null",
+        "court": "string | null",
+        "indexNumber": "string | null",
+        "caseName": "string | null",
+        "caseType": "string | null",
+        "judgeName": "string | null",
+        "partName": "string | null",
+        "currentPhase": "string | null",
+        "currentMiniPhase": "string | null",
+        "confidence": "high | medium | low"
+      },
+      "example": {
+        "caseId": "example_case",
+        "county": "Queens",
+        "part": "Part 10",
+        "currentPhase": "commencement",
+        "synthetic": true,
+        "note": "Placeholder example for model-condenser inventory only."
+      }
+    },
+    "DocumentModel": {
+      "name": "DocumentModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js",
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/db/migrations/001_case_filing_ai_schema.sql"
+      ],
+      "description": "A filing document linked to a case (NYSCEF-style metadata).",
+      "schema": {
+        "documentId": "string",
+        "caseId": "string",
+        "nyscefDocNo": "number | null",
+        "title": "string | null",
+        "documentType": "string | null",
+        "filedDateTime": "string | null",
+        "filedBy": "string | null",
+        "sourceFileName": "string",
+        "pageCount": "number | null",
+        "extractionStatus": "string",
+        "textReviewStatus": "unreviewed | partially_reviewed | reviewed | rejected"
+      },
+      "example": null
+    },
+    "DocumentTextVersionModel": {
+      "name": "DocumentTextVersionModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js"
+      ],
+      "description": "Versioned extracted or reviewed text for a document (filing-text-vault).",
+      "schema": {
+        "id": "string",
+        "caseId": "string",
+        "documentId": "string",
+        "versionType": "embedded_text | ocr_text | ai_parsed_text | human_reviewed_text",
+        "textContent": "string (optional)",
+        "structuredJson": "unknown (optional)",
+        "extractionMethod": "pdf_text | ocr | llm | human_review",
+        "reviewStatus": "unreviewed | partially_reviewed | reviewed | rejected",
+        "createdBy": "system | ai | human",
+        "createdAt": "string (ISO datetime)"
+      },
+      "example": null
+    },
+    "TaskModel": {
+      "name": "TaskModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js"
+      ],
+      "description": "Docketing task with due date and workflow status.",
+      "schema": {
+        "taskId": "string",
+        "caseId": "string",
+        "documentId": "string (optional)",
+        "taskDescription": "string",
+        "taskType": "string",
+        "responsibleParty": "string | null",
+        "dueDate": "string | null",
+        "dueDateStatus": "fixed | calculated | no_fixed_due_date | needs_review",
+        "status": "ai_extracted_unreviewed | source_supported_auto_saved | conditional | needs_ocr_review | corrected_later | superseded | human_verified",
+        "sourcePage": "number (optional)",
+        "confidence": "high | medium | low",
+        "docketingNote": "string (optional)"
+      },
+      "example": null
+    },
+    "HumanReviewItemModel": {
+      "name": "HumanReviewItemModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js"
+      ],
+      "description": "Mandatory human review queue item (OCR, handwriting, stamps, etc.).",
+      "schema": {
+        "itemId": "string",
+        "caseId": "string",
+        "documentId": "string",
+        "pageNumber": "number",
+        "location": "string",
+        "issue": "string",
+        "reason": "string",
+        "suggestedAction": "string",
+        "cropFilePath": "string (optional)",
+        "blocking": "boolean",
+        "status": "pending | reviewed | resolved"
+      },
+      "example": null
+    },
+    "CaseStateSnapshotModel": {
+      "name": "CaseStateSnapshotModel",
+      "category": "core_domain",
+      "sourcePaths": [
+        "work-log/handoffs/001_2026-05-23_starter_case-filing-ai-updated/models/typescript/core-models.ts",
+        "backend/src/shared/domain/case-filing/core-models.js",
+        "backend/src/modules/case-filing-ai/services/localJsonStore.service.js"
+      ],
+      "description": "Rolling case state after each processed document.",
+      "schema": {
+        "snapshotId": "string | null",
+        "caseId": "string | null",
+        "afterDocNo": "number | null",
+        "currentPhase": "string | null",
+        "currentMiniPhase": "string | null",
+        "confirmedFacts": "unknown[]",
+        "carriedForwardContext": "unknown[]",
+        "openTasks": "TaskModel[] | string[] (runtime varies)",
+        "completedTasks": "TaskModel[] | string[]",
+        "conditionalTasks": "TaskModel[] | string[]",
+        "deadlines": "unknown[]",
+        "supersededDeadlines": "unknown[]",
+        "unresolvedHumanReviewItems": "HumanReviewItemModel[]",
+        "conflicts": "unknown[]",
+        "auditNotes": "string[]"
+      },
+      "example": {
+        "snapshotId": "example_snapshot",
+        "caseId": "example_case",
+        "currentPhase": "commencement",
+        "confirmedFacts": [],
+        "openTasks": [],
+        "synthetic": true
+      }
+    },
+    "EmptyCaseStateSnapshot": {
+      "name": "EmptyCaseStateSnapshot",
+      "category": "runtime_default",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/localJsonStore.service.js"
+      ],
+      "description": "Initial snapshot written when a new batch is created.",
+      "schema": {
+        "snapshotId": null,
+        "caseId": null,
+        "afterDocNo": null,
+        "currentPhase": null,
+        "currentMiniPhase": null,
+        "confirmedFacts": [],
+        "carriedForwardContext": [],
+        "openTasks": [],
+        "completedTasks": [],
+        "conditionalTasks": [],
+        "deadlines": [],
+        "supersededDeadlines": [],
+        "unresolvedHumanReviewItems": [],
+        "conflicts": [],
+        "auditNotes": []
+      },
+      "example": {
+        "snapshotId": null,
+        "caseId": null,
+        "afterDocNo": null,
+        "currentPhase": null,
+        "currentMiniPhase": null,
+        "confirmedFacts": [],
+        "carriedForwardContext": [],
+        "openTasks": [],
+        "completedTasks": [],
+        "conditionalTasks": [],
+        "deadlines": [],
+        "supersededDeadlines": [],
+        "unresolvedHumanReviewItems": [],
+        "conflicts": [],
+        "auditNotes": []
+      }
+    },
+    "MasterCaseFilingPromptOutput": {
+      "name": "MasterCaseFilingPromptOutput",
+      "category": "prompt_output",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/prompts/master-case-filing.prompt.md",
+        "work-log/handoffs/002_2026-05-23_00-42_handoff_second.md"
+      ],
+      "description": "Strict JSON returned by the master case-filing LLM prompt per document.",
+      "schema": {
+        "documentMetadata": "object",
+        "extractionQuality": "object",
+        "docketEntry": "object",
+        "caseUpdates": "object",
+        "parties": "array",
+        "witnesses": "array",
+        "tasks": "array",
+        "deadlines": "array",
+        "humanReviewItems": "array",
+        "updatedCaseSnapshot": "object",
+        "auditNotes": "array",
+        "inferredPartRuleText": "string",
+        "partRuleExtracts": "array"
+      },
+      "example": null
+    },
+    "PartRuleParsed": {
+      "name": "PartRuleParsed",
+      "category": "prompt_output",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/prompts/rule-parse.prompt.md"
+      ],
+      "description": "Structured part/judge rules after parsing user-supplied rule text.",
+      "schema": {
+        "partName": "string | null",
+        "judgeName": "string | null",
+        "county": "string | null",
+        "court": "string | null",
+        "rules": "string[]",
+        "schedulingNotes": "string[]",
+        "deadlinePolicies": "string[]",
+        "sourceSummary": "string",
+        "confidence": "high | medium | low"
+      },
+      "example": null
+    },
+    "PartRuleStoredRecord": {
+      "name": "PartRuleStoredRecord",
+      "category": "pipeline_storage",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/uploadBatch.service.js"
+      ],
+      "description": "part-rules-parsed.json on disk: PartRuleParsed plus batch metadata.",
+      "schema": {
+        "source": "user_paste | user_upload | inferred_from_filings | pending_inference | none",
+        "savedAt": "string (ISO datetime)",
+        "extraction": "PartRuleExtraction | null",
+        "inferredFromDocs": "array (optional)",
+        "...PartRuleParsed fields": "see PartRuleParsed"
+      },
+      "example": null
+    },
+    "PartRuleExtraction": {
+      "name": "PartRuleExtraction",
+      "category": "pipeline_storage",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/uploadBatch.service.js"
+      ],
+      "description": "part-rules-extraction.json: file upload metadata for a part rule file.",
+      "schema": {
+        "storedName": "string",
+        "originalName": "string",
+        "fileKind": "pdf | text | image | office | binary",
+        "extractionQuality": "ExtractionQuality",
+        "mimeType": "string",
+        "sizeBytes": "number"
+      },
+      "example": null
+    },
+    "ExtractionQuality": {
+      "name": "ExtractionQuality",
+      "category": "pipeline_runtime",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/documentText.service.js"
+      ],
+      "description": "Text extraction quality flags for uploads and filings.",
+      "schema": {
+        "method": "string",
+        "fileKind": "string",
+        "textLength": "number",
+        "ocr_needed": "boolean",
+        "ocr_used": "boolean",
+        "ocr_model": "string | null",
+        "ocr_pages": "number[] | null",
+        "reviewStatus": "ai_extracted_unreviewed | ...",
+        "note": "string | null"
+      },
+      "example": null
+    },
+    "DocumentProcessingOutput": {
+      "name": "DocumentProcessingOutput",
+      "category": "pipeline_storage",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/uploadBatch.service.js",
+        "data/case-filing-ai/batches/batch-002/outputs/doc-001.json"
+      ],
+      "description": "Per-document JSON saved under data/.../outputs/doc-NNN.json after LLM processing.",
+      "schema": {
+        "docKey": "string",
+        "docIndex": "number",
+        "storedName": "string",
+        "originalName": "string",
+        "fileKind": "string",
+        "model": "string",
+        "usage": "object",
+        "documentMetadata": "object",
+        "extractionQuality": "object",
+        "docketEntry": "object",
+        "caseUpdates": "object",
+        "parties": "array",
+        "witnesses": "array",
+        "tasks": "array",
+        "deadlines": "array",
+        "humanReviewItems": "array",
+        "auditNotes": "array"
+      },
+      "example": null
+    },
+    "BatchProcessingResult": {
+      "name": "BatchProcessingResult",
+      "category": "api_response",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/uploadBatch.service.js"
+      ],
+      "description": "POST /process-batch and GET /batches/:id/results response body.",
+      "schema": {
+        "batchId": "string",
+        "caseSnapshot": "CaseStateSnapshotModel",
+        "documents": "DocumentProcessingOutput[]",
+        "tasks": "array (aggregated)",
+        "deadlines": "array (aggregated)",
+        "humanReviewItems": "array (aggregated)",
+        "partRule": "PartRuleStoredRecord | null"
+      },
+      "example": null
+    },
+    "BatchStatus": {
+      "name": "BatchStatus",
+      "category": "api_response",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/uploadBatch.service.js"
+      ],
+      "description": "GET /batches/:id/status response body.",
+      "schema": {
+        "batchId": "string",
+        "status": "pending | processing | completed",
+        "currentStep": "string",
+        "currentDocument": "string | null",
+        "processedCount": "number",
+        "totalCount": "number"
+      },
+      "example": null
+    },
+    "RuleTextExtractResponse": {
+      "name": "RuleTextExtractResponse",
+      "category": "api_response",
+      "sourcePaths": [
+        "backend/src/modules/case-filing-ai/services/ruleText.service.js",
+        "backend/src/modules/case-filing-ai/routes/caseFiling.routes.js"
+      ],
+      "description": "POST /extract-rule-text response body.",
+      "schema": {
+        "text": "string",
+        "fileKind": "string",
+        "extractionQuality": "ExtractionQuality",
+        "originalName": "string"
+      },
+      "example": null
+    }
+  },
+  "exampleInstances": {
+    "backend/data/case-filing-ai/examples/case.json": {
+      "caseId": "example_case",
+      "county": "Queens",
+      "part": "Part 10",
+      "currentPhase": "commencement",
+      "synthetic": true,
+      "note": "Placeholder example for model-condenser inventory only."
+    },
+    "backend/data/case-filing-ai/examples/case-snapshot.json": {
+      "snapshotId": "example_snapshot",
+      "caseId": "example_case",
+      "currentPhase": "commencement",
+      "confirmedFacts": [],
+      "openTasks": [],
+      "synthetic": true
+    }
+  },
+  "evalDatasets": {
+    "description": "Per-module eval fixture files (API health shape tests, not case domain models).",
+    "paths": [
+      "backend/src/modules/_reference/evals/datasets/example.cases.json",
+      "backend/src/modules/case-filing-ai/evals/datasets/example.cases.json",
+      "backend/src/modules/case-workflow/evals/datasets/example.cases.json",
+      "backend/src/modules/court-rules/evals/datasets/example.cases.json",
+      "backend/src/modules/filing-pipeline/evals/datasets/example.cases.json",
+      "backend/src/modules/filing-text-vault/evals/datasets/example.cases.json",
+      "backend/src/modules/human-review/evals/datasets/example.cases.json",
+      "backend/src/modules/task-docketing/evals/datasets/example.cases.json"
+    ],
+    "sharedShape": null
+  }
+}

package/template/frontend/.env.example

@@ -0,0 +1,2 @@
+# Frontend — copy to frontend/.env.local (optional)
+VITE_API_BASE_URL=http://localhost:3001