homegraph 1.5.8 → 1.5.10

package/CHANGELOG.md

@@ -10,6 +10,21 @@ and adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 ## [Unreleased]
 
 
+## [1.5.10] - 2026-09-20
+
+### Fixes
+
+- ArkTS synthetic PROJECT modules are limited to Node `package.json` trees (e.g. hvigor plugins). Forgotten Harmony HARs that only have `oh-package.json5` / loose `.ets` outside root `build-profile.json5` are no longer registered for `analyseByModule` BODIES — on SceneBoard-scale repos that was reloading already-indexed monorepo deps into ModuleCache and inflating wall time and peak RSS. Those orphans are indexed via tree-sitter instead. Parent-dir swallow of real Harmony modules (e.g. `synthetic:feature/`) remains blocked (Spec 0036).
+- After a streamed ArkTS modular batch finishes and releases the Scene, orphan `.ets` files that were never PROJECT-persisted no longer trigger a second full `analyseByModule` (the “127/127 done → starts again at 1/127” loop). They use the TypeScript tree-sitter fallback instead (Spec 0036).
+- `homegraph init`/`index` reported duration now covers the full wall clock (extract + FTS rebuild + resolve/link + maintenance), not only the extraction orchestrator phase (Spec 0036).
+- Harmony `build-profile.json5` files that use single-quoted strings (e.g. `'2in1'`) and bare keys now parse correctly, so multi-module ArkTS dirty sync can map changed `.ets` files to PROJECT modules instead of always falling back to a full rebuild (Spec 0034).
+
+### Improvements
+
+- Bump `arkanalyzer` to **1.0.94**.
+- Harmony projects with a root `build-profile.json5` now default to **serial indexing** after ArkAnalyzer: one parse worker and no resolve/synthesis worker pool. On SceneBoard-scale repos this cut peak process-tree PrivateMemory from ~8.5GB to ~3.8GB with only ~6% more wall clock. Opt out with `HOMEGRAPH_HARMONY_SERIAL=0`; force on with `=1`. Explicit `CODEGRAPH_PARSE_WORKERS` still overrides parse concurrency (Spec 0037).
+- MCP product index readiness is now five short states (`empty` / `fast` / `full` / `dirty` / `syncing`): tool replies use a one-line `HomeGraph status=…` footer (or that line alone when the tool cannot answer yet). Pending edits surface as `dirty` with path list instead of the long stale banner; write locks stay `syncing`. MCP initialize includes a one-line status glossary (Spec 0035).
+
 ## [1.5.8] - 2026-09-15
 
 ### Improvements
@@ -240,3 +255,4 @@ and adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 [1.5.6]: https://github.com/fujiaxin-coder/homegraph/releases/tag/v1.5.6
 [1.5.7]: https://github.com/fujiaxin-coder/homegraph/releases/tag/v1.5.7
 [1.5.8]: https://github.com/fujiaxin-coder/homegraph/releases/tag/v1.5.8
+[1.5.10]: https://github.com/fujiaxin-coder/homegraph/releases/tag/v1.5.10

package/dist/extraction/index.js

@@ -1475,17 +1475,25 @@ class ExtractionOrchestrator {
                 await (0, arkts_1.primeArkTSBatch)(this.rootDir, this.queries, firstEtsFile);
                 errors.push(...(0, arkts_1.drainArkTSIndexNotices)());
             }
-            // Start parse pool only after Scene teardown — most .ets are already in DB.
-            const remainingToParse = files.filter((f) => !((0, arkts_1.isArkTSBatchPersisted)(f) || ((0, arkts_1.isArkTSBatchCommitted)() && (0, arkts_1.isArkAnalyzerSourcePath)(f)))).length;
+            // Start parse pool only after Scene teardown — AA-persisted .ets are already
+            // in DB. Ark sources that never entered a PROJECT module (forgotten HARs /
+            // packageless orphans) are NOT skipped here — they fall through to tree-sitter.
+            const remainingToParse = files.filter((f) => !(0, arkts_1.isArkTSBatchPersisted)(f)).length;
             if (useWorker) {
                 // CODEGRAPH_PARSE_WORKERS: explicit worker count; 1 = the old single-worker
                 // behaviour (the conservative rollback). Unset → clamp(cores-1, 1, 8).
+                // Harmony modular repos default to 1 worker (Spec 0037) unless overridden.
                 let poolSize = (0, parse_pool_1.resolveParsePoolSize)(process.env.CODEGRAPH_PARSE_WORKERS, os.cpus().length);
-                if (!process.env.CODEGRAPH_PARSE_WORKERS?.trim() && remainingToParse < 500) {
-                    poolSize = Math.min(poolSize, 2);
-                }
-                else if (!process.env.CODEGRAPH_PARSE_WORKERS?.trim() && remainingToParse < 2000) {
-                    poolSize = Math.min(poolSize, 4);
+                if (!process.env.CODEGRAPH_PARSE_WORKERS?.trim()) {
+                    if ((0, arkts_1.preferHarmonySerialIndexing)(this.rootDir)) {
+                        poolSize = 1;
+                    }
+                    else if (remainingToParse < 500) {
+                        poolSize = Math.min(poolSize, 2);
+                    }
+                    else if (remainingToParse < 2000) {
+                        poolSize = Math.min(poolSize, 4);
+                    }
                 }
                 pool = new parse_pool_1.ParseWorkerPool({
                     languages: neededLanguages,
@@ -1523,8 +1531,7 @@ class ExtractionOrchestrator {
                 const batch = files.slice(i, i + FILE_IO_BATCH_SIZE);
                 // Read files in parallel (with path validation before any I/O)
                 const fileContents = await Promise.all(batch.map(async (fp) => {
-                    if ((0, arkts_1.isArkTSBatchPersisted)(fp) ||
-                        ((0, arkts_1.isArkTSBatchCommitted)() && (0, arkts_1.isArkAnalyzerSourcePath)(fp))) {
+                    if ((0, arkts_1.isArkTSBatchPersisted)(fp)) {
                         return {
                             filePath: fp,
                             content: null,
@@ -1559,9 +1566,7 @@ class ExtractionOrchestrator {
                         aborted = true;
                         break;
                     }
-                    if ((0, arkts_1.isArkTSBatchPersisted)(filePath) ||
-                        arktsBatchSkipped ||
-                        ((0, arkts_1.isArkTSBatchCommitted)() && (0, arkts_1.isArkAnalyzerSourcePath)(filePath))) {
+                    if ((0, arkts_1.isArkTSBatchPersisted)(filePath) || arktsBatchSkipped) {
                         processed++;
                         filesIndexed++;
                         onProgress?.({ phase: 'parsing', current: processed, total, currentFile: filePath });

package/dist/extraction/languages/arkts.d.ts

@@ -49,6 +49,16 @@ export declare function buildArkMethodSignatureFields(method: ArkMethod): {
  * the indexer (rare Photos-scale Windows cases).
  */
 export declare function shouldUseIsolatedArkTSBuild(): boolean;
+/**
+ * Default to serial parse + no resolve worker pool on Harmony modular repos.
+ * analyseByModule dominates wall clock; worker pools mainly spike peak RSS after
+ * Scene release (Spec 0037). Explicit CODEGRAPH_PARSE_WORKERS still wins when set.
+ *
+ * - unset: true iff root `build-profile.json5` exists
+ * - `HOMEGRAPH_HARMONY_SERIAL=0`/`false`: never
+ * - `HOMEGRAPH_HARMONY_SERIAL=1`/`true`: always
+ */
+export declare function preferHarmonySerialIndexing(rootDir: string): boolean;
 /** One PROJECT module from root `build-profile.json5`. */
 export interface HarmonyModuleRef {
     name: string;
@@ -63,19 +73,38 @@ export declare function normalizeHarmonyModuleSrcPath(srcPath: string): string;
  */
 export declare function listHarmonyProjectModules(rootDir: string): HarmonyModuleRef[];
 /**
- * Nearest package-like directory for an orphan Ark source, or the first path
- * segment. Never returns the project root (registering `.` would re-scan every
- * Harmony module). Lone files directly under the root return null.
+ * True when registering `srcPath` as a synthetic PROJECT would re-load real
+ * Harmony modules: exact path collision, or a parent of existing `srcPath`s
+ * (e.g. synthetic `feature/` swallowing `feature/appcenter`).
  */
-export declare function findSyntheticArkModuleRoot(rootDir: string, relFile: string): string | null;
+export declare function syntheticRootConflictsWithHarmonyModules(srcPath: string, modules: readonly HarmonyModuleRef[]): boolean;
+/**
+ * Nearest **Node** `package.json` directory for an orphan Ark/TS source.
+ * Never returns the project root (registering `.` would re-scan every Harmony
+ * module). Lone files directly under the root return null.
+ *
+ * Only `package.json` counts — not `oh-package.json5`. Forgotten Harmony HARs
+ * left out of root `build-profile.json5` (scene_board `feature/visionglass`
+ * etc.) often declare heavy `file:`/`../` deps on modules already indexed as
+ * real PROJECT modules; registering them as synthetic PROJECT→BODIES reloads
+ * those deps into ModuleCache and spikes wall time + RSS for almost no unique
+ * coverage. Those orphans fall through to tree-sitter instead.
+ *
+ * When `harmonyModules` is provided, skips roots that would swallow those
+ * modules (e.g. a plugin under `feature/intelligent` must not become
+ * `synthetic:feature/` and re-BODIES the whole `feature/` tree).
+ */
+export declare function findSyntheticArkModuleRoot(rootDir: string, relFile: string, harmonyModules?: readonly HarmonyModuleRef[]): string | null;
 /**
  * ArkAnalyzer sources under `scannedFiles` that are not inside any
  * build-profile PROJECT module `srcPath`.
  */
 export declare function listOrphanArkAnalyzerSources(scannedFiles: Iterable<string>, harmonyModules: HarmonyModuleRef[]): string[];
 /**
- * Cluster orphan `.ets`/`.ts`/`.d.ts` into synthetic PROJECT module roots
- * (e.g. `HMRouterPlugin` for a Node hvigor plugin living beside HAP modules).
+ * Cluster orphan `.ets`/`.ts`/`.d.ts` into synthetic PROJECT module roots for
+ * Node-style packages only (`package.json`, e.g. HMRouterPlugin). Harmony
+ * `oh-package.json5` trees omitted from build-profile are not registered —
+ * analyseByModule would re-SIGNATURES their monorepo deps at high RSS cost.
  */
 export declare function listSyntheticArkModuleRoots(rootDir: string, scannedFiles: Iterable<string>, harmonyModules?: HarmonyModuleRef[]): HarmonyModuleRef[];
 export type DirtyHarmonyModuleResolution = {
@@ -273,7 +302,11 @@ export interface BindOhosApiDbOptions extends EnsureOhosApiDbOptions {
 /** Prefix applied to API db node file paths so explore can render without disk reads. */
 export declare function markOhosApiFilePath(relativePath: string): string;
 export declare function isOhosApiFilePath(filePath: string): boolean;
-/** Strip json5 comments/trailing commas enough for compileSdkVersion extraction. */
+/**
+ * DevEco / Harmony JSON5 subset → JSON.parse.
+ * Supports: line/block comments, trailing commas, bare keys, single-quoted strings
+ * (e.g. deviceTypes: ['phone', '2in1']). Not a full JSON5 implementation.
+ */
 export declare function parseJson5Minimal(text: string): unknown;
 /** Normalize compileSdkVersion values like "6.0.1(21)" → "6.0.1". */
 export declare function normalizeOhosApiVersion(raw: unknown): string | null;