@ytinnovation/harness-cli 0.0.0

package/README.md

@@ -0,0 +1,19 @@
+# @ytinnovation/harness-cli
+
+Harness Kit 的命令行入口，安装后提供 `harness` 命令。
+
+## 安装
+
+```bash
+npm install -g @ytinnovation/harness-cli
+```
+
+## 常用命令
+
+```bash
+harness version
+harness init --mode template-match --dry-run
+harness dashboard serve --port 4242
+```
+
+`harness dashboard serve` 会从依赖的 `@ytinnovation/harness-core` 包内读取 dashboard 静态资源，不需要用户额外构建前端。

package/dist/env.d.ts

@@ -0,0 +1,6 @@
+export interface ApplyHarnessCliEnvDefaultsOptions {
+    readonly env?: NodeJS.ProcessEnv;
+    readonly envPath?: string;
+}
+export declare function applyHarnessCliEnvDefaults(options?: ApplyHarnessCliEnvDefaultsOptions): void;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,iCAAsC,GAAG,IAAI,CAWhG"}

package/dist/env.js

@@ -0,0 +1,47 @@
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const DEFAULT_CLI_ENV_PATH = resolve(dirname(fileURLToPath(import.meta.url)), '../src/.env');
+export function applyHarnessCliEnvDefaults(options = {}) {
+    const env = options.env ?? process.env;
+    if (env.HARNESS_SERVICE_URL?.trim()) {
+        return;
+    }
+    const defaultServiceUrl = env.HARNESS_DEFAULT_SERVICE_URL?.trim() || readHarnessDefaultServiceUrl(options.envPath ?? DEFAULT_CLI_ENV_PATH);
+    if (defaultServiceUrl) {
+        env.HARNESS_SERVICE_URL = defaultServiceUrl;
+    }
+}
+function readHarnessDefaultServiceUrl(envPath) {
+    try {
+        return parseHarnessDefaultServiceUrl(readFileSync(envPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function parseHarnessDefaultServiceUrl(raw) {
+    for (const line of raw.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) {
+            continue;
+        }
+        const match = /^HARNESS_DEFAULT_SERVICE_URL\s*=\s*(.*)$/.exec(trimmed);
+        if (!match) {
+            continue;
+        }
+        return stripOptionalQuotes(match[1]?.trim() ?? '') || null;
+    }
+    return null;
+}
+function stripOptionalQuotes(value) {
+    if (value.length >= 2) {
+        const first = value[0];
+        const last = value[value.length - 1];
+        if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+            return value.slice(1, -1).trim();
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC,MAAM,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;AAE7F,MAAM,UAAU,0BAA0B,CAAC,UAA6C,EAAE;IACxF,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,IAAI,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,EAAE,CAAC;QACpC,OAAO;IACT,CAAC;IAED,MAAM,iBAAiB,GACrB,GAAG,CAAC,2BAA2B,EAAE,IAAI,EAAE,IAAI,4BAA4B,CAAC,OAAO,CAAC,OAAO,IAAI,oBAAoB,CAAC,CAAC;IACnH,IAAI,iBAAiB,EAAE,CAAC;QACtB,GAAG,CAAC,mBAAmB,GAAG,iBAAiB,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,SAAS,4BAA4B,CAAC,OAAe;IACnD,IAAI,CAAC;QACH,OAAO,6BAA6B,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,6BAA6B,CAAC,GAAW;IAChD,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,0CAA0C,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QACD,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACvE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/main.d.ts

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

package/dist/main.d.ts.map

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

package/dist/main.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import { createHarnessTelemetryEvent, createKernel, reportHarnessTelemetryEvents } from '@ytinnovation/harness-core';
+import { applyHarnessCliEnvDefaults } from './env.js';
+try {
+    applyHarnessCliEnvDefaults();
+    const kernel = createKernel();
+    kernel.router.register('version', () => {
+        console.log(kernel.version);
+        return 0;
+    });
+    const commandArgs = process.argv.slice(2);
+    const startedAt = Date.now();
+    const result = await kernel.router.dispatch(commandArgs);
+    const durationMs = Date.now() - startedAt;
+    if (result.message) {
+        if (result.exitCode === 0) {
+            console.log(result.message);
+        }
+        else {
+            console.error(result.message);
+        }
+    }
+    reportHarnessTelemetryEvents([
+        createHarnessTelemetryEvent(result.exitCode === 0 ? 'cli.command.completed' : 'cli.command.failed', {
+            source: 'cli',
+            command: commandArgs.join(' ').trim() || '__root__',
+            success: result.exitCode === 0,
+            duration_ms: durationMs,
+            error_code: result.exitCode === 0 ? undefined : 'CLI_COMMAND_FAILED',
+            payload: {
+                argv: commandArgs,
+            },
+        }),
+    ]);
+    process.exitCode = result.exitCode;
+}
+catch (err) {
+    reportHarnessTelemetryEvents([
+        createHarnessTelemetryEvent('cli.command.failed', {
+            source: 'cli',
+            command: process.argv.slice(2).join(' ').trim() || '__root__',
+            success: false,
+            error_code: 'CLI_FATAL_ERROR',
+            payload: {
+                message: err instanceof Error ? err.message : String(err),
+            },
+        }),
+    ]);
+    console.error('致命错误：', err instanceof Error ? err.message : err);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,2BAA2B,EAAE,YAAY,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AACrH,OAAO,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAEtD,IAAI,CAAC;IACH,0BAA0B,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACrC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAC1C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,4BAA4B,CAAC;QAC3B,2BAA2B,CAAC,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,oBAAoB,EAAE;YAClG,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,UAAU;YACnD,OAAO,EAAE,MAAM,CAAC,QAAQ,KAAK,CAAC;YAC9B,WAAW,EAAE,UAAU;YACvB,UAAU,EAAE,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,oBAAoB;YACpE,OAAO,EAAE;gBACP,IAAI,EAAE,WAAW;aAClB;SACF,CAAC;KACH,CAAC,CAAC;IACH,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AACrC,CAAC;AAAC,OAAO,GAAG,EAAE,CAAC;IACb,4BAA4B,CAAC;QAC3B,2BAA2B,CAAC,oBAAoB,EAAE;YAChD,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,UAAU;YAC7D,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,iBAAiB;YAC7B,OAAO,EAAE;gBACP,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D;SACF,CAAC;KACH,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@ytinnovation/harness-cli",
+  "version": "0.0.0",
+  "type": "module",
+  "description": "Command line interface for Harness Kit.",
+  "bin": {
+    "harness": "./dist/main.js"
+  },
+  "dependencies": {
+    "@ytinnovation/harness-core": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "~5.7.2"
+  }
+}