@builder.io/dev-tools 1.47.2-dev.202604210756.fdce3a53d → 1.47.2-dev.202604210953.dac9af97d

package/types/cli/utils/rules-parser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Custom instruction/rules parsing utilities
+ * Handles parsing of custom instruction files (.mdc, .cursorrules, etc.)
+ */
+import type { CustomInstruction } from "$/ai-utils";
+/**
+ * Parse a custom instruction file
+ * Supports both:
+ * - .mdc files with YAML frontmatter
+ * - Plain text files (.cursorrules, .builderrules, etc.)
+ *
+ * @param fileContent - Raw file content
+ * @param filePath - File path (for generating name and id)
+ * @param hashFunction - Optional hash function for generating unique IDs
+ * @returns Parsed CustomInstruction or null
+ */
+export declare function parseCustomInstructionFile(fileContent: string, filePath: string, hashFunction?: (content: string) => string): CustomInstruction | null;

package/types/cli/utils/rules-parser.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/cli/utils/timeline-collector.d.ts

@@ -26,6 +26,15 @@ interface ProgressSnapshot {
     lastFrameFileName?: string;
     lastThinking?: string;
 }
+export interface StateEntry {
+    ts: number;
+    agentId: string;
+    kind: "test_outcome";
+    status?: "accepted" | "rejected";
+    reason?: string;
+    test_case_id?: string;
+    [key: string]: any;
+}
 export declare class TimelineCollector {
     #private;
     constructor(sessionId: string, options: TimelineCollectorOptions);
@@ -61,6 +70,62 @@ export declare class TimelineCollector {
     getLastLabel(): string;
     hasExplicitFrames(): boolean;
     hasAnyFrames(): boolean;
+    /**
+     * Merge all events and frames from a child agent's timeline into this one.
+     * Used to combine parallel executor timelines into a single planner recording.
+     * Adds section markers and prefixes labels with the phase name.
+     */
+    mergeChildTimeline(child: TimelineCollector, label: string, opts?: {
+        summary?: string;
+        sessionId?: string;
+        testCaseIds?: string[];
+    }): {
+        startEventId: number;
+        endEventId: number;
+    };
+    /** Merge a child executor's test plan into this timeline for recording submission. */
+    mergeTestPlan(plan: {
+        mode: string;
+        test_cases: Array<{
+            id: string;
+            description?: string;
+            title?: string;
+            expected_outcome: string;
+            priority: string;
+        }>;
+    }): void;
+    /** Returns the merged test plan from child executors, if any. */
+    getMergedTestPlan(): {
+        mode: string;
+        test_cases: Array<{
+            id: string;
+            description?: string;
+            title?: string;
+            expected_outcome: string;
+            priority: string;
+        }>;
+    } | null;
+    /** Merge child executor test case results into this timeline. Last write wins by test_case_id. */
+    mergeTestCaseResults(results: Array<Record<string, any>>): void;
+    /** Returns all merged test case results from child executors. */
+    getMergedTestCaseResults(): Record<string, any>[];
+    /**
+     * Path to this collector's append-only state file. One JSONL line per
+     * `ReportTestOutcome` call (accepted or rejected)
+     */
+    getStateFilePath(): string;
+    /** Record a test outcome (accepted or rejected) to the state file. */
+    onTestOutcome(input: Record<string, any>, status: "accepted" | "rejected", reason?: string): void;
+    /**
+     * Merge a child agent's state file into this one. Called from
+     * mergeChildTimeline so parent's finalize() sees both own and child state.
+     */
+    mergeChildStateFile(childPath: string): void;
+    /**
+     * Read all state entries from disk. Used by finalize-from-disk on
+     * crash recovery. Malformed lines are skipped silently.
+     */
+    readState(): StateEntry[];
     getHighlightFrames(): CollectedFrame[];
     getHighlightImages(): ContentMessageItemImage[];
     getHighlightMetadataFrames(): Array<{

package/types/cli/utils/yaml-frontmatter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Generic YAML frontmatter parser for Markdown files
+ * Supports both simple key-value pairs and arrays
+ */
+export interface YamlFrontmatterResult<T = Record<string, any>> {
+    frontmatter: T;
+    body: string;
+}
+/**
+ * Checks if content has YAML frontmatter
+ */
+export declare function hasYamlFrontmatter(content: string): boolean;
+/**
+ * Parses YAML frontmatter from a string
+ * Handles simple YAML: key-value pairs, arrays, and comments
+ */
+export declare function parseYamlFrontmatter(yamlContent: string): Record<string, any>;
+/**
+ * Extracts YAML frontmatter and body from Markdown content
+ * @param content - The raw Markdown content with frontmatter
+ * @returns Object with frontmatter and body, or null if no frontmatter found
+ */
+export declare function extractYamlFrontmatter(content: string): {
+    frontmatterContent: string;
+    body: string;
+} | null;
+/**
+ * Parse Markdown file with YAML frontmatter
+ * @param content - The raw file content
+ * @returns Parsed frontmatter and body
+ */
+export declare function parseMarkdownWithYaml<T = Record<string, any>>(content: string): YamlFrontmatterResult<T>;

package/types/cli/utils/yaml-frontmatter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/scripts/analyze-projects.d.ts

@@ -0,0 +1,18 @@
+export declare function analyzeProjects(inputPath?: string): Promise<{
+    success: boolean;
+    error: string;
+    projectsCount?: undefined;
+    branchesCount?: undefined;
+    csvRowsCount?: undefined;
+    outputPath?: undefined;
+} | {
+    success: boolean;
+    projectsCount: number;
+    branchesCount: number;
+    csvRowsCount: number;
+    outputPath: string;
+    error?: undefined;
+}>;
+export declare function handleAnalyzeProjects(args: {
+    inputPath?: string;
+}): Promise<void>;

package/types/scripts/call-ensure-container.d.ts

@@ -0,0 +1,4 @@
+export declare function handleCallEnsureContainer(args: {
+    appName: string;
+    branchName: string;
+}): Promise<void>;

package/types/scripts/check-backup.d.ts

@@ -0,0 +1 @@
+export declare function handleCheckBackup(): Promise<void>;

package/types/scripts/cli.d.ts

@@ -0,0 +1 @@
+export {};

package/types/scripts/download-projects.d.ts

@@ -0,0 +1,12 @@
+export declare function downloadProjects(): Promise<{
+    success: boolean;
+    count: number;
+    outputPath: string;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: string;
+    count?: undefined;
+    outputPath?: undefined;
+}>;
+export declare function handleDownloadProjects(): Promise<void>;

package/types/scripts/utils/db.d.ts

@@ -0,0 +1,3 @@
+import admin from "firebase-admin";
+export declare const db: admin.firestore.Firestore;
+export declare const storage: admin.storage.Storage;

package/types/scripts/utils/ensure-container.d.ts

@@ -0,0 +1,7 @@
+export declare function ensureContainer(projectId: string, branchName: string): Promise<{
+    success: boolean;
+    error?: undefined;
+} | {
+    success: boolean;
+    error: any;
+}>;

package/types/scripts/utils/remove-machine-and-volume.d.ts

@@ -0,0 +1,5 @@
+export declare function forceRemoveMachineAndVolume({ projectId, branchName, shouldDeleteVolume, }: {
+    projectId: string;
+    branchName: string;
+    shouldDeleteVolume?: boolean;
+}): Promise<void>;