endurance-coach 1.0.2 → 1.2.0

package/LICENSE.md

@@ -1,6 +1,7 @@
 # MIT License
 
-Copyright (c) 2025 Felix Rieseberg
+Original work Copyright (c) 2025 Felix Rieseberg
+Modifications and independent development Copyright (c) 2025-2026 Shiva Prasad
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,8 +1,5 @@
 # Endurance Coach
 
-Originally forked from Claude Coach.
-This project is now independently maintained and has evolved with a different architecture and goals, focusing on agent-first, schema-driven endurance planning.
-
 Endurance Coach allows you to use Claude (or any AI assistant) to create custom-tailored training programs for triathlons, marathons, and other endurance activities. Using a data-driven approach and principles from top training plans, the AI will create a training plan that's uniquely fit for you, your personal fitness, and the constraints you have in the next couple of weeks. Maybe you're recovering from an injury, maybe you're traveling and don't have access to a pool or track in a certain week - tell the AI about it and it'll create a plan that works for you.
 
 The output is a beautiful training plan app that allows you to add, edit, or move workouts, mark them as complete, and update key training data like heart rate zones, LTHR, threshold paces, FTP, and others. Your data is kept locally in your browser.
@@ -92,6 +89,54 @@ In the next step, the AI will ask you about yourself, the event you're training
 
 The AI will use this information to create a plan tailored to your current fitness level. The more detail you provide, the better your plan will be.
 
+## Contributing
+
+We welcome contributions from the community! Whether you want to add workout templates, improve the UI, fix bugs, or enhance documentation, your help is appreciated.
+
+Please see our [CONTRIBUTING.md](CONTRIBUTING.md) for:
+
+- Development setup instructions
+- Coding standards and guidelines
+- How to submit pull requests
+- Areas where we need help
+
 # About
 
-Endurance Coach is an independent, open-source project based on Felix Rieseberg's Claude Coach. It is not made by, endorsed by, or affiliated with Anthropic, PBC. "Claude" is a trademark of Anthropic. This skill works with Claude and other AI assistants but is developed and maintained independently. License: MIT.
+## Lineage & Architectural Evolution
+
+This project originated as a fork of [Claude Coach](https://github.com/felixrieseberg/claude-coach) by [Felix Rieseberg](https://felixrieseberg.com), but it is no longer a fork in any meaningful architectural or behavioral sense.
+
+The original project relied on large language models generating full, deeply nested workout plans as verbose JSON based solely on plain-text instructions. This approach had no formal schema contract, no validation loop, and no way for an AI agent to detect or correct structural errors before downstream rendering. Failures were late, brittle, and required human intervention.
+
+This project deliberately replaces that architecture.
+
+### Key changes that make this an independent system:
+
+**Contract-first design**
+The system now exposes explicit machine-consumable schemas (via validation tooling) rather than relying on prose instructions. AI agents can validate outputs and receive structured error feedback before proceeding.
+
+**Representation shift**
+Workout plans are no longer generated as large raw JSON objects. Instead, the system defines a constrained domain-specific language composed of reusable workout templates. Plans are authored as concise YAML compositions of these templates, drastically reducing output size, entropy, and failure modes.
+
+**Template-based composition**
+The AI agent does not invent workout structure freely. It selects from a predefined, inspectable set of workout building blocks supplied by the tool, turning generation into constrained composition rather than unconstrained construction.
+
+**Agent-first execution model**
+The primary consumer is an AI agent, not a human. All commands are deterministic, side-effect explicit, and validation-first. Outputs are designed to support self-correction loops by the agent.
+
+**Independent surface and identity**
+The project has a new name, a new installation path, and a different public contract. It is no longer Claude-specific and is designed to be consumed by any AI agent or orchestration framework.
+
+Because the core abstraction, data representation, validation model, target consumer, and public interface have all changed, this project should be treated as an independently evolved system that acknowledges its lineage but does not share the original architecture or assumptions.
+
+## Disclaimer
+
+Endurance Coach is an independent, open-source project. It is not made by, endorsed by, or affiliated with Anthropic, PBC. "Claude" is a trademark of Anthropic. This skill works with Claude and other AI assistants but is developed and maintained independently.
+
+## Maintainer
+
+Maintained by [Shiva Prasad](https://shiv19.com) · [@multishiv19](https://twitter.com/multishiv19)
+
+## License
+
+MIT License. Original work Copyright © 2025 Felix Rieseberg. Modifications and independent development Copyright © 2025-2026 Shiva Prasad.

package/dist/cli.js

@@ -218,8 +218,8 @@ Commands:
   sync              Sync activities from Strava
   auth              Get Strava authorization URL or exchange code for tokens
   schema            Print the YAML v2.0 plan format reference
-  validate <file>   Validate a training plan against the schema
-  expand <file>     Expand a compact YAML plan to full JSON format
+  validate <file>   Validate a training plan (YAML recommended)
+  expand <file>     Expand a compact YAML plan to full format
   render <file>     Render a training plan to HTML
   templates         List available workout templates
   query <sql>       Run a SQL query against the database
@@ -241,9 +241,6 @@ Sync Options:
   --client-secret=SEC   Strava API client secret (for OAuth flow)
   --days=N              Days of history to sync (default: 730)
 
-Validate Options:
-  --compact             Force compact plan validation (auto-detected for .yaml files)
-
 Expand Options:
   --output, -o FILE     Output file (default: stdout)
   --format json|yaml    Output format (default: json)
@@ -261,7 +258,7 @@ Query Options:
 
 Modify Options:
   --backup, -b FILE     Backup JSON file (exported from Settings)
-  --plan, -p FILE       Training plan JSON file to modify
+  --plan, -p FILE       Expanded plan JSON file to modify
   --output, -o FILE     Output file (default: overwrites plan file)
 
 Examples:
@@ -277,20 +274,20 @@ Examples:
   # Get the YAML v2.0 format reference
   npx endurance-coach schema
 
-  # Validate a training plan JSON
-  npx endurance-coach validate plan.json
+  # Validate a compact YAML plan
+  npx endurance-coach validate plan.yaml
 
-  # Render a training plan to HTML (includes validation)
-  npx endurance-coach render plan.json --output my-plan.html
+  # Render a training plan to HTML
+  npx endurance-coach render plan.yaml --output my-plan.html
 
   # Query the database
   npx endurance-coach query "SELECT * FROM weekly_volume LIMIT 5"
-  
-  # Apply backup changes to a training plan
-  npx endurance-coach modify --backup backup.json --plan plan.json
+
+  # Apply backup changes to an expanded plan
+  npx endurance-coach modify --backup backup.json --plan expanded.json
 
   # Save modified plan to a new file
-  npx endurance-coach modify -b backup.json -p plan.json -o modified_plan.json
+  npx endurance-coach modify -b backup.json -p expanded.json -o modified.json
 `);
 }
 // ============================================================================

package/dist/expander/expander.js

@@ -9,6 +9,16 @@ import { calculateAthleteZones } from "./zones.js";
 // ============================================================================
 // Date Utilities
 // ============================================================================
+/**
+ * Parse an ISO date string (YYYY-MM-DD) as a local date, avoiding timezone issues.
+ * When you use `new Date("2025-02-16")`, it creates a UTC date which can shift
+ * to the previous day in timezones behind UTC. This function creates a date in
+ * local timezone.
+ */
+function parseLocalDate(dateStr) {
+    const [year, month, day] = dateStr.split("-").map(Number);
+    return new Date(year, month - 1, day);
+}
 /**
  * Get the day of week name from a Date.
  */
@@ -20,7 +30,10 @@ function getDayOfWeekName(date) {
  * Format a Date as ISO date string (YYYY-MM-DD).
  */
 function formatDate(date) {
-    return date.toISOString().split("T")[0];
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, "0");
+    const day = String(date.getDate()).padStart(2, "0");
+    return `${year}-${month}-${day}`;
 }
 /**
  * Add days to a date.
@@ -34,7 +47,7 @@ function addDays(date, days) {
  * Calculate the start date of the plan from the event date and total weeks.
  */
 function calculateStartDate(eventDate, totalWeeks, firstDayOfWeek) {
-    const event = new Date(eventDate);
+    const event = parseLocalDate(eventDate);
     // Go back totalWeeks * 7 days from event date
     const start = addDays(event, -(totalWeeks * 7));
     // Adjust to the first day of the week

package/dist/templates/template.schema.d.ts

@@ -33,12 +33,15 @@ export declare const WorkoutCategorySchema: z.ZodEnum<{
     rest: "rest";
     recovery: "recovery";
     threshold: "threshold";
+    power: "power";
     endurance: "endurance";
     tempo: "tempo";
     intervals: "intervals";
     technique: "technique";
     hills: "hills";
+    aerobic: "aerobic";
     speed: "speed";
+    maintenance: "maintenance";
 }>;
 export declare const TemplateParamSchema: z.ZodObject<{
     type: z.ZodEnum<{
@@ -264,12 +267,15 @@ export declare const WorkoutTemplateSchema: z.ZodObject<{
         rest: "rest";
         recovery: "recovery";
         threshold: "threshold";
+        power: "power";
         endurance: "endurance";
         tempo: "tempo";
         intervals: "intervals";
         technique: "technique";
         hills: "hills";
+        aerobic: "aerobic";
         speed: "speed";
+        maintenance: "maintenance";
     }>;
     params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         type: z.ZodEnum<{

package/dist/templates/template.schema.js

@@ -14,6 +14,7 @@ export const WorkoutCategorySchema = z.enum([
     "rest",
     "recovery",
     "endurance",
+    "aerobic",
     "tempo",
     "threshold",
     "intervals",
@@ -21,6 +22,8 @@ export const WorkoutCategorySchema = z.enum([
     "hills",
     "race",
     "strength",
+    "power",
+    "maintenance",
     "technique",
 ]);
 // ============================================================================

package/dist/templates/template.types.d.ts

@@ -67,7 +67,7 @@ export interface TemplateStructure {
 /**
  * Workout category for organization.
  */
-export type WorkoutCategory = "rest" | "recovery" | "endurance" | "tempo" | "threshold" | "intervals" | "speed" | "hills" | "race" | "strength" | "technique";
+export type WorkoutCategory = "rest" | "recovery" | "endurance" | "aerobic" | "tempo" | "threshold" | "intervals" | "speed" | "hills" | "race" | "strength" | "power" | "maintenance" | "technique";
 /**
  * A complete workout template.
  */

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "endurance-coach",
-  "version": "1.0.2",
-  "author": "Felix Rieseberg",
+  "version": "1.2.0",
+  "author": "Shiva Prasad <sp@shiv19.com> (https://shiv19.com)",
   "contributors": [
-    "Shiva Prasad <sp@shiv19.com> (https://shiv19.com)"
+    "Felix Rieseberg (https://felixrieseberg.com)"
   ],
   "license": "MIT",
   "type": "module",