ralph-research 0.1.2 → 0.1.4

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;