@rucher/carnet 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Florian Varrin
+
+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

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# @rucher/carnet
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Shared state for Rucher: groups, sessions, agents, the "On the table" line and the event journal, stored in one SQLite database per group (`<meta directory>/.rucher/carnet.db`, via `node:sqlite`).
+
+Used by the `rucher` CLI and the Carnet MCP server. See `docs/carnet-spec.md` at the repository root.
+
+```ts
+import { openCarnet } from '@rucher/carnet';
+
+const carnet = openCarnet({ cwd: process.cwd() });
+const session = carnet.sessions.default();
+if (session) console.log(carnet.status.render(session));
+```
+
+## Development
+
+```bash
+vp test
+vp check
+vp pack
+```

package/dist/carnet-CSdqWDas.d.mts

@@ -0,0 +1,261 @@
+import { DatabaseSync } from "node:sqlite";
+interface Ctx {
+  db: DatabaseSync;
+  now: () => Date;
+}
+declare const AGENT_STATUSES: readonly ['running', 'discussing', 'answer', 'review', 'apply', 'test', 'commit', 'branch', 'closed'];
+type AgentStatus = (typeof AGENT_STATUSES)[number];
+declare const USER_ACTION_STATUSES: readonly ['discussing', 'answer', 'review', 'apply', 'test', 'commit', 'branch'];
+type UserActionStatus = (typeof USER_ACTION_STATUSES)[number];
+declare const EMOJI: Record<Exclude<AgentStatus, 'closed'>, string>;
+declare const MAIN_WORKING_EMOJI = "⚙️";
+declare const LEGEND = "⚙️ main working · 💬 discussing · ❓ answer · 👀 review · 📥 apply · 🧪 test · ✅ commit · 🌿 branch · ⏳ running";
+declare function isAgentStatus(value: unknown): value is AgentStatus;
+declare function isUserActionStatus(value: unknown): value is UserActionStatus;
+interface Agent {
+  session: string;
+  name: string;
+  task: string | null;
+  status: AgentStatus;
+  note: string | null;
+  reportPath: string | null;
+  baseCommit: string | null;
+  worktree: string | null;
+  queueOrder: number | null;
+  hostAgentId: string | null;
+  pendingStatus: AgentStatus | null;
+  doneAt: string | null;
+  startedAt: string;
+  updatedAt: string;
+}
+interface StartAgentInput {
+  name: string;
+  task: string;
+  baseCommit?: string | undefined;
+  worktree?: string | undefined;
+}
+interface UpdateAgentInput {
+  status: AgentStatus;
+  note?: string | undefined;
+  reportPath?: string | undefined;
+}
+interface FinishAgentInput {
+  reportPath: string;
+  hasQuestions: boolean;
+}
+interface ListAgentsOptions {
+  includeClosed?: boolean;
+}
+declare const REPORTING_NOTE = "reporting";
+declare const PUBLISH_FALLBACK_MILLISECONDS = 120000;
+declare const GROUP_DIRECTORY = ".rucher";
+declare const REPORTS_DIRECTORY = "reports";
+declare const GROUP_FILE = "group.json";
+declare const DB_FILE = "carnet.db";
+interface Group {
+  root: string;
+  name: string;
+  repos: string[];
+  hosts: string[];
+  dbPath: string;
+}
+interface GroupFile {
+  name: string;
+  repos: string[];
+  hosts?: string[] | undefined;
+}
+declare function isInside(directory: string, path: string): boolean;
+declare function repoNameFor(group: Group, path: string | undefined): string | null;
+declare function repoPathFor(group: Group, path: string | undefined | null): string | null;
+declare function findGroupRoot(from: string): string | null;
+declare function reportsDirectoryOf(group: Group): string;
+declare function reportPathFor(group: Group, agentName: string): string;
+declare function isGroupRoot(directory: string): boolean;
+declare function loadGroup(root: string): Group;
+interface LocateOptions {
+  cwd?: string;
+  env?: NodeJS.ProcessEnv;
+}
+declare function locateGroup({ cwd, env }?: LocateOptions): Group;
+interface HostSessionPayload {
+  session_id: string;
+  cwd?: string | undefined;
+  source?: string | undefined;
+  session_title?: string | undefined;
+}
+interface HostPromptPayload {
+  session_id: string;
+  cwd?: string | undefined;
+  session_title?: string | undefined;
+  transcript_path?: string | undefined;
+}
+interface HostSubagentPayload {
+  session_id: string;
+  agent_id: string;
+  agent_type?: string | undefined;
+  cwd?: string | undefined;
+}
+interface ResumeCommand {
+  command: string;
+  args: string[];
+}
+interface ContextFile {
+  path: string;
+  sync(group: Group, mode: 'merge' | 'exact'): ContextFileResult;
+}
+type ContextFileResult = 'written' | 'updated' | 'unchanged' | 'no-markers';
+interface Host {
+  id: string;
+  displayName: string;
+  processId(env: NodeJS.ProcessEnv): number | null;
+  sessionIdFromEnvironment(env: NodeJS.ProcessEnv): string | undefined;
+  projectDirectory(env: NodeJS.ProcessEnv): string | undefined;
+  parseSessionPayload(json: string): HostSessionPayload;
+  parsePromptPayload(json: string): HostPromptPayload;
+  parseSubagentPayload(json: string): HostSubagentPayload;
+  promptTitle(payload: HostPromptPayload): string | undefined;
+  resumeCommand(session: Session): ResumeCommand;
+  renameInstruction(name: string): string;
+  contextFiles: readonly ContextFile[];
+}
+declare const DEFAULT_HOST = "claude-code";
+declare function allHosts(): Host[];
+declare function hostById(id: string): Host;
+type SessionStatus = 'temporary' | 'active' | 'dropped';
+interface Session {
+  id: string;
+  name: string | null;
+  purpose: string | null;
+  status: SessionStatus;
+  cwd: string | null;
+  repo: string | null;
+  host: string;
+  hostPid: number | null;
+  hookedAt: string | null;
+  createdAt: string;
+  lastActiveAt: string;
+}
+type HookSessionPayload = HostSessionPayload;
+interface HookEnv {
+  host?: string | undefined;
+  processId?: number | null | undefined;
+  RUCHER_PURGE_DAYS?: string | undefined;
+}
+interface ListSessionsOptions {
+  includeTemporary?: boolean | undefined;
+  includeDropped?: boolean | undefined;
+}
+declare const MINIMUM_ID_PREFIX = 4;
+declare function shortId(id: string): string;
+interface MergeResult {
+  session: Session;
+  movedAgents: string[];
+  closedAgents: string[];
+  movedEvents: number;
+  movedTable: boolean;
+}
+interface TableItem {
+  session: string;
+  text: string;
+  status: UserActionStatus | null;
+  mainWorking: boolean;
+  updatedAt: string;
+}
+interface SetTableInput {
+  text: string;
+  mainWorking: boolean;
+  status?: UserActionStatus | undefined;
+}
+declare const EVENT_TYPES: readonly ['started', 'finished', 'answered', 'applied', 'tested', 'committed', 'dropped'];
+type EventType = (typeof EVENT_TYPES)[number];
+interface CarnetEvent {
+  id: number;
+  session: string;
+  at: string;
+  type: EventType;
+  agent: string | null;
+  commit: string | null;
+  link: string | null;
+  note: string | null;
+}
+interface LogEventInput {
+  type: EventType;
+  agent?: string | undefined;
+  commit?: string | undefined;
+  link?: string | undefined;
+  note?: string | undefined;
+}
+declare function isEventType(value: unknown): value is EventType;
+interface StatusLine {
+  name: string;
+  status: AgentStatus;
+  emoji: string;
+  note: string | null;
+}
+interface StatusView {
+  time: string;
+  sessionName: string | null;
+  table: TableItem | null;
+  waiting: StatusLine[];
+  running: StatusLine[];
+}
+declare function formatClock(date: Date): string;
+declare function buildStatusView(ctx: Ctx, session: Session): StatusView;
+interface CarnetOptions {
+  now?: () => Date;
+}
+declare class Carnet {
+  readonly group: Group;
+  readonly db: DatabaseSync;
+  private readonly ctx;
+  constructor(group: Group, db: DatabaseSync, options?: CarnetOptions);
+  readonly sessions: {
+    get: (id: string) => Session | undefined;
+    find: (reference: string) => Session;
+    require: (id: string) => Session;
+    ensure: (id: string, cwd?: string) => Session;
+    upsertFromHook: (payload: HookSessionPayload, env?: HookEnv) => Session;
+    touch: (id: string) => void;
+    merge: (fromId: string, intoId: string) => MergeResult;
+    purge: (keepId: string, days: number) => string[];
+    name: (id: string, name: string, purpose?: string) => Session;
+    adoptTitle: (id: string, title: string | undefined) => Session;
+    list: (options?: ListSessionsOptions) => Session[];
+    drop: (id: string) => Session;
+    default: () => Session | undefined;
+    byName: (name: string) => Session | undefined;
+    byHostProcess: (host: string, processId: number) => Session | undefined;
+  };
+  readonly agents: {
+    get: (session: string, name: string) => Agent | undefined;
+    start: (session: string, input: StartAgentInput) => Agent;
+    update: (session: string, name: string, input: UpdateAgentInput) => Agent;
+    finish: (session: string, name: string, input: FinishAgentInput) => Agent;
+    drop: (session: string, name: string, reason?: string) => Agent;
+    list: (session: string, options?: ListAgentsOptions) => Agent[];
+    reorderQueue: (session: string, names: string[]) => Agent[];
+    pairSubagent: (session: string, hostAgentId: string) => Agent | undefined;
+    stopSubagent: (session: string, hostAgentId: string) => Agent | undefined;
+  };
+  readonly table: {
+    get: (session: string) => TableItem | undefined;
+    set: (session: string, input: SetTableInput) => TableItem;
+    clear: (session: string) => void;
+  };
+  readonly events: {
+    log: (session: string, input: LogEventInput) => CarnetEvent;
+    read: (session: string, limit?: number) => CarnetEvent[];
+  };
+  readonly status: {
+    view: (session: Session) => StatusView;
+    render: (session: Session) => string;
+    sections: (session: Session) => string;
+  };
+  close(): void;
+}
+interface OpenCarnetOptions extends LocateOptions, CarnetOptions {
+  dbPath?: string;
+}
+declare function openCarnet(options?: OpenCarnetOptions): Carnet;
+export { PUBLISH_FALLBACK_MILLISECONDS as $, HostSubagentPayload as A, REPORTS_DIRECTORY as B, shortId as C, Host as D, DEFAULT_HOST as E, GROUP_DIRECTORY as F, locateGroup as G, isGroupRoot as H, GROUP_FILE as I, reportPathFor as J, repoNameFor as K, Group as L, allHosts as M, hostById as N, HostPromptPayload as O, DB_FILE as P, ListAgentsOptions as Q, GroupFile as R, SessionStatus as S, ContextFileResult as T, isInside as U, findGroupRoot as V, loadGroup as W, Agent as X, reportsDirectoryOf as Y, FinishAgentInput as Z, HookEnv as _, StatusLine as a, EMOJI as at, MINIMUM_ID_PREFIX as b, formatClock as c, USER_ACTION_STATUSES as ct, EventType as d, isUserActionStatus as dt, REPORTING_NOTE as et, LogEventInput as f, MergeResult as g, TableItem as h, openCarnet as i, AgentStatus as it, ResumeCommand as j, HostSessionPayload as k, CarnetEvent as l, UserActionStatus as lt, SetTableInput as m, CarnetOptions as n, UpdateAgentInput as nt, StatusView as o, LEGEND as ot, isEventType as p, repoPathFor as q, OpenCarnetOptions as r, AGENT_STATUSES as rt, buildStatusView as s, MAIN_WORKING_EMOJI as st, Carnet as t, StartAgentInput as tt, EVENT_TYPES as u, isAgentStatus as ut, HookSessionPayload as v, ContextFile as w, Session as x, ListSessionsOptions as y, LocateOptions as z };
+//# sourceMappingURL=carnet-CSdqWDas.d.mts.map

package/dist/carnet-CSdqWDas.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carnet-CSdqWDas.d.mts","names":["_$__merge_ts0.MergeResult","_$__agents_ts0.Agent","_$__table_ts0.TableItem","_$__events_ts0.CarnetEvent","_$__status_view_ts0.StatusView"],"sources":["../src/context.ts","../src/status/model.ts","../src/agents.ts","../src/group/locate.ts","../src/hosts/host.ts","../src/sessions.ts","../src/merge.ts","../src/table.ts","../src/events.ts","../src/status/view.ts","../src/carnet.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,65 @@
+import { $ as PUBLISH_FALLBACK_MILLISECONDS, A as HostSubagentPayload, B as REPORTS_DIRECTORY, C as shortId, D as Host, E as DEFAULT_HOST, F as GROUP_DIRECTORY, G as locateGroup, H as isGroupRoot, I as GROUP_FILE, J as reportPathFor, K as repoNameFor, L as Group, M as allHosts, N as hostById, O as HostPromptPayload, P as DB_FILE, Q as ListAgentsOptions, R as GroupFile, S as SessionStatus, T as ContextFileResult, U as isInside, V as findGroupRoot, W as loadGroup, X as Agent, Y as reportsDirectoryOf, Z as FinishAgentInput, _ as HookEnv, a as StatusLine, at as EMOJI, b as MINIMUM_ID_PREFIX, c as formatClock, ct as USER_ACTION_STATUSES, d as EventType, dt as isUserActionStatus, et as REPORTING_NOTE, f as LogEventInput, g as MergeResult, h as TableItem, i as openCarnet, it as AgentStatus, j as ResumeCommand, k as HostSessionPayload, l as CarnetEvent, lt as UserActionStatus, m as SetTableInput, n as CarnetOptions, nt as UpdateAgentInput, o as StatusView, ot as LEGEND, p as isEventType, q as repoPathFor, r as OpenCarnetOptions, rt as AGENT_STATUSES, s as buildStatusView, st as MAIN_WORKING_EMOJI, t as Carnet, tt as StartAgentInput, u as EVENT_TYPES, ut as isAgentStatus, v as HookSessionPayload, w as ContextFile, x as Session, y as ListSessionsOptions, z as LocateOptions } from "./carnet-CSdqWDas.mjs";
+import { DatabaseSync } from "node:sqlite";
+export declare const MEMORY_DB = ":memory:";
+export declare function openDatabase(path: string): DatabaseSync;
+export declare const migrations: readonly string[];
+export declare function schemaVersion(db: DatabaseSync): number;
+export declare function migrate(db: DatabaseSync): void;
+type CarnetErrorCode = 'NO_GROUP' | 'GROUP_EXISTS' | 'REPO_NOT_FOUND' | 'UNKNOWN_HOST' | 'NO_SESSION' | 'SESSION_NOT_FOUND' | 'SESSION_AMBIGUOUS' | 'SESSION_NAME_TAKEN' | 'SESSION_MERGE_INVALID' | 'AGENT_EXISTS' | 'AGENT_NOT_FOUND' | 'INVALID_STATUS' | 'INVALID_EVENT_TYPE' | 'TABLE_STATUS_WITH_MAIN_WORKING';
+export declare class CarnetError extends Error {
+  readonly code: CarnetErrorCode;
+  constructor(code: CarnetErrorCode, message: string);
+}
+interface InitOptions {
+  name?: string | undefined;
+  repos?: string[] | undefined;
+  hosts?: string[] | undefined;
+  env?: NodeJS.ProcessEnv | undefined;
+}
+export declare function initGroup(directory: string, options?: InitOptions): Group;
+export declare function addGroupRepo(root: string, repo: string): Group;
+export declare function removeGroupRepo(root: string, repo: string): Group;
+interface GroupReference {
+  name: string;
+  path: string;
+}
+export declare function rucherHome(env?: NodeJS.ProcessEnv): string;
+export declare function readRegistry(env?: NodeJS.ProcessEnv): GroupReference[];
+export declare function registerGroup(reference: GroupReference, env?: NodeJS.ProcessEnv): GroupReference[];
+export declare function unregisterGroups(paths: string[], env?: NodeJS.ProcessEnv): GroupReference[];
+interface SessionStartResult {
+  session: Session;
+  additionalContext?: string;
+}
+export declare function handleSessionStart(carnet: Carnet, payload: HookSessionPayload, env: HookEnv): SessionStartResult;
+export declare function handleUserPromptSubmit(carnet: Carnet, host: Host, payload: HostPromptPayload): Session;
+export declare const REPOS_START = "<!-- rucher:repos start -->";
+export declare const REPOS_END = "<!-- rucher:repos end -->";
+export declare function transcriptTitle(path: string): string | undefined;
+export declare function reposBlock(group: Group): string;
+export declare function replaceReposBlock(content: string, group: Group): string | null;
+export declare function groupInstructions(group: Group): string;
+export declare function groupSettings(group: Group): string;
+export declare const claudeCode: Host;
+export declare const DEFAULT_PURGE_DAYS = 3;
+export declare function purgeDays(value: string | undefined): number;
+export declare const RESUME_EVENTS = 20;
+export declare const RESUME_MAX_CHARACTERS = 2000;
+interface ResumeContextOptions {
+  events?: number;
+  maxCharacters?: number;
+}
+export declare function formatEventLine(event: CarnetEvent): string;
+export declare function sessionLabel(session: Session): string;
+export declare function resumeContext(carnet: Carnet, session: Session, { events, maxCharacters }?: ResumeContextOptions): string;
+export declare const PAIRING_WINDOW_MILLISECONDS = 60000;
+export declare const STOPPED_NOTE = "stopped without agent_done";
+export declare const NOTE_MAX = 60;
+export declare function sanitizeNote(text: string): string;
+export declare const MAIN_WORKING_SUFFIX = "(main working, not ready)";
+export declare function renderTableLine(item: TableItem): string;
+export declare function renderAgentLine(line: StatusLine): string;
+export declare function renderSections(view: StatusView): string;
+export declare function renderStatus(view: StatusView): string;
+export { AGENT_STATUSES, type Agent, type AgentStatus, Carnet, type CarnetErrorCode, type CarnetEvent, type CarnetOptions, type ContextFile, type ContextFileResult, DB_FILE, DEFAULT_HOST, EMOJI, EVENT_TYPES, type EventType, type FinishAgentInput, GROUP_DIRECTORY, GROUP_FILE, type Group, type GroupFile, type GroupReference, type HookEnv, type HookSessionPayload, type Host, type HostPromptPayload, type HostSessionPayload, type HostSubagentPayload, type InitOptions, LEGEND, type ListAgentsOptions, type ListSessionsOptions, type LocateOptions, type LogEventInput, MAIN_WORKING_EMOJI, MINIMUM_ID_PREFIX, type MergeResult, type OpenCarnetOptions, PUBLISH_FALLBACK_MILLISECONDS, REPORTING_NOTE, REPORTS_DIRECTORY, type ResumeCommand, type ResumeContextOptions, type Session, type SessionStartResult, type SessionStatus, type SetTableInput, type StartAgentInput, type StatusLine, type StatusView, type TableItem, USER_ACTION_STATUSES, type UpdateAgentInput, type UserActionStatus, allHosts, buildStatusView, findGroupRoot, formatClock, hostById, isAgentStatus, isEventType, isGroupRoot, isInside, isUserActionStatus, loadGroup, locateGroup, openCarnet, repoNameFor, repoPathFor, reportPathFor, reportsDirectoryOf, shortId };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/db/open.ts","../src/db/schema.ts","../src/errors.ts","../src/group/init.ts","../src/group/registry.ts","../src/hook/session-start.ts","../src/hook/user-prompt-submit.ts","../src/hosts/claude-code.ts","../src/purge.ts","../src/resume.ts","../src/subagents.ts","../src/status/note.ts","../src/status/render.ts"],"mappings":";;qBAGa;wBAEG,aAAa,eAAe;qBCH/B;wBA6EG,cAAc,IAAI;wBAKlB,QAAQ,IAAI;KCpFhB;qBAgBC,oBAAoB;WAEpB,MAAM;EADjB,YACW,MAAM,iBACf;;UCHa;EACf;EACA;EACA;EACA,MAAM,OAAO;;wBAcC,UAAU,mBAAmB,UAAS,cAAmB;wBAkBzD,aAAa,cAAc,eAAe;wBAa1C,gBAAgB,cAAc,eAAe;UC7D5C;EACf;EACA;;wBAOc,WAAW,MAAK,OAAO;wBAQvB,aAAa,MAAM,OAAO,aAAa;wBAmBvC,cACd,WAAW,gBACX,MAAM,OAAO,aACZ;wBAOa,iBAAiB,iBAAiB,MAAM,OAAO,aAAa;UC7C3D;EACf,SAAS;EACT;;wBAGc,mBACd,QAAQ,QACR,SAAS,oBACT,KAAK,UACJ;wBCVa,uBACd,QAAQ,QACR,MAAM,MACN,SAAS,oBACR;qBCgBU;qBACA;wBAeG,gBAAgB;wBAkBhB,WAAW,OAAO;wBAOlB,kBAAkB,iBAAiB,OAAO;wBAO1C,kBAAkB,OAAO;wBAiBzB,cAAc,OAAO;qBAmDxB,YAAY;qBC1IZ;wBAGG,UAAU;qBCAb;qBACA;UAEI;EACf;EACA;;wBAGc,gBAAgB,OAAO;wBAYvB,aAAa,SAAS;wBAKtB,cACd,QAAQ,QACR,SAAS,WACP,QAAwB,kBAAyC;qBC7BxD;qBACA;qBCLA;wBAWG,aAAa;qBCPhB;wBAEG,gBAAgB,MAAM;wBAKtB,gBAAgB,MAAM;wBAItB,eAAe,MAAM;wBAgBrB,aAAa,MAAM"}

package/dist/index.mjs

@@ -0,0 +1,71 @@
+import { $ as schemaVersion, A as repoNameFor, B as hostById, C as GROUP_FILE, D as isInside, E as isGroupRoot, F as registerGroup, G as groupSettings, H as REPOS_START, I as rucherHome, J as transcriptTitle, K as replaceReposBlock, L as unregisterGroups, M as reportPathFor, N as reportsDirectoryOf, O as loadGroup, P as readRegistry, Q as migrations, R as DEFAULT_HOST, S as GROUP_DIRECTORY, T as findGroupRoot, U as claudeCode, V as REPOS_END, W as groupInstructions, X as openDatabase, Y as MEMORY_DB, Z as migrate, _ as DEFAULT_PURGE_DAYS, a as sessionLabel, at as EMOJI, b as shortId, c as PAIRING_WINDOW_MILLISECONDS, d as formatClock, dt as isUserActionStatus, et as PUBLISH_FALLBACK_MILLISECONDS, f as MAIN_WORKING_SUFFIX, ft as EVENT_TYPES, g as renderTableLine, h as renderStatus, i as resumeContext, it as AGENT_STATUSES, j as repoPathFor, k as locateGroup, l as STOPPED_NOTE, lt as USER_ACTION_STATUSES, m as renderSections, mt as CarnetError, n as RESUME_MAX_CHARACTERS, nt as NOTE_MAX, o as Carnet, ot as LEGEND, p as renderAgentLine, pt as isEventType, q as reposBlock, r as formatEventLine, rt as sanitizeNote, s as openCarnet, st as MAIN_WORKING_EMOJI, t as RESUME_EVENTS, tt as REPORTING_NOTE, u as buildStatusView, ut as isAgentStatus, v as purgeDays, w as REPORTS_DIRECTORY, x as DB_FILE, y as MINIMUM_ID_PREFIX, z as allHosts } from "./resume-Daotqfdq.mjs";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { basename, join, resolve } from "node:path";
+// src/group/init.ts
+function writeGroupFile(root, file) {
+	writeFileSync(join(root, GROUP_DIRECTORY, GROUP_FILE), `${JSON.stringify(file, null, 2)}\n`);
+}
+function resolveRepo(root, repo) {
+	const path = resolve(root, repo);
+	if (!existsSync(path)) throw new CarnetError("REPO_NOT_FOUND", `Repo path does not exist: ${path}`);
+	return path;
+}
+function initGroup(directory, options = {}) {
+	const root = resolve(directory);
+	const groupDirectory = join(root, GROUP_DIRECTORY);
+	if (existsSync(groupDirectory)) throw new CarnetError("GROUP_EXISTS", `${root} is already a Rucher group`);
+	const name = options.name ?? basename(root);
+	const repos = (options.repos ?? []).map((repo) => resolveRepo(root, repo));
+	const hosts = (options.hosts?.length ? options.hosts : [DEFAULT_HOST]).map((id) => hostById(id).id);
+	mkdirSync(join(groupDirectory, REPORTS_DIRECTORY), { recursive: true });
+	writeGroupFile(root, {
+		name,
+		repos,
+		hosts
+	});
+	openDatabase(join(groupDirectory, DB_FILE)).close();
+	registerGroup({
+		name,
+		path: root
+	}, options.env);
+	return loadGroup(root);
+}
+function addGroupRepo(root, repo) {
+	const group = loadGroup(resolve(root));
+	const path = resolveRepo(group.root, repo);
+	if (!group.repos.includes(path)) writeGroupFile(group.root, {
+		name: group.name,
+		repos: [...group.repos, path],
+		hosts: group.hosts
+	});
+	return loadGroup(group.root);
+}
+function removeGroupRepo(root, repo) {
+	const group = loadGroup(resolve(root));
+	const path = resolve(group.root, repo);
+	if (!group.repos.includes(path)) throw new CarnetError("REPO_NOT_FOUND", `${path} is not a repo of ${group.name}`);
+	writeGroupFile(group.root, {
+		name: group.name,
+		repos: group.repos.filter((repo) => repo !== path),
+		hosts: group.hosts
+	});
+	return loadGroup(group.root);
+}
+// src/hook/session-start.ts
+function handleSessionStart(carnet, payload, env) {
+	const session = carnet.sessions.upsertFromHook(payload, env);
+	carnet.sessions.purge(session.id, purgeDays(env.RUCHER_PURGE_DAYS));
+	if (payload.source !== "resume") return { session };
+	return {
+		session,
+		additionalContext: resumeContext(carnet, session)
+	};
+}
+// src/hook/user-prompt-submit.ts
+function handleUserPromptSubmit(carnet, host, payload) {
+	carnet.sessions.ensure(payload.session_id, payload.cwd);
+	return carnet.sessions.adoptTitle(payload.session_id, host.promptTitle(payload));
+}
+export { AGENT_STATUSES, Carnet, CarnetError, DB_FILE, DEFAULT_HOST, DEFAULT_PURGE_DAYS, EMOJI, EVENT_TYPES, GROUP_DIRECTORY, GROUP_FILE, LEGEND, MAIN_WORKING_EMOJI, MAIN_WORKING_SUFFIX, MEMORY_DB, MINIMUM_ID_PREFIX, NOTE_MAX, PAIRING_WINDOW_MILLISECONDS, PUBLISH_FALLBACK_MILLISECONDS, REPORTING_NOTE, REPORTS_DIRECTORY, REPOS_END, REPOS_START, RESUME_EVENTS, RESUME_MAX_CHARACTERS, STOPPED_NOTE, USER_ACTION_STATUSES, addGroupRepo, allHosts, buildStatusView, claudeCode, findGroupRoot, formatClock, formatEventLine, groupInstructions, groupSettings, handleSessionStart, handleUserPromptSubmit, hostById, initGroup, isAgentStatus, isEventType, isGroupRoot, isInside, isUserActionStatus, loadGroup, locateGroup, migrate, migrations, openCarnet, openDatabase, purgeDays, readRegistry, registerGroup, removeGroupRepo, renderAgentLine, renderSections, renderStatus, renderTableLine, replaceReposBlock, repoNameFor, repoPathFor, reportPathFor, reportsDirectoryOf, reposBlock, resumeContext, rucherHome, sanitizeNote, schemaVersion, sessionLabel, shortId, transcriptTitle, unregisterGroups };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/group/init.ts","../src/hook/session-start.ts","../src/hook/user-prompt-submit.ts"],"sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from 'node:fs';\nimport { basename, join, resolve } from 'node:path';\nimport { CarnetError } from '../errors.ts';\nimport { openDatabase } from '../db/open.ts';\nimport { DEFAULT_HOST, hostById } from '../hosts/host.ts';\nimport {\n  DB_FILE,\n  GROUP_DIRECTORY,\n  GROUP_FILE,\n  REPORTS_DIRECTORY,\n  type Group,\n  type GroupFile,\n  loadGroup,\n} from './locate.ts';\nimport { registerGroup } from './registry.ts';\n\nexport interface InitOptions {\n  name?: string | undefined;\n  repos?: string[] | undefined;\n  hosts?: string[] | undefined;\n  env?: NodeJS.ProcessEnv | undefined;\n}\n\nfunction writeGroupFile(root: string, file: GroupFile): void {\n  writeFileSync(join(root, GROUP_DIRECTORY, GROUP_FILE), `${JSON.stringify(file, null, 2)}\\n`);\n}\n\nfunction resolveRepo(root: string, repo: string): string {\n  const path = resolve(root, repo);\n  if (!existsSync(path))\n    throw new CarnetError('REPO_NOT_FOUND', `Repo path does not exist: ${path}`);\n  return path;\n}\n\nexport function initGroup(directory: string, options: InitOptions = {}): Group {\n  const root = resolve(directory);\n  const groupDirectory = join(root, GROUP_DIRECTORY);\n  if (existsSync(groupDirectory)) {\n    throw new CarnetError('GROUP_EXISTS', `${root} is already a Rucher group`);\n  }\n  const name = options.name ?? basename(root);\n  const repos = (options.repos ?? []).map((repo) => resolveRepo(root, repo));\n  const hosts = (options.hosts?.length ? options.hosts : [DEFAULT_HOST]).map(\n    (id) => hostById(id).id,\n  );\n  mkdirSync(join(groupDirectory, REPORTS_DIRECTORY), { recursive: true });\n  writeGroupFile(root, { name, repos, hosts });\n  openDatabase(join(groupDirectory, DB_FILE)).close();\n  registerGroup({ name, path: root }, options.env);\n  return loadGroup(root);\n}\n\nexport function addGroupRepo(root: string, repo: string): Group {\n  const group = loadGroup(resolve(root));\n  const path = resolveRepo(group.root, repo);\n  if (!group.repos.includes(path)) {\n    writeGroupFile(group.root, {\n      name: group.name,\n      repos: [...group.repos, path],\n      hosts: group.hosts,\n    });\n  }\n  return loadGroup(group.root);\n}\n\nexport function removeGroupRepo(root: string, repo: string): Group {\n  const group = loadGroup(resolve(root));\n  const path = resolve(group.root, repo);\n  if (!group.repos.includes(path)) {\n    throw new CarnetError('REPO_NOT_FOUND', `${path} is not a repo of ${group.name}`);\n  }\n  writeGroupFile(group.root, {\n    name: group.name,\n    repos: group.repos.filter((repo) => repo !== path),\n    hosts: group.hosts,\n  });\n  return loadGroup(group.root);\n}\n","import type { Carnet } from '../carnet.ts';\nimport { purgeDays } from '../purge.ts';\nimport { resumeContext } from '../resume.ts';\nimport type { HookEnv, HookSessionPayload, Session } from '../sessions.ts';\n\nexport interface SessionStartResult {\n  session: Session;\n  additionalContext?: string;\n}\n\nexport function handleSessionStart(\n  carnet: Carnet,\n  payload: HookSessionPayload,\n  env: HookEnv,\n): SessionStartResult {\n  const session = carnet.sessions.upsertFromHook(payload, env);\n  carnet.sessions.purge(session.id, purgeDays(env.RUCHER_PURGE_DAYS));\n  if (payload.source !== 'resume') return { session };\n  return { session, additionalContext: resumeContext(carnet, session) };\n}\n","import type { Carnet } from '../carnet.ts';\nimport type { Host, HostPromptPayload } from '../hosts/host.ts';\nimport type { Session } from '../sessions.ts';\n\nexport function handleUserPromptSubmit(\n  carnet: Carnet,\n  host: Host,\n  payload: HostPromptPayload,\n): Session {\n  carnet.sessions.ensure(payload.session_id, payload.cwd);\n  return carnet.sessions.adoptTitle(payload.session_id, host.promptTitle(payload));\n}\n"],"mappings":";;;;AAuBA,SAAS,eAAe,MAAc,MAAuB;CAC3D,cAAc,KAAK,MAAM,iBAAiB,UAAU,GAAG,GAAG,KAAK,UAAU,MAAM,MAAM,CAAC,EAAE,GAAG;AAC7F;AAEA,SAAS,YAAY,MAAc,MAAsB;CACvD,MAAM,OAAO,QAAQ,MAAM,IAAI;CAC/B,IAAI,CAAC,WAAW,IAAI,GAClB,MAAM,IAAI,YAAY,kBAAkB,6BAA6B,MAAM;CAC7E,OAAO;AACT;AAEA,SAAgB,UAAU,WAAmB,UAAuB,CAAC,GAAU;CAC7E,MAAM,OAAO,QAAQ,SAAS;CAC9B,MAAM,iBAAiB,KAAK,MAAM,eAAe;CACjD,IAAI,WAAW,cAAc,GAC3B,MAAM,IAAI,YAAY,gBAAgB,GAAG,KAAK,2BAA2B;CAE3E,MAAM,OAAO,QAAQ,QAAQ,SAAS,IAAI;CAC1C,MAAM,SAAS,QAAQ,SAAS,CAAC,EAAA,CAAG,KAAK,SAAS,YAAY,MAAM,IAAI,CAAC;CACzE,MAAM,SAAS,QAAQ,OAAO,SAAS,QAAQ,QAAQ,CAAC,YAAY,EAAA,CAAG,KACpE,OAAO,SAAS,EAAE,CAAC,CAAC,EACvB;CACA,UAAU,KAAK,gBAAgB,iBAAiB,GAAG,EAAE,WAAW,KAAK,CAAC;CACtE,eAAe,MAAM;EAAE;EAAM;EAAO;CAAM,CAAC;CAC3C,aAAa,KAAK,gBAAgB,OAAO,CAAC,CAAC,CAAC,MAAM;CAClD,cAAc;EAAE;EAAM,MAAM;CAAK,GAAG,QAAQ,GAAG;CAC/C,OAAO,UAAU,IAAI;AACvB;AAEA,SAAgB,aAAa,MAAc,MAAqB;CAC9D,MAAM,QAAQ,UAAU,QAAQ,IAAI,CAAC;CACrC,MAAM,OAAO,YAAY,MAAM,MAAM,IAAI;CACzC,IAAI,CAAC,MAAM,MAAM,SAAS,IAAI,GAC5B,eAAe,MAAM,MAAM;EACzB,MAAM,MAAM;EACZ,OAAO,CAAC,GAAG,MAAM,OAAO,IAAI;EAC5B,OAAO,MAAM;CACf,CAAC;CAEH,OAAO,UAAU,MAAM,IAAI;AAC7B;AAEA,SAAgB,gBAAgB,MAAc,MAAqB;CACjE,MAAM,QAAQ,UAAU,QAAQ,IAAI,CAAC;CACrC,MAAM,OAAO,QAAQ,MAAM,MAAM,IAAI;CACrC,IAAI,CAAC,MAAM,MAAM,SAAS,IAAI,GAC5B,MAAM,IAAI,YAAY,kBAAkB,GAAG,KAAK,oBAAoB,MAAM,MAAM;CAElF,eAAe,MAAM,MAAM;EACzB,MAAM,MAAM;EACZ,OAAO,MAAM,MAAM,QAAQ,SAAS,SAAS,IAAI;EACjD,OAAO,MAAM;CACf,CAAC;CACD,OAAO,UAAU,MAAM,IAAI;AAC7B;;ACnEA,SAAgB,mBACd,QACA,SACA,KACoB;CACpB,MAAM,UAAU,OAAO,SAAS,eAAe,SAAS,GAAG;CAC3D,OAAO,SAAS,MAAM,QAAQ,IAAI,UAAU,IAAI,iBAAiB,CAAC;CAClE,IAAI,QAAQ,WAAW,UAAU,OAAO,EAAE,QAAQ;CAClD,OAAO;EAAE;EAAS,mBAAmB,cAAc,QAAQ,OAAO;CAAE;AACtE;;ACfA,SAAgB,uBACd,QACA,MACA,SACS;CACT,OAAO,SAAS,OAAO,QAAQ,YAAY,QAAQ,GAAG;CACtD,OAAO,OAAO,SAAS,WAAW,QAAQ,YAAY,KAAK,YAAY,OAAO,CAAC;AACjF"}

package/dist/mcp.d.mts

@@ -0,0 +1,40 @@
+import { D as Host, r as OpenCarnetOptions, t as Carnet } from "./carnet-CSdqWDas.mjs";
+import { McpServer } from "@modelcontextprotocol/server";
+import { StdioServerHandle } from "@modelcontextprotocol/server/stdio";
+import * as z from "zod/v4";
+export declare const INSTRUCTIONS = "Carnet tracks the status of sub-agents (forks) for the human, in a shared database. Views are rendered by the `rucher` CLI.\n\nRules:\n- Never write status files (agents-status.md or similar) and never describe status updates in the chat. When a fork finishes, the main agent says only \"<name> finished, report ready\".\n- Update BEFORE and AFTER each piece of work, never batched at the end of a turn.\n- Your session is resolved automatically. Pass `session` only to target another session.\n\nMain agent:\n- agent_start before dispatching a fork (name, task), in an earlier message than the launch; launch parallel forks in the same order. Names are short, no paths.\n- table_set with main_working=true before applying, testing or fixing yourself; table_set with a status (or table_clear) when done.\n- log_event when a step is answered, applied, tested, committed or dropped.\n- When a fork finishes: say one line \"<name> finished, report ready\", copy its report to the report destination agent_start gave (.rucher/reports/<name>.md in the group meta directory) and call agent_update with that report_path. Present the report only when asked.\n- For dispatching, applying or reviewing forks, load the rucher skill: it holds the full workflow.\n- agent_drop when a fork's work is committed or abandoned. queue_reorder to change the handling order.\n- agent_list to recall where things stand.\n- Sessions: session_new when the human names this session (then ask them to /rename it the same way); session_list, session_resume_info and log_read to recall other sessions or the journal; session_drop only when the human asks.\n\nForks:\n- agent_update (status running, short note) at meaningful progress.\n- agent_done with the report path as your LAST tool action; has_questions=true when the report asks the human something. Then reply with one line only: the report holds the detail.\n- Never agent_start, never table_set.\n\nStatuses (emoji shown to the human = the NEXT action): running ⏳ fork working · discussing 💬 · answer ❓ human must answer · review 👀 human must review · apply 📥 · test 🧪 · commit ✅ · branch 🌿. Only the human applies, tests and commits.\n\nNotes and table text: under 60 characters, no paths, no backticks.";
+interface SessionResolverOptions {
+  carnet: Carnet;
+  env?: NodeJS.ProcessEnv | undefined;
+  ppid?: number | undefined;
+  cwd?: string | undefined;
+  host?: Host | undefined;
+}
+interface SessionResolver {
+  resolve(override?: string): string;
+}
+export declare function createSessionResolver({ carnet, env, ppid, cwd, host }: SessionResolverOptions): SessionResolver;
+export declare const SERVER_NAME = "carnet";
+export declare const SERVER_VERSION = "0.0.0";
+interface CarnetServerOptions extends Omit<SessionResolverOptions, 'carnet'> {
+  carnet: Carnet | (() => Carnet);
+}
+export declare function createCarnetServer(options: CarnetServerOptions): McpServer;
+interface ServeCarnetOptions extends OpenCarnetOptions {
+  carnet?: Carnet;
+  ppid?: number;
+}
+export declare function serveCarnet(options?: ServeCarnetOptions): StdioServerHandle;
+interface ToolOutput {
+  text: string;
+  data?: Record<string, unknown>;
+}
+interface ToolDefinition<Schema extends z.ZodObject = z.ZodObject> {
+  name: string;
+  description: string;
+  schema: Schema;
+  run: (carnet: Carnet, sessionId: string, args: z.infer<Schema>) => ToolOutput;
+}
+export declare const TOOLS: readonly ToolDefinition[];
+export type { CarnetServerOptions, ServeCarnetOptions, SessionResolver, SessionResolverOptions, ToolDefinition, ToolOutput };
+//# sourceMappingURL=mcp.d.mts.map

package/dist/mcp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.mts","names":[],"sources":["../src/mcp/instructions.ts","../src/mcp/session.ts","../src/mcp/server.ts","../src/mcp/tools.ts"],"mappings":";;;;qBAAa;UCMI;EACf,QAAQ;EACR,MAAM,OAAO;EACb;EACA;EACA,OAAO;;UAGQ;EACf,QAAQ;;wBAGM,wBACd,QACA,KACA,MACA,KACA,QACC,yBAAyB;qBCXf;qBACA;UAEI,4BAA4B,KAAK;EAChD,QAAQ,gBAAgB;;wBAOV,mBAAmB,SAAS,sBAAsB;UAgCjD,2BAA2B;EAC1C,SAAS;EACT;;wBAGc,YAAY,UAAS,qBAA0B;UCnD9C;EACf;EACA,OAAO;;UAGQ,eAAe,eAAe,EAAE,YAAY,EAAE;EAC7D;EACA;EACA,QAAQ;EACR,MAAM,QAAQ,QAAQ,mBAAmB,MAAM,EAAE,MAAM,YAAY;;qBAoSxD,gBAAgB"}