homegraph 1.5.1 → 1.5.3

package/dist/extraction/wasm-runtime-flags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wasm-runtime-flags.d.ts","sourceRoot":"","sources":["../../src/extraction/wasm-runtime-flags.ts"],"names":[],"mappings":"AAkCA;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAuB,CAAC;AAExE,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAiBvC,mFAAmF;AACnF,wBAAgB,wBAAwB,IAAI,MAAM,CAOjD;AAED,wBAAgB,mBAAmB,CAAC,EAAE,GAAE,MAAmC,GAAG,MAAM,CAEnF;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,mFAAmF;AACnF,wBAAgB,0BAA0B,CACxC,QAAQ,GAAE,SAAS,MAAM,EAAqB,GAC7C,OAAO,CAET;AAED,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAC5C,QAAQ,GAAE,SAAS,MAAM,EAAqB,GAC7C,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,QAAQ,GAAE,SAAS,MAAM,EAAqB,GAC7C,MAAM,EAAE,CAcV;AAED;;;;;;;;GAQG;AACH,wBAAgB,oCAAoC,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAkB7E"}
+{"version":3,"file":"wasm-runtime-flags.d.ts","sourceRoot":"","sources":["../../src/extraction/wasm-runtime-flags.ts"],"names":[],"mappings":"AAqCA;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAAuB,CAAC;AAExE,kFAAkF;AAClF,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAiBvC,mFAAmF;AACnF,wBAAgB,wBAAwB,IAAI,MAAM,CAOjD;AAED,wBAAgB,mBAAmB,CAAC,EAAE,GAAE,MAAmC,GAAG,MAAM,CAEnF;AAMD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,mFAAmF;AACnF,wBAAgB,0BAA0B,CACxC,QAAQ,GAAE,SAAS,MAAM,EAAqB,GAC7C,OAAO,CAET;AAED,+EAA+E;AAC/E,wBAAgB,8BAA8B,CAC5C,QAAQ,GAAE,SAAS,MAAM,EAAqB,GAC7C,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,QAAQ,GAAE,SAAS,MAAM,EAAqB,GAC7C,MAAM,EAAE,CAcV;AAED;;;;;;;;GAQG;AACH,wBAAgB,oCAAoC,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAkB7E"}

package/dist/extraction/wasm-runtime-flags.js

@@ -15,8 +15,12 @@ exports.relaunchWithWasmRuntimeFlagsIfNeeded = relaunchWithWasmRuntimeFlagsIfNee
  * arena while compiling these grammars on a background thread, aborting the
  * whole process with `Fatal process out of memory: Zone` — even with tens of
  * GB of system memory free, because the Zone is a V8-internal arena, not the
- * JS heap. Reproduced on Node 22 and 24; Node 25 is already hard-blocked for
- * the same crash (see ../bin/node-version-check.ts). See issues #293 and #298.
+ * JS heap. The trigger is not mere `Language.load` (lazy compile stays on
+ * Liftoff): after a large grammar is hot from repeated parse, turboshaft's
+ * background optimizing compile OOMs the Zone. Reproduced on Node 24 and 25+
+ * (see test/fixtures/wasm-zone-oom-harness.cjs); mitigated here rather than by
+ * blocking majors (see ../bin/node-version-check.ts for the supported floor
+ * only). See issues #293 and #298.
  *
  * `--liftoff-only` forces every WASM module to the Liftoff baseline compiler
  * and never runs turboshaft, which eliminates the crash. Parsing stays fully
@@ -31,10 +35,9 @@ exports.relaunchWithWasmRuntimeFlagsIfNeeded = relaunchWithWasmRuntimeFlagsIfNee
  * Also empirically, `--no-wasm-tier-up` / `--no-wasm-dynamic-tiering` do NOT
  * prevent the crash — only disabling the optimizing tier entirely does.
  *
- * Delivery: the bundled launcher passes the flag directly (see
- * scripts/build-bundle.sh and scripts/npm-shim.js); for any other launch path
- * (running dist directly, from source, etc.) the CLI re-execs itself once with
- * the flag via {@link relaunchWithWasmRuntimeFlagsIfNeeded}. V8 flags are
+ * Delivery: the CLI re-execs itself once with the flag via
+ * {@link relaunchWithWasmRuntimeFlagsIfNeeded} when launched without it
+ * (running dist directly, from source, npm global, etc.). V8 flags are
  * PROCESS-global, and the parse worker is created with default (inherited)
  * execArgv, so flagging the main process governs the worker's WASM compilation
  * too.

package/dist/extraction/wasm-runtime-flags.js.map

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

package/dist/graph-sources.d.ts

@@ -0,0 +1,41 @@
+/**
+ * MCP / query-time graph source selection — project index vs OHOS SDK API db.
+ *
+ * Spec: docs/specs/0005-mcp-graph-sources-switch.md
+ *
+ * CLI: `homegraph serve mcp --sources both|project|sdk|none`
+ * Env:  `HOMEGRAPH_SOURCES` (used when CLI omits --sources)
+ * Priority: explicit CLI/options > env > `both`
+ */
+export declare const GRAPH_SOURCES_ENV = "HOMEGRAPH_SOURCES";
+export type GraphSourcesMode = 'both' | 'project' | 'sdk' | 'none';
+export declare const GRAPH_SOURCES_MODES: readonly GraphSourcesMode[];
+export interface GraphSourceFlags {
+    /** Include symbols from the project's `.homegraph` main graph. */
+    project: boolean;
+    /** ATTACH + query `~/.homegraph/api` OHOS API db. */
+    sdk: boolean;
+    /** Open a HomeGraph instance at all (false only for `none`). */
+    openProjectDb: boolean;
+}
+/**
+ * Parse a raw mode string. Returns null when empty/undefined (caller applies default).
+ * Throws on non-empty invalid values.
+ */
+export declare function parseGraphSourcesMode(raw: string | undefined | null): GraphSourcesMode | null;
+/** Map mode → runtime flags. */
+export declare function graphSourceFlags(mode: GraphSourcesMode): GraphSourceFlags;
+/**
+ * Resolve effective mode.
+ * @param explicit - from `--sources` or `OpenOptions.sources` (wins over env)
+ * @param env - defaults to `process.env.HOMEGRAPH_SOURCES`
+ */
+export declare function resolveGraphSources(explicit?: string | null, env?: NodeJS.ProcessEnv): GraphSourcesMode;
+/**
+ * Apply CLI `--sources` into the process env so detached daemons and nested
+ * opens in this process see the same mode without re-parsing argv.
+ */
+export declare function applyGraphSourcesToEnv(mode: GraphSourcesMode, env?: NodeJS.ProcessEnv): void;
+/** Short success-shaped guidance when sources=none (or no usable graph). */
+export declare function graphSourcesDisabledGuidance(mode?: GraphSourcesMode): string;
+//# sourceMappingURL=graph-sources.d.ts.map

package/dist/graph-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-sources.d.ts","sourceRoot":"","sources":["../src/graph-sources.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnE,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAKjD,CAAC;AAEX,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,GAAG,EAAE,OAAO,CAAC;IACb,gEAAgE;IAChE,aAAa,EAAE,OAAO,CAAC;CACxB;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,gBAAgB,GAAG,IAAI,CAW7F;AAED,gCAAgC;AAChC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,gBAAgB,CAWzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,gBAAgB,CAMlB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAEzG;AAED,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAAC,IAAI,GAAE,gBAAwC,GAAG,MAAM,CAMnG"}

package/dist/graph-sources.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * MCP / query-time graph source selection — project index vs OHOS SDK API db.
+ *
+ * Spec: docs/specs/0005-mcp-graph-sources-switch.md
+ *
+ * CLI: `homegraph serve mcp --sources both|project|sdk|none`
+ * Env:  `HOMEGRAPH_SOURCES` (used when CLI omits --sources)
+ * Priority: explicit CLI/options > env > `both`
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GRAPH_SOURCES_MODES = exports.GRAPH_SOURCES_ENV = void 0;
+exports.parseGraphSourcesMode = parseGraphSourcesMode;
+exports.graphSourceFlags = graphSourceFlags;
+exports.resolveGraphSources = resolveGraphSources;
+exports.applyGraphSourcesToEnv = applyGraphSourcesToEnv;
+exports.graphSourcesDisabledGuidance = graphSourcesDisabledGuidance;
+exports.GRAPH_SOURCES_ENV = 'HOMEGRAPH_SOURCES';
+exports.GRAPH_SOURCES_MODES = [
+    'both',
+    'project',
+    'sdk',
+    'none',
+];
+const MODE_SET = new Set(exports.GRAPH_SOURCES_MODES);
+/**
+ * Parse a raw mode string. Returns null when empty/undefined (caller applies default).
+ * Throws on non-empty invalid values.
+ */
+function parseGraphSourcesMode(raw) {
+    if (raw == null)
+        return null;
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    const lower = trimmed.toLowerCase();
+    if (!MODE_SET.has(lower)) {
+        throw new Error(`Invalid graph sources "${raw}". Expected one of: ${exports.GRAPH_SOURCES_MODES.join(', ')}`);
+    }
+    return lower;
+}
+/** Map mode → runtime flags. */
+function graphSourceFlags(mode) {
+    switch (mode) {
+        case 'both':
+            return { project: true, sdk: true, openProjectDb: true };
+        case 'project':
+            return { project: true, sdk: false, openProjectDb: true };
+        case 'sdk':
+            return { project: false, sdk: true, openProjectDb: true };
+        case 'none':
+            return { project: false, sdk: false, openProjectDb: false };
+    }
+}
+/**
+ * Resolve effective mode.
+ * @param explicit - from `--sources` or `OpenOptions.sources` (wins over env)
+ * @param env - defaults to `process.env.HOMEGRAPH_SOURCES`
+ */
+function resolveGraphSources(explicit, env = process.env) {
+    const fromCli = parseGraphSourcesMode(explicit ?? undefined);
+    if (fromCli)
+        return fromCli;
+    const fromEnv = parseGraphSourcesMode(env[exports.GRAPH_SOURCES_ENV]);
+    if (fromEnv)
+        return fromEnv;
+    return 'both';
+}
+/**
+ * Apply CLI `--sources` into the process env so detached daemons and nested
+ * opens in this process see the same mode without re-parsing argv.
+ */
+function applyGraphSourcesToEnv(mode, env = process.env) {
+    env[exports.GRAPH_SOURCES_ENV] = mode;
+}
+/** Short success-shaped guidance when sources=none (or no usable graph). */
+function graphSourcesDisabledGuidance(mode = resolveGraphSources()) {
+    return (`HomeGraph graph sources are set to "${mode}" — no project/SDK graph is available for this session. ` +
+        `Pass \`--sources both|project|sdk\` on \`homegraph serve mcp\`, or set ${exports.GRAPH_SOURCES_ENV}. ` +
+        `Default is both (project index + OHOS SDK API db when bound).`);
+}
+//# sourceMappingURL=graph-sources.js.map

package/dist/graph-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-sources.js","sourceRoot":"","sources":["../src/graph-sources.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA4BH,sDAWC;AAGD,4CAWC;AAOD,kDASC;AAMD,wDAEC;AAGD,oEAMC;AApFY,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AAIxC,QAAA,mBAAmB,GAAgC;IAC9D,MAAM;IACN,SAAS;IACT,KAAK;IACL,MAAM;CACE,CAAC;AAWX,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,2BAAmB,CAAC,CAAC;AAEtD;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,GAA8B;IAClE,IAAI,GAAG,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,0BAA0B,GAAG,uBAAuB,2BAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,KAAyB,CAAC;AACnC,CAAC;AAED,gCAAgC;AAChC,SAAgB,gBAAgB,CAAC,IAAsB;IACrD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAC3D,KAAK,SAAS;YACZ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAC5D,KAAK,KAAK;YACR,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAC5D,KAAK,MAAM;YACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;IAChE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CACjC,QAAwB,EACxB,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,OAAO,GAAG,qBAAqB,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC;IAC7D,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,yBAAiB,CAAC,CAAC,CAAC;IAC9D,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CAAC,IAAsB,EAAE,MAAyB,OAAO,CAAC,GAAG;IACjG,GAAG,CAAC,yBAAiB,CAAC,GAAG,IAAI,CAAC;AAChC,CAAC;AAED,4EAA4E;AAC5E,SAAgB,4BAA4B,CAAC,OAAyB,mBAAmB,EAAE;IACzF,OAAO,CACL,uCAAuC,IAAI,0DAA0D;QACrG,0EAA0E,yBAAiB,IAAI;QAC/F,+DAA+D,CAChE,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -9,8 +9,11 @@ import { QueryBuilder } from './db/queries';
 import { IndexProgress, IndexResult, SyncResult } from './extraction';
 import { type OhosApiDbBinding } from './extraction/languages/arkts';
 import { ResolutionResult } from './resolution';
+import { type ArkUIMigrateSnapshot } from './arkui/migrate-snapshot';
 import { WatchOptions, PendingFile } from './sync';
+import { type GraphSourcesMode } from './graph-sources';
 export * from './types';
+export { type GraphSourcesMode, GRAPH_SOURCES_ENV, GRAPH_SOURCES_MODES, resolveGraphSources, graphSourceFlags, parseGraphSourcesMode, } from './graph-sources';
 export { getDatabasePath, DatabaseConnection } from './db';
 export { QueryBuilder } from './db/queries';
 export { getHomeGraphDir, isInitialized, findNearestHomeGraphRoot, HOMEGRAPH_DIR, } from './directory';
@@ -21,6 +24,7 @@ export { HomeGraphError, FileError, ParseError, DatabaseError, SearchError, Vect
 export { Mutex, FileLock, processInBatches, debounce, throttle, MemoryMonitor } from './utils';
 export { FileWatcher, WatchOptions, PendingFile, LockUnavailableError } from './sync';
 export { MCPServer } from './mcp';
+export { buildArkUIMigrateSnapshot, ARKUI_MIGRATE_SCHEMA_VERSION, DEFAULT_DIRECTORY_COMPONENT_LIMIT, type ArkUIMigrateSnapshot, } from './arkui';
 /**
  * Options for initializing a new HomeGraph project
  */
@@ -38,6 +42,11 @@ export interface OpenOptions {
     sync?: boolean;
     /** Whether to run in read-only mode */
     readOnly?: boolean;
+    /**
+     * Which graph sources to use for lookups (project index and/or OHOS SDK API).
+     * Defaults to `HOMEGRAPH_SOURCES` env, then `both`. See Spec 0005.
+     */
+    sources?: GraphSourcesMode | string;
 }
 /**
  * Options for indexing
@@ -69,6 +78,8 @@ export declare class HomeGraph {
     private indexMutex;
     private fileLock;
     private watcher;
+    /** Effective graph sources for this instance (Spec 0005). */
+    private graphSources;
     private constructor();
     /**
      * (Re)build the query/extraction/graph layers over the current `this.queries`
@@ -134,7 +145,7 @@ export declare class HomeGraph {
     /**
      * Open synchronously (without sync)
      */
-    static openSync(projectRoot: string): HomeGraph;
+    static openSync(projectRoot: string, options?: OpenOptions): HomeGraph;
     /**
      * Check if a directory has been initialized as a HomeGraph project
      */
@@ -147,6 +158,8 @@ export declare class HomeGraph {
      * Get the project root directory
      */
     getProjectRoot(): string;
+    /** Effective graph sources for this open (`both` | `project` | `sdk`). */
+    getGraphSources(): GraphSourcesMode;
     /**
      * Index all files in the project
      *
@@ -435,6 +448,11 @@ export declare class HomeGraph {
      * Get incoming edges to a node
      */
     getIncomingEdges(nodeId: string): Edge[];
+    /**
+     * ArkUI migrate / state-semantics snapshot for a scope (spec 0007).
+     * Scope: component name, relative file path, or directory prefix.
+     */
+    getArkUIMigrateSnapshot(scope: string): ArkUIMigrateSnapshot;
     /**
      * Get a file record by path
      */

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -42,7 +42,7 @@ 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 });
-exports.HomeGraph = exports.MCPServer = exports.LockUnavailableError = exports.FileWatcher = exports.MemoryMonitor = exports.throttle = exports.debounce = exports.processInBatches = exports.FileLock = exports.Mutex = exports.defaultLogger = exports.silentLogger = exports.getLogger = exports.setLogger = exports.ConfigError = exports.VectorError = exports.SearchError = exports.DatabaseError = exports.ParseError = exports.FileError = exports.HomeGraphError = exports.loadAllGrammars = exports.loadGrammarsForLanguages = exports.initGrammars = exports.getSupportedLanguages = exports.isGrammarLoaded = exports.isLanguageSupported = exports.detectLanguage = exports.HOMEGRAPH_DIR = exports.findNearestHomeGraphRoot = exports.isInitialized = exports.getHomeGraphDir = exports.QueryBuilder = exports.DatabaseConnection = exports.getDatabasePath = void 0;
+exports.HomeGraph = exports.DEFAULT_DIRECTORY_COMPONENT_LIMIT = exports.ARKUI_MIGRATE_SCHEMA_VERSION = exports.buildArkUIMigrateSnapshot = exports.MCPServer = exports.LockUnavailableError = exports.FileWatcher = exports.MemoryMonitor = exports.throttle = exports.debounce = exports.processInBatches = exports.FileLock = exports.Mutex = exports.defaultLogger = exports.silentLogger = exports.getLogger = exports.setLogger = exports.ConfigError = exports.VectorError = exports.SearchError = exports.DatabaseError = exports.ParseError = exports.FileError = exports.HomeGraphError = exports.loadAllGrammars = exports.loadGrammarsForLanguages = exports.initGrammars = exports.getSupportedLanguages = exports.isGrammarLoaded = exports.isLanguageSupported = exports.detectLanguage = exports.HOMEGRAPH_DIR = exports.findNearestHomeGraphRoot = exports.isInitialized = exports.getHomeGraphDir = exports.QueryBuilder = exports.DatabaseConnection = exports.getDatabasePath = exports.parseGraphSourcesMode = exports.graphSourceFlags = exports.resolveGraphSources = exports.GRAPH_SOURCES_MODES = exports.GRAPH_SOURCES_ENV = void 0;
 const path = __importStar(require("path"));
 const db_1 = require("./db");
 const wal_valve_1 = require("./db/wal-valve");
@@ -53,6 +53,7 @@ const context_1 = require("./extraction/context");
 const arkts_1 = require("./extraction/languages/arkts");
 const resolution_1 = require("./resolution");
 const graph_1 = require("./graph");
+const migrate_snapshot_1 = require("./arkui/migrate-snapshot");
 const context_2 = require("./context");
 const utils_1 = require("./utils");
 const sync_1 = require("./sync");
@@ -63,8 +64,15 @@ const identifier_segments_1 = require("./search/identifier-segments");
 const cooperative_yield_1 = require("./resolution/cooperative-yield");
 const resolver_pool_1 = require("./resolution/resolver-pool");
 const version_1 = require("./mcp/version");
+const graph_sources_1 = require("./graph-sources");
 // Re-export types for consumers
 __exportStar(require("./types"), exports);
+var graph_sources_2 = require("./graph-sources");
+Object.defineProperty(exports, "GRAPH_SOURCES_ENV", { enumerable: true, get: function () { return graph_sources_2.GRAPH_SOURCES_ENV; } });
+Object.defineProperty(exports, "GRAPH_SOURCES_MODES", { enumerable: true, get: function () { return graph_sources_2.GRAPH_SOURCES_MODES; } });
+Object.defineProperty(exports, "resolveGraphSources", { enumerable: true, get: function () { return graph_sources_2.resolveGraphSources; } });
+Object.defineProperty(exports, "graphSourceFlags", { enumerable: true, get: function () { return graph_sources_2.graphSourceFlags; } });
+Object.defineProperty(exports, "parseGraphSourcesMode", { enumerable: true, get: function () { return graph_sources_2.parseGraphSourcesMode; } });
 // Storage building blocks for embedded/SDK consumers that drive the graph
 // directly (open a DB, run prepared queries) rather than through the HomeGraph
 // facade. Exposed from the package entry so they no longer require deep imports
@@ -111,6 +119,10 @@ Object.defineProperty(exports, "FileWatcher", { enumerable: true, get: function
 Object.defineProperty(exports, "LockUnavailableError", { enumerable: true, get: function () { return sync_2.LockUnavailableError; } });
 var mcp_1 = require("./mcp");
 Object.defineProperty(exports, "MCPServer", { enumerable: true, get: function () { return mcp_1.MCPServer; } });
+var arkui_1 = require("./arkui");
+Object.defineProperty(exports, "buildArkUIMigrateSnapshot", { enumerable: true, get: function () { return arkui_1.buildArkUIMigrateSnapshot; } });
+Object.defineProperty(exports, "ARKUI_MIGRATE_SCHEMA_VERSION", { enumerable: true, get: function () { return arkui_1.ARKUI_MIGRATE_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "DEFAULT_DIRECTORY_COMPONENT_LIMIT", { enumerable: true, get: function () { return arkui_1.DEFAULT_DIRECTORY_COMPONENT_LIMIT; } });
 /**
  * Main HomeGraph class
  *
@@ -134,10 +146,13 @@ class HomeGraph {
     fileLock;
     // File watcher for auto-sync on file changes
     watcher = null;
-    constructor(db, queries, projectRoot) {
+    /** Effective graph sources for this instance (Spec 0005). */
+    graphSources;
+    constructor(db, queries, projectRoot, sources) {
         this.db = db;
         this.queries = queries;
         this.projectRoot = projectRoot;
+        this.graphSources = sources ?? 'both';
         (0, context_1.bindExtractionContext)(projectRoot, queries);
         this.fileLock = new utils_1.FileLock(path.join((0, directory_2.getHomeGraphDir)(projectRoot), 'homegraph.lock'));
         this.wireLayers();
@@ -162,9 +177,17 @@ class HomeGraph {
         this.graphManager = new graph_1.GraphQueryManager(this.queries);
         this.traverser = new graph_1.GraphTraverser(this.queries);
         this.contextBuilder = (0, context_2.createContextBuilder)(this.projectRoot, this.queries, this.traverser);
-        (0, arkts_1.restoreOhosApiDbAttach)(this.queries);
-        if (!this.queries.getOhosApiDbPath()) {
-            (0, arkts_1.bindOhosApiDbForProject)(this.projectRoot, this.queries);
+        const flags = (0, graph_sources_1.graphSourceFlags)(this.graphSources);
+        this.queries.setIncludeProjectNodes(flags.project);
+        if (flags.sdk) {
+            (0, arkts_1.restoreOhosApiDbAttach)(this.queries);
+            if (!this.queries.getOhosApiDbPath()) {
+                // Open path: attach a prebuilt ~/.homegraph/api db only — never build here.
+                (0, arkts_1.attachExistingOhosApiDbForProject)(this.projectRoot, this.queries);
+            }
+        }
+        else {
+            this.queries.attachOhosApiDb(null);
         }
     }
     /**
@@ -260,6 +283,11 @@ class HomeGraph {
     static async open(projectRoot, options = {}) {
         await (0, extraction_1.initGrammars)();
         const resolvedRoot = path.resolve(projectRoot);
+        const sources = (0, graph_sources_1.resolveGraphSources)(options.sources);
+        if (!(0, graph_sources_1.graphSourceFlags)(sources).openProjectDb) {
+            throw new Error(`Cannot open HomeGraph when graph sources are "${sources}". ` +
+                `Use --sources both|project|sdk or unset HOMEGRAPH_SOURCES.`);
+        }
         // Check if initialized
         if (!(0, directory_1.isInitialized)(resolvedRoot)) {
             throw new Error(`HomeGraph not initialized in ${resolvedRoot}. Run init() first.`);
@@ -273,7 +301,7 @@ class HomeGraph {
         const dbPath = (0, db_1.getDatabasePath)(resolvedRoot);
         const db = db_1.DatabaseConnection.open(dbPath);
         const queries = new queries_1.QueryBuilder(db.getDb());
-        const instance = new HomeGraph(db, queries, resolvedRoot);
+        const instance = new HomeGraph(db, queries, resolvedRoot, sources);
         // Sync if requested
         if (options.sync) {
             await instance.sync();
@@ -325,8 +353,13 @@ class HomeGraph {
     /**
      * Open synchronously (without sync)
      */
-    static openSync(projectRoot) {
+    static openSync(projectRoot, options = {}) {
         const resolvedRoot = path.resolve(projectRoot);
+        const sources = (0, graph_sources_1.resolveGraphSources)(options.sources);
+        if (!(0, graph_sources_1.graphSourceFlags)(sources).openProjectDb) {
+            throw new Error(`Cannot open HomeGraph when graph sources are "${sources}". ` +
+                `Use --sources both|project|sdk or unset HOMEGRAPH_SOURCES.`);
+        }
         // Check if initialized
         if (!(0, directory_1.isInitialized)(resolvedRoot)) {
             throw new Error(`HomeGraph not initialized in ${resolvedRoot}. Run init() first.`);
@@ -340,7 +373,7 @@ class HomeGraph {
         const dbPath = (0, db_1.getDatabasePath)(resolvedRoot);
         const db = db_1.DatabaseConnection.open(dbPath);
         const queries = new queries_1.QueryBuilder(db.getDb());
-        return new HomeGraph(db, queries, resolvedRoot);
+        return new HomeGraph(db, queries, resolvedRoot, sources);
     }
     /**
      * Check if a directory has been initialized as a HomeGraph project
@@ -363,6 +396,10 @@ class HomeGraph {
     getProjectRoot() {
         return this.projectRoot;
     }
+    /** Effective graph sources for this open (`both` | `project` | `sdk`). */
+    getGraphSources() {
+        return this.graphSources;
+    }
     // ===========================================================================
     // Indexing
     // ===========================================================================
@@ -489,7 +526,7 @@ class HomeGraph {
                     const languages = Object.entries(this.getStats().filesByLanguage)
                         .filter(([, count]) => count > 0)
                         .map(([lang]) => lang);
-                    const ohosBinding = (0, arkts_1.bindOhosApiDbForProject)(this.projectRoot, this.queries, languages);
+                    const ohosBinding = await (0, arkts_1.bindOhosApiDbForProject)(this.projectRoot, this.queries, languages, { build: true, onProgress: options.onProgress });
                     if (ohosBinding && 'code' in ohosBinding) {
                         result.errors.push({ message: ohosBinding.message, severity: 'warning', code: ohosBinding.code });
                     }
@@ -667,6 +704,24 @@ class HomeGraph {
                         }, backpressure);
                     }
                 }
+                // Re-open resolution edges this sync may have invalidated ELSEWHERE in
+                // the repo. Everything above re-resolves references in the changed
+                // files; this covers the opposite direction — references in files the
+                // sync never touched whose answer depended on a definition that just
+                // appeared or disappeared. Without it a synced index never converges
+                // to a full rebuild. The resurrected refs are pending rows, so the
+                // orphan sweep immediately below is what resolves them — batched,
+                // yielding, multi-pass, exactly as a full index resolves.
+                //
+                // `definitionDelta` is empty for a body-only edit, so the overwhelmingly
+                // common sync pays one branch. HOMEGRAPH_NO_REBIND=1 disables it.
+                if (result.definitionDelta && process.env.HOMEGRAPH_NO_REBIND !== '1') {
+                    const tRebind = Date.now();
+                    const rebound = this.orchestrator.resurrectStaleResolutionEdges(result.definitionDelta, result.changedFilePaths ?? []);
+                    if (process.env.HOMEGRAPH_SYNTH_TIMINGS) {
+                        console.error(`[phase-timing] sync-rebind: ${Date.now() - tRebind}ms (${result.definitionDelta.length} changed names, ${rebound} edges re-opened)`);
+                    }
+                }
                 const orphanCount = this.queries.getUnresolvedReferencesCount();
                 if (orphanCount > 0) {
                     options.onProgress?.({
@@ -949,6 +1004,7 @@ class HomeGraph {
     getStats() {
         const stats = this.queries.getStats();
         stats.dbSizeBytes = this.db.getSize();
+        stats.walSizeBytes = this.db.getWalSizeBytes();
         return stats;
     }
     /**
@@ -1229,6 +1285,21 @@ class HomeGraph {
     getIncomingEdges(nodeId) {
         return this.queries.getIncomingEdges(nodeId);
     }
+    /**
+     * ArkUI migrate / state-semantics snapshot for a scope (spec 0007).
+     * Scope: component name, relative file path, or directory prefix.
+     */
+    getArkUIMigrateSnapshot(scope) {
+        return (0, migrate_snapshot_1.buildArkUIMigrateSnapshot)({
+            getNodesByKind: (kind) => this.getNodesByKind(kind),
+            getNodesByName: (name) => this.getNodesByName(name),
+            getNodesInFile: (filePath) => this.getNodesInFile(filePath),
+            getOutgoingEdges: (id) => this.getOutgoingEdges(id),
+            getIncomingEdges: (id) => this.getIncomingEdges(id),
+            getNode: (id) => this.getNode(id),
+            getAllFiles: () => this.getFiles(),
+        }, scope);
+    }
     // ===========================================================================
     // File Operations
     // ===========================================================================