@summer_icicle/time-traveler 0.1.0

package/dist/git/GitHistoryAnalyzer.js

@@ -0,0 +1,97 @@
+export class GitHistoryAnalyzer {
+    analyze(commits) {
+        if (commits.length === 0) {
+            return {
+                commitCount: 0,
+                totalInsertions: 0,
+                totalDeletions: 0,
+                totalFilesChanged: 0,
+                totalLinesChanged: 0,
+                averageInsertionsPerCommit: 0,
+                averageDeletionsPerCommit: 0,
+                averageFilesChangedPerCommit: 0,
+                averageLinesChangedPerCommit: 0,
+                repositoryAgeDays: 0,
+                commitsPerDay: 0,
+                busiestHour: null,
+                churnRatio: 0
+            };
+        }
+        let totalInsertions = 0;
+        let totalDeletions = 0;
+        let totalFilesChanged = 0;
+        const hourCounts = new Array(24).fill(0);
+        for (const commit of commits) {
+            totalInsertions += commit.insertions;
+            totalDeletions += commit.deletions;
+            totalFilesChanged += commit.filesChanged;
+            const hour = commit.date.getHours();
+            hourCounts[hour] += 1;
+        }
+        const commitCount = commits.length;
+        const totalLinesChanged = totalInsertions + totalDeletions;
+        const averageInsertionsPerCommit = totalInsertions / commitCount;
+        const averageDeletionsPerCommit = totalDeletions / commitCount;
+        const averageFilesChangedPerCommit = totalFilesChanged / commitCount;
+        const averageLinesChangedPerCommit = totalLinesChanged / commitCount;
+        const repositoryAgeDays = this.calculateRepositoryAgeDays(commits);
+        const commitsPerDay = repositoryAgeDays > 0
+            ? commitCount / repositoryAgeDays
+            : commitCount;
+        const busiestHour = this.findBusiestHour(hourCounts);
+        const churnRatio = totalLinesChanged > 0
+            ? totalDeletions / totalLinesChanged
+            : 0;
+        return {
+            commitCount,
+            totalInsertions,
+            totalDeletions,
+            totalFilesChanged,
+            totalLinesChanged,
+            averageInsertionsPerCommit,
+            averageDeletionsPerCommit,
+            averageFilesChangedPerCommit,
+            averageLinesChangedPerCommit,
+            repositoryAgeDays,
+            commitsPerDay,
+            busiestHour,
+            churnRatio
+        };
+    }
+    calculateRepositoryAgeDays(commits) {
+        const firstCommit = commits[0];
+        if (firstCommit === undefined) {
+            return 0;
+        }
+        let oldest = firstCommit.date.getTime();
+        let newest = oldest;
+        for (let index = 1; index < commits.length; index += 1) {
+            const commit = commits[index];
+            if (commit === undefined) {
+                continue;
+            }
+            const timestamp = commit.date.getTime();
+            if (timestamp < oldest) {
+                oldest = timestamp;
+            }
+            if (timestamp > newest) {
+                newest = timestamp;
+            }
+        }
+        const millisecondsPerDay = 1000 * 60 * 60 * 24;
+        const difference = newest - oldest;
+        return Math.max(1, difference / millisecondsPerDay);
+    }
+    findBusiestHour(hourCounts) {
+        let busiestHour = 0;
+        let highestCount = 0;
+        for (let hour = 0; hour < hourCounts.length; hour += 1) {
+            if (hourCounts[hour] > highestCount) {
+                highestCount = hourCounts[hour];
+                busiestHour = hour;
+            }
+        }
+        return busiestHour;
+    }
+}
+//# sourceMappingURL=GitHistoryAnalyzer.js.map

package/dist/git/GitHistoryAnalyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHistoryAnalyzer.js","sourceRoot":"","sources":["../../src/git/GitHistoryAnalyzer.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,kBAAkB;IACtB,OAAO,CAAC,OAAoB;QACjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,WAAW,EAAE,CAAC;gBAEd,eAAe,EAAE,CAAC;gBAClB,cAAc,EAAE,CAAC;gBACjB,iBAAiB,EAAE,CAAC;gBAEpB,iBAAiB,EAAE,CAAC;gBAEpB,0BAA0B,EAAE,CAAC;gBAC7B,yBAAyB,EAAE,CAAC;gBAC5B,4BAA4B,EAAE,CAAC;gBAC/B,4BAA4B,EAAE,CAAC;gBAE/B,iBAAiB,EAAE,CAAC;gBACpB,aAAa,EAAE,CAAC;gBAEhB,WAAW,EAAE,IAAI;gBAEjB,UAAU,EAAE,CAAC;aACd,CAAC;QACJ,CAAC;QAED,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAE1B,MAAM,UAAU,GAAG,IAAI,KAAK,CAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAEjD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,eAAe,IAAI,MAAM,CAAC,UAAU,CAAC;YACrC,cAAc,IAAI,MAAM,CAAC,SAAS,CAAC;YACnC,iBAAiB,IAAI,MAAM,CAAC,YAAY,CAAC;YAEzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAEpC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;QAEnC,MAAM,iBAAiB,GACrB,eAAe,GAAG,cAAc,CAAC;QAEnC,MAAM,0BAA0B,GAC9B,eAAe,GAAG,WAAW,CAAC;QAEhC,MAAM,yBAAyB,GAC7B,cAAc,GAAG,WAAW,CAAC;QAE/B,MAAM,4BAA4B,GAChC,iBAAiB,GAAG,WAAW,CAAC;QAElC,MAAM,4BAA4B,GAChC,iBAAiB,GAAG,WAAW,CAAC;QAElC,MAAM,iBAAiB,GACrB,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;QAE3C,MAAM,aAAa,GACjB,iBAAiB,GAAG,CAAC;YACnB,CAAC,CAAC,WAAW,GAAG,iBAAiB;YACjC,CAAC,CAAC,WAAW,CAAC;QAElB,MAAM,WAAW,GACf,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;QAEnC,MAAM,UAAU,GACd,iBAAiB,GAAG,CAAC;YACnB,CAAC,CAAC,cAAc,GAAG,iBAAiB;YACpC,CAAC,CAAC,CAAC,CAAC;QAER,OAAO;YACL,WAAW;YAEX,eAAe;YACf,cAAc;YACd,iBAAiB;YAEjB,iBAAiB;YAEjB,0BAA0B;YAC1B,yBAAyB;YACzB,4BAA4B;YAC5B,4BAA4B;YAE5B,iBAAiB;YACjB,aAAa;YAEb,WAAW;YAEX,UAAU;SACX,CAAC;IACJ,CAAC;IAEO,0BAA0B,CAChC,OAAoB;QAEpB,MAAM,WAAW,GACf,OAAO,CAAC,CAAC,CAAC,CAAC;QAEb,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,MAAM,GACR,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAE7B,IAAI,MAAM,GACR,MAAM,CAAC;QAET,KACE,IAAI,KAAK,GAAG,CAAC,EACb,KAAK,GAAG,OAAO,CAAC,MAAM,EACtB,KAAK,IAAI,CAAC,EACV,CAAC;YACD,MAAM,MAAM,GACV,OAAO,CAAC,KAAK,CAAC,CAAC;YAEjB,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GACb,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAExB,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;gBACvB,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;YAED,IAAI,SAAS,GAAG,MAAM,EAAE,CAAC;gBACvB,MAAM,GAAG,SAAS,CAAC;YACrB,CAAC;QACH,CAAC;QAED,MAAM,kBAAkB,GACtB,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAEtB,MAAM,UAAU,GACd,MAAM,GAAG,MAAM,CAAC;QAElB,OAAO,IAAI,CAAC,GAAG,CACb,CAAC,EACD,UAAU,GAAG,kBAAkB,CAChC,CAAC;IACJ,CAAC;IAEO,eAAe,CACrB,UAAoB;QAEpB,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,KACE,IAAI,IAAI,GAAG,CAAC,EACZ,IAAI,GAAG,UAAU,CAAC,MAAM,EACxB,IAAI,IAAI,CAAC,EACT,CAAC;YACD,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,YAAY,EAAE,CAAC;gBACpC,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;gBAChC,WAAW,GAAG,IAAI,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;CACF"}

package/dist/git/GitHistoryParser.d.ts

@@ -0,0 +1,7 @@
+import type { GitCommit } from "./GitCommit.js";
+export declare class GitHistoryParser {
+    parse(rawHistory: string): GitCommit[];
+    parseStream(chunks: AsyncIterable<string>): Promise<GitCommit[]>;
+    private parseLines;
+    private processLine;
+}

package/dist/git/GitHistoryParser.js

@@ -0,0 +1,97 @@
+const FIELD_SEPARATOR = "\x1f";
+export class GitHistoryParser {
+    parse(rawHistory) {
+        return this.parseLines(rawHistory.split(/\r?\n/));
+    }
+    async parseStream(chunks) {
+        const commits = [];
+        let currentCommit = null;
+        let remainder = "";
+        for await (const chunk of chunks) {
+            const text = remainder +
+                chunk;
+            const lines = text.split(/\r?\n/);
+            remainder =
+                lines.pop() ?? "";
+            for (const line of lines) {
+                currentCommit =
+                    this.processLine(line, currentCommit, commits);
+            }
+        }
+        if (remainder.length > 0) {
+            currentCommit =
+                this.processLine(remainder, currentCommit, commits);
+        }
+        if (currentCommit !== null) {
+            commits.push(currentCommit);
+        }
+        return commits;
+    }
+    parseLines(lines) {
+        const commits = [];
+        let currentCommit = null;
+        for (const line of lines) {
+            currentCommit =
+                this.processLine(line, currentCommit, commits);
+        }
+        if (currentCommit !== null) {
+            commits.push(currentCommit);
+        }
+        return commits;
+    }
+    processLine(line, currentCommit, commits) {
+        if (line.includes(FIELD_SEPARATOR)) {
+            if (currentCommit !== null) {
+                commits.push(currentCommit);
+            }
+            const fields = line.split(FIELD_SEPARATOR);
+            const [hash, authorName, authorEmail, date, message] = fields;
+            if (hash === undefined ||
+                authorName === undefined ||
+                authorEmail === undefined ||
+                date === undefined ||
+                message === undefined) {
+                return null;
+            }
+            return {
+                hash,
+                authorName,
+                authorEmail,
+                date: new Date(date),
+                message,
+                insertions: 0,
+                deletions: 0,
+                filesChanged: 0
+            };
+        }
+        if (currentCommit === null) {
+            return null;
+        }
+        if (line.length === 0) {
+            return currentCommit;
+        }
+        const parts = line.split("\t");
+        if (parts.length < 3) {
+            return currentCommit;
+        }
+        const [insertionsText, deletionsText] = parts;
+        currentCommit.filesChanged +=
+            1;
+        if (insertionsText !== "-") {
+            const insertions = Number(insertionsText);
+            if (Number.isFinite(insertions)) {
+                currentCommit.insertions +=
+                    insertions;
+            }
+        }
+        if (deletionsText !== "-") {
+            const deletions = Number(deletionsText);
+            if (Number.isFinite(deletions)) {
+                currentCommit.deletions +=
+                    deletions;
+            }
+        }
+        return currentCommit;
+    }
+}
+//# sourceMappingURL=GitHistoryParser.js.map

package/dist/git/GitHistoryParser.js.map

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

package/dist/git/GitHistoryStats.d.ts

@@ -0,0 +1,15 @@
+export interface GitHistoryStats {
+    commitCount: number;
+    totalInsertions: number;
+    totalDeletions: number;
+    totalFilesChanged: number;
+    totalLinesChanged: number;
+    averageInsertionsPerCommit: number;
+    averageDeletionsPerCommit: number;
+    averageFilesChangedPerCommit: number;
+    averageLinesChangedPerCommit: number;
+    repositoryAgeDays: number;
+    commitsPerDay: number;
+    busiestHour: number | null;
+    churnRatio: number;
+}

package/dist/git/GitHistoryStats.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=GitHistoryStats.js.map

package/dist/git/GitHistoryStats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHistoryStats.js","sourceRoot":"","sources":["../../src/git/GitHistoryStats.ts"],"names":[],"mappings":""}

package/dist/git/GitRepository.d.ts

@@ -0,0 +1,10 @@
+export declare class GitRepository {
+    private readonly workingDirectory;
+    constructor(workingDirectory: string);
+    isRepository(): Promise<boolean>;
+    hasCommits(): Promise<boolean>;
+    getCurrentBranch(): Promise<string>;
+    branchExists(branch: string): Promise<boolean>;
+    streamHistory(branch?: string): AsyncGenerator<string>;
+    private createLogArguments;
+}

package/dist/git/GitRepository.js

@@ -0,0 +1,115 @@
+import { execFile, spawn } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export class GitRepository {
+    workingDirectory;
+    constructor(workingDirectory) {
+        this.workingDirectory = workingDirectory;
+    }
+    async isRepository() {
+        try {
+            await execFileAsync("git", [
+                "rev-parse",
+                "--is-inside-work-tree"
+            ], {
+                cwd: this.workingDirectory
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async hasCommits() {
+        try {
+            await execFileAsync("git", [
+                "rev-parse",
+                "--verify",
+                "HEAD"
+            ], {
+                cwd: this.workingDirectory
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getCurrentBranch() {
+        const { stdout } = await execFileAsync("git", [
+            "branch",
+            "--show-current"
+        ], {
+            cwd: this.workingDirectory
+        });
+        const branch = stdout.trim();
+        if (branch.length > 0) {
+            return branch;
+        }
+        const { stdout: shortHash } = await execFileAsync("git", [
+            "rev-parse",
+            "--short",
+            "HEAD"
+        ], {
+            cwd: this.workingDirectory
+        });
+        return `detached-${shortHash.trim()}`;
+    }
+    async branchExists(branch) {
+        try {
+            await execFileAsync("git", [
+                "show-ref",
+                "--verify",
+                "--quiet",
+                `refs/heads/${branch}`
+            ], {
+                cwd: this.workingDirectory
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async *streamHistory(branch) {
+        const args = this.createLogArguments(branch);
+        const git = spawn("git", args, {
+            cwd: this.workingDirectory,
+            stdio: [
+                "ignore",
+                "pipe",
+                "pipe"
+            ]
+        });
+        let stderr = "";
+        git.stderr.setEncoding("utf8");
+        git.stderr.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        const exitPromise = new Promise((resolve, reject) => {
+            git.on("error", reject);
+            git.on("close", resolve);
+        });
+        git.stdout.setEncoding("utf8");
+        for await (const chunk of git.stdout) {
+            yield chunk;
+        }
+        const exitCode = await exitPromise;
+        if (exitCode !== 0) {
+            throw new Error(stderr ||
+                `Git exited with code ${exitCode}.`);
+        }
+    }
+    createLogArguments(branch) {
+        const args = [
+            "log",
+            "--format=%H%x1f%an%x1f%ae%x1f%aI%x1f%s",
+            "--numstat"
+        ];
+        if (branch !== undefined) {
+            args.push(`refs/heads/${branch}`);
+        }
+        return args;
+    }
+}
+//# sourceMappingURL=GitRepository.js.map

package/dist/git/GitRepository.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { registerAnalyzeCommand } from "./cli/commands/analyze.js";
+import { registerExportCommand } from "./cli/commands/export.js";
+import { registerPlayCommand } from "./cli/commands/play.js";
+const program = new Command();
+program
+    .name("time-traveler")
+    .description("Turn your Git history into music")
+    .version("0.1.0");
+registerAnalyzeCommand(program);
+registerExportCommand(program);
+registerPlayCommand(program);
+program.parseAsync();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAE7B,OAAO,CAAC,UAAU,EAAE,CAAC"}

package/dist/music/MusicComposer.d.ts

@@ -0,0 +1,13 @@
+import type { GitCommit } from "../git/GitCommit.js";
+import type { MusicProfile } from "./MusicProfile.js";
+import type { MusicEvent } from "./MusicEvent.js";
+export declare class MusicComposer {
+    compose(profile: MusicProfile, commits: GitCommit[]): MusicEvent[];
+    private aggregateLargeHistory;
+    private chooseScaleDegree;
+    private chooseOctave;
+    private calculateTensionOffset;
+    private calculateMelodyDuration;
+    private calculateAmplitude;
+    private calculateSpacing;
+}

package/dist/music/MusicComposer.js

@@ -0,0 +1,257 @@
+import { SCALE_INTERVALS } from "./scales.js";
+import { noteToMidi, midiToFrequency } from "./midi.js";
+import { normalize } from "./normalize.js";
+export class MusicComposer {
+    compose(profile, commits) {
+        if (commits.length === 0) {
+            return [];
+        }
+        const events = [];
+        const rootMidi = noteToMidi(profile.rootNote, 4);
+        const scaleIntervals = SCALE_INTERVALS[profile.scale];
+        const secondsPerBeat = 60 / profile.tempo;
+        const chronologicalCommits = [...commits].sort((a, b) => a.date.getTime() -
+            b.date.getTime());
+        const musicalCommits = this.aggregateLargeHistory(chronologicalCommits);
+        let maximumLinesChanged = 1;
+        let maximumFilesChanged = 1;
+        for (const commit of musicalCommits) {
+            const linesChanged = commit.insertions +
+                commit.deletions;
+            if (linesChanged >
+                maximumLinesChanged) {
+                maximumLinesChanged =
+                    linesChanged;
+            }
+            if (commit.filesChanged >
+                maximumFilesChanged) {
+                maximumFilesChanged =
+                    commit.filesChanged;
+            }
+        }
+        let currentTime = 0;
+        for (let index = 0; index < musicalCommits.length; index += 1) {
+            const commit = musicalCommits[index];
+            if (commit === undefined) {
+                continue;
+            }
+            const linesChanged = commit.insertions +
+                commit.deletions;
+            const size = normalize(linesChanged, 0, maximumLinesChanged);
+            const fileComplexity = normalize(commit.filesChanged, 0, maximumFilesChanged);
+            const deletionRatio = linesChanged > 0
+                ? commit.deletions /
+                    linesChanged
+                : 0;
+            const scaleDegree = this.chooseScaleDegree(commit, scaleIntervals.length);
+            const melodyOctave = this.chooseOctave(commit);
+            const melodyMidi = rootMidi +
+                scaleIntervals[scaleDegree] +
+                (melodyOctave - 4) *
+                    12 +
+                this.calculateTensionOffset(deletionRatio);
+            const melodyFrequency = midiToFrequency(melodyMidi);
+            const melodyDuration = this.calculateMelodyDuration(secondsPerBeat, fileComplexity);
+            const melodyAmplitude = this.calculateAmplitude(profile, size, "melody");
+            events.push({
+                startTime: currentTime,
+                duration: melodyDuration,
+                frequency: melodyFrequency,
+                amplitude: melodyAmplitude,
+                waveform: profile.waveform,
+                layer: "melody",
+                commitHash: commit.hash
+            });
+            const bassMidi = rootMidi -
+                12 +
+                scaleIntervals[scaleDegree %
+                    scaleIntervals.length];
+            events.push({
+                startTime: currentTime,
+                duration: secondsPerBeat *
+                    (2 +
+                        fileComplexity),
+                frequency: midiToFrequency(bassMidi),
+                amplitude: this.calculateAmplitude(profile, size, "bass"),
+                waveform: "sine",
+                layer: "bass",
+                commitHash: commit.hash
+            });
+            const padDuration = secondsPerBeat *
+                (3 +
+                    fileComplexity *
+                        3);
+            const chordDegrees = [
+                scaleDegree,
+                scaleDegree + 2,
+                scaleDegree + 4
+            ];
+            for (const chordDegree of chordDegrees) {
+                const wrappedDegree = chordDegree %
+                    scaleIntervals.length;
+                const octaveShift = Math.floor(chordDegree /
+                    scaleIntervals.length) *
+                    12;
+                const padMidi = rootMidi +
+                    scaleIntervals[wrappedDegree] +
+                    octaveShift;
+                events.push({
+                    startTime: currentTime,
+                    duration: padDuration,
+                    frequency: midiToFrequency(padMidi),
+                    amplitude: this.calculateAmplitude(profile, size, "pad"),
+                    waveform: "sine",
+                    layer: "pad",
+                    commitHash: commit.hash
+                });
+            }
+            currentTime +=
+                this.calculateSpacing(musicalCommits, index, secondsPerBeat, commits.length);
+        }
+        return events;
+    }
+    aggregateLargeHistory(commits) {
+        const aggregationThreshold = 1000;
+        if (commits.length <=
+            aggregationThreshold) {
+            return commits;
+        }
+        const targetCount = Math.round(600 +
+            Math.log10(commits.length /
+                aggregationThreshold) *
+                120);
+        const bucketSize = Math.ceil(commits.length /
+            targetCount);
+        const aggregated = [];
+        for (let start = 0; start < commits.length; start += bucketSize) {
+            const end = Math.min(start +
+                bucketSize, commits.length);
+            const first = commits[start];
+            const last = commits[end - 1];
+            if (first === undefined ||
+                last === undefined) {
+                continue;
+            }
+            let insertions = 0;
+            let deletions = 0;
+            let filesChanged = 0;
+            let timestampTotal = 0;
+            let commitCount = 0;
+            for (let index = start; index < end; index += 1) {
+                const commit = commits[index];
+                if (commit === undefined) {
+                    continue;
+                }
+                insertions +=
+                    commit.insertions;
+                deletions +=
+                    commit.deletions;
+                filesChanged +=
+                    commit.filesChanged;
+                timestampTotal +=
+                    commit.date.getTime();
+                commitCount += 1;
+            }
+            if (commitCount === 0) {
+                continue;
+            }
+            const averageTimestamp = timestampTotal /
+                commitCount;
+            aggregated.push({
+                hash: `${first.hash.slice(0, 7)}-${last.hash.slice(0, 7)}`,
+                authorName: "Aggregated",
+                authorEmail: "",
+                date: new Date(averageTimestamp),
+                message: `Aggregated ${commitCount} commits`,
+                insertions,
+                deletions,
+                filesChanged
+            });
+        }
+        return aggregated;
+    }
+    chooseScaleDegree(commit, scaleLength) {
+        const value = commit.insertions +
+            commit.filesChanged;
+        return (value %
+            scaleLength);
+    }
+    chooseOctave(commit) {
+        const hour = commit.date.getHours();
+        if (hour < 6) {
+            return 3;
+        }
+        if (hour < 12) {
+            return 4;
+        }
+        if (hour < 18) {
+            return 5;
+        }
+        return 4;
+    }
+    calculateTensionOffset(deletionRatio) {
+        if (deletionRatio >=
+            0.6) {
+            return 1;
+        }
+        if (deletionRatio >=
+            0.35) {
+            return -1;
+        }
+        return 0;
+    }
+    calculateMelodyDuration(secondsPerBeat, fileComplexity) {
+        return (secondsPerBeat *
+            (0.75 +
+                fileComplexity *
+                    1.5));
+    }
+    calculateAmplitude(profile, commitSize, layer) {
+        const base = 0.12 +
+            profile.intensity *
+                0.18 +
+            commitSize *
+                0.18;
+        switch (layer) {
+            case "melody":
+                return Math.min(base + 0.08, 0.5);
+            case "bass":
+                return Math.min(base * 0.75, 0.35);
+            case "pad":
+                return Math.min(base * 0.35, 0.16);
+        }
+    }
+    calculateSpacing(commits, index, secondsPerBeat, totalCommitCount) {
+        const current = commits[index];
+        const next = commits[index + 1];
+        if (current === undefined ||
+            next === undefined) {
+            return secondsPerBeat;
+        }
+        const millisecondsBetween = next.date.getTime() -
+            current.date.getTime();
+        const hoursBetween = Math.max(0, millisecondsBetween /
+            (1000 *
+                60 *
+                60));
+        const compressedGap = Math.log1p(hoursBetween);
+        const maximumReferenceGap = Math.log1p(24 * 365);
+        const normalizedGap = Math.min(1, compressedGap /
+            maximumReferenceGap);
+        const sizeCompression = totalCommitCount <=
+            100
+            ? 1
+            : 1 /
+                (1 +
+                    Math.log10(totalCommitCount /
+                        100) *
+                        0.18);
+        const baseSpacing = secondsPerBeat *
+            (1 +
+                normalizedGap *
+                    4);
+        return (baseSpacing *
+            sizeCompression);
+    }
+}
+//# sourceMappingURL=MusicComposer.js.map