@yalehwang/archguard 0.1.23 → 0.1.31

package/dist/core/query/arch-metrics.js

@@ -0,0 +1,42 @@
+import { ExtensionAccessor } from './extension-accessor.js';
+import { StructureMetrics, } from './arch-metrics-structure.js';
+import { QualityMetrics } from './arch-metrics-quality.js';
+import { CognitiveMetrics } from './arch-metrics-cognitive.js';
+export class ArchMetrics {
+    archJson;
+    index;
+    structure;
+    quality;
+    cognitive;
+    constructor(archJson, index, extensionAccessor) {
+        this.archJson = archJson;
+        this.index = index;
+        const entityMap = new Map(archJson.entities.map((e) => [e.id, e]));
+        const ext = extensionAccessor ?? new ExtensionAccessor(archJson);
+        this.structure = new StructureMetrics(archJson, index, ext, entityMap);
+        this.quality = new QualityMetrics(archJson, ext);
+        this.cognitive = new CognitiveMetrics(archJson, index, ext, this.structure);
+    }
+    getSummary() {
+        return this.cognitive.getSummary();
+    }
+    getPackageStats(depth = 2, topN) {
+        return this.structure.getPackageStats(depth, topN);
+    }
+    getPackageCoverage() {
+        return this.quality.getPackageCoverage();
+    }
+    getEntityCoverage(entityId) {
+        return this.quality.getEntityCoverage(entityId);
+    }
+    findHighCoupling(threshold = 8) {
+        return this.structure.findHighCoupling(threshold);
+    }
+    findOrphans() {
+        return this.structure.findOrphans();
+    }
+    findInCycles() {
+        return this.structure.findInCycles();
+    }
+}
+//# sourceMappingURL=arch-metrics.js.map

package/dist/core/query/arch-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-metrics.js","sourceRoot":"","sources":["../../../src/core/query/arch-metrics.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,gBAAgB,GAIjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAQ/D,MAAM,OAAO,WAAW;IAMH;IACA;IANF,SAAS,CAAmB;IAC5B,OAAO,CAAiB;IACxB,SAAS,CAAmB;IAE7C,YACmB,QAAkB,EAClB,KAAgB,EACjC,iBAAqC;QAFpB,aAAQ,GAAR,QAAQ,CAAU;QAClB,UAAK,GAAL,KAAK,CAAW;QAGjC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAiB,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,GAAG,GAAG,iBAAiB,IAAI,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QACvE,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,GAAG,IAAI,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9E,CAAC;IAED,UAAU;QAWR,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;IAED,eAAe,CAAC,QAAgB,CAAC,EAAE,IAAa;QAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,kBAAkB;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAC3C,CAAC;IAED,iBAAiB,CAAC,QAAgB;QAchC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,gBAAgB,CAAC,YAAoB,CAAC;QACpC,OAAO,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IACtC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;IACvC,CAAC;CACF"}

package/dist/core/query/edge-list-serializer.d.ts

@@ -0,0 +1,4 @@
+import type { Entity, Relation } from '../../types/index.js';
+import type { OutputScope, EdgeListOutput } from './query-engine.js';
+export declare function serialize(entities: Partial<Entity>[], relations: Relation[], outputScope: OutputScope): EdgeListOutput;
+//# sourceMappingURL=edge-list-serializer.d.ts.map

package/dist/core/query/edge-list-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-list-serializer.d.ts","sourceRoot":"","sources":["../../../src/core/query/edge-list-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAkB,MAAM,mBAAmB,CAAC;AAErF,wBAAgB,SAAS,CACvB,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAC3B,SAAS,EAAE,QAAQ,EAAE,EACrB,WAAW,EAAE,WAAW,GACvB,cAAc,CAyBhB"}

package/dist/core/query/edge-list-serializer.js

@@ -0,0 +1,24 @@
+export function serialize(entities, relations, outputScope) {
+    const serializedEntities = entities.map((e) => ({
+        id: e.id ?? '',
+        name: e.name ?? '',
+        type: e.type ?? '',
+        sourceFile: e.sourceLocation?.file ?? 'unknown',
+        methods: outputScope === 'method'
+            ? (e.members ?? [])
+                .filter((m) => m.type === 'method' || m.type === 'constructor')
+                .map((m) => ({
+                name: m.name,
+                params: (m.parameters ?? []).map((p) => ({ name: p.name, type: p.type })),
+                returnType: m.returnType ?? 'void',
+            }))
+            : [],
+    }));
+    const serializedRelations = relations.map((r) => ({
+        from: r.source,
+        to: r.target,
+        type: r.type,
+    }));
+    return { entities: serializedEntities, relations: serializedRelations };
+}
+//# sourceMappingURL=edge-list-serializer.js.map

package/dist/core/query/edge-list-serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-list-serializer.js","sourceRoot":"","sources":["../../../src/core/query/edge-list-serializer.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,SAAS,CACvB,QAA2B,EAC3B,SAAqB,EACrB,WAAwB;IAExB,MAAM,kBAAkB,GAAqB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;QAClB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;QAClB,UAAU,EAAE,CAAC,CAAC,cAAc,EAAE,IAAI,IAAI,SAAS;QAC/C,OAAO,EACL,WAAW,KAAK,QAAQ;YACtB,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC;iBACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC;iBAC9D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACX,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;gBACzE,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,MAAM;aACnC,CAAC,CAAC;YACP,CAAC,CAAC,EAAE;KACT,CAAC,CAAC,CAAC;IAEJ,MAAM,mBAAmB,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,EAAE,CAAC,CAAC,MAAM;QACd,EAAE,EAAE,CAAC,CAAC,MAAM;QACZ,IAAI,EAAE,CAAC,CAAC,IAAI;KACb,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC;AAC1E,CAAC"}

package/dist/core/query/entity-query-service.d.ts

@@ -0,0 +1,15 @@
+import type { ArchJSON, Entity } from '../../types/index.js';
+import type { ArchIndex } from './arch-index.js';
+export declare class EntityQueryService {
+    private readonly archJson;
+    private readonly index;
+    private readonly entityMap;
+    constructor(archJson: ArchJSON, index: ArchIndex);
+    findEntity(name: string): Entity[];
+    findByType(entityType: string): Entity[];
+    findByAttr(key: string, value?: string | number | boolean): Entity[];
+    findByTypeAndAttr(entityType: string, attrKey?: string, attrValue?: string | number | boolean): Entity[];
+    getFileEntities(filePath: string): Entity[];
+    getById(id: string): Entity | undefined;
+}
+//# sourceMappingURL=entity-query-service.d.ts.map

package/dist/core/query/entity-query-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-query-service.d.ts","sourceRoot":"","sources":["../../../src/core/query/entity-query-service.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;gBAG7B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,SAAS;IAMnC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IAMlC,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAUxC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE;IAepE,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GACpC,MAAM,EAAE;IAWX,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAM3C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGxC"}

package/dist/core/query/entity-query-service.js

@@ -0,0 +1,51 @@
+export class EntityQueryService {
+    archJson;
+    index;
+    entityMap;
+    constructor(archJson, index) {
+        this.archJson = archJson;
+        this.index = index;
+        this.entityMap = new Map(archJson.entities.map((e) => [e.id, e]));
+    }
+    findEntity(name) {
+        const ids = this.index.nameToIds[name] ?? [];
+        return ids.map((id) => this.entityMap.get(id)).filter(Boolean);
+    }
+    findByType(entityType) {
+        return this.archJson.entities.filter((e) => {
+            if (entityType === 'abstract_class') {
+                return e.type === 'abstract_class' || (e.isAbstract && e.type === 'class');
+            }
+            return e.type === entityType;
+        });
+    }
+    findByAttr(key, value) {
+        return this.archJson.entities.filter((e) => {
+            if (!e.attributes)
+                return false;
+            if (value === undefined)
+                return key in e.attributes;
+            return e.attributes[key] === value;
+        });
+    }
+    findByTypeAndAttr(entityType, attrKey, attrValue) {
+        const base = this.findByType(entityType);
+        return base.filter((e) => {
+            if (!attrKey)
+                return true;
+            if (!e.attributes)
+                return false;
+            if (attrValue === undefined)
+                return attrKey in e.attributes;
+            return e.attributes[attrKey] === attrValue;
+        });
+    }
+    getFileEntities(filePath) {
+        const ids = this.index.fileToIds[filePath] ?? [];
+        return ids.map((id) => this.entityMap.get(id)).filter(Boolean);
+    }
+    getById(id) {
+        return this.entityMap.get(id);
+    }
+}
+//# sourceMappingURL=entity-query-service.js.map

package/dist/core/query/entity-query-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-query-service.js","sourceRoot":"","sources":["../../../src/core/query/entity-query-service.ts"],"names":[],"mappings":"AAaA,MAAM,OAAO,kBAAkB;IAIV;IACA;IAJF,SAAS,CAAsB;IAEhD,YACmB,QAAkB,EAClB,KAAgB;QADhB,aAAQ,GAAR,QAAQ,CAAU;QAClB,UAAK,GAAL,KAAK,CAAW;QAEjC,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,CAAC;IAGD,UAAU,CAAC,IAAY;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IAGD,UAAU,CAAC,UAAkB;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACzC,IAAI,UAAU,KAAK,gBAAgB,EAAE,CAAC;gBACpC,OAAO,CAAC,CAAC,IAAI,KAAK,gBAAgB,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YAC7E,CAAC;YACD,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAGD,UAAU,CAAC,GAAW,EAAE,KAAiC;QACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACzC,IAAI,CAAC,CAAC,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAC;YAChC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC;YACpD,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IASD,iBAAiB,CACf,UAAkB,EAClB,OAAgB,EAChB,SAAqC;QAErC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACvB,IAAI,CAAC,OAAO;gBAAE,OAAO,IAAI,CAAC;YAC1B,IAAI,CAAC,CAAC,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAC;YAChC,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,OAAO,IAAI,CAAC,CAAC,UAAU,CAAC;YAC5D,OAAO,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAGD,eAAe,CAAC,QAAgB;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjE,CAAC;IAGD,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/core/query/extension-accessor.d.ts

@@ -0,0 +1,15 @@
+import type { ArchJSON, Relation } from '../../types/index.js';
+import type { GoAtlasLayers } from '../../types/extensions/go-atlas.js';
+import type { TestAnalysis } from '../../types/extensions/test-analysis.js';
+export declare class ExtensionAccessor {
+    private readonly archJson;
+    constructor(archJson: ArchJSON);
+    getAtlasLayer<K extends keyof GoAtlasLayers>(layer: K): GoAtlasLayers[K] | undefined;
+    getAtlasLayers(): GoAtlasLayers | undefined;
+    hasAtlasExtension(): boolean;
+    getTestAnalysis(): TestAnalysis | undefined;
+    hasTestAnalysis(): boolean;
+    getRelations(): readonly Relation[];
+    getEntityIds(): string[];
+}
+//# sourceMappingURL=extension-accessor.d.ts.map

package/dist/core/query/extension-accessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-accessor.d.ts","sourceRoot":"","sources":["../../../src/core/query/extension-accessor.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAExE,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAG/C,aAAa,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS;IAKpF,cAAc,IAAI,aAAa,GAAG,SAAS;IAK3C,iBAAiB,IAAI,OAAO;IAK5B,eAAe,IAAI,YAAY,GAAG,SAAS;IAK3C,eAAe,IAAI,OAAO;IAK1B,YAAY,IAAI,SAAS,QAAQ,EAAE;IAKnC,YAAY,IAAI,MAAM,EAAE;CAGzB"}

package/dist/core/query/extension-accessor.js

@@ -0,0 +1,28 @@
+export class ExtensionAccessor {
+    archJson;
+    constructor(archJson) {
+        this.archJson = archJson;
+    }
+    getAtlasLayer(layer) {
+        return this.archJson.extensions?.goAtlas?.layers?.[layer];
+    }
+    getAtlasLayers() {
+        return this.archJson.extensions?.goAtlas?.layers;
+    }
+    hasAtlasExtension() {
+        return !!this.archJson.extensions?.goAtlas;
+    }
+    getTestAnalysis() {
+        return this.archJson.extensions?.testAnalysis;
+    }
+    hasTestAnalysis() {
+        return this.archJson.extensions?.testAnalysis !== undefined;
+    }
+    getRelations() {
+        return this.archJson.relations;
+    }
+    getEntityIds() {
+        return this.archJson.entities.map((e) => e.id);
+    }
+}
+//# sourceMappingURL=extension-accessor.js.map

package/dist/core/query/extension-accessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-accessor.js","sourceRoot":"","sources":["../../../src/core/query/extension-accessor.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,QAAkB;QAAlB,aAAQ,GAAR,QAAQ,CAAU;IAAG,CAAC;IAGnD,aAAa,CAAgC,KAAQ;QACnD,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC;IAGD,cAAc;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC;IACnD,CAAC;IAGD,iBAAiB;QACf,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7C,CAAC;IAGD,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAChD,CAAC;IAGD,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,KAAK,SAAS,CAAC;IAC9D,CAAC;IAGD,YAAY;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;IACjC,CAAC;IAGD,YAAY;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/core/query/index.d.ts

@@ -0,0 +1,8 @@
+export { ARCH_INDEX_VERSION } from './arch-index.js';
+export type { ArchIndex } from './arch-index.js';
+export { buildArchIndex } from './arch-index-builder.js';
+export { QueryEngine } from './query-engine.js';
+export type { EntitySummary, PackageStatEntry, PackageStatMeta, PackageStatsResult, QueryEngineOptions, } from './query-engine.js';
+export * from './arch-metrics.js';
+export { RelationQueryService } from './relation-query-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/query/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/core/query/index.js

@@ -0,0 +1,6 @@
+export { ARCH_INDEX_VERSION } from './arch-index.js';
+export { buildArchIndex } from './arch-index-builder.js';
+export { QueryEngine } from './query-engine.js';
+export * from './arch-metrics.js';
+export { RelationQueryService } from './relation-query-service.js';
+//# sourceMappingURL=index.js.map

package/dist/core/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/query/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShD,cAAc,mBAAmB,CAAC;AAElC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/core/query/output-scope-filter.d.ts

@@ -0,0 +1,6 @@
+import type { Entity, Relation } from '../../types/index.js';
+import type { OutputScope } from './query-engine.js';
+export declare function narrowEntity(entity: Entity, scope: OutputScope): Partial<Entity>;
+export declare function narrowEntities(entities: readonly Entity[], scope: OutputScope): Partial<Entity>[];
+export declare function filterRelationsForScope(relations: readonly Relation[], scope: OutputScope): Relation[];
+//# sourceMappingURL=output-scope-filter.d.ts.map

package/dist/core/query/output-scope-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-scope-filter.d.ts","sourceRoot":"","sources":["../../../src/core/query/output-scope-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAehF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,CAEjG;AAUD,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,KAAK,EAAE,WAAW,GACjB,QAAQ,EAAE,CA6BZ"}

package/dist/core/query/output-scope-filter.js

@@ -0,0 +1,45 @@
+export function narrowEntity(entity, scope) {
+    if (scope === 'method')
+        return entity;
+    if (scope === 'class') {
+        const { members: _m, ...rest } = entity;
+        return rest;
+    }
+    return {
+        id: entity.id,
+        name: entity.name,
+        type: entity.type,
+        sourceLocation: { file: entity.sourceLocation.file, startLine: 0, endLine: 0 },
+    };
+}
+export function narrowEntities(entities, scope) {
+    return entities.map((e) => narrowEntity(e, scope));
+}
+export function filterRelationsForScope(relations, scope) {
+    if (scope === 'package') {
+        return relations.filter((r) => r.type !== 'call');
+    }
+    if (scope === 'class') {
+        const callEdges = relations.filter((r) => r.type === 'call');
+        const nonCallEdges = relations.filter((r) => r.type !== 'call');
+        const existingDeps = new Set(nonCallEdges.filter((r) => r.type === 'dependency').map((r) => `${r.source}:${r.target}`));
+        const aggregated = [];
+        const seen = new Set();
+        for (const edge of callEdges) {
+            const key = `${edge.source}:${edge.target}`;
+            if (!existingDeps.has(key) && !seen.has(key)) {
+                seen.add(key);
+                aggregated.push({
+                    id: `call-aggregated:${edge.source}:${edge.target}`,
+                    type: 'dependency',
+                    source: edge.source,
+                    target: edge.target,
+                    inferenceSource: 'call-aggregated',
+                });
+            }
+        }
+        return [...nonCallEdges, ...aggregated];
+    }
+    return [...relations];
+}
+//# sourceMappingURL=output-scope-filter.js.map

package/dist/core/query/output-scope-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-scope-filter.js","sourceRoot":"","sources":["../../../src/core/query/output-scope-filter.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,KAAkB;IAC7D,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAEtC,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE;KAC/E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAA2B,EAAE,KAAkB;IAC5E,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACrD,CAAC;AAUD,MAAM,UAAU,uBAAuB,CACrC,SAA8B,EAC9B,KAAkB;IAElB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAC7D,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAChE,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAC1F,CAAC;QACF,MAAM,UAAU,GAAe,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACd,UAAU,CAAC,IAAI,CAAC;oBACd,EAAE,EAAE,mBAAmB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE;oBACnD,IAAI,EAAE,YAAY;oBAClB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,eAAe,EAAE,iBAAiB;iBACnC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,YAAY,EAAE,GAAG,UAAU,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;AACxB,CAAC"}

package/dist/core/query/query-engine.d.ts

@@ -0,0 +1,116 @@
+import type { ArchJSON, Entity, RelationType, CycleInfo } from '../../types/index.js';
+import type { ArchIndex } from './arch-index.js';
+import type { QueryScopeEntry } from '../../cli/query/query-manifest.js';
+import type { PackageCoverage, TestFileInfo } from '../../types/extensions/test-analysis.js';
+import { RelationQueryService } from './relation-query-service.js';
+export type { PackageStatEntry, PackageStatMeta, PackageStatsResult } from './arch-metrics.js';
+export interface EntitySummary {
+    id: string;
+    name: string;
+    type: string;
+    visibility: string;
+    file: string;
+    methodCount: number;
+    fieldCount: number;
+}
+export interface QueryEngineOptions {
+    archJson: ArchJSON;
+    archIndex: ArchIndex;
+    scopeEntry: QueryScopeEntry;
+}
+export type OutputScope = 'package' | 'class' | 'method';
+export type QueryOutputFormat = 'structured' | 'edge-list';
+export interface QueryMethodOptions {
+    outputScope?: OutputScope;
+    queryFormat?: QueryOutputFormat;
+}
+export interface EdgeListEntity {
+    id: string;
+    name: string;
+    type: string;
+    sourceFile: string;
+    methods: Array<{
+        name: string;
+        params: Array<{
+            name: string;
+            type: string;
+        }>;
+        returnType: string;
+    }>;
+}
+export interface EdgeListRelation {
+    from: string;
+    to: string;
+    type: string;
+}
+export interface EdgeListOutput {
+    entities: EdgeListEntity[];
+    relations: EdgeListRelation[];
+}
+export declare class QueryEngine {
+    private archJson;
+    private index;
+    private scopeEntry;
+    private readonly metrics;
+    private readonly extensionAccessor;
+    private readonly entityQueryService;
+    readonly relationQueryService: RelationQueryService;
+    constructor(options: QueryEngineOptions);
+    findEntity(name: string, options?: QueryMethodOptions): Entity[] | Partial<Entity>[] | EdgeListOutput;
+    getFileEntities(filePath: string, options?: QueryMethodOptions): Entity[] | Partial<Entity>[] | EdgeListOutput;
+    getCycles(): CycleInfo[];
+    getSummary(): {
+        entityCount: number;
+        relationCount: number;
+        language: string;
+        kind: 'parsed' | 'derived';
+        topDependedOn: Array<{
+            name: string;
+            dependentCount: number;
+        }>;
+        topDependedOnNote?: string;
+        capabilities: {
+            classHierarchy: boolean;
+            interfaceImplementation: boolean;
+            packageGraph: boolean;
+            cycleDetection: boolean;
+        };
+        topPackages: import('./arch-metrics.js').PackageStatEntry[];
+        totalPackageCount: number;
+        relationCountByType: Partial<Record<RelationType, number>>;
+        topByMethodCount: Array<{
+            name: string;
+            methodCount: number;
+        }>;
+        topByOutDegree: Array<{
+            name: string;
+            outDegree: number;
+        }>;
+    };
+    findByType(entityType: string, options?: QueryMethodOptions): Entity[] | Partial<Entity>[] | EdgeListOutput;
+    findByAttr(key: string, value?: string | number | boolean, options?: QueryMethodOptions): Entity[] | Partial<Entity>[] | EdgeListOutput;
+    findByTypeAndAttr(entityType: string, attrKey?: string, attrValue?: string | number | boolean, options?: QueryMethodOptions): Entity[] | Partial<Entity>[] | EdgeListOutput;
+    findHighCoupling(threshold?: number): Entity[];
+    findOrphans(): Entity[];
+    findInCycles(): Entity[];
+    applyOutputOptions(entities: Entity[], options?: QueryMethodOptions): Entity[] | Partial<Entity>[] | EdgeListOutput;
+    getScopeEntry(): QueryScopeEntry;
+    getPackageCoverage(): PackageCoverage[];
+    getEntityCoverage(entityId: string): {
+        entityId: string;
+        coverageScore: number;
+        coveredByTestIds: string[];
+        testFileDetails: Array<{
+            id: string;
+            testType: TestFileInfo['testType'];
+            testCaseCount: number;
+            assertionCount: number;
+            assertionDensity: number;
+            frameworks: string[];
+        }>;
+        found: boolean;
+    };
+    getPackageStats(depth?: number, topN?: number): import('./arch-metrics.js').PackageStatsResult;
+    toSummary(entity: Entity): EntitySummary;
+}
+//# sourceMappingURL=query-engine.d.ts.map

package/dist/core/query/query-engine.d.ts.map

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

package/dist/core/query/query-engine.js

@@ -0,0 +1,105 @@
+import { narrowEntities, filterRelationsForScope } from './output-scope-filter.js';
+import { serialize } from './edge-list-serializer.js';
+import { ArchMetrics } from './arch-metrics.js';
+import { ExtensionAccessor } from './extension-accessor.js';
+import { EntityQueryService } from './entity-query-service.js';
+import { RelationQueryService } from './relation-query-service.js';
+export class QueryEngine {
+    archJson;
+    index;
+    scopeEntry;
+    metrics;
+    extensionAccessor;
+    entityQueryService;
+    relationQueryService;
+    constructor(options) {
+        this.archJson = options.archJson;
+        this.index = options.archIndex;
+        this.scopeEntry = options.scopeEntry;
+        this.extensionAccessor = new ExtensionAccessor(options.archJson);
+        this.entityQueryService = new EntityQueryService(options.archJson, options.archIndex);
+        this.relationQueryService = new RelationQueryService(options.archJson, options.archIndex, this.entityQueryService);
+        this.metrics = new ArchMetrics(options.archJson, options.archIndex, this.extensionAccessor);
+    }
+    findEntity(name, options) {
+        return this.applyOutputOptions(this.entityQueryService.findEntity(name), options);
+    }
+    getFileEntities(filePath, options) {
+        return this.applyOutputOptions(this.entityQueryService.getFileEntities(filePath), options);
+    }
+    getCycles() {
+        return this.index.cycles;
+    }
+    getSummary() {
+        const hasImplementation = (this.index.relationsByType['implementation']?.length ?? 0) > 0;
+        const hasAtlas = !!this.archJson.extensions?.goAtlas;
+        const capabilities = {
+            classHierarchy: this.archJson.language !== 'go',
+            interfaceImplementation: hasImplementation,
+            packageGraph: hasAtlas,
+            cycleDetection: this.archJson.language !== 'go',
+        };
+        const metricsResult = this.metrics.getSummary();
+        return {
+            ...metricsResult,
+            language: this.archJson.language,
+            kind: this.scopeEntry.kind,
+            capabilities,
+        };
+    }
+    findByType(entityType, options) {
+        return this.applyOutputOptions(this.entityQueryService.findByType(entityType), options);
+    }
+    findByAttr(key, value, options) {
+        return this.applyOutputOptions(this.entityQueryService.findByAttr(key, value), options);
+    }
+    findByTypeAndAttr(entityType, attrKey, attrValue, options) {
+        return this.applyOutputOptions(this.entityQueryService.findByTypeAndAttr(entityType, attrKey, attrValue), options);
+    }
+    findHighCoupling(threshold = 8) {
+        return this.metrics.findHighCoupling(threshold);
+    }
+    findOrphans() {
+        return this.metrics.findOrphans();
+    }
+    findInCycles() {
+        return this.metrics.findInCycles();
+    }
+    applyOutputOptions(entities, options) {
+        if (!options)
+            return entities;
+        const scope = options.outputScope ?? 'class';
+        const format = options.queryFormat ?? 'structured';
+        const narrowed = narrowEntities(entities, scope);
+        if (format === 'edge-list') {
+            const filteredRelations = filterRelationsForScope(this.archJson.relations, scope);
+            return serialize(narrowed, filteredRelations, scope);
+        }
+        return narrowed;
+    }
+    getScopeEntry() {
+        return this.scopeEntry;
+    }
+    getPackageCoverage() {
+        return this.metrics.getPackageCoverage();
+    }
+    getEntityCoverage(entityId) {
+        return this.metrics.getEntityCoverage(entityId);
+    }
+    getPackageStats(depth = 2, topN) {
+        return this.metrics.getPackageStats(depth, topN);
+    }
+    toSummary(entity) {
+        const members = entity.members ?? [];
+        return {
+            id: entity.id,
+            name: entity.name,
+            type: entity.type,
+            visibility: entity.visibility,
+            file: entity.sourceLocation.file,
+            methodCount: members.filter((m) => m.type === 'method' || m.type === 'constructor').length,
+            fieldCount: members.filter((m) => m.type === 'property' || m.type === 'field').length,
+        };
+    }
+}
+//# sourceMappingURL=query-engine.js.map

package/dist/core/query/query-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-engine.js","sourceRoot":"","sources":["../../../src/core/query/query-engine.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAkDnE,MAAM,OAAO,WAAW;IACd,QAAQ,CAAW;IACnB,KAAK,CAAY;IACjB,UAAU,CAAkB;IACnB,OAAO,CAAc;IACrB,iBAAiB,CAAoB;IACrC,kBAAkB,CAAqB;IAC/C,oBAAoB,CAAuB;IAEpD,YAAY,OAA2B;QACrC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,CAAC,kBAAkB,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACtF,IAAI,CAAC,oBAAoB,GAAG,IAAI,oBAAoB,CAClD,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,SAAS,EACjB,IAAI,CAAC,kBAAkB,CACxB,CAAC;QACF,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC9F,CAAC;IAOD,UAAU,CACR,IAAY,EACZ,OAA4B;QAE5B,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAGD,eAAe,CACb,QAAgB,EAChB,OAA4B;QAE5B,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,CAAC,eAAe,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IAC7F,CAAC;IAGD,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAGD,UAAU;QAmBR,MAAM,iBAAiB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1F,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;QAErD,MAAM,YAAY,GAAG;YACnB,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI;YAC/C,uBAAuB,EAAE,iBAAiB;YAC1C,YAAY,EAAE,QAAQ;YACtB,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,IAAI;SAChD,CAAC;QAEF,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAEhD,OAAO;YACL,GAAG,aAAa;YAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAChC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;YAC1B,YAAY;SACb,CAAC;IACJ,CAAC;IAOD,UAAU,CACR,UAAkB,EAClB,OAA4B;QAE5B,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1F,CAAC;IAGD,UAAU,CACR,GAAW,EACX,KAAiC,EACjC,OAA4B;QAE5B,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1F,CAAC;IASD,iBAAiB,CACf,UAAkB,EAClB,OAAgB,EAChB,SAAqC,EACrC,OAA4B;QAE5B,OAAO,IAAI,CAAC,kBAAkB,CAC5B,IAAI,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,EACzE,OAAO,CACR,CAAC;IACJ,CAAC;IAGD,gBAAgB,CAAC,YAAoB,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAGD,WAAW;QACT,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;IAGD,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;IACrC,CAAC;IAWD,kBAAkB,CAChB,QAAkB,EAClB,OAA4B;QAE5B,IAAI,CAAC,OAAO;YAAE,OAAO,QAAQ,CAAC;QAE9B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC;QAEnD,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YAC3B,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAClF,OAAO,SAAS,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAGD,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAMD,kBAAkB;QAChB,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAC3C,CAAC;IAED,iBAAiB,CAAC,QAAgB;QAchC,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,eAAe,CACb,QAAgB,CAAC,EACjB,IAAa;QAEb,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;IAGD,SAAS,CAAC,MAAc;QACtB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,IAAI,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI;YAChC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC,MAAM;YAC1F,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,MAAM;SACtF,CAAC;IACJ,CAAC;CACF"}

package/dist/core/query/relation-query-service.d.ts

@@ -0,0 +1,21 @@
+import type { ArchJSON, Entity } from '../../types/index.js';
+import type { ArchIndex } from './arch-index.js';
+import type { EntityQueryService } from './entity-query-service.js';
+export declare class RelationQueryService {
+    private readonly archJson;
+    private readonly index;
+    private readonly entityQueryService;
+    constructor(archJson: ArchJSON, index: ArchIndex, entityQueryService: EntityQueryService);
+    getDependencies(entityName: string, depth?: number): Entity[];
+    getDependents(entityName: string, depth?: number): Entity[];
+    findImplementers(interfaceName: string): Entity[];
+    findSubclasses(className: string): Entity[];
+    findCallers(entityName: string, depth?: number): Array<{
+        callerEntity: string;
+        callerMethod: string;
+        callType: string;
+        depth: number;
+    }>;
+    private bfs;
+}
+//# sourceMappingURL=relation-query-service.d.ts.map

package/dist/core/query/relation-query-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation-query-service.d.ts","sourceRoot":"","sources":["../../../src/core/query/relation-query-service.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAFlB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,SAAS,EAChB,kBAAkB,EAAE,kBAAkB;IAIzD,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE;IAKhE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE;IAK9D,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE;IAcjD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAmB3C,WAAW,CACT,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAU,GAChB,KAAK,CAAC;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IA6EzF,OAAO,CAAC,GAAG;CAgCZ"}