homegraph 1.1.2 → 1.2.0

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":";AAAA;;GAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuFH,wCAoFC;AAzKD,uCAAyB;AACzB,2CAA6B;AAC7B,8BAA2C;AAC3C,2CAA6C;AAC7C,mDAAsF;AAEtF,yDAAiF;AACjF,yEAAsE;AACtE,4CAAyD;AACzD,qDAA6F;AAS7F,SAAS,yBAAyB,CAAC,OAAe;IAChD,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,SAAS,IAAI,CAAC,GAAW;QACvB,IAAI,KAAK;YAAE,OAAO;QAClB,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;oBAAE,SAAS;gBACrE,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACvC,IACE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACtB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;oBACvB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBACxB,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EACnD,CAAC;oBACD,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;oBACzD,OAAO;gBACT,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAe;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,SAAS,IAAI,CAAC,GAAW;QACvB,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;oBAAE,SAAS;gBACrE,IAAI,CAAC,IAAI,CAAC,CAAC;YACb,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACvC,IACE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;oBACtB,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;oBACvB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBACxB,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EACnD,CAAC;oBACD,KAAK,EAAE,CAAC;gBACV,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAAC,OAA4B;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAA,kCAAiB,EAAC,OAAO,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,wCAAwC,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,oCAAmB,EAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAC7B,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAA,kCAAiB,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CACnF,CAAC;IACF,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,MAAM,EAAE,GAAG,uBAAkB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,sBAAY,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;YACnD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC;oBACV,OAAO,EAAE,0BAA0B,OAAO,EAAE;oBAC5C,QAAQ,EAAE,SAAS;iBACpB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;YACzC,OAAO,CAAC,UAAU,EAAE,CAAC;gBACnB,KAAK,EAAE,aAAa;gBACpB,OAAO,EAAE,CAAC;gBACV,KAAK;gBACL,WAAW,EAAE,OAAO;gBACpB,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YAEH,IAAA,uBAAe,GAAE,CAAC;YAClB,IAAA,gCAAsB,GAAE,CAAC;YACzB,IAAA,+BAAqB,EAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACxC,MAAM,IAAA,uBAAe,EAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACjD,YAAY,IAAI,KAAK,CAAC;YAEtB,OAAO,CAAC,UAAU,EAAE,CAAC;gBACnB,KAAK,EAAE,aAAa;gBACpB,OAAO,EAAE,KAAK;gBACd,KAAK;gBACL,WAAW,EAAE,OAAO;gBACpB,QAAQ,EAAE,SAAS;aACpB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;QAC7C,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QACzD,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,uBAAuB,CAAC,CAAC;QACjE,OAAO,CAAC,WAAW,CAAC,sBAAsB,EAAE,iCAAuB,CAAC,CAAC;QACrE,OAAO,CAAC,WAAW,CAAC,iCAAiC,EAAE,MAAM,CAAC,uCAAkB,CAAC,CAAC,CAAC;QAEnF,EAAE,CAAC,cAAc,EAAE,CAAC;QAEpB,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC;YACpD,YAAY;YACZ,YAAY,EAAE,CAAC;YACf,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;YACjE,YAAY,EAAE,MAAM,CAAC,KAAK;YAC1B,YAAY,EAAE,MAAM,CAAC,KAAK;YAC1B,MAAM;YACN,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;SACnC,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,IAAA,uBAAe,GAAE,CAAC;QAClB,IAAA,gCAAsB,GAAE,CAAC;QACzB,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

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"}

package/dist/bin/command-supervision.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installCommandSupervision = installCommandSupervision;
+/**
+ * Process supervision for long-running CLI commands (`index` / `init --index`).
+ *
+ * Indexing a large repo can run for a while on the main thread, and #999
+ * surfaced two ways that goes wrong when nothing is watching it:
+ *
+ *   1. **Orphaned worker.** `index` runs in a child re-exec'd with
+ *      `--liftoff-only` (the WASM-flag relaunch). Its parent blocks in
+ *      `spawnSync`, so when the parent shim is killed it cannot forward the
+ *      signal — the child keeps running, now orphaned, pinning a core. The PPID
+ *      watchdog (#277) notices the parent/host went away and exits the child.
+ *   2. **Wedged indexer.** The `#850` main-thread liveness watchdog — which
+ *      SIGKILLs a process whose event loop stops turning — was wired only into
+ *      the MCP `serve` path, so a wedged `index`/`init` was never auto-killed.
+ *
+ * Both reuse the exact mechanisms `serve` already uses; this just makes them
+ * available to a one-shot command. Best-effort and self-disabling: a missing
+ * watchdog never blocks the command from running. Both honour the same env
+ * switches as `serve` (`CODEGRAPH_NO_WATCHDOG`, `CODEGRAPH_PPID_POLL_MS=0`).
+ *
+ * Unlike the daemon — whose main thread only does fast, bounded work — the
+ * `index`/`init` path runs reference resolution and dynamic-edge synthesis
+ * SYNCHRONOUSLY on this thread, and on a large repo that is legitimately many
+ * seconds of work. So those spans yield cooperatively to the event loop
+ * (`src/resolution/cooperative-yield.ts`) to keep the heartbeat alive; without
+ * that the watchdog would SIGKILL a valid, in-progress index (#1091). The
+ * distinction it must preserve — kill a TRUE wedge, spare slow-but-progressing
+ * work — is exactly what cooperative yielding buys: a genuinely stuck span never
+ * reaches its next yield, so it still trips the timeout.
+ */
+const liveness_watchdog_1 = require("../mcp/liveness-watchdog");
+const ppid_watchdog_1 = require("../mcp/ppid-watchdog");
+const daemon_registry_1 = require("../mcp/daemon-registry");
+const wasm_runtime_flags_1 = require("../extraction/wasm-runtime-flags");
+/**
+ * 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.
+ */
+function installCommandSupervision(label) {
+    // Liveness watchdog: a separate process that SIGKILLs us if our event loop
+    // stops turning for too long (a wedged synchronous loop). Self-disables on
+    // CODEGRAPH_NO_WATCHDOG.
+    const liveness = (0, liveness_watchdog_1.installMainThreadWatchdog)();
+    // PPID watchdog: detect that the parent (or the host threaded past the
+    // relaunch shim) died and we've been orphaned, then exit instead of leaking.
+    const originalPpid = process.ppid;
+    const hostPpid = (0, ppid_watchdog_1.parseHostPpid)(process.env[wasm_runtime_flags_1.HOST_PPID_ENV]);
+    const pollMs = (0, ppid_watchdog_1.parsePpidPollMs)(process.env.CODEGRAPH_PPID_POLL_MS);
+    let ppidTimer = null;
+    if (pollMs > 0) {
+        ppidTimer = setInterval(() => {
+            const reason = (0, ppid_watchdog_1.supervisionLostReason)({
+                originalPpid,
+                currentPpid: process.ppid,
+                hostPpid,
+                isAlive: daemon_registry_1.isProcessAlive,
+            });
+            if (reason) {
+                try {
+                    process.stderr.write(`[CodeGraph ${label}] Parent process exited (${reason}); aborting.\n`);
+                }
+                catch { /* stderr gone with the parent — exit anyway */ }
+                process.exit(1);
+            }
+        }, pollMs);
+        // Never let the watchdog itself keep the process alive past its real work.
+        ppidTimer.unref();
+    }
+    let stopped = false;
+    return {
+        stop() {
+            if (stopped)
+                return;
+            stopped = true;
+            if (ppidTimer)
+                clearInterval(ppidTimer);
+            liveness?.stop();
+        },
+    };
+}
+//# sourceMappingURL=command-supervision.js.map

package/dist/bin/command-supervision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-supervision.js","sourceRoot":"","sources":["../../src/bin/command-supervision.ts"],"names":[],"mappings":";;AA8CA,8DAwCC;AAtFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,gEAAqE;AACrE,wDAA6F;AAC7F,4DAAwD;AACxD,yEAAiE;AAOjE;;;;;GAKG;AACH,SAAgB,yBAAyB,CAAC,KAAa;IACrD,2EAA2E;IAC3E,2EAA2E;IAC3E,yBAAyB;IACzB,MAAM,QAAQ,GAAG,IAAA,6CAAyB,GAAE,CAAC;IAE7C,uEAAuE;IACvE,6EAA6E;IAC7E,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAA,6BAAa,EAAC,OAAO,CAAC,GAAG,CAAC,kCAAa,CAAC,CAAC,CAAC;IAC3D,MAAM,MAAM,GAAG,IAAA,+BAAe,EAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IACnE,IAAI,SAAS,GAA0C,IAAI,CAAC;IAC5D,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;YAC3B,MAAM,MAAM,GAAG,IAAA,qCAAqB,EAAC;gBACnC,YAAY;gBACZ,WAAW,EAAE,OAAO,CAAC,IAAI;gBACzB,QAAQ;gBACR,OAAO,EAAE,gCAAc;aACxB,CAAC,CAAC;YACH,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC;oBACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,KAAK,4BAA4B,MAAM,gBAAgB,CAAC,CAAC;gBAC9F,CAAC;gBAAC,MAAM,CAAC,CAAC,+CAA+C,CAAC,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,2EAA2E;QAC3E,SAAS,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,OAAO;QACL,IAAI;YACF,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,SAAS;gBAAE,aAAa,CAAC,SAAS,CAAC,CAAC;YACxC,QAAQ,EAAE,IAAI,EAAE,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/bin/homegraph.d.ts

@@ -19,7 +19,7 @@
  *   homegraph callers <symbol>   Find what calls a function/method
  *   homegraph callees <symbol>   Find what a function/method calls
  *   homegraph impact <symbol>    Analyze what code is affected by changing a symbol
- *   homegraph affected [files]   Find test files affected by changes
+ *   homegraph index-api <tools>   Build OHOS API db from command-line-tools
  *   homegraph upgrade [version]  Update HomeGraph to the latest release
  */
 export {};