pi-harness-runtime 0.9.4 → 0.9.6

package/packages/sprint-planner/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,SAAS,GACT,MAAM,iBAAiB,CAAC;AACzB,mBAAmB,YAAY,CAAC"}

package/packages/sprint-planner/dist/index.js

@@ -0,0 +1,6 @@
+/**
+ * Sprint Planner — Main Entry (RFC-0074)
+ */
+export { planSprints, createSprintConfig, sortRequirements, calculateVelocity, } from "./planner.js";
+export { decomposeRequirement, assignEstimate, sumPoints, } from "./decomposer.js";
+//# sourceMappingURL=index.js.map

package/packages/sprint-planner/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,SAAS,GACT,MAAM,iBAAiB,CAAC"}

package/packages/sprint-planner/dist/planner.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Sprint Planner — Sprint Planner (RFC-0074)
+ */
+import type { Requirement, Sprint, SprintConfig, PlanningResult } from "./types.js";
+export declare function createSprintConfig(overrides?: Partial<SprintConfig>): SprintConfig;
+export declare function sortRequirements(reqs: Requirement[], strategy: SprintConfig["prioritizationStrategy"]): Requirement[];
+export declare function planSprints(requirements: Requirement[], config?: Partial<SprintConfig>): PlanningResult;
+export declare function calculateVelocity(sprints: Sprint[]): number;
+//# sourceMappingURL=planner.d.ts.map

package/packages/sprint-planner/dist/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../src/planner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACX,WAAW,EACX,MAAM,EAEN,YAAY,EACZ,cAAc,EAGd,MAAM,YAAY,CAAC;AAKpB,wBAAgB,kBAAkB,CACjC,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC/B,YAAY,CAQd;AAED,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,WAAW,EAAE,EACnB,QAAQ,EAAE,YAAY,CAAC,wBAAwB,CAAC,GAC9C,WAAW,EAAE,CAgBf;AA2BD,wBAAgB,WAAW,CAC1B,YAAY,EAAE,WAAW,EAAE,EAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC5B,cAAc,CA4ChB;AAkBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAS3D"}

package/packages/sprint-planner/dist/planner.js

@@ -0,0 +1,114 @@
+/**
+ * Sprint Planner — Sprint Planner (RFC-0074)
+ */
+import { decomposeRequirement, sumPoints } from "./decomposer.js";
+let sprintCounter = 0;
+export function createSprintConfig(overrides) {
+    return {
+        sprintDurationDays: 14,
+        capacityPerDay: 5,
+        defaultEstimate: 3,
+        prioritizationStrategy: "priority-then-dependencies",
+        ...overrides,
+    };
+}
+export function sortRequirements(reqs, strategy) {
+    const priorityOrder = {
+        critical: 0,
+        high: 1,
+        medium: 2,
+        low: 3,
+    };
+    const sorted = [...reqs].sort((a, b) => {
+        const aP = priorityOrder[a.priority];
+        const bP = priorityOrder[b.priority];
+        if (aP !== bP)
+            return aP - bP;
+        return a.dependencies.length - b.dependencies.length;
+    });
+    return topologicalSort(sorted);
+}
+function topologicalSort(reqs) {
+    const result = [];
+    const remaining = new Set(reqs.map((r) => r.id));
+    const byId = new Map(reqs.map((r) => [r.id, r]));
+    while (remaining.size > 0) {
+        let added = false;
+        for (const id of remaining) {
+            const req = byId.get(id);
+            const depsSatisfied = req.dependencies.every((d) => !remaining.has(d));
+            if (depsSatisfied) {
+                result.push(req);
+                remaining.delete(id);
+                added = true;
+            }
+        }
+        if (!added) {
+            for (const id of remaining)
+                result.push(byId.get(id));
+            break;
+        }
+    }
+    return result;
+}
+export function planSprints(requirements, config) {
+    const cfg = createSprintConfig(config);
+    const allTasks = requirements.flatMap((req) => decomposeRequirement(req, { defaultEstimate: cfg.defaultEstimate }));
+    const sorted = sortRequirements(requirements, cfg.prioritizationStrategy);
+    const sprints = [];
+    const unassigned = [];
+    const sprintCapacity = cfg.sprintDurationDays * cfg.capacityPerDay;
+    let sprintTasks = [];
+    let sprintPoints = 0;
+    for (const req of sorted) {
+        const reqTasks = decomposeRequirement(req, {
+            defaultEstimate: cfg.defaultEstimate,
+        });
+        const reqPoints = sumPoints(reqTasks);
+        if (sprintPoints + reqPoints <= sprintCapacity) {
+            sprintTasks.push(...reqTasks);
+            sprintPoints += reqPoints;
+        }
+        else {
+            if (sprintTasks.length > 0) {
+                sprints.push(makeSprint(sprints.length + 1, sprintTasks));
+            }
+            sprintTasks = reqTasks;
+            sprintPoints = reqPoints;
+        }
+    }
+    if (sprintTasks.length > 0) {
+        sprints.push(makeSprint(sprints.length + 1, sprintTasks));
+    }
+    return {
+        sprints,
+        unassigned,
+        totalPoints: sumPoints(allTasks),
+        capacityUtilization: sprints.length > 0
+            ? (sumPoints(allTasks) / (sprints.length * sprintCapacity)) * 100
+            : 0,
+    };
+}
+function makeSprint(number, tasks) {
+    const today = new Date();
+    const start = new Date(today);
+    const end = new Date(today);
+    end.setDate(end.getDate() + 14 * number);
+    return {
+        id: `sprint-${++sprintCounter}-${Date.now()}`,
+        number,
+        name: `Sprint ${number}`,
+        startDate: start.toISOString().split("T")[0],
+        endDate: end.toISOString().split("T")[0],
+        capacity: sumPoints(tasks),
+        tasks,
+    };
+}
+export function calculateVelocity(sprints) {
+    const completed = sprints.filter((s) => s.tasks.every((t) => t.status === "done"));
+    if (completed.length === 0)
+        return 0;
+    return (completed.reduce((s, sp) => s + (sp.velocity ?? sumPoints(sp.tasks)), 0) /
+        completed.length);
+}
+//# sourceMappingURL=planner.js.map

package/packages/sprint-planner/dist/planner.js.map

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

package/packages/sprint-planner/dist/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Sprint Planner — Types (RFC-0074)
+ */
+export type StoryPoint = 1 | 2 | 3 | 5 | 8 | 13 | 21;
+export type Priority = "critical" | "high" | "medium" | "low";
+export type Status = "todo" | "in-progress" | "done" | "blocked";
+export interface Requirement {
+    id: string;
+    title: string;
+    description: string;
+    priority: Priority;
+    estimate?: StoryPoint;
+    acceptanceCriteria: string[];
+    labels: string[];
+    parentId?: string;
+    dependencies: string[];
+}
+export interface Task {
+    id: string;
+    requirementId: string;
+    title: string;
+    description: string;
+    status: Status;
+    assignee?: string;
+    estimate?: StoryPoint;
+    labels: string[];
+}
+export interface Sprint {
+    id: string;
+    number: number;
+    name: string;
+    startDate: string;
+    endDate: string;
+    capacity: number;
+    tasks: Task[];
+    velocity?: number;
+    goal?: string;
+}
+export interface SprintConfig {
+    sprintDurationDays: number;
+    capacityPerDay: number;
+    defaultEstimate: StoryPoint;
+    prioritizationStrategy: "priority-then-dependencies" | "moSCoW" | "value-density";
+}
+export interface PlanningResult {
+    sprints: Sprint[];
+    unassigned: Requirement[];
+    totalPoints: number;
+    capacityUtilization: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/sprint-planner/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;AACrD,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAC9D,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,IAAI;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,UAAU,CAAC;IAC5B,sBAAsB,EACnB,4BAA4B,GAC5B,QAAQ,GACR,eAAe,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;CAC5B"}

package/packages/sprint-planner/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Sprint Planner — Types (RFC-0074)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/sprint-planner/dist/types.js.map

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

package/packages/sprint-planner/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pi/sprint-planner",
+  "version": "0.9.6",
+  "type": "module",
+  "description": "Sprint planning engine for pi-harness",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc --noEmit",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "bun-types": "^1.0.0"
+  }
+}

package/packages/sprint-planner/src/decomposer.ts

@@ -0,0 +1,57 @@
+/**
+ * Sprint Planner — Requirement Decomposer (RFC-0074)
+ */
+
+import type { Requirement, Task, StoryPoint } from "./types.js";
+
+let taskCounter = 0;
+
+/**
+ * Decompose a requirement into tasks
+ */
+export function decomposeRequirement(
+	req: Requirement,
+	options?: { defaultEstimate?: StoryPoint },
+): Task[] {
+	const tasks: Task[] = [];
+	const estimate = req.estimate ?? options?.defaultEstimate ?? 3;
+
+	tasks.push(createTask(req, "Implementation", "todo", estimate));
+	tasks.push(
+		createTask(req, "Tests", "todo", Math.min(estimate, 5) as StoryPoint),
+	);
+	tasks.push(createTask(req, "Documentation", "todo", 1 as StoryPoint));
+
+	for (const ac of req.acceptanceCriteria) {
+		tasks.push(createTask(req, `AC: ${ac}`, "todo", 2 as StoryPoint));
+	}
+
+	return tasks;
+}
+
+function createTask(
+	req: Requirement,
+	title: string,
+	status: Task["status"],
+	estimate: StoryPoint,
+): Task {
+	return {
+		id: `task-${++taskCounter}-${Date.now()}`,
+		requirementId: req.id,
+		title: `${req.title} — ${title}`,
+		description: req.description,
+		status,
+		estimate,
+		labels: req.labels,
+	};
+}
+
+export function assignEstimate(complexity: number): StoryPoint {
+	const points: StoryPoint[] = [1, 2, 3, 5, 8, 13, 21];
+	const idx = Math.min(Math.floor(complexity / 2), points.length - 1);
+	return points[idx];
+}
+
+export function sumPoints(tasks: Task[]): number {
+	return tasks.reduce((sum, t) => sum + (t.estimate ?? 0), 0);
+}

package/packages/sprint-planner/src/index.ts

@@ -0,0 +1,16 @@
+/**
+ * Sprint Planner — Main Entry (RFC-0074)
+ */
+
+export {
+	planSprints,
+	createSprintConfig,
+	sortRequirements,
+	calculateVelocity,
+} from "./planner.js";
+export {
+	decomposeRequirement,
+	assignEstimate,
+	sumPoints,
+} from "./decomposer.js";
+export type * from "./types.js";

package/packages/sprint-planner/src/planner.ts

@@ -0,0 +1,150 @@
+/**
+ * Sprint Planner — Sprint Planner (RFC-0074)
+ */
+
+import type {
+	Requirement,
+	Sprint,
+	Task,
+	SprintConfig,
+	PlanningResult,
+	Priority,
+	StoryPoint,
+} from "./types.js";
+import { decomposeRequirement, sumPoints } from "./decomposer.js";
+
+let sprintCounter = 0;
+
+export function createSprintConfig(
+	overrides?: Partial<SprintConfig>,
+): SprintConfig {
+	return {
+		sprintDurationDays: 14,
+		capacityPerDay: 5,
+		defaultEstimate: 3,
+		prioritizationStrategy: "priority-then-dependencies",
+		...overrides,
+	};
+}
+
+export function sortRequirements(
+	reqs: Requirement[],
+	strategy: SprintConfig["prioritizationStrategy"],
+): Requirement[] {
+	const priorityOrder: Record<Priority, number> = {
+		critical: 0,
+		high: 1,
+		medium: 2,
+		low: 3,
+	};
+
+	const sorted = [...reqs].sort((a, b) => {
+		const aP = priorityOrder[a.priority];
+		const bP = priorityOrder[b.priority];
+		if (aP !== bP) return aP - bP;
+		return a.dependencies.length - b.dependencies.length;
+	});
+
+	return topologicalSort(sorted);
+}
+
+function topologicalSort(reqs: Requirement[]): Requirement[] {
+	const result: Requirement[] = [];
+	const remaining = new Set(reqs.map((r) => r.id));
+	const byId = new Map(reqs.map((r) => [r.id, r]));
+
+	while (remaining.size > 0) {
+		let added = false;
+		for (const id of remaining) {
+			const req = byId.get(id)!;
+			const depsSatisfied = req.dependencies.every((d) => !remaining.has(d));
+			if (depsSatisfied) {
+				result.push(req);
+				remaining.delete(id);
+				added = true;
+			}
+		}
+		if (!added) {
+			for (const id of remaining) result.push(byId.get(id)!);
+			break;
+		}
+	}
+
+	return result;
+}
+
+export function planSprints(
+	requirements: Requirement[],
+	config?: Partial<SprintConfig>,
+): PlanningResult {
+	const cfg = createSprintConfig(config);
+	const allTasks: Task[] = requirements.flatMap((req) =>
+		decomposeRequirement(req, { defaultEstimate: cfg.defaultEstimate }),
+	);
+	const sorted = sortRequirements(requirements, cfg.prioritizationStrategy);
+	const sprints: Sprint[] = [];
+	const unassigned: Requirement[] = [];
+	const sprintCapacity = cfg.sprintDurationDays * cfg.capacityPerDay;
+
+	let sprintTasks: Task[] = [];
+	let sprintPoints = 0;
+
+	for (const req of sorted) {
+		const reqTasks = decomposeRequirement(req, {
+			defaultEstimate: cfg.defaultEstimate,
+		});
+		const reqPoints = sumPoints(reqTasks);
+
+		if (sprintPoints + reqPoints <= sprintCapacity) {
+			sprintTasks.push(...reqTasks);
+			sprintPoints += reqPoints;
+		} else {
+			if (sprintTasks.length > 0) {
+				sprints.push(makeSprint(sprints.length + 1, sprintTasks));
+			}
+			sprintTasks = reqTasks;
+			sprintPoints = reqPoints;
+		}
+	}
+
+	if (sprintTasks.length > 0) {
+		sprints.push(makeSprint(sprints.length + 1, sprintTasks));
+	}
+
+	return {
+		sprints,
+		unassigned,
+		totalPoints: sumPoints(allTasks),
+		capacityUtilization:
+			sprints.length > 0
+				? (sumPoints(allTasks) / (sprints.length * sprintCapacity)) * 100
+				: 0,
+	};
+}
+
+function makeSprint(number: number, tasks: Task[]): Sprint {
+	const today = new Date();
+	const start = new Date(today);
+	const end = new Date(today);
+	end.setDate(end.getDate() + 14 * number);
+	return {
+		id: `sprint-${++sprintCounter}-${Date.now()}`,
+		number,
+		name: `Sprint ${number}`,
+		startDate: start.toISOString().split("T")[0],
+		endDate: end.toISOString().split("T")[0],
+		capacity: sumPoints(tasks),
+		tasks,
+	};
+}
+
+export function calculateVelocity(sprints: Sprint[]): number {
+	const completed = sprints.filter((s) =>
+		s.tasks.every((t) => t.status === "done"),
+	);
+	if (completed.length === 0) return 0;
+	return (
+		completed.reduce((s, sp) => s + (sp.velocity ?? sumPoints(sp.tasks)), 0) /
+		completed.length
+	);
+}

package/packages/sprint-planner/src/types.ts

@@ -0,0 +1,59 @@
+/**
+ * Sprint Planner — Types (RFC-0074)
+ */
+
+export type StoryPoint = 1 | 2 | 3 | 5 | 8 | 13 | 21;
+export type Priority = "critical" | "high" | "medium" | "low";
+export type Status = "todo" | "in-progress" | "done" | "blocked";
+
+export interface Requirement {
+	id: string;
+	title: string;
+	description: string;
+	priority: Priority;
+	estimate?: StoryPoint;
+	acceptanceCriteria: string[];
+	labels: string[];
+	parentId?: string;
+	dependencies: string[];
+}
+
+export interface Task {
+	id: string;
+	requirementId: string;
+	title: string;
+	description: string;
+	status: Status;
+	assignee?: string;
+	estimate?: StoryPoint;
+	labels: string[];
+}
+
+export interface Sprint {
+	id: string;
+	number: number;
+	name: string;
+	startDate: string;
+	endDate: string;
+	capacity: number;
+	tasks: Task[];
+	velocity?: number;
+	goal?: string;
+}
+
+export interface SprintConfig {
+	sprintDurationDays: number;
+	capacityPerDay: number;
+	defaultEstimate: StoryPoint;
+	prioritizationStrategy:
+		| "priority-then-dependencies"
+		| "moSCoW"
+		| "value-density";
+}
+
+export interface PlanningResult {
+	sprints: Sprint[];
+	unassigned: Requirement[];
+	totalPoints: number;
+	capacityUtilization: number;
+}