homegraph 1.5.10 → 1.6.0

package/dist/project-map/index.d.ts

@@ -30,4 +30,49 @@ export interface BuiltProjectMap {
  */
 export declare function buildProjectMapScan(projectRoot: string): BuiltProjectMap;
 export declare function parseBuildPhase(raw: string | null | undefined): BuildPhase | null;
+/**
+ * Spec 0040 — optional bundleName/name from app.json5 (AppScope or root).
+ * Best-effort; returns null on missing/parse failure.
+ */
+export declare function readHarmonyAppBundleName(projectRoot: string): string | null;
+/**
+ * Spec 0040 — project-relative paths to Spec 0039 route profile JSON under a module root.
+ */
+export declare function listHarmonyRouteProfilesUnderModule(projectRoot: string, moduleRootPath: string, cap?: number): string[];
+/** Spec 0040 — oh-package name at module root, if any. */
+export declare function readModuleOhPackageName(projectRoot: string, moduleRootPath: string): string | null;
+/** Spec 0042 B — path-only Harmony resource inventory (no parse, no edges). */
+export interface HarmonyResourceInventory {
+    stringJson: string[];
+    rawfiles: string[];
+    mediaDirs: Array<{
+        dir: string;
+        countsByExt: Record<string, number>;
+    }>;
+    /** Spec 0048 — form_config.json / shortcuts_config.json paths. */
+    capabilityProfiles: string[];
+    unindexedDirs: Array<{
+        path: string;
+        reason: string;
+    }>;
+    truncated: boolean;
+}
+/**
+ * Bounded walk: whitelist paths under `resources/…` plus package dirs with zero
+ * indexed sources. Does not read JSON bodies or media bytes.
+ */
+export declare function scanHarmonyResourceInventory(projectRoot: string, options?: {
+    indexedPaths?: Iterable<string>;
+}): HarmonyResourceInventory;
+/** Markdown section for Spec 0042 B (empty string when nothing to show). */
+export declare function formatHarmonyResourceInventory(inv: HarmonyResourceInventory): string;
+/**
+ * Spec 0048 §4 — module roster with oh-package name + local file: deps.
+ */
+export declare function formatHarmonyModuleRoster(projectRoot: string, modules: Array<{
+    name: string;
+    rootPath: string;
+    kind: string;
+    fileCount: number;
+}>, maxRows?: number): string;
 //# sourceMappingURL=index.d.ts.map

package/dist/project-map/index.js

@@ -41,6 +41,12 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildProjectMapScan = buildProjectMapScan;
 exports.parseBuildPhase = parseBuildPhase;
+exports.readHarmonyAppBundleName = readHarmonyAppBundleName;
+exports.listHarmonyRouteProfilesUnderModule = listHarmonyRouteProfilesUnderModule;
+exports.readModuleOhPackageName = readModuleOhPackageName;
+exports.scanHarmonyResourceInventory = scanHarmonyResourceInventory;
+exports.formatHarmonyResourceInventory = formatHarmonyResourceInventory;
+exports.formatHarmonyModuleRoster = formatHarmonyModuleRoster;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const extraction_1 = require("../extraction");
@@ -178,9 +184,19 @@ function discoverOhpmPackages(projectRoot) {
 }
 function readOhpmName(manifestAbs) {
     try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const parsed = require('jsonc-parser').parse(fs.readFileSync(manifestAbs, 'utf-8'));
-        return typeof parsed?.name === 'string' && parsed.name.trim() ? parsed.name.trim() : null;
+        const text = fs.readFileSync(manifestAbs, 'utf-8');
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const parsed = require('jsonc-parser').parse(text);
+            if (typeof parsed?.name === 'string' && parsed.name.trim())
+                return parsed.name.trim();
+        }
+        catch {
+            /* regex */
+        }
+        const m = text.match(/["']name["']\s*:\s*["']([^"']+)["']/) ||
+            text.match(/name\s*:\s*["']([^"']+)["']/);
+        return m?.[1]?.trim() || null;
     }
     catch {
         return null;
@@ -217,4 +233,356 @@ function parseBuildPhase(raw) {
     }
     return null;
 }
+const SKELETON_SKIP_DIRS = new Set([
+    'node_modules',
+    'oh_modules',
+    '.git',
+    '.homegraph',
+    '.hvigor',
+    '.preview',
+    'build',
+    'dist',
+    'out',
+    '.cxx',
+]);
+const ROUTE_PROFILE_WALK_MAX_DEPTH = 8;
+const ROUTE_PROFILE_DIR_BUDGET = 400;
+const ROUTE_PROFILE_CAP_PER_MODULE = 8;
+/**
+ * Spec 0040 — optional bundleName/name from app.json5 (AppScope or root).
+ * Best-effort; returns null on missing/parse failure.
+ */
+function readHarmonyAppBundleName(projectRoot) {
+    for (const rel of ['AppScope/app.json5', 'app.json5']) {
+        const abs = path.join(projectRoot, rel);
+        if (!fs.existsSync(abs))
+            continue;
+        try {
+            const text = fs.readFileSync(abs, 'utf-8');
+            let bundle = null;
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                const parsed = require('jsonc-parser').parse(text);
+                if (parsed?.app && typeof parsed.app.bundleName === 'string' && parsed.app.bundleName.trim()) {
+                    bundle = parsed.app.bundleName.trim();
+                }
+                else if (typeof parsed?.bundleName === 'string' && parsed.bundleName.trim()) {
+                    bundle = parsed.bundleName.trim();
+                }
+                else if (typeof parsed?.name === 'string' && parsed.name.trim()) {
+                    bundle = parsed.name.trim();
+                }
+            }
+            catch {
+                /* regex fallback below */
+            }
+            if (!bundle) {
+                const m = text.match(/["']bundleName["']\s*:\s*["']([^"']+)["']/) ||
+                    text.match(/bundleName\s*:\s*["']([^"']+)["']/);
+                if (m?.[1])
+                    bundle = m[1];
+            }
+            if (bundle)
+                return bundle;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+/**
+ * Spec 0040 — project-relative paths to Spec 0039 route profile JSON under a module root.
+ */
+function listHarmonyRouteProfilesUnderModule(projectRoot, moduleRootPath, cap = ROUTE_PROFILE_CAP_PER_MODULE) {
+    const rootAbs = path.resolve(projectRoot);
+    const modAbs = moduleRootPath
+        ? path.resolve(projectRoot, moduleRootPath)
+        : rootAbs;
+    if (!fs.existsSync(modAbs))
+        return [];
+    const found = [];
+    const queue = [{ abs: modAbs, depth: 0 }];
+    let visited = 0;
+    while (queue.length > 0 && found.length < cap) {
+        const { abs, depth } = queue.shift();
+        if (++visited > ROUTE_PROFILE_DIR_BUDGET)
+            break;
+        let entries;
+        try {
+            entries = fs.readdirSync(abs, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            if (found.length >= cap)
+                break;
+            const child = path.join(abs, e.name);
+            if (e.isDirectory()) {
+                if (depth >= ROUTE_PROFILE_WALK_MAX_DEPTH)
+                    continue;
+                if (e.name.startsWith('.') || SKELETON_SKIP_DIRS.has(e.name))
+                    continue;
+                queue.push({ abs: child, depth: depth + 1 });
+                continue;
+            }
+            if (!e.isFile())
+                continue;
+            const rel = path.relative(rootAbs, child).replace(/\\/g, '/');
+            if ((0, grammars_1.isHarmonyRouteProfileJson)(rel))
+                found.push(rel);
+        }
+    }
+    return found.sort();
+}
+/** Spec 0040 — oh-package name at module root, if any. */
+function readModuleOhPackageName(projectRoot, moduleRootPath) {
+    const abs = path.join(projectRoot, moduleRootPath || '.', OHPM_MANIFEST);
+    return readOhpmName(abs);
+}
+const RESOURCE_WALK_MAX_DEPTH = 14;
+const RESOURCE_DIR_BUDGET = 4000;
+const RESOURCE_STRING_CAP = 24;
+const RESOURCE_RAWFILE_CAP = 40;
+const RESOURCE_MEDIA_DIR_CAP = 24;
+const RESOURCE_UNINDEXED_CAP = 16;
+const RESOURCE_CAPABILITY_CAP = 16;
+const RESOURCE_CONFIG_BASENAMES = new Set([
+    'shortcuts_config.json',
+    'form_config.json',
+]);
+/**
+ * Bounded walk: whitelist paths under `resources/…` plus package dirs with zero
+ * indexed sources. Does not read JSON bodies or media bytes.
+ */
+function scanHarmonyResourceInventory(projectRoot, options) {
+    const rootAbs = path.resolve(projectRoot);
+    const out = {
+        stringJson: [],
+        rawfiles: [],
+        mediaDirs: [],
+        capabilityProfiles: [],
+        unindexedDirs: [],
+        truncated: false,
+    };
+    if (!fs.existsSync(rootAbs))
+        return out;
+    const indexed = new Set();
+    for (const p of options?.indexedPaths ?? []) {
+        indexed.add(p.replace(/\\/g, '/'));
+    }
+    const mediaCounts = new Map();
+    const packageDirs = new Map();
+    const queue = [{ abs: rootAbs, depth: 0 }];
+    let visited = 0;
+    while (queue.length > 0) {
+        const { abs, depth } = queue.shift();
+        if (++visited > RESOURCE_DIR_BUDGET) {
+            out.truncated = true;
+            break;
+        }
+        let entries;
+        try {
+            entries = fs.readdirSync(abs, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const child = path.join(abs, e.name);
+            const rel = path.relative(rootAbs, child).replace(/\\/g, '/');
+            if (e.isDirectory()) {
+                if (depth >= RESOURCE_WALK_MAX_DEPTH)
+                    continue;
+                if (e.name.startsWith('.') || SKELETON_SKIP_DIRS.has(e.name))
+                    continue;
+                queue.push({ abs: child, depth: depth + 1 });
+                continue;
+            }
+            if (!e.isFile() || !rel || rel.startsWith('..'))
+                continue;
+            if (/(?:^|\/)resources\/(?:[^/]+\/)*element\/string\.json$/i.test(rel)) {
+                if (out.stringJson.length < RESOURCE_STRING_CAP)
+                    out.stringJson.push(rel);
+                else
+                    out.truncated = true;
+                continue;
+            }
+            if (/(?:^|\/)resources\/(?:[^/]+\/)*rawfile\//i.test(rel)) {
+                if (out.rawfiles.length < RESOURCE_RAWFILE_CAP)
+                    out.rawfiles.push(rel);
+                else
+                    out.truncated = true;
+                continue;
+            }
+            const mediaMatch = rel.match(/^(.*?\/resources\/(?:[^/]+\/)*(?:base\/)?media)\/[^/]+$/i);
+            if (mediaMatch) {
+                const dir = mediaMatch[1].replace(/\\/g, '/');
+                const ext = path.extname(rel).slice(1).toLowerCase() || 'bin';
+                const counts = mediaCounts.get(dir) ?? {};
+                counts[ext] = (counts[ext] ?? 0) + 1;
+                mediaCounts.set(dir, counts);
+                continue;
+            }
+            const base = rel.split('/').pop()?.toLowerCase() ?? '';
+            if (RESOURCE_CONFIG_BASENAMES.has(base)) {
+                if (out.capabilityProfiles.length < RESOURCE_CAPABILITY_CAP) {
+                    if (!out.capabilityProfiles.includes(rel))
+                        out.capabilityProfiles.push(rel);
+                }
+                else {
+                    out.truncated = true;
+                }
+                continue;
+            }
+            if (base === 'oh-package.json5' || base === 'module.json5') {
+                const dirRel = rel.includes('/') ? rel.slice(0, rel.lastIndexOf('/')) : '';
+                const cur = packageDirs.get(dirRel) ?? { hasOhpm: false, hasModule: false };
+                if (base === 'oh-package.json5')
+                    cur.hasOhpm = true;
+                else
+                    cur.hasModule = true;
+                packageDirs.set(dirRel, cur);
+            }
+        }
+    }
+    for (const [dir, counts] of [...mediaCounts.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+        if (out.mediaDirs.length >= RESOURCE_MEDIA_DIR_CAP) {
+            out.truncated = true;
+            break;
+        }
+        out.mediaDirs.push({ dir, countsByExt: counts });
+    }
+    out.stringJson.sort((a, b) => a.localeCompare(b));
+    out.rawfiles.sort((a, b) => a.localeCompare(b));
+    out.capabilityProfiles.sort((a, b) => a.localeCompare(b));
+    // Unindexed package/module dirs: on disk but no indexed source under them.
+    for (const [dirRel, flags] of [...packageDirs.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+        if (out.unindexedDirs.length >= RESOURCE_UNINDEXED_CAP) {
+            out.truncated = true;
+            break;
+        }
+        if (!dirRel)
+            continue; // project root always "indexed" via map
+        const prefix = `${dirRel}/`;
+        const hasIndexed = [...indexed].some((p) => p === dirRel || p.startsWith(prefix));
+        if (hasIndexed)
+            continue;
+        // Skip pure resource-only package markers under resources/ (not a module root).
+        if (/(?:^|\/)resources\//i.test(dirRel))
+            continue;
+        const reason = flags.hasOhpm
+            ? 'oh-package.json5 present; 0 indexed source files'
+            : 'module.json5 present; 0 indexed source files';
+        out.unindexedDirs.push({ path: dirRel, reason });
+    }
+    return out;
+}
+/** Markdown section for Spec 0042 B (empty string when nothing to show). */
+function formatHarmonyResourceInventory(inv) {
+    const lines = [];
+    const hasResources = inv.stringJson.length > 0
+        || inv.rawfiles.length > 0
+        || inv.mediaDirs.length > 0
+        || inv.capabilityProfiles.length > 0;
+    if (hasResources) {
+        lines.push('### HarmonyOS resources');
+        if (inv.stringJson.length) {
+            const shown = inv.stringJson.slice(0, 12);
+            lines.push(`- string.json (${inv.stringJson.length}): ${shown.map((p) => `\`${p}\``).join(', ')}`
+                + (inv.stringJson.length > shown.length ? `, +${inv.stringJson.length - shown.length} more` : ''));
+        }
+        if (inv.capabilityProfiles.length) {
+            const shown = inv.capabilityProfiles.slice(0, 12);
+            lines.push(`- capability profiles (${inv.capabilityProfiles.length}): ${shown.map((p) => `\`${p}\``).join(', ')}`
+                + (inv.capabilityProfiles.length > shown.length
+                    ? `, +${inv.capabilityProfiles.length - shown.length} more`
+                    : ''));
+        }
+        if (inv.rawfiles.length) {
+            const shown = inv.rawfiles.slice(0, 12);
+            lines.push(`- rawfile (${inv.rawfiles.length}): ${shown.map((p) => `\`${p}\``).join(', ')}`
+                + (inv.rawfiles.length > shown.length ? `, +${inv.rawfiles.length - shown.length} more` : ''));
+        }
+        for (const m of inv.mediaDirs.slice(0, 8)) {
+            const counts = Object.entries(m.countsByExt)
+                .sort((a, b) => a[0].localeCompare(b[0]))
+                .map(([ext, n]) => `${ext}=${n}`)
+                .join(', ');
+            lines.push(`- media: \`${m.dir}\`${counts ? ` (${counts})` : ''}`);
+        }
+        if (inv.mediaDirs.length > 8) {
+            lines.push(`- media: … +${inv.mediaDirs.length - 8} more dirs`);
+        }
+    }
+    if (inv.unindexedDirs.length) {
+        if (lines.length)
+            lines.push('');
+        lines.push('### On disk, not in graph');
+        for (const u of inv.unindexedDirs) {
+            lines.push(`- \`${u.path}/\` (${u.reason})`);
+        }
+    }
+    if (inv.truncated) {
+        lines.push('');
+        lines.push('_resource inventory truncated (bounded walk)_');
+    }
+    return lines.join('\n');
+}
+function readOhpmLocalDeps(manifestAbs, cap = 8) {
+    try {
+        const text = fs.readFileSync(manifestAbs, 'utf-8');
+        let deps;
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const parsed = require('jsonc-parser').parse(text);
+            deps = parsed?.dependencies;
+        }
+        catch {
+            deps = undefined;
+        }
+        if (!deps || typeof deps !== 'object')
+            return [];
+        const out = [];
+        for (const [name, ver] of Object.entries(deps)) {
+            if (out.length >= cap)
+                break;
+            if (typeof ver !== 'string')
+                continue;
+            if (!/^(file:|\.\.?\/)/i.test(ver.trim()))
+                continue;
+            out.push(`\`${name}\` (${ver.trim()})`);
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Spec 0048 §4 — module roster with oh-package name + local file: deps.
+ */
+function formatHarmonyModuleRoster(projectRoot, modules, maxRows = 24) {
+    const rows = [];
+    for (const m of modules) {
+        if (rows.length >= maxRows)
+            break;
+        if (m.kind === 'root' && !m.rootPath)
+            continue;
+        const rootLabel = m.rootPath || '.';
+        const ohpmAbs = path.join(projectRoot, m.rootPath || '.', OHPM_MANIFEST);
+        const pkg = readOhpmName(ohpmAbs);
+        const localDeps = readOhpmLocalDeps(ohpmAbs);
+        let line = `- \`${m.name}\` (\`${rootLabel}\`) · ${m.kind} · ${m.fileCount} files`;
+        if (pkg)
+            line += ` · oh-package \`${pkg}\``;
+        if (localDeps.length)
+            line += ` · deps: ${localDeps.join(', ')}`;
+        rows.push(line);
+    }
+    if (rows.length === 0)
+        return '';
+    return ['### Module roster', ...rows].join('\n');
+}
 //# sourceMappingURL=index.js.map