@xemahq/xema 0.1.1

package/dist/dev/forked-worker.d.ts

@@ -0,0 +1,14 @@
+export interface ForkedWorkerSpawnOptions {
+    readonly name: string;
+    readonly port: number;
+    readonly siblingAppDir: string;
+    readonly readinessTimeoutMs: number;
+}
+export interface ForkedWorkerHandle {
+    readonly name: string;
+    readonly url: string;
+    readonly pid: number;
+    close(): Promise<void>;
+}
+export declare function spawnForkedWorker(opts: ForkedWorkerSpawnOptions, baseDir: string): Promise<ForkedWorkerHandle>;
+//# sourceMappingURL=forked-worker.d.ts.map

package/dist/dev/forked-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forked-worker.d.ts","sourceRoot":"","sources":["../../src/dev/forked-worker.ts"],"names":[],"mappings":"AAyCA,MAAM,WAAW,wBAAwB;IAEvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAMtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAO/B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAKrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAQD,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,wBAAwB,EAC9B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC,CAuC7B"}

package/dist/dev/forked-worker.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spawnForkedWorker = spawnForkedWorker;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const READINESS_PROBE_INTERVAL_MS = 250;
+const SHUTDOWN_GRACE_MS = 5_000;
+async function spawnForkedWorker(opts, baseDir) {
+    const serviceRoot = (0, node_path_1.resolve)(baseDir, opts.siblingAppDir);
+    const mainModulePath = (0, node_path_1.resolve)(serviceRoot, 'dist', 'main.js');
+    if (!(0, node_fs_1.existsSync)(mainModulePath)) {
+        throw new Error(`${opts.name} dist not found at ${mainModulePath}. ` +
+            `Run \`pnpm --filter ${opts.name} build\` first, or use \`pnpm refresh\`.`);
+    }
+    const childEnv = {
+        ...process.env,
+        PORT: String(opts.port),
+    };
+    const child = (0, node_child_process_1.fork)(mainModulePath, [], {
+        cwd: serviceRoot,
+        env: childEnv,
+    });
+    return waitForReady(child, opts);
+}
+function waitForReady(child, opts) {
+    return new Promise((resolve, reject) => {
+        const pid = child.pid;
+        if (pid === undefined) {
+            reject(new Error(`${opts.name}: child_process.fork() returned a process with no PID.`));
+            return;
+        }
+        let settled = false;
+        const settle = (fn) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            fn();
+        };
+        const onExit = (code, signal) => {
+            settle(() => {
+                reject(new Error(`${opts.name}: child exited before /health/ready (code=${String(code)}, signal=${String(signal)}).`));
+            });
+        };
+        const onError = (err) => {
+            settle(() => {
+                reject(new Error(`${opts.name}: child_process.fork() error: ${err.message}`));
+            });
+        };
+        child.once('exit', onExit);
+        child.once('error', onError);
+        const deadline = Date.now() + opts.readinessTimeoutMs;
+        const probe = async () => {
+            while (!settled) {
+                if (Date.now() > deadline) {
+                    settle(() => {
+                        void killChild(child).then(() => {
+                            reject(new Error(`${opts.name}: /health/ready did not return 200 within ${String(opts.readinessTimeoutMs)}ms.`));
+                        });
+                    });
+                    return;
+                }
+                if (await probeReady(opts.port)) {
+                    settle(() => {
+                        child.off('exit', onExit);
+                        child.off('error', onError);
+                        resolve({
+                            name: opts.name,
+                            url: `http://localhost:${String(opts.port)}`,
+                            pid,
+                            close: () => killChild(child),
+                        });
+                    });
+                    return;
+                }
+                await sleep(READINESS_PROBE_INTERVAL_MS);
+            }
+        };
+        void probe();
+    });
+}
+function probeReady(port) {
+    return new Promise((resolve) => {
+        const http = require('node:http');
+        const req = http.request({
+            host: '127.0.0.1',
+            port,
+            path: '/health/ready',
+            method: 'GET',
+            timeout: READINESS_PROBE_INTERVAL_MS,
+        }, (res) => {
+            res.resume();
+            resolve(res.statusCode === 200);
+        });
+        req.on('error', () => { resolve(false); });
+        req.on('timeout', () => {
+            req.destroy();
+            resolve(false);
+        });
+        req.end();
+    });
+}
+function killChild(child) {
+    return new Promise((resolve) => {
+        if (child.exitCode !== null || child.signalCode !== null) {
+            resolve();
+            return;
+        }
+        const killTimer = setTimeout(() => {
+            if (child.exitCode === null && child.signalCode === null) {
+                child.kill('SIGKILL');
+            }
+        }, SHUTDOWN_GRACE_MS);
+        const onExit = () => {
+            clearTimeout(killTimer);
+            resolve();
+        };
+        child.once('exit', onExit);
+        child.kill('SIGTERM');
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => { setTimeout(resolve, ms); });
+}
+//# sourceMappingURL=forked-worker.js.map

package/dist/dev/forked-worker.js.map

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

package/dist/dev/infra-preflight.d.ts

@@ -0,0 +1,31 @@
+export declare enum InfraDependencyKind {
+    Postgres = "postgres",
+    Redis = "redis",
+    EventHub = "event-hub-api"
+}
+export interface InfraDependency {
+    readonly kind: InfraDependencyKind;
+    readonly host: string;
+    readonly port: number;
+    readonly composeServiceName: string;
+    readonly dependents: ReadonlyArray<string>;
+}
+export declare const DEFAULT_INFRA_DEPENDENCIES: ReadonlyArray<InfraDependency>;
+export interface InfraProbeResult {
+    readonly dependency: InfraDependency;
+    readonly reachable: boolean;
+    readonly errorCode?: string;
+}
+export interface InfraPreflightReport {
+    readonly results: ReadonlyArray<InfraProbeResult>;
+    readonly missing: ReadonlyArray<InfraProbeResult>;
+    readonly allReachable: boolean;
+}
+export type InfraProbeFn = (host: string, port: number, timeoutMs: number) => Promise<{
+    reachable: boolean;
+    errorCode?: string;
+}>;
+export declare function runInfraPreflight(deps?: ReadonlyArray<InfraDependency>, probe?: InfraProbeFn, timeoutMs?: number): Promise<InfraPreflightReport>;
+export declare function formatPreflightFailure(report: InfraPreflightReport): string;
+export declare function labelFor(kind: InfraDependencyKind): string;
+//# sourceMappingURL=infra-preflight.d.ts.map

package/dist/dev/infra-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infra-preflight.d.ts","sourceRoot":"","sources":["../../src/dev/infra-preflight.ts"],"names":[],"mappings":"AA2BA,oBAAY,mBAAmB;IAC7B,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,QAAQ,kBAAkB;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAOtB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IAMpC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5C;AAOD,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,eAAe,CAwCrE,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAM5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAOD,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,KACd,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAIzD,wBAAsB,iBAAiB,CACrC,IAAI,GAAE,aAAa,CAAC,eAAe,CAA8B,EACjE,KAAK,GAAE,YAAuB,EAC9B,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,oBAAoB,CAAC,CAqB/B;AAyDD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,GAC3B,MAAM,CAwCR;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,CAS1D"}

package/dist/dev/infra-preflight.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_INFRA_DEPENDENCIES = exports.InfraDependencyKind = void 0;
+exports.runInfraPreflight = runInfraPreflight;
+exports.formatPreflightFailure = formatPreflightFailure;
+exports.labelFor = labelFor;
+const node_net_1 = require("node:net");
+var InfraDependencyKind;
+(function (InfraDependencyKind) {
+    InfraDependencyKind["Postgres"] = "postgres";
+    InfraDependencyKind["Redis"] = "redis";
+    InfraDependencyKind["EventHub"] = "event-hub-api";
+})(InfraDependencyKind || (exports.InfraDependencyKind = InfraDependencyKind = {}));
+exports.DEFAULT_INFRA_DEPENDENCIES = [
+    {
+        kind: InfraDependencyKind.Postgres,
+        host: '127.0.0.1',
+        port: 5432,
+        composeServiceName: 'postgres',
+        dependents: [
+            'authorization-api',
+            'llm-registry-api',
+            'project-registry-api',
+            'skill-registry-api',
+            'object-registry-api',
+        ],
+    },
+    {
+        kind: InfraDependencyKind.Redis,
+        host: '127.0.0.1',
+        port: 6379,
+        composeServiceName: 'redis',
+        dependents: [
+            'workspace-proxy',
+            'public-gateway-api',
+            'mcp-gateway-api',
+        ],
+    },
+    {
+        kind: InfraDependencyKind.EventHub,
+        host: '127.0.0.1',
+        port: 3128,
+        composeServiceName: 'event-hub',
+        dependents: [
+            'authorization-api',
+            'llm-registry-api',
+            'memory-api',
+            'project-registry-api',
+        ],
+    },
+];
+const DEFAULT_TIMEOUT_MS = 1000;
+async function runInfraPreflight(deps = exports.DEFAULT_INFRA_DEPENDENCIES, probe = tcpProbe, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    const results = [];
+    for (const dep of deps) {
+        const outcome = await probe(dep.host, dep.port, timeoutMs);
+        const result = outcome.reachable
+            ? { dependency: dep, reachable: true }
+            : {
+                dependency: dep,
+                reachable: false,
+                ...(outcome.errorCode !== undefined
+                    ? { errorCode: outcome.errorCode }
+                    : {}),
+            };
+        results.push(result);
+    }
+    const missing = results.filter((r) => !r.reachable);
+    return {
+        results,
+        missing,
+        allReachable: missing.length === 0,
+    };
+}
+function tcpProbe(host, port, timeoutMs) {
+    return new Promise((resolve) => {
+        const socket = (0, node_net_1.createConnection)({ host, port });
+        let settled = false;
+        const settle = (outcome) => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            socket.destroy();
+            resolve(outcome);
+        };
+        const watchdog = setTimeout(() => {
+            settle({ reachable: false, errorCode: 'timeout' });
+        }, timeoutMs);
+        watchdog.unref();
+        socket.once('connect', () => {
+            clearTimeout(watchdog);
+            settle({ reachable: true });
+        });
+        socket.once('error', (err) => {
+            clearTimeout(watchdog);
+            settle({ reachable: false, errorCode: err.code ?? 'unknown' });
+        });
+    });
+}
+function formatPreflightFailure(report) {
+    if (report.allReachable) {
+        return '';
+    }
+    const lines = [];
+    lines.push('`xema dev` requires the following infra services running locally:');
+    for (const r of report.missing) {
+        const dep = r.dependency;
+        const dependents = dep.dependents.join(', ');
+        const why = r.errorCode !== undefined ? ` [${r.errorCode}]` : '';
+        lines.push(`  - ${labelFor(dep.kind)} (${dep.host}:${dep.port})${why} — needed by: ${dependents}`);
+    }
+    const composeNames = report.missing
+        .map((r) => r.dependency.composeServiceName)
+        .join(' ');
+    lines.push('');
+    lines.push('Quickest path:');
+    lines.push(`  cd test-suite && docker compose up -d ${composeNames}`);
+    lines.push('');
+    lines.push('Or run `xema doctor --infra` to see the full status table.');
+    lines.push('');
+    lines.push('Note: `xema dev` wires 29/29 services into its candidate list (mix');
+    lines.push('of in-process + forked-worker) — see Phase J in the plan-of-record.');
+    lines.push('Individual services that fail to boot are routed through skip-mode');
+    lines.push('(see `dev-orchestrator.ts` header for the forked-worker root cause).');
+    return lines.join('\n');
+}
+function labelFor(kind) {
+    switch (kind) {
+        case InfraDependencyKind.Postgres:
+            return 'Postgres';
+        case InfraDependencyKind.Redis:
+            return 'Redis';
+        case InfraDependencyKind.EventHub:
+            return 'event-hub-api';
+    }
+}
+//# sourceMappingURL=infra-preflight.js.map

package/dist/dev/infra-preflight.js.map

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

package/dist/lib/command-registry.d.ts

@@ -0,0 +1,5 @@
+import type { Command } from 'commander';
+export type RegisterCommand = (program: Command) => void;
+export declare const XEMA_CLI_COMMAND_NAMES: readonly ["dev", "serve", "biome", "run", "shell", "objects", "doctor"];
+export type XemaCliCommandName = (typeof XEMA_CLI_COMMAND_NAMES)[number];
+//# sourceMappingURL=command-registry.d.ts.map

package/dist/lib/command-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.d.ts","sourceRoot":"","sources":["../../src/lib/command-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASzC,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAYzD,eAAO,MAAM,sBAAsB,yEAQzB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/lib/command-registry.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XEMA_CLI_COMMAND_NAMES = void 0;
+exports.XEMA_CLI_COMMAND_NAMES = [
+    'dev',
+    'serve',
+    'biome',
+    'run',
+    'shell',
+    'objects',
+    'doctor',
+];
+//# sourceMappingURL=command-registry.js.map

package/dist/lib/command-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-registry.js","sourceRoot":"","sources":["../../src/lib/command-registry.ts"],"names":[],"mappings":";;;AAqBa,QAAA,sBAAsB,GAAG;IACpC,KAAK;IACL,OAAO;IACP,OAAO;IACP,KAAK;IACL,OAAO;IACP,SAAS;IACT,QAAQ;CACA,CAAC"}

package/dist/lib/exit-codes.d.ts

@@ -0,0 +1,10 @@
+export declare enum XemaCliExitCode {
+    Ok = 0,
+    GenericError = 1,
+    NotImplemented = 2,
+    MissingDependency = 3,
+    ConfigurationError = 4,
+    NotFound = 5
+}
+export declare function exitWith(code: XemaCliExitCode, message?: string): never;
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/lib/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/lib/exit-codes.ts"],"names":[],"mappings":"AAWA,oBAAY,eAAe;IACzB,EAAE,IAAI;IACN,YAAY,IAAI;IAChB,cAAc,IAAI;IAClB,iBAAiB,IAAI;IACrB,kBAAkB,IAAI;IACtB,QAAQ,IAAI;CACb;AAOD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CASvE"}

package/dist/lib/exit-codes.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XemaCliExitCode = void 0;
+exports.exitWith = exitWith;
+var XemaCliExitCode;
+(function (XemaCliExitCode) {
+    XemaCliExitCode[XemaCliExitCode["Ok"] = 0] = "Ok";
+    XemaCliExitCode[XemaCliExitCode["GenericError"] = 1] = "GenericError";
+    XemaCliExitCode[XemaCliExitCode["NotImplemented"] = 2] = "NotImplemented";
+    XemaCliExitCode[XemaCliExitCode["MissingDependency"] = 3] = "MissingDependency";
+    XemaCliExitCode[XemaCliExitCode["ConfigurationError"] = 4] = "ConfigurationError";
+    XemaCliExitCode[XemaCliExitCode["NotFound"] = 5] = "NotFound";
+})(XemaCliExitCode || (exports.XemaCliExitCode = XemaCliExitCode = {}));
+function exitWith(code, message) {
+    if (message !== undefined && message.length > 0) {
+        if (code === XemaCliExitCode.Ok) {
+            console.log(message);
+        }
+        else {
+            console.error(message);
+        }
+    }
+    process.exit(code);
+}
+//# sourceMappingURL=exit-codes.js.map

package/dist/lib/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/lib/exit-codes.ts"],"names":[],"mappings":";;;AAyBA,4BASC;AAvBD,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,iDAAM,CAAA;IACN,qEAAgB,CAAA;IAChB,yEAAkB,CAAA;IAClB,+EAAqB,CAAA;IACrB,iFAAsB,CAAA;IACtB,6DAAY,CAAA;AACd,CAAC,EAPW,eAAe,+BAAf,eAAe,QAO1B;AAOD,SAAgB,QAAQ,CAAC,IAAqB,EAAE,OAAgB;IAC9D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,KAAK,eAAe,CAAC,EAAE,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@xemahq/xema",
+  "version": "0.1.1",
+  "description": "Xema OS global CLI (plan v4.3 §6 Phase J). Single binary day-0 onboarding: `npm i -g @xemahq/xema && xema dev` boots the whole stack; `xema biome scaffold` / `install` / `publish` / `lint` author and ship biomes; `xema run <capability>` invokes through the local capability-router. Multi-platform: works without pnpm or any monorepo clone.",
+  "type": "commonjs",
+  "main": "dist/cli.js",
+  "bin": {
+    "xema": "./dist/cli.js"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "dependencies": {
+    "@nestjs/common": "11.1.13",
+    "@nestjs/core": "11.1.13",
+    "@nestjs/platform-express": "11.1.13",
+    "@xemahq/kernel-state-runtime": "^0.1.0",
+    "@xemahq/service-registry-nest": "^0.1.0",
+    "commander": "^12.1.0",
+    "reflect-metadata": "0.2.2",
+    "rxjs": "7.8.2"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.4",
+    "@types/jest": "^30.0.0",
+    "@types/node": "25.2.3",
+    "@yao-pkg/pkg": "^6.6.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "jest": "^30.3.0",
+    "prettier": "3.6.2",
+    "ts-jest": "^29.4.9",
+    "ts-node": "^10.9.2",
+    "typescript": "5.9.3",
+    "typescript-eslint": "^8.56.1"
+  },
+  "pkg": {
+    "scripts": [
+      "dist/**/*.js"
+    ],
+    "assets": [
+      "dist/**/*.json"
+    ],
+    "targets": [
+      "node20-macos-arm64",
+      "node20-macos-x64",
+      "node20-linux-arm64",
+      "node20-linux-x64",
+      "node20-win-x64"
+    ],
+    "outputPath": "dist/bin"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.json && node ./scripts/post-build.cjs",
+    "build:binary": "node ./scripts/build-binaries.cjs",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "start": "node ./dist/cli.js",
+    "lint": "eslint \"src/**/*.ts\"",
+    "lint:fix": "eslint \"src/**/*.ts\" --fix",
+    "test": "jest --config jest.config.cjs",
+    "typecheck": "tsc --noEmit"
+  }
+}