Skip to content

armgit / cogit

Public Imported from GitHub
0

Git for the intent behind agent-written code. Records what your coding agent decided and why, and links every commit to it.

3.6 KB
Raw Blame
import { homedir } from "node:os";
import { join } from "node:path";

export const DIR_NAME = ".cogit";
/** The name cogit used before Story 9.1; still read so a record is never lost. */
export const OLD_DIR_NAME = ".codelineage";
export const CONFIG_DIR_NAME = "cogit";
export const OLD_CONFIG_DIR_NAME = "codelineage";

/** `COGIT_HOME`, still accepting `CODELINEAGE_HOME` for one minor version. */
export function configuredHome(env: NodeJS.ProcessEnv = process.env): string | undefined {
  return env.COGIT_HOME ?? env.CODELINEAGE_HOME;
}

/** Hooks are off when either the current or the legacy switch is set. */
export function captureDisabled(env: NodeJS.ProcessEnv = process.env): boolean {
  return env.COGIT_DISABLE === "1" || env.CODELINEAGE_DISABLE === "1";
}

export function projectPaths(root: string) {
  const base = join(root, DIR_NAME);
  return {
    base,
    project: join(base, "project.json"),
    sessions: join(base, "sessions"),
    session: (id: string) => join(base, "sessions", `${id}.json`),
    /** Append-only structure events for a session (Story 8.5). */
    events: (id: string) => join(base, "sessions", `${id}.events.jsonl`),
    /** Pre-migration copies of the record files. */
    backup: (name: string) => join(base, name),
    /** The conversation store: what the drill-down needs, outliving the transcript. */
    conversations: join(base, "conversations"),
    conversation: (id: string) => join(base, "conversations", `${id}.jsonl.gz`),
    state: (id: string) => join(base, "state", `${id}.json`),
    /** Inbox rows the user dismissed, per session (Story 11.1); also local. */
    inboxState: join(base, "state", "inbox.json"),
    /** How the user left the map: open sessions and dragged row widths; also local. */
    mapView: join(base, "state", "map.json"),
    /** The curated captured-work list (Story 15.1); local, never committed. */
    captures: join(base, "state", "captures.json"),
    /** What the detached hook children (build, side run) printed; local, capped. */
    detachedLog: join(base, "state", "detached.log"),
    /** What the record refs last looked like, and what waits to be sent; local. */
    recordSync: join(base, "state", "record-sync.json"),
    /** Present after `cogit hooks uninstall`: the refresh then adds no block; local. */
    hooksOff: join(base, "state", "hooks-off"),
    /** Commits waiting for their message's record before a Shape; local. */
    shapeQueue: join(base, "state", "shape-queue"),
    locks: join(base, "locks"),
    /** Where the skill drops session JSON for `session write --file`. */
    inbox: (id: string) => join(base, "inbox", `${id}.json`),
    lock: (name: string) => join(base, "locks", `${name}.lock`),
    html: join(base, "map.html"),
    /**
     * The session whose next code commit carries its record (Story 9.3), written
     * by the UserPromptSubmit hook. Local state, never committed.
     */
    head: join(base, "HEAD"),
    /** The project-scoped ignore rules that keep local state out of git. */
    gitignore: join(base, ".gitignore"),
  };
}

/** `$XDG_CONFIG_HOME/<name>` > `~/.config/<name>`. */
export function defaultConfigBase(name: string, env: NodeJS.ProcessEnv = process.env): string {
  return join(env.XDG_CONFIG_HOME ?? join(homedir(), ".config"), name);
}

/** `COGIT_HOME` > `CODELINEAGE_HOME` > `$XDG_CONFIG_HOME/cogit` > `~/.config/cogit`. */
export function globalPaths(env: NodeJS.ProcessEnv = process.env) {
  const base = configuredHome(env) ?? defaultConfigBase(CONFIG_DIR_NAME, env);
  return {
    base,
    config: join(base, "config.json"),
    registry: join(base, "projects.json"),
    lock: join(base, "registry.lock"),
    panel: join(base, "panel.html"),
  };
}