@phren/cli/dist/shell/state-store.js

Knowledge layer for AI agents - CLI, MCP server, and data layer

import * as fs from "fs";
import * as path from "path";
import { phrenOk, shellStateFile } from "../shared.js";
import { withSafeLock } from "../shared/data-utils.js";
import { errorMessage } from "../utils.js";
import { logger } from "../logger.js";
const SHELL_STATE_VERSION = 3;
const VALID_VIEWS = new Set(["Projects", "Tasks", "Findings", "Review Queue", "Skills", "Hooks", "Machines/Profiles", "Health", "Graph"]);
export function loadShellState(phrenPath) {
    const file = shellStateFile(phrenPath);
    const fallback = {
        version: SHELL_STATE_VERSION,
        view: "Projects",
        page: 1,
        perPage: 40,
        introMode: "once-per-version",
    };
    if (!fs.existsSync(file))
        return fallback;
    try {
        const raw = JSON.parse(fs.readFileSync(file, "utf8"));
        const persistedView = VALID_VIEWS.has(raw.view)
            ? raw.view
            : fallback.view;
        return {
            version: SHELL_STATE_VERSION,
            view: persistedView,
            project: raw.project,
            filter: raw.filter,
            taskResponsibility: raw.taskResponsibility === "human" || raw.taskResponsibility === "agent" ? raw.taskResponsibility : undefined,
            page: Number.isFinite(raw.page) ? Number(raw.page) : fallback.page,
            perPage: Number.isFinite(raw.perPage) ? Number(raw.perPage) : fallback.perPage,
            introMode: raw.introMode === "always" || raw.introMode === "off" ? raw.introMode : "once-per-version",
            introSeenVersion: typeof raw.introSeenVersion === "string" ? raw.introSeenVersion : undefined,
        };
    }
    catch (err) {
        logger.debug("shell-state", `loadShellState parse: ${errorMessage(err)}`);
        return fallback;
    }
}
export function saveShellState(phrenPath, state) {
    const file = shellStateFile(phrenPath);
    fs.mkdirSync(path.dirname(file), { recursive: true });
    withSafeLock(file, () => {
        const out = {
            version: SHELL_STATE_VERSION,
            view: state.view,
            project: state.project,
            filter: state.filter,
            taskResponsibility: state.taskResponsibility,
            page: state.page,
            perPage: state.perPage,
            introMode: state.introMode,
            introSeenVersion: state.introSeenVersion,
        };
        fs.writeFileSync(file, JSON.stringify(out, null, 2) + "\n");
        return phrenOk(undefined);
    });
}
export function resetShellState(phrenPath) {
    const file = shellStateFile(phrenPath);
    return withSafeLock(file, () => {
        if (fs.existsSync(file))
            fs.unlinkSync(file);
        return phrenOk("Shell state reset.");
    });
}