@critical-path/svelte 0.11.0 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @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
+
+- 105f3d3: Synchronize feature parity between `@critical-path/react` and `@critical-path/svelte`:
+  - `@critical-path/react`: Added `updateTask` with optimistic updates and rollback to `useTasks`, and introduced `useTaskActivity` hook for unified threaded discussions and attachments.
+  - `@critical-path/svelte`: Added `KanbanState` (`createKanbanState`), `TaskTransitionsState` (`createTaskTransitionsState`), and `DeliverableSummaryState` (`createDeliverableSummaryState`) using native Svelte 5 runes.
+
 ## 0.11.0
 
 ### Minor Changes

package/README.md

@@ -2,7 +2,7 @@
 
 > **Svelte 5 Runes Reactive Integrations for Critical Path.**
 
-`@critical-path/svelte` provides Svelte 5 Runes reactive state classes and factories (`ProjectState`, `TaskState`, `WorkflowState`, `CommentState`, `AttachmentState`, `TaskActivityState`) for building project management UIs in Svelte 5 and SvelteKit applications.
+`@critical-path/svelte` provides Svelte 5 Runes reactive state classes and factories (`ProjectState`, `TaskState`, `KanbanState`, `TaskTransitionsState`, `WorkflowState`, `CommentState`, `AttachmentState`, `TaskActivityState`, `DeliverableState`, `DeliverableSummaryState`, `WebMcpState`) for building project management UIs in Svelte 5 and SvelteKit applications.
 
 ---
 
@@ -52,7 +52,39 @@ pnpm add @critical-path/svelte svelte@^5.0.0
 {/if}
 ```
 
-### 2. Unified Task Activity & Threaded Discussions (`TaskActivityState`)
+### 2. Reactive Kanban Board (`KanbanState`)
+
+Buckets tasks reactively into workflow columns (`backlog`, `todo`, `in_progress`, etc.) or semantic columns (`not_started`, `in_progress`, `completed`, `canceled`):
+
+```svelte
+<script lang="ts">
+  import { onMount } from 'svelte';
+  import { createCriticalPathClient, createKanbanState } from '@critical-path/svelte';
+
+  const client = createCriticalPathClient({ baseUrl: '/api/critical-path' });
+  const kanban = createKanbanState(client, 'proj_1');
+
+  onMount(() => {
+    kanban.fetch();
+  });
+</script>
+
+<div class="board" style="display: flex; gap: 16px;">
+  {#each Object.entries(kanban.columns) as [status, tasks]}
+    <div class="column">
+      <h3>{status} ({tasks.length})</h3>
+      {#each tasks as task}
+        <div class="card">
+          <h4>{task.title}</h4>
+          <button on:click={() => kanban.moveTask(task.id, 'done')}>Mark Done</button>
+        </div>
+      {/each}
+    </div>
+  {/each}
+</div>
+```
+
+### 3. Unified Task Activity & Threaded Discussions (`TaskActivityState`)
 
 Combines threaded comments with inline attachments (`attachment.commentId === comment.id`) and standalone attachments in a single reactive store:
 
@@ -106,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/deliverable-summary-state.svelte.d.ts

@@ -0,0 +1,14 @@
+import type { CriticalPathClient } from '@critical-path/client';
+import type { DeliverableSummary } from '@critical-path/core';
+export declare class DeliverableSummaryState {
+    private client;
+    deliverableId?: string | undefined;
+    summary: DeliverableSummary | null;
+    loading: boolean;
+    error: Error | null;
+    get data(): DeliverableSummary | null;
+    constructor(client: CriticalPathClient, deliverableId?: string | undefined);
+    fetch(deliverableId?: string): Promise<void>;
+}
+export declare function createDeliverableSummaryState(client: CriticalPathClient, deliverableId?: string): DeliverableSummaryState;
+//# sourceMappingURL=deliverable-summary-state.svelte.d.ts.map

package/dist/deliverable-summary-state.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliverable-summary-state.svelte.d.ts","sourceRoot":"","sources":["../src/deliverable-summary-state.svelte.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,qBAAa,uBAAuB;IAStB,OAAO,CAAC,MAAM;IAA6B,aAAa,CAAC,EAAE,MAAM;IAR7E,OAAO,4BAA2C;IAClD,OAAO,UAA0B;IACjC,KAAK,eAA8B;IAEnC,IAAI,IAAI,IAAI,kBAAkB,GAAG,IAAI,CAEpC;gBAEmB,MAAM,EAAE,kBAAkB,EAAS,aAAa,CAAC,EAAE,MAAM,YAAA;IAEvE,KAAK,CAAC,aAAa,CAAC,EAAE,MAAM;CAkBnC;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,kBAAkB,EAC1B,aAAa,CAAC,EAAE,MAAM,GACrB,uBAAuB,CAEzB"}

package/dist/index.d.ts

@@ -7,5 +7,10 @@ export * from './comment-state.svelte.js';
 export * from './attachment-state.svelte.js';
 export * from './activity-state.svelte.js';
 export * from './deliverable-state.svelte.js';
+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,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"}