@reqlan/analytical 0.4.0

package/out/core/analytical-store.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Zustand store for analytical submodule state and lifecycle actions.
+ */
+import { type StoreApi } from 'zustand/vanilla';
+export type IndexState = 'uninitialized' | 'opening' | 'idle' | 'syncing' | 'ready' | 'error' | 'closing';
+type IndexEvent = 'activate' | 'opened' | 'sync' | 'synced' | 'fail' | 'deactivate';
+export type WorkspaceChange = 'created' | 'changed' | 'deleted';
+export type IndexErrorPhase = 'open' | 'parse' | 'extract' | 'persist' | 'sync' | 'transition';
+export interface IndexError {
+    message: string;
+    fileUri?: string;
+    ideaNames?: string[];
+    phase?: IndexErrorPhase;
+    cause?: unknown;
+}
+export interface FileIndexIssue {
+    fileUri: string;
+    line: number;
+    column: number;
+    message: string;
+    phase: IndexErrorPhase;
+    ideaNames?: string[];
+    cause?: string;
+    at: number;
+}
+export interface DocumentUpdate {
+    fileUri: string;
+    ideaCount: number;
+    at: number;
+}
+export interface WorkspaceFileChange {
+    fileUri: string;
+    change: WorkspaceChange;
+    at: number;
+}
+export interface AnalysisRun {
+    analyser: string;
+    params: unknown;
+    status: 'running' | 'completed' | 'failed';
+    result?: unknown;
+    error?: string;
+    at: number;
+}
+export interface AnalyticalState {
+    indexState: IndexState;
+    previousIndexState?: IndexState;
+    ideaCount: number;
+    edgeCount: number;
+    lastError?: IndexError;
+    fileIndexIssues: FileIndexIssue[];
+    documentUpdates: DocumentUpdate[];
+    workspaceChanges: WorkspaceFileChange[];
+    analysisRuns: AnalysisRun[];
+    currentAnalysis?: AnalysisRun;
+}
+export interface AnalyticalActions {
+    canDispatchIndex: (event: IndexEvent) => boolean;
+    dispatchIndex: (event: IndexEvent) => boolean;
+    setIndexReady: (counts: {
+        ideaCount: number;
+        edgeCount: number;
+    }) => void;
+    recordIndexError: (message: string, cause?: unknown, context?: Pick<IndexError, 'fileUri' | 'ideaNames' | 'phase'>) => void;
+    recordFileIndexIssues: (fileUri: string, issues: Array<Omit<FileIndexIssue, 'fileUri' | 'at'>>) => void;
+    clearFileIndexIssues: () => void;
+    clearFileIndexIssuesForFile: (fileUri: string) => void;
+    clearLastError: () => void;
+    recordDocumentUpdate: (fileUri: string, ideaCount: number) => void;
+    recordWorkspaceChange: (fileUri: string, change: WorkspaceChange) => void;
+    startAnalysis: (analyser: string, params: unknown) => void;
+    completeAnalysis: (analyser: string, result: unknown) => void;
+    failAnalysis: (analyser: string, error: string) => void;
+    reset: () => void;
+}
+export type AnalyticalStoreState = AnalyticalState & AnalyticalActions;
+export type AnalyticalStore = StoreApi<AnalyticalStoreState>;
+export declare function createAnalyticalStore(): AnalyticalStore;
+export {};

package/out/core/analytical-store.js

@@ -0,0 +1,141 @@
+/**
+ * Zustand store for analytical submodule state and lifecycle actions.
+ */
+import { createStore } from 'zustand/vanilla';
+const INDEX_TRANSITIONS = {
+    uninitialized: { activate: 'opening' },
+    opening: { opened: 'idle', fail: 'error' },
+    idle: { sync: 'syncing', deactivate: 'closing' },
+    ready: { sync: 'syncing', deactivate: 'closing' },
+    syncing: { synced: 'ready', fail: 'error' },
+    error: { sync: 'syncing', deactivate: 'closing' },
+    closing: {}
+};
+const INITIAL_STATE = {
+    indexState: 'uninitialized',
+    ideaCount: 0,
+    edgeCount: 0,
+    fileIndexIssues: [],
+    documentUpdates: [],
+    workspaceChanges: [],
+    analysisRuns: []
+};
+const MAX_ACTIVITY = 50;
+const MAX_FILE_ISSUES = 500;
+function resolveTransition(state, event) {
+    return INDEX_TRANSITIONS[state]?.[event];
+}
+function appendActivity(items, item) {
+    return [...items, item].slice(-MAX_ACTIVITY);
+}
+export function createAnalyticalStore() {
+    return createStore((set, get) => ({
+        ...INITIAL_STATE,
+        canDispatchIndex(event) {
+            return resolveTransition(get().indexState, event) !== undefined;
+        },
+        dispatchIndex(event) {
+            const current = get().indexState;
+            const next = resolveTransition(current, event);
+            if (!next) {
+                return false;
+            }
+            set({
+                previousIndexState: current,
+                indexState: next
+            });
+            return true;
+        },
+        setIndexReady({ ideaCount, edgeCount }) {
+            set({ ideaCount, edgeCount });
+        },
+        recordIndexError(message, cause, context) {
+            set({
+                lastError: {
+                    message,
+                    cause,
+                    fileUri: context?.fileUri,
+                    ideaNames: context?.ideaNames,
+                    phase: context?.phase
+                }
+            });
+        },
+        recordFileIndexIssues(fileUri, issues) {
+            const at = Date.now();
+            set(state => ({
+                fileIndexIssues: [
+                    ...state.fileIndexIssues.filter(issue => issue.fileUri !== fileUri),
+                    ...issues.map(issue => ({ ...issue, fileUri, at }))
+                ].slice(-MAX_FILE_ISSUES)
+            }));
+        },
+        clearFileIndexIssues() {
+            set({ fileIndexIssues: [] });
+        },
+        clearFileIndexIssuesForFile(fileUri) {
+            set(state => ({
+                fileIndexIssues: state.fileIndexIssues.filter(issue => issue.fileUri !== fileUri)
+            }));
+        },
+        clearLastError() {
+            set({ lastError: undefined });
+        },
+        recordDocumentUpdate(fileUri, ideaCount) {
+            set(state => ({
+                documentUpdates: appendActivity(state.documentUpdates, {
+                    fileUri,
+                    ideaCount,
+                    at: Date.now()
+                })
+            }));
+        },
+        recordWorkspaceChange(fileUri, change) {
+            set(state => ({
+                workspaceChanges: appendActivity(state.workspaceChanges, {
+                    fileUri,
+                    change,
+                    at: Date.now()
+                })
+            }));
+        },
+        startAnalysis(analyser, params) {
+            const run = {
+                analyser,
+                params,
+                status: 'running',
+                at: Date.now()
+            };
+            set({ currentAnalysis: run });
+        },
+        completeAnalysis(analyser, result) {
+            const completed = {
+                analyser,
+                params: get().currentAnalysis?.params,
+                status: 'completed',
+                result,
+                at: Date.now()
+            };
+            set(state => ({
+                currentAnalysis: undefined,
+                analysisRuns: appendActivity(state.analysisRuns, completed)
+            }));
+        },
+        failAnalysis(analyser, error) {
+            const failed = {
+                analyser,
+                params: get().currentAnalysis?.params,
+                status: 'failed',
+                error,
+                at: Date.now()
+            };
+            set(state => ({
+                currentAnalysis: undefined,
+                analysisRuns: appendActivity(state.analysisRuns, failed)
+            }));
+        },
+        reset() {
+            set({ ...INITIAL_STATE });
+        }
+    }));
+}
+//# sourceMappingURL=analytical-store.js.map

package/out/core/analytical-store.js.map

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

package/out/core/context-model.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Composed reqlan context model — dimensions, focus, and merged footprint.
+ * per ["../../../../reqlan rq/extension/module/context-scope.rq"]
+ */
+import type { IdeaSummary, IdeaWithRange, OutlineNode, ReferenceListRow } from './types.js';
+import type { AiReadiness, ContextFingerprintAxes, ContextSignals, ContextSynthesis } from './context-signals.js';
+export type { AiReadiness, ContextFingerprintAxes, ContextSignals, ContextSynthesis, ContextRiskLevel, ContextCoverageLevel, ContextHotspotBand, DevelopmentHistorySignals, LifecycleSignals, QualitySignals, RelationshipSignals, RiskSignals } from './context-signals.js';
+export interface ContextReferencesSlice {
+    ideaId: string;
+    rows: ReferenceListRow[];
+}
+export type ContextDimensionId = 'workspace' | 'current_file' | 'open_files' | 'file_history' | 'edit_history' | 'manual' | 'git';
+export type ContextFocusKind = 'idea' | 'file' | 'selection' | 'none';
+export interface ContextFocus {
+    kind: ContextFocusKind;
+    ideaId?: string;
+    fileUri?: string;
+    line?: number;
+    selectionIdeaIds?: string[];
+}
+export interface ContextFileEntry {
+    fileUri: string;
+    fileLabel: string;
+    line?: number;
+    touchedAt?: number;
+    gitChange?: 'staged' | 'unstaged' | 'both';
+    sources: ContextDimensionId[];
+}
+export interface ContextIdeaEntry {
+    idea: IdeaSummary;
+    sources: ContextDimensionId[];
+    weight: number;
+}
+export interface ContextProvenance {
+    ideaSources: Record<string, ContextDimensionId[]>;
+    fileSources: Record<string, ContextDimensionId[]>;
+}
+export interface ContextDimensionContribution {
+    id: ContextDimensionId;
+    label: string;
+    enabled: boolean;
+    pinned: boolean;
+    weight: number;
+    ideaCount: number;
+    fileCount: number;
+    summary: string;
+    /** Effective graph hop depth for this dimension (inherits global when unset). */
+    hopDepth: number;
+    /** True when this dimension supports per-lens hop overrides. */
+    supportsHopControl: boolean;
+}
+export interface CurrentFileSlice {
+    fileUri: string;
+    fileLabel: string;
+    isRqFile: boolean;
+    focusIdea?: IdeaSummary;
+    ideasInFile: IdeaWithRange[];
+    outline: OutlineNode[];
+    unresolvedCount: number;
+    /** Ideas with edges to this file (or its ideas) — file-scoped inbound. */
+    referencingIdeas: IdeaSummary[];
+    /** Ideas that reference the focused idea — idea-scoped inbound. */
+    inboundReferencingIdeas: IdeaSummary[];
+    /** Ideas the focused idea references — idea-scoped outbound. */
+    referencedIdeas: IdeaSummary[];
+    commentLinkedIdeas: IdeaSummary[];
+    folderReferencingIdeas: IdeaSummary[];
+    gitChange?: 'staged' | 'unstaged' | 'both';
+}
+export interface ContextSelection {
+    fileUri: string;
+    startLine: number;
+    endLine: number;
+    ideaIds: string[];
+    ideas: IdeaSummary[];
+}
+export interface ContextFileLensDetail {
+    fileUri: string;
+    fileLabel: string;
+    ideasInFile: IdeaWithRange[];
+    relatedIdeas: IdeaSummary[];
+}
+/** @deprecated Use CurrentFileSlice — kept for wire compat during migration */
+export type ActivityBarScope = CurrentFileSlice;
+/** One commit from focus-scoped `git log` for the git history lens. */
+export interface GitFocusCommit {
+    hash: string;
+    shortHash: string;
+    subject: string;
+    author: string;
+    authoredAt: string;
+}
+export interface GitAuthorRollup {
+    name: string;
+    commitCount: number;
+}
+export interface GitPeerChangeRate {
+    ideaId: string;
+    name: string;
+    commitCount: number;
+    ageDays?: number;
+    changeRate?: number;
+}
+export interface GitFocusStats {
+    symbolName?: string;
+    createdAt?: string;
+    createdBy?: string;
+    modifiedAt?: string;
+    modifiedBy?: string;
+    commitCount?: number;
+    ageDays?: number;
+    changeRate?: number;
+    relativeChangeRate?: number;
+    relativeChangeLabel?: 'cold' | 'typical' | 'hot' | 'very_hot';
+    peers?: GitPeerChangeRate[];
+}
+export interface GitContextSlice {
+    branch?: string;
+    headShort?: string;
+    unstagedCount: number;
+    stagedCount: number;
+    changedFiles: ContextFileEntry[];
+    /** Recent commits touching the focus file / idea line range. */
+    focusCommits: GitFocusCommit[];
+    topAuthors: GitAuthorRollup[];
+    /** Lifecycle and churn metrics for the focused symbol when available. */
+    focusStats?: GitFocusStats;
+    /** Collapsed lens summary, e.g. "main · 3 commits · 2 authors". */
+    summary: string;
+    /** Focus-hero cue, e.g. "2d ago · main". */
+    historyCue?: string;
+}
+export interface WorkspaceContextSlice {
+    ready: boolean;
+    ideaCount: number;
+    edgeCount: number;
+}
+export interface ContextFootprint {
+    ideaIds: string[];
+    fileUris: string[];
+    effectiveCenterId?: string;
+    summaryLine: string;
+    provenance: ContextProvenance;
+}
+export interface ContextAnomaly {
+    kind: 'unresolved_refs' | 'index_issue' | 'git_conflict';
+    message: string;
+    action?: 'filter_broken_refs' | 'open_workspace' | 'open_file';
+    fileUri?: string;
+}
+export interface ReqlanContextModel {
+    revision: number;
+    focus: ContextFocus;
+    dimensions: ContextDimensionContribution[];
+    footprint: ContextFootprint;
+    expandedLens?: ContextDimensionId;
+    /** Global graph hop depth for panes and context search. */
+    globalHopDepth: number;
+    minHopDepth: number;
+    maxHopDepth: number;
+    /** Per-dimension hop overrides; omitted dimensions inherit globalHopDepth. */
+    dimensionHopDepth: Partial<Record<ContextDimensionId, number>>;
+    currentFile?: CurrentFileSlice;
+    openFiles: ContextFileEntry[];
+    fileHistory: ContextFileEntry[];
+    editHistory: ContextFileEntry[];
+    manualIdeas: IdeaSummary[];
+    git?: GitContextSlice;
+    workspace: WorkspaceContextSlice;
+    anomalies: ContextAnomaly[];
+    selection?: ContextSelection;
+    /** Bidirectional reference rows for [footprint.effectiveCenterId]. */
+    references?: ContextReferencesSlice;
+    /** v2 focus signals (relationship, history, risk, …). */
+    signals?: ContextSignals;
+    /** v2 synthesized knowledge for the focus entity. */
+    synthesis?: ContextSynthesis;
+    /** Compact axes describing what is in composed context. */
+    fingerprint?: ContextFingerprintAxes;
+    /** Whether AI has enough / safe enough context to assist. */
+    aiReadiness?: AiReadiness;
+}
+export declare const CONTEXT_DIMENSION_LABELS: Record<ContextDimensionId, string>;
+export declare const CONTEXT_DIMENSION_WEIGHTS: Record<ContextDimensionId, number>;
+export declare const DEFAULT_ENABLED_DIMENSIONS: Record<ContextDimensionId, boolean>;
+/** Dimensions that traverse the requirement graph and expose hop controls. */
+export declare const CONTEXT_GRAPH_SEARCH_DIMENSIONS: ContextDimensionId[];

package/out/core/context-model.js

@@ -0,0 +1,36 @@
+export const CONTEXT_DIMENSION_LABELS = {
+    workspace: 'Workspace',
+    current_file: 'This file',
+    open_files: 'Open',
+    file_history: 'Visited',
+    edit_history: 'Edited',
+    manual: 'Pinned',
+    git: 'Git'
+};
+export const CONTEXT_DIMENSION_WEIGHTS = {
+    workspace: 0.1,
+    current_file: 1.0,
+    open_files: 0.6,
+    file_history: 0.4,
+    edit_history: 0.5,
+    manual: 0.9,
+    git: 0.7
+};
+export const DEFAULT_ENABLED_DIMENSIONS = {
+    workspace: true,
+    current_file: true,
+    open_files: true,
+    file_history: true,
+    edit_history: true,
+    manual: true,
+    git: true
+};
+/** Dimensions that traverse the requirement graph and expose hop controls. */
+export const CONTEXT_GRAPH_SEARCH_DIMENSIONS = [
+    'current_file',
+    'open_files',
+    'file_history',
+    'edit_history',
+    'manual'
+];
+//# sourceMappingURL=context-model.js.map

package/out/core/context-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-model.js","sourceRoot":"","sources":["../../src/core/context-model.ts"],"names":[],"mappings":"AAsOA,MAAM,CAAC,MAAM,wBAAwB,GAAuC;IACxE,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,WAAW;IACzB,UAAU,EAAE,MAAM;IAClB,YAAY,EAAE,SAAS;IACvB,YAAY,EAAE,QAAQ;IACtB,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAuC;IACzE,SAAS,EAAE,GAAG;IACd,YAAY,EAAE,GAAG;IACjB,UAAU,EAAE,GAAG;IACf,YAAY,EAAE,GAAG;IACjB,YAAY,EAAE,GAAG;IACjB,MAAM,EAAE,GAAG;IACX,GAAG,EAAE,GAAG;CACX,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAwC;IAC3E,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,IAAI;IAClB,MAAM,EAAE,IAAI;IACZ,GAAG,EAAE,IAAI;CACZ,CAAC;AAEF,8EAA8E;AAC9E,MAAM,CAAC,MAAM,+BAA+B,GAAyB;IACjE,cAAc;IACd,YAAY;IACZ,cAAc;IACd,cAAc;IACd,QAAQ;CACX,CAAC"}

package/out/core/context-signals.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Context signals and focus synthesis for context-scope v2.
+ * per ["../../../../reqlan rq/extension/module/context-scope-v2.rq"]
+ */
+export type ContextRiskLevel = 'low' | 'medium' | 'high';
+export type ContextCoverageLevel = 'unknown' | 'partial' | 'complete';
+export type ContextHotspotBand = 'low' | 'medium' | 'high';
+export interface RelationshipSignals {
+    parentCount: number;
+    childCount: number;
+    inboundCount: number;
+    outboundCount: number;
+    /** Inbound idea references that are not in the ancestor (parent) set. */
+    dependentCount: number;
+}
+export interface DevelopmentHistorySignals {
+    createdAt?: string;
+    createdBy?: string;
+    modifiedAt?: string;
+    modifiedBy?: string;
+    /** Whole days since createdAt; undefined when unknown. */
+    ageDays?: number;
+    /** Whole days since modifiedAt; undefined when unknown. */
+    timeSinceTouchedDays?: number;
+    /** Focus-scoped commit count from git history (when collected). */
+    commitCount?: number;
+    /** Commits per day since introduction; undefined when age is unknown. */
+    changeRate?: number;
+    /** Ratio of focus changeRate to peer median changeRate. */
+    relativeChangeRate?: number;
+    relativeChangeLabel?: 'cold' | 'typical' | 'hot' | 'very_hot';
+    /** Top author names for the focus path / line range. */
+    authors?: string[];
+}
+export interface LifecycleSignals {
+    createdAt?: string;
+    lastEditedAt?: string;
+    status?: string;
+}
+export interface RiskSignals {
+    highFanout: boolean;
+    unresolvedRefs: boolean;
+    recentlyTouched: boolean;
+    flags: string[];
+}
+export interface QualitySignals {
+    unresolvedCount: number;
+    hasStatus: boolean;
+}
+export interface ContextSignals {
+    focusIdeaId?: string;
+    relationship?: RelationshipSignals;
+    developmentHistory?: DevelopmentHistorySignals;
+    lifecycle?: LifecycleSignals;
+    risk?: RiskSignals;
+    quality?: QualitySignals;
+}
+export interface ContextSynthesis {
+    stability: number;
+    confidence: number;
+    aiRisk: ContextRiskLevel;
+    coverage: ContextCoverageLevel;
+    story: string;
+    stories: string[];
+}
+export interface ContextFingerprintAxes {
+    files: number;
+    requirements: number;
+    history: number;
+    architecture: number;
+    git: number;
+    diagnostics: number;
+    coverage: number;
+}
+export interface AiReadiness {
+    score: number;
+    ready: boolean;
+    checks: {
+        label: string;
+        ok: boolean;
+    }[];
+    risk: ContextRiskLevel;
+}
+export interface FocusSignalInput {
+    focusIdeaId?: string;
+    status?: string;
+    parentCount: number;
+    inboundCount: number;
+    outboundCount: number;
+    unresolvedCount: number;
+    createdAt?: string;
+    createdBy?: string;
+    modifiedAt?: string;
+    modifiedBy?: string;
+    commitCount?: number;
+    changeRate?: number;
+    relativeChangeRate?: number;
+    relativeChangeLabel?: 'cold' | 'typical' | 'hot' | 'very_hot';
+    authors?: string[];
+    now?: Date;
+}
+export declare function emptyContextSignals(): ContextSignals;
+export declare function emptyContextSynthesis(): ContextSynthesis;
+export declare function buildFocusSignals(input: FocusSignalInput): ContextSignals;
+export declare function synthesizeFocusContext(signals: ContextSignals): ContextSynthesis;
+export declare function formatSynthesisMarkdown(synthesis: ContextSynthesis): string;
+export declare function buildContextFingerprint(input: {
+    fileCount: number;
+    ideaCount: number;
+    historyCount: number;
+    hasArchitectureHint: boolean;
+    /** @deprecated Prefer gitCommitCount / gitAuthorCount; dirty-tree count is secondary. */
+    gitChangeCount?: number;
+    gitCommitCount?: number;
+    gitAuthorCount?: number;
+    anomalyCount: number;
+    coverage: ContextCoverageLevel;
+}): ContextFingerprintAxes;
+/** Overview of why context fingerprint / health bars matter for developers. */
+export declare const CONTEXT_FINGERPRINT_HELP: string;
+/** Per-axis semantic help for scope-pane tooltips and the fingerprint info panel. */
+export declare const CONTEXT_FINGERPRINT_AXIS_HELP: Record<keyof ContextFingerprintAxes, string>;
+export declare function fingerprintAxisTooltip(key: keyof ContextFingerprintAxes, value: number): string;
+export declare function buildAiReadiness(signals: ContextSignals, synthesis: ContextSynthesis): AiReadiness;
+export declare function formatFingerprintMarkdown(axes: ContextFingerprintAxes): string;
+export declare function formatAiReadinessMarkdown(readiness: AiReadiness): string;
+export declare function hotspotBandFromRisk(risk: ContextRiskLevel): ContextHotspotBand;
+export declare function hotspotBorderWidth(band?: ContextHotspotBand): number;
+export declare function hotspotBorderColor(band?: ContextHotspotBand): string;
+/** Opacity for impact-radius fade: selected = 1, 1 hop = 0.75, 2 hops = 0.45, farther = 0.2. */
+export declare function impactOpacityForHopDistance(distance: number | undefined): number;
+/** BFS hop distances from a center over undirected edges. */
+export declare function hopDistancesFromCenter(centerId: string, edges: {
+    sourceId: string;
+    targetId: string;
+}[]): Map<string, number>;
+/** Thin requirement-card cue from ref counts (Ideas Summary rows). */
+export declare function requirementCardCue(inboundCount: number, outboundCount: number): {
+    stability: number;
+    label: string;
+};
+/** Timeline milestones for the ribbon widget. */
+export declare function timelineMilestones(signals: ContextSignals, now?: Date): {
+    id: string;
+    label: string;
+    at: Date;
+}[];
+/** Two-point churn intensity 0–1 for the thin heat bar. */
+export declare function thinChurnIntensity(signals: ContextSignals): number;