pi-harness-runtime 0.9.20 → 0.9.21

package/packages/workflow-events/dist/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Workflow Events — Semantic Event Types
+ */
+export type SemanticEvent = TaskAssigned | TaskStarted | TaskCompleted | TaskFailed | ReviewRequested | ReviewCompleted | ArchitectureDecision | CodeGenerated | TestsPassed | TestsFailed | HumanApprovalRequested | HumanApprovalGranted | WorkflowFinished;
+export interface TaskAssigned {
+    kind: "TaskAssigned";
+    taskId: string;
+    assignedTo: string;
+    assignedBy: string;
+    timestamp: string;
+}
+export interface TaskStarted {
+    kind: "TaskStarted";
+    taskId: string;
+    workerId: string;
+    timestamp: string;
+}
+export interface TaskCompleted {
+    kind: "TaskCompleted";
+    taskId: string;
+    workerId: string;
+    result: {
+        delivered: boolean;
+        files?: string[];
+        summary?: string;
+    };
+    timestamp: string;
+}
+export interface TaskFailed {
+    kind: "TaskFailed";
+    taskId: string;
+    workerId: string;
+    error: string;
+    timestamp: string;
+}
+export interface ReviewRequested {
+    kind: "ReviewRequested";
+    taskId: string;
+    reviewer: string;
+    rationale: string;
+    timestamp: string;
+}
+export interface ReviewCompleted {
+    kind: "ReviewCompleted";
+    taskId: string;
+    reviewer: string;
+    verdict: "approved" | "rejected" | "changes_requested";
+    comments?: string;
+    timestamp: string;
+}
+export interface ArchitectureDecision {
+    kind: "ArchitectureDecision";
+    id: string;
+    decision: string;
+    rationale: string;
+    approved: boolean;
+    timestamp: string;
+}
+export interface CodeGenerated {
+    kind: "CodeGenerated";
+    taskId: string;
+    files: string[];
+    timestamp: string;
+}
+export interface TestsPassed {
+    kind: "TestsPassed";
+    taskId: string;
+    testCount: number;
+    timestamp: string;
+}
+export interface TestsFailed {
+    kind: "TestsFailed";
+    taskId: string;
+    failedCount: number;
+    failures: string[];
+    timestamp: string;
+}
+export interface HumanApprovalRequested {
+    kind: "HumanApprovalRequested";
+    taskId: string;
+    rationale: string;
+    requestedAt: string;
+}
+export interface HumanApprovalGranted {
+    kind: "HumanApprovalGranted";
+    taskId: string;
+    grantedBy: string;
+    timestamp: string;
+}
+export interface WorkflowFinished {
+    kind: "WorkflowFinished";
+    workflowId: string;
+    outcome: "success" | "cancelled" | "failed";
+    timestamp: string;
+}
+export type WorkflowStatus = "idle" | "running" | "paused" | "finished";
+export interface WorkflowState {
+    id: string;
+    status: WorkflowStatus;
+    tasks: string[];
+    currentTask?: string;
+    blockers: string[];
+}
+export interface WorkflowTransition {
+    from: WorkflowStatus;
+    to: WorkflowStatus;
+    trigger: string;
+    timestamp: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/workflow-events/dist/types.d.ts.map

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

package/packages/workflow-events/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Workflow Events — Semantic Event Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/workflow-events/dist/types.js.map

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

package/packages/workflow-events/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@pi/workflow-events",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "test": "node --test"
+  }
+}

package/packages/workflow-events/src/events.ts

@@ -0,0 +1,86 @@
+/**
+ * Workflow Events — Semantic Event Builder
+ */
+
+interface SessionEvent {
+	id: string;
+	sessionId: string;
+	timestamp: string;
+	type: string;
+	content?: string;
+	metadata?: Record<string, unknown>;
+}
+
+interface SemanticEvent {
+	kind: string;
+	timestamp: string;
+	[key: string]: unknown;
+}
+
+interface WorkflowState {
+	id: string;
+	status: string;
+	tasks: string[];
+	blockers: string[];
+}
+
+interface WorkflowTransition {
+	from: string;
+	to: string;
+	trigger: string;
+	timestamp: string;
+}
+
+export function buildSemanticEvents(events: SessionEvent[]): SemanticEvent[] {
+	const semantic: SemanticEvent[] = [];
+	for (const evt of events) {
+		if (evt.type === "tool_end" && evt.content?.includes("task-")) {
+			const match = evt.content.match(/task-[a-z0-9-]+/i);
+			if (match) {
+				semantic.push({
+					kind: "TaskCompleted",
+					taskId: match[0],
+					workerId: (evt.metadata?.model as string) ?? "unknown",
+					result: { delivered: true },
+					timestamp: evt.timestamp,
+				});
+			}
+		}
+	}
+	return semantic;
+}
+
+export class WorkflowStateMachine {
+	private state: WorkflowState = {
+		id: "main",
+		status: "idle",
+		tasks: [],
+		blockers: [],
+	};
+	private history: WorkflowTransition[] = [];
+
+	transition(event: SemanticEvent): WorkflowTransition {
+		const prev = this.state.status;
+		if (event.kind === "TaskStarted") {
+			this.state.status = "running";
+			this.state.tasks.push(event.taskId as string);
+		} else if (event.kind === "WorkflowFinished") {
+			this.state.status = "finished";
+		}
+		const t: WorkflowTransition = {
+			from: prev,
+			to: this.state.status,
+			trigger: event.kind,
+			timestamp: new Date().toISOString(),
+		};
+		this.history.push(t);
+		return t;
+	}
+
+	getState(): WorkflowState {
+		return { ...this.state };
+	}
+	getHistory(): WorkflowTransition[] {
+		return [...this.history];
+	}
+}

package/packages/workflow-events/src/index.ts

@@ -0,0 +1,19 @@
+export type {
+	SemanticEvent,
+	TaskAssigned,
+	TaskStarted,
+	TaskCompleted,
+	TaskFailed,
+	ReviewRequested,
+	ReviewCompleted,
+	ArchitectureDecision,
+	CodeGenerated,
+	TestsPassed,
+	TestsFailed,
+	HumanApprovalRequested,
+	HumanApprovalGranted,
+	WorkflowFinished,
+	WorkflowStatus,
+	WorkflowState,
+	WorkflowTransition,
+} from "./types.js";

package/packages/workflow-events/src/pipeline.ts

@@ -0,0 +1,41 @@
+/**
+ * Workflow Events — Pipeline (self-contained)
+ */
+
+export class WorkflowPipeline {
+	private state = {
+		id: "main",
+		status: "idle",
+		tasks: [] as string[],
+		blockers: [] as string[],
+	};
+	private history: Array<{
+		from: string;
+		to: string;
+		trigger: string;
+		timestamp: string;
+	}> = [];
+
+	transition(kind: string, data: Record<string, unknown> = {}): void {
+		const prev = this.state.status;
+		if (kind === "TaskStarted") {
+			this.state.status = "running";
+			if (data.taskId) this.state.tasks.push(data.taskId as string);
+		} else if (kind === "WorkflowFinished") {
+			this.state.status = "finished";
+		}
+		this.history.push({
+			from: prev,
+			to: this.state.status,
+			trigger: kind,
+			timestamp: new Date().toISOString(),
+		});
+	}
+
+	getState() {
+		return { ...this.state };
+	}
+	getHistory() {
+		return [...this.history];
+	}
+}

package/packages/workflow-events/src/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Workflow Events — Semantic Event Types
+ */
+export type SemanticEvent = TaskAssigned | TaskStarted | TaskCompleted | TaskFailed | ReviewRequested | ReviewCompleted | ArchitectureDecision | CodeGenerated | TestsPassed | TestsFailed | HumanApprovalRequested | HumanApprovalGranted | WorkflowFinished;
+export interface TaskAssigned {
+    kind: "TaskAssigned";
+    taskId: string;
+    assignedTo: string;
+    assignedBy: string;
+    timestamp: string;
+}
+export interface TaskStarted {
+    kind: "TaskStarted";
+    taskId: string;
+    workerId: string;
+    timestamp: string;
+}
+export interface TaskCompleted {
+    kind: "TaskCompleted";
+    taskId: string;
+    workerId: string;
+    result: {
+        delivered: boolean;
+        files?: string[];
+        summary?: string;
+    };
+    timestamp: string;
+}
+export interface TaskFailed {
+    kind: "TaskFailed";
+    taskId: string;
+    workerId: string;
+    error: string;
+    timestamp: string;
+}
+export interface ReviewRequested {
+    kind: "ReviewRequested";
+    taskId: string;
+    reviewer: string;
+    rationale: string;
+    timestamp: string;
+}
+export interface ReviewCompleted {
+    kind: "ReviewCompleted";
+    taskId: string;
+    reviewer: string;
+    verdict: "approved" | "rejected" | "changes_requested";
+    comments?: string;
+    timestamp: string;
+}
+export interface ArchitectureDecision {
+    kind: "ArchitectureDecision";
+    id: string;
+    decision: string;
+    rationale: string;
+    approved: boolean;
+    timestamp: string;
+}
+export interface CodeGenerated {
+    kind: "CodeGenerated";
+    taskId: string;
+    files: string[];
+    timestamp: string;
+}
+export interface TestsPassed {
+    kind: "TestsPassed";
+    taskId: string;
+    testCount: number;
+    timestamp: string;
+}
+export interface TestsFailed {
+    kind: "TestsFailed";
+    taskId: string;
+    failedCount: number;
+    failures: string[];
+    timestamp: string;
+}
+export interface HumanApprovalRequested {
+    kind: "HumanApprovalRequested";
+    taskId: string;
+    rationale: string;
+    requestedAt: string;
+}
+export interface HumanApprovalGranted {
+    kind: "HumanApprovalGranted";
+    taskId: string;
+    grantedBy: string;
+    timestamp: string;
+}
+export interface WorkflowFinished {
+    kind: "WorkflowFinished";
+    workflowId: string;
+    outcome: "success" | "cancelled" | "failed";
+    timestamp: string;
+}
+export type WorkflowStatus = "idle" | "running" | "paused" | "finished";
+export interface WorkflowState {
+    id: string;
+    status: WorkflowStatus;
+    tasks: string[];
+    currentTask?: string;
+    blockers: string[];
+}
+export interface WorkflowTransition {
+    from: WorkflowStatus;
+    to: WorkflowStatus;
+    trigger: string;
+    timestamp: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/workflow-events/src/types.d.ts.map

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

package/packages/workflow-events/src/types.js

@@ -0,0 +1,5 @@
+/**
+ * Workflow Events — Semantic Event Types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/workflow-events/src/types.js.map

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

package/packages/workflow-events/src/types.ts

@@ -0,0 +1,139 @@
+/**
+ * Workflow Events — Semantic Event Types
+ */
+
+export type SemanticEvent =
+	| TaskAssigned
+	| TaskStarted
+	| TaskCompleted
+	| TaskFailed
+	| ReviewRequested
+	| ReviewCompleted
+	| ArchitectureDecision
+	| CodeGenerated
+	| TestsPassed
+	| TestsFailed
+	| HumanApprovalRequested
+	| HumanApprovalGranted
+	| WorkflowFinished;
+
+export interface TaskAssigned {
+	kind: "TaskAssigned";
+	taskId: string;
+	assignedTo: string;
+	assignedBy: string;
+	timestamp: string;
+}
+
+export interface TaskStarted {
+	kind: "TaskStarted";
+	taskId: string;
+	workerId: string;
+	timestamp: string;
+}
+
+export interface TaskCompleted {
+	kind: "TaskCompleted";
+	taskId: string;
+	workerId: string;
+	result: {
+		delivered: boolean;
+		files?: string[];
+		summary?: string;
+	};
+	timestamp: string;
+}
+
+export interface TaskFailed {
+	kind: "TaskFailed";
+	taskId: string;
+	workerId: string;
+	error: string;
+	timestamp: string;
+}
+
+export interface ReviewRequested {
+	kind: "ReviewRequested";
+	taskId: string;
+	reviewer: string;
+	rationale: string;
+	timestamp: string;
+}
+
+export interface ReviewCompleted {
+	kind: "ReviewCompleted";
+	taskId: string;
+	reviewer: string;
+	verdict: "approved" | "rejected" | "changes_requested";
+	comments?: string;
+	timestamp: string;
+}
+
+export interface ArchitectureDecision {
+	kind: "ArchitectureDecision";
+	id: string;
+	decision: string;
+	rationale: string;
+	approved: boolean;
+	timestamp: string;
+}
+
+export interface CodeGenerated {
+	kind: "CodeGenerated";
+	taskId: string;
+	files: string[];
+	timestamp: string;
+}
+
+export interface TestsPassed {
+	kind: "TestsPassed";
+	taskId: string;
+	testCount: number;
+	timestamp: string;
+}
+
+export interface TestsFailed {
+	kind: "TestsFailed";
+	taskId: string;
+	failedCount: number;
+	failures: string[];
+	timestamp: string;
+}
+
+export interface HumanApprovalRequested {
+	kind: "HumanApprovalRequested";
+	taskId: string;
+	rationale: string;
+	requestedAt: string;
+}
+
+export interface HumanApprovalGranted {
+	kind: "HumanApprovalGranted";
+	taskId: string;
+	grantedBy: string;
+	timestamp: string;
+}
+
+export interface WorkflowFinished {
+	kind: "WorkflowFinished";
+	workflowId: string;
+	outcome: "success" | "cancelled" | "failed";
+	timestamp: string;
+}
+
+export type WorkflowStatus = "idle" | "running" | "paused" | "finished";
+
+export interface WorkflowState {
+	id: string;
+	status: WorkflowStatus;
+	tasks: string[];
+	currentTask?: string;
+	blockers: string[];
+}
+
+export interface WorkflowTransition {
+	from: WorkflowStatus;
+	to: WorkflowStatus;
+	trigger: string;
+	timestamp: string;
+}

package/packages/workflow-events/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": ".",
+    "types": ["node"],
+    "lib": ["ES2022"]
+  },
+  "include": ["src/**/*"]
+}

package/packages/workspace-scanner/dist/detect.d.ts

@@ -0,0 +1,3 @@
+import type { ProjectConfig } from "./types.js";
+export declare function detectProject(rootPath: string): ProjectConfig;
+//# sourceMappingURL=detect.d.ts.map

package/packages/workspace-scanner/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAwD7D"}

package/packages/workspace-scanner/dist/detect.js

@@ -0,0 +1,58 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+export function detectProject(rootPath) {
+    const config = {};
+    // Node.js detection
+    const packageJsonPath = join(rootPath, "package.json");
+    if (existsSync(packageJsonPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+            if (pkg.name)
+                config.name = String(pkg.name);
+            config.language = "TypeScript";
+            if (pkg.workspaces)
+                config.packageManager = "npm";
+            if (existsSync(join(rootPath, "pnpm-lock.yaml")))
+                config.packageManager = "pnpm";
+            if (existsSync(join(rootPath, "yarn.lock")))
+                config.packageManager = "yarn";
+            if (existsSync(join(rootPath, "bun.lockb")))
+                config.packageManager = "bun";
+        }
+        catch { /* ignore */ }
+    }
+    // Python detection
+    if (existsSync(join(rootPath, "pyproject.toml")) ||
+        existsSync(join(rootPath, "setup.py"))) {
+        config.language = "Python";
+        config.packageManager = "pip";
+    }
+    // Go detection
+    if (existsSync(join(rootPath, "go.mod"))) {
+        config.language = "Go";
+        config.packageManager = "go";
+    }
+    // Rust detection
+    if (existsSync(join(rootPath, "Cargo.toml"))) {
+        config.language = "Rust";
+        config.packageManager = "cargo";
+    }
+    // Frappe/ERPNext detection
+    if (existsSync(join(rootPath, "sites")) ||
+        existsSync(join(rootPath, "apps")) ||
+        existsSync(join(rootPath, "hooks.py"))) {
+        config.framework = "frappe";
+    }
+    // Next.js detection
+    if (existsSync(join(rootPath, "next.config.js")) ||
+        existsSync(join(rootPath, "next.config.ts"))) {
+        config.framework = "nextjs";
+    }
+    // Vite detection
+    if (existsSync(join(rootPath, "vite.config.js")) ||
+        existsSync(join(rootPath, "vite.config.ts"))) {
+        config.buildTool = "vite";
+    }
+    return config;
+}
+//# sourceMappingURL=detect.js.map

package/packages/workspace-scanner/dist/detect.js.map

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

package/packages/workspace-scanner/dist/git.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Workspace Scanner — Git State Detection
+ */
+import type { GitState } from "./types.js";
+export declare function isGitRepo(rootPath: string): boolean;
+export declare function getGitState(rootPath: string): GitState | null;
+//# sourceMappingURL=git.d.ts.map

package/packages/workspace-scanner/dist/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAkE7D"}