@summer_icicle/time-traveler 0.1.0

package/dist/audio/Synthesizer.js

@@ -0,0 +1,186 @@
+import { Oscillator } from "./Oscillator.js";
+import { Envelope } from "./Envelope.js";
+import { LowPassFilter } from "./LowPassFilter.js";
+export class Synthesizer {
+    oscillator = new Oscillator();
+    envelope = new Envelope();
+    render(events, options = {
+        sampleRate: 44100
+    }) {
+        if (events.length === 0) {
+            return {
+                left: new Float32Array(),
+                right: new Float32Array()
+            };
+        }
+        const totalDuration = Math.max(...events.map(event => event.startTime +
+            event.duration));
+        const totalSamples = Math.ceil(totalDuration *
+            options.sampleRate);
+        const left = new Float32Array(totalSamples);
+        const right = new Float32Array(totalSamples);
+        for (const event of events) {
+            this.renderEvent(left, right, event, options.sampleRate);
+        }
+        this.applyMasterGain(left, right);
+        this.softClip(left);
+        this.softClip(right);
+        return {
+            left,
+            right
+        };
+    }
+    renderEvent(left, right, event, sampleRate) {
+        const startSample = Math.floor(event.startTime *
+            sampleRate);
+        const eventSamples = Math.ceil(event.duration *
+            sampleRate);
+        const envelopeSettings = this.getEnvelopeForLayer(event.layer);
+        const cutoffFrequency = this.getCutoffFrequency(event.layer);
+        const leftFilter = new LowPassFilter();
+        const rightFilter = new LowPassFilter();
+        const pan = this.getPan(event);
+        const { leftGain, rightGain } = this.calculatePanGains(pan);
+        for (let index = 0; index < eventSamples; index += 1) {
+            const outputIndex = startSample +
+                index;
+            if (outputIndex >=
+                left.length) {
+                break;
+            }
+            const time = index /
+                sampleRate;
+            const timbreSample = this.getTimbreSample(event, time);
+            const filteredLeft = leftFilter.process(timbreSample, cutoffFrequency, sampleRate);
+            const filteredRight = rightFilter.process(timbreSample, cutoffFrequency, sampleRate);
+            const envelopeAmplitude = this.envelope.amplitude(time, event.duration, envelopeSettings);
+            const layerGain = this.getLayerGain(event.layer);
+            const sample = event.amplitude *
+                envelopeAmplitude *
+                layerGain;
+            left[outputIndex] +=
+                filteredLeft *
+                    sample *
+                    leftGain;
+            right[outputIndex] +=
+                filteredRight *
+                    sample *
+                    rightGain;
+        }
+    }
+    getTimbreSample(event, time) {
+        switch (event.layer) {
+            case "melody": {
+                const primary = this.oscillator.sample(event.waveform, event.frequency, time);
+                const sine = this.oscillator.sample("sine", event.frequency, time);
+                return (primary * 0.7 +
+                    sine * 0.3);
+            }
+            case "bass": {
+                const sine = this.oscillator.sample("sine", event.frequency, time);
+                const triangle = this.oscillator.sample("triangle", event.frequency, time);
+                return (sine * 0.85 +
+                    triangle * 0.15);
+            }
+            case "pad": {
+                const sine = this.oscillator.sample("sine", event.frequency, time);
+                const triangle = this.oscillator.sample("triangle", event.frequency, time);
+                return (sine * 0.6 +
+                    triangle * 0.4);
+            }
+        }
+    }
+    getPan(event) {
+        switch (event.layer) {
+            case "bass":
+                return 0;
+            case "melody":
+                return this.getMelodyPan(event.frequency);
+            case "pad":
+                return this.getPadPan(event.frequency);
+        }
+    }
+    getMelodyPan(frequency) {
+        const normalized = Math.min(1, Math.max(0, (frequency - 130) /
+            (1046 - 130)));
+        return (normalized * 0.8 -
+            0.4);
+    }
+    getPadPan(frequency) {
+        const normalized = Math.min(1, Math.max(0, (frequency - 130) /
+            (1046 - 130)));
+        return (normalized * 1.2 -
+            0.6);
+    }
+    calculatePanGains(pan) {
+        const clampedPan = Math.min(1, Math.max(-1, pan));
+        const angle = (clampedPan + 1) *
+            Math.PI /
+            4;
+        return {
+            leftGain: Math.cos(angle),
+            rightGain: Math.sin(angle)
+        };
+    }
+    getCutoffFrequency(layer) {
+        switch (layer) {
+            case "melody":
+                return 12000;
+            case "bass":
+                return 1800;
+            case "pad":
+                return 2500;
+        }
+    }
+    getEnvelopeForLayer(layer) {
+        switch (layer) {
+            case "melody":
+                return {
+                    attack: 0.02,
+                    decay: 0.12,
+                    sustain: 0.6,
+                    release: 0.2
+                };
+            case "bass":
+                return {
+                    attack: 0.08,
+                    decay: 0.2,
+                    sustain: 0.8,
+                    release: 0.35
+                };
+            case "pad":
+                return {
+                    attack: 0.35,
+                    decay: 0.25,
+                    sustain: 0.65,
+                    release: 0.6
+                };
+        }
+    }
+    getLayerGain(layer) {
+        switch (layer) {
+            case "melody":
+                return 0.9;
+            case "bass":
+                return 0.7;
+            case "pad":
+                return 0.3;
+        }
+    }
+    applyMasterGain(left, right) {
+        const masterGain = 0.85;
+        for (let index = 0; index < left.length; index += 1) {
+            left[index] *=
+                masterGain;
+            right[index] *=
+                masterGain;
+        }
+    }
+    softClip(samples) {
+        for (let index = 0; index < samples.length; index += 1) {
+            samples[index] =
+                Math.tanh(samples[index]);
+        }
+    }
+}
+//# sourceMappingURL=Synthesizer.js.map

package/dist/audio/Synthesizer.js.map

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

package/dist/audio/WavEncoder.d.ts

@@ -0,0 +1,8 @@
+import type { StereoBuffer } from "./StereoBuffer.js";
+export interface WavEncoderOptions {
+    sampleRate: number;
+}
+export declare class WavEncoder {
+    encode(stereo: StereoBuffer, options?: WavEncoderOptions): Buffer;
+    private floatToInt16;
+}

package/dist/audio/WavEncoder.js

@@ -0,0 +1,56 @@
+export class WavEncoder {
+    encode(stereo, options = {
+        sampleRate: 44100
+    }) {
+        if (stereo.left.length !==
+            stereo.right.length) {
+            throw new Error("Left and right channels must have the same length.");
+        }
+        const channels = 2;
+        const bitsPerSample = 16;
+        const bytesPerSample = bitsPerSample / 8;
+        const frameCount = stereo.left.length;
+        const dataSize = frameCount *
+            channels *
+            bytesPerSample;
+        const buffer = Buffer.alloc(44 + dataSize);
+        buffer.write("RIFF", 0);
+        buffer.writeUInt32LE(36 + dataSize, 4);
+        buffer.write("WAVE", 8);
+        buffer.write("fmt ", 12);
+        buffer.writeUInt32LE(16, 16);
+        buffer.writeUInt16LE(1, 20);
+        buffer.writeUInt16LE(channels, 22);
+        buffer.writeUInt32LE(options.sampleRate, 24);
+        const byteRate = options.sampleRate *
+            channels *
+            bytesPerSample;
+        buffer.writeUInt32LE(byteRate, 28);
+        const blockAlign = channels *
+            bytesPerSample;
+        buffer.writeUInt16LE(blockAlign, 32);
+        buffer.writeUInt16LE(bitsPerSample, 34);
+        buffer.write("data", 36);
+        buffer.writeUInt32LE(dataSize, 40);
+        let offset = 44;
+        for (let index = 0; index < frameCount; index += 1) {
+            const leftSample = this.floatToInt16(stereo.left[index] ?? 0);
+            const rightSample = this.floatToInt16(stereo.right[index] ?? 0);
+            buffer.writeInt16LE(leftSample, offset);
+            offset += 2;
+            buffer.writeInt16LE(rightSample, offset);
+            offset += 2;
+        }
+        return buffer;
+    }
+    floatToInt16(sample) {
+        const clamped = Math.max(-1, Math.min(1, sample));
+        if (clamped < 0) {
+            return Math.round(clamped *
+                32768);
+        }
+        return Math.round(clamped *
+            32767);
+    }
+}
+//# sourceMappingURL=WavEncoder.js.map

package/dist/audio/WavEncoder.js.map

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

package/dist/cli/commands/analyze.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerAnalyzeCommand(program: Command): void;

package/dist/cli/commands/analyze.js

@@ -0,0 +1,90 @@
+import { GitRepository } from "../../git/GitRepository.js";
+import { GitHistoryParser } from "../../git/GitHistoryParser.js";
+import { GitHistoryAnalyzer } from "../../git/GitHistoryAnalyzer.js";
+import { MusicMapper } from "../../music/MusicMapper.js";
+export function registerAnalyzeCommand(program) {
+    program
+        .command("analyze")
+        .description("Analyze the Git repository and display its musical profile")
+        .option("-b, --branch <branch>", "Analyze a specific Git branch")
+        .action(async (options) => {
+        const repository = new GitRepository(process.cwd());
+        const historyParser = new GitHistoryParser();
+        const historyAnalyzer = new GitHistoryAnalyzer();
+        const musicMapper = new MusicMapper();
+        const isRepository = await repository.isRepository();
+        if (!isRepository) {
+            console.error("Time Traveler must be run inside a Git repository.");
+            process.exitCode = 1;
+            return;
+        }
+        const hasCommits = await repository.hasCommits();
+        if (!hasCommits) {
+            console.error("Time Traveler cannot process a repository with no commits.");
+            process.exitCode = 1;
+            return;
+        }
+        const requestedBranch = options.branch;
+        if (requestedBranch !== undefined) {
+            const exists = await repository.branchExists(requestedBranch);
+            if (!exists) {
+                console.error(`Branch "${requestedBranch}" does not exist.`);
+                process.exitCode = 1;
+                return;
+            }
+        }
+        const branch = requestedBranch ??
+            await repository.getCurrentBranch();
+        const historyStream = repository.streamHistory(requestedBranch);
+        const commits = await historyParser.parseStream(historyStream);
+        if (commits.length === 0) {
+            console.error("Time Traveler could not find any commits in this repository.");
+            process.exitCode = 1;
+            return;
+        }
+        const stats = historyAnalyzer.analyze(commits);
+        const musicProfile = musicMapper.createProfile(stats);
+        console.log();
+        console.log("Time Traveler");
+        console.log("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━");
+        console.log();
+        console.log("Repository");
+        console.log(`  Branch: ${branch}`);
+        console.log(`  Commits: ${stats.commitCount}`);
+        console.log(`  Age: ${stats.repositoryAgeDays.toFixed(1)} days`);
+        console.log();
+        console.log("Code Activity");
+        console.log(`  Lines added: ${stats.totalInsertions.toLocaleString()}`);
+        console.log(`  Lines deleted: ${stats.totalDeletions.toLocaleString()}`);
+        console.log(`  Total lines changed: ${stats.totalLinesChanged.toLocaleString()}`);
+        console.log(`  Files changed: ${stats.totalFilesChanged.toLocaleString()}`);
+        console.log(`  Churn ratio: ${(stats.churnRatio * 100).toFixed(1)}%`);
+        console.log();
+        console.log("Commit Activity");
+        console.log(`  Commits/day: ${stats.commitsPerDay.toFixed(2)}`);
+        console.log(`  Avg lines/commit: ${stats.averageLinesChangedPerCommit.toFixed(1)}`);
+        console.log(`  Busiest hour: ${formatHour(stats.busiestHour)}`);
+        console.log();
+        console.log("Musical Profile");
+        console.log(`  Tempo: ${musicProfile.tempo} BPM`);
+        console.log(`  Root note: ${musicProfile.rootNote}`);
+        console.log(`  Scale: ${musicProfile.scale}`);
+        console.log(`  Waveform: ${musicProfile.waveform}`);
+        console.log(`  Intensity: ${musicProfile.intensity.toFixed(2)}`);
+        console.log(`  Dissonance: ${musicProfile.dissonance.toFixed(2)}`);
+        console.log(`  Note density: ${musicProfile.noteDensity.toFixed(2)}`);
+    });
+}
+function formatHour(hour) {
+    if (hour === null) {
+        return "N/A";
+    }
+    const suffix = hour >= 12
+        ? "PM"
+        : "AM";
+    const displayHour = hour % 12 === 0
+        ? 12
+        : hour % 12;
+    return `${displayHour}:00 ${suffix}`;
+}
+//# sourceMappingURL=analyze.js.map

package/dist/cli/commands/analyze.js.map

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

package/dist/cli/commands/export.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerExportCommand(program: Command): void;

package/dist/cli/commands/export.js

@@ -0,0 +1,86 @@
+import path from "node:path";
+import { writeFile } from "node:fs/promises";
+import { GitRepository } from "../../git/GitRepository.js";
+import { GitHistoryParser } from "../../git/GitHistoryParser.js";
+import { GitHistoryAnalyzer } from "../../git/GitHistoryAnalyzer.js";
+import { MusicMapper } from "../../music/MusicMapper.js";
+import { MusicComposer } from "../../music/MusicComposer.js";
+import { Synthesizer } from "../../audio/Synthesizer.js";
+import { WavEncoder } from "../../audio/WavEncoder.js";
+export function registerExportCommand(program) {
+    program
+        .command("export")
+        .description("Generate a WAV soundscape from the current Git repository")
+        .option("-o, --output <file>", "Output WAV filename")
+        .option("-b, --branch <branch>", "Export a specific Git branch")
+        .action(async (options) => {
+        const repository = new GitRepository(process.cwd());
+        const historyParser = new GitHistoryParser();
+        const historyAnalyzer = new GitHistoryAnalyzer();
+        const musicMapper = new MusicMapper();
+        const musicComposer = new MusicComposer();
+        const synthesizer = new Synthesizer();
+        const wavEncoder = new WavEncoder();
+        const isRepository = await repository.isRepository();
+        if (!isRepository) {
+            console.error("Time Traveler must be run inside a Git repository.");
+            process.exitCode = 1;
+            return;
+        }
+        const hasCommits = await repository.hasCommits();
+        if (!hasCommits) {
+            console.error("Time Traveler cannot process a repository with no commits.");
+            process.exitCode = 1;
+            return;
+        }
+        const requestedBranch = options.branch;
+        if (requestedBranch !== undefined) {
+            const exists = await repository.branchExists(requestedBranch);
+            if (!exists) {
+                console.error(`Branch "${requestedBranch}" does not exist.`);
+                process.exitCode = 1;
+                return;
+            }
+        }
+        const branch = requestedBranch ??
+            await repository.getCurrentBranch();
+        const historyStream = repository.streamHistory(requestedBranch);
+        const commits = await historyParser.parseStream(historyStream);
+        if (commits.length === 0) {
+            console.error("Time Traveler could not find any commits in this repository.");
+            process.exitCode = 1;
+            return;
+        }
+        const latestCommit = commits.reduce((latest, commit) => commit.date >
+            latest.date
+            ? commit
+            : latest);
+        const stats = historyAnalyzer.analyze(commits);
+        const musicProfile = musicMapper.createProfile(stats);
+        const musicEvents = musicComposer.compose(musicProfile, commits);
+        const melodyCount = musicEvents.filter(event => event.layer ===
+            "melody").length;
+        const bassCount = musicEvents.filter(event => event.layer ===
+            "bass").length;
+        const padCount = musicEvents.filter(event => event.layer ===
+            "pad").length;
+        console.log();
+        console.log("Composition");
+        console.log(`  Branch: ${branch}`);
+        console.log(`  Total events: ${musicEvents.length}`);
+        console.log(`  Melody: ${melodyCount}`);
+        console.log(`  Bass: ${bassCount}`);
+        console.log(`  Pad: ${padCount}`);
+        const stereo = synthesizer.render(musicEvents);
+        const wav = wavEncoder.encode(stereo);
+        const shortHash = latestCommit.hash.slice(0, 7);
+        const repositoryName = path.basename(process.cwd());
+        const safeBranchName = branch.replace(/[^a-zA-Z0-9._-]/g, "-");
+        const outputFileName = options.output ??
+            `${repositoryName}-${safeBranchName}-${shortHash}.wav`;
+        await writeFile(outputFileName, wav);
+        console.log();
+        console.log(`Audio written to ${outputFileName}`);
+    });
+}
+//# sourceMappingURL=export.js.map

package/dist/cli/commands/export.js.map

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

package/dist/cli/commands/play.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerPlayCommand(program: Command): void;

package/dist/cli/commands/play.js

@@ -0,0 +1,69 @@
+import path from "node:path";
+import os from "node:os";
+import { writeFile } from "node:fs/promises";
+import { GitRepository } from "../../git/GitRepository.js";
+import { GitHistoryParser } from "../../git/GitHistoryParser.js";
+import { GitHistoryAnalyzer } from "../../git/GitHistoryAnalyzer.js";
+import { MusicMapper } from "../../music/MusicMapper.js";
+import { MusicComposer } from "../../music/MusicComposer.js";
+import { Synthesizer } from "../../audio/Synthesizer.js";
+import { WavEncoder } from "../../audio/WavEncoder.js";
+import { AudioPlayer } from "../../audio/AudioPlayer.js";
+export function registerPlayCommand(program) {
+    program
+        .command("play")
+        .description("Generate and play a soundscape from the current Git repository")
+        .option("-b, --branch <branch>", "Play a specific Git branch")
+        .action(async (options) => {
+        const repository = new GitRepository(process.cwd());
+        const historyParser = new GitHistoryParser();
+        const historyAnalyzer = new GitHistoryAnalyzer();
+        const musicMapper = new MusicMapper();
+        const musicComposer = new MusicComposer();
+        const synthesizer = new Synthesizer();
+        const wavEncoder = new WavEncoder();
+        const audioPlayer = new AudioPlayer();
+        const isRepository = await repository.isRepository();
+        if (!isRepository) {
+            console.error("Time Traveler must be run inside a Git repository.");
+            process.exitCode = 1;
+            return;
+        }
+        const hasCommits = await repository.hasCommits();
+        if (!hasCommits) {
+            console.error("Time Traveler cannot process a repository with no commits.");
+            process.exitCode = 1;
+            return;
+        }
+        const requestedBranch = options.branch;
+        if (requestedBranch !== undefined) {
+            const exists = await repository.branchExists(requestedBranch);
+            if (!exists) {
+                console.error(`Branch "${requestedBranch}" does not exist.`);
+                process.exitCode = 1;
+                return;
+            }
+        }
+        const branch = requestedBranch ??
+            await repository.getCurrentBranch();
+        const historyStream = repository.streamHistory(requestedBranch);
+        const commits = await historyParser.parseStream(historyStream);
+        if (commits.length === 0) {
+            console.error("Time Traveler could not find any commits in this repository.");
+            process.exitCode = 1;
+            return;
+        }
+        console.log();
+        console.log(`Generating soundscape for ${branch}...`);
+        const stats = historyAnalyzer.analyze(commits);
+        const musicProfile = musicMapper.createProfile(stats);
+        const musicEvents = musicComposer.compose(musicProfile, commits);
+        const stereo = synthesizer.render(musicEvents);
+        const wav = wavEncoder.encode(stereo);
+        const temporaryFile = path.join(os.tmpdir(), `time-traveler-${process.pid}.wav`);
+        await writeFile(temporaryFile, wav);
+        console.log(`Playing ${commits.length} commits from ${branch}`);
+        await audioPlayer.play(temporaryFile);
+    });
+}
+//# sourceMappingURL=play.js.map

package/dist/cli/commands/play.js.map

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

package/dist/git/GitCommit.d.ts

@@ -0,0 +1,10 @@
+export interface GitCommit {
+    hash: string;
+    authorName: string;
+    authorEmail: string;
+    date: Date;
+    message: string;
+    insertions: number;
+    deletions: number;
+    filesChanged: number;
+}

package/dist/git/GitCommit.js

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

package/dist/git/GitCommit.js.map

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

package/dist/git/GitHistoryAnalyzer.d.ts

@@ -0,0 +1,7 @@
+import type { GitCommit } from "./GitCommit.js";
+import type { GitHistoryStats } from "./GitHistoryStats.js";
+export declare class GitHistoryAnalyzer {
+    analyze(commits: GitCommit[]): GitHistoryStats;
+    private calculateRepositoryAgeDays;
+    private findBusiestHour;
+}