@tailor-platform/erp-kit 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @tailor-platform/erp-kit
 
+## 0.5.1
+
+### Patch Changes
+
+- fb40e4d: - Fix mdschema binary resolution to use platform-specific native binaries, enabling Windows support
+  - Fix init commands to be idempotent when directory already exists instead of erroring
+  - Add package.json and dev tooling to module template
+  - Update app skill to use erp-kit app generate seed
+
 ## 0.5.0
 
 ### Minor Changes

package/dist/cli.mjs

@@ -364,12 +364,35 @@ function runLicenseCheck(configPath) {
 //#endregion
 //#region src/mdschema.ts
 const require = createRequire(import.meta.url);
+const PLATFORMS = {
+	darwin: {
+		arm64: "@jackchuka/mdschema-darwin-arm64",
+		x64: "@jackchuka/mdschema-darwin-x64"
+	},
+	linux: {
+		arm64: "@jackchuka/mdschema-linux-arm64",
+		x64: "@jackchuka/mdschema-linux-x64"
+	},
+	win32: {
+		arm64: "@jackchuka/mdschema-windows-arm64",
+		x64: "@jackchuka/mdschema-windows-x64"
+	}
+};
 function getMdschemaBin() {
 	const pkgPath = require.resolve("@jackchuka/mdschema/package.json");
-	const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-	const bin = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.mdschema;
+	const pkgDir = path.dirname(pkgPath);
+	const mdschemaRequire = createRequire(pkgPath);
+	const ext = process.platform === "win32" ? ".exe" : "";
+	const pkg = PLATFORMS[process.platform]?.[process.arch];
+	if (pkg) try {
+		return mdschemaRequire.resolve(`${pkg}/bin/mdschema${ext}`);
+	} catch {}
+	const localBin = path.join(pkgDir, "bin", `mdschema${ext}`);
+	if (fs.existsSync(localBin)) return localBin;
+	const pkgJson = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+	const bin = typeof pkgJson.bin === "string" ? pkgJson.bin : pkgJson.bin?.mdschema;
 	if (!bin) throw new Error("Could not resolve mdschema binary from package.json bin field");
-	return path.join(path.dirname(pkgPath), bin);
+	return path.join(pkgDir, bin);
 }
 function runMdschema(args, cwd) {
 	return new Promise((resolve) => {
@@ -552,10 +575,6 @@ async function runCheck(config, cwd) {
 //#region src/commands/init-module.ts
 function runInitModule(name, dir) {
 	const moduleDir = path.resolve(dir, name);
-	if (fs.existsSync(moduleDir)) {
-		console.error(`Directory already exists: ${moduleDir}`);
-		return 1;
-	}
 	fs.mkdirSync(moduleDir, { recursive: true });
 	return 0;
 }
@@ -578,10 +597,6 @@ async function runInitModuleWithReadme(name, dir, cwd) {
 }
 function runInitApp(name, dir) {
 	const appDir = path.resolve(dir, name);
-	if (fs.existsSync(appDir)) {
-		console.error(`Directory already exists: ${appDir}`);
-		return 1;
-	}
 	fs.mkdirSync(appDir, { recursive: true });
 	return 0;
 }
@@ -1129,7 +1144,16 @@ function copyTemplateDir(srcDir, destDir, replacements, placeholderFiles) {
 	}
 }
 function scaffoldModuleBoilerplate(moduleDir, moduleName) {
-	copyTemplateDir(path.join(PACKAGE_ROOT, "templates", "scaffold", "module"), moduleDir, { "template-module": moduleName }, new Set(["permissions.ts", "tailor.config.ts"]));
+	const templateDir = path.join(PACKAGE_ROOT, "templates", "scaffold", "module");
+	const erpKitVersion = readErpKitVersion();
+	copyTemplateDir(templateDir, moduleDir, {
+		"template-module": moduleName,
+		"\"workspace:*\"": `"${erpKitVersion}"`
+	}, new Set([
+		"package.json",
+		"permissions.ts",
+		"tailor.config.ts"
+	]));
 }
 function scaffoldAppBoilerplate(appDir, appName) {
 	const templateDir = path.join(PACKAGE_ROOT, "templates", "scaffold", "app");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailor-platform/erp-kit",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Opinionated ERP toolkit for building business applications on Tailor Platform",
   "license": "MIT",
   "bin": {

package/skills/erp-kit-app-5-impl-backend/SKILL.md

@@ -99,7 +99,9 @@ Do not directly mutate module-owned tables via Kysely — always use module comm
 ### Phase 5: Generated Files
 
 - **Kysely types** (`src/generated/kysely-tailordb.ts`) — Auto-generated by `pnpm generate` after deployment. Before deployment, create a minimal placeholder so the codebase typechecks.
-- **Seed data** (`seed/`) — `exec.mjs` runner + `data/*.jsonl` (records) and `data/*.schema.ts` (validation). Create seed records for initial data (permissions, roles, test users, etc.). Seeded users must have concrete permission keys required by the wired modules.
+- **Seed data** (`seed/`) — `exec.mjs` runner + `data/*.jsonl` (records) and `data/*.schema.ts` (validation).
+  1. **Module seed** — Run `pnpm erp-kit app generate seed -p <app-path>` to generate module-provided defaults (currencies, units, UoM categories, exchange rates). This writes JSONL files to `seed/data/`, skipping files that already exist.
+  2. **App-specific seed** — Manually create seed records for permissions, roles, test users, and domain-specific data. Seeded users must have concrete permission keys required by the wired modules.
 
 ### Phase 6: Deploy Backend & Next Steps
 

package/src/commands/init-module.test.ts

@@ -14,12 +14,19 @@ describe("runInitModule", () => {
   });
 
   it("creates module directory", () => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "init-module-test-"));
+    const exitCode = runInitModule("my-module", tmpDir);
+    expect(exitCode).toBe(0);
+    expect(fs.existsSync(path.join(tmpDir, "my-module"))).toBe(true);
+  });
+
+  it("succeeds if module directory already exists", () => {
     tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "init-module-test-"));
     const moduleDir = path.join(tmpDir, "my-module");
     fs.mkdirSync(moduleDir, { recursive: true });
 
     const exitCode = runInitModule("my-module", tmpDir);
-    expect(exitCode).toBe(1); // should fail — dir exists
+    expect(exitCode).toBe(0);
   });
 });
 
@@ -32,12 +39,19 @@ describe("runInitApp", () => {
     }
   });
 
-  it("errors if app directory already exists", () => {
+  it("creates app directory", () => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "init-app-test-"));
+    const exitCode = runInitApp("my-app", tmpDir);
+    expect(exitCode).toBe(0);
+    expect(fs.existsSync(path.join(tmpDir, "my-app"))).toBe(true);
+  });
+
+  it("succeeds if app directory already exists", () => {
     tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "init-app-test-"));
     const appDir = path.join(tmpDir, "my-app");
     fs.mkdirSync(appDir, { recursive: true });
 
     const exitCode = runInitApp("my-app", tmpDir);
-    expect(exitCode).toBe(1);
+    expect(exitCode).toBe(0);
   });
 });

package/src/commands/init-module.ts

@@ -5,12 +5,6 @@ import { MODULE_SCHEMAS, APP_COMPOSE_SCHEMAS } from "../schemas";
 
 export function runInitModule(name: string, dir: string): number {
   const moduleDir = path.resolve(dir, name);
-
-  if (fs.existsSync(moduleDir)) {
-    console.error(`Directory already exists: ${moduleDir}`);
-    return 1;
-  }
-
   fs.mkdirSync(moduleDir, { recursive: true });
   return 0;
 }
@@ -40,12 +34,6 @@ export async function runInitModuleWithReadme(
 
 export function runInitApp(name: string, dir: string): number {
   const appDir = path.resolve(dir, name);
-
-  if (fs.existsSync(appDir)) {
-    console.error(`Directory already exists: ${appDir}`);
-    return 1;
-  }
-
   fs.mkdirSync(appDir, { recursive: true });
   return 0;
 }

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

@@ -24,7 +24,7 @@ describe("scaffoldModuleBoilerplate", () => {
       expect(fs.existsSync(path.join(moduleDir, dir))).toBe(true);
     }
 
-    for (const dir of ["db", "command", "executor", "generated", "query"]) {
+    for (const dir of ["db", "command", "executor", "query"]) {
       expect(fs.existsSync(path.join(moduleDir, dir, ".gitkeep"))).toBe(true);
     }
 
@@ -33,8 +33,12 @@ describe("scaffoldModuleBoilerplate", () => {
       "index.ts",
       "permissions.ts",
       "tailor.config.ts",
+      "package.json",
+      "eslint.config.js",
+      "tsconfig.json",
       "lib/types.ts",
       "testing/fixtures.ts",
+      "generated/kysely-tailordb.ts",
     ];
     for (const file of expectedFiles) {
       expect(fs.existsSync(path.join(moduleDir, file))).toBe(true);
@@ -46,6 +50,10 @@ describe("scaffoldModuleBoilerplate", () => {
     const config = fs.readFileSync(path.join(moduleDir, "tailor.config.ts"), "utf-8");
     expect(config).toContain('name: "test-module"');
 
+    const pkg = fs.readFileSync(path.join(moduleDir, "package.json"), "utf-8");
+    expect(pkg).toContain('"name": "test-module"');
+    expect(pkg).not.toContain("workspace:*");
+
     const moduleFile = fs.readFileSync(path.join(moduleDir, "module.ts"), "utf-8");
     expect(moduleFile).toContain("defineModule");
     expect(moduleFile).toContain("commands");

package/src/generator/scaffold.ts

@@ -38,8 +38,12 @@ export function copyTemplateDir(
 
 export function scaffoldModuleBoilerplate(moduleDir: string, moduleName: string): void {
   const templateDir = path.join(PACKAGE_ROOT, "templates", "scaffold", "module");
-  const replacements = { "template-module": moduleName };
-  const placeholderFiles = new Set(["permissions.ts", "tailor.config.ts"]);
+  const erpKitVersion = readErpKitVersion();
+  const replacements = {
+    "template-module": moduleName,
+    '"workspace:*"': `"${erpKitVersion}"`,
+  };
+  const placeholderFiles = new Set(["package.json", "permissions.ts", "tailor.config.ts"]);
   copyTemplateDir(templateDir, moduleDir, replacements, placeholderFiles);
 }
 

package/src/mdschema.ts

@@ -5,18 +5,54 @@ import { createRequire } from "node:module";
 
 const require = createRequire(import.meta.url);
 
+const PLATFORMS: Record<string, Record<string, string>> = {
+  darwin: {
+    arm64: "@jackchuka/mdschema-darwin-arm64",
+    x64: "@jackchuka/mdschema-darwin-x64",
+  },
+  linux: {
+    arm64: "@jackchuka/mdschema-linux-arm64",
+    x64: "@jackchuka/mdschema-linux-x64",
+  },
+  win32: {
+    arm64: "@jackchuka/mdschema-windows-arm64",
+    x64: "@jackchuka/mdschema-windows-x64",
+  },
+};
+
 interface PackageJson {
   bin?: string | Record<string, string>;
 }
 
 export function getMdschemaBin(): string {
   const pkgPath = require.resolve("@jackchuka/mdschema/package.json");
-  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as PackageJson;
-  const bin = typeof pkg.bin === "string" ? pkg.bin : pkg.bin?.mdschema;
+  const pkgDir = path.dirname(pkgPath);
+
+  // Resolve from mdschema's context so pnpm optionalDependencies are visible
+  const mdschemaRequire = createRequire(pkgPath);
+  const ext = process.platform === "win32" ? ".exe" : "";
+  const pkg = PLATFORMS[process.platform]?.[process.arch];
+  if (pkg) {
+    try {
+      return mdschemaRequire.resolve(`${pkg}/bin/mdschema${ext}`);
+    } catch {
+      // Platform package not installed, fall through
+    }
+  }
+
+  // Fallback: locally downloaded binary from install.js
+  const localBin = path.join(pkgDir, "bin", `mdschema${ext}`);
+  if (fs.existsSync(localBin)) {
+    return localBin;
+  }
+
+  // Last resort: cli.js wrapper (requires shebang support, won't work on Windows)
+  const pkgJson = JSON.parse(fs.readFileSync(pkgPath, "utf-8")) as PackageJson;
+  const bin = typeof pkgJson.bin === "string" ? pkgJson.bin : pkgJson.bin?.mdschema;
   if (!bin) {
     throw new Error("Could not resolve mdschema binary from package.json bin field");
   }
-  return path.join(path.dirname(pkgPath), bin);
+  return path.join(pkgDir, bin);
 }
 
 export interface MdschemaResult {

package/templates/scaffold/module/__dot__gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.eslintcache
+.tailor-sdk/

package/templates/scaffold/module/eslint.config.js

@@ -0,0 +1,31 @@
+import eslint from "@eslint/js";
+import { defineConfig, globalIgnores } from "eslint/config";
+import { createTypeScriptImportResolver } from "eslint-import-resolver-typescript";
+import importX from "eslint-plugin-import-x";
+import tseslint from "typescript-eslint";
+
+export default defineConfig([
+  globalIgnores([".tailor-sdk/", "seed/", "generated/", "tailor.d.ts"]),
+  {
+    files: ["**/*.ts"],
+    extends: [
+      eslint.configs.recommended,
+      tseslint.configs.recommendedTypeChecked,
+      tseslint.configs.stylisticTypeChecked,
+      importX.flatConfigs.recommended,
+      importX.flatConfigs.typescript,
+    ],
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    settings: {
+      "import-x/resolver-next": [createTypeScriptImportResolver()],
+    },
+    rules: {
+      "import-x/order": "error",
+    },
+  },
+]);

package/templates/scaffold/module/generated/kysely-tailordb.ts

@@ -0,0 +1,3 @@
+// Stub generated by scaffold template.
+// Overwritten when running `tailor-sdk generate`.
+export type DB = Record<string, never>;

package/templates/scaffold/module/lib/types.ts

@@ -1,9 +1,4 @@
+import type { InferSchema } from "@tailor-platform/erp-kit/module";
 import type { DB } from "../generated/kysely-tailordb";
-import type {
-  InferSchema,
-  Selectable,
-  Insertable,
-  Updateable,
-} from "@tailor-platform/erp-kit/module";
 
 export type Schema = InferSchema<DB>;

package/templates/scaffold/module/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "template-module",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "generate": "tailor-sdk generate",
+    "lint": "eslint --cache .",
+    "lint:fix": "eslint --cache --fix .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@tailor-platform/erp-kit": "workspace:*",
+    "@tailor-platform/sdk": "1.25.4"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "@tailor-platform/function-types": "0.8.2",
+    "@types/node": "24.12.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "eslint": "10.0.3",
+    "eslint-import-resolver-typescript": "4.4.4",
+    "eslint-plugin-import-x": "4.16.2",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.57.0"
+  }
+}

package/templates/scaffold/module/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "types": ["node", "@tailor-platform/function-types"]
+  },
+  "include": ["**/*.ts"]
+}