@tailor-platform/erp-kit 0.5.1 → 0.7.0

package/src/commands/sync-check.ts

@@ -1,6 +1,6 @@
 import chalk from "chalk";
 import { runSourceSyncCheck, type SyncCheckResult, type CheckError } from "./lib/sync-check-source";
-import { runTestCaseSyncCheck } from "./lib/sync-check-tests";
+import { runModuleTestCaseSyncCheck, runAppTestCaseSyncCheck } from "./lib/sync-check-tests";
 
 export type { SyncCheckResult, CheckError } from "./lib/sync-check-source";
 
@@ -10,10 +10,14 @@ export async function runSyncCheck(
 ): Promise<SyncCheckResult> {
   const sourceResult = await runSourceSyncCheck(config, cwd);
   if (config.modulesRoot) {
-    const testCaseErrors = await runTestCaseSyncCheck(config.modulesRoot, cwd);
+    const testCaseErrors = await runModuleTestCaseSyncCheck(config.modulesRoot, cwd);
     sourceResult.errors.push(...testCaseErrors);
-    sourceResult.exitCode = sourceResult.errors.length > 0 ? 1 : 0;
   }
+  if (config.appRoot) {
+    const storyErrors = await runAppTestCaseSyncCheck(config.appRoot, cwd);
+    sourceResult.errors.push(...storyErrors);
+  }
+  sourceResult.exitCode = sourceResult.errors.length > 0 ? 1 : 0;
   return sourceResult;
 }
 
@@ -50,6 +54,9 @@ export function formatSyncCheckReport(result: SyncCheckResult): string {
           lines.push(
             `    ${chalk.yellow("Extra test case:")} "${error.expectedBasename}" is in test but not in doc`,
           );
+        } else if (error.type === "missing-test-file") {
+          lines.push(`  ${chalk.red(error.docPath)}`);
+          lines.push(`    ${chalk.yellow("Missing test file:")} ${error.expectedBasename}`);
         }
         lines.push("");
       }

package/src/generator/generate-app-code.test.ts

@@ -62,9 +62,7 @@ Gets profile.
 
     const files = fs.readdirSync(resolverDir).sort();
     // Template scaffolding may copy additional files (e.g. createUser.ts)
-    expect(files).toContain("createItem.test.ts");
     expect(files).toContain("createItem.ts");
-    expect(files).toContain("getMyProfile.test.ts");
     expect(files).toContain("getMyProfile.ts");
     expect(files).not.toContain("createItem.generated.ts");
 
@@ -73,10 +71,6 @@ Gets profile.
     expect(stub).toContain("createResolver");
     expect(stub).toContain('name: "createItem"');
     expect(stub).toContain('getDB("main-db")');
-
-    // Test stub exists
-    const test = fs.readFileSync(path.join(resolverDir, "createItem.test.ts"), "utf-8");
-    expect(test).toContain('describe("createItem"');
   });
 
   it("does not overwrite existing stubs on re-run", () => {

package/src/generator/generate-app-code.ts

@@ -1,29 +1,29 @@
-import fs from "node:fs";
+import fs, { globSync } from "node:fs";
 import path from "node:path";
+import { parseTestCasesFromDoc } from "../commands/parse-doc-test-cases";
+import { APP_PATHS } from "../commands/lib/paths";
 import { parseResolverDoc } from "./parse-resolver-doc";
-import { generateResolverStub, generateResolverTestStub } from "./generate-stubs";
+import { renderStub } from "./stub-templates";
 import { scaffoldAppBoilerplate } from "./scaffold";
 
 export function runGenerateAppCode(appPath: string): number {
   const appName = path.basename(appPath);
   scaffoldAppBoilerplate(appPath, appName);
 
-  const docsDir = path.join(appPath, "docs", "resolver");
-  const resolverDir = path.join(appPath, "backend", "src", "resolvers");
+  generateResolverStubs(appPath, appName);
+  generateStoryTestStubs(appPath, appName);
 
-  if (!fs.existsSync(docsDir)) {
-    console.log(`No docs/resolver/ directory found — skipping resolver generation`);
-    console.log(`Generated boilerplate for ${appName}`);
-    return 0;
-  }
+  return 0;
+}
+
+function generateResolverStubs(appPath: string, appName: string): void {
+  const docsDir = path.join(appPath, "docs", "resolver");
+  if (!fs.existsSync(docsDir)) return;
 
   const mdFiles = fs.readdirSync(docsDir).filter((f) => f.endsWith(".md"));
-  if (mdFiles.length === 0) {
-    console.log(`No resolver docs found — skipping resolver generation`);
-    console.log(`Generated boilerplate for ${appName}`);
-    return 0;
-  }
+  if (mdFiles.length === 0) return;
 
+  const resolverDir = path.join(appPath, "backend", "src", "resolvers");
   fs.mkdirSync(resolverDir, { recursive: true });
   let generated = 0;
 
@@ -34,18 +34,43 @@ export function runGenerateAppCode(appPath: string): number {
 
     const implFile = path.join(resolverDir, `${doc.resolverName}.ts`);
     if (!fs.existsSync(implFile)) {
-      fs.writeFileSync(implFile, generateResolverStub(doc.resolverName));
+      fs.writeFileSync(implFile, renderStub("resolver", doc.resolverName));
       console.log(`  scaffolded ${path.relative(appPath, implFile)}`);
       generated++;
     }
+  }
 
-    const testFile = path.join(resolverDir, `${doc.resolverName}.test.ts`);
-    if (!fs.existsSync(testFile)) {
-      fs.writeFileSync(testFile, generateResolverTestStub(doc.resolverName));
-      console.log(`  scaffolded ${path.relative(appPath, testFile)}`);
-    }
+  if (generated > 0) {
+    console.log(`Scaffolded ${generated} resolver(s) for ${appName}`);
   }
+}
 
-  console.log(`Scaffolded ${generated} resolver(s) for ${appName}`);
-  return 0;
+function generateStoryTestStubs(appPath: string, appName: string): void {
+  const storyPattern = path.join(appPath, "docs/business-flow/*/story/*.md");
+  const storyDocs = globSync(storyPattern);
+  let generated = 0;
+
+  for (const storyDocPath of storyDocs) {
+    const content = fs.readFileSync(storyDocPath, "utf-8");
+    const testCases = parseTestCasesFromDoc(content);
+    if (testCases.length === 0) continue;
+
+    const regex = /\/docs\/business-flow\/([^/]+)\/story\/([^/]+)\.md$/;
+    const match = regex.exec(storyDocPath);
+    if (!match) continue;
+    const [, flow, storyName] = match;
+
+    const testDir = path.join(appPath, APP_PATHS.tests.stories, flow);
+    const testFile = path.join(testDir, `${storyName}.test.ts`);
+    if (fs.existsSync(testFile)) continue;
+
+    fs.mkdirSync(testDir, { recursive: true });
+    fs.writeFileSync(testFile, renderStub("storyTest", storyName, testCases));
+    console.log(`  scaffolded ${path.relative(appPath, testFile)}`);
+    generated++;
+  }
+
+  if (generated > 0) {
+    console.log(`Scaffolded ${generated} story test(s) for ${appName}`);
+  }
 }

package/src/generator/generate-code.test.ts

@@ -2,13 +2,7 @@ import { describe, expect, it } from "vitest";
 import { moduleNameToPrefix, generateErrors } from "./generate-errors";
 import { generatePermissions } from "./generate-permissions";
 import { generateCommandShell, generateQueryShell } from "./generate-shells";
-import {
-  generateQueryStub,
-  generateQueryTestStub,
-  generateDbStub,
-  generateResolverStub,
-  generateResolverTestStub,
-} from "./generate-stubs";
+import { renderStub } from "./stub-templates";
 import type { ParsedCommandDoc } from "./parse-command-doc";
 
 describe("moduleNameToPrefix", () => {
@@ -174,15 +168,9 @@ describe("generateQueryShell", () => {
   });
 });
 
-describe("generateQueryStub", () => {
+describe("renderStub query", () => {
   it("generates a stub implementation with ReadonlyDB and input interface", () => {
-    const doc: ParsedCommandDoc = {
-      commandName: "getTaxonomyNode",
-      errors: [],
-      externalDependencies: [],
-    };
-
-    const result = generateQueryStub(doc);
+    const result = renderStub("query", "getTaxonomyNode");
 
     expect(result).toContain('import type { ReadonlyDB } from "@tailor-platform/erp-kit/module";');
     expect(result).toContain('import type { DB } from "../generated/kysely-tailordb";');
@@ -194,9 +182,9 @@ describe("generateQueryStub", () => {
   });
 });
 
-describe("generateDbStub", () => {
+describe("renderStub db", () => {
   it("generates an empty db type definition with TODO", () => {
-    const result = generateDbStub("item");
+    const result = renderStub("db", "item");
 
     expect(result).toContain(
       "import { db, unsafeAllowAllGqlPermission, unsafeAllowAllTypePermission }",
@@ -210,22 +198,16 @@ describe("generateDbStub", () => {
   });
 
   it("handles camelCase model names", () => {
-    const result = generateDbStub("taxonomyNode");
+    const result = renderStub("db", "taxonomyNode");
 
     expect(result).toContain("export const taxonomyNode = db");
     expect(result).toContain('.type("TaxonomyNode"');
   });
 });
 
-describe("generateQueryTestStub", () => {
+describe("renderStub queryTest", () => {
   it("generates a test stub with createMockDb and run import", () => {
-    const doc: ParsedCommandDoc = {
-      commandName: "getTaxonomyNode",
-      errors: [],
-      externalDependencies: [],
-    };
-
-    const result = generateQueryTestStub(doc);
+    const result = renderStub("queryTest", "getTaxonomyNode");
 
     expect(result).toContain('import { describe, expect, it } from "vitest";');
     expect(result).toContain('import { createMockDb } from "../../../testing/index";');
@@ -238,9 +220,9 @@ describe("generateQueryTestStub", () => {
   });
 });
 
-describe("generateResolverStub", () => {
+describe("renderStub resolver", () => {
   it("generates a createResolver stub with SDK imports and transaction boilerplate", () => {
-    const result = generateResolverStub("createItem");
+    const result = renderStub("resolver", "createItem");
 
     expect(result).toContain('import { createResolver, t } from "@tailor-platform/sdk";');
     expect(result).toContain('import { createContext } from "@tailor-platform/erp-kit/app";');
@@ -252,15 +234,3 @@ describe("generateResolverStub", () => {
     expect(result).toContain('.description("CreateItem response")');
   });
 });
-
-describe("generateResolverTestStub", () => {
-  it("generates a test that imports and verifies the resolver", () => {
-    const result = generateResolverTestStub("createItem");
-
-    expect(result).toContain('import { describe, expect, it } from "vitest";');
-    expect(result).toContain('describe("createItem"');
-    expect(result).toContain('import("./createItem")');
-    expect(result).toContain("expect(resolver.default).toBeDefined()");
-    expect(result).toContain('expect(resolver.default.name).toBe("createItem")');
-  });
-});

package/src/generator/generate-code.ts

@@ -4,13 +4,7 @@ import { parseCommandDoc, type ParsedCommandDoc } from "./parse-command-doc";
 import { generateErrors } from "./generate-errors";
 import { generatePermissions } from "./generate-permissions";
 import { generateCommandShell, generateQueryShell } from "./generate-shells";
-import {
-  generateCommandStub,
-  generateTestStub,
-  generateQueryStub,
-  generateQueryTestStub,
-  generateDbStub,
-} from "./generate-stubs";
+import { renderStub } from "./stub-templates";
 import { scaffoldModuleBoilerplate } from "./scaffold";
 
 export function runGenerateCode(modulePath: string, moduleName: string): number {
@@ -81,13 +75,13 @@ export function runGenerateCode(modulePath: string, moduleName: string): number
     generated++;
 
     if (!fs.existsSync(implFile)) {
-      fs.writeFileSync(implFile, generateCommandStub(doc));
+      fs.writeFileSync(implFile, renderStub("command", doc.commandName));
       console.log(`  scaffolded ${path.relative(modulePath, implFile)}`);
     }
 
     const testFile = path.join(commandDir, `${doc.commandName}.test.ts`);
     if (!fs.existsSync(testFile)) {
-      fs.writeFileSync(testFile, generateTestStub(doc));
+      fs.writeFileSync(testFile, renderStub("commandTest", doc.commandName));
       console.log(`  scaffolded ${path.relative(modulePath, testFile)}`);
     }
   }
@@ -111,13 +105,13 @@ export function runGenerateCode(modulePath: string, moduleName: string): number
 
         const implFile = path.join(queryDir, `${doc.commandName}.ts`);
         if (!fs.existsSync(implFile)) {
-          fs.writeFileSync(implFile, generateQueryStub(doc));
+          fs.writeFileSync(implFile, renderStub("query", doc.commandName));
           console.log(`  scaffolded ${path.relative(modulePath, implFile)}`);
         }
 
         const testFile = path.join(queryDir, `${doc.commandName}.test.ts`);
         if (!fs.existsSync(testFile)) {
-          fs.writeFileSync(testFile, generateQueryTestStub(doc));
+          fs.writeFileSync(testFile, renderStub("queryTest", doc.commandName));
           console.log(`  scaffolded ${path.relative(modulePath, testFile)}`);
         }
       }
@@ -137,7 +131,7 @@ export function runGenerateCode(modulePath: string, moduleName: string): number
         const camelName = modelName.charAt(0).toLowerCase() + modelName.slice(1);
         const dbFile = path.join(dbDir, `${camelName}.ts`);
         if (!fs.existsSync(dbFile)) {
-          fs.writeFileSync(dbFile, generateDbStub(camelName));
+          fs.writeFileSync(dbFile, renderStub("db", camelName));
           console.log(`  scaffolded ${path.relative(modulePath, dbFile)}`);
         }
       }

package/src/generator/stub-templates.test.ts

@@ -46,10 +46,14 @@ describe("renderStub", () => {
     expect(result).toContain('getDB("main-db")');
   });
 
-  it("resolverTest: generates test that imports resolver", () => {
-    const result = renderStub("resolverTest", "createItem");
-    expect(result).toContain('describe("createItem"');
-    expect(result).toContain('import("./createItem")');
-    expect(result).toContain("resolver.default");
+  it("storyTest: generates integration test with graphql client and test cases", () => {
+    const result = renderStub("storyTest", "admin--create-item", [
+      "creates item successfully",
+      "rejects duplicate SKU",
+    ]);
+    expect(result).toContain('describe("admin--create-item"');
+    expect(result).toContain("createGraphQLClient");
+    expect(result).toContain('it("creates item successfully"');
+    expect(result).toContain('it("rejects duplicate SKU"');
   });
 });

package/src/generator/stub-templates.ts

@@ -122,16 +122,18 @@ export default createResolver({
 `;
     },
   },
-  resolverTest: {
-    render: (name: string) => {
-      return `import { describe, expect, it } from "vitest";
+  storyTest: {
+    render: (name: string, testCases: string[]) => {
+      const its = testCases
+        .map((tc) => `  it("${tc}", async () => {\n    // TODO: implement\n  });`)
+        .join("\n\n");
+      return `import { describe, expect, inject, it } from "vitest";
+import { createGraphQLClient } from "@/tests/utils/graphql-client";
 
 describe("${name}", () => {
-  it("should be implemented", async () => {
-    const resolver = await import("./${name}");
-    expect(resolver.default).toBeDefined();
-    expect(resolver.default.name).toBe("${name}");
-  });
+  const graphQLClient = createGraphQLClient(inject("url"), inject("token"));
+
+${its}
 });
 `;
     },
@@ -140,6 +142,11 @@ describe("${name}", () => {
 
 export type StubType = keyof typeof templates;
 
-export function renderStub(type: StubType, name: string): string {
+export function renderStub(type: "storyTest", name: string, testCases: string[]): string;
+export function renderStub(type: Exclude<StubType, "storyTest">, name: string): string;
+export function renderStub(type: StubType, name: string, testCases?: string[]): string {
+  if (type === "storyTest") {
+    return templates.storyTest.render(name, testCases!);
+  }
   return templates[type].render(name);
 }

package/src/modules/finance-ledger/README.md

@@ -0,0 +1,50 @@
+# README
+
+<!-- This section should contain the following subsections in order: -->
+<!-- 1. ## Overview (required) -->
+<!-- 2. ## Key Features (required) -->
+<!-- 3. ## Module Scope (required) -->
+<!-- 4. ## Module Dependencies (required) -->
+
+## Overview
+
+## Key Features
+
+<!-- List requirements: -->
+<!-- Minimum 1 unordered lists required -->
+<!-- Minimum 1 items per list -->
+
+- TODO: Add list item
+
+## Module Scope
+
+<!-- This section should contain the following subsections in order: -->
+<!-- 1. ### In Scope (required) -->
+<!-- 2. ### Out of Scope (required) -->
+<!-- 3. ### Scope Decision Rationale (required) -->
+
+### In Scope
+
+<!-- List requirements: -->
+<!-- Minimum 1 unordered lists required -->
+<!-- Minimum 1 items per list -->
+
+- TODO: Add list item
+
+### Out of Scope
+
+<!-- List requirements: -->
+<!-- Minimum 1 unordered lists required -->
+<!-- Minimum 1 items per list -->
+
+- TODO: Add list item
+
+### Scope Decision Rationale
+
+<!-- Explain why capabilities are in-scope or out-of-scope — domain alignment, separation of concerns, etc. -->
+
+## Module Dependencies
+
+<!-- List requirements: -->
+<!-- Minimum 1 items per list -->
+

package/src/modules/finance-ledger/command/addJournalLine.generated.ts

@@ -0,0 +1,6 @@
+// @generated — do not edit
+import { defineCommand } from "@tailor-platform/erp-kit/module";
+import { permissions } from "../lib/permissions.generated";
+import { run } from "./addJournalLine";
+
+export const addJournalLine = defineCommand(permissions.addJournalLine, run);