rivet-design 0.26.2 → 0.27.1

package/dist/agent-variants/existingStaticEntry.d.ts

@@ -0,0 +1,34 @@
+import type { WorktreeRecord } from './WorkspaceInventory';
+import type { ProjectEnvironment, WorktreeManagerLike } from './variant-project-runtime';
+import { type VariantsTelemetry } from './variantsTelemetry';
+export type ExistingStaticEntrySource = 'configured' | 'root_page' | 'changed_page';
+export type ExistingStaticEntry = {
+    kind: 'found';
+    entryPath: string;
+    source: ExistingStaticEntrySource;
+} | {
+    kind: 'missing';
+    detail: string;
+    source: 'configured' | 'none';
+};
+export type ExistingStaticPreviewEntry = {
+    kind: 'unresolved';
+} | (ExistingStaticEntry & {
+    hostProjectPath: string;
+    projectDirectory: string;
+    startedAt: number;
+});
+export declare const resolveExistingStaticEntry: (args: {
+    worktreePath: string;
+    projectDirectory: string;
+    configuredEntryPath: string | undefined;
+    changedFiles: string[];
+}) => Promise<ExistingStaticEntry>;
+export declare const resolveExistingStaticPreviewEntry: (args: {
+    sessionId: string;
+    record: WorktreeRecord;
+    resolveEnv: (sessionId: string) => Promise<ProjectEnvironment>;
+    worktrees: WorktreeManagerLike;
+    telemetry: VariantsTelemetry;
+}) => Promise<ExistingStaticPreviewEntry | undefined>;
+//# sourceMappingURL=existingStaticEntry.d.ts.map

package/dist/agent-variants/existingStaticEntry.js

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveExistingStaticPreviewEntry = exports.resolveExistingStaticEntry = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const staticProjectTarget_1 = require("../services/staticProjectTarget");
+const pathContainment_1 = require("../utils/pathContainment");
+const logger_1 = require("../utils/logger");
+const variantsTelemetry_1 = require("./variantsTelemetry");
+const log = (0, logger_1.createLogger)('ExistingStaticEntry');
+const INDEX_PAGE = 'index.html';
+const MISSING_PAGE_DETAIL = "This project has no index.html or package.json at its root, and this direction didn't add or change an HTML page. " +
+    "Run rivet open on the folder that contains your app's package.json or index.html, or pass --entry <page.html>.";
+const missingConfiguredEntryDetail = (entryPath) => `${entryPath} isn't in this direction's copy of the project. Directions start from committed and untracked files; ` +
+    `git-ignored files are left out. Commit ${entryPath} or remove it from .gitignore, then generate the direction again.`;
+const isPageInsideWorktree = async (worktreePath, pagePath) => {
+    const realPage = await (0, pathContainment_1.resolveRealPathWithinRoot)({
+        root: worktreePath,
+        candidate: pagePath,
+        containment: 'strict',
+    });
+    if (!realPage)
+        return false;
+    try {
+        await fs_1.default.promises.access(realPage, fs_1.default.constants.R_OK);
+        return (await fs_1.default.promises.stat(realPage)).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+const pageDepth = (pagePath) => pagePath.split('/').length;
+const isIndexPage = (pagePath) => path_1.default.posix.basename(pagePath).toLowerCase() === INDEX_PAGE;
+const comparePreviewPages = (left, right) => pageDepth(left) - pageDepth(right) ||
+    Number(isIndexPage(right)) - Number(isIndexPage(left)) ||
+    left.localeCompare(right);
+const findRootPage = (projectDirectory) => {
+    try {
+        return (0, staticProjectTarget_1.resolveStaticProjectTarget)({ targetPath: projectDirectory })
+            .entryPath;
+    }
+    catch {
+        return undefined;
+    }
+};
+const toProjectPagePaths = (args) => args.changedFiles
+    .map((changedFile) => path_1.default.join(args.worktreePath, changedFile))
+    .filter((changedPath) => (0, pathContainment_1.isPathStrictlyInsideRoot)(args.projectDirectory, changedPath) &&
+    (0, staticProjectTarget_1.isStaticHtmlFilePath)(changedPath))
+    .map((changedPath) => path_1.default
+    .relative(args.projectDirectory, changedPath)
+    .split(path_1.default.sep)
+    .join('/'))
+    .sort(comparePreviewPages);
+const resolveExistingStaticEntry = async (args) => {
+    const isProjectPage = (entryPath) => isPageInsideWorktree(args.worktreePath, path_1.default.join(args.projectDirectory, entryPath));
+    if (args.configuredEntryPath) {
+        return (await isProjectPage(args.configuredEntryPath))
+            ? {
+                kind: 'found',
+                entryPath: args.configuredEntryPath,
+                source: 'configured',
+            }
+            : {
+                kind: 'missing',
+                detail: missingConfiguredEntryDetail(args.configuredEntryPath),
+                source: 'configured',
+            };
+    }
+    const rootPage = findRootPage(args.projectDirectory);
+    if (rootPage && (await isProjectPage(rootPage))) {
+        return { kind: 'found', entryPath: rootPage, source: 'root_page' };
+    }
+    for (const changedPage of toProjectPagePaths(args)) {
+        if (await isProjectPage(changedPage)) {
+            return { kind: 'found', entryPath: changedPage, source: 'changed_page' };
+        }
+    }
+    return { kind: 'missing', detail: MISSING_PAGE_DETAIL, source: 'none' };
+};
+exports.resolveExistingStaticEntry = resolveExistingStaticEntry;
+const resolveExistingStaticPreviewEntry = async (args) => {
+    const { sessionId, record } = args;
+    let env;
+    try {
+        env = await args.resolveEnv(sessionId);
+    }
+    catch (err) {
+        log.warn(`resolveEnv failed for ${sessionId}`, err);
+        return undefined;
+    }
+    if (env.framework !== 'static')
+        return undefined;
+    const startedAt = Date.now();
+    (0, variantsTelemetry_1.trackPreviewStarted)(args.telemetry, {
+        sessionId,
+        variantId: record.workItemId,
+        projectContextKind: 'existing',
+        previewKind: 'static_artifact',
+    });
+    let projectDirectory;
+    try {
+        projectDirectory = await args.worktrees.getProjectCwdInWorktree(record.worktreePath);
+    }
+    catch (err) {
+        log.warn(`project cwd failed for ${sessionId}/${record.workItemId}`, err);
+        return { kind: 'unresolved' };
+    }
+    let changedFiles = [];
+    if (!env.entryPath) {
+        try {
+            changedFiles =
+                (await args.worktrees.getChangedFiles?.(record.worktreePath)) ?? [];
+        }
+        catch (err) {
+            log.warn(`changed files unavailable for ${sessionId}/${record.workItemId}`, err);
+        }
+    }
+    const entry = await (0, exports.resolveExistingStaticEntry)({
+        worktreePath: record.worktreePath,
+        projectDirectory,
+        configuredEntryPath: env.entryPath,
+        changedFiles,
+    });
+    return {
+        ...entry,
+        hostProjectPath: env.projectPath,
+        projectDirectory,
+        startedAt,
+    };
+};
+exports.resolveExistingStaticPreviewEntry = resolveExistingStaticPreviewEntry;
+//# sourceMappingURL=existingStaticEntry.js.map

package/dist/agent-variants/staticPreviewFiles.js

@@ -33,7 +33,7 @@ const prepareStaticPreviewProjectFiles = ({ sourceDir, entryPath, isWebsite, })
 exports.prepareStaticPreviewProjectFiles = prepareStaticPreviewProjectFiles;
 const stageStaticPreviewFiles = ({ preview, workItemId, environment, isWebsite, briefMarkdown, }) => {
     const rootPath = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), `rivet-variant-${workItemId}-`));
-    const siteDirectory = isWebsite && environment?.framework === 'static'
+    const siteDirectory = isWebsite && environment?.framework === 'static' && environment.entryPath
         ? path_1.default.dirname(environment.entryPath)
         : '.';
     try {

package/dist/agent-variants/variant-project-runtime.d.ts

@@ -14,6 +14,7 @@ export interface WorktreeManagerLike {
     startDevServer(worktreePath: string, port: number, cmd: string, args: string[], env: Record<string, string>): Promise<ChildProcess>;
     stopDevServer(proc: ChildProcess, timeoutMs?: number): Promise<void>;
     getProjectCwdInWorktree(worktreePath: string): Promise<string>;
+    getChangedFiles?(worktreePath: string): Promise<string[]>;
     createFreshWorktrees?(sessionId: string, count: number, template: TemplateBundle, designContext: ReadonlyArray<DesignContextEntry | undefined> | undefined, destinationParent: string): Promise<string[]>;
 }
 type DevServerProjectEnvironment = {
@@ -31,7 +32,7 @@ type DevServerProjectEnvironment = {
 type StaticProjectEnvironment = {
     projectPath: string;
     framework: 'static';
-    entryPath: string;
+    entryPath?: string;
 };
 export type ProjectEnvironment = DevServerProjectEnvironment | StaticProjectEnvironment;
 export {};

package/dist/agent-variants/variantsTelemetry.d.ts

@@ -48,6 +48,7 @@ export interface VariantsTelemetry {
         exitCode?: number | null;
         signal?: string | null;
         missingDeps?: boolean;
+        error?: unknown;
     }) => void;
     trackAgentVariantsPreviewStarted?: (data: {
         sessionId: string;
@@ -63,6 +64,7 @@ export interface VariantsTelemetry {
         hasPort: boolean;
         port?: number;
         durationMs?: number | null;
+        staticEntrySource?: string;
     }) => void;
     trackAgentVariantsPreviewFailed?: (data: {
         sessionId: string;
@@ -76,6 +78,8 @@ export interface VariantsTelemetry {
         exitCode?: number | null;
         signal?: string | null;
         missingDeps?: boolean;
+        staticEntrySource?: string;
+        error?: unknown;
     }) => void;
     trackAgentVariantsBriefQuality?: (data: {
         sessionId: string;
@@ -132,6 +136,7 @@ export declare const trackFreshDevServerFailed: (telemetry: VariantsTelemetry, d
     exitCode?: number | null;
     signal?: string | null;
     missingDeps?: boolean;
+    error?: unknown;
 }) => void;
 export declare const trackPreviewStarted: (telemetry: VariantsTelemetry, data: {
     sessionId: string;
@@ -147,6 +152,7 @@ export declare const trackPreviewReady: (telemetry: VariantsTelemetry, data: {
     hasPort: boolean;
     port?: number;
     durationMs?: number | null;
+    staticEntrySource?: string;
 }) => void;
 export declare const trackPreviewFailed: (telemetry: VariantsTelemetry, data: {
     sessionId: string;
@@ -160,6 +166,8 @@ export declare const trackPreviewFailed: (telemetry: VariantsTelemetry, data: {
     exitCode?: number | null;
     signal?: string | null;
     missingDeps?: boolean;
+    staticEntrySource?: string;
+    error?: unknown;
 }) => void;
 export declare const trackStaticPreviewCompleted: (telemetry: VariantsTelemetry, data: {
     sessionId: string;

package/dist/agent-variants/variantsTelemetry.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.trackStaticPreviewCompleted = exports.trackPreviewFailed = exports.trackPreviewReady = exports.trackPreviewStarted = exports.trackFreshDevServerFailed = exports.trackFreshDevServerStarted = exports.trackScaffoldFailed = exports.trackScaffoldCompleted = exports.trackScaffoldStarted = exports.summarizeDesignContext = exports.NOOP_TELEMETRY = void 0;
+const failureReason_1 = require("../utils/failureReason");
 exports.NOOP_TELEMETRY = { track: () => undefined };
 const summarizeDesignContext = (designContext) => {
     if (!designContext)
@@ -89,6 +90,7 @@ const trackFreshDevServerFailed = (telemetry, data) => {
         exit_code: data.exitCode,
         term_signal: data.signal,
         missing_deps: data.missingDeps,
+        ...(0, failureReason_1.failureReasonProperties)(data.error),
     });
 };
 exports.trackFreshDevServerFailed = trackFreshDevServerFailed;
@@ -120,6 +122,7 @@ const trackPreviewReady = (telemetry, data) => {
         has_port: data.hasPort,
         port: data.port,
         duration_ms: data.durationMs,
+        static_entry_source: data.staticEntrySource,
     });
 };
 exports.trackPreviewReady = trackPreviewReady;
@@ -141,6 +144,8 @@ const trackPreviewFailed = (telemetry, data) => {
         exit_code: data.exitCode,
         term_signal: data.signal,
         missing_deps: data.missingDeps,
+        static_entry_source: data.staticEntrySource,
+        ...(0, failureReason_1.failureReasonProperties)(data.error),
     });
 };
 exports.trackPreviewFailed = trackPreviewFailed;