@schilderlabs/pitown-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Schilder Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,5 @@
+# @schilderlabs/pitown-core
+
+Core runtime primitives for Pi Town.
+
+This package contains the local-first controller, run artifacts model, metrics helpers, repo identity helpers, and other building blocks used by the `pitown` CLI.

package/dist/index.d.mts

@@ -0,0 +1,162 @@
+//#region src/types.d.ts
+type InterruptCategory = "missing-context" | "spec-gap" | "policy-gap" | "validation-gap" | "tooling-failure" | "external-blocker";
+type FixType = "adr" | "docs" | "policy" | "prompt" | "skill" | "tooling" | "validation";
+type RunMode = "single-pi";
+interface InterruptRecord {
+  id: string;
+  runId: string;
+  taskId?: string;
+  category: InterruptCategory;
+  subtype?: string;
+  summary: string;
+  requiresHuman: boolean;
+  createdAt: string;
+  resolvedAt?: string;
+  fixType?: FixType;
+}
+interface TaskAttempt {
+  taskId: string;
+  status: "completed" | "blocked" | "skipped";
+  interrupted: boolean;
+  startedAt: string;
+  endedAt: string;
+}
+interface FeedbackCycle {
+  feedbackAt: string;
+  demoReadyAt: string;
+}
+interface MetricsSnapshot {
+  interruptRate: number;
+  autonomousCompletionRate: number;
+  contextCoverageScore: number;
+  meanTimeToCorrectHours: number | null;
+  feedbackToDemoCycleTimeHours: number | null;
+  totals: {
+    taskAttempts: number;
+    completedTasks: number;
+    interrupts: number;
+    observedInterruptCategories: number;
+    coveredInterruptCategories: number;
+  };
+}
+interface RunOptions {
+  cwd?: string;
+  artifactsDir: string;
+  branch?: string | null;
+  goal?: string | null;
+  mode?: RunMode;
+  planPath?: string | null;
+  recommendedPlanDir?: string | null;
+  piCommand?: string;
+}
+interface RunManifest {
+  runId: string;
+  repoId: string;
+  repoSlug: string;
+  repoRoot: string;
+  branch: string;
+  goal: string | null;
+  planPath: string | null;
+  recommendedPlanDir: string | null;
+  mode: RunMode;
+  startedAt: string;
+  endedAt: string | null;
+  stopReason: string | null;
+  leasePath: string;
+  piExitCode: number | null;
+  completedTaskCount: number;
+  blockedTaskCount: number;
+  skippedTaskCount: number;
+  totalCostUsd: number;
+}
+interface PiInvocationRecord {
+  command: string;
+  cwd: string;
+  repoRoot: string;
+  planPath: string | null;
+  goal: string | null;
+  startedAt: string;
+  endedAt: string;
+  exitCode: number;
+  stdoutPath: string;
+  stderrPath: string;
+  promptSummary: string;
+}
+interface RunSummary {
+  runId: string;
+  mode: RunMode;
+  createdAt: string;
+  success: boolean;
+  message: string;
+  piExitCode: number;
+  recommendedPlanDir: string | null;
+}
+interface ControllerRunResult {
+  runId: string;
+  runDir: string;
+  latestDir: string;
+  manifest: RunManifest;
+  metrics: MetricsSnapshot;
+  summary: RunSummary;
+  piInvocation: PiInvocationRecord;
+}
+//#endregion
+//#region src/controller.d.ts
+declare function runController(options: RunOptions): ControllerRunResult;
+//#endregion
+//#region src/events.d.ts
+declare function appendJsonl(filePath: string, value: unknown): void;
+declare function readJsonl<T>(filePath: string): T[];
+//#endregion
+//#region src/interrupts.d.ts
+interface CreateInterruptInput {
+  runId: string;
+  taskId?: string;
+  category: InterruptCategory;
+  subtype?: string;
+  summary: string;
+  requiresHuman?: boolean;
+  createdAt?: string;
+}
+declare function createInterruptRecord(input: CreateInterruptInput): InterruptRecord;
+declare function resolveInterrupt(interrupt: InterruptRecord, options: Pick<InterruptRecord, "resolvedAt" | "fixType">): InterruptRecord;
+//#endregion
+//#region src/lease.d.ts
+declare function acquireRepoLease(runId: string, repoId: string, branch: string): {
+  path: string;
+  release: () => void;
+};
+//#endregion
+//#region src/metrics.d.ts
+declare function computeInterruptRate(interrupts: InterruptRecord[], taskAttempts: TaskAttempt[]): number;
+declare function computeAutonomousCompletionRate(taskAttempts: TaskAttempt[]): number;
+declare function computeContextCoverageScore(interrupts: InterruptRecord[]): number;
+declare function computeMeanTimeToCorrect(interrupts: InterruptRecord[]): number | null;
+declare function computeFeedbackToDemoCycleTime(feedbackCycles: FeedbackCycle[]): number | null;
+declare function computeMetrics(input: {
+  taskAttempts: TaskAttempt[];
+  interrupts: InterruptRecord[];
+  feedbackCycles?: FeedbackCycle[];
+}): MetricsSnapshot;
+//#endregion
+//#region src/repo.d.ts
+declare function isGitRepo(cwd: string): boolean;
+declare function getRepoRoot(cwd: string): string;
+declare function getCurrentBranch(cwd: string): string | null;
+declare function getRepoIdentity(cwd: string): string;
+declare function createRepoSlug(repoId: string, repoRoot: string): string;
+//#endregion
+//#region src/shell.d.ts
+interface CommandResult {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+}
+declare function runCommandSync(command: string, args: string[], options?: {
+  cwd?: string;
+  env?: NodeJS.ProcessEnv;
+}): CommandResult;
+declare function assertSuccess(result: CommandResult, context: string): void;
+//#endregion
+export { CommandResult, ControllerRunResult, CreateInterruptInput, FeedbackCycle, FixType, InterruptCategory, InterruptRecord, MetricsSnapshot, PiInvocationRecord, RunManifest, RunMode, RunOptions, RunSummary, TaskAttempt, acquireRepoLease, appendJsonl, assertSuccess, computeAutonomousCompletionRate, computeContextCoverageScore, computeFeedbackToDemoCycleTime, computeInterruptRate, computeMeanTimeToCorrect, computeMetrics, createInterruptRecord, createRepoSlug, getCurrentBranch, getRepoIdentity, getRepoRoot, isGitRepo, readJsonl, resolveInterrupt, runCommandSync, runController };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,425 @@
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
+import { homedir, hostname } from "node:os";
+import { createHash, randomUUID } from "node:crypto";
+import { spawnSync } from "node:child_process";
+
+//#region src/events.ts
+function appendJsonl(filePath, value) {
+	mkdirSync(dirname(filePath), { recursive: true });
+	writeFileSync(filePath, `${JSON.stringify(value)}\n`, {
+		encoding: "utf-8",
+		flag: "a"
+	});
+}
+function readJsonl(filePath) {
+	try {
+		return readFileSync(filePath, "utf-8").split(/\r?\n/).map((line) => line.trim()).filter(Boolean).map((line) => JSON.parse(line));
+	} catch {
+		return [];
+	}
+}
+
+//#endregion
+//#region src/lease.ts
+function sanitize$1(value) {
+	return value.replace(/[^a-zA-Z0-9._-]+/g, "_");
+}
+function processAlive(pid) {
+	if (!Number.isFinite(pid) || pid <= 0) return false;
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch {
+		return false;
+	}
+}
+function acquireRepoLease(runId, repoId, branch) {
+	const locksDir = join(homedir(), ".pi-town", "locks");
+	mkdirSync(locksDir, { recursive: true });
+	const leasePath = join(locksDir, `pi-town-${sanitize$1(repoId)}-${sanitize$1(branch)}.json`);
+	const nextData = {
+		runId,
+		repoId,
+		branch,
+		pid: process.pid,
+		hostname: hostname(),
+		startedAt: (/* @__PURE__ */ new Date()).toISOString()
+	};
+	try {
+		const current = JSON.parse(readFileSync(leasePath, "utf-8"));
+		if (processAlive(current.pid)) throw new Error(`Pi Town lease already held by pid ${current.pid} on ${current.hostname} for run ${current.runId}.`);
+		rmSync(leasePath, { force: true });
+	} catch (error) {
+		if (error.code !== "ENOENT") {
+			if (error instanceof Error && error.message.startsWith("Pi Town lease already held")) throw error;
+		}
+	}
+	writeFileSync(leasePath, `${JSON.stringify(nextData, null, 2)}\n`, "utf-8");
+	return {
+		path: leasePath,
+		release: () => {
+			try {
+				if (JSON.parse(readFileSync(leasePath, "utf-8")).runId === runId) rmSync(leasePath, { force: true });
+			} catch {}
+		}
+	};
+}
+
+//#endregion
+//#region src/metrics.ts
+function round(value) {
+	return Math.round(value * 1e3) / 1e3;
+}
+function diffHours(start, end) {
+	return (Date.parse(end) - Date.parse(start)) / 36e5;
+}
+function average(values) {
+	if (values.length === 0) return null;
+	return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+function computeInterruptRate(interrupts, taskAttempts) {
+	if (taskAttempts.length === 0) return 0;
+	return round(interrupts.length / taskAttempts.length);
+}
+function computeAutonomousCompletionRate(taskAttempts) {
+	const completed = taskAttempts.filter((task) => task.status === "completed");
+	if (completed.length === 0) return 0;
+	return round(completed.filter((task) => !task.interrupted).length / completed.length);
+}
+function computeContextCoverageScore(interrupts) {
+	const observed = new Set(interrupts.map((interrupt) => interrupt.category));
+	if (observed.size === 0) return 0;
+	return round(new Set(interrupts.filter((interrupt) => interrupt.fixType).map((interrupt) => interrupt.category)).size / observed.size);
+}
+function computeMeanTimeToCorrect(interrupts) {
+	const value = average(interrupts.filter((interrupt) => interrupt.resolvedAt).map((interrupt) => diffHours(interrupt.createdAt, interrupt.resolvedAt)));
+	return value === null ? null : round(value);
+}
+function computeFeedbackToDemoCycleTime(feedbackCycles) {
+	const value = average(feedbackCycles.map((cycle) => diffHours(cycle.feedbackAt, cycle.demoReadyAt)));
+	return value === null ? null : round(value);
+}
+function computeMetrics(input) {
+	const observedCategories = new Set(input.interrupts.map((interrupt) => interrupt.category));
+	const coveredCategories = new Set(input.interrupts.filter((interrupt) => interrupt.fixType).map((interrupt) => interrupt.category));
+	const completedTasks = input.taskAttempts.filter((task) => task.status === "completed").length;
+	return {
+		interruptRate: computeInterruptRate(input.interrupts, input.taskAttempts),
+		autonomousCompletionRate: computeAutonomousCompletionRate(input.taskAttempts),
+		contextCoverageScore: computeContextCoverageScore(input.interrupts),
+		meanTimeToCorrectHours: computeMeanTimeToCorrect(input.interrupts),
+		feedbackToDemoCycleTimeHours: computeFeedbackToDemoCycleTime(input.feedbackCycles ?? []),
+		totals: {
+			taskAttempts: input.taskAttempts.length,
+			completedTasks,
+			interrupts: input.interrupts.length,
+			observedInterruptCategories: observedCategories.size,
+			coveredInterruptCategories: coveredCategories.size
+		}
+	};
+}
+
+//#endregion
+//#region src/shell.ts
+function runCommandSync(command, args, options) {
+	const result = spawnSync(command, args, {
+		cwd: options?.cwd,
+		env: options?.env,
+		encoding: "utf-8"
+	});
+	const errorText = result.error instanceof Error ? `${result.error.message}
+` : "";
+	return {
+		stdout: result.stdout ?? "",
+		stderr: `${errorText}${result.stderr ?? ""}`,
+		exitCode: result.status ?? 1
+	};
+}
+function assertSuccess(result, context) {
+	if (result.exitCode === 0) return;
+	const details = [result.stdout.trim(), result.stderr.trim()].filter(Boolean).join("\n");
+	throw new Error(`${context} failed${details ? `\n${details}` : ""}`);
+}
+
+//#endregion
+//#region src/repo.ts
+function gitResult(cwd, args) {
+	return runCommandSync("git", args, { cwd });
+}
+function sanitize(value) {
+	return value.replace(/[^a-zA-Z0-9._-]+/g, "-").replace(/^-+|-+$/g, "") || "repo";
+}
+function isGitRepo(cwd) {
+	const result = gitResult(cwd, ["rev-parse", "--is-inside-work-tree"]);
+	return result.exitCode === 0 && result.stdout.trim() === "true";
+}
+function getRepoRoot(cwd) {
+	if (!isGitRepo(cwd)) return resolve(cwd);
+	const result = gitResult(cwd, ["rev-parse", "--show-toplevel"]);
+	assertSuccess(result, "git rev-parse --show-toplevel");
+	return resolve(result.stdout.trim());
+}
+function getCurrentBranch(cwd) {
+	if (!isGitRepo(cwd)) return null;
+	const result = gitResult(cwd, [
+		"rev-parse",
+		"--abbrev-ref",
+		"HEAD"
+	]);
+	if (result.exitCode !== 0) return null;
+	return result.stdout.trim() || null;
+}
+function getRepoIdentity(cwd) {
+	if (!isGitRepo(cwd)) return resolve(cwd);
+	const remote = gitResult(cwd, [
+		"config",
+		"--get",
+		"remote.origin.url"
+	]);
+	const remoteValue = remote.stdout.trim();
+	if (remote.exitCode === 0 && remoteValue) return remoteValue;
+	const root = gitResult(cwd, ["rev-parse", "--show-toplevel"]);
+	assertSuccess(root, "git rev-parse --show-toplevel");
+	const commonDir = gitResult(cwd, ["rev-parse", "--git-common-dir"]);
+	assertSuccess(commonDir, "git rev-parse --git-common-dir");
+	const rootPath = resolve(root.stdout.trim());
+	const commonDirPath = commonDir.stdout.trim();
+	return `${basename(rootPath)}:${rootPath}:${existsSync(commonDirPath) ? resolve(commonDirPath) : commonDirPath}`;
+}
+function createRepoSlug(repoId, repoRoot) {
+	return `${sanitize(basename(repoRoot))}-${createHash("sha1").update(repoId).digest("hex").slice(0, 8)}`;
+}
+
+//#endregion
+//#region src/controller.ts
+function createRunId() {
+	return `run-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}`;
+}
+function writeJson(path, value) {
+	writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`, "utf-8");
+}
+function writeText(path, value) {
+	writeFileSync(path, value, "utf-8");
+}
+function createPiPrompt(input) {
+	const goal = input.goal ?? "continue from current scaffold state";
+	if (input.planPath) return [
+		"Read the private plans in:",
+		`- ${input.planPath}`,
+		"",
+		"and the current code in:",
+		`- ${input.repoRoot}`,
+		"",
+		`Goal: ${goal}`,
+		"Continue from the current scaffold state.",
+		"Keep any persisted run artifacts high-signal and avoid copying private plan contents into them."
+	].join("\n");
+	return [
+		`Work in the repository at: ${input.repoRoot}`,
+		`Goal: ${goal}`,
+		"No private plan path is configured for this run.",
+		input.recommendedPlanDir ? `If you need private plans, use a user-owned location such as: ${input.recommendedPlanDir}` : "If you need private plans, keep them in a user-owned location outside the repo.",
+		"Continue from the current scaffold state."
+	].join("\n");
+}
+function createManifest(input) {
+	return {
+		runId: input.runId,
+		repoId: input.repoId,
+		repoSlug: input.repoSlug,
+		repoRoot: input.repoRoot,
+		branch: input.branch,
+		goal: input.goal,
+		planPath: input.planPath,
+		recommendedPlanDir: input.recommendedPlanDir,
+		mode: input.mode,
+		startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		endedAt: null,
+		stopReason: null,
+		leasePath: input.leasePath,
+		piExitCode: null,
+		completedTaskCount: 0,
+		blockedTaskCount: 0,
+		skippedTaskCount: 0,
+		totalCostUsd: 0
+	};
+}
+function createSummary(input) {
+	const success = input.exitCode === 0;
+	const recommendation = input.recommendedPlanDir === null ? "" : ` No plan path was configured. Recommended private plans location: ${input.recommendedPlanDir}.`;
+	return {
+		runId: input.runId,
+		mode: input.mode,
+		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+		success,
+		message: success ? `Pi invocation completed.${recommendation}` : `Pi invocation failed.${recommendation}`,
+		piExitCode: input.exitCode,
+		recommendedPlanDir: input.recommendedPlanDir
+	};
+}
+function runController(options) {
+	const cwd = options.cwd ?? process.cwd();
+	const artifactsDir = options.artifactsDir;
+	const repoRoot = getRepoRoot(cwd);
+	const repoId = getRepoIdentity(repoRoot);
+	const repoSlug = createRepoSlug(repoId, repoRoot);
+	const branch = options.branch ?? getCurrentBranch(repoRoot) ?? "workspace";
+	const goal = options.goal ?? null;
+	const planPath = options.planPath ?? null;
+	const recommendedPlanDir = planPath ? null : options.recommendedPlanDir ?? null;
+	const mode = options.mode ?? "single-pi";
+	const piCommand = options.piCommand ?? "pi";
+	const runId = createRunId();
+	const runDir = join(artifactsDir, "runs", runId);
+	const latestDir = join(artifactsDir, "latest");
+	const stdoutPath = join(runDir, "stdout.txt");
+	const stderrPath = join(runDir, "stderr.txt");
+	const prompt = createPiPrompt({
+		repoRoot,
+		planPath,
+		goal,
+		recommendedPlanDir
+	});
+	mkdirSync(runDir, { recursive: true });
+	mkdirSync(latestDir, { recursive: true });
+	writeText(join(runDir, "questions.jsonl"), "");
+	writeText(join(runDir, "interventions.jsonl"), "");
+	writeJson(join(runDir, "agent-state.json"), {
+		status: "starting",
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+	});
+	const lease = acquireRepoLease(runId, repoId, branch);
+	try {
+		const manifest = createManifest({
+			runId,
+			repoId,
+			repoSlug,
+			repoRoot,
+			branch,
+			goal,
+			planPath,
+			recommendedPlanDir,
+			mode,
+			leasePath: lease.path
+		});
+		appendJsonl(join(runDir, "events.jsonl"), {
+			type: "run_started",
+			runId,
+			repoId,
+			repoSlug,
+			branch,
+			createdAt: manifest.startedAt
+		});
+		const piStartedAt = (/* @__PURE__ */ new Date()).toISOString();
+		appendJsonl(join(runDir, "events.jsonl"), {
+			type: "pi_invocation_started",
+			runId,
+			command: piCommand,
+			createdAt: piStartedAt
+		});
+		const piResult = runCommandSync(piCommand, [
+			"--no-session",
+			"-p",
+			prompt
+		], {
+			cwd: repoRoot,
+			env: process.env
+		});
+		const piEndedAt = (/* @__PURE__ */ new Date()).toISOString();
+		writeText(stdoutPath, piResult.stdout);
+		writeText(stderrPath, piResult.stderr);
+		const piInvocation = {
+			command: piCommand,
+			cwd: repoRoot,
+			repoRoot,
+			planPath,
+			goal,
+			startedAt: piStartedAt,
+			endedAt: piEndedAt,
+			exitCode: piResult.exitCode,
+			stdoutPath,
+			stderrPath,
+			promptSummary: planPath ? "Read private plan path and continue from current scaffold state." : "Continue from current scaffold state without a configured private plan path."
+		};
+		writeJson(join(runDir, "pi-invocation.json"), piInvocation);
+		appendJsonl(join(runDir, "events.jsonl"), {
+			type: "pi_invocation_finished",
+			runId,
+			command: piCommand,
+			exitCode: piInvocation.exitCode,
+			createdAt: piEndedAt
+		});
+		const metrics = computeMetrics({
+			taskAttempts: [],
+			interrupts: []
+		});
+		const summary = createSummary({
+			runId,
+			mode,
+			exitCode: piInvocation.exitCode,
+			recommendedPlanDir
+		});
+		const finalManifest = {
+			...manifest,
+			endedAt: piEndedAt,
+			stopReason: piInvocation.exitCode === 0 ? "pi invocation completed" : `pi invocation exited with code ${piInvocation.exitCode}`,
+			piExitCode: piInvocation.exitCode
+		};
+		writeJson(join(runDir, "manifest.json"), finalManifest);
+		writeJson(join(runDir, "metrics.json"), metrics);
+		writeJson(join(runDir, "run-summary.json"), summary);
+		writeJson(join(runDir, "agent-state.json"), {
+			status: summary.success ? "completed" : "failed",
+			updatedAt: piEndedAt,
+			exitCode: piInvocation.exitCode
+		});
+		writeJson(join(latestDir, "manifest.json"), finalManifest);
+		writeJson(join(latestDir, "metrics.json"), metrics);
+		writeJson(join(latestDir, "run-summary.json"), summary);
+		appendJsonl(join(runDir, "events.jsonl"), {
+			type: "run_finished",
+			runId,
+			createdAt: finalManifest.endedAt,
+			stopReason: finalManifest.stopReason,
+			metrics
+		});
+		return {
+			runId,
+			runDir,
+			latestDir,
+			manifest: finalManifest,
+			metrics,
+			summary,
+			piInvocation
+		};
+	} finally {
+		lease.release();
+	}
+}
+
+//#endregion
+//#region src/interrupts.ts
+function createInterruptRecord(input) {
+	return {
+		id: randomUUID(),
+		runId: input.runId,
+		category: input.category,
+		summary: input.summary,
+		requiresHuman: input.requiresHuman ?? true,
+		createdAt: input.createdAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+		...input.taskId ? { taskId: input.taskId } : {},
+		...input.subtype ? { subtype: input.subtype } : {}
+	};
+}
+function resolveInterrupt(interrupt, options) {
+	return {
+		...interrupt,
+		...options.resolvedAt ? { resolvedAt: options.resolvedAt } : {},
+		...options.fixType ? { fixType: options.fixType } : {}
+	};
+}
+
+//#endregion
+export { acquireRepoLease, appendJsonl, assertSuccess, computeAutonomousCompletionRate, computeContextCoverageScore, computeFeedbackToDemoCycleTime, computeInterruptRate, computeMeanTimeToCorrect, computeMetrics, createInterruptRecord, createRepoSlug, getCurrentBranch, getRepoIdentity, getRepoRoot, isGitRepo, readJsonl, resolveInterrupt, runCommandSync, runController };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["sanitize"],"sources":["../src/events.ts","../src/lease.ts","../src/metrics.ts","../src/shell.ts","../src/repo.ts","../src/controller.ts","../src/interrupts.ts"],"sourcesContent":["import { mkdirSync, readFileSync, writeFileSync } from \"node:fs\"\nimport { dirname } from \"node:path\"\n\nexport function appendJsonl(filePath: string, value: unknown) {\n\tmkdirSync(dirname(filePath), { recursive: true })\n\twriteFileSync(filePath, `${JSON.stringify(value)}\\n`, { encoding: \"utf-8\", flag: \"a\" })\n}\n\nexport function readJsonl<T>(filePath: string): T[] {\n\ttry {\n\t\tconst raw = readFileSync(filePath, \"utf-8\")\n\t\treturn raw\n\t\t\t.split(/\\r?\\n/)\n\t\t\t.map((line) => line.trim())\n\t\t\t.filter(Boolean)\n\t\t\t.map((line) => JSON.parse(line) as T)\n\t} catch {\n\t\treturn []\n\t}\n}\n","import { mkdirSync, readFileSync, rmSync, writeFileSync } from \"node:fs\"\nimport { homedir, hostname } from \"node:os\"\nimport { join } from \"node:path\"\n\ninterface LeaseData {\n\trunId: string\n\trepoId: string\n\tbranch: string\n\tpid: number\n\thostname: string\n\tstartedAt: string\n}\n\nfunction sanitize(value: string): string {\n\treturn value.replace(/[^a-zA-Z0-9._-]+/g, \"_\")\n}\n\nfunction processAlive(pid: number): boolean {\n\tif (!Number.isFinite(pid) || pid <= 0) return false\n\ttry {\n\t\tprocess.kill(pid, 0)\n\t\treturn true\n\t} catch {\n\t\treturn false\n\t}\n}\n\nexport function acquireRepoLease(runId: string, repoId: string, branch: string): { path: string; release: () => void } {\n\tconst locksDir = join(homedir(), \".pi-town\", \"locks\")\n\tmkdirSync(locksDir, { recursive: true })\n\n\tconst leasePath = join(locksDir, `pi-town-${sanitize(repoId)}-${sanitize(branch)}.json`)\n\tconst nextData: LeaseData = {\n\t\trunId,\n\t\trepoId,\n\t\tbranch,\n\t\tpid: process.pid,\n\t\thostname: hostname(),\n\t\tstartedAt: new Date().toISOString(),\n\t}\n\n\ttry {\n\t\tconst current = JSON.parse(readFileSync(leasePath, \"utf-8\")) as LeaseData\n\t\tif (processAlive(current.pid)) {\n\t\t\tthrow new Error(`Pi Town lease already held by pid ${current.pid} on ${current.hostname} for run ${current.runId}.`)\n\t\t}\n\t\trmSync(leasePath, { force: true })\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") {\n\t\t\tif (error instanceof Error && error.message.startsWith(\"Pi Town lease already held\")) throw error\n\t\t}\n\t}\n\n\twriteFileSync(leasePath, `${JSON.stringify(nextData, null, 2)}\\n`, \"utf-8\")\n\n\treturn {\n\t\tpath: leasePath,\n\t\trelease: () => {\n\t\t\ttry {\n\t\t\t\tconst current = JSON.parse(readFileSync(leasePath, \"utf-8\")) as LeaseData\n\t\t\t\tif (current.runId === runId) rmSync(leasePath, { force: true })\n\t\t\t} catch {\n\t\t\t\t// ignore cleanup failures\n\t\t\t}\n\t\t},\n\t}\n}\n","import type { FeedbackCycle, InterruptRecord, MetricsSnapshot, TaskAttempt } from \"./types.js\"\n\nfunction round(value: number): number {\n\treturn Math.round(value * 1000) / 1000\n}\n\nfunction diffHours(start: string, end: string): number {\n\treturn (Date.parse(end) - Date.parse(start)) / 3_600_000\n}\n\nfunction average(values: number[]): number | null {\n\tif (values.length === 0) return null\n\treturn values.reduce((sum, value) => sum + value, 0) / values.length\n}\n\nexport function computeInterruptRate(interrupts: InterruptRecord[], taskAttempts: TaskAttempt[]): number {\n\tif (taskAttempts.length === 0) return 0\n\treturn round(interrupts.length / taskAttempts.length)\n}\n\nexport function computeAutonomousCompletionRate(taskAttempts: TaskAttempt[]): number {\n\tconst completed = taskAttempts.filter((task) => task.status === \"completed\")\n\tif (completed.length === 0) return 0\n\tconst autonomous = completed.filter((task) => !task.interrupted)\n\treturn round(autonomous.length / completed.length)\n}\n\nexport function computeContextCoverageScore(interrupts: InterruptRecord[]): number {\n\tconst observed = new Set(interrupts.map((interrupt) => interrupt.category))\n\tif (observed.size === 0) return 0\n\n\tconst covered = new Set(\n\t\tinterrupts.filter((interrupt) => interrupt.fixType).map((interrupt) => interrupt.category),\n\t)\n\n\treturn round(covered.size / observed.size)\n}\n\nexport function computeMeanTimeToCorrect(interrupts: InterruptRecord[]): number | null {\n\tconst resolved = interrupts.filter((interrupt) => interrupt.resolvedAt)\n\tconst hours = resolved.map((interrupt) => diffHours(interrupt.createdAt, interrupt.resolvedAt!))\n\tconst value = average(hours)\n\treturn value === null ? null : round(value)\n}\n\nexport function computeFeedbackToDemoCycleTime(feedbackCycles: FeedbackCycle[]): number | null {\n\tconst hours = feedbackCycles.map((cycle) => diffHours(cycle.feedbackAt, cycle.demoReadyAt))\n\tconst value = average(hours)\n\treturn value === null ? null : round(value)\n}\n\nexport function computeMetrics(input: {\n\ttaskAttempts: TaskAttempt[]\n\tinterrupts: InterruptRecord[]\n\tfeedbackCycles?: FeedbackCycle[]\n}): MetricsSnapshot {\n\tconst observedCategories = new Set(input.interrupts.map((interrupt) => interrupt.category))\n\tconst coveredCategories = new Set(\n\t\tinput.interrupts.filter((interrupt) => interrupt.fixType).map((interrupt) => interrupt.category),\n\t)\n\tconst completedTasks = input.taskAttempts.filter((task) => task.status === \"completed\").length\n\n\treturn {\n\t\tinterruptRate: computeInterruptRate(input.interrupts, input.taskAttempts),\n\t\tautonomousCompletionRate: computeAutonomousCompletionRate(input.taskAttempts),\n\t\tcontextCoverageScore: computeContextCoverageScore(input.interrupts),\n\t\tmeanTimeToCorrectHours: computeMeanTimeToCorrect(input.interrupts),\n\t\tfeedbackToDemoCycleTimeHours: computeFeedbackToDemoCycleTime(input.feedbackCycles ?? []),\n\t\ttotals: {\n\t\t\ttaskAttempts: input.taskAttempts.length,\n\t\t\tcompletedTasks,\n\t\t\tinterrupts: input.interrupts.length,\n\t\t\tobservedInterruptCategories: observedCategories.size,\n\t\t\tcoveredInterruptCategories: coveredCategories.size,\n\t\t},\n\t}\n}\n","import { spawnSync } from \"node:child_process\"\n\nexport interface CommandResult {\n\tstdout: string\n\tstderr: string\n\texitCode: number\n}\n\nexport function runCommandSync(\n\tcommand: string,\n\targs: string[],\n\toptions?: { cwd?: string; env?: NodeJS.ProcessEnv },\n): CommandResult {\n\tconst result = spawnSync(command, args, {\n\t\tcwd: options?.cwd,\n\t\tenv: options?.env,\n\t\tencoding: \"utf-8\",\n\t})\n\tconst errorText = result.error instanceof Error ? `${result.error.message}\n` : \"\"\n\n\treturn {\n\t\tstdout: result.stdout ?? \"\",\n\t\tstderr: `${errorText}${result.stderr ?? \"\"}`,\n\t\texitCode: result.status ?? 1,\n\t}\n}\n\nexport function assertSuccess(result: CommandResult, context: string) {\n\tif (result.exitCode === 0) return\n\tconst details = [result.stdout.trim(), result.stderr.trim()].filter(Boolean).join(\"\\n\")\n\tthrow new Error(`${context} failed${details ? `\\n${details}` : \"\"}`)\n}\n","import { createHash } from \"node:crypto\"\nimport { existsSync } from \"node:fs\"\nimport { basename, resolve } from \"node:path\"\nimport { assertSuccess, runCommandSync } from \"./shell.js\"\n\nfunction gitResult(cwd: string, args: string[]) {\n\treturn runCommandSync(\"git\", args, { cwd })\n}\n\nfunction sanitize(value: string): string {\n\treturn value.replace(/[^a-zA-Z0-9._-]+/g, \"-\").replace(/^-+|-+$/g, \"\") || \"repo\"\n}\n\nexport function isGitRepo(cwd: string): boolean {\n\tconst result = gitResult(cwd, [\"rev-parse\", \"--is-inside-work-tree\"])\n\treturn result.exitCode === 0 && result.stdout.trim() === \"true\"\n}\n\nexport function getRepoRoot(cwd: string): string {\n\tif (!isGitRepo(cwd)) return resolve(cwd)\n\tconst result = gitResult(cwd, [\"rev-parse\", \"--show-toplevel\"])\n\tassertSuccess(result, \"git rev-parse --show-toplevel\")\n\treturn resolve(result.stdout.trim())\n}\n\nexport function getCurrentBranch(cwd: string): string | null {\n\tif (!isGitRepo(cwd)) return null\n\tconst result = gitResult(cwd, [\"rev-parse\", \"--abbrev-ref\", \"HEAD\"])\n\tif (result.exitCode !== 0) return null\n\tconst branch = result.stdout.trim()\n\treturn branch || null\n}\n\nexport function getRepoIdentity(cwd: string): string {\n\tif (!isGitRepo(cwd)) return resolve(cwd)\n\n\tconst remote = gitResult(cwd, [\"config\", \"--get\", \"remote.origin.url\"])\n\tconst remoteValue = remote.stdout.trim()\n\tif (remote.exitCode === 0 && remoteValue) return remoteValue\n\n\tconst root = gitResult(cwd, [\"rev-parse\", \"--show-toplevel\"])\n\tassertSuccess(root, \"git rev-parse --show-toplevel\")\n\tconst commonDir = gitResult(cwd, [\"rev-parse\", \"--git-common-dir\"])\n\tassertSuccess(commonDir, \"git rev-parse --git-common-dir\")\n\n\tconst rootPath = resolve(root.stdout.trim())\n\tconst commonDirPath = commonDir.stdout.trim()\n\treturn `${basename(rootPath)}:${rootPath}:${existsSync(commonDirPath) ? resolve(commonDirPath) : commonDirPath}`\n}\n\nexport function createRepoSlug(repoId: string, repoRoot: string): string {\n\tconst name = sanitize(basename(repoRoot))\n\tconst digest = createHash(\"sha1\").update(repoId).digest(\"hex\").slice(0, 8)\n\treturn `${name}-${digest}`\n}\n","import { mkdirSync, writeFileSync } from \"node:fs\"\nimport { join } from \"node:path\"\nimport { appendJsonl } from \"./events.js\"\nimport { acquireRepoLease } from \"./lease.js\"\nimport { computeMetrics } from \"./metrics.js\"\nimport { createRepoSlug, getCurrentBranch, getRepoIdentity, getRepoRoot } from \"./repo.js\"\nimport { runCommandSync } from \"./shell.js\"\nimport type { ControllerRunResult, PiInvocationRecord, RunManifest, RunOptions, RunSummary } from \"./types.js\"\n\nfunction createRunId(): string {\n\treturn `run-${new Date().toISOString().replace(/[:.]/g, \"-\")}`\n}\n\nfunction writeJson(path: string, value: unknown) {\n\twriteFileSync(path, `${JSON.stringify(value, null, 2)}\\n`, \"utf-8\")\n}\n\nfunction writeText(path: string, value: string) {\n\twriteFileSync(path, value, \"utf-8\")\n}\n\nfunction createPiPrompt(input: {\n\trepoRoot: string\n\tplanPath: string | null\n\tgoal: string | null\n\trecommendedPlanDir: string | null\n}): string {\n\tconst goal = input.goal ?? \"continue from current scaffold state\"\n\n\tif (input.planPath) {\n\t\treturn [\n\t\t\t\"Read the private plans in:\",\n\t\t\t`- ${input.planPath}`,\n\t\t\t\"\",\n\t\t\t\"and the current code in:\",\n\t\t\t`- ${input.repoRoot}`,\n\t\t\t\"\",\n\t\t\t`Goal: ${goal}`,\n\t\t\t\"Continue from the current scaffold state.\",\n\t\t\t\"Keep any persisted run artifacts high-signal and avoid copying private plan contents into them.\",\n\t\t].join(\"\\n\")\n\t}\n\n\treturn [\n\t\t`Work in the repository at: ${input.repoRoot}`,\n\t\t`Goal: ${goal}`,\n\t\t\"No private plan path is configured for this run.\",\n\t\tinput.recommendedPlanDir\n\t\t\t? `If you need private plans, use a user-owned location such as: ${input.recommendedPlanDir}`\n\t\t\t: \"If you need private plans, keep them in a user-owned location outside the repo.\",\n\t\t\"Continue from the current scaffold state.\",\n\t].join(\"\\n\")\n}\n\nfunction createManifest(input: {\n\trunId: string\n\trepoId: string\n\trepoSlug: string\n\trepoRoot: string\n\tbranch: string\n\tgoal: string | null\n\tplanPath: string | null\n\trecommendedPlanDir: string | null\n\tmode: \"single-pi\"\n\tleasePath: string\n}): RunManifest {\n\treturn {\n\t\trunId: input.runId,\n\t\trepoId: input.repoId,\n\t\trepoSlug: input.repoSlug,\n\t\trepoRoot: input.repoRoot,\n\t\tbranch: input.branch,\n\t\tgoal: input.goal,\n\t\tplanPath: input.planPath,\n\t\trecommendedPlanDir: input.recommendedPlanDir,\n\t\tmode: input.mode,\n\t\tstartedAt: new Date().toISOString(),\n\t\tendedAt: null,\n\t\tstopReason: null,\n\t\tleasePath: input.leasePath,\n\t\tpiExitCode: null,\n\t\tcompletedTaskCount: 0,\n\t\tblockedTaskCount: 0,\n\t\tskippedTaskCount: 0,\n\t\ttotalCostUsd: 0,\n\t}\n}\n\nfunction createSummary(input: {\n\trunId: string\n\tmode: \"single-pi\"\n\texitCode: number\n\trecommendedPlanDir: string | null\n}): RunSummary {\n\tconst success = input.exitCode === 0\n\tconst recommendation =\n\t\tinput.recommendedPlanDir === null\n\t\t\t? \"\"\n\t\t\t: ` No plan path was configured. Recommended private plans location: ${input.recommendedPlanDir}.`\n\n\treturn {\n\t\trunId: input.runId,\n\t\tmode: input.mode,\n\t\tcreatedAt: new Date().toISOString(),\n\t\tsuccess,\n\t\tmessage: success ? `Pi invocation completed.${recommendation}` : `Pi invocation failed.${recommendation}`,\n\t\tpiExitCode: input.exitCode,\n\t\trecommendedPlanDir: input.recommendedPlanDir,\n\t}\n}\n\nexport function runController(options: RunOptions): ControllerRunResult {\n\tconst cwd = options.cwd ?? process.cwd()\n\tconst artifactsDir = options.artifactsDir\n\tconst repoRoot = getRepoRoot(cwd)\n\tconst repoId = getRepoIdentity(repoRoot)\n\tconst repoSlug = createRepoSlug(repoId, repoRoot)\n\tconst branch = options.branch ?? getCurrentBranch(repoRoot) ?? \"workspace\"\n\tconst goal = options.goal ?? null\n\tconst planPath = options.planPath ?? null\n\tconst recommendedPlanDir = planPath ? null : (options.recommendedPlanDir ?? null)\n\tconst mode = options.mode ?? \"single-pi\"\n\tconst piCommand = options.piCommand ?? \"pi\"\n\tconst runId = createRunId()\n\tconst runDir = join(artifactsDir, \"runs\", runId)\n\tconst latestDir = join(artifactsDir, \"latest\")\n\tconst stdoutPath = join(runDir, \"stdout.txt\")\n\tconst stderrPath = join(runDir, \"stderr.txt\")\n\tconst prompt = createPiPrompt({ repoRoot, planPath, goal, recommendedPlanDir })\n\n\tmkdirSync(runDir, { recursive: true })\n\tmkdirSync(latestDir, { recursive: true })\n\n\twriteText(join(runDir, \"questions.jsonl\"), \"\")\n\twriteText(join(runDir, \"interventions.jsonl\"), \"\")\n\twriteJson(join(runDir, \"agent-state.json\"), {\n\t\tstatus: \"starting\",\n\t\tupdatedAt: new Date().toISOString(),\n\t})\n\n\tconst lease = acquireRepoLease(runId, repoId, branch)\n\n\ttry {\n\t\tconst manifest = createManifest({\n\t\t\trunId,\n\t\t\trepoId,\n\t\t\trepoSlug,\n\t\t\trepoRoot,\n\t\t\tbranch,\n\t\t\tgoal,\n\t\t\tplanPath,\n\t\t\trecommendedPlanDir,\n\t\t\tmode,\n\t\t\tleasePath: lease.path,\n\t\t})\n\n\t\tappendJsonl(join(runDir, \"events.jsonl\"), {\n\t\t\ttype: \"run_started\",\n\t\t\trunId,\n\t\t\trepoId,\n\t\t\trepoSlug,\n\t\t\tbranch,\n\t\t\tcreatedAt: manifest.startedAt,\n\t\t})\n\n\t\tconst piStartedAt = new Date().toISOString()\n\t\tappendJsonl(join(runDir, \"events.jsonl\"), {\n\t\t\ttype: \"pi_invocation_started\",\n\t\t\trunId,\n\t\t\tcommand: piCommand,\n\t\t\tcreatedAt: piStartedAt,\n\t\t})\n\n\t\tconst piResult = runCommandSync(piCommand, [\"--no-session\", \"-p\", prompt], {\n\t\t\tcwd: repoRoot,\n\t\t\tenv: process.env,\n\t\t})\n\t\tconst piEndedAt = new Date().toISOString()\n\n\t\twriteText(stdoutPath, piResult.stdout)\n\t\twriteText(stderrPath, piResult.stderr)\n\n\t\tconst piInvocation: PiInvocationRecord = {\n\t\t\tcommand: piCommand,\n\t\t\tcwd: repoRoot,\n\t\t\trepoRoot,\n\t\t\tplanPath,\n\t\t\tgoal,\n\t\t\tstartedAt: piStartedAt,\n\t\t\tendedAt: piEndedAt,\n\t\t\texitCode: piResult.exitCode,\n\t\t\tstdoutPath,\n\t\t\tstderrPath,\n\t\t\tpromptSummary: planPath\n\t\t\t\t? \"Read private plan path and continue from current scaffold state.\"\n\t\t\t\t: \"Continue from current scaffold state without a configured private plan path.\",\n\t\t}\n\t\twriteJson(join(runDir, \"pi-invocation.json\"), piInvocation)\n\n\t\tappendJsonl(join(runDir, \"events.jsonl\"), {\n\t\t\ttype: \"pi_invocation_finished\",\n\t\t\trunId,\n\t\t\tcommand: piCommand,\n\t\t\texitCode: piInvocation.exitCode,\n\t\t\tcreatedAt: piEndedAt,\n\t\t})\n\n\t\tconst metrics = computeMetrics({\n\t\t\ttaskAttempts: [],\n\t\t\tinterrupts: [],\n\t\t})\n\t\tconst summary = createSummary({\n\t\t\trunId,\n\t\t\tmode,\n\t\t\texitCode: piInvocation.exitCode,\n\t\t\trecommendedPlanDir,\n\t\t})\n\t\tconst finalManifest: RunManifest = {\n\t\t\t...manifest,\n\t\t\tendedAt: piEndedAt,\n\t\t\tstopReason:\n\t\t\t\tpiInvocation.exitCode === 0\n\t\t\t\t\t? \"pi invocation completed\"\n\t\t\t\t\t: `pi invocation exited with code ${piInvocation.exitCode}`,\n\t\t\tpiExitCode: piInvocation.exitCode,\n\t\t}\n\n\t\twriteJson(join(runDir, \"manifest.json\"), finalManifest)\n\t\twriteJson(join(runDir, \"metrics.json\"), metrics)\n\t\twriteJson(join(runDir, \"run-summary.json\"), summary)\n\t\twriteJson(join(runDir, \"agent-state.json\"), {\n\t\t\tstatus: summary.success ? \"completed\" : \"failed\",\n\t\t\tupdatedAt: piEndedAt,\n\t\t\texitCode: piInvocation.exitCode,\n\t\t})\n\t\twriteJson(join(latestDir, \"manifest.json\"), finalManifest)\n\t\twriteJson(join(latestDir, \"metrics.json\"), metrics)\n\t\twriteJson(join(latestDir, \"run-summary.json\"), summary)\n\n\t\tappendJsonl(join(runDir, \"events.jsonl\"), {\n\t\t\ttype: \"run_finished\",\n\t\t\trunId,\n\t\t\tcreatedAt: finalManifest.endedAt,\n\t\t\tstopReason: finalManifest.stopReason,\n\t\t\tmetrics,\n\t\t})\n\n\t\treturn {\n\t\t\trunId,\n\t\t\trunDir,\n\t\t\tlatestDir,\n\t\t\tmanifest: finalManifest,\n\t\t\tmetrics,\n\t\t\tsummary,\n\t\t\tpiInvocation,\n\t\t}\n\t} finally {\n\t\tlease.release()\n\t}\n}\n","import { randomUUID } from \"node:crypto\"\nimport type { InterruptCategory, InterruptRecord } from \"./types.js\"\n\nexport interface CreateInterruptInput {\n\trunId: string\n\ttaskId?: string\n\tcategory: InterruptCategory\n\tsubtype?: string\n\tsummary: string\n\trequiresHuman?: boolean\n\tcreatedAt?: string\n}\n\nexport function createInterruptRecord(input: CreateInterruptInput): InterruptRecord {\n\treturn {\n\t\tid: randomUUID(),\n\t\trunId: input.runId,\n\t\tcategory: input.category,\n\t\tsummary: input.summary,\n\t\trequiresHuman: input.requiresHuman ?? true,\n\t\tcreatedAt: input.createdAt ?? new Date().toISOString(),\n\t\t...(input.taskId ? { taskId: input.taskId } : {}),\n\t\t...(input.subtype ? { subtype: input.subtype } : {}),\n\t}\n}\n\nexport function resolveInterrupt(\n\tinterrupt: InterruptRecord,\n\toptions: Pick<InterruptRecord, \"resolvedAt\" | \"fixType\">,\n): InterruptRecord {\n\treturn {\n\t\t...interrupt,\n\t\t...(options.resolvedAt ? { resolvedAt: options.resolvedAt } : {}),\n\t\t...(options.fixType ? { fixType: options.fixType } : {}),\n\t}\n}\n"],"mappings":";;;;;;;AAGA,SAAgB,YAAY,UAAkB,OAAgB;AAC7D,WAAU,QAAQ,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC;AACjD,eAAc,UAAU,GAAG,KAAK,UAAU,MAAM,CAAC,KAAK;EAAE,UAAU;EAAS,MAAM;EAAK,CAAC;;AAGxF,SAAgB,UAAa,UAAuB;AACnD,KAAI;AAEH,SADY,aAAa,UAAU,QAAQ,CAEzC,MAAM,QAAQ,CACd,KAAK,SAAS,KAAK,MAAM,CAAC,CAC1B,OAAO,QAAQ,CACf,KAAK,SAAS,KAAK,MAAM,KAAK,CAAM;SAC/B;AACP,SAAO,EAAE;;;;;;ACJX,SAASA,WAAS,OAAuB;AACxC,QAAO,MAAM,QAAQ,qBAAqB,IAAI;;AAG/C,SAAS,aAAa,KAAsB;AAC3C,KAAI,CAAC,OAAO,SAAS,IAAI,IAAI,OAAO,EAAG,QAAO;AAC9C,KAAI;AACH,UAAQ,KAAK,KAAK,EAAE;AACpB,SAAO;SACA;AACP,SAAO;;;AAIT,SAAgB,iBAAiB,OAAe,QAAgB,QAAuD;CACtH,MAAM,WAAW,KAAK,SAAS,EAAE,YAAY,QAAQ;AACrD,WAAU,UAAU,EAAE,WAAW,MAAM,CAAC;CAExC,MAAM,YAAY,KAAK,UAAU,WAAWA,WAAS,OAAO,CAAC,GAAGA,WAAS,OAAO,CAAC,OAAO;CACxF,MAAM,WAAsB;EAC3B;EACA;EACA;EACA,KAAK,QAAQ;EACb,UAAU,UAAU;EACpB,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC;AAED,KAAI;EACH,MAAM,UAAU,KAAK,MAAM,aAAa,WAAW,QAAQ,CAAC;AAC5D,MAAI,aAAa,QAAQ,IAAI,CAC5B,OAAM,IAAI,MAAM,qCAAqC,QAAQ,IAAI,MAAM,QAAQ,SAAS,WAAW,QAAQ,MAAM,GAAG;AAErH,SAAO,WAAW,EAAE,OAAO,MAAM,CAAC;UAC1B,OAAO;AACf,MAAK,MAAgC,SAAS,UAC7C;OAAI,iBAAiB,SAAS,MAAM,QAAQ,WAAW,6BAA6B,CAAE,OAAM;;;AAI9F,eAAc,WAAW,GAAG,KAAK,UAAU,UAAU,MAAM,EAAE,CAAC,KAAK,QAAQ;AAE3E,QAAO;EACN,MAAM;EACN,eAAe;AACd,OAAI;AAEH,QADgB,KAAK,MAAM,aAAa,WAAW,QAAQ,CAAC,CAChD,UAAU,MAAO,QAAO,WAAW,EAAE,OAAO,MAAM,CAAC;WACxD;;EAIT;;;;;AC/DF,SAAS,MAAM,OAAuB;AACrC,QAAO,KAAK,MAAM,QAAQ,IAAK,GAAG;;AAGnC,SAAS,UAAU,OAAe,KAAqB;AACtD,SAAQ,KAAK,MAAM,IAAI,GAAG,KAAK,MAAM,MAAM,IAAI;;AAGhD,SAAS,QAAQ,QAAiC;AACjD,KAAI,OAAO,WAAW,EAAG,QAAO;AAChC,QAAO,OAAO,QAAQ,KAAK,UAAU,MAAM,OAAO,EAAE,GAAG,OAAO;;AAG/D,SAAgB,qBAAqB,YAA+B,cAAqC;AACxG,KAAI,aAAa,WAAW,EAAG,QAAO;AACtC,QAAO,MAAM,WAAW,SAAS,aAAa,OAAO;;AAGtD,SAAgB,gCAAgC,cAAqC;CACpF,MAAM,YAAY,aAAa,QAAQ,SAAS,KAAK,WAAW,YAAY;AAC5E,KAAI,UAAU,WAAW,EAAG,QAAO;AAEnC,QAAO,MADY,UAAU,QAAQ,SAAS,CAAC,KAAK,YAAY,CACxC,SAAS,UAAU,OAAO;;AAGnD,SAAgB,4BAA4B,YAAuC;CAClF,MAAM,WAAW,IAAI,IAAI,WAAW,KAAK,cAAc,UAAU,SAAS,CAAC;AAC3E,KAAI,SAAS,SAAS,EAAG,QAAO;AAMhC,QAAO,MAJS,IAAI,IACnB,WAAW,QAAQ,cAAc,UAAU,QAAQ,CAAC,KAAK,cAAc,UAAU,SAAS,CAC1F,CAEoB,OAAO,SAAS,KAAK;;AAG3C,SAAgB,yBAAyB,YAA8C;CAGtF,MAAM,QAAQ,QAFG,WAAW,QAAQ,cAAc,UAAU,WAAW,CAChD,KAAK,cAAc,UAAU,UAAU,WAAW,UAAU,WAAY,CAAC,CACpE;AAC5B,QAAO,UAAU,OAAO,OAAO,MAAM,MAAM;;AAG5C,SAAgB,+BAA+B,gBAAgD;CAE9F,MAAM,QAAQ,QADA,eAAe,KAAK,UAAU,UAAU,MAAM,YAAY,MAAM,YAAY,CAAC,CAC/D;AAC5B,QAAO,UAAU,OAAO,OAAO,MAAM,MAAM;;AAG5C,SAAgB,eAAe,OAIX;CACnB,MAAM,qBAAqB,IAAI,IAAI,MAAM,WAAW,KAAK,cAAc,UAAU,SAAS,CAAC;CAC3F,MAAM,oBAAoB,IAAI,IAC7B,MAAM,WAAW,QAAQ,cAAc,UAAU,QAAQ,CAAC,KAAK,cAAc,UAAU,SAAS,CAChG;CACD,MAAM,iBAAiB,MAAM,aAAa,QAAQ,SAAS,KAAK,WAAW,YAAY,CAAC;AAExF,QAAO;EACN,eAAe,qBAAqB,MAAM,YAAY,MAAM,aAAa;EACzE,0BAA0B,gCAAgC,MAAM,aAAa;EAC7E,sBAAsB,4BAA4B,MAAM,WAAW;EACnE,wBAAwB,yBAAyB,MAAM,WAAW;EAClE,8BAA8B,+BAA+B,MAAM,kBAAkB,EAAE,CAAC;EACxF,QAAQ;GACP,cAAc,MAAM,aAAa;GACjC;GACA,YAAY,MAAM,WAAW;GAC7B,6BAA6B,mBAAmB;GAChD,4BAA4B,kBAAkB;GAC9C;EACD;;;;;ACnEF,SAAgB,eACf,SACA,MACA,SACgB;CAChB,MAAM,SAAS,UAAU,SAAS,MAAM;EACvC,KAAK,SAAS;EACd,KAAK,SAAS;EACd,UAAU;EACV,CAAC;CACF,MAAM,YAAY,OAAO,iBAAiB,QAAQ,GAAG,OAAO,MAAM,QAAQ;IACvE;AAEH,QAAO;EACN,QAAQ,OAAO,UAAU;EACzB,QAAQ,GAAG,YAAY,OAAO,UAAU;EACxC,UAAU,OAAO,UAAU;EAC3B;;AAGF,SAAgB,cAAc,QAAuB,SAAiB;AACrE,KAAI,OAAO,aAAa,EAAG;CAC3B,MAAM,UAAU,CAAC,OAAO,OAAO,MAAM,EAAE,OAAO,OAAO,MAAM,CAAC,CAAC,OAAO,QAAQ,CAAC,KAAK,KAAK;AACvF,OAAM,IAAI,MAAM,GAAG,QAAQ,SAAS,UAAU,KAAK,YAAY,KAAK;;;;;AC1BrE,SAAS,UAAU,KAAa,MAAgB;AAC/C,QAAO,eAAe,OAAO,MAAM,EAAE,KAAK,CAAC;;AAG5C,SAAS,SAAS,OAAuB;AACxC,QAAO,MAAM,QAAQ,qBAAqB,IAAI,CAAC,QAAQ,YAAY,GAAG,IAAI;;AAG3E,SAAgB,UAAU,KAAsB;CAC/C,MAAM,SAAS,UAAU,KAAK,CAAC,aAAa,wBAAwB,CAAC;AACrE,QAAO,OAAO,aAAa,KAAK,OAAO,OAAO,MAAM,KAAK;;AAG1D,SAAgB,YAAY,KAAqB;AAChD,KAAI,CAAC,UAAU,IAAI,CAAE,QAAO,QAAQ,IAAI;CACxC,MAAM,SAAS,UAAU,KAAK,CAAC,aAAa,kBAAkB,CAAC;AAC/D,eAAc,QAAQ,gCAAgC;AACtD,QAAO,QAAQ,OAAO,OAAO,MAAM,CAAC;;AAGrC,SAAgB,iBAAiB,KAA4B;AAC5D,KAAI,CAAC,UAAU,IAAI,CAAE,QAAO;CAC5B,MAAM,SAAS,UAAU,KAAK;EAAC;EAAa;EAAgB;EAAO,CAAC;AACpE,KAAI,OAAO,aAAa,EAAG,QAAO;AAElC,QADe,OAAO,OAAO,MAAM,IAClB;;AAGlB,SAAgB,gBAAgB,KAAqB;AACpD,KAAI,CAAC,UAAU,IAAI,CAAE,QAAO,QAAQ,IAAI;CAExC,MAAM,SAAS,UAAU,KAAK;EAAC;EAAU;EAAS;EAAoB,CAAC;CACvE,MAAM,cAAc,OAAO,OAAO,MAAM;AACxC,KAAI,OAAO,aAAa,KAAK,YAAa,QAAO;CAEjD,MAAM,OAAO,UAAU,KAAK,CAAC,aAAa,kBAAkB,CAAC;AAC7D,eAAc,MAAM,gCAAgC;CACpD,MAAM,YAAY,UAAU,KAAK,CAAC,aAAa,mBAAmB,CAAC;AACnE,eAAc,WAAW,iCAAiC;CAE1D,MAAM,WAAW,QAAQ,KAAK,OAAO,MAAM,CAAC;CAC5C,MAAM,gBAAgB,UAAU,OAAO,MAAM;AAC7C,QAAO,GAAG,SAAS,SAAS,CAAC,GAAG,SAAS,GAAG,WAAW,cAAc,GAAG,QAAQ,cAAc,GAAG;;AAGlG,SAAgB,eAAe,QAAgB,UAA0B;AAGxE,QAAO,GAFM,SAAS,SAAS,SAAS,CAAC,CAE1B,GADA,WAAW,OAAO,CAAC,OAAO,OAAO,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,EAAE;;;;;AC3C3E,SAAS,cAAsB;AAC9B,QAAO,wBAAO,IAAI,MAAM,EAAC,aAAa,CAAC,QAAQ,SAAS,IAAI;;AAG7D,SAAS,UAAU,MAAc,OAAgB;AAChD,eAAc,MAAM,GAAG,KAAK,UAAU,OAAO,MAAM,EAAE,CAAC,KAAK,QAAQ;;AAGpE,SAAS,UAAU,MAAc,OAAe;AAC/C,eAAc,MAAM,OAAO,QAAQ;;AAGpC,SAAS,eAAe,OAKb;CACV,MAAM,OAAO,MAAM,QAAQ;AAE3B,KAAI,MAAM,SACT,QAAO;EACN;EACA,KAAK,MAAM;EACX;EACA;EACA,KAAK,MAAM;EACX;EACA,SAAS;EACT;EACA;EACA,CAAC,KAAK,KAAK;AAGb,QAAO;EACN,8BAA8B,MAAM;EACpC,SAAS;EACT;EACA,MAAM,qBACH,iEAAiE,MAAM,uBACvE;EACH;EACA,CAAC,KAAK,KAAK;;AAGb,SAAS,eAAe,OAWR;AACf,QAAO;EACN,OAAO,MAAM;EACb,QAAQ,MAAM;EACd,UAAU,MAAM;EAChB,UAAU,MAAM;EAChB,QAAQ,MAAM;EACd,MAAM,MAAM;EACZ,UAAU,MAAM;EAChB,oBAAoB,MAAM;EAC1B,MAAM,MAAM;EACZ,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,SAAS;EACT,YAAY;EACZ,WAAW,MAAM;EACjB,YAAY;EACZ,oBAAoB;EACpB,kBAAkB;EAClB,kBAAkB;EAClB,cAAc;EACd;;AAGF,SAAS,cAAc,OAKR;CACd,MAAM,UAAU,MAAM,aAAa;CACnC,MAAM,iBACL,MAAM,uBAAuB,OAC1B,KACA,qEAAqE,MAAM,mBAAmB;AAElG,QAAO;EACN,OAAO,MAAM;EACb,MAAM,MAAM;EACZ,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC;EACA,SAAS,UAAU,2BAA2B,mBAAmB,wBAAwB;EACzF,YAAY,MAAM;EAClB,oBAAoB,MAAM;EAC1B;;AAGF,SAAgB,cAAc,SAA0C;CACvE,MAAM,MAAM,QAAQ,OAAO,QAAQ,KAAK;CACxC,MAAM,eAAe,QAAQ;CAC7B,MAAM,WAAW,YAAY,IAAI;CACjC,MAAM,SAAS,gBAAgB,SAAS;CACxC,MAAM,WAAW,eAAe,QAAQ,SAAS;CACjD,MAAM,SAAS,QAAQ,UAAU,iBAAiB,SAAS,IAAI;CAC/D,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,WAAW,QAAQ,YAAY;CACrC,MAAM,qBAAqB,WAAW,OAAQ,QAAQ,sBAAsB;CAC5E,MAAM,OAAO,QAAQ,QAAQ;CAC7B,MAAM,YAAY,QAAQ,aAAa;CACvC,MAAM,QAAQ,aAAa;CAC3B,MAAM,SAAS,KAAK,cAAc,QAAQ,MAAM;CAChD,MAAM,YAAY,KAAK,cAAc,SAAS;CAC9C,MAAM,aAAa,KAAK,QAAQ,aAAa;CAC7C,MAAM,aAAa,KAAK,QAAQ,aAAa;CAC7C,MAAM,SAAS,eAAe;EAAE;EAAU;EAAU;EAAM;EAAoB,CAAC;AAE/E,WAAU,QAAQ,EAAE,WAAW,MAAM,CAAC;AACtC,WAAU,WAAW,EAAE,WAAW,MAAM,CAAC;AAEzC,WAAU,KAAK,QAAQ,kBAAkB,EAAE,GAAG;AAC9C,WAAU,KAAK,QAAQ,sBAAsB,EAAE,GAAG;AAClD,WAAU,KAAK,QAAQ,mBAAmB,EAAE;EAC3C,QAAQ;EACR,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,CAAC;CAEF,MAAM,QAAQ,iBAAiB,OAAO,QAAQ,OAAO;AAErD,KAAI;EACH,MAAM,WAAW,eAAe;GAC/B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,WAAW,MAAM;GACjB,CAAC;AAEF,cAAY,KAAK,QAAQ,eAAe,EAAE;GACzC,MAAM;GACN;GACA;GACA;GACA;GACA,WAAW,SAAS;GACpB,CAAC;EAEF,MAAM,+BAAc,IAAI,MAAM,EAAC,aAAa;AAC5C,cAAY,KAAK,QAAQ,eAAe,EAAE;GACzC,MAAM;GACN;GACA,SAAS;GACT,WAAW;GACX,CAAC;EAEF,MAAM,WAAW,eAAe,WAAW;GAAC;GAAgB;GAAM;GAAO,EAAE;GAC1E,KAAK;GACL,KAAK,QAAQ;GACb,CAAC;EACF,MAAM,6BAAY,IAAI,MAAM,EAAC,aAAa;AAE1C,YAAU,YAAY,SAAS,OAAO;AACtC,YAAU,YAAY,SAAS,OAAO;EAEtC,MAAM,eAAmC;GACxC,SAAS;GACT,KAAK;GACL;GACA;GACA;GACA,WAAW;GACX,SAAS;GACT,UAAU,SAAS;GACnB;GACA;GACA,eAAe,WACZ,qEACA;GACH;AACD,YAAU,KAAK,QAAQ,qBAAqB,EAAE,aAAa;AAE3D,cAAY,KAAK,QAAQ,eAAe,EAAE;GACzC,MAAM;GACN;GACA,SAAS;GACT,UAAU,aAAa;GACvB,WAAW;GACX,CAAC;EAEF,MAAM,UAAU,eAAe;GAC9B,cAAc,EAAE;GAChB,YAAY,EAAE;GACd,CAAC;EACF,MAAM,UAAU,cAAc;GAC7B;GACA;GACA,UAAU,aAAa;GACvB;GACA,CAAC;EACF,MAAM,gBAA6B;GAClC,GAAG;GACH,SAAS;GACT,YACC,aAAa,aAAa,IACvB,4BACA,kCAAkC,aAAa;GACnD,YAAY,aAAa;GACzB;AAED,YAAU,KAAK,QAAQ,gBAAgB,EAAE,cAAc;AACvD,YAAU,KAAK,QAAQ,eAAe,EAAE,QAAQ;AAChD,YAAU,KAAK,QAAQ,mBAAmB,EAAE,QAAQ;AACpD,YAAU,KAAK,QAAQ,mBAAmB,EAAE;GAC3C,QAAQ,QAAQ,UAAU,cAAc;GACxC,WAAW;GACX,UAAU,aAAa;GACvB,CAAC;AACF,YAAU,KAAK,WAAW,gBAAgB,EAAE,cAAc;AAC1D,YAAU,KAAK,WAAW,eAAe,EAAE,QAAQ;AACnD,YAAU,KAAK,WAAW,mBAAmB,EAAE,QAAQ;AAEvD,cAAY,KAAK,QAAQ,eAAe,EAAE;GACzC,MAAM;GACN;GACA,WAAW,cAAc;GACzB,YAAY,cAAc;GAC1B;GACA,CAAC;AAEF,SAAO;GACN;GACA;GACA;GACA,UAAU;GACV;GACA;GACA;GACA;WACQ;AACT,QAAM,SAAS;;;;;;ACpPjB,SAAgB,sBAAsB,OAA8C;AACnF,QAAO;EACN,IAAI,YAAY;EAChB,OAAO,MAAM;EACb,UAAU,MAAM;EAChB,SAAS,MAAM;EACf,eAAe,MAAM,iBAAiB;EACtC,WAAW,MAAM,8BAAa,IAAI,MAAM,EAAC,aAAa;EACtD,GAAI,MAAM,SAAS,EAAE,QAAQ,MAAM,QAAQ,GAAG,EAAE;EAChD,GAAI,MAAM,UAAU,EAAE,SAAS,MAAM,SAAS,GAAG,EAAE;EACnD;;AAGF,SAAgB,iBACf,WACA,SACkB;AAClB,QAAO;EACN,GAAG;EACH,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,YAAY,GAAG,EAAE;EAChE,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,SAAS,GAAG,EAAE;EACvD"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@schilderlabs/pitown-core",
+  "version": "0.1.0",
+  "description": "Core runtime primitives for Pi Town",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
+    }
+  },
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "devDependencies": {
+    "eslint": "9.39.3",
+    "tsdown": "0.20.3",
+    "typescript": "5.9.2",
+    "vitest": "4.0.18"
+  },
+  "keywords": [
+    "pitown",
+    "orchestration",
+    "runtime",
+    "night-shift"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/schilderlabs/pitown.git"
+  },
+  "homepage": "https://github.com/schilderlabs/pitown#readme",
+  "bugs": {
+    "url": "https://github.com/schilderlabs/pitown/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsdown",
+    "lint": "eslint .",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit"
+  }
+}