@jokerized/getresearchdone 0.4.1

package/dist/lib/evolve/types.d.ts

@@ -0,0 +1,249 @@
+/**
+ * GRD Evolve -- Domain type definitions
+ *
+ * All interfaces and type aliases for the evolve subsystem.
+ * Pure type definitions with no runtime code or imports.
+ *
+ * @dependencies None (pure types)
+ */
+/** Effort estimates for work items. */
+export type WorkItemEffort = 'small' | 'medium' | 'large';
+/** Source of a work item. */
+export type WorkItemSource = 'discovery' | 'bugfix' | 'carryover';
+/** Status of a work item. */
+export type WorkItemStatus = 'pending' | 'selected' | 'completed' | 'failed';
+/** A single unit of improvement work. */
+export interface WorkItem {
+    id: string;
+    dimension: string;
+    slug: string;
+    title: string;
+    description: string;
+    effort: WorkItemEffort;
+    source: WorkItemSource;
+    status: WorkItemStatus;
+    iteration_added: number;
+}
+/** Optional overrides for createWorkItem. */
+export interface WorkItemOptions {
+    effort?: WorkItemEffort;
+    source?: WorkItemSource;
+    status?: WorkItemStatus;
+    iteration_added?: number;
+}
+/** Iteration history record. */
+export interface HistoryEntry {
+    iteration: number;
+    timestamp: string;
+    selected_count: number;
+    completed_count: number;
+    failed_count: number;
+}
+/** Full evolve state (legacy item-based format). */
+export interface EvolveState {
+    iteration: number;
+    timestamp: string;
+    milestone: string;
+    items_per_iteration: number;
+    selected: WorkItem[];
+    remaining: WorkItem[];
+    bugfix: WorkItem[];
+    completed: WorkItem[];
+    failed: WorkItem[];
+    history: HistoryEntry[];
+}
+/** Group-based evolve state (Phase 56+ format). */
+export interface EvolveGroupState {
+    iteration: number;
+    timestamp: string;
+    milestone: string;
+    pick_pct: number;
+    selected_groups: WorkGroup[];
+    remaining_groups: WorkGroup[];
+    completed_groups: WorkGroup[];
+    failed_groups: WorkGroup[];
+    all_items_count: number;
+    groups_count: number;
+    history: HistoryEntry[];
+}
+/** Grouped work items by theme. */
+export interface WorkGroup {
+    id: string;
+    theme: string;
+    dimension: string;
+    title?: string;
+    items: WorkItem[];
+    priority: number;
+    effort: WorkItemEffort;
+    status?: string;
+}
+/** Result from runGroupDiscovery. */
+export interface GroupDiscoveryResult {
+    groups: WorkGroup[];
+    selected_groups: WorkGroup[];
+    remaining_groups: WorkGroup[];
+    all_items_count: number;
+    merged_items_count: number;
+    groups_count: number;
+}
+/** Theme pattern for slug-based grouping. */
+export interface ThemePattern {
+    pattern: RegExp;
+    theme: string;
+}
+/** Options for runEvolve. */
+export interface EvolveOptions {
+    iterations?: number;
+    pickPct?: number;
+    timeout?: number;
+    maxTurns?: number;
+    dryRun?: boolean;
+    useWorktree?: boolean;
+    autoCommit?: boolean;
+    createPr?: boolean;
+}
+/** Result of processing one group. */
+export interface GroupOutcome {
+    group: string;
+    status: 'pass' | 'fail' | 'skip';
+    step?: string;
+    reason?: string;
+}
+/** Per-iteration summary. */
+export interface IterationResult {
+    iteration: number;
+    status: string;
+    groups_attempted: number;
+    groups_passed: number;
+    groups_failed: number;
+    remaining_groups: number;
+}
+/** Dry-run iteration result. */
+export interface DryRunIterationResult {
+    iteration: number;
+    status: 'dry-run';
+    groups: Array<{
+        id: string;
+        priority: number;
+        item_count: number;
+        effort: string;
+    }>;
+    total_items: number;
+    total_groups: number;
+    groups_per_iteration: number;
+    estimated_iterations: number;
+}
+/** Full result from runEvolve. */
+export interface EvolveResult {
+    iterations_completed: number;
+    results: Array<IterationResult | DryRunIterationResult>;
+    evolution_notes_path: string;
+    worktree?: {
+        path: string;
+        branch: string;
+    };
+    pr?: Record<string, unknown>;
+}
+/** Tracked worktree state during evolve. */
+export interface WorktreeInfo {
+    path: string;
+    branch: string;
+    baseBranch: string;
+}
+/** Data for writeEvolutionNotes. */
+export interface EvolutionNotesData {
+    iteration: number;
+    items: WorkItem[];
+    outcomes: Array<{
+        item: string;
+        status: string;
+        step?: string;
+        reason?: string;
+    }>;
+    decisions: string[];
+    patterns: string[];
+    takeaways: string[];
+}
+/** Context for _runIterationStep. */
+export interface IterationContext {
+    executionCwd: string;
+    state: EvolveGroupState | EvolveState | null;
+    useWorktree: boolean;
+    worktreeInfo: WorktreeInfo | null;
+    effectivePickPct: number;
+    dryRun: boolean;
+    timeoutMs: number;
+    maxTurns: number | undefined;
+    cwd: string;
+    log: (msg: string) => void;
+    autoCommit: boolean;
+    iterationNum: number;
+    /** Optional scheduler for rate-limited backend routing. */
+    scheduler: import('../scheduler').Scheduler | null;
+}
+/** Structured feedback from a single iteration's subprocess. */
+export interface IterationFeedback {
+    decisions: string[];
+    patterns: string[];
+    takeaways: string[];
+    files_changed?: string[];
+}
+/** Return from _runIterationStep. */
+export interface IterationStepResult {
+    discovery: GroupDiscoveryResult;
+    outcomes: GroupOutcome[] | null;
+    worktreeInfo: WorktreeInfo | null;
+    executionCwd: string;
+    feedback: IterationFeedback | null;
+    useWorktree: boolean;
+    isDryRun: boolean;
+}
+/** Return from _handleIterationResult. */
+export interface HandleIterationReturn {
+    newState: EvolveGroupState;
+    iterResult: IterationResult;
+}
+/** Structured context gathered from project planning files for product ideation. */
+export interface ProductIdeationContext {
+    projectVision: string | null;
+    longTermGoals: string | null;
+    existingCommands: string[];
+    existingAgents: string[];
+    recentPhases: string | null;
+    productQuality: string | null;
+}
+/** Options passed through the discovery call chain. */
+export interface DiscoveryOptions {
+    timeoutMs?: number;
+    scheduler?: import('../scheduler').Scheduler | null;
+}
+/** Per-cycle result in the infinite evolve loop. */
+export interface InfiniteEvolveCycleResult {
+    cycle: number;
+    discovery_groups: number;
+    discovery_items: number;
+    autoplan_status: string;
+    autopilot_status: string;
+    reason?: string;
+}
+/** Options for runInfiniteEvolve. */
+export interface InfiniteEvolveOptions {
+    maxCycles?: number;
+    timeBudget?: number;
+    pickPct?: number;
+    dryRun?: boolean;
+    timeout?: number;
+    maxTurns?: number;
+    model?: string;
+    maxMilestones?: number;
+}
+/** Returned by runInfiniteEvolve. */
+export interface InfiniteEvolveResult {
+    cycles_completed: number;
+    cycles_attempted: number;
+    stopped_at: string | null;
+    cycle_results: InfiniteEvolveCycleResult[];
+    total_groups_discovered: number;
+    total_items_discovered: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/evolve/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../lib/evolve/types.ts"],"names":[],"mappings":"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"}

package/dist/lib/evolve/types.js

@@ -0,0 +1,3 @@
+'use strict';
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/lib/evolve/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../lib/evolve/types.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC"}

package/dist/lib/frontmatter.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/lib/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../lib/frontmatter.ts"],"names":[],"mappings":""}