refactor: rename MixtapeLabs to Mixtape and update related components

Author: Thavarshan

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,6 +1,6 @@
 ---
 name: "Bug report"
-about: "Report a problem with MixtapeLabs Engine"
+about: "Report a problem with Mixtape Engine"
 labels: [bug]
 title: "[Bug]: "
 ---

.github/copilot-instructions.md

@@ -3,8 +3,8 @@
 Core idea: this package is a framework-agnostic LangGraph workflow that orchestrates mix analysis end-to-end. Keep all work inside well-typed modules; let hosts inject real services.
 
 ## Architecture snapshot
-- Entry point is `runMixtapeLabsSession` (`src/index.ts`), which compiles the graph from `buildMixtapeLabsGraph` and invokes it with an `EngineState` derived from `RunSessionInput`.
-- State schemas live in `src/state.ts` (Zod-validated). `src/types.ts` exposes `MixtapeLabsEngineDeps` and re-exports the schemas—never bypass them when changing shapes.
+- Entry point is `runMixtapeSession` (`src/index.ts`), which compiles the graph from `buildMixtapeGraph` and invokes it with an `EngineState` derived from `RunSessionInput`.
+- State schemas live in `src/state.ts` (Zod-validated). `src/types.ts` exposes `MixtapeEngineDeps` and re-exports the schemas—never bypass them when changing shapes.
 - Graph nodes are declared in `src/graph/mixtapelabs-graph.ts` and exported as helper functions (`validateInputNode`, `metadataStepNode`, etc.). They depend solely on injected clients: metadata → analysis → feedback → finalize.
 - Tool interfaces under `src/tools/` define the only allowed side-effect boundaries. They wrap user-provided clients via `create*Tool` helpers so validation happens before I/O.
 - Prompt/LLM logic lives in `src/prompts/feedback-prompt.ts` and `src/config/llm.ts` (`OpenAIFeedbackClient`). That client requires `OPENAI_API_KEY`; never instantiate it without checking the env.

NOTICE

@@ -1,6 +1,6 @@
-# MixtapeLabs Engine (@mixtapelabs/engine)
+# Mixtape Engine (@mixtapelabs/engine)
 
 LangGraph-powered workflow engine for AI-driven audio mix analysis.
 
-This project and its contents are proprietary to MixtapeLabs. All rights reserved.
+This project and its contents are proprietary to Mixtape. All rights reserved.
 Refer to the LICENSE file for usage terms.

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mixtapelabs/engine",
   "version": "0.0.1",
-  "description": "MixtapeLabs engine – LangGraph-powered workflow engine for AI-driven audio mix analysis.",
+  "description": "Mixtape engine – LangGraph-powered workflow engine for AI-driven audio mix analysis.",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.js",

src/graph/mixtapelabs-graph.ts src/graph/mixtape-graph.tssrc/graph/mixtapelabs-graph.ts renamed to src/graph/mixtape-graph.ts

@@ -1,5 +1,5 @@
 /**
- * MixtapeLabs Workflow Graph - LangGraph Orchestration
+ * Mixtape Workflow Graph - LangGraph Orchestration
  *
  * Implements the complete audio analysis pipeline as a LangGraph state machine.
  * The workflow is linear and fault-tolerant:
@@ -20,7 +20,7 @@
  */
 import { Annotation, END, START, StateGraph } from '@langchain/langgraph';
 import type { EngineState } from '../state.ts';
-import type { MixtapeLabsEngineDeps } from '../types.ts';
+import type { MixtapeEngineDeps } from '../types.ts';
 
 /**
  * LangGraph annotation defining the shape of our workflow state.
@@ -82,7 +82,7 @@ const GRAPH_NODE_NAMES = [
  */
 export async function validateInputNode(state: GraphState): Promise<GraphNodeResult> {
   if (!state.uploadUrl) {
-    return { error: 'uploadUrl is required to run an MixtapeLabs session' };
+    return { error: 'uploadUrl is required to run an Mixtape session' };
   }
 
   return {};
@@ -103,7 +103,7 @@ export async function validateInputNode(state: GraphState): Promise<GraphNodeRes
  * @returns { fileInfo } on success, { error } on failure, or {} if skipped
  */
 export async function metadataStepNode(
-  deps: Pick<MixtapeLabsEngineDeps, 'audioMetadataClient'>,
+  deps: Pick<MixtapeEngineDeps, 'audioMetadataClient'>,
   state: GraphState,
 ): Promise<GraphNodeResult> {
   // Skip if no URL or already errored
@@ -137,7 +137,7 @@ export async function metadataStepNode(
  * @returns { analysis } on success, { error } on failure, or {} if skipped
  */
 export async function analysisStepNode(
-  deps: Pick<MixtapeLabsEngineDeps, 'audioAnalysisClient'>,
+  deps: Pick<MixtapeEngineDeps, 'audioAnalysisClient'>,
   state: GraphState,
 ): Promise<GraphNodeResult> {
   // Skip if no URL or already errored
@@ -173,7 +173,7 @@ export async function analysisStepNode(
  * @returns { feedbackText, suggestions } on success, { error } on failure, or {} if skipped
  */
 export async function feedbackStepNode(
-  deps: Pick<MixtapeLabsEngineDeps, 'feedbackClient'>,
+  deps: Pick<MixtapeEngineDeps, 'feedbackClient'>,
   state: GraphState,
 ): Promise<GraphNodeResult> {
   // Skip if already errored
@@ -193,7 +193,7 @@ export async function feedbackStepNode(
 }
 
 /**
- * Constructs and compiles the complete MixtapeLabs workflow graph.
+ * Constructs and compiles the complete Mixtape workflow graph.
  *
  * This function:
  * 1. Creates a LangGraph StateGraph with our annotation
@@ -225,7 +225,7 @@ export async function feedbackStepNode(
  * @param deps - Complete set of injected service clients
  * @returns Compiled graph ready for execution via `.invoke(initialState)`
  */
-export function buildMixtapeLabsGraph(deps: MixtapeLabsEngineDeps) {
+export function buildMixtapeGraph(deps: MixtapeEngineDeps) {
   const workflow = new StateGraph(GraphAnnotation, {
     nodes: GRAPH_NODE_NAMES,
   }) as StateGraph<typeof GraphAnnotation, GraphState, GraphNodeResult, GraphNodeName>;

src/index.ts

@@ -1,7 +1,7 @@
 /**
- * Mixtapelabs Engine - Core Workflow Orchestration
+ * Mixtape Engine - Core Workflow Orchestration
  *
- * Entry point for the proprietary Mixtapelabs Engine. This module coordinates
+ * Entry point for the proprietary Mixtape Engine. This module coordinates
  * the complete audio analysis workflow through a LangGraph state machine.
  *
  * Design principles:
@@ -11,12 +11,12 @@
  *
  * @module engine
  */
-import { buildMixtapelabsGraph } from './graph/mixtapelabs-graph.ts';
+import { buildMixtapeGraph } from './graph/mixtape-graph.ts';
 import type { EngineState } from './state.ts';
-import type { MixtapelabsEngineDeps, RunSessionInput } from './types.ts';
+import type { MixtapeEngineDeps, RunSessionInput } from './types.ts';
 
 /**
- * Executes a complete audio analysis session through the Mixtapelabs workflow.
+ * Executes a complete audio analysis session through the Mixtape workflow.
  *
  * This function orchestrates the following pipeline:
  * 1. **Input validation** - Ensures uploadUrl is provided
@@ -36,7 +36,7 @@ import type { MixtapelabsEngineDeps, RunSessionInput } from './types.ts';
  *
  * @example
  * ```ts
- * const result = await runMixtapelabsSession(
+ * const result = await runMixtapeSession(
  *   { sessionId: 'abc123', uploadUrl: 'https://...', userContext: { daw: 'Ableton' } },
  *   { audioMetadataClient, audioAnalysisClient, feedbackClient }
  * );
@@ -48,11 +48,11 @@ import type { MixtapelabsEngineDeps, RunSessionInput } from './types.ts';
  * }
  * ```
  */
-export async function runMixtapelabsSession(
+export async function runMixtapeSession(
   input: RunSessionInput,
-  deps: MixtapelabsEngineDeps,
+  deps: MixtapeEngineDeps,
 ): Promise<EngineState> {
-  const graph = buildMixtapelabsGraph(deps);
+  const graph = buildMixtapeGraph(deps);
 
   const initialState: EngineState = {
     sessionId: input.sessionId,

src/types.ts

@@ -2,7 +2,7 @@
  * Engine Type Definitions & Dependency Injection Contracts
  *
  * Defines the interfaces that external systems must implement to integrate
- * with the Mixtapelabs Engine. This enables dependency injection and testability.
+ * with the Mixtape Engine. This enables dependency injection and testability.
  *
  * @module engine/types
  */
@@ -13,7 +13,7 @@ import type { AudioAnalysisClient } from './tools/audio-analysis-tool.ts';
 import type { FeedbackClient } from './tools/llm-feedback-tool.ts';
 
 /**
- * Complete set of dependencies required to run the Mixtapelabs Engine.
+ * Complete set of dependencies required to run the Mixtape Engine.
  *
  * This interface enforces dependency injection, making the engine:
  * - **Testable**: Mock implementations can be injected for unit tests
@@ -23,7 +23,7 @@ import type { FeedbackClient } from './tools/llm-feedback-tool.ts';
  * In production, implementations will be HTTP clients calling microservices.
  * In tests, they'll be stub implementations returning synthetic data.
  */
-export interface MixtapelabsEngineDeps {
+export interface MixtapeEngineDeps {
   /** Client for extracting file metadata (duration, format, sample rate, etc.) */
   audioMetadataClient: AudioMetadataClient;
   /** Client for performing DSP analysis (loudness, dynamics, spectrum, stereo) */
@@ -33,7 +33,7 @@ export interface MixtapelabsEngineDeps {
 }
 
 /**
- * Input required to initiate an Mixtapelabs analysis session.
+ * Input required to initiate an Mixtape analysis session.
  *
  * This is the minimal data needed to start the workflow. The engine
  * will augment this with analysis results as it progresses through

test/graph/auralyze-graph.unit.test.ts

@@ -1,16 +1,16 @@
 import { describe, expect, it, vi } from 'vitest';
 import {
   analysisStepNode,
-  buildMixtapelabsGraph,
+  buildMixtapeGraph,
   feedbackStepNode,
   metadataStepNode,
-} from '../../src/graph/mixtapelabs-graph';
+} from '../../src/graph/mixtape-graph';
 import { EngineState } from '../../src/state';
 import { AudioMetadataClient } from '../../src/tools/audio-metadata-tool';
 import { AudioAnalysisClient } from '../../src/tools/audio-analysis-tool';
 import { FeedbackClient } from '../../src/tools/llm-feedback-tool';
 
-describe('Mixtapelabs LangGraph', () => {
+describe('Mixtape LangGraph', () => {
   const baseDeps = () => {
     const metadataClient: AudioMetadataClient = {
       getMetadata: vi.fn().mockResolvedValue({
@@ -48,7 +48,7 @@ describe('Mixtapelabs LangGraph', () => {
   it('runs through happy path', async () => {
     const { metadataClient, analysisClient, feedbackClient } = baseDeps();
 
-    const graph = buildMixtapelabsGraph({
+    const graph = buildMixtapeGraph({
       audioMetadataClient: metadataClient,
       audioAnalysisClient: analysisClient,
       feedbackClient,
@@ -73,7 +73,7 @@ describe('Mixtapelabs LangGraph', () => {
   it('sets error when upload url missing', async () => {
     const { metadataClient, analysisClient, feedbackClient } = baseDeps();
 
-    const graph = buildMixtapelabsGraph({
+    const graph = buildMixtapeGraph({
       audioMetadataClient: metadataClient,
       audioAnalysisClient: analysisClient,
       feedbackClient,
@@ -95,7 +95,7 @@ describe('Mixtapelabs LangGraph', () => {
       new Error('ffprobe offline'),
     );
 
-    const graph = buildMixtapelabsGraph({
+    const graph = buildMixtapeGraph({
       audioMetadataClient: metadataClient,
       audioAnalysisClient: analysisClient,
       feedbackClient,
@@ -116,7 +116,7 @@ describe('Mixtapelabs LangGraph', () => {
     const { metadataClient, analysisClient, feedbackClient } = baseDeps();
     (metadataClient.getMetadata as ReturnType<typeof vi.fn>).mockRejectedValueOnce('string boom');
 
-    const graph = buildMixtapelabsGraph({
+    const graph = buildMixtapeGraph({
       audioMetadataClient: metadataClient,
       audioAnalysisClient: analysisClient,
       feedbackClient,
@@ -136,7 +136,7 @@ describe('Mixtapelabs LangGraph', () => {
       new Error('analysis timeout'),
     );
 
-    const graph = buildMixtapelabsGraph({
+    const graph = buildMixtapeGraph({
       audioMetadataClient: metadataClient,
       audioAnalysisClient: analysisClient,
       feedbackClient,
@@ -158,7 +158,7 @@ describe('Mixtapelabs LangGraph', () => {
       new Error('openai down'),
     );
 
-    const graph = buildMixtapelabsGraph({
+    const graph = buildMixtapeGraph({
       audioMetadataClient: metadataClient,
       audioAnalysisClient: analysisClient,
       feedbackClient,
@@ -179,7 +179,7 @@ describe('Mixtapelabs LangGraph', () => {
   it('skips downstream nodes when error is already populated', async () => {
     const { metadataClient, analysisClient, feedbackClient } = baseDeps();
 
-    const graph = buildMixtapelabsGraph({
+    const graph = buildMixtapeGraph({
       audioMetadataClient: metadataClient,
       audioAnalysisClient: analysisClient,
       feedbackClient,