homegraph 1.1.3 → 1.2.0

package/README.md

@@ -134,33 +134,57 @@ homegraph uninit             # 删除当前项目的 .homegraph/ 索引
 ## 常用命令
 
 ```bash
-homegraph install            # 配置 AI 助手
-homegraph init -i [path]     # 初始化并索引项目
-homegraph index [path]       # 全量索引（--force 强制重建）
-homegraph sync [path]        # 增量同步变更
-homegraph status [path]      # 查看索引状态
-homegraph query <关键词>      # 搜索符号
-homegraph callers <符号>      # 谁调用了它
-homegraph callees <符号>      # 它调用了谁
-homegraph impact <符号>       # 修改该符号的影响范围
-homegraph serve --mcp         # 启动 MCP 服务（一般由 Agent 自动拉起）
+homegraph install              # 配置 AI 助手
+homegraph init -i [path]       # 初始化并索引项目
+homegraph index [path]         # 全量索引（--force 强制重建）
+homegraph sync [path]          # 增量同步变更
+homegraph status [path]        # 查看索引状态
+homegraph query <关键词>        # 搜索符号
+homegraph explore <查询>        # 探索区域（与 MCP homegraph_explore 相同输出）
+homegraph node <符号或文件>      # 读取符号/文件（与 MCP homegraph_node 相同输出）
+homegraph files                # 已索引文件树
+homegraph callers <符号>        # 谁调用了它
+homegraph callees <符号>        # 它调用了谁
+homegraph impact <符号>         # 修改该符号的影响范围
+homegraph affected [files...]  # 根据变更文件查找受影响的测试（支持 --stdin）
+homegraph spec mine            # 从 Git 历史挖掘规格知识图谱（Commit4Spec）
+homegraph spec match <文本>     # 搜索相似历史规格
+homegraph spec evolve install  # 安装 post-commit 钩子，提交后自动演化规格
+homegraph serve --mcp           # 启动 MCP 服务（一般由 Agent 自动拉起）
 ```
 
+`explore` / `node` 等命令与同名 MCP 工具共享同一套输出，适合没有 MCP 的子 Agent 或脚本直接调用。
+
 ---
 
 ## MCP 工具
 
-Agent 侧工具名前缀为 `homegraph_`：
+Agent 侧工具名前缀为 `homegraph_`。
+
+**暴露规则：** 默认注册全部工具。索引文件数 **少于 500** 的小项目会自动收缩为三个核心工具（`explore` / `search` / `node`）。可通过环境变量 `HOMEGRAPH_MCP_TOOLS`（逗号分隔短名，如 `explore,node`）自定义暴露列表。
+
+**跨项目查询：** 所有工具均支持可选参数 `projectPath`（绝对路径），用于在 monorepo 中查询子项目，或当 MCP 服务器根目录没有索引时指定目标项目。
 
 | 工具 | 用途 |
 |------|------|
-| `homegraph_explore` | 主要工具：一次返回相关符号源码与调用关系 |
-| `homegraph_search` | 按名称快速定位符号 |
+| `homegraph_explore` | **主工具**：一次调用返回相关符号的完整源码、调用路径与影响范围；支持自然语言问题或符号/文件名列表 |
+| `homegraph_search` | 按名称快速搜索符号（仅返回位置，不含源码） |
+| `homegraph_node` | 读取单个符号或整个文件的源码（带行号）及调用关系；可替代 Read 读文件 |
 | `homegraph_callers` / `homegraph_callees` | 查看调用方 / 被调用方 |
-| `homegraph_impact` | 变更影响分析 |
-| `homegraph_node` | 单个符号的完整源码与上下文 |
-| `homegraph_files` | 已索引的文件结构 |
-| `homegraph_status` | 索引健康状态 |
+| `homegraph_impact` | 变更影响分析（重构前使用） |
+| `homegraph_files` | 已索引的文件树（支持 glob 过滤、按语言分组） |
+| `homegraph_status` | 索引健康状态（调试用） |
+| `homegraph_spec_match` | 将新需求描述与 Commit4Spec 规格知识图谱做全文匹配，返回相似历史规格及关联提交与代码片段 |
+
+### Commit4Spec（规格知识图谱）
+
+`homegraph_spec_match` 与 `homegraph spec` 子命令基于 Commit4Spec：从 Git 历史中的 `.spec` 目录反向挖掘规格、提交与代码片段，存入 `.homegraph/commit4spec/commit4spec.db`。典型流程：
+
+```bash
+homegraph spec mine              # 首次挖掘
+homegraph spec match "用户登录"   # CLI 侧搜索（与 MCP spec_match 相同能力）
+homegraph spec evolve install    # 可选：每次 commit 后自动更新规格图谱
+```
 
 ---
 
@@ -168,7 +192,7 @@ Agent 侧工具名前缀为 `homegraph_`：
 
 继承上游多语言 tree-sitter 解析，包括但不限于：
 
-TypeScript / JavaScript、Python、Go、Rust、Java、C#、PHP、Ruby、C / C++、Objective-C、Swift、Kotlin、Scala、Dart、Lua、Luau、Svelte、Vue、Liquid、Pascal / Delphi 等。
+TypeScript / JavaScript、Python、Go、Rust、Java、C#、PHP、Ruby、C / C++、Objective-C、Swift、Kotlin、Scala、Dart、Lua、Luau、R、Svelte、Vue、Astro、Liquid、Razor、Pascal / Delphi 等。
 
 **HomeGraph 新增：**
 
@@ -235,6 +259,7 @@ Cursor 等项目级配置写入 `./.cursor/mcp.json`，格式相同。推荐使
 
 - Node.js **22.5+**（推荐 22 LTS 或 24；使用 Node 内置 `node:sqlite`）
 - 首次索引时会对项目源码做 AST 解析，大型仓库首次 `init -i` 可能需要数分钟
+- WSL2 下若项目位于 Windows 盘符（`/mnt/c` 等）且 MCP 连接不稳定，可设置 `HOMEGRAPH_NO_DAEMON=1` 跳过共享后台服务，每个会话独立运行
 
 ---
 

package/dist/arkts/ohos-api-index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Build a standalone OHOS API symbol database from an SDK `ets` tree.
+ */
+import type { IndexProgress, IndexResult } from '../extraction';
+export interface OhosApiIndexOptions {
+    sdkHome: string;
+    version: string;
+    outputPath?: string;
+    onProgress?: (progress: IndexProgress) => void;
+}
+/**
+ * Index OpenHarmony (and optional HMS) SDK API declarations into a SQLite db.
+ */
+export declare function indexOhosApiDb(options: OhosApiIndexOptions): Promise<IndexResult>;
+//# sourceMappingURL=ohos-api-index.d.ts.map

package/dist/arkts/ohos-api-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohos-api-index.d.ts","sourceRoot":"","sources":["../../src/arkts/ohos-api-index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMhE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;CAChD;AAkED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAoFvF"}

package/dist/arkts/ohos-api-index.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Build a standalone OHOS API symbol database from an SDK `ets` tree.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexOhosApiDb = indexOhosApiDb;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const db_1 = require("../db");
+const queries_1 = require("../db/queries");
+const context_1 = require("../extraction/context");
+const arkts_1 = require("../extraction/languages/arkts");
+const extraction_version_1 = require("../extraction/extraction-version");
+const version_1 = require("../mcp/version");
+const ohos_sdk_input_1 = require("./ohos-sdk-input");
+function scanFirstArkTsTriggerFile(etsRoot) {
+    let found = null;
+    function walk(dir) {
+        if (found)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === 'node_modules' || entry.name === '.git')
+                    continue;
+                walk(full);
+            }
+            else if (entry.isFile()) {
+                const lower = entry.name.toLowerCase();
+                if (lower.endsWith('.ets') ||
+                    lower.endsWith('.d.ts') ||
+                    lower.endsWith('.d.ets') ||
+                    (lower.endsWith('.ts') && !lower.endsWith('.d.ts'))) {
+                    found = path.relative(etsRoot, full).replace(/\\/g, '/');
+                    return;
+                }
+            }
+        }
+    }
+    walk(etsRoot);
+    return found;
+}
+function countArkTsSources(etsRoot) {
+    let count = 0;
+    function walk(dir) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (entry.name === 'node_modules' || entry.name === '.git')
+                    continue;
+                walk(full);
+            }
+            else if (entry.isFile()) {
+                const lower = entry.name.toLowerCase();
+                if (lower.endsWith('.ets') ||
+                    lower.endsWith('.d.ts') ||
+                    lower.endsWith('.d.ets') ||
+                    (lower.endsWith('.ts') && !lower.endsWith('.d.ts'))) {
+                    count++;
+                }
+            }
+        }
+    }
+    walk(etsRoot);
+    return count;
+}
+/**
+ * Index OpenHarmony (and optional HMS) SDK API declarations into a SQLite db.
+ */
+async function indexOhosApiDb(options) {
+    const sdkHome = path.resolve(options.sdkHome);
+    if (!(0, ohos_sdk_input_1.hasOpenHarmonyEts)(sdkHome)) {
+        throw new Error(`SDK home is missing openharmony/ets: ${sdkHome}`);
+    }
+    const etsRoots = (0, ohos_sdk_input_1.listOhosApiEtsRoots)(sdkHome);
+    if (etsRoots.length === 0) {
+        throw new Error(`No API ets roots found under ${sdkHome}`);
+    }
+    const outputPath = path.resolve(options.outputPath ?? path.join(process.cwd(), (0, ohos_sdk_input_1.ohosApiDbFilename)(options.version)));
+    if (fs.existsSync(outputPath)) {
+        fs.unlinkSync(outputPath);
+    }
+    const startTime = Date.now();
+    const errors = [];
+    let filesIndexed = 0;
+    const db = db_1.DatabaseConnection.initialize(outputPath);
+    const queries = new queries_1.QueryBuilder(db.getDb());
+    try {
+        for (const etsRoot of etsRoots) {
+            const trigger = scanFirstArkTsTriggerFile(etsRoot);
+            if (!trigger) {
+                errors.push({
+                    message: `No ArkTS sources under ${etsRoot}`,
+                    severity: 'warning',
+                });
+                continue;
+            }
+            const total = countArkTsSources(etsRoot);
+            options.onProgress?.({
+                phase: 'arkts-batch',
+                current: 0,
+                total,
+                currentFile: etsRoot,
+                subphase: 'scene',
+            });
+            (0, arkts_1.resetArkTSBatch)();
+            (0, context_1.resetExtractionContext)();
+            (0, context_1.bindExtractionContext)(etsRoot, queries);
+            await (0, arkts_1.primeArkTSBatch)(etsRoot, queries, trigger);
+            filesIndexed += total;
+            options.onProgress?.({
+                phase: 'arkts-batch',
+                current: total,
+                total,
+                currentFile: etsRoot,
+                subphase: 'persist',
+            });
+        }
+        const counts = queries.getNodeAndEdgeCount();
+        queries.setMetadata('ohos_api_version', options.version);
+        queries.setMetadata('ohos_api_sdk_home', sdkHome);
+        queries.setMetadata('ohos_api_db_kind', 'homegraph-ohos-api-db');
+        queries.setMetadata('indexed_with_version', version_1.HomeGraphPackageVersion);
+        queries.setMetadata('indexed_with_extraction_version', String(extraction_version_1.EXTRACTION_VERSION));
+        db.runMaintenance();
+        return {
+            success: errors.every((e) => e.severity !== 'error'),
+            filesIndexed,
+            filesSkipped: 0,
+            filesErrored: errors.filter((e) => e.severity === 'error').length,
+            nodesCreated: counts.nodes,
+            edgesCreated: counts.edges,
+            errors,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    finally {
+        (0, arkts_1.resetArkTSBatch)();
+        (0, context_1.resetExtractionContext)();
+        db.close();
+    }
+}
+//# sourceMappingURL=ohos-api-index.js.map

package/dist/arkts/ohos-api-index.js.map

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

package/dist/arkts/ohos-sdk-input.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Resolve HarmonyOS command-line-tools archives/directories and API db versions.
+ */
+export declare class OhosSdkInputError extends Error {
+    constructor(message: string);
+}
+/** Parse `6.1.1.290` or `commandline-tools-linux-x64-6.1.1.290.zip` → `6.1.1`. */
+export declare function parseOhosToolsVersionFromName(name: string): string | null;
+export declare function isArchivePath(inputPath: string): boolean;
+/**
+ * Locate `sdk/default` that contains `openharmony/ets` under an extracted tree.
+ */
+export declare function findOhosSdkHome(searchRoot: string): string | null;
+export declare function hasOpenHarmonyEts(sdkHome: string): boolean;
+export declare function listOhosApiEtsRoots(sdkHome: string): string[];
+export interface ResolvedOhosSdkInput {
+    sdkHome: string;
+    version: string;
+    sourcePath: string;
+    /** Present when the input archive was extracted to a temp directory. */
+    cleanup?: () => void;
+}
+export interface ResolveOhosSdkInputOptions {
+    inputPath: string;
+    /** When set, overrides any version parsed from the path name. */
+    versionOverride?: string;
+}
+/**
+ * Resolve a command-line-tools archive or directory to an SDK home + API db version.
+ */
+export declare function resolveOhosSdkInput(options: ResolveOhosSdkInputOptions): ResolvedOhosSdkInput;
+/** Default filename for a versioned OHOS API db. */
+export declare function ohosApiDbFilename(version: string): string;
+/** Target path under ~/.homegraph/api/ for a versioned db. */
+export declare function ohosApiDbInstallPath(version: string): string;
+//# sourceMappingURL=ohos-sdk-input.d.ts.map

package/dist/arkts/ohos-sdk-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohos-sdk-input.d.ts","sourceRoot":"","sources":["../../src/arkts/ohos-sdk-input.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAI5B;AAED,kFAAkF;AAClF,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKzE;AAWD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuCjE;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAW7D;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,oBAAoB,CAgD7F;AA8BD,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/arkts/ohos-sdk-input.js

@@ -0,0 +1,214 @@
+"use strict";
+/**
+ * Resolve HarmonyOS command-line-tools archives/directories and API db versions.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OhosSdkInputError = void 0;
+exports.parseOhosToolsVersionFromName = parseOhosToolsVersionFromName;
+exports.isArchivePath = isArchivePath;
+exports.findOhosSdkHome = findOhosSdkHome;
+exports.hasOpenHarmonyEts = hasOpenHarmonyEts;
+exports.listOhosApiEtsRoots = listOhosApiEtsRoots;
+exports.resolveOhosSdkInput = resolveOhosSdkInput;
+exports.ohosApiDbFilename = ohosApiDbFilename;
+exports.ohosApiDbInstallPath = ohosApiDbInstallPath;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const ARCHIVE_EXTENSIONS = ['.tar.gz', '.tgz', '.zip', '.tar'];
+class OhosSdkInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OhosSdkInputError';
+    }
+}
+exports.OhosSdkInputError = OhosSdkInputError;
+/** Parse `6.1.1.290` or `commandline-tools-linux-x64-6.1.1.290.zip` → `6.1.1`. */
+function parseOhosToolsVersionFromName(name) {
+    const base = path.basename(name);
+    const withoutExt = stripArchiveExtension(base);
+    const match = withoutExt.match(/(\d+\.\d+\.\d+)(?:\.\d+)?$/);
+    return match?.[1] ?? null;
+}
+function stripArchiveExtension(filename) {
+    for (const ext of ARCHIVE_EXTENSIONS) {
+        if (filename.toLowerCase().endsWith(ext)) {
+            return filename.slice(0, -ext.length);
+        }
+    }
+    return filename;
+}
+function isArchivePath(inputPath) {
+    const lower = inputPath.toLowerCase();
+    return ARCHIVE_EXTENSIONS.some((ext) => lower.endsWith(ext));
+}
+/**
+ * Locate `sdk/default` that contains `openharmony/ets` under an extracted tree.
+ */
+function findOhosSdkHome(searchRoot) {
+    const resolved = path.resolve(searchRoot);
+    const direct = [
+        path.join(resolved, 'sdk', 'default'),
+        path.join(resolved, 'command-line-tools', 'sdk', 'default'),
+    ];
+    for (const candidate of direct) {
+        if (hasOpenHarmonyEts(candidate)) {
+            return candidate;
+        }
+    }
+    const queue = [{ dir: resolved, depth: 0 }];
+    const seen = new Set();
+    while (queue.length > 0) {
+        const { dir, depth } = queue.shift();
+        if (seen.has(dir) || depth > 5)
+            continue;
+        seen.add(dir);
+        const sdkDefault = path.join(dir, 'sdk', 'default');
+        if (hasOpenHarmonyEts(sdkDefault)) {
+            return sdkDefault;
+        }
+        if (depth >= 5)
+            continue;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name === 'node_modules' || entry.name === '.git')
+                continue;
+            queue.push({ dir: path.join(dir, entry.name), depth: depth + 1 });
+        }
+    }
+    return null;
+}
+function hasOpenHarmonyEts(sdkHome) {
+    return fs.existsSync(path.join(sdkHome, 'openharmony', 'ets'));
+}
+function listOhosApiEtsRoots(sdkHome) {
+    const roots = [];
+    const openharmony = path.join(sdkHome, 'openharmony', 'ets');
+    if (fs.existsSync(openharmony)) {
+        roots.push(openharmony);
+    }
+    const hms = path.join(sdkHome, 'hms', 'ets');
+    if (fs.existsSync(hms)) {
+        roots.push(hms);
+    }
+    return roots;
+}
+/**
+ * Resolve a command-line-tools archive or directory to an SDK home + API db version.
+ */
+function resolveOhosSdkInput(options) {
+    const inputPath = path.resolve(options.inputPath);
+    if (!fs.existsSync(inputPath)) {
+        throw new OhosSdkInputError(`Path does not exist: ${inputPath}`);
+    }
+    let searchRoot = inputPath;
+    let cleanup;
+    if (fs.statSync(inputPath).isFile()) {
+        if (!isArchivePath(inputPath)) {
+            throw new OhosSdkInputError(`Unsupported file type: ${path.basename(inputPath)} (expected .zip, .tar.gz, .tgz, or .tar)`);
+        }
+        const extracted = extractArchive(inputPath);
+        searchRoot = extracted.dir;
+        cleanup = extracted.cleanup;
+    }
+    const sdkHome = findOhosSdkHome(searchRoot);
+    if (!sdkHome) {
+        cleanup?.();
+        throw new OhosSdkInputError(`Could not find sdk/default/openharmony/ets under ${inputPath}. ` +
+            'Expected HarmonyOS command-line-tools layout.');
+    }
+    const version = options.versionOverride?.trim() ||
+        parseOhosToolsVersionFromName(inputPath) ||
+        parseOhosToolsVersionFromName(searchRoot);
+    if (!version) {
+        cleanup?.();
+        throw new OhosSdkInputError('Could not determine API db version. Use a path like commandline-tools-linux-x64-6.1.1.290.zip ' +
+            'or pass the version as the second argument.');
+    }
+    return {
+        sdkHome,
+        version,
+        sourcePath: inputPath,
+        cleanup,
+    };
+}
+function extractArchive(archivePath) {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'homegraph-ohos-sdk-'));
+    const lower = archivePath.toLowerCase();
+    try {
+        if (lower.endsWith('.zip')) {
+            (0, child_process_1.execFileSync)('unzip', ['-q', archivePath, '-d', tempDir], { stdio: 'pipe' });
+        }
+        else if (lower.endsWith('.tar.gz') || lower.endsWith('.tgz')) {
+            (0, child_process_1.execFileSync)('tar', ['-xzf', archivePath, '-C', tempDir], { stdio: 'pipe' });
+        }
+        else if (lower.endsWith('.tar')) {
+            (0, child_process_1.execFileSync)('tar', ['-xf', archivePath, '-C', tempDir], { stdio: 'pipe' });
+        }
+        else {
+            throw new OhosSdkInputError(`Unsupported archive: ${path.basename(archivePath)}`);
+        }
+    }
+    catch (err) {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new OhosSdkInputError(`Failed to extract ${archivePath}: ${msg}`);
+    }
+    return {
+        dir: tempDir,
+        cleanup: () => {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        },
+    };
+}
+/** Default filename for a versioned OHOS API db. */
+function ohosApiDbFilename(version) {
+    return `ohos-api-${version}.db`;
+}
+/** Target path under ~/.homegraph/api/ for a versioned db. */
+function ohosApiDbInstallPath(version) {
+    return path.join(os.homedir(), '.homegraph', 'api', ohosApiDbFilename(version));
+}
+//# sourceMappingURL=ohos-sdk-input.js.map

package/dist/arkts/ohos-sdk-input.js.map

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

package/dist/bin/command-supervision.d.ts

@@ -0,0 +1,12 @@
+export interface CommandSupervision {
+    /** Tear down both watchdogs. Idempotent; call when the command finishes. */
+    stop(): void;
+}
+/**
+ * Install the liveness + PPID watchdogs for the duration of a CLI command.
+ * `label` is used in the shutdown notice (e.g. `"index"`). Returns a handle
+ * whose `stop()` must be called when the command completes so neither watchdog
+ * outlives it.
+ */
+export declare function installCommandSupervision(label: string): CommandSupervision;
+//# sourceMappingURL=command-supervision.d.ts.map

package/dist/bin/command-supervision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-supervision.d.ts","sourceRoot":"","sources":["../../src/bin/command-supervision.ts"],"names":[],"mappings":"AAmCA,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAwC3E"}