@haneinfo/app-tooling 0.1.0

package/LICENSE

@@ -0,0 +1,14 @@
+Copyright (c) 2026 Haneinfo. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are the proprietary and
+confidential property of Haneinfo. No part of the Software may be copied, modified, merged,
+published, distributed, sublicensed, or sold without the prior written permission of Haneinfo.
+
+The Software is provided for internal use by Haneinfo and its authorized personnel only, and is
+NOT licensed for external distribution or open-source use.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL HANEINFO BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
+THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# @haneinfo/app-tooling
+
+Run `haneinfo-app check` from an App repository to verify generated plugin artifacts, integration contract runtime files, enum documentation and translations, and domain event subscriber wiring. `haneinfo-app check plugins`, `integrations`, `enums`, or `subscribers` runs one gate. Use `--root <path>` to check another App and `--json` for machine-readable results. Missing enum translations and documentation fail; orphaned translation keys are warnings.
+
+This package owns App-level checks. The `scripts/lint-specs.mjs` file remains in each repository under the shared specs governance rule.
+
+`haneinfo-app scaffold` initializes an unmodified template clone. It requires `--name`,
+`--display-name`, `--db-port`, `--backend-port`, and `--frontend-port`; `--description`,
+`--ports-registry <dev-infra/app-ports.json>`, `--root`, and `--dry-run` are optional. The dry run
+checks all expected template patterns and prints a file-level plan without writing. The command
+updates package identity, environment examples, Docker port, frontend scripts, CI and E2E defaults,
+and the committed Keycloak E2E realm. It creates an ignored `.env` with a unique local database
+password while keeping placeholders in `.env.example`. A marker prevents a second initialization.

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cli_1 = require("./cli");
+void (0, cli_1.runAppToolingCli)(process.argv.slice(2), process.cwd(), {
+    stdout: (line) => process.stdout.write(`${line}\n`),
+    stderr: (line) => process.stderr.write(`${line}\n`),
+}).then((exitCode) => {
+    process.exitCode = exitCode;
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";;;AACA,+BAAyC;AAEzC,KAAK,IAAA,sBAAgB,EAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE;IAC1D,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;IACnD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;CACpD,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;IACnB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;AAC9B,CAAC,CAAC,CAAC"}

package/dist/checks.d.ts

@@ -0,0 +1,11 @@
+import { type CheckIssue } from './integration-contracts';
+export type CheckTarget = 'all' | 'plugins' | 'integrations' | 'enums' | 'subscribers';
+export interface CheckReport {
+    target: CheckTarget;
+    issues: CheckIssue[];
+    warnings: CheckIssue[];
+    passed: boolean;
+}
+/** Run stable App checks without invoking an App-local copy of each implementation. */
+export declare function checkApp(appRoot: string, target?: CheckTarget): Promise<CheckReport>;
+//# sourceMappingURL=checks.d.ts.map

package/dist/checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.d.ts","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAsC,MAAM,yBAAyB,CAAC;AAG9F,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,GAAG,aAAa,CAAC;AAEvF,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AA4BD,uFAAuF;AACvF,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,WAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAoBjG"}

package/dist/checks.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkApp = checkApp;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const plugin_cli_1 = require("@haneinfo/plugin-cli");
+const enums_1 = require("./enums");
+const integration_contracts_1 = require("./integration-contracts");
+const subscriber_wiring_1 = require("./subscriber-wiring");
+function pluginCliVersion() {
+    try {
+        const file = require.resolve('@haneinfo/plugin-cli/package.json');
+        return JSON.parse((0, node_fs_1.readFileSync)(file, 'utf8')).version ?? 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+async function checkPlugins(appRoot) {
+    const result = await plugin_cli_1.buildCommand.handler({
+        appRoot,
+        args: { command: 'build', positionals: [], flags: new Map([['check', true]]) },
+        io: { cwd: () => appRoot, stdout: () => { }, stderr: () => { } },
+        version: pluginCliVersion(),
+    });
+    if (result.exitCode === plugin_cli_1.ExitCode.OK)
+        return [];
+    return result.diagnostics
+        .filter((entry) => entry.severity === 'error')
+        .map((entry) => ({
+        code: entry.code,
+        path: entry.path ?? 'haneinfo.plugins.json',
+        message: entry.message,
+    }));
+}
+/** Run stable App checks without invoking an App-local copy of each implementation. */
+async function checkApp(appRoot, target = 'all') {
+    const root = node_path_1.default.resolve(appRoot);
+    const repositoryRoot = node_path_1.default.basename(root) === 'backend' && (0, node_fs_1.existsSync)(node_path_1.default.join(root, 'haneinfo.plugins.json'))
+        ? node_path_1.default.dirname(root)
+        : root;
+    const backendRoot = node_path_1.default.join(repositoryRoot, 'backend');
+    const issues = [];
+    const warnings = [];
+    if (target === 'all' || target === 'plugins')
+        issues.push(...(await checkPlugins(backendRoot)));
+    if (target === 'all' || target === 'integrations')
+        issues.push(...(0, integration_contracts_1.checkGeneratedIntegrationContracts)(repositoryRoot));
+    if (target === 'all' || target === 'enums') {
+        const enums = (0, enums_1.checkEnums)(repositoryRoot);
+        issues.push(...enums.issues);
+        warnings.push(...enums.warnings);
+    }
+    if (target === 'all' || target === 'subscribers')
+        issues.push(...(0, subscriber_wiring_1.checkDomainEventSubscribers)(repositoryRoot));
+    return { target, issues, warnings, passed: issues.length === 0 };
+}
+//# sourceMappingURL=checks.js.map

package/dist/checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checks.js","sourceRoot":"","sources":["../src/checks.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+export type AppToolingOutput = {
+    stdout: (line: string) => void;
+    stderr: (line: string) => void;
+};
+/** Exit codes: 0 passed, 1 verification failed, 2 invalid invocation, 3 unexpected error. */
+export declare function runAppToolingCli(argv: string[], cwd: string, output: AppToolingOutput): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,gBAAgB,GAAG;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,CAAC;AAKlG,6FAA6F;AAC7F,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,MAAM,CAAC,CAgDjB"}

package/dist/cli.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAppToolingCli = runAppToolingCli;
+const node_util_1 = require("node:util");
+const checks_1 = require("./checks");
+const scaffold_1 = require("./scaffold");
+const USAGE = 'Usage: haneinfo-app check [all|plugins|integrations|enums|subscribers] [--root <app-root>] [--json]\n       haneinfo-app scaffold --name <kebab-case> --display-name <text> --db-port <port> --backend-port <port> --frontend-port <port> [--description <text>] [--ports-registry <file>] [--root <template-root>] [--dry-run]';
+/** Exit codes: 0 passed, 1 verification failed, 2 invalid invocation, 3 unexpected error. */
+async function runAppToolingCli(argv, cwd, output) {
+    if (argv[0] === 'scaffold')
+        return runScaffoldCli(argv.slice(1), cwd, output);
+    let parsed;
+    try {
+        parsed = (0, node_util_1.parseArgs)({
+            args: argv,
+            options: { root: { type: 'string' }, json: { type: 'boolean' }, help: { type: 'boolean' } },
+            allowPositionals: true,
+            strict: true,
+        });
+    }
+    catch (error) {
+        output.stderr(`${error instanceof Error ? error.message : String(error)}\n${USAGE}`);
+        return 2;
+    }
+    if (parsed.values.help === true) {
+        output.stdout(USAGE);
+        return 0;
+    }
+    const [command, requested = 'all', ...extra] = parsed.positionals;
+    if (command !== 'check' ||
+        extra.length > 0 ||
+        !['all', 'plugins', 'integrations', 'enums', 'subscribers'].includes(requested)) {
+        output.stderr(USAGE);
+        return 2;
+    }
+    try {
+        const root = typeof parsed.values.root === 'string' ? parsed.values.root : cwd;
+        const report = await (0, checks_1.checkApp)(root, requested);
+        if (parsed.values.json) {
+            output.stdout(JSON.stringify(report, null, 2));
+        }
+        else if (report.passed) {
+            output.stdout(`haneinfo-app: ${report.target} checks passed`);
+        }
+        else {
+            for (const issue of report.issues)
+                output.stderr(`${issue.code} ${issue.path}: ${issue.message}`);
+        }
+        if (!parsed.values.json) {
+            for (const warning of report.warnings)
+                output.stderr(`warning ${warning.code} ${warning.path}: ${warning.message}`);
+        }
+        return report.passed ? 0 : 1;
+    }
+    catch (error) {
+        output.stderr(`haneinfo-app: ${error instanceof Error ? error.message : String(error)}`);
+        return 3;
+    }
+}
+function runScaffoldCli(argv, cwd, output) {
+    let parsed;
+    try {
+        parsed = (0, node_util_1.parseArgs)({
+            args: argv,
+            options: {
+                name: { type: 'string' },
+                'display-name': { type: 'string' },
+                description: { type: 'string' },
+                'db-port': { type: 'string' },
+                'backend-port': { type: 'string' },
+                'frontend-port': { type: 'string' },
+                'ports-registry': { type: 'string' },
+                root: { type: 'string' },
+                'dry-run': { type: 'boolean' },
+                help: { type: 'boolean' },
+            },
+            allowPositionals: false,
+            strict: true,
+        });
+    }
+    catch (error) {
+        output.stderr(`${error instanceof Error ? error.message : String(error)}\n${USAGE}`);
+        return 2;
+    }
+    if (parsed.values.help) {
+        output.stdout(USAGE);
+        return 0;
+    }
+    const values = parsed.values;
+    const required = ['name', 'display-name', 'db-port', 'backend-port', 'frontend-port'];
+    if (required.some((key) => typeof values[key] !== 'string' || !values[key])) {
+        output.stderr(USAGE);
+        return 2;
+    }
+    try {
+        const changes = (0, scaffold_1.scaffoldApp)({
+            root: values.root ?? cwd,
+            name: values.name,
+            displayName: values['display-name'],
+            description: values.description,
+            dbPort: Number(values['db-port']),
+            backendPort: Number(values['backend-port']),
+            frontendPort: Number(values['frontend-port']),
+            portsRegistry: values['ports-registry'],
+            dryRun: values['dry-run'] === true,
+        });
+        output.stdout(values['dry-run'] ? 'scaffold dry run passed; no files written' : 'scaffold initialized');
+        for (const file of changes)
+            output.stdout(`${file.file}: ${file.changes.join(', ')}`);
+        return 0;
+    }
+    catch (error) {
+        output.stderr(`haneinfo-app scaffold: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/enum-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=enum-worker.d.ts.map

package/dist/enum-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-worker.d.ts","sourceRoot":"","sources":["../src/enum-worker.ts"],"names":[],"mappings":""}

package/dist/enum-worker.js

@@ -0,0 +1,17 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = require("node:fs");
+const node_module_1 = require("node:module");
+const node_path_1 = __importDefault(require("node:path"));
+// @haneinfo/common selects the consuming App's Prisma client from process.cwd() at import time.
+// This worker keeps that resolution isolated when one process checks several Apps.
+const appRequire = (0, node_module_1.createRequire)(node_path_1.default.join(process.cwd(), 'package.json'));
+const api = appRequire('@haneinfo/metadata-schema');
+const dictionaries = JSON.parse((0, node_fs_1.readFileSync)(0, 'utf8'));
+const meta = new api.MetaService().buildMeta();
+const gaps = api.collectEnumTranslationGaps(meta, dictionaries);
+process.stdout.write(JSON.stringify({ meta, gaps }));
+//# sourceMappingURL=enum-worker.js.map

package/dist/enum-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enum-worker.js","sourceRoot":"","sources":["../src/enum-worker.ts"],"names":[],"mappings":";;;;;AAAA,qCAAuC;AACvC,6CAA4C;AAC5C,0DAA6B;AAE7B,gGAAgG;AAChG,mFAAmF;AACnF,MAAM,UAAU,GAAG,IAAA,2BAAa,EAAC,mBAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AAC3E,MAAM,GAAG,GAAG,UAAU,CAAC,2BAA2B,CAGjD,CAAC;AACF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,CAAC,CAA4C,CAAC;AACpG,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;AAC/C,MAAM,IAAI,GAAG,GAAG,CAAC,0BAA0B,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;AAChE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC"}

package/dist/enums.d.ts

@@ -0,0 +1,29 @@
+import type { CheckIssue } from './integration-contracts';
+interface EnumMeta {
+    enums: Array<{
+        name: string;
+        documentation?: string;
+        values: Array<{
+            name: string;
+        }>;
+    }>;
+}
+interface EnumGap {
+    locale: string;
+    key: string;
+    kind: 'missing' | 'orphaned';
+}
+interface MetadataApi {
+    MetaService: new () => {
+        buildMeta(): EnumMeta;
+    };
+    collectEnumTranslationGaps(meta: EnumMeta, dictionaries: Record<string, Record<string, unknown>>): EnumGap[];
+}
+export interface EnumCheckResult {
+    issues: CheckIssue[];
+    warnings: CheckIssue[];
+}
+/** Use the App's generated Prisma client when checking schema docs and enum translations. */
+export declare function checkEnums(appRoot: string, metadataApi?: MetadataApi): EnumCheckResult;
+export {};
+//# sourceMappingURL=enums.d.ts.map

package/dist/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,UAAU,QAAQ;IAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACzF;AAED,UAAU,OAAO;IACf,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;CAC9B;AAED,UAAU,WAAW;IACnB,WAAW,EAAE,UAAU;QAAE,SAAS,IAAI,QAAQ,CAAA;KAAE,CAAC;IACjD,0BAA0B,CACxB,IAAI,EAAE,QAAQ,EACd,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACpD,OAAO,EAAE,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAkBD,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,eAAe,CAyDtF"}

package/dist/enums.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkEnums = checkEnums;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+function metadataFromApp(backendRoot, dictionaries) {
+    const result = (0, node_child_process_1.spawnSync)(process.execPath, [node_path_1.default.join(__dirname, 'enum-worker.js')], {
+        cwd: backendRoot,
+        input: JSON.stringify(dictionaries),
+        encoding: 'utf8',
+        timeout: 30_000,
+        maxBuffer: 16 * 1024 * 1024,
+    });
+    if (result.error || result.status !== 0)
+        throw new Error(result.error?.message ?? result.stderr.trim() ?? 'enum worker failed');
+    return JSON.parse(result.stdout);
+}
+/** Use the App's generated Prisma client when checking schema docs and enum translations. */
+function checkEnums(appRoot, metadataApi) {
+    const backendRoot = node_path_1.default.join(appRoot, 'backend');
+    const issues = [];
+    const warnings = [];
+    const dictionaries = {};
+    for (const locale of ['en', 'zh-TW']) {
+        const file = node_path_1.default.join(appRoot, 'frontend', 'messages', `${locale}.json`);
+        if (!(0, node_fs_1.existsSync)(file)) {
+            issues.push({
+                code: 'enum-dictionary-missing',
+                path: file,
+                message: 'locale file is missing',
+            });
+            continue;
+        }
+        try {
+            const parsed = JSON.parse((0, node_fs_1.readFileSync)(file, 'utf8'));
+            if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+                throw new Error('locale file must contain a JSON object');
+            const enums = parsed.enums;
+            if (enums !== undefined && (!enums || typeof enums !== 'object' || Array.isArray(enums)))
+                throw new Error('enums must be a JSON object');
+            dictionaries[locale] = (enums ?? {});
+        }
+        catch (error) {
+            issues.push({
+                code: 'enum-dictionary-invalid',
+                path: file,
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    if (Object.keys(dictionaries).length === 2) {
+        const { meta, gaps } = metadataApi
+            ? { meta: new metadataApi.MetaService().buildMeta(), gaps: [] }
+            : metadataFromApp(backendRoot, dictionaries);
+        if (metadataApi)
+            gaps.push(...metadataApi.collectEnumTranslationGaps(meta, dictionaries));
+        for (const item of meta.enums) {
+            if (!item.documentation?.trim()) {
+                issues.push({
+                    code: 'enum-documentation-missing',
+                    path: node_path_1.default.join(backendRoot, 'prisma', 'schema'),
+                    message: `enum ${item.name} is missing a /// doc comment`,
+                });
+            }
+        }
+        for (const gap of gaps) {
+            const issue = {
+                code: gap.kind === 'missing' ? 'enum-translation-missing' : 'enum-translation-orphaned',
+                path: node_path_1.default.join(appRoot, 'frontend', 'messages', `${gap.locale}.json`),
+                message: `${gap.locale}: ${gap.key}`,
+            };
+            (gap.kind === 'missing' ? issues : warnings).push(issue);
+        }
+    }
+    return { issues, warnings };
+}
+//# sourceMappingURL=enums.js.map

package/dist/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../src/enums.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './checks';
+export * from './cli';
+export * from './enums';
+export * from './integration-contracts';
+export * from './scaffold';
+export * from './subscriber-wiring';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./checks"), exports);
+__exportStar(require("./cli"), exports);
+__exportStar(require("./enums"), exports);
+__exportStar(require("./integration-contracts"), exports);
+__exportStar(require("./scaffold"), exports);
+__exportStar(require("./subscriber-wiring"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,wCAAsB;AACtB,0CAAwB;AACxB,0DAAwC;AACxC,6CAA2B;AAC3B,sDAAoC"}

package/dist/integration-contracts.d.ts

@@ -0,0 +1,8 @@
+export interface CheckIssue {
+    code: string;
+    path: string;
+    message: string;
+}
+/** Check committed runtime files against the canonical integration contract references. */
+export declare function checkGeneratedIntegrationContracts(appRoot: string): CheckIssue[];
+//# sourceMappingURL=integration-contracts.d.ts.map

package/dist/integration-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-contracts.d.ts","sourceRoot":"","sources":["../src/integration-contracts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AA4DD,2FAA2F;AAC3F,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CA+GhF"}

package/dist/integration-contracts.js

@@ -0,0 +1,160 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkGeneratedIntegrationContracts = checkGeneratedIntegrationContracts;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+function walk(directory) {
+    if (!(0, node_fs_1.existsSync)(directory))
+        return [];
+    return (0, node_fs_1.readdirSync)(directory, { withFileTypes: true }).flatMap((entry) => {
+        const file = node_path_1.default.join(directory, entry.name);
+        return entry.isDirectory() ? walk(file) : [file];
+    });
+}
+function typescriptType(schema) {
+    if (!schema || typeof schema !== 'object')
+        return 'unknown';
+    const node = schema;
+    if (Array.isArray(node.enum))
+        return node.enum.map((value) => JSON.stringify(value)).join(' | ');
+    if (node.const !== undefined)
+        return JSON.stringify(node.const);
+    if (Array.isArray(node.type))
+        return node.type.map((type) => typescriptType({ ...node, type })).join(' | ');
+    if (node.type === 'object') {
+        const required = Array.isArray(node.required) ? node.required : [];
+        const properties = Object.entries((node.properties ?? {})).map(([key, child]) => `${JSON.stringify(key)}${required.includes(key) ? '' : '?'}: ${typescriptType(child)};`);
+        return `{ ${properties.join(' ')}${node.additionalProperties === false ? '' : ' [key: string]: unknown;'} }`;
+    }
+    if (node.type === 'array')
+        return `Array<${typescriptType(node.items ?? {})}>`;
+    if (node.type === 'integer' || node.type === 'number')
+        return 'number';
+    if (node.type === 'boolean' || node.type === 'string' || node.type === 'null')
+        return node.type;
+    if (node.anyOf || node.oneOf)
+        return (node.anyOf ?? node.oneOf).map(typescriptType).join(' | ');
+    if (node.allOf)
+        return node.allOf.map(typescriptType).join(' & ');
+    return 'unknown';
+}
+function expectedFiles(ref, schema) {
+    return {
+        'manifest.ts': `export const integrationContractManifest = ${JSON.stringify({
+            contractId: ref.contract_id,
+            version: ref.version,
+            kind: ref.kind,
+            digest: ref.digest,
+            capabilityRef: ref.capability_ref,
+        }, null, 2)} as const;\n`,
+        'types.ts': `export type IntegrationContractPayload = ${typescriptType(schema)};\n`,
+        'validators.ts': `import { validateJsonSchema, type SchemaValidationIssue } from '@haneinfo/integration-contracts';\n\nconst integrationContractSchema = ${JSON.stringify(schema, null, 2)} as const;\n\nexport function validateIntegrationContractPayload(value: unknown): SchemaValidationIssue[] {\n  return validateJsonSchema(value, integrationContractSchema as never, { mode: 'strict' });\n}\n`,
+    };
+}
+/** Check committed runtime files against the canonical integration contract references. */
+function checkGeneratedIntegrationContracts(appRoot) {
+    const refsRoot = node_path_1.default.resolve(appRoot, 'specs', 'contracts');
+    const runtimeRoot = node_path_1.default.resolve(appRoot, 'backend', 'src', 'generated', 'integration-contracts');
+    const issues = [];
+    const expectedDirectories = new Set();
+    const refs = walk(refsRoot).filter((file) => file.endsWith(node_path_1.default.join('_generated', 'contract-ref.json')));
+    for (const refFile of refs) {
+        let ref;
+        try {
+            ref = JSON.parse((0, node_fs_1.readFileSync)(refFile, 'utf8'));
+        }
+        catch {
+            issues.push({
+                code: 'contract-ref-invalid',
+                path: refFile,
+                message: 'contract-ref.json is not valid JSON',
+            });
+            continue;
+        }
+        if (typeof ref.contract_id !== 'string' ||
+            !ref.contract_id ||
+            !/^[A-Za-z0-9_.-]+$/.test(ref.contract_id) ||
+            ref.contract_id.includes('..')) {
+            issues.push({
+                code: 'contract-id-invalid',
+                path: refFile,
+                message: 'contract_id must be a safe path segment',
+            });
+            continue;
+        }
+        if (![ref.version, ref.kind, ref.digest, ref.capability_ref].every((value) => typeof value === 'string' && value.length > 0)) {
+            issues.push({
+                code: 'contract-ref-invalid',
+                path: refFile,
+                message: 'version, kind, digest, and capability_ref must be non-empty strings',
+            });
+            continue;
+        }
+        const safeId = ref.contract_id.replace(/[^a-zA-Z0-9_-]/gu, '_');
+        if (expectedDirectories.has(safeId)) {
+            issues.push({
+                code: 'contract-id-duplicate',
+                path: refFile,
+                message: `duplicate runtime directory ${safeId}`,
+            });
+            continue;
+        }
+        expectedDirectories.add(safeId);
+        const schemaFile = walk(node_path_1.default.join(refsRoot, ref.contract_id, '_generated'))
+            .filter((file) => file.endsWith('.schema.json'))
+            .sort()[0];
+        if (!schemaFile) {
+            issues.push({
+                code: 'contract-schema-missing',
+                path: refFile,
+                message: `missing canonical schema for ${ref.contract_id}@${ref.version}`,
+            });
+            continue;
+        }
+        let schema;
+        try {
+            schema = JSON.parse((0, node_fs_1.readFileSync)(schemaFile, 'utf8'));
+        }
+        catch {
+            issues.push({
+                code: 'contract-schema-invalid',
+                path: schemaFile,
+                message: 'canonical schema is not valid JSON',
+            });
+            continue;
+        }
+        for (const [name, expected] of Object.entries(expectedFiles(ref, schema))) {
+            const target = node_path_1.default.join(runtimeRoot, safeId, name);
+            if (!(0, node_fs_1.existsSync)(target)) {
+                issues.push({
+                    code: 'contract-runtime-missing',
+                    path: target,
+                    message: `${ref.contract_id}@${ref.version}: ${name} is missing`,
+                });
+            }
+            else if ((0, node_fs_1.readFileSync)(target, 'utf8') !== expected) {
+                issues.push({
+                    code: 'contract-runtime-stale',
+                    path: target,
+                    message: `${ref.contract_id}@${ref.version}: ${name} is stale`,
+                });
+            }
+        }
+    }
+    if ((0, node_fs_1.existsSync)(runtimeRoot)) {
+        for (const entry of (0, node_fs_1.readdirSync)(runtimeRoot, { withFileTypes: true })) {
+            if (entry.isDirectory() && !expectedDirectories.has(entry.name)) {
+                issues.push({
+                    code: 'contract-runtime-orphaned',
+                    path: node_path_1.default.join(runtimeRoot, entry.name),
+                    message: `orphaned runtime directory ${entry.name}`,
+                });
+            }
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=integration-contracts.js.map

package/dist/integration-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-contracts.js","sourceRoot":"","sources":["../src/integration-contracts.ts"],"names":[],"mappings":"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"}

package/dist/scaffold.d.ts

@@ -0,0 +1,18 @@
+export interface ScaffoldInput {
+    root: string;
+    name: string;
+    displayName: string;
+    description?: string;
+    dbPort: number;
+    backendPort: number;
+    frontendPort: number;
+    portsRegistry?: string;
+    dryRun?: boolean;
+}
+export interface ScaffoldChange {
+    file: string;
+    changes: string[];
+}
+/** Preflight every template rule before writing any file. */
+export declare function scaffoldApp(input: ScaffoldInput): ScaffoldChange[];
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AASD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAwRD,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,EAAE,CAwClE"}

package/dist/scaffold.js

@@ -0,0 +1,208 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scaffoldApp = scaffoldApp;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+function validPort(value) {
+    return Number.isInteger(value) && value >= 1 && value <= 65535;
+}
+function checkPorts(input) {
+    const selected = [input.dbPort, input.backendPort, input.frontendPort];
+    if (!selected.every(validPort))
+        throw new Error('DB, backend, and frontend ports are required TCP ports (1–65535)');
+    if (new Set(selected).size !== 3)
+        throw new Error('DB, backend, and frontend ports must be distinct');
+    if (!input.portsRegistry)
+        return;
+    const file = node_path_1.default.resolve(input.portsRegistry);
+    const registry = JSON.parse((0, node_fs_1.readFileSync)(file, 'utf8'));
+    if (registry.version !== 1 || !Array.isArray(registry.apps))
+        throw new Error(`${file}: expected a version 1 App port registry`);
+    const seenNames = new Set();
+    const seenPorts = new Map();
+    for (const app of registry.apps) {
+        if (!app || typeof app.name !== 'string' || !app.name || seenNames.has(app.name))
+            throw new Error(`${file}: duplicate or invalid App name in port registry`);
+        seenNames.add(app.name);
+        if (app.name === input.name)
+            throw new Error(`${file}: App ${input.name} is already registered`);
+        const ports = [app.dbPort, app.backendPort, app.frontendPort];
+        if (!ports.every(validPort) || new Set(ports).size !== 3)
+            throw new Error(`${file}: ${app.name} has invalid or duplicate ports`);
+        for (const port of ports) {
+            if (seenPorts.has(port))
+                throw new Error(`${file}: port ${port} is registered to multiple Apps`);
+            seenPorts.set(port, app.name);
+        }
+    }
+    for (const port of selected) {
+        const owner = seenPorts.get(port);
+        if (owner)
+            throw new Error(`port ${port} is already registered to ${owner} in ${file}`);
+    }
+}
+function validate(input) {
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(input.name))
+        throw new Error('name must use lowercase kebab-case');
+    if (!input.displayName || input.displayName.length > 80 || /[\p{Cc}`$]/u.test(input.displayName))
+        throw new Error('display-name must be 1–80 printable characters without backticks or $');
+    if (input.description && (input.description.length > 240 || /\p{Cc}/u.test(input.description)))
+        throw new Error('description must be at most 240 printable characters');
+    const rootPackage = JSON.parse((0, node_fs_1.readFileSync)(node_path_1.default.join(input.root, 'package.json'), 'utf8'));
+    if (rootPackage.name !== 'haneinfo-app-template')
+        throw new Error('scaffold requires an uninitialized haneinfo-app-template clone');
+    if ((0, node_fs_1.existsSync)(node_path_1.default.join(input.root, '.haneinfo', 'scaffold.json')))
+        throw new Error('scaffold already initialized this App');
+    if ((0, node_fs_1.existsSync)(node_path_1.default.join(input.root, '.env')))
+        throw new Error('scaffold requires a clone without .env so local credentials cannot be overwritten');
+    checkPorts(input);
+}
+function makePlan(input) {
+    validate(input);
+    const planned = new Map();
+    const description = input.description ?? input.displayName;
+    const change = (file, from, to, label, minimum = 1) => {
+        const absolutePath = node_path_1.default.join(input.root, file);
+        let item = planned.get(file);
+        if (!item) {
+            const original = (0, node_fs_1.readFileSync)(absolutePath, 'utf8');
+            item = { file, absolutePath, original, content: original, changes: [] };
+            planned.set(file, item);
+        }
+        const occurrences = item.content.split(from).length - 1;
+        if (occurrences < minimum)
+            throw new Error(`${file}: expected ${label} (${JSON.stringify(from)}), found ${occurrences}`);
+        item.content = item.content.replaceAll(from, to);
+        item.changes.push(`${label}: ${from} → ${to} (${occurrences})`);
+    };
+    const env = (key, value) => {
+        const file = '.env.example';
+        const absolutePath = node_path_1.default.join(input.root, file);
+        let item = planned.get(file);
+        if (!item) {
+            const original = (0, node_fs_1.readFileSync)(absolutePath, 'utf8');
+            item = { file, absolutePath, original, content: original, changes: [] };
+            planned.set(file, item);
+        }
+        const expression = new RegExp(`^${key}=[^\\r\\n]*`, 'gmu');
+        const matches = [...item.content.matchAll(expression)];
+        if (matches.length !== 1)
+            throw new Error(`${file}: expected one ${key} entry, found ${matches.length}`);
+        item.content = item.content.replace(expression, `${key}=${value}`);
+        item.changes.push(`${key} → ${value}`);
+    };
+    change('package.json', '"name": "haneinfo-app-template"', `"name": "${input.name}"`, 'root package name');
+    change('backend/package.json', '"name": "@app/backend"', `"name": "@app/${input.name}"`, 'backend package name');
+    change('frontend/package.json', '"name": "@app/frontend"', `"name": "${input.name}"`, 'frontend package name');
+    change('frontend/package.json', 'next dev -p 3901', `next dev -p ${input.frontendPort}`, 'frontend dev port');
+    change('frontend/package.json', 'next start -p 3901', `next start -p ${input.frontendPort}`, 'frontend start port');
+    env('APP_NAME', input.name);
+    env('MCP_TOOL_PREFIX', input.name);
+    env('DB_PORT', String(input.dbPort));
+    env('DATABASE_URL', `'postgresql://postgres:<set-a-strong-password>@localhost:${input.dbPort}/app_db'`);
+    env('OIDC_AUDIENCE', `"${input.name}"`);
+    env('AUTH_KEYCLOAK_ID', `"${input.name}"`);
+    env('CORS_ORIGINS', `http://localhost:${input.frontendPort}`);
+    env('PORT', String(input.backendPort));
+    env('BACKEND_PORT', String(input.backendPort));
+    env('FRONTEND_PORT', String(input.frontendPort));
+    env('NEXT_PUBLIC_API_URL', `http://localhost:${input.backendPort}`);
+    env('PUBLIC_BASE_URL', `http://localhost:${input.backendPort}`);
+    const dollar = '$';
+    change('docker-compose.yml', `${dollar}{DB_PORT:-23900}`, `${dollar}{DB_PORT:-${input.dbPort}}`, 'Docker DB fallback');
+    change('frontend/src/config/app-config.ts', '"Haneinfo App Template"', JSON.stringify(input.displayName), 'display name');
+    change('frontend/src/config/app-config.ts', 'Haneinfo App Template.', `${input.displayName}.`, 'copyright');
+    change('frontend/src/config/app-config.ts', '"Haneinfo App Template is a fully customizable starter for business systems built with Next.js 16, Tailwind CSS v4, and shadcn/ui."', JSON.stringify(description), 'description');
+    change('README.md', '# haneinfo-app-template', `# ${input.name}`, 'README title');
+    change('README.md', 'localhost:23900', `localhost:${input.dbPort}`, 'README DB URL');
+    change('README.md', 'localhost:3900', `localhost:${input.backendPort}`, 'README backend URL');
+    change('README.md', 'localhost:3901', `localhost:${input.frontendPort}`, 'README frontend URL');
+    change('README.md', 'port 3900', `port ${input.backendPort}`, 'README backend prose');
+    change('README.md', 'port 3901', `port ${input.frontendPort}`, 'README frontend prose');
+    for (const file of ['AGENTS.md', 'CLAUDE.md', 'docs/agent-guide.md'])
+        change(file, '# haneinfo-app-template', `# ${input.name}`, 'guide title');
+    change('backend/prisma/seed.ts', '"haneinfo-app-template"', JSON.stringify(input.name), 'seed App fallback');
+    change('backend/src/main.ts', 'localhost:3901', `localhost:${input.frontendPort}`, 'CORS example');
+    change('backend/src/app.module.spec.ts', '"haneinfo-app-template"', JSON.stringify(input.name), 'topology test App identity');
+    change('e2e/test-env.ts', '"E2E_KEYCLOAK_CLIENT_ID", "template"', `"E2E_KEYCLOAK_CLIENT_ID", "${input.name}"`, 'E2E client ID');
+    change('e2e/test-env.ts', '"E2E_KEYCLOAK_CLIENT_SECRET", "dev-secret-template"', `"E2E_KEYCLOAK_CLIENT_SECRET", "dev-secret-${input.name}"`, 'E2E client secret');
+    change('e2e/keycloak/README.md', '`template` client', `\`${input.name}\` client`, 'realm README client');
+    change('e2e/keycloak/README.md', 'dev-secret-template', `dev-secret-${input.name}`, 'realm README secret');
+    change('e2e/keycloak/README.md', 'localhost:3901', `localhost:${input.frontendPort}`, 'realm README frontend URL');
+    const workflow = '.gitea/workflows/ci.yml';
+    change(workflow, 'haneinfo-app-template', input.name, 'CI App identity');
+    change(workflow, 'dev-secret-template', `dev-secret-${input.name}`, 'CI OIDC client secret');
+    change(workflow, 'OIDC_AUDIENCE=template', `OIDC_AUDIENCE=${input.name}`, 'CI OIDC audience');
+    change(workflow, 'AUTH_KEYCLOAK_ID=template', `AUTH_KEYCLOAK_ID=${input.name}`, 'CI OIDC client ID');
+    change(workflow, 'E2E_KEYCLOAK_CLIENT_ID: template', `E2E_KEYCLOAK_CLIENT_ID: ${input.name}`, 'CI E2E client ID');
+    change(workflow, 'localhost:3900', `localhost:${input.backendPort}`, 'CI backend URL');
+    change(workflow, 'localhost:3901', `localhost:${input.frontendPort}`, 'CI frontend URL');
+    change(workflow, 'PORT=3900', `PORT=${input.backendPort}`, 'CI backend port');
+    change(workflow, 'FRONTEND_PORT=3901', `FRONTEND_PORT=${input.frontendPort}`, 'CI frontend port');
+    const realmFile = 'e2e/keycloak/haneinfo-dev-realm.json';
+    const realmPath = node_path_1.default.join(input.root, realmFile);
+    const realmSource = (0, node_fs_1.readFileSync)(realmPath, 'utf8');
+    const realm = JSON.parse(realmSource);
+    if (realm.clients?.filter((client) => client.clientId === 'template').length !== 1)
+        throw new Error(`${realmFile}: expected one template client`);
+    const replacedRealm = realmSource
+        .replace(/\btemplate\b/gu, input.name)
+        .replaceAll('localhost:3901', `localhost:${input.frontendPort}`);
+    JSON.parse(replacedRealm);
+    planned.set(realmFile, {
+        file: realmFile,
+        absolutePath: realmPath,
+        original: realmSource,
+        content: replacedRealm,
+        changes: [
+            `template client, roles, groups, and flows → ${input.name}`,
+            `frontend redirect URI: 3901 → ${input.frontendPort}`,
+        ],
+    });
+    return [...planned.values()];
+}
+/** Preflight every template rule before writing any file. */
+function scaffoldApp(input) {
+    const root = node_path_1.default.resolve(input.root);
+    const plan = makePlan({ ...input, root });
+    if (!input.dryRun) {
+        const envExample = plan.find((file) => file.file === '.env.example');
+        if (!envExample)
+            throw new Error('scaffold did not plan .env.example');
+        const password = (0, node_crypto_1.randomBytes)(16).toString('hex');
+        const marker = node_path_1.default.join(root, '.haneinfo', 'scaffold.json');
+        const localEnv = node_path_1.default.join(root, '.env');
+        const written = [];
+        try {
+            for (const file of plan) {
+                written.push(file);
+                (0, node_fs_1.writeFileSync)(file.absolutePath, file.content);
+            }
+            (0, node_fs_1.writeFileSync)(localEnv, envExample.content.replaceAll('<set-a-strong-password>', password));
+            (0, node_fs_1.mkdirSync)(node_path_1.default.dirname(marker), { recursive: true });
+            (0, node_fs_1.writeFileSync)(marker, `${JSON.stringify({
+                version: 1,
+                name: input.name,
+                displayName: input.displayName,
+                dbPort: input.dbPort,
+                backendPort: input.backendPort,
+                frontendPort: input.frontendPort,
+            }, null, 2)}\n`);
+        }
+        catch (error) {
+            for (const file of written.reverse())
+                (0, node_fs_1.writeFileSync)(file.absolutePath, file.original);
+            if ((0, node_fs_1.existsSync)(localEnv))
+                (0, node_fs_1.unlinkSync)(localEnv);
+            if ((0, node_fs_1.existsSync)(marker))
+                (0, node_fs_1.unlinkSync)(marker);
+            throw error;
+        }
+    }
+    return plan.map(({ file, changes }) => ({ file, changes }));
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"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"}

package/dist/subscriber-wiring.d.ts

@@ -0,0 +1,4 @@
+import type { CheckIssue } from './integration-contracts';
+/** Check App-owned domain event handlers against the documented registration path. */
+export declare function checkDomainEventSubscribers(appRoot: string): CheckIssue[];
+//# sourceMappingURL=subscriber-wiring.d.ts.map

package/dist/subscriber-wiring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber-wiring.d.ts","sourceRoot":"","sources":["../src/subscriber-wiring.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAW1D,sFAAsF;AACtF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAyDzE"}

package/dist/subscriber-wiring.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkDomainEventSubscribers = checkDomainEventSubscribers;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+function sourceFiles(directory) {
+    if (!(0, node_fs_1.existsSync)(directory))
+        return [];
+    return (0, node_fs_1.readdirSync)(directory, { withFileTypes: true }).flatMap((entry) => {
+        const file = node_path_1.default.join(directory, entry.name);
+        if (entry.isDirectory())
+            return sourceFiles(file);
+        return entry.name.endsWith('.ts') && !entry.name.endsWith('.spec.ts') ? [file] : [];
+    });
+}
+/** Check App-owned domain event handlers against the documented registration path. */
+function checkDomainEventSubscribers(appRoot) {
+    const sourceRoot = node_path_1.default.join(appRoot, 'backend', 'src');
+    const moduleFile = node_path_1.default.join(sourceRoot, 'domain-events', 'domain-events.module.ts');
+    const moduleContent = (0, node_fs_1.existsSync)(moduleFile) ? (0, node_fs_1.readFileSync)(moduleFile, 'utf8') : '';
+    const issues = [];
+    for (const file of sourceFiles(sourceRoot)) {
+        const content = (0, node_fs_1.readFileSync)(file, 'utf8');
+        if (/registry\s*\.\s*on\s*\(/u.test(content) && file !== moduleFile) {
+            issues.push({
+                code: 'domain-event-direct-registration',
+                path: file,
+                message: 'calls registry.on(...) outside domain-events.module.ts; use registerDomainEventSubscribers()',
+            });
+        }
+        const rel = node_path_1.default.relative(sourceRoot, file);
+        const isHandler = rel.split(node_path_1.default.sep).includes('handlers') && rel.endsWith('.handler.ts');
+        if (!isHandler)
+            continue;
+        const decorated = content.includes('@DomainEventSubscriber');
+        if (!decorated && !content.includes('@domain-events-undecorated:')) {
+            issues.push({
+                code: 'domain-event-handler-undecorated',
+                path: file,
+                message: 'missing @DomainEventSubscriber(...) and no exemption marker',
+            });
+        }
+        if (!decorated)
+            continue;
+        const className = content.match(/export\s+class\s+([A-Za-z0-9_]+)/u)?.[1];
+        if (!className) {
+            issues.push({
+                code: 'domain-event-handler-class-missing',
+                path: file,
+                message: 'decorated handler has no exported class',
+            });
+            continue;
+        }
+        const base = className.replace(/DomainEventHandler$/u, 'Handler');
+        const variableName = base.charAt(0).toLowerCase() + base.slice(1);
+        if (!moduleContent.includes(className)) {
+            issues.push({
+                code: 'domain-event-handler-not-provided',
+                path: file,
+                message: `${className} is not referenced by domain-events.module.ts`,
+            });
+        }
+        if (!moduleContent.includes('registerDomainEventSubscribers') ||
+            !moduleContent.includes(variableName)) {
+            issues.push({
+                code: 'domain-event-handler-not-registered',
+                path: file,
+                message: `${variableName} is not passed to registerDomainEventSubscribers()`,
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=subscriber-wiring.js.map

package/dist/subscriber-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber-wiring.js","sourceRoot":"","sources":["../src/subscriber-wiring.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@haneinfo/app-tooling",
+  "version": "0.1.0",
+  "private": false,
+  "type": "commonjs",
+  "description": "Shared Haneinfo App checks and scaffold tooling",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "haneinfo-app": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@haneinfo/plugin-cli": "2.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}