@reqlan/analytical 0.4.0

package/out/analysis/analyser-registry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Registry and contracts for graph analysers.
+ */
+import type { AnalyticalStore } from '../core/analytical-store.js';
+import type { SqliteIndexStore } from '../index-store/sqlite-store.js';
+export interface AnalyserContext {
+    store: SqliteIndexStore;
+    analytical: AnalyticalStore;
+    workspaceRoot?: string;
+}
+export interface Analyser<TParams = unknown, TResult = unknown> {
+    readonly id: string;
+    run(context: AnalyserContext, params: TParams): Promise<TResult> | TResult;
+}
+export declare class AnalyserRegistry {
+    private readonly analysers;
+    register<TParams, TResult>(analyser: Analyser<TParams, TResult>): void;
+    get(id: string): Analyser | undefined;
+    run<TParams, TResult>(context: AnalyserContext, id: string, params: TParams): Promise<TResult>;
+    list(): string[];
+}

package/out/analysis/analyser-registry.js

@@ -0,0 +1,33 @@
+export class AnalyserRegistry {
+    constructor() {
+        this.analysers = new Map();
+    }
+    register(analyser) {
+        this.analysers.set(analyser.id, analyser);
+    }
+    get(id) {
+        return this.analysers.get(id);
+    }
+    async run(context, id, params) {
+        const analyser = this.analysers.get(id);
+        if (!analyser) {
+            throw new Error(`Unknown analyser: ${id}`);
+        }
+        const { startAnalysis, completeAnalysis, failAnalysis } = context.analytical.getState();
+        startAnalysis(id, params);
+        try {
+            const result = await analyser.run(context, params);
+            completeAnalysis(id, result);
+            return result;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            failAnalysis(id, message);
+            throw error;
+        }
+    }
+    list() {
+        return [...this.analysers.keys()];
+    }
+}
+//# sourceMappingURL=analyser-registry.js.map

package/out/analysis/analyser-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyser-registry.js","sourceRoot":"","sources":["../../src/analysis/analyser-registry.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAO,gBAAgB;IAA7B;QACqB,cAAS,GAAG,IAAI,GAAG,EAAsC,CAAC;IA+B/E,CAAC;IA7BG,QAAQ,CAAmB,QAAoC;QAC3D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAsC,CAAC,CAAC;IAC5E,CAAC;IAED,GAAG,CAAC,EAAU;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,GAAG,CAAmB,OAAwB,EAAE,EAAU,EAAE,MAAe;QAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QACxF,aAAa,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAY,CAAC;YAC9D,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC7B,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,YAAY,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAC1B,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,IAAI;QACA,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;CACJ"}

package/out/analysis/completion-tracking-analyser.d.ts

@@ -0,0 +1,3 @@
+import type { Analyser } from './analyser-registry.js';
+import type { CompletionSummary } from '../core/types.js';
+export declare const completionTrackingAnalyser: Analyser<void, CompletionSummary>;

package/out/analysis/completion-tracking-analyser.js

@@ -0,0 +1,37 @@
+import { isDeprecated, ideaStatus, parseAttributes } from '../core/types.js';
+const OUTSTANDING_STATUSES = new Set(['pending', 'todo', 'open', 'in_progress', 'blocked', 'stub']);
+export const completionTrackingAnalyser = {
+    id: 'completion_tracking',
+    async run({ store }) {
+        const ideas = await store.listAllIdeas();
+        const allRaw = await store.getAllIdeasRaw();
+        const byStatus = {};
+        const byTag = {};
+        const outstanding = [];
+        const deprecated = [];
+        for (const idea of ideas) {
+            const raw = allRaw.find(entry => entry.id === idea.id);
+            const attributes = parseAttributes(raw?.attributesJson ?? '{}');
+            const status = ideaStatus(attributes) ?? 'unspecified';
+            byStatus[status] = (byStatus[status] ?? 0) + 1;
+            for (const tag of idea.tags) {
+                byTag[tag] = (byTag[tag] ?? 0) + 1;
+            }
+            if (isDeprecated(attributes) || idea.tags.some(tag => tag.toLowerCase() === 'deprecated')) {
+                deprecated.push(idea);
+            }
+            else if (OUTSTANDING_STATUSES.has(status.toLowerCase()) ||
+                idea.tags.some(tag => ['todo', 'stub', 'open'].includes(tag.toLowerCase()))) {
+                outstanding.push(idea);
+            }
+        }
+        return {
+            total: ideas.length,
+            byStatus,
+            byTag,
+            outstanding,
+            deprecated
+        };
+    }
+};
+//# sourceMappingURL=completion-tracking-analyser.js.map

package/out/analysis/completion-tracking-analyser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion-tracking-analyser.js","sourceRoot":"","sources":["../../src/analysis/completion-tracking-analyser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAI7E,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;AAEpG,MAAM,CAAC,MAAM,0BAA0B,GAAsC;IACzE,EAAE,EAAE,qBAAqB;IACzB,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE;QACf,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,MAAM,WAAW,GAAkB,EAAE,CAAC;QACtC,MAAM,UAAU,GAAkB,EAAE,CAAC;QAErC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;YACvD,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,EAAE,cAAc,IAAI,IAAI,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,aAAa,CAAC;YACvD,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAE/C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC1B,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACvC,CAAC;YAED,IAAI,YAAY,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,YAAY,CAAC,EAAE,CAAC;gBACxF,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;iBAAM,IACH,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;gBAC9C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,EAC7E,CAAC;gBACC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;QACL,CAAC;QAED,OAAO;YACH,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,QAAQ;YACR,KAAK;YACL,WAAW;YACX,UAAU;SACb,CAAC;IACN,CAAC;CACJ,CAAC"}

package/out/analysis/deprecation-impact-analyser.d.ts

@@ -0,0 +1,3 @@
+import type { Analyser } from './analyser-registry.js';
+import type { DeprecationImpact } from '../core/types.js';
+export declare const deprecationImpactAnalyser: Analyser<void, DeprecationImpact[]>;

package/out/analysis/deprecation-impact-analyser.js

@@ -0,0 +1,21 @@
+import { isDeprecated, parseAttributes } from '../core/types.js';
+export const deprecationImpactAnalyser = {
+    id: 'deprecation_impact_analysis',
+    async run({ store }) {
+        const impacts = [];
+        const allIdeas = await store.listAllIdeas();
+        const allRaw = await store.getAllIdeasRaw();
+        for (const idea of allIdeas) {
+            const raw = allRaw.find(entry => entry.id === idea.id);
+            const attributes = parseAttributes(raw?.attributesJson ?? '{}');
+            if (!isDeprecated(attributes)) {
+                continue;
+            }
+            const inbound = await store.getEdgesTo(idea.id);
+            const dependents = (await Promise.all(inbound.map(edge => store.getIdea(edge.sourceId)))).filter((entry) => entry !== undefined);
+            impacts.push({ deprecated: idea, dependents });
+        }
+        return impacts;
+    }
+};
+//# sourceMappingURL=deprecation-impact-analyser.js.map

package/out/analysis/deprecation-impact-analyser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecation-impact-analyser.js","sourceRoot":"","sources":["../../src/analysis/deprecation-impact-analyser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIjE,MAAM,CAAC,MAAM,yBAAyB,GAAwC;IAC1E,EAAE,EAAE,6BAA6B;IACjC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE;QACf,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC;YACvD,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,EAAE,cAAc,IAAI,IAAI,CAAC,CAAC;YAChE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5B,SAAS;YACb,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChD,MAAM,UAAU,GAAG,CACf,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CACvE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAsC,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;YAC7E,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ,CAAC"}

package/out/analysis/file-related-analyser.d.ts

@@ -0,0 +1,5 @@
+import type { Analyser } from './analyser-registry.js';
+import type { FileRelatedRequirements } from '../core/types.js';
+export declare const fileRelatedAnalyser: Analyser<{
+    fileUri: string;
+}, FileRelatedRequirements>;

package/out/analysis/file-related-analyser.js

@@ -0,0 +1,41 @@
+import { basename } from 'node:path';
+import { matchFileReferenceTarget } from '../core/file-path-match.js';
+import { toWorkspaceRelativePath } from '../core/workspace-paths.js';
+export const fileRelatedAnalyser = {
+    id: 'file_related_requirements',
+    async run({ store, workspaceRoot }, { fileUri }) {
+        const indexedFileUri = workspaceRoot ? toWorkspaceRelativePath(fileUri, workspaceRoot) : fileUri;
+        const ideasInFile = await store.getIdeasInFile(indexedFileUri);
+        const fileName = basename(indexedFileUri);
+        const referencingIds = new Set();
+        const folderReferencingIds = new Set();
+        for (const edge of await store.getAllEdges()) {
+            if (edge.targetId && ideasInFile.some(idea => idea.id === edge.targetId)) {
+                referencingIds.add(edge.sourceId);
+            }
+            if (edge.kind === 'file_reference' && edge.targetFile) {
+                const match = matchFileReferenceTarget(edge.targetFile, indexedFileUri, fileName);
+                if (match === 'file') {
+                    referencingIds.add(edge.sourceId);
+                }
+                else if (match === 'folder') {
+                    folderReferencingIds.add(edge.sourceId);
+                }
+            }
+        }
+        const loadIdeas = async (ids) => (await Promise.all([...ids].map(id => store.getIdea(id)))).filter((idea) => idea !== undefined);
+        const referencingIdeas = await loadIdeas(referencingIds);
+        const folderReferencingIdeas = (await loadIdeas(folderReferencingIds)).filter(idea => !referencingIds.has(idea.id));
+        const commentLinkedIdeas = (await Promise.all((await store.getEdgesReferencingFile(fileName))
+            .filter(edge => edge.kind === 'comment_link')
+            .map(edge => (edge.targetId ? store.getIdea(edge.targetId) : Promise.resolve(undefined))))).filter((idea) => idea !== undefined);
+        return {
+            fileUri: indexedFileUri,
+            ideasInFile,
+            referencingIdeas,
+            commentLinkedIdeas,
+            folderReferencingIdeas
+        };
+    }
+};
+//# sourceMappingURL=file-related-analyser.js.map

package/out/analysis/file-related-analyser.js.map

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

package/out/analysis/git-dates-analyser.d.ts

@@ -0,0 +1,9 @@
+import type { Analyser } from './analyser-registry.js';
+export interface GitDateInfo {
+    ideaId: string;
+    createdAt?: string;
+    modifiedAt?: string;
+}
+export declare const gitDatesAnalyser: Analyser<{
+    ideaIds?: string[];
+}, GitDateInfo[]>;

package/out/analysis/git-dates-analyser.js

@@ -0,0 +1,39 @@
+import { URI } from 'langium';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { resolveWorkspaceFileUri } from '../core/workspace-paths.js';
+const execFileAsync = promisify(execFile);
+export const gitDatesAnalyser = {
+    id: 'git_dates',
+    async run({ store, workspaceRoot }, { ideaIds }) {
+        const ideas = ideaIds
+            ? (await Promise.all(ideaIds.map(id => store.getIdea(id)))).filter((idea) => !!idea)
+            : await store.listAllIdeas();
+        const results = [];
+        for (const idea of ideas) {
+            const dates = await lookupGitDates(idea.fileUri, idea.lineStart + 1, workspaceRoot);
+            if (dates.createdAt || dates.modifiedAt) {
+                await store.updateGitDates(idea.id, dates.createdAt, dates.modifiedAt);
+            }
+            results.push({ ideaId: idea.id, ...dates });
+        }
+        return results;
+    }
+};
+async function lookupGitDates(fileUri, line, workspaceRoot) {
+    const resolvedUri = resolveWorkspaceFileUri(fileUri, workspaceRoot);
+    const filePath = resolvedUri.startsWith('file://') ? URI.parse(resolvedUri).fsPath : resolvedUri;
+    const cwd = workspaceRoot;
+    try {
+        const { stdout: createdStdout } = await execFileAsync('git', ['log', '--diff-filter=A', '--format=%aI', '-1', '--', filePath], { cwd });
+        const { stdout: modifiedStdout } = await execFileAsync('git', ['log', '-L', `${line},${line}:${filePath}`, '--format=%aI', '-1'], { cwd });
+        return {
+            createdAt: createdStdout.trim() || undefined,
+            modifiedAt: modifiedStdout.trim() || undefined
+        };
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=git-dates-analyser.js.map

package/out/analysis/git-dates-analyser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-dates-analyser.js","sourceRoot":"","sources":["../../src/analysis/git-dates-analyser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAQ1C,MAAM,CAAC,MAAM,gBAAgB,GAAoD;IAC7E,EAAE,EAAE,WAAW;IACf,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,OAAO,EAAE;QAC3C,MAAM,KAAK,GAAG,OAAO;YACjB,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAoC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACtH,CAAC,CAAC,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;QACjC,MAAM,OAAO,GAAkB,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,aAAa,CAAC,CAAC;YACpF,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACtC,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ,CAAC;AAEF,KAAK,UAAU,cAAc,CACzB,OAAe,EACf,IAAY,EACZ,aAAsB;IAEtB,MAAM,WAAW,GAAG,uBAAuB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC;IACjG,MAAM,GAAG,GAAG,aAAa,CAAC;IAC1B,IAAI,CAAC;QACD,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,aAAa,CACjD,KAAK,EACL,CAAC,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,EAChE,EAAE,GAAG,EAAE,CACV,CAAC;QACF,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,aAAa,CAClD,KAAK,EACL,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,IAAI,IAAI,QAAQ,EAAE,EAAE,cAAc,EAAE,IAAI,CAAC,EAClE,EAAE,GAAG,EAAE,CACV,CAAC;QACF,OAAO;YACH,SAAS,EAAE,aAAa,CAAC,IAAI,EAAE,IAAI,SAAS;YAC5C,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,IAAI,SAAS;SACjD,CAAC;IACN,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC"}

package/out/analysis/list-ideas-analyser.d.ts

@@ -0,0 +1,3 @@
+import type { Analyser } from './analyser-registry.js';
+import type { IdeaSummary } from '../core/types.js';
+export declare const listAllIdeasAnalyser: Analyser<void, IdeaSummary[]>;

package/out/analysis/list-ideas-analyser.js

@@ -0,0 +1,7 @@
+export const listAllIdeasAnalyser = {
+    id: 'list_all_ideas',
+    async run({ store }) {
+        return store.listAllIdeas();
+    }
+};
+//# sourceMappingURL=list-ideas-analyser.js.map

package/out/analysis/list-ideas-analyser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-ideas-analyser.js","sourceRoot":"","sources":["../../src/analysis/list-ideas-analyser.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,oBAAoB,GAAkC;IAC/D,EAAE,EAAE,gBAAgB;IACpB,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE;QACf,OAAO,KAAK,CAAC,YAAY,EAAE,CAAC;IAChC,CAAC;CACJ,CAAC"}

package/out/analysis/local-graph-analyser.d.ts

@@ -0,0 +1,6 @@
+import type { Analyser } from './analyser-registry.js';
+import type { GraphSlice } from '../core/types.js';
+export declare const localGraphAnalyser: Analyser<{
+    centerId: string;
+    depth?: number;
+}, GraphSlice>;

package/out/analysis/local-graph-analyser.js

@@ -0,0 +1,42 @@
+export const localGraphAnalyser = {
+    id: 'local_graph_analysis',
+    async run({ store }, { centerId, depth = 1 }) {
+        const center = await store.getIdea(centerId);
+        if (!center) {
+            return { centerId, depth, nodes: [], edges: [] };
+        }
+        const nodes = new Map();
+        const edges = new Map();
+        const visited = new Set();
+        const queue = [{ id: centerId, remaining: depth }];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            if (visited.has(current.id)) {
+                continue;
+            }
+            visited.add(current.id);
+            const idea = await store.getIdea(current.id);
+            if (idea) {
+                nodes.set(idea.id, idea);
+            }
+            const outbound = await store.getEdgesFrom(current.id);
+            const inbound = await store.getEdgesTo(current.id);
+            for (const edge of [...outbound, ...inbound]) {
+                edges.set(edge.id, edge);
+                if (current.remaining > 0) {
+                    const nextId = edge.sourceId === current.id ? edge.targetId : edge.sourceId;
+                    if (nextId) {
+                        queue.push({ id: nextId, remaining: current.remaining - 1 });
+                    }
+                }
+            }
+        }
+        return {
+            centerId,
+            depth,
+            nodes: [...nodes.values()],
+            edges: [...edges.values()]
+        };
+    }
+};
+//# sourceMappingURL=local-graph-analyser.js.map

package/out/analysis/local-graph-analyser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-graph-analyser.js","sourceRoot":"","sources":["../../src/analysis/local-graph-analyser.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,kBAAkB,GAA+D;IAC1F,EAAE,EAAE,sBAAsB;IAC1B,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE;QACxC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACrD,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,KAAK,GAA6C,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;QAE7F,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC1B,SAAS;YACb,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7C,IAAI,IAAI,EAAE,CAAC;gBACP,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC7B,CAAC;YAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACtD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACnD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;gBAC3C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gBACzB,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;oBACxB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;oBAC5E,IAAI,MAAM,EAAE,CAAC;wBACT,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC,CAAC;oBACjE,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO;YACH,QAAQ;YACR,KAAK;YACL,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC1B,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;SAC7B,CAAC;IACN,CAAC;CACJ,CAAC"}

package/out/analysis/semantic-search-analyser.d.ts

@@ -0,0 +1,8 @@
+import type { Analyser } from './analyser-registry.js';
+import type { SemanticMatch } from '../core/types.js';
+export interface SemanticSearchParams {
+    query: string;
+    ideaset?: string;
+    limit?: number;
+}
+export declare const semanticSearchAnalyser: Analyser<SemanticSearchParams, SemanticMatch[]>;

package/out/analysis/semantic-search-analyser.js

@@ -0,0 +1,51 @@
+export const semanticSearchAnalyser = {
+    id: 'semantic_analysis',
+    async run({ store }, { query, ideaset, limit = 20 }) {
+        const normalized = query.toLowerCase();
+        const tokens = normalized.split(/\s+/).filter(Boolean);
+        const candidates = await store.searchByNameOrSummary(query);
+        const matches = [];
+        for (const idea of candidates) {
+            if (ideaset && idea.kind === 'ideaset' && idea.name !== ideaset) {
+                continue;
+            }
+            const haystack = `${idea.name} ${idea.summary} ${idea.tags.join(' ')}`.toLowerCase();
+            const reasons = [];
+            let score = 0;
+            if (idea.name.toLowerCase().includes(normalized)) {
+                score += 3;
+                reasons.push('name match');
+            }
+            if (idea.summary.toLowerCase().includes(normalized)) {
+                score += 2;
+                reasons.push('summary match');
+            }
+            for (const token of tokens) {
+                if (haystack.includes(token)) {
+                    score += 1;
+                    reasons.push(`token:${token}`);
+                }
+            }
+            for (const tag of idea.tags) {
+                if (tag.toLowerCase().includes(normalized)) {
+                    score += 1;
+                    reasons.push(`tag:${tag}`);
+                }
+            }
+            const relatedEdges = await store.getEdgesFrom(idea.id);
+            for (const edge of relatedEdges) {
+                if (edge.label?.toLowerCase().includes(normalized)) {
+                    score += 1;
+                    reasons.push('reference label');
+                }
+            }
+            if (score > 0) {
+                matches.push({ idea, score, reasons: [...new Set(reasons)] });
+            }
+        }
+        return matches
+            .sort((left, right) => right.score - left.score)
+            .slice(0, limit);
+    }
+};
+//# sourceMappingURL=semantic-search-analyser.js.map

package/out/analysis/semantic-search-analyser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-search-analyser.js","sourceRoot":"","sources":["../../src/analysis/semantic-search-analyser.ts"],"names":[],"mappings":"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"}

package/out/analysis-api.d.ts

@@ -0,0 +1,31 @@
+import type { CompletionSummary, DeprecationImpact, FileRelatedRequirements, GraphSlice, IdeaSummary } from './core/types.js';
+import type { AnalysisRuntime } from './create-runtime.js';
+export interface RequirementMatch {
+    idea: IdeaSummary;
+    score?: number;
+    reasons?: string[];
+}
+export interface InteractionDescriptor {
+    name: string;
+    description: string;
+    parameters: Record<string, string>;
+}
+export declare class AnalysisApi {
+    private readonly runtime;
+    constructor(runtime: AnalysisRuntime);
+    ensureReady(): Promise<void>;
+    searchRequirements(query: string, limit?: number): Promise<RequirementMatch[]>;
+    listRequirements(limit?: number): Promise<IdeaSummary[]>;
+    getFileContext(filePath: string): Promise<FileRelatedRequirements>;
+    getLocalGraph(filePath: string, depth?: number): Promise<GraphSlice | undefined>;
+    summarizeSubtree(requirementName: string, depth?: number): Promise<GraphSlice | undefined>;
+    getCompletionStatus(): Promise<CompletionSummary>;
+    getDeprecationImpact(): Promise<DeprecationImpact[]>;
+    resolveRequirementReference(name?: string): Promise<IdeaSummary[]>;
+    resolveFileReference(pathPrefix?: string): Promise<Array<{
+        path: string;
+        ideas: IdeaSummary[];
+    }>>;
+    listInteractions(): InteractionDescriptor[];
+    formatIdea(idea: IdeaSummary): string;
+}

package/out/analysis-api.js

@@ -0,0 +1,136 @@
+export class AnalysisApi {
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    async ensureReady() {
+        if (this.runtime.index.isReady) {
+            return;
+        }
+        await this.runtime.index.syncWorkspace();
+    }
+    async searchRequirements(query, limit = 8) {
+        await this.ensureReady();
+        const matches = await this.runtime.analysers.run(this.runtime.makeContext(), 'semantic_analysis', { query, limit });
+        return matches.map(match => ({
+            idea: match.idea,
+            score: match.score,
+            reasons: match.reasons
+        }));
+    }
+    async listRequirements(limit = 50) {
+        await this.ensureReady();
+        const ideas = await this.runtime.analysers.run(this.runtime.makeContext(), 'list_all_ideas', undefined);
+        return ideas.slice(0, limit);
+    }
+    async getFileContext(filePath) {
+        await this.ensureReady();
+        const fileUri = this.runtime.index.resolveFileUri(filePath);
+        return this.runtime.analysers.run(this.runtime.makeContext(), 'file_related_requirements', { fileUri });
+    }
+    async getLocalGraph(filePath, depth = 1) {
+        await this.ensureReady();
+        const fileUri = this.runtime.index.resolveFileUri(filePath);
+        const ideas = await this.runtime.index.indexStore.getIdeasInFile(fileUri);
+        if (ideas.length === 0) {
+            return undefined;
+        }
+        const center = ideas[0];
+        return this.runtime.analysers.run(this.runtime.makeContext(), 'local_graph_analysis', { centerId: center.id, depth });
+    }
+    async summarizeSubtree(requirementName, depth = 2) {
+        await this.ensureReady();
+        const matches = await this.searchRequirements(requirementName, 1);
+        const center = matches[0]?.idea;
+        if (!center) {
+            return undefined;
+        }
+        return this.runtime.analysers.run(this.runtime.makeContext(), 'local_graph_analysis', { centerId: center.id, depth });
+    }
+    async getCompletionStatus() {
+        await this.ensureReady();
+        return this.runtime.analysers.run(this.runtime.makeContext(), 'completion_tracking', undefined);
+    }
+    async getDeprecationImpact() {
+        await this.ensureReady();
+        return this.runtime.analysers.run(this.runtime.makeContext(), 'deprecation_impact_analysis', undefined);
+    }
+    async resolveRequirementReference(name) {
+        await this.ensureReady();
+        const query = name?.trim() ?? '';
+        if (query) {
+            const matches = await this.searchRequirements(query, 8);
+            return matches.map(match => match.idea);
+        }
+        return this.listRequirements(12);
+    }
+    async resolveFileReference(pathPrefix) {
+        await this.ensureReady();
+        const prefix = pathPrefix?.trim() ?? '';
+        const files = await this.runtime.index.listRqFiles(prefix).slice(0, 12);
+        const results = [];
+        for (const path of files) {
+            const related = await this.getFileContext(path).catch(() => undefined);
+            results.push({
+                path,
+                ideas: related?.ideasInFile.slice(0, 4) ?? []
+            });
+        }
+        return results;
+    }
+    listInteractions() {
+        return [
+            {
+                name: 'search_requirements',
+                description: 'Search requirements by keyword across names, summaries, tags, and references.',
+                parameters: { query: 'Search text', limit: 'Optional maximum number of matches' }
+            },
+            {
+                name: 'list_requirements',
+                description: 'List indexed requirements in the workspace.',
+                parameters: { limit: 'Optional maximum number of requirements' }
+            },
+            {
+                name: 'file_context',
+                description: 'Get requirements in, referencing, or comment-linked to a file.',
+                parameters: { filePath: 'Relative or absolute path to a .rq file' }
+            },
+            {
+                name: 'local_graph',
+                description: 'Get the local requirement graph around the first requirement in a file.',
+                parameters: { filePath: 'Relative or absolute path to a .rq file', depth: 'Optional hop depth' }
+            },
+            {
+                name: 'summarize_subtree',
+                description: 'Summarise a requirement subtree rooted at a named requirement.',
+                parameters: { requirementName: 'Requirement name or search text', depth: 'Optional hop depth' }
+            },
+            {
+                name: 'requirement_reference',
+                description: 'Resolve a requirement by name for compact chat or MCP context.',
+                parameters: { name: 'Optional requirement name or search text' }
+            },
+            {
+                name: 'file_reference',
+                description: 'Resolve requirements indexed in matching .rq files.',
+                parameters: { path: 'Optional path fragment filter' }
+            },
+            {
+                name: 'completion_status',
+                description: 'Summarise completion and deprecation status across the workspace graph.',
+                parameters: {}
+            },
+            {
+                name: 'list_interactions',
+                description: 'Discover available requirement graph interactions and parameters.',
+                parameters: {}
+            }
+        ];
+    }
+    formatIdea(idea) {
+        const location = `${this.runtime.index.relativePath(idea.fileUri)}:${idea.lineStart + 1}`;
+        const tags = idea.tags.length > 0 ? `\nTags: ${idea.tags.join(', ')}` : '';
+        const status = idea.status ? `\nStatus: ${idea.status}` : '';
+        return `### ${idea.name} (${location})\n${idea.summary || '(no summary)'}${status}${tags}`;
+    }
+}
+//# sourceMappingURL=analysis-api.js.map

package/out/analysis-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-api.js","sourceRoot":"","sources":["../src/analysis-api.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,WAAW;IACpB,YAA6B,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;IAAG,CAAC;IAEzD,KAAK,CAAC,WAAW;QACb,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAC7B,OAAO;QACX,CAAC;QACD,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,kBAAkB,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC;QAC7C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAC5C,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAC1B,mBAAmB,EACnB,EAAE,KAAK,EAAE,KAAK,EAAE,CACnB,CAAC;QACF,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;SACzB,CAAC,CAAC,CAAC;IACR,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,KAAK,GAAG,EAAE;QAC7B,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAC1C,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAC1B,gBAAgB,EAChB,SAAS,CACZ,CAAC;QACF,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAgB;QACjC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAC7B,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAC1B,2BAA2B,EAC3B,EAAE,OAAO,EAAE,CACd,CAAC;IACN,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAAgB,EAAE,KAAK,GAAG,CAAC;QAC3C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC1E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAC7B,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAC1B,sBAAsB,EACtB,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,CACjC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,eAAuB,EAAE,KAAK,GAAG,CAAC;QACrD,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAC7B,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAC1B,sBAAsB,EACtB,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,CACjC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,mBAAmB;QACrB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAC7B,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAC1B,qBAAqB,EACrB,SAAS,CACZ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,oBAAoB;QACtB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAC7B,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAC1B,6BAA6B,EAC7B,SAAS,CACZ,CAAC;IACN,CAAC;IAED,KAAK,CAAC,2BAA2B,CAAC,IAAa;QAC3C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACjC,IAAI,KAAK,EAAE,CAAC;YACR,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACxD,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,oBAAoB,CAAC,UAAmB;QAC1C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAExE,MAAM,OAAO,GAAkD,EAAE,CAAC;QAClE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC;gBACT,IAAI;gBACJ,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE;aAChD,CAAC,CAAC;QACP,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;IAED,gBAAgB;QACZ,OAAO;YACH;gBACI,IAAI,EAAE,qBAAqB;gBAC3B,WAAW,EAAE,+EAA+E;gBAC5F,UAAU,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,oCAAoC,EAAE;aACpF;YACD;gBACI,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE,6CAA6C;gBAC1D,UAAU,EAAE,EAAE,KAAK,EAAE,yCAAyC,EAAE;aACnE;YACD;gBACI,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,gEAAgE;gBAC7E,UAAU,EAAE,EAAE,QAAQ,EAAE,yCAAyC,EAAE;aACtE;YACD;gBACI,IAAI,EAAE,aAAa;gBACnB,WAAW,EAAE,yEAAyE;gBACtF,UAAU,EAAE,EAAE,QAAQ,EAAE,yCAAyC,EAAE,KAAK,EAAE,oBAAoB,EAAE;aACnG;YACD;gBACI,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE,gEAAgE;gBAC7E,UAAU,EAAE,EAAE,eAAe,EAAE,iCAAiC,EAAE,KAAK,EAAE,oBAAoB,EAAE;aAClG;YACD;gBACI,IAAI,EAAE,uBAAuB;gBAC7B,WAAW,EAAE,gEAAgE;gBAC7E,UAAU,EAAE,EAAE,IAAI,EAAE,0CAA0C,EAAE;aACnE;YACD;gBACI,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,qDAAqD;gBAClE,UAAU,EAAE,EAAE,IAAI,EAAE,+BAA+B,EAAE;aACxD;YACD;gBACI,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE,yEAAyE;gBACtF,UAAU,EAAE,EAAE;aACjB;YACD;gBACI,IAAI,EAAE,mBAAmB;gBACzB,WAAW,EAAE,mEAAmE;gBAChF,UAAU,EAAE,EAAE;aACjB;SACJ,CAAC;IACN,CAAC;IAED,UAAU,CAAC,IAAiB;QACxB,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QAC1F,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,MAAM,IAAI,CAAC,OAAO,IAAI,cAAc,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC;IAC/F,CAAC;CACJ"}