@ai-agent-context/core 0.1.0

package/dist/core/decisions/detector.js

@@ -0,0 +1,256 @@
+import { compareStrings, shortHash } from "../../model/canonical.js";
+import { redactSecrets } from "../../adapters/filesystem/sensitive.js";
+import { truncate, formatDate } from "../../util/text.js";
+import { basename, stem } from "../../util/paths.js";
+const ADR_DIRECTORY = /(^|\/)(adr|adrs|decisions?|architecture\/decisions?)\//i;
+const ADR_FILENAME = /^(adr[-_]?)?(\d{2,4})[-_.]|^adr[-_]?\d*[-_.]/i;
+const ADR_HEADING = /^(adr[-_ ]?\d{1,4}|decision[-_ ]?\d{1,4})\s*[:\-–—]?\s*(.*)$/i;
+const STATUS_PATTERN = /\bstatus\b\s*[:\-]\s*(accepted|proposed|deprecated|superseded|rejected|draft|approved)/i;
+const DECISION_SECTION = /\b(decision|decisions|architecture decision|design decision|invariant|invariants|architecture)\b/i;
+const STATUS_MAP = {
+    accepted: 'accepted',
+    approved: 'accepted',
+    proposed: 'proposed',
+    draft: 'proposed',
+    deprecated: 'deprecated',
+    superseded: 'superseded',
+    rejected: 'rejected',
+};
+function readStringArray(value) {
+    return Array.isArray(value) ? value.filter((entry) => typeof entry === 'string') : [];
+}
+function normalizeStatus(raw) {
+    if (raw === undefined)
+        return 'unknown';
+    return STATUS_MAP[raw.toLowerCase()] ?? 'unknown';
+}
+/** Extracts an ADR from a markdown document, when the document looks like one. */
+export function parseAdrDocument(path, file) {
+    const headings = readStringArray(file.metadata['markdown.headings']);
+    const frontMatter = file.metadata['markdown.frontMatter'];
+    const front = typeof frontMatter === 'object' && frontMatter !== null ? frontMatter : {};
+    const paragraph = typeof file.metadata['markdown.firstParagraph'] === 'string'
+        ? file.metadata['markdown.firstParagraph']
+        : '';
+    const firstHeading = headings[0] ?? '';
+    const looksLikeAdr = ADR_DIRECTORY.test(path) ||
+        ADR_FILENAME.test(basename(path)) ||
+        ADR_HEADING.test(firstHeading) ||
+        front.status !== undefined;
+    if (!looksLikeAdr)
+        return null;
+    const filenameDigits = /(\d{2,4})/.exec(stem(path));
+    const headingMatch = ADR_HEADING.exec(firstHeading);
+    let id = null;
+    if (filenameDigits !== null)
+        id = `ADR-${filenameDigits[1].padStart(3, '0')}`;
+    else if (headingMatch !== null && /\d/.test(headingMatch[1])) {
+        id = `ADR-${headingMatch[1].replace(/[^0-9]/g, '').padStart(3, '0')}`;
+    }
+    else if (front.id !== undefined)
+        id = front.id.toUpperCase();
+    const cleanedHeading = headingMatch !== null ? headingMatch[2] : firstHeading;
+    const title = (front.title ?? cleanedHeading).trim();
+    const status = normalizeStatus(front.status ?? STATUS_PATTERN.exec(paragraph)?.[1]);
+    const excerptSource = paragraph.length > 0 ? paragraph : title;
+    return {
+        path,
+        id: id ?? `ADR-${shortHash(path, 6).toUpperCase()}`,
+        title: title.length > 0 ? title : `Decision recorded in ${path}`,
+        status,
+        excerpt: truncate(redactSecrets(excerptSource), 320),
+        explicitId: id !== null,
+    };
+}
+/** Explicit decisions: ADR documents and dedicated architecture documentation. */
+export function detectExplicitDecisions(input) {
+    const decisions = [];
+    const markdownFiles = [...input.parsed.values()]
+        .filter((file) => file.language === 'markdown')
+        .sort((a, b) => compareStrings(a.path, b.path));
+    for (const file of markdownFiles) {
+        const adr = parseAdrDocument(file.path, file);
+        if (adr === null)
+            continue;
+        decisions.push({
+            id: adr.id,
+            title: truncate(adr.title, 160),
+            status: adr.status,
+            source: adr.path,
+            origin: 'explicit',
+            kind: 'adr',
+            confidence: adr.status === 'unknown' ? 0.7 : 0.95,
+            evidence: [
+                {
+                    source: adr.path,
+                    detail: adr.explicitId ? 'document carries an ADR identifier' : 'document lives in a decision directory',
+                },
+                {
+                    source: adr.path,
+                    detail: adr.status === 'unknown'
+                        ? 'no explicit status found in front matter or body'
+                        : `status found in the document: ${adr.status}`,
+                },
+            ],
+            excerpt: adr.excerpt,
+        });
+    }
+    // Decision-like sections inside regular documentation (README, docs/*).
+    for (const file of markdownFiles) {
+        if (parseAdrDocument(file.path, file) !== null)
+            continue;
+        const headingDetails = file.metadata['markdown.headingDetails'];
+        if (!Array.isArray(headingDetails))
+            continue;
+        for (const heading of headingDetails) {
+            if (heading.level > 3 || !DECISION_SECTION.test(heading.title))
+                continue;
+            const isDedicatedDoc = /(^|\/)(architecture|design)(\.|\/)/i.test(file.path);
+            decisions.push({
+                id: `DOC-${shortHash(`${file.path}:${heading.line}`, 6).toUpperCase()}`,
+                title: truncate(heading.title, 160),
+                status: 'unknown',
+                source: `${file.path}#L${heading.line}`,
+                origin: isDedicatedDoc ? 'explicit' : 'inferred',
+                kind: 'documented-section',
+                confidence: isDedicatedDoc ? 0.6 : 0.45,
+                evidence: [
+                    { source: file.path, detail: `section "${heading.title}" (line ${heading.line}) matched decision vocabulary` },
+                    {
+                        source: file.path,
+                        detail: isDedicatedDoc
+                            ? 'document is a dedicated architecture document'
+                            : 'section may describe design context rather than a decision; verify before treating it as an ADR',
+                    },
+                ],
+            });
+            break;
+        }
+    }
+    return decisions;
+}
+/** Configuration and dependency facts presented as *inferred* decisions. */
+export function detectConfigDecisions(input) {
+    const decisions = [];
+    const workspace = input.repository.workspace;
+    if (workspace.rootPackage !== null) {
+        decisions.push({
+            id: 'INF-MODULE-FORMAT',
+            title: workspace.rootPackage.type === 'module'
+                ? 'Packages use ES modules ("type": "module")'
+                : 'Packages use CommonJS ("type": "commonjs")',
+            status: 'accepted',
+            source: 'package.json',
+            origin: 'inferred',
+            kind: 'config-signal',
+            confidence: 0.9,
+            evidence: [{ source: 'package.json', detail: `"type": "${workspace.rootPackage.type ?? 'commonjs'}"` }],
+        });
+    }
+    if (workspace.packageManager !== 'unknown') {
+        decisions.push({
+            id: 'INF-PACKAGE-MANAGER',
+            title: `Repository is maintained with ${workspace.packageManager}`,
+            status: 'accepted',
+            source: workspace.lockfiles[0] ?? 'package.json',
+            origin: 'inferred',
+            kind: 'config-signal',
+            confidence: 0.8,
+            evidence: workspace.packageManagerEvidence.slice(0, 3),
+        });
+    }
+    if (workspace.isMonorepo) {
+        decisions.push({
+            id: 'INF-WORKSPACES',
+            title: `Repository is organised as a workspace monorepo (${workspace.workspaceGlobs.join(', ')})`,
+            status: 'accepted',
+            source: 'package.json',
+            origin: 'inferred',
+            kind: 'config-signal',
+            confidence: 0.95,
+            evidence: [{ source: 'package.json', detail: `workspaces: ${workspace.workspaceGlobs.join(', ')}` }],
+        });
+    }
+    const strictConfigs = [...input.parsed.values()].filter((file) => file.metadata['tsconfig.strict'] === true);
+    if (strictConfigs.length > 0) {
+        decisions.push({
+            id: 'INF-STRICT-TS',
+            title: 'TypeScript strict mode is mandatory',
+            status: 'accepted',
+            source: strictConfigs[0].path,
+            origin: 'inferred',
+            kind: 'config-signal',
+            confidence: 0.95,
+            evidence: strictConfigs.slice(0, 3).map((file) => ({ source: file.path, detail: '"strict": true' })),
+        });
+    }
+    const noteworthy = input.repository.externalDependencies.filter((entry) => entry.importance.value === 'framework' || entry.importance.value === 'infrastructure');
+    for (const dependency of noteworthy.slice(0, 4)) {
+        decisions.push({
+            id: `INF-DEP-${dependency.name.replace(/[^A-Za-z0-9]+/g, '-').toUpperCase()}`,
+            title: `The repository builds on ${dependency.name} (heuristic: ${dependency.importance.value})`,
+            status: 'accepted',
+            source: 'package.json',
+            origin: 'inferred',
+            kind: 'dependency-signal',
+            confidence: Math.min(dependency.importance.confidence, 0.7),
+            evidence: [
+                { source: 'package.json', detail: `declared by ${dependency.declaredBy.join(', ') || 'the source code'}` },
+                { source: '<graph>', detail: `imported by ${dependency.importedByModules} module(s)` },
+            ],
+        });
+    }
+    return decisions;
+}
+/** Architectural change signals from git history, clearly marked as inferred. */
+export function detectGitDecisions(input) {
+    if (input.architectureSignalPatterns.length === 0)
+        return [];
+    const patterns = input.architectureSignalPatterns.map((pattern) => pattern.toLowerCase());
+    const signals = [];
+    const sortedCommits = [...input.gitCommits].sort((a, b) => b.dateMs - a.dateMs);
+    for (const commit of sortedCommits) {
+        const subject = commit.subject.toLowerCase();
+        if (!patterns.some((pattern) => subject.includes(pattern)))
+            continue;
+        signals.push({
+            id: `GIT-${commit.sha.slice(0, 8)}`,
+            title: truncate(redactSecrets(commit.subject), 160),
+            status: 'unknown',
+            source: `git:${commit.sha.slice(0, 8)}`,
+            origin: 'inferred',
+            kind: 'git-signal',
+            confidence: 0.45,
+            evidence: [
+                {
+                    source: `git:${commit.sha.slice(0, 8)}`,
+                    detail: `commit message matched an architectural keyword (${formatDate(commit.dateMs)}, ${commit.files.length} file(s) changed)`,
+                },
+            ],
+        });
+        if (signals.length >= 5)
+            break;
+    }
+    return signals;
+}
+/** Runs every decision detector; explicit decisions win id conflicts. */
+export function detectDecisions(input) {
+    const combined = [...detectExplicitDecisions(input), ...detectConfigDecisions(input), ...detectGitDecisions(input)];
+    const seenIds = new Set();
+    const result = [];
+    for (const decision of combined) {
+        if (seenIds.has(decision.id))
+            continue;
+        seenIds.add(decision.id);
+        result.push(decision);
+    }
+    return result.sort((a, b) => (a.origin === b.origin ? compareStrings(a.id, b.id) : a.origin === 'explicit' ? -1 : 1));
+}
+/** Paths of ADR documents, used by `explain` and search. */
+export function collectAdrPaths(parsed) {
+    return [...parsed.values()]
+        .filter((file) => file.language === 'markdown' && parseAdrDocument(file.path, file) !== null)
+        .map((file) => file.path)
+        .sort(compareStrings);
+}
+//# sourceMappingURL=detector.js.map

package/dist/core/decisions/detector.js.map

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

package/dist/core/diff/differ.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Context differ.
+ *
+ * Compares the previously persisted `.agent/` context with the freshly computed
+ * one and answers the questions an engineer has before committing: which files
+ * changed, which modules appeared, which architectural dependency moved, which
+ * conventions/decisions changed.
+ *
+ * Wording stays neutral: no "critical", no "unsafe" — just what changed.
+ */
+import type { ContextDiff } from '../../model/types.ts';
+import type { PersistedContext } from '../serialization/reader.ts';
+import type { ContextDocuments } from '../serialization/types.ts';
+export interface DiffOptions {
+    /** Previously persisted context; `null` when there is nothing to compare against. */
+    previous: PersistedContext | null;
+    /** Freshly computed documents. */
+    current: ContextDocuments;
+    /** Hash of the previous canonical context (from the local state). */
+    baselineHash?: string | null;
+}
+/** Computes the context diff. */
+export declare function diffContext(options: DiffOptions): ContextDiff;
+/** Stable hash of the generated documents, stored locally as the diff baseline. */
+export declare function hashDocuments(documents: ContextDocuments): string;
+//# sourceMappingURL=differ.d.ts.map

package/dist/core/diff/differ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../../../src/core/diff/differ.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAWlE,MAAM,WAAW,WAAW;IAC1B,qFAAqF;IACrF,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,kCAAkC;IAClC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAqBD,iCAAiC;AACjC,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAgI7D;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAQjE"}

package/dist/core/diff/differ.js

@@ -0,0 +1,159 @@
+import { compareStrings, hashValue } from "../../model/canonical.js";
+function difference(current, previous) {
+    const previousSet = new Set(previous);
+    return [...current].filter((entry) => !previousSet.has(entry)).sort(compareStrings);
+}
+function edgeKey(edge) {
+    return `${edge.from} -> ${edge.to}`;
+}
+function emptyDiff(current, baseline) {
+    return {
+        files: { added: [], modified: [], removed: [] },
+        modules: { added: [], removed: [], roleChanges: [] },
+        entryPoints: { added: [], removed: [] },
+        dependencies: { added: [], removed: [], externalAdded: [], externalRemoved: [] },
+        conventions: { added: [], removed: [], changed: [] },
+        decisions: { added: [], removed: [] },
+        statistics: {
+            files: current.index.repository.counts.files,
+            modules: current.index.repository.counts.modules,
+            dependencies: current.index.repository.counts.dependencies,
+            entries: current.index.repository.counts.entryPoints,
+        },
+        hasChanges: false,
+        baseline,
+    };
+}
+/** Computes the context diff. */
+export function diffContext(options) {
+    const { previous, current } = options;
+    const baseline = options.baselineHash ?? null;
+    if (previous === null || previous.index === null)
+        return emptyDiff(current, baseline);
+    const previousFiles = new Map(previous.index.files.entries.map((entry) => [entry.path, entry.hash]));
+    const currentFiles = new Map(current.index.files.entries.map((entry) => [entry.path, entry.hash]));
+    const addedFiles = [];
+    const modifiedFiles = [];
+    for (const [file, hash] of currentFiles) {
+        const before = previousFiles.get(file);
+        if (before === undefined)
+            addedFiles.push(file);
+        else if (before !== hash)
+            modifiedFiles.push(file);
+    }
+    const removedFiles = [...previousFiles.keys()].filter((file) => !currentFiles.has(file));
+    const previousModules = new Map((previous.architecture?.modules ?? []).map((module) => [module.id, module]));
+    const currentModules = new Map(current.architecture.modules.map((module) => [module.id, module]));
+    const modulesAdded = difference([...currentModules.keys()], [...previousModules.keys()]);
+    const modulesRemoved = difference([...previousModules.keys()], [...currentModules.keys()]);
+    const roleChanges = [];
+    for (const [id, module] of currentModules) {
+        const before = previousModules.get(id);
+        if (before === undefined)
+            continue;
+        const beforeRoles = before.roles.map((role) => role.value);
+        const afterRoles = module.roles.map((role) => role.value);
+        const addedRoles = difference(afterRoles, beforeRoles);
+        const removedRoles = difference(beforeRoles, afterRoles);
+        if (addedRoles.length > 0 || removedRoles.length > 0) {
+            roleChanges.push({ moduleId: id, added: addedRoles, removed: removedRoles });
+        }
+    }
+    roleChanges.sort((a, b) => compareStrings(a.moduleId, b.moduleId));
+    const previousEntries = (previous.architecture?.entryPoints ?? []).map((entry) => `${entry.path} (${entry.type})`);
+    const currentEntries = current.architecture.entryPoints.map((entry) => `${entry.path} (${entry.type})`);
+    const previousEdges = (previous.dependencies?.internal ?? []).map((edge) => edgeKey(edge));
+    const currentEdges = current.dependencies.internal.map((edge) => edgeKey(edge));
+    const addedEdgeKeys = difference(currentEdges, previousEdges);
+    const removedEdgeKeys = difference(previousEdges, currentEdges);
+    const currentEdgeByKey = new Map(current.dependencies.internal.map((edge) => [edgeKey(edge), edge]));
+    const previousEdgeByKey = new Map((previous.dependencies?.internal ?? []).map((edge) => [edgeKey(edge), edge]));
+    const previousExternal = (previous.dependencies?.external ?? []).map((entry) => entry.name);
+    const currentExternal = current.dependencies.external.map((entry) => entry.name);
+    const previousConventions = new Map((previous.conventions?.conventions ?? []).map((entry) => [entry.id, entry.statement]));
+    const currentConventions = new Map(current.conventions.conventions.map((entry) => [entry.id, entry.statement]));
+    const conventionsChanged = [];
+    for (const [id, statement] of currentConventions) {
+        const before = previousConventions.get(id);
+        if (before !== undefined && before !== statement) {
+            conventionsChanged.push(`${id}: "${before}" → "${statement}"`);
+        }
+    }
+    const previousDecisions = (previous.decisions?.decisions ?? []).map((entry) => `${entry.id} ${entry.title}`);
+    const currentDecisions = current.decisions.decisions.map((entry) => `${entry.id} ${entry.title}`);
+    const diff = {
+        files: {
+            added: addedFiles.sort(compareStrings),
+            modified: modifiedFiles.sort(compareStrings),
+            removed: removedFiles.sort(compareStrings),
+        },
+        modules: { added: modulesAdded, removed: modulesRemoved, roleChanges },
+        entryPoints: {
+            added: difference(currentEntries, previousEntries),
+            removed: difference(previousEntries, currentEntries),
+        },
+        dependencies: {
+            added: addedEdgeKeys.flatMap((key) => {
+                const edge = currentEdgeByKey.get(key);
+                return edge === undefined
+                    ? []
+                    : [{ from: edge.from, to: edge.to, relationship: 'depends-on', kind: edge.kind }];
+            }),
+            removed: removedEdgeKeys.flatMap((key) => {
+                const edge = previousEdgeByKey.get(key);
+                return edge === undefined
+                    ? []
+                    : [{ from: edge.from, to: edge.to, relationship: 'depends-on', kind: edge.kind }];
+            }),
+            externalAdded: difference(currentExternal, previousExternal),
+            externalRemoved: difference(previousExternal, currentExternal),
+        },
+        conventions: {
+            added: difference([...currentConventions.keys()], [...previousConventions.keys()]),
+            removed: difference([...previousConventions.keys()], [...currentConventions.keys()]),
+            changed: conventionsChanged.sort(compareStrings),
+        },
+        decisions: {
+            added: difference(currentDecisions, previousDecisions),
+            removed: difference(previousDecisions, currentDecisions),
+        },
+        statistics: {
+            files: current.index.repository.counts.files,
+            modules: current.index.repository.counts.modules,
+            dependencies: current.index.repository.counts.dependencies,
+            entries: current.index.repository.counts.entryPoints,
+        },
+        hasChanges: false,
+        baseline,
+    };
+    diff.hasChanges =
+        diff.files.added.length > 0 ||
+            diff.files.modified.length > 0 ||
+            diff.files.removed.length > 0 ||
+            diff.modules.added.length > 0 ||
+            diff.modules.removed.length > 0 ||
+            diff.modules.roleChanges.length > 0 ||
+            diff.entryPoints.added.length > 0 ||
+            diff.entryPoints.removed.length > 0 ||
+            diff.dependencies.added.length > 0 ||
+            diff.dependencies.removed.length > 0 ||
+            diff.dependencies.externalAdded.length > 0 ||
+            diff.dependencies.externalRemoved.length > 0 ||
+            diff.conventions.added.length > 0 ||
+            diff.conventions.removed.length > 0 ||
+            diff.conventions.changed.length > 0 ||
+            diff.decisions.added.length > 0 ||
+            diff.decisions.removed.length > 0;
+    return diff;
+}
+/** Stable hash of the generated documents, stored locally as the diff baseline. */
+export function hashDocuments(documents) {
+    return hashValue({
+        index: { ...documents.index, generatedAt: undefined },
+        architecture: { ...documents.architecture, generatedAt: undefined },
+        dependencies: { ...documents.dependencies, generatedAt: undefined },
+        conventions: { ...documents.conventions, generatedAt: undefined },
+        decisions: { ...documents.decisions, generatedAt: undefined },
+    });
+}
+//# sourceMappingURL=differ.js.map

package/dist/core/diff/differ.js.map

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

package/dist/core/git-analysis/activity.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Git activity analysis.
+ *
+ * Terminology is deliberately neutral: `historicalChanges`, `recentChanges`,
+ * `changeFrequency`, `lastChanged`. A frequently changed file is *not* labelled
+ * critical — the numbers are reported and the reader decides.
+ *
+ * All data comes from `git log`, executed locally by GitAdapter.
+ */
+import type { ChangeFrequency, FileNode, GitFileSignals, GitModuleSignals, ModuleNode } from '../../model/types.ts';
+import type { GitCommit } from '../../adapters/git/git-adapter.ts';
+export interface GitActivityInput {
+    commits: GitCommit[];
+    files: FileNode[];
+    modules: ModuleNode[];
+    /** Window (days) counted as "recent activity". */
+    recentDays: number;
+    /** Patterns that mark a commit message as an architectural change signal. */
+    architectureSignalPatterns: string[];
+    /** Injectable clock (tests). */
+    now?: number;
+}
+export interface GitActivityResult {
+    fileSignals: Map<string, GitFileSignals>;
+    moduleSignals: Map<string, GitModuleSignals>;
+    /** Number of commits inspected. */
+    commitCount: number;
+}
+/** Buckets a count against the quantiles of the repository distribution. */
+export declare function bucket(count: number, lowThreshold: number, highThreshold: number): ChangeFrequency;
+/** Computes per-file and per-module git signals from the parsed commit history. */
+export declare function computeGitActivity(input: GitActivityInput): GitActivityResult;
+/** Attaches the computed module signals to the repository modules. */
+export declare function applyGitSignals(modules: ModuleNode[], activity: GitActivityResult): void;
+//# sourceMappingURL=activity.d.ts.map

package/dist/core/git-analysis/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/core/git-analysis/activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACpH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAanE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,0BAA0B,EAAE,MAAM,EAAE,CAAC;IACrC,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4EAA4E;AAC5E,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,eAAe,CAKlG;AAQD,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,iBAAiB,CAoG7E;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAIxF"}

package/dist/core/git-analysis/activity.js

@@ -0,0 +1,123 @@
+import { compareStrings } from "../../model/canonical.js";
+import { formatDate, truncate } from "../../util/text.js";
+const MS_PER_DAY = 86_400_000;
+/** Buckets a count against the quantiles of the repository distribution. */
+export function bucket(count, lowThreshold, highThreshold) {
+    if (count <= 0)
+        return 'none';
+    if (count >= highThreshold)
+        return 'high';
+    if (count >= lowThreshold)
+        return 'medium';
+    return 'low';
+}
+function quantile(sorted, fraction) {
+    if (sorted.length === 0)
+        return 0;
+    const index = Math.min(sorted.length - 1, Math.max(0, Math.round(fraction * (sorted.length - 1))));
+    return sorted[index] ?? 0;
+}
+/** Computes per-file and per-module git signals from the parsed commit history. */
+export function computeGitActivity(input) {
+    const now = input.now ?? Date.now();
+    const recentWindowStart = now - input.recentDays * MS_PER_DAY;
+    const moduleByFile = new Map();
+    for (const module of input.modules) {
+        for (const file of module.files)
+            moduleByFile.set(file, module.id);
+    }
+    const knownFiles = new Set(input.files.map((file) => file.path));
+    const fileActivity = new Map();
+    const moduleActivity = new Map();
+    const architectureSignals = new Map();
+    const patterns = input.architectureSignalPatterns.map((pattern) => pattern.toLowerCase());
+    const ensure = (map, key) => {
+        let record = map.get(key);
+        if (record === undefined) {
+            record = { shas: new Set(), recentShas: new Set(), lastDateMs: 0, authors: new Map() };
+            map.set(key, record);
+        }
+        return record;
+    };
+    let commitCount = 0;
+    for (const commit of input.commits) {
+        commitCount += 1;
+        const isRecent = commit.dateMs >= recentWindowStart;
+        const touchesArchitecture = patterns.some((pattern) => commit.subject.toLowerCase().includes(pattern));
+        const modulesTouched = new Set();
+        for (const rawPath of commit.files) {
+            const path = rawPath.replace(/\\/g, '/');
+            if (!knownFiles.has(path))
+                continue;
+            const activity = ensure(fileActivity, path);
+            activity.shas.add(commit.sha);
+            if (isRecent)
+                activity.recentShas.add(commit.sha);
+            activity.lastDateMs = Math.max(activity.lastDateMs, commit.dateMs);
+            activity.authors.set(commit.author, (activity.authors.get(commit.author) ?? 0) + 1);
+            const moduleId = moduleByFile.get(path);
+            if (moduleId === undefined)
+                continue;
+            const moduleRecord = ensure(moduleActivity, moduleId);
+            moduleRecord.shas.add(commit.sha);
+            if (isRecent)
+                moduleRecord.recentShas.add(commit.sha);
+            moduleRecord.lastDateMs = Math.max(moduleRecord.lastDateMs, commit.dateMs);
+            moduleRecord.authors.set(commit.author, (moduleRecord.authors.get(commit.author) ?? 0) + 1);
+            modulesTouched.add(moduleId);
+        }
+        if (touchesArchitecture && commit.sha.length > 0) {
+            for (const moduleId of modulesTouched) {
+                const list = architectureSignals.get(moduleId) ?? [];
+                if (list.length < 5) {
+                    list.push({
+                        sha: commit.sha.slice(0, 8),
+                        date: formatDate(commit.dateMs),
+                        subject: truncate(commit.subject, 120),
+                    });
+                }
+                architectureSignals.set(moduleId, list);
+            }
+        }
+    }
+    const fileCounts = [...fileActivity.values()].map((activity) => activity.shas.size).sort((a, b) => a - b);
+    const moduleCounts = [...moduleActivity.values()].map((activity) => activity.shas.size).sort((a, b) => a - b);
+    const fileLow = quantile(fileCounts, 0.33);
+    const fileHigh = quantile(fileCounts, 0.66);
+    const moduleLow = quantile(moduleCounts, 0.33);
+    const moduleHigh = quantile(moduleCounts, 0.66);
+    const fileSignals = new Map();
+    for (const [path, activity] of fileActivity) {
+        fileSignals.set(path, {
+            historicalChanges: activity.shas.size,
+            recentChanges: activity.recentShas.size,
+            lastChanged: activity.lastDateMs > 0 ? formatDate(activity.lastDateMs) : null,
+            changeFrequency: bucket(activity.shas.size, Math.max(1, fileLow), Math.max(2, fileHigh)),
+            contributorCount: activity.authors.size,
+        });
+    }
+    const moduleSignals = new Map();
+    for (const [moduleId, activity] of moduleActivity) {
+        const topContributors = [...activity.authors.entries()]
+            .map(([name, commits]) => ({ name, commits }))
+            .sort((a, b) => (b.commits === a.commits ? compareStrings(a.name, b.name) : b.commits - a.commits))
+            .slice(0, 3);
+        moduleSignals.set(moduleId, {
+            historicalChanges: activity.shas.size,
+            recentChanges: activity.recentShas.size,
+            lastChanged: activity.lastDateMs > 0 ? formatDate(activity.lastDateMs) : null,
+            changeFrequency: bucket(activity.shas.size, Math.max(1, moduleLow), Math.max(2, moduleHigh)),
+            contributorCount: activity.authors.size,
+            topContributors,
+            architectureChangeSignals: architectureSignals.get(moduleId) ?? [],
+        });
+    }
+    return { fileSignals, moduleSignals, commitCount };
+}
+/** Attaches the computed module signals to the repository modules. */
+export function applyGitSignals(modules, activity) {
+    for (const module of modules) {
+        module.git = activity.moduleSignals.get(module.id) ?? null;
+    }
+}
+//# sourceMappingURL=activity.js.map