@critical-path/svelte 0.12.0 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @critical-path/svelte
 
+## 0.13.0
+
+### Minor Changes
+
+- e2a7eef: Introduce Bret Victor's Ladder of Abstraction and Critical Path Method (CPM) timeline synthesis to the framework data model:
+  - **Core Domain**: Multi-scale timeline synthesis model across Macro phase rollups, Standard CPM Gantt schedule (early/late bounds, float/slack calculation, bottleneck identification), and Concrete grounding (deliverables, file attachments, daily effort distribution, and reality deltas). Added `calculateCriticalPath`, `getTimelineLadder`, and `getTaskLadder` to `CriticalPathEngine`.
+  - **Server Router**: HTTP endpoints `GET /projects/:id/critical-path`, `GET /projects/:id/ladder`, and `GET /tasks/:id/ladder`.
+  - **Client SDK**: `CriticalPathClient` methods `calculateCriticalPath`, `getTimelineLadder`, and `getTaskLadder`.
+  - **MCP**: New AI tools `calculate_critical_path`, `get_timeline_ladder`, and `get_task_ladder`.
+  - **React**: Custom hooks `useTimelineLadder`, `useCriticalPath`, and `useTaskLadder`.
+  - **Svelte 5**: Svelte 5 Runes state classes `TimelineLadderState` and `CriticalPathState`.
+
+### Patch Changes
+
+- Updated dependencies [e2a7eef]
+  - @critical-path/core@0.16.0
+  - @critical-path/client@0.10.0
+  - @critical-path/mcp@0.3.0
+
 ## 0.12.0
 
 ### Minor Changes

package/README.md

@@ -138,6 +138,68 @@ Combines threaded comments with inline attachments (`attachment.commentId === co
 {/each}
 ```
 
+### 4. Bret Victor's Ladder of Abstraction (`TimelineLadderState`)
+
+Fluidly traverse between Macro phase health, Standard Gantt tasks with CPM critical paths, and Concrete deliverables/effort using Svelte 5 Runes:
+
+```svelte
+<script lang="ts">
+  import { onMount } from 'svelte';
+  import { createCriticalPathClient, createTimelineLadderState, createCriticalPathState } from '@critical-path/svelte';
+
+  const client = createCriticalPathClient({ baseUrl: '/api/critical-path' });
+  const ladderState = createTimelineLadderState(client, 'proj_1', { level: 'all' });
+  const cpmState = createCriticalPathState(client, 'proj_1');
+
+  onMount(() => {
+    ladderState.fetch();
+    cpmState.fetch();
+  });
+</script>
+
+<!-- Level Switcher -->
+<div class="flex gap-2">
+  <button on:click={() => ladderState.setLevel('macro')}>Macro</button>
+  <button on:click={() => ladderState.setLevel('standard')}>Standard Gantt</button>
+  <button on:click={() => ladderState.setLevel('concrete')}>Concrete</button>
+  <button on:click={() => ladderState.setLevel('all')}>All Rungs</button>
+</div>
+
+{#if ladderState.loading}
+  <p>Loading timeline ladder...</p>
+{:else}
+  <!-- Macro Rung -->
+  {#if ladderState.macro}
+    <div class="macro-banner">
+      <h3>Phase Health: {ladderState.macro.health} ({ladderState.macro.overallProgressPercentage}% Complete)</h3>
+      <p>Total Duration: {ladderState.macro.totalDurationHours}h | Critical Path: {ladderState.macro.criticalPathDurationHours}h</p>
+    </div>
+  {/if}
+
+  <!-- Standard Rung -->
+  {#if ladderState.standard}
+    <div class="standard-gantt">
+      <h4>Gantt Schedule</h4>
+      {#each ladderState.standard.tasks as item}
+        <div class:is-critical={item.isCritical}>
+          {item.task.title} (Early Start: {item.schedule.earlyStart}h, Total Slack: {item.schedule.totalSlack}h)
+        </div>
+      {/each}
+    </div>
+  {/if}
+
+  <!-- Concrete Rung -->
+  {#if ladderState.concrete}
+    <div class="concrete-grounding">
+      <h4>Concrete Ground Truth</h4>
+      {#each Object.entries(ladderState.concrete) as [taskId, evidence]}
+        <div>Task {taskId}: {evidence.deliverables.length} deliverables, {evidence.attachments.length} files</div>
+      {/each}
+    </div>
+  {/if}
+{/if}
+```
+
 ---
 
 ## 📄 License

package/dist/critical-path-state.svelte.d.ts

@@ -0,0 +1,13 @@
+import type { CriticalPathClient } from '@critical-path/client';
+import type { CriticalPathAnalysis } from '@critical-path/core';
+export declare class CriticalPathState {
+    private client;
+    projectId: string;
+    data: CriticalPathAnalysis | null;
+    loading: boolean;
+    error: Error | null;
+    constructor(client: CriticalPathClient, projectId: string);
+    fetch(): Promise<void>;
+}
+export declare function createCriticalPathState(client: CriticalPathClient, projectId: string): CriticalPathState;
+//# sourceMappingURL=critical-path-state.svelte.d.ts.map

package/dist/critical-path-state.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critical-path-state.svelte.d.ts","sourceRoot":"","sources":["../src/critical-path-state.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,qBAAa,iBAAiB;IAM1B,OAAO,CAAC,MAAM;IACP,SAAS,EAAE,MAAM;IAN1B,IAAI,8BAA6C;IACjD,OAAO,UAA0B;IACjC,KAAK,eAA8B;gBAGzB,MAAM,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM;IAGpB,KAAK;CAWZ;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,GAChB,iBAAiB,CAEnB"}

package/dist/index.d.ts

@@ -11,4 +11,6 @@ export * from './deliverable-summary-state.svelte.js';
 export * from './kanban-state.svelte.js';
 export * from './task-transitions-state.svelte.js';
 export * from './webmcp-state.svelte.js';
+export * from './critical-path-state.svelte.js';
+export * from './timeline-ladder-state.svelte.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE/E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,kBAAkB,CAEnF;AAED,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE/E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,kBAAkB,CAEnF;AAED,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,oCAAoC,CAAC;AACnD,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mCAAmC,CAAC"}