@veewo/claw-core 0.2.3 → 0.2.4

package/dist/src/errors.d.ts

@@ -1,4 +1,4 @@
-export type ClawErrorCode = "PROJECT_ROOT_NOT_FOUND" | "CLAW_DIR_NOT_FOUND" | "PROJECT_ALREADY_INITIALIZED" | "PROJECT_CONFIG_INVALID" | "TASK_NOT_FOUND" | "TASK_NAME_INVALID" | "ACTIVE_PLAN_INVALID" | "ACTIVE_PLAN_MISSING" | "PLAN_NOT_FOUND" | "PLAN_ALREADY_EXISTS" | "PLAN_STATUS_INVALID" | "PLAN_STATUS_NOT_SETTABLE" | "PLAN_STATUS_TRANSITION_FORBIDDEN" | "PLAN_STATUS_REOPEN_REQUIRED" | "TASK_STATUS_FORBIDDEN_IN_NON_ACTIVE_PLAN" | "PLAN_WRITE_CONFLICT" | "PLAN_STALE_EDIT" | "RETROSPECTIVE_REQUIRED" | "MEMORY_QUERY_REQUIRED" | "MEMORY_DISABLED" | "MEMORY_STORE_BUSY" | "MEMORY_VECTOR_INDEX_REQUIRED" | "GITNEXUS_REFRESH_FAILED" | "TRUTH_TARGET_INVALID" | "INPUT_REQUIRED";
+export type ClawErrorCode = "PROJECT_ROOT_NOT_FOUND" | "CLAW_DIR_NOT_FOUND" | "PROJECT_ALREADY_INITIALIZED" | "PROJECT_CONFIG_INVALID" | "TASK_NOT_FOUND" | "TASK_NAME_INVALID" | "ACTIVE_PLAN_INVALID" | "ACTIVE_PLAN_MISSING" | "PLAN_NOT_FOUND" | "PLAN_ALREADY_EXISTS" | "PLAN_STATUS_INVALID" | "PLAN_STATUS_NOT_SETTABLE" | "PLAN_STATUS_TRANSITION_FORBIDDEN" | "PLAN_STATUS_REOPEN_REQUIRED" | "TASK_STATUS_FORBIDDEN_IN_NON_ACTIVE_PLAN" | "PLAN_WRITE_CONFLICT" | "PLAN_STALE_EDIT" | "CURRENT_PLAN_REQUIRED" | "PLAN_NOT_RESUMABLE" | "PLAN_FOCUS_CONFLICT" | "PLAN_TRANSITION_CONFLICT" | "FOCUS_RECOVERY_CONFLICT" | "SESSION_IDENTITY_INVALID" | "SESSION_NOT_FOUND" | "SESSION_EXPIRED" | "SESSION_PROTOCOL_UNSUPPORTED" | "SESSION_COMMAND_FAILED" | "SESSION_OPERATION_UNSUPPORTED" | "RETROSPECTIVE_REQUIRED" | "MEMORY_QUERY_REQUIRED" | "MEMORY_DISABLED" | "MEMORY_STORE_BUSY" | "MEMORY_VECTOR_INDEX_REQUIRED" | "GITNEXUS_REFRESH_FAILED" | "TRUTH_TARGET_INVALID" | "INPUT_REQUIRED";
 export declare class ClawError extends Error {
     readonly code: ClawErrorCode;
     readonly details: Record<string, unknown> | undefined;

package/dist/src/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AA2BA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAgB;IACpB,OAAO,CAAsC;IAEtD,YAAY,IAAmB,EAAE,OAAe,EAAE,OAAiC;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAsCA,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAgB;IACpB,OAAO,CAAsC;IAEtD,YAAY,IAAmB,EAAE,OAAe,EAAE,OAAiC;QACjF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/src/focus-transitions.d.ts

@@ -0,0 +1,158 @@
+import type { PlanDocument, PlanLeaveReason, ProjectContext } from "./types.js";
+export type PlanRef = {
+    projectRoot: string;
+    taskName: string;
+    planFile: string;
+};
+export type PlanFocusOwner = {
+    sessionKeyHash: string;
+    planRef: PlanRef;
+    acquiredAt: string;
+    updatedAt: string;
+};
+export type PlanFocusRegistry = {
+    schemaVersion: 1;
+    owners: Record<string, PlanFocusOwner>;
+};
+export type FocusSessionRecord = {
+    schemaVersion: 1;
+    sessionKeyHash: string;
+    currentPlan?: PlanRef;
+    updatedAt: string;
+};
+export interface FocusSessionStore {
+    read(sessionKeyHash: string): FocusSessionRecord;
+    buildPersistedRecord(sessionKeyHash: string, record: FocusSessionRecord): unknown;
+    writePersistedAtomic(sessionKeyHash: string, persistedRecord: unknown): void;
+    queuePath(sessionKeyHash: string): string;
+    resourcePath(sessionKeyHash: string): string;
+}
+export type FocusTransitionKind = "create" | "resume" | "leave" | "end" | "expire" | "subplan_create" | "subplan_complete";
+export type FocusTransitionJournal = {
+    schemaVersion: 1;
+    transitionId: string;
+    kind: FocusTransitionKind;
+    sessionKeyHash: string;
+    phase: "prepared" | "applying" | "committed";
+    createdAt: string;
+    updatedAt: string;
+    before: {
+        sessionRecordHash: string;
+        ownerRegistryHash: string;
+        sessionCurrentPlan?: PlanRef;
+        plans: Array<{
+            ref: PlanRef;
+            contentHash: string;
+        }>;
+    };
+    after: {
+        sessionRecord: unknown;
+        ownerRegistry: PlanFocusRegistry;
+        sessionCurrentPlan?: PlanRef;
+        plans: Array<{
+            ref: PlanRef;
+            content: PlanDocument;
+        }>;
+    };
+};
+export type FocusTransitionResult = {
+    changed: boolean;
+    transitionId?: string;
+    previousCurrentPlan?: PlanRef;
+    currentPlan?: PlanRef;
+    enteredEndPlans: Array<{
+        ref: PlanRef;
+        plan: PlanDocument;
+        endedAt: string;
+    }>;
+};
+export type FocusFailurePoint = "after_prepared" | "after_applying" | "after_plan" | "after_owners" | "after_session" | "after_committed";
+export type FocusTransitionTestHooks = {
+    failAt?: FocusFailurePoint;
+    failAfterPlanWrites?: number;
+};
+export declare class ProjectFocusSessionStore implements FocusSessionStore {
+    readonly project: ProjectContext;
+    constructor(project: ProjectContext);
+    read(sessionKeyHash: string): FocusSessionRecord;
+    buildPersistedRecord(sessionKeyHash: string, record: FocusSessionRecord): unknown;
+    writePersistedAtomic(sessionKeyHash: string, persistedRecord: unknown): void;
+    queuePath(sessionKeyHash: string): string;
+    resourcePath(sessionKeyHash: string): string;
+}
+export declare function createPlanRef(project: ProjectContext, taskName: string, planFile?: string): PlanRef;
+export declare function focusSessionKeyHash(sessionKey: string): string;
+export declare function focusTransitionsDirectory(project: ProjectContext): string;
+export declare function focusQueuePath(project: ProjectContext): string;
+export declare function focusOwnersPath(project: ProjectContext): string;
+export declare function readFocusedPlan(project: ProjectContext, sessionKey: string, sessionStore?: FocusSessionStore): PlanRef | undefined;
+export declare function readPlanFocusOwner(project: ProjectContext, ref: PlanRef): PlanFocusOwner | undefined;
+export declare function leaveCurrentPlan(input: {
+    project: ProjectContext;
+    sessionKey: string;
+    reason?: PlanLeaveReason;
+    sessionStore?: FocusSessionStore;
+    testHooks?: FocusTransitionTestHooks;
+}): Promise<FocusTransitionResult>;
+export declare function releaseCurrentPlanFocus(input: {
+    project: ProjectContext;
+    sessionKey: string;
+    expectedEnd?: boolean;
+    kind?: "end" | "expire";
+    sessionStore?: FocusSessionStore;
+    testHooks?: FocusTransitionTestHooks;
+}): Promise<FocusTransitionResult>;
+export declare function activatePlan(input: {
+    project: ProjectContext;
+    sessionKey: string;
+    target?: PlanRef;
+    sessionStore?: FocusSessionStore;
+    testHooks?: FocusTransitionTestHooks;
+}): Promise<FocusTransitionResult>;
+export declare function switchCurrentPlan(input: {
+    project: ProjectContext;
+    sessionKey: string;
+    target: PlanRef;
+    kind?: FocusTransitionKind;
+    additionalPlanUpdates?: Array<{
+        ref: PlanRef;
+        content: PlanDocument;
+    }>;
+    preserveTargetStatus?: boolean;
+    preserveCurrentEndState?: boolean;
+    sessionStore?: FocusSessionStore;
+    testHooks?: FocusTransitionTestHooks;
+}): Promise<FocusTransitionResult>;
+export declare function createPlanAndSwitchFocus(input: {
+    project: ProjectContext;
+    sessionKey: string;
+    createdPlan: PlanRef;
+    sessionStore?: FocusSessionStore;
+    testHooks?: FocusTransitionTestHooks;
+}): Promise<FocusTransitionResult>;
+export declare function createSubplanAndSwitchFocus(input: {
+    project: ProjectContext;
+    sessionKey: string;
+    parentPlan: PlanRef;
+    parentAfterLink: PlanDocument;
+    childPlan: PlanRef;
+    sessionStore?: FocusSessionStore;
+    testHooks?: FocusTransitionTestHooks;
+}): Promise<FocusTransitionResult>;
+export declare function completeSubplanAndRestoreParent(input: {
+    project: ProjectContext;
+    sessionKey: string;
+    childPlan: PlanRef;
+    completedChild: PlanDocument;
+    parentPlan: PlanRef;
+    parentTaskId: number;
+    sessionStore?: FocusSessionStore;
+    testHooks?: FocusTransitionTestHooks;
+}): Promise<FocusTransitionResult>;
+export declare function recoverProjectFocusTransitions(input: {
+    project: ProjectContext;
+    sessionStore?: FocusSessionStore;
+}): Promise<{
+    recovered: string[];
+    discarded: string[];
+}>;