ralph-research 0.1.2 → 0.1.3

package/dist/app/services/codex-cli-session-lifecycle-service.js

@@ -0,0 +1,186 @@
+import { ResearchSessionRecoveryService, } from "./research-session-recovery-service.js";
+export class CodexCliSessionLifecycleService {
+    recoveryService;
+    attachabilityValidator;
+    constructor(dependencies = {}) {
+        this.recoveryService =
+            dependencies.recoveryService ??
+                dependencies.createRecoveryService?.() ??
+                new ResearchSessionRecoveryService();
+        this.attachabilityValidator =
+            dependencies.attachabilityValidator ?? validateCodexCliSessionAttachability;
+    }
+    async inspectSession(input) {
+        const inspection = await this.recoveryService.inspectSession(input);
+        return materializeCodexCliSessionLifecycleInspection(inspection, this.attachabilityValidator(inspection));
+    }
+    async resolveCycleSession(input) {
+        const inspection = await this.recoveryService.inspectSession(input);
+        return resolveCodexCliSessionReuseOrReplaceDecision(inspection, this.attachabilityValidator(inspection));
+    }
+}
+export function classifyCodexCliSessionLifecycleInspection(inspection) {
+    return materializeCodexCliSessionLifecycleInspection(inspection, validateCodexCliSessionAttachability(inspection));
+}
+export function resolveCodexCliSessionReuseOrReplaceDecision(inspection, attachability = validateCodexCliSessionAttachability(inspection)) {
+    const result = materializeCodexCliSessionLifecycleInspection(inspection, attachability);
+    if (result.kind === "reusable_attachment_target") {
+        if (!inspection.codexSessionReference) {
+            throw new Error("Reusable Codex CLI attachments require a persisted Codex session reference");
+        }
+        return {
+            decision: "reuse",
+            session: result.session,
+            lifecycle: result.lifecycle,
+            recovery: result.recovery,
+            codexSessionReference: inspection.codexSessionReference,
+            reason: result.attachability.reason,
+            reuse: result.target,
+        };
+    }
+    return {
+        decision: "replace",
+        session: result.session,
+        lifecycle: result.lifecycle,
+        recovery: result.recovery,
+        codexSessionReference: inspection.codexSessionReference,
+        reason: result.attachability.reason,
+        replace: {
+            ...result.outcome,
+            attachabilityMode: result.attachability.mode,
+        },
+    };
+}
+function materializeCodexCliSessionLifecycleInspection(inspection, attachability) {
+    const reusableAttachmentFailure = getReusableAttachmentFailure(inspection);
+    if (attachability.mode === "attach" && isReusableAttachmentLifecycle(inspection)) {
+        return buildReusableAttachmentTarget(inspection, attachability);
+    }
+    const safeAttachability = attachability.mode === "attach"
+        ? deriveSafeStaleAttachability(inspection, reusableAttachmentFailure)
+        : attachability;
+    return buildStaleSessionOutcome(inspection, safeAttachability);
+}
+function buildReusableAttachmentTarget(inspection, attachability) {
+    return {
+        kind: "reusable_attachment_target",
+        session: inspection.session,
+        lifecycle: inspection.lifecycle,
+        recovery: inspection.recovery,
+        attachability,
+        target: {
+            researchSessionId: inspection.session.sessionId,
+            codexSessionId: inspection.lifecycle.identity.codexSessionId,
+            pid: inspection.lifecycle.pid,
+            phase: inspection.lifecycle.phase,
+            command: inspection.lifecycle.command,
+            args: [...inspection.lifecycle.args],
+            workingDirectory: inspection.lifecycle.workingDirectory,
+            attachmentStatus: "bound",
+            trackedGlobs: [...inspection.lifecycle.attachmentState.trackedGlobs],
+            extraWritableDirectories: [...inspection.lifecycle.attachmentState.extraWritableDirectories],
+            tty: { ...inspection.lifecycle.tty },
+            ...(inspection.lifecycle.references.workspaceRef
+                ? { workspaceRef: inspection.lifecycle.references.workspaceRef }
+                : {}),
+            ...(inspection.lifecycle.references.workspacePath
+                ? { workspacePath: inspection.lifecycle.references.workspacePath }
+                : {}),
+            ...(inspection.lifecycle.references.checkpointRunId
+                ? { checkpointRunId: inspection.lifecycle.references.checkpointRunId }
+                : {}),
+            ...(inspection.lifecycle.references.checkpointDecisionId
+                ? { checkpointDecisionId: inspection.lifecycle.references.checkpointDecisionId }
+                : {}),
+        },
+    };
+}
+function buildStaleSessionOutcome(inspection, attachability) {
+    return {
+        kind: "stale_session_outcome",
+        session: inspection.session,
+        lifecycle: inspection.lifecycle,
+        recovery: inspection.recovery,
+        attachability,
+        outcome: {
+            runtimeState: inspection.recovery.runtime.state,
+            completedCycles: inspection.session.progress.completedCycles,
+            resumeFromCycle: inspection.session.resume.resumeFromCycle,
+            resumable: inspection.recovery.resumeAllowed,
+            reason: inspection.recovery.reason,
+            ...(inspection.lifecycle ? { phase: inspection.lifecycle.phase } : {}),
+            ...(inspection.lifecycle ? { attachmentStatus: inspection.lifecycle.attachmentState.status } : {}),
+        },
+    };
+}
+function deriveSafeStaleAttachability(inspection, reusableAttachmentFailure) {
+    if (inspection.recovery.resumeAllowed) {
+        return {
+            mode: "resume",
+            attachable: false,
+            resumable: true,
+            reason: inspection.recovery.reason,
+        };
+    }
+    return {
+        mode: "inspect",
+        attachable: false,
+        resumable: false,
+        reason: reusableAttachmentFailure ??
+            "Codex CLI session looked attachable, but the persisted lifecycle evidence was incomplete",
+    };
+}
+export function validateCodexCliSessionAttachability(inspection) {
+    const reusableAttachmentFailure = getReusableAttachmentFailure(inspection);
+    if (!reusableAttachmentFailure) {
+        return {
+            mode: "attach",
+            attachable: true,
+            resumable: false,
+            reason: "Codex CLI session is still live and bound to the persisted working-directory attachment",
+        };
+    }
+    if (inspection.recovery.resumeAllowed) {
+        return {
+            mode: "resume",
+            attachable: false,
+            resumable: true,
+            reason: inspection.recovery.reason,
+        };
+    }
+    return {
+        mode: "inspect",
+        attachable: false,
+        resumable: false,
+        reason: reusableAttachmentFailure ?? inspection.recovery.reason,
+    };
+}
+function getReusableAttachmentFailure(inspection) {
+    const lifecycle = inspection.lifecycle;
+    if (!lifecycle) {
+        return inspection.recovery.reason;
+    }
+    if (!inspection.codexSessionReference) {
+        return "Persisted Codex session reference is missing";
+    }
+    if (inspection.codexSessionReference.codexSessionId !== lifecycle.identity.codexSessionId) {
+        return "Persisted Codex session reference does not match the lifecycle codex session id";
+    }
+    if (!inspection.recovery.runtime.processAlive || inspection.recovery.runtime.state !== "active") {
+        return inspection.recovery.reason;
+    }
+    if (lifecycle.phase !== "starting" && lifecycle.phase !== "running") {
+        return `Codex CLI process is live, but lifecycle phase ${lifecycle.phase} cannot accept attachment`;
+    }
+    if (lifecycle.pid === undefined) {
+        return "Codex CLI process is live, but the persisted lifecycle is missing the process id required for attachment";
+    }
+    if (lifecycle.attachmentState.status !== "bound") {
+        return `Codex CLI process is live, but attachmentState.status is ${lifecycle.attachmentState.status} instead of bound`;
+    }
+    return null;
+}
+function isReusableAttachmentLifecycle(inspection) {
+    return getReusableAttachmentFailure(inspection) === null;
+}
+//# sourceMappingURL=codex-cli-session-lifecycle-service.js.map

package/dist/app/services/codex-cli-session-lifecycle-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-cli-session-lifecycle-service.js","sourceRoot":"","sources":["../../../src/app/services/codex-cli-session-lifecycle-service.ts"],"names":[],"mappings":"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"}

package/dist/app/services/research-project-defaults-service.d.ts

@@ -0,0 +1,18 @@
+import { type ResearchProjectDefaultsRecord } from "../../core/model/research-project-defaults.js";
+import type { ResearchSessionRecord } from "../../core/model/research-session.js";
+import type { ResearchProjectDefaultsStore } from "../../core/ports/research-project-defaults-store.js";
+export interface ResearchProjectDefaultsServiceDependencies {
+    now?: () => Date;
+    createStore?: (filePath: string) => ResearchProjectDefaultsStore;
+}
+export declare class ResearchProjectDefaultsService {
+    private readonly now;
+    private readonly createStore;
+    constructor(dependencies?: ResearchProjectDefaultsServiceDependencies);
+    loadForRepo(repoRoot: string): Promise<ResearchProjectDefaultsRecord | null>;
+    saveForSession(input: {
+        repoRoot: string;
+        session: ResearchSessionRecord;
+    }): Promise<ResearchProjectDefaultsRecord>;
+    private resolveStore;
+}

package/dist/app/services/research-project-defaults-service.js

@@ -0,0 +1,175 @@
+import { realpath, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { JsonFileResearchProjectDefaultsStore } from "../../adapters/fs/json-file-research-project-defaults-store.js";
+import { DEFAULT_PROJECT_BASELINE_REF, DEFAULT_RESEARCH_PROJECT_DEFAULTS_FILE, DEFAULT_STORAGE_ROOT, } from "../../core/manifest/defaults.js";
+import { researchProjectDefaultsRecordSchema, } from "../../core/model/research-project-defaults.js";
+export class ResearchProjectDefaultsService {
+    now;
+    createStore;
+    constructor(dependencies = {}) {
+        this.now = dependencies.now ?? (() => new Date());
+        this.createStore =
+            dependencies.createStore ?? ((filePath) => new JsonFileResearchProjectDefaultsStore(filePath));
+    }
+    async loadForRepo(repoRoot) {
+        const { store } = await this.resolveStore(repoRoot);
+        return store.load();
+    }
+    async saveForSession(input) {
+        const { store } = await this.resolveStore(input.repoRoot);
+        const existing = await store.load();
+        const timestamp = this.now().toISOString();
+        const contract = deriveProjectDefaultsContract(input.session);
+        const record = researchProjectDefaultsRecordSchema.parse({
+            recordType: "research_project_defaults",
+            version: 1,
+            ...contract,
+            createdAt: existing?.createdAt ?? timestamp,
+            updatedAt: timestamp,
+        });
+        await store.save(record);
+        return record;
+    }
+    async resolveStore(repoRoot) {
+        const resolvedRoot = resolve(repoRoot);
+        const repoStats = await stat(resolvedRoot).catch(() => null);
+        if (!repoStats?.isDirectory()) {
+            throw new Error(`Working directory is not a directory: ${resolvedRoot}`);
+        }
+        const canonicalRepoRoot = await realpath(resolvedRoot);
+        const defaultsPath = join(canonicalRepoRoot, DEFAULT_STORAGE_ROOT, DEFAULT_RESEARCH_PROJECT_DEFAULTS_FILE);
+        return {
+            canonicalRepoRoot,
+            store: this.createStore(defaultsPath),
+        };
+    }
+}
+function deriveProjectDefaultsContract(session) {
+    const permissions = session.draftState?.flowState?.permissions;
+    const stopRules = session.draftState?.flowState?.stopRules;
+    const outputs = session.draftState?.flowState?.outputs;
+    const contextStep = session.draftState?.contextStep;
+    const workspaceStep = session.draftState?.workspaceStep;
+    const goalStep = session.draftState?.goalStep;
+    const agentStep = session.draftState?.agentStep;
+    const resolvedModel = resolveOptionalString(outputs?.model ?? agentStep?.model ?? session.agent.model);
+    return {
+        workingDirectory: resolveRequiredString(permissions?.workingDirectory ?? workspaceStep?.workingDirectory, session.workingDirectory, "Working directory"),
+        context: {
+            trackableGlobs: resolveStringList(outputs?.trackableGlobs ?? contextStep?.trackableGlobs, session.context.trackableGlobs, "Trackable files"),
+            webSearch: resolveWebSearchChoice(permissions?.webSearch ?? contextStep?.webSearch, session.context.webSearch),
+            shellCommandAllowlistAdditions: resolveStringList(permissions?.shellCommandAllowlistAdditions ??
+                contextStep?.shellCommandAllowlistAdditions, session.context.shellCommandAllowlistAdditions, "Shell allowlist additions", { allowEmpty: true }),
+            shellCommandAllowlistRemovals: resolveStringList(permissions?.shellCommandAllowlistRemovals ??
+                contextStep?.shellCommandAllowlistRemovals, session.context.shellCommandAllowlistRemovals, "Shell allowlist removals", { allowEmpty: true }),
+        },
+        workspace: {
+            strategy: "git_worktree",
+            baseRef: resolveRequiredString(outputs?.baseRef ?? workspaceStep?.baseRef, session.workspace.baseRef ?? DEFAULT_PROJECT_BASELINE_REF, "Baseline ref"),
+        },
+        agent: {
+            type: session.agent.type,
+            command: resolveRequiredString(outputs?.agentCommand ?? goalStep?.agentCommand ?? agentStep?.command, session.agent.command, "Agent command"),
+            ...(resolvedModel ? { model: resolvedModel } : {}),
+            approvalPolicy: resolveAgentApprovalPolicy(permissions?.approvalPolicy ?? agentStep?.approvalPolicy, session.agent.approvalPolicy),
+            sandboxMode: resolveAgentSandboxMode(permissions?.sandboxMode ?? agentStep?.sandboxMode, session.agent.sandboxMode),
+            ttySession: {
+                startupTimeoutSec: resolvePositiveInteger(outputs?.startupTimeoutSec ?? agentStep?.startupTimeoutSec, session.agent.ttySession.startupTimeoutSec, "Agent startup timeout"),
+                turnTimeoutSec: resolvePositiveInteger(outputs?.turnTimeoutSec ?? agentStep?.turnTimeoutSec, session.agent.ttySession.turnTimeoutSec, "Agent turn timeout"),
+            },
+        },
+        stopPolicy: {
+            repeatedFailures: resolvePositiveInteger(stopRules?.repeatedFailures ?? goalStep?.repeatedFailures, session.stopPolicy.repeatedFailures, "Repeated failures threshold"),
+            noMeaningfulProgress: resolvePositiveInteger(stopRules?.noMeaningfulProgress ?? goalStep?.noMeaningfulProgress, session.stopPolicy.noMeaningfulProgress, "No-progress threshold"),
+            insufficientEvidence: resolvePositiveInteger(stopRules?.insufficientEvidence ?? goalStep?.insufficientEvidence, session.stopPolicy.insufficientEvidence, "Insufficient-evidence threshold"),
+        },
+    };
+}
+function resolveRequiredString(draftValue, fallbackValue, label) {
+    const normalized = draftValue?.trim() ?? "";
+    if (normalized) {
+        return normalized;
+    }
+    const fallback = fallbackValue.trim();
+    if (!fallback) {
+        throw new Error(`${label} is required`);
+    }
+    return fallback;
+}
+function resolveOptionalString(value) {
+    const normalized = value?.trim() ?? "";
+    return normalized ? normalized : undefined;
+}
+function resolveStringList(draftValue, fallback, label, options = {}) {
+    if (draftValue === undefined) {
+        return [...fallback];
+    }
+    const values = draftValue
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter((entry) => entry.length > 0);
+    if (values.length === 0) {
+        if (options.allowEmpty) {
+            return [];
+        }
+        return [...fallback];
+    }
+    return values;
+}
+function resolveWebSearchChoice(draftValue, fallback) {
+    if (draftValue === undefined) {
+        return fallback;
+    }
+    const normalized = draftValue.trim().toLowerCase();
+    if (normalized === "enabled") {
+        return true;
+    }
+    if (normalized === "disabled") {
+        return false;
+    }
+    return fallback;
+}
+function resolvePositiveInteger(draftValue, fallback, label) {
+    if (draftValue === undefined) {
+        return fallback;
+    }
+    const normalized = draftValue.trim();
+    if (!/^\d+$/.test(normalized)) {
+        return fallback;
+    }
+    const value = Number.parseInt(normalized, 10);
+    if (value < 1) {
+        return fallback;
+    }
+    return value;
+}
+function resolveAgentApprovalPolicy(draftValue, fallback) {
+    if (draftValue === undefined) {
+        return fallback;
+    }
+    const normalized = draftValue.trim();
+    switch (normalized) {
+        case "never":
+        case "on-failure":
+        case "on-request":
+        case "untrusted":
+            return normalized;
+        default:
+            return fallback;
+    }
+}
+function resolveAgentSandboxMode(draftValue, fallback) {
+    if (draftValue === undefined) {
+        return fallback;
+    }
+    const normalized = draftValue.trim();
+    switch (normalized) {
+        case "read-only":
+        case "workspace-write":
+        case "danger-full-access":
+            return normalized;
+        default:
+            return fallback;
+    }
+}
+//# sourceMappingURL=research-project-defaults-service.js.map

package/dist/app/services/research-project-defaults-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-project-defaults-service.js","sourceRoot":"","sources":["../../../src/app/services/research-project-defaults-service.ts"],"names":[],"mappings":"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"}

package/dist/app/services/research-session-draft-service.d.ts

@@ -0,0 +1,121 @@
+import type { ResearchSessionRepository } from "../../core/ports/research-session-repository.js";
+import { ResearchProjectDefaultsService } from "./research-project-defaults-service.js";
+export type ResearchSessionDraftStep = "permissions" | "stopRules" | "outputs" | "review";
+export interface ResearchSessionDraft {
+    sessionId: string;
+    currentStep: ResearchSessionDraftStep;
+    completedSteps: ResearchSessionDraftStep[];
+    returnToReview: boolean;
+    reviewConfirmed: boolean;
+    goal: string;
+    repoRoot: string;
+    workingDirectory: string;
+    contextSettings: {
+        trackableGlobs: string;
+        webSearch: string;
+        shellCommandAllowlistAdditions: string;
+        shellCommandAllowlistRemovals: string;
+    };
+    workspaceSettings: {
+        baseRef: string;
+    };
+    agentCommand: string;
+    stopPolicy: {
+        repeatedFailures: string;
+        noMeaningfulProgress: string;
+        insufficientEvidence: string;
+    };
+    agentSettings: {
+        model: string;
+        approvalPolicy: string;
+        sandboxMode: string;
+        startupTimeoutSec: string;
+        turnTimeoutSec: string;
+    };
+    reviewState: ResearchSessionReviewState;
+}
+export type ResearchSessionDraftValidationField = "goal" | "repeatedFailures" | "noMeaningfulProgress" | "insufficientEvidence" | "trackableGlobs" | "webSearch" | "shellCommandAllowlistAdditions" | "shellCommandAllowlistRemovals" | "workingDirectory" | "baseRef" | "agentCommand" | "approvalPolicy" | "sandboxMode" | "startupTimeoutSec" | "turnTimeoutSec";
+export interface ResearchSessionDraftValidationResult {
+    isValid: boolean;
+    fieldErrors: Partial<Record<ResearchSessionDraftValidationField, string>>;
+}
+export interface ResearchSessionReviewSummaryField {
+    label: string;
+    value: string;
+}
+export interface ResearchSessionReviewStateSection {
+    index: string;
+    label: string;
+    step: Exclude<ResearchSessionDraftStep, "review">;
+    fields: ResearchSessionReviewSummaryField[];
+}
+export interface ResearchSessionReviewState {
+    sections: ResearchSessionReviewStateSection[];
+}
+export interface ResearchSessionReviewSummarySection extends ResearchSessionReviewStateSection {
+    validation: ResearchSessionDraftValidationResult;
+}
+export interface ResearchSessionDraftUpdate {
+    currentStep?: ResearchSessionDraftStep;
+    completedSteps?: ResearchSessionDraftStep[];
+    returnToReview?: boolean;
+    reviewConfirmed?: boolean;
+    goal?: string;
+    workingDirectory?: string;
+    agentCommand?: string;
+    contextSettings?: Partial<ResearchSessionDraft["contextSettings"]>;
+    workspaceSettings?: Partial<ResearchSessionDraft["workspaceSettings"]>;
+    stopPolicy?: Partial<ResearchSessionDraft["stopPolicy"]>;
+    agentSettings?: Partial<ResearchSessionDraft["agentSettings"]>;
+}
+export interface ResearchSessionDraftServiceDependencies {
+    now?: () => Date;
+    createRepository?: (sessionsRoot: string) => ResearchSessionRepository;
+    projectDefaultsService?: Pick<ResearchProjectDefaultsService, "saveForSession">;
+    createProjectDefaultsService?: () => Pick<ResearchProjectDefaultsService, "saveForSession">;
+}
+export interface ResearchSessionReviewStateInput {
+    workingDirectory: string;
+    webSearch: string;
+    shellCommandAllowlistAdditions: string;
+    shellCommandAllowlistRemovals: string;
+    approvalPolicy: string;
+    sandboxMode: string;
+    repeatedFailures: string;
+    noMeaningfulProgress: string;
+    insufficientEvidence: string;
+    goal: string;
+    trackableGlobs: string;
+    baseRef: string;
+    agentCommand: string;
+    model: string;
+    startupTimeoutSec: string;
+    turnTimeoutSec: string;
+}
+export declare class ResearchSessionDraftService {
+    private readonly now;
+    private readonly createRepository;
+    private readonly projectDefaultsService;
+    constructor(dependencies?: ResearchSessionDraftServiceDependencies);
+    loadDraft(input: {
+        repoRoot: string;
+        sessionId: string;
+    }): Promise<ResearchSessionDraft>;
+    updateDraft(input: {
+        repoRoot: string;
+        sessionId: string;
+        patch: ResearchSessionDraftUpdate;
+    }): Promise<ResearchSessionDraft>;
+    private resolveRepository;
+}
+export declare function validateGoalStepDraft(draft: ResearchSessionDraft): ResearchSessionDraftValidationResult;
+export declare function validateContextStepDraft(draft: ResearchSessionDraft): ResearchSessionDraftValidationResult;
+export declare function validateWorkspaceStepDraft(draft: ResearchSessionDraft): ResearchSessionDraftValidationResult;
+export declare function validateAgentStepDraft(draft: ResearchSessionDraft): ResearchSessionDraftValidationResult;
+export declare function validatePermissionsStepDraft(draft: ResearchSessionDraft): ResearchSessionDraftValidationResult;
+export declare function validateStopRulesStepDraft(draft: ResearchSessionDraft): ResearchSessionDraftValidationResult;
+export declare function validateOutputsStepDraft(draft: ResearchSessionDraft): ResearchSessionDraftValidationResult;
+export declare function validateReviewStepDraft(draft: ResearchSessionDraft): ResearchSessionDraftValidationResult;
+export declare function buildResearchSessionReviewSummary(draft: ResearchSessionDraft): ResearchSessionReviewSummarySection[];
+export declare function buildResearchSessionReviewState(draft: Pick<ResearchSessionDraft, "workingDirectory" | "contextSettings" | "agentSettings" | "stopPolicy" | "goal" | "workspaceSettings" | "agentCommand">): ResearchSessionReviewState;
+export declare function buildResearchSessionReviewStateFromValues(input: ResearchSessionReviewStateInput): ResearchSessionReviewState;