@phren/cli/dist/data/task-format.js

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

import * as fs from "node:fs";
import * as path from "node:path";
import { atomicWriteText } from "../phren-paths.js";
import { withFileLock } from "../governance/locks.js";
import { permissionDeniedError } from "../governance/rbac.js";
import { registeredStoreIdentity } from "../store-registry.js";
const file = (base) => path.join(base, ".config", "task-format.json");
export const taskFormatMigrationHint = "Task metadata is not enabled for this store. Upgrade every CLI, MCP, Hook, sync and app writer first; an owner can then run phren task format enable --all-writers-compatible. Existing writers must be replaced through the coordinated adoption workflow.";
/** An explicit store-owner acknowledgement, not inferred from one serving Hook.
 * It cannot fence an old binary that ignores this file: coordinated adoption of
 * every writer remains a prerequisite, and is stated at the activation boundary. */
export function taskFormatStatus(base) {
    try {
        const value = JSON.parse(fs.readFileSync(file(base), "utf8"));
        if (value?.version === 1 && value.allWritersCompatible === true && typeof value.storeId === "string"
            && value.storeId === registeredStoreIdentity(base) && typeof value.acknowledgedAt === "string"
            && Number.isFinite(Date.parse(value.acknowledgedAt))) {
            return { enabled: true, version: 1, acknowledgedAt: value.acknowledgedAt };
        }
    }
    catch { /* Missing, malformed or unsupported activation remains disabled. */ }
    return { enabled: false, version: 1 };
}
/** Wire status describes admission, never proof that old filesystem/Git writers
 * have been upgraded. Such writers do not consult our activation file. */
export function taskWriterSafety(base) {
    const status = taskFormatStatus(base);
    return {
        version: 1,
        metadataVersion: 1,
        activation: status.enabled ? "owner-acknowledged" : "disabled",
        requiresCoordinatedAdoption: true,
        legacyWritersFenced: false,
        ...(status.acknowledgedAt ? { acknowledgedAt: status.acknowledgedAt } : {}),
    };
}
export function enableTaskFormat(base, allWritersCompatible) {
    const denied = permissionDeniedError(base, "manage_config");
    if (denied)
        throw new Error(denied);
    if (allWritersCompatible !== true)
        throw new Error(taskFormatMigrationHint);
    const storeId = registeredStoreIdentity(base);
    if (!storeId)
        throw new Error("Register a portable store identity with phren store identity --create before enabling task metadata.");
    fs.mkdirSync(path.dirname(file(base)), { recursive: true });
    withFileLock(file(base), () => {
        if (taskFormatStatus(base).enabled)
            return;
        // A future-format or malformed file is evidence, not permission to replace it.
        if (fs.existsSync(file(base)))
            throw new Error("Existing task-format.json is unsupported or belongs to another store. Review it before enabling metadata.");
        atomicWriteText(file(base), JSON.stringify({ version: 1, storeId, allWritersCompatible: true, acknowledgedAt: new Date().toISOString() }, null, 2) + "\n");
    });
}