@vincenthanxiaodu/pi-web 1.202608.1

package/dist/server/diagnostics/nodePtyNativeModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodePtyNativeModule.js","sourceRoot":"","sources":["../../../src/server/diagnostics/nodePtyNativeModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,CAAC,MAAM,iCAAiC,GAAG,kEAAkE,CAAC;AAEpH,MAAM,WAAW,GAAG,iCAAiC,CAAC;AACtD,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAiBvD,MAAM,UAAU,wBAAwB,CAAC,UAA2C,EAAE;IACpF,IAAI,CAAC;QACH,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC,EAAE,CAAC;QAChC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;IACjE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAA+B;IAC5E,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,KAAK,WAAW,EAAE,CAAC,EAAE,CAAC;IAC5E,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE;YACL,KAAK,WAAW,EAAE;YAClB,8BAA8B,KAAK,CAAC,OAAO,EAAE;YAC7C,4DAA4D;YAC5D,yDAAyD;YACzD,OAAO,iCAAiC,EAAE;YAC1C,mCAAmC;SACpC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAChD,CAAC"}

package/dist/server/diagnostics/nodePtySpawnHelper.js

@@ -0,0 +1,135 @@
+import { accessSync, constants, existsSync, statSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+export const PI_WEB_SPAWN_HELPER_ISSUE_URL = "https://github.com/jmfederico/pi-web/issues/4";
+export const NODE_PTY_SPAWN_HELPER_UPSTREAM_ISSUE_URL = "https://github.com/microsoft/node-pty/issues/850";
+const doctorLabel = "node-pty macOS spawn-helper executable";
+const requireFromHere = createRequire(import.meta.url);
+export function checkNodePtyDarwinSpawnHelper(options = {}) {
+    const platform = options.platform ?? process.platform;
+    if (platform !== "darwin")
+        return { status: "skipped", reason: "not-macos" };
+    const arch = options.arch ?? process.arch;
+    const exists = options.exists ?? existsSync;
+    const stat = options.stat ?? statSync;
+    const access = options.access ?? accessSync;
+    let nodePtyPackageJsonPath;
+    try {
+        nodePtyPackageJsonPath = options.nodePtyPackageJsonPath ?? (options.resolveNodePtyPackageJson ?? resolveNodePtyPackageJson)();
+    }
+    catch (error) {
+        return { status: "node-pty-not-found", message: errorMessage(error) };
+    }
+    const nodePtyRoot = dirname(nodePtyPackageJsonPath);
+    const nativeDir = findNodePtyNativeDir(nodePtyRoot, platform, arch, exists);
+    if (nativeDir === undefined) {
+        return {
+            status: "native-module-not-found",
+            nodePtyRoot,
+            expectedHelperPath: join(nodePtyRoot, "prebuilds", `${platform}-${arch}`, "spawn-helper"),
+        };
+    }
+    const helperPath = join(nativeDir, "spawn-helper");
+    try {
+        if (!stat(helperPath).isFile())
+            return { status: "spawn-helper-not-file", helperPath, nodePtyRoot };
+    }
+    catch (error) {
+        if (isFileNotFoundError(error))
+            return { status: "spawn-helper-missing", helperPath, nodePtyRoot };
+        return { status: "spawn-helper-stat-error", helperPath, nodePtyRoot, message: errorMessage(error) };
+    }
+    try {
+        access(helperPath, constants.X_OK);
+        return { status: "ok", helperPath, nodePtyRoot };
+    }
+    catch {
+        return { status: "spawn-helper-not-executable", helperPath, nodePtyRoot, fixCommand: chmodFixCommand(helperPath) };
+    }
+}
+export function formatNodePtyDarwinSpawnHelperCheck(check) {
+    if (check.status === "skipped")
+        return { ok: true, lines: [] };
+    if (check.status === "ok") {
+        return {
+            ok: true,
+            lines: [`✓ ${doctorLabel}`, `  ${check.helperPath}`],
+        };
+    }
+    if (check.status === "spawn-helper-not-executable") {
+        return {
+            ok: false,
+            lines: [
+                `✗ ${doctorLabel}`,
+                `  ${check.helperPath} exists but is not executable.`,
+                `  Known upstream node-pty packaging issue: ${NODE_PTY_SPAWN_HELPER_UPSTREAM_ISSUE_URL}`,
+                `  PI WEB tracking issue: ${PI_WEB_SPAWN_HELPER_ISSUE_URL}`,
+                "  Proposed workaround:",
+                `    ${check.fixCommand}`,
+                "  Then run `pi-web doctor` again and retry opening a terminal.",
+            ],
+        };
+    }
+    return {
+        ok: false,
+        lines: [`✗ ${doctorLabel}`, ...failureDetails(check)],
+    };
+}
+function resolveNodePtyPackageJson() {
+    return requireFromHere.resolve("node-pty/package.json");
+}
+function findNodePtyNativeDir(nodePtyRoot, platform, arch, exists) {
+    for (const dir of nodePtyNativeDirs(nodePtyRoot, platform, arch)) {
+        if (exists(join(dir, "pty.node")))
+            return dir;
+    }
+    return undefined;
+}
+function nodePtyNativeDirs(nodePtyRoot, platform, arch) {
+    const dirs = ["build/Release", "build/Debug", `prebuilds/${platform}-${arch}`];
+    return dirs.flatMap((dir) => [join(nodePtyRoot, dir), join(nodePtyRoot, "lib", dir)]);
+}
+function failureDetails(check) {
+    if (check.status === "node-pty-not-found") {
+        return [
+            `  Could not resolve node-pty from PI WEB: ${check.message}`,
+            "  Reinstall or update PI WEB, then run `pi-web doctor` again.",
+        ];
+    }
+    if (check.status === "native-module-not-found") {
+        return [
+            `  Could not find node-pty's native pty.node module under ${check.nodePtyRoot}.`,
+            `  Expected macOS helper location: ${check.expectedHelperPath}`,
+            "  Reinstall or update PI WEB, then run `pi-web doctor` again.",
+        ];
+    }
+    if (check.status === "spawn-helper-missing") {
+        return [
+            `  Expected helper is missing: ${check.helperPath}`,
+            "  Reinstall or update PI WEB, then run `pi-web doctor` again.",
+        ];
+    }
+    if (check.status === "spawn-helper-not-file") {
+        return [
+            `  Expected helper is not a regular file: ${check.helperPath}`,
+            "  Reinstall or update PI WEB, then run `pi-web doctor` again.",
+        ];
+    }
+    return [
+        `  Could not inspect ${check.helperPath}: ${check.message}`,
+        "  Check the file permissions, then run `pi-web doctor` again.",
+    ];
+}
+function chmodFixCommand(path) {
+    return `chmod +x ${shellSingleQuote(path)}`;
+}
+function shellSingleQuote(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+function isFileNotFoundError(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=nodePtySpawnHelper.js.map

package/dist/server/diagnostics/nodePtySpawnHelper.js.map

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

package/dist/server/git/gitEnv.js

@@ -0,0 +1,15 @@
+const GIT_LOCAL_ENV_VARS = [
+    "GIT_ALTERNATE_OBJECT_DIRECTORIES",
+    "GIT_COMMON_DIR",
+    "GIT_DIR",
+    "GIT_INDEX_FILE",
+    "GIT_OBJECT_DIRECTORY",
+    "GIT_PREFIX",
+    "GIT_QUARANTINE_PATH",
+    "GIT_WORK_TREE",
+];
+export function sanitizedGitEnv(env = process.env) {
+    const blocked = new Set(GIT_LOCAL_ENV_VARS);
+    return Object.fromEntries(Object.entries(env).filter(([key]) => !blocked.has(key)));
+}
+//# sourceMappingURL=gitEnv.js.map

package/dist/server/git/gitEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitEnv.js","sourceRoot":"","sources":["../../../src/server/git/gitEnv.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG;IACzB,kCAAkC;IAClC,gBAAgB;IAChB,SAAS;IACT,gBAAgB;IAChB,sBAAsB;IACtB,YAAY;IACZ,qBAAqB;IACrB,eAAe;CAChB,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,MAAyB,OAAO,CAAC,GAAG;IAClE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,kBAAkB,CAAC,CAAC;IACpD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC"}

package/dist/server/goals/goalArchive.js

@@ -0,0 +1,184 @@
+import { mkdir, readFile, readdir, rename, rm, stat, unlink, writeFile } from "node:fs/promises";
+import { appendFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, posix } from "node:path";
+import { GOALS_DIRECTORY } from "./goalStore.js";
+import { extractGoalJsonBlock } from "./goalFile.js";
+export class GoalArchiveError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "GoalArchiveError";
+    }
+}
+/** How long another process's lock is honoured before it counts as abandoned. */
+const LOCK_STALE_MS = 30_000;
+/** The extension waits ~100ms for this lock, so ours must be far shorter. */
+const LOCK_ATTEMPTS = 5;
+const LOCK_RETRY_MS = 12;
+export async function archiveWorkspaceGoal(workspacePath, goalId, options = {}) {
+    const safeId = goalIdForPath(goalId);
+    const directory = join(workspacePath, GOALS_DIRECTORY);
+    const now = options.now ?? (() => new Date());
+    const release = await acquireGoalLock(directory, safeId, now);
+    try {
+        const active = await findActiveGoalFile(directory, goalId);
+        if (active === undefined) {
+            return { goalId, archivedPath: "", alreadyArchived: true, agentMayRecreate: false };
+        }
+        const record = parseGoalRecord(active.content);
+        const archivedName = `goal_${archiveStamp(now())}_${safeId}.md`;
+        const archivedPath = join(directory, "archived", archivedName);
+        await mkdir(join(directory, "archived"), { recursive: true });
+        const archivedContent = archivedGoalContent(active.content, record, {
+            // Stored inside the record, not handed to the filesystem: the extension
+            // writes these as POSIX relative paths (`.pi/goals/...`), so a Windows
+            // separator here would be a foreign value in someone else's format.
+            archivedPath: posix.join(".pi", "goals", "archived", archivedName),
+            at: now().toISOString(),
+        });
+        const temporary = `${archivedPath}.${String(process.pid)}.${String(now().getTime())}.tmp`;
+        await writeFile(temporary, archivedContent, "utf8");
+        await rename(temporary, archivedPath);
+        await unlink(active.path);
+        appendGoalEvent(directory, {
+            type: "goal_archived",
+            goalId,
+            archivePath: archivedPath,
+            at: now().toISOString(),
+            source: "pi-web",
+        });
+        await dropPoolSnapshot(options.home ?? homedir(), workspacePath);
+        return { goalId, archivedPath, alreadyArchived: false, agentMayRecreate: true };
+    }
+    finally {
+        await release();
+    }
+}
+/**
+ * The lock file the extension uses. `wx` is the whole mechanism: whoever
+ * creates the file owns the goal. A lock left by a process that died is taken
+ * over once it is older than the staleness window, since otherwise a crash
+ * during a turn would make the goal permanently unarchivable.
+ */
+async function acquireGoalLock(directory, safeId, now) {
+    const locks = join(directory, ".locks");
+    const lockPath = join(locks, `${safeId}.lock`);
+    await mkdir(locks, { recursive: true });
+    for (let attempt = 0; attempt < LOCK_ATTEMPTS; attempt++) {
+        try {
+            await writeFile(lockPath, JSON.stringify({ pid: process.pid, startedAt: now().toISOString() }), { encoding: "utf8", flag: "wx" });
+            return async () => { await rm(lockPath, { force: true }); };
+        }
+        catch {
+            if (await lockIsStale(lockPath, now)) {
+                await rm(lockPath, { force: true });
+                continue;
+            }
+            await delay(LOCK_RETRY_MS);
+        }
+    }
+    throw new GoalArchiveError("The goal is being written by another process; try again in a moment.", "locked");
+}
+async function lockIsStale(lockPath, now) {
+    try {
+        const stats = await stat(lockPath);
+        return now().getTime() - stats.mtimeMs > LOCK_STALE_MS;
+    }
+    catch {
+        return false;
+    }
+}
+async function findActiveGoalFile(directory, goalId) {
+    let entries;
+    try {
+        entries = await readdir(directory);
+    }
+    catch {
+        return undefined;
+    }
+    for (const entry of entries) {
+        if (!entry.startsWith("active_goal_") || !entry.endsWith(".md"))
+            continue;
+        const path = join(directory, entry);
+        let content;
+        try {
+            content = await readFile(path, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const record = parseGoalRecord(content);
+        if (record["id"] === goalId)
+            return { path, content };
+    }
+    return undefined;
+}
+function parseGoalRecord(content) {
+    const block = extractGoalJsonBlock(content);
+    if (block === undefined)
+        throw new GoalArchiveError("The goal record has no JSON header to update.", "invalid");
+    const parsed = JSON.parse(block);
+    if (!isRecord(parsed))
+        throw new GoalArchiveError("The goal record's header is not an object.", "invalid");
+    return { ...parsed };
+}
+/**
+ * Rewrite the header and keep everything after it byte for byte: the prose is
+ * where the objective actually lives, so a rewritten body would change the goal
+ * while archiving it.
+ */
+function archivedGoalContent(content, record, archive) {
+    const block = extractGoalJsonBlock(content);
+    if (block === undefined)
+        throw new GoalArchiveError("The goal record has no JSON header to update.", "invalid");
+    const status = record["status"];
+    const nextRecord = {
+        ...record,
+        status: status === "complete" || status === "completed" ? status : "paused",
+        stopReason: "user",
+        archivedPath: archive.archivedPath,
+        updatedAt: archive.at,
+        revision: typeof record["revision"] === "number" ? record["revision"] + 1 : 1,
+    };
+    delete nextRecord["activePath"];
+    const body = content.slice(content.indexOf(block) + block.length);
+    return `${JSON.stringify(nextRecord, undefined, 2)}${body}`;
+}
+/**
+ * The ledger is append-only and read line by line, and its own reader tolerates
+ * a torn tail. One synchronous append keeps the record whole.
+ */
+function appendGoalEvent(directory, event) {
+    try {
+        appendFileSync(join(directory, "goal_events.jsonl"), `${JSON.stringify(event)}\n`, "utf8");
+    }
+    catch {
+        // A missing ledger is not a reason to leave the goal in place; the archived
+        // file and the removed active file are the durable part of this operation.
+    }
+}
+/**
+ * Delete rather than rewrite: a missing snapshot costs one rescan, while a
+ * stale one keeps reporting a goal that is no longer open.
+ */
+async function dropPoolSnapshot(home, workspacePath) {
+    const candidates = [join(home, ".pi", ".goals-pool-snapshot.json"), join(workspacePath, ".pi", ".goals-pool-snapshot.json")];
+    await Promise.all(candidates.map(async (candidate) => { await rm(candidate, { force: true }); }));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function goalIdForPath(goalId) {
+    const safe = goalId.replace(/[^a-zA-Z0-9_-]/g, "-");
+    if (safe === "" || safe.length > 128)
+        throw new GoalArchiveError("That goal id cannot be used as a file name.", "invalid");
+    return safe;
+}
+function archiveStamp(now) {
+    return now.toISOString().replace(/[-:.TZ]/g, "").slice(0, 14);
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=goalArchive.js.map

package/dist/server/goals/goalArchive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goalArchive.js","sourceRoot":"","sources":["../../../src/server/goals/goalArchive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAyCrD,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe,EAAW,IAAwC;QAC5E,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,SAAI,GAAJ,IAAI,CAAoC;QAE5E,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,aAAa,GAAG,MAAM,CAAC;AAC7B,6EAA6E;AAC7E,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,aAAa,GAAG,EAAE,CAAC;AAQzB,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,aAAqB,EAAE,MAAc,EAAE,UAA8B,EAAE;IAChH,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC3D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,CAAC;QACtF,CAAC;QAED,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,YAAY,GAAG,QAAQ,YAAY,CAAC,GAAG,EAAE,CAAC,IAAI,MAAM,KAAK,CAAC;QAChE,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QAC/D,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9D,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE;YAClE,wEAAwE;YACxE,uEAAuE;YACvE,oEAAoE;YACpE,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,CAAC;YAClE,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;SACxB,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,GAAG,YAAY,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC;QAC1F,MAAM,SAAS,CAAC,SAAS,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACtC,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE1B,eAAe,CAAC,SAAS,EAAE;YACzB,IAAI,EAAE,eAAe;YACrB,MAAM;YACN,WAAW,EAAE,YAAY;YACzB,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;YACvB,MAAM,EAAE,QAAQ;SACjB,CAAC,CAAC;QACH,MAAM,gBAAgB,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;QAEjE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC;IAClF,CAAC;YAAS,CAAC;QACT,MAAM,OAAO,EAAE,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,MAAc,EAAE,GAAe;IAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IAC/C,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAExC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,aAAa,EAAE,OAAO,EAAE,EAAE,CAAC;QACzD,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAClI,OAAO,KAAK,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,MAAM,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpC,SAAS;YACX,CAAC;YACD,MAAM,KAAK,CAAC,aAAa,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,MAAM,IAAI,gBAAgB,CAAC,sEAAsE,EAAE,QAAQ,CAAC,CAAC;AAC/G,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,GAAe;IAC1D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,GAAG,aAAa,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAID,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,MAAc;IACjE,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACpC,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,MAAM;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACxD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,eAAe,CAAC,OAAe;IACtC,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,gBAAgB,CAAC,+CAA+C,EAAE,SAAS,CAAC,CAAC;IAChH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,gBAAgB,CAAC,4CAA4C,EAAE,SAAS,CAAC,CAAC;IAC3G,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,OAAe,EAAE,MAA+B,EAAE,OAA6C;IAC1H,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,gBAAgB,CAAC,+CAA+C,EAAE,SAAS,CAAC,CAAC;IAChH,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,UAAU,GAA4B;QAC1C,GAAG,MAAM;QACT,MAAM,EAAE,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;QAC3E,UAAU,EAAE,MAAM;QAClB,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,SAAS,EAAE,OAAO,CAAC,EAAE;QACrB,QAAQ,EAAE,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;KAC9E,CAAC;IACF,OAAO,UAAU,CAAC,YAAY,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAClE,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,SAAiB,EAAE,KAA8B;IACxE,IAAI,CAAC;QACH,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7F,CAAC;IAAC,MAAM,CAAC;QACP,4EAA4E;QAC5E,2EAA2E;IAC7E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,aAAqB;IACjE,MAAM,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,2BAA2B,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,EAAE,2BAA2B,CAAC,CAAC,CAAC;IAC7H,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,gBAAgB,CAAC,6CAA6C,EAAE,SAAS,CAAC,CAAC;IAC3H,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,GAAS;IAC7B,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/server/goals/goalFile.js

@@ -0,0 +1,200 @@
+/**
+ * Reading goal records written by the `pi-goal-x` extension.
+ *
+ * A goal file is a Markdown document whose *leading* block is the complete
+ * record as pretty-printed JSON, followed by a human-readable rendering:
+ *
+ * ```
+ * {
+ *   "version": 3,
+ *   "id": "...",
+ *   ...
+ * }
+ *
+ * # Goal Prompt
+ * ...
+ * ```
+ *
+ * Only the JSON block is authoritative here; the prose below it is a
+ * projection of the same fields and is never parsed. The extension owns the
+ * format, so this reader is deliberately permissive: unknown fields are
+ * ignored and a record missing anything required is skipped rather than
+ * failing the whole listing.
+ */
+/** Guard against a runaway or truncated file consuming the parse. */
+const MAX_GOAL_FILE_BYTES = 512 * 1024;
+/**
+ * Extract the leading JSON object of a goal file.
+ *
+ * Brace counting is string- and escape-aware so a brace inside an objective
+ * (`"ship {this}"`) cannot end the block early. Returns undefined when the
+ * content does not begin with a JSON object, which is the expected outcome for
+ * a file caught mid-write.
+ */
+export function extractGoalJsonBlock(content) {
+    const start = content.indexOf("{");
+    if (start === -1)
+        return undefined;
+    // Anything before the object other than whitespace means this is not a goal
+    // file laid out as expected.
+    if (content.slice(0, start).trim() !== "")
+        return undefined;
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let index = start; index < content.length; index += 1) {
+        const character = content[index];
+        if (inString) {
+            if (escaped)
+                escaped = false;
+            else if (character === "\\")
+                escaped = true;
+            else if (character === "\"")
+                inString = false;
+            continue;
+        }
+        if (character === "\"")
+            inString = true;
+        else if (character === "{")
+            depth += 1;
+        else if (character === "}") {
+            depth -= 1;
+            if (depth === 0)
+                return content.slice(start, index + 1);
+        }
+    }
+    return undefined;
+}
+/**
+ * Parse one goal file into the summary the browser renders.
+ *
+ * Returns undefined for content that is not a usable record: a partial write,
+ * a foreign file that happens to live in the directory, or a record without
+ * the identity fields the UI needs. Callers skip those rather than surfacing
+ * an error, because a goal directory is written concurrently by the extension
+ * and a transient unparseable read is normal.
+ */
+export function parseGoalFile(content, filePath) {
+    if (content.length > MAX_GOAL_FILE_BYTES)
+        return undefined;
+    const block = extractGoalJsonBlock(content);
+    if (block === undefined)
+        return undefined;
+    let record;
+    try {
+        record = JSON.parse(block);
+    }
+    catch {
+        return undefined;
+    }
+    const fields = asRecord(record);
+    if (fields === undefined)
+        return undefined;
+    const id = optionalString(fields["id"]);
+    const objective = optionalString(fields["objective"]);
+    if (id === undefined || objective === undefined)
+        return undefined;
+    const tasks = parseTasks(fields["taskList"]);
+    return {
+        id,
+        objective,
+        status: optionalString(fields["status"]) ?? "unknown",
+        path: filePath,
+        sisyphus: fields["sisyphus"] === true,
+        autoContinue: fields["autoContinue"] === true,
+        ...optional("createdAt", optionalString(fields["createdAt"])),
+        ...optional("updatedAt", optionalString(fields["updatedAt"])),
+        ...optional("currentTaskId", optionalString(fields["currentTaskId"])),
+        ...optional("stopReason", optionalString(fields["stopReason"])),
+        ...optional("pauseReason", optionalString(fields["pauseReason"])),
+        ...optional("verificationContract", optionalString(fields["verificationContract"])),
+        ...optional("tokensUsed", optionalNonNegativeNumber(usageField(fields["usage"], "tokensUsed"))),
+        ...optional("activeSeconds", optionalNonNegativeNumber(usageField(fields["usage"], "activeSeconds"))),
+        tasks,
+        completedTaskCount: countTasks(tasks, (task) => task.status === "complete"),
+        totalTaskCount: countTasks(tasks, () => true),
+    };
+}
+/**
+ * Order goals for display: unfinished work first, then most recently updated.
+ * A completed goal is still listed — it is the record of what was achieved —
+ * but never above a goal that still needs attention.
+ */
+export function sortGoalSummaries(goals) {
+    return [...goals].sort((left, right) => {
+        const leftDone = isFinishedStatus(left.status);
+        const rightDone = isFinishedStatus(right.status);
+        if (leftDone !== rightDone)
+            return leftDone ? 1 : -1;
+        return (right.updatedAt ?? "").localeCompare(left.updatedAt ?? "");
+    });
+}
+function isFinishedStatus(status) {
+    return status === "complete" || status === "completed" || status === "abandoned";
+}
+function parseTasks(value) {
+    const taskList = asRecord(value);
+    if (taskList === undefined)
+        return [];
+    const list = taskList["tasks"];
+    if (!Array.isArray(list))
+        return [];
+    const tasks = [];
+    for (const entry of list) {
+        const task = parseTask(entry);
+        if (task !== undefined)
+            tasks.push(task);
+    }
+    return tasks;
+}
+function parseTask(value) {
+    const fields = asRecord(value);
+    if (fields === undefined)
+        return undefined;
+    const id = optionalString(fields["id"]);
+    const title = optionalString(fields["title"]);
+    if (id === undefined || title === undefined)
+        return undefined;
+    const subtasks = Array.isArray(fields["subtasks"])
+        ? fields["subtasks"].map(parseTask).filter((task) => task !== undefined)
+        : [];
+    return {
+        id,
+        title,
+        status: optionalString(fields["status"]) ?? "pending",
+        ...optional("verificationContract", optionalString(fields["verificationContract"])),
+        ...(subtasks.length === 0 ? {} : { subtasks }),
+    };
+}
+function countTasks(tasks, predicate) {
+    let count = 0;
+    for (const task of tasks) {
+        if (predicate(task))
+            count += 1;
+        if (task.subtasks !== undefined)
+            count += countTasks(task.subtasks, predicate);
+    }
+    return count;
+}
+function usageField(usage, key) {
+    return asRecord(usage)?.[key];
+}
+/** Narrow an unknown to a plain object without asserting a shape onto it. */
+function asRecord(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return undefined;
+    return Object.fromEntries(Object.entries(value));
+}
+function optionalString(value) {
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+function optionalNonNegativeNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : undefined;
+}
+function optional(key, value) {
+    const result = {};
+    if (value !== undefined)
+        result[key] = value;
+    return result;
+}
+//# sourceMappingURL=goalFile.js.map

package/dist/server/goals/goalFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goalFile.js","sourceRoot":"","sources":["../../../src/server/goals/goalFile.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,qEAAqE;AACrE,MAAM,mBAAmB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEvC;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACnC,4EAA4E;IAC5E,6BAA6B;IAC7B,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAE5D,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,IAAI,KAAK,GAAG,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,OAAO;gBAAE,OAAO,GAAG,KAAK,CAAC;iBACxB,IAAI,SAAS,KAAK,IAAI;gBAAE,OAAO,GAAG,IAAI,CAAC;iBACvC,IAAI,SAAS,KAAK,IAAI;gBAAE,QAAQ,GAAG,KAAK,CAAC;YAC9C,SAAS;QACX,CAAC;QACD,IAAI,SAAS,KAAK,IAAI;YAAE,QAAQ,GAAG,IAAI,CAAC;aACnC,IAAI,SAAS,KAAK,GAAG;YAAE,KAAK,IAAI,CAAC,CAAC;aAClC,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAC3B,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,QAAgB;IAC7D,IAAI,OAAO,CAAC,MAAM,GAAG,mBAAmB;QAAE,OAAO,SAAS,CAAC;IAC3D,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC5C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IACtD,IAAI,EAAE,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAElE,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7C,OAAO;QACL,EAAE;QACF,SAAS;QACT,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,SAAS;QACrD,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI;QACrC,YAAY,EAAE,MAAM,CAAC,cAAc,CAAC,KAAK,IAAI;QAC7C,GAAG,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QAC7D,GAAG,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QAC7D,GAAG,QAAQ,CAAC,eAAe,EAAE,cAAc,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;QACrE,GAAG,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;QAC/D,GAAG,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;QACjE,GAAG,QAAQ,CAAC,sBAAsB,EAAE,cAAc,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACnF,GAAG,QAAQ,CAAC,YAAY,EAAE,yBAAyB,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;QAC/F,GAAG,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;QACrG,KAAK;QACL,kBAAkB,EAAE,UAAU,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC;QAC3E,cAAc,EAAE,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAmC;IACnE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACrC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,OAAO,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,WAAW,CAAC;AACnF,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,KAAK,GAAsB,EAAE,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9C,IAAI,EAAE,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAA2B,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC;QACjG,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;QACL,EAAE;QACF,KAAK;QACL,MAAM,EAAE,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,SAAS;QACrD,GAAG,QAAQ,CAAC,sBAAsB,EAAE,cAAc,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;QACnF,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAiC,EAAE,SAA6C;IAClG,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,SAAS,CAAC,IAAI,CAAC;YAAE,KAAK,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,GAAW;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,6EAA6E;AAC7E,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1F,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/F,CAAC;AAED,SAAS,QAAQ,CAAsB,GAAM,EAAE,KAAoB;IACjE,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/server/goals/goalStore.js

@@ -0,0 +1,65 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { parseGoalFile, sortGoalSummaries } from "./goalFile.js";
+/**
+ * Directory, relative to a workspace, where `pi-goal-x` keeps its records.
+ * Sessions of the same workspace share it, which is exactly why several goals
+ * can be open at once.
+ */
+export const GOALS_DIRECTORY = join(".pi", "goals");
+/**
+ * Upper bound on files inspected per listing. A goal directory is small by
+ * nature; the cap only stops a pathological directory from stalling a request.
+ */
+const MAX_GOAL_FILES = 200;
+/**
+ * List the goals recorded under a workspace.
+ *
+ * The directory is written concurrently by the extension (it keeps a `.locks/`
+ * subdirectory for exactly that reason), so this reader treats an unreadable
+ * or half-written file as absent rather than as an error: a transient parse
+ * failure must not blank the panel for every other goal. A missing directory
+ * is simply "no goals", which is the common case.
+ */
+export async function readWorkspaceGoals(workspacePath, now = () => new Date()) {
+    const directory = join(workspacePath, GOALS_DIRECTORY);
+    const response = (goals) => ({
+        goals,
+        directory,
+        generatedAt: now().toISOString(),
+    });
+    let entries;
+    try {
+        entries = await readdir(directory, { withFileTypes: true });
+    }
+    catch {
+        return response([]);
+    }
+    const files = entries
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".md"))
+        .slice(0, MAX_GOAL_FILES);
+    const goals = [];
+    await Promise.all(files.map(async (entry) => {
+        const path = join(directory, entry.name);
+        let content;
+        try {
+            content = await readFile(path, "utf8");
+        }
+        catch {
+            return;
+        }
+        const goal = parseGoalFile(content, path);
+        if (goal !== undefined)
+            goals.push(goal);
+    }));
+    // Records are keyed by id, but a goal that was archived to a second file
+    // would otherwise appear twice; the most recently updated copy wins.
+    const byId = new Map();
+    for (const goal of goals) {
+        const existing = byId.get(goal.id);
+        if (existing === undefined || (goal.updatedAt ?? "") > (existing.updatedAt ?? ""))
+            byId.set(goal.id, goal);
+    }
+    return response(sortGoalSummaries([...byId.values()]));
+}
+//# sourceMappingURL=goalStore.js.map

package/dist/server/goals/goalStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goalStore.js","sourceRoot":"","sources":["../../../src/server/goals/goalStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEjE;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAEpD;;;GAGG;AACH,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,aAAqB,EAAE,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;IACpF,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,CAAC,KAA0B,EAA0B,EAAE,CAAC,CAAC;QACxE,KAAK;QACL,SAAS;QACT,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE;KACjC,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO;SAClB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SAC/D,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAE5B,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC1C,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC,CAAC;IAEJ,yEAAyE;IACzE,qEAAqE;IACrE,MAAM,IAAI,GAAG,IAAI,GAAG,EAA6B,CAAC;IAClD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7G,CAAC;IAED,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { effectivePiWebConfig, maxUploadBytes } from "../config.js";
+import { buildApp } from "./app.js";
+const { config } = effectivePiWebConfig();
+const app = await buildApp({ bodyLimit: maxUploadBytes(process.env, config) });
+await app.listen({ port: config.port ?? 8504, host: config.host ?? "127.0.0.1" });
+//# sourceMappingURL=index.js.map