super-ralph 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "super-ralph",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Reusable Ralph workflow pattern - ticket-driven development with multi-agent review loops",
   "author": "William Cory",
   "license": "MIT",
@@ -36,6 +36,9 @@
     "tdd",
     "code-review"
   ],
+  "scripts": {
+    "typecheck": "tsc --noEmit"
+  },
   "peerDependencies": {
     "smithers-orchestrator": "*"
   },

package/src/components/SuperRalph.tsx

@@ -35,13 +35,13 @@ export type SuperRalphProps = {
   maxConcurrency: number;
   taskRetries?: number;
 
-  // Agents (grouped)
+  // Agents (grouped) - each can be a single agent or [agent, fallback]
   agents: {
-    planning: any;
-    implementation: any;
-    testing: any;
-    reviewing: any;
-    reporting: any;
+    planning: any | [any, any];
+    implementation: any | [any, any];
+    testing: any | [any, any];
+    reviewing: any | [any, any];
+    reporting: any | [any, any];
   };
 
   // Configuration
@@ -80,6 +80,10 @@ export type SuperRalphProps = {
   children?: ReactNode;
 };
 
+function normalizeAgent(agentOrArray: any | any[]): any | any[] {
+  return agentOrArray; // Just return as-is, Task handles arrays now
+}
+
 export function SuperRalph({
   ctx,
   focuses,
@@ -126,11 +130,17 @@ export function SuperRalph({
 
   const { prefix = "📝", mainBranch = "main", emojiPrefixes = "✨ feat, 🐛 fix, ♻️ refactor, 📝 docs, 🧪 test" } = commitConfig;
 
+  const planningAgent = normalizeAgent(agents.planning);
+  const implementationAgent = normalizeAgent(agents.implementation);
+  const testingAgent = normalizeAgent(agents.testing);
+  const reviewingAgent = normalizeAgent(agents.reviewing);
+  const reportingAgent = normalizeAgent(agents.reporting);
+
   return (
     <Ralph until={false} maxIterations={Infinity} onMaxReached="return-last">
       <Parallel maxConcurrency={maxConcurrency}>
         {!skipPhases.has("PROGRESS") && (customUpdateProgress || (
-          <Task id="update-progress" output={outputs.progress} agent={agents.reporting} retries={taskRetries}>
+          <Task id="update-progress" output={outputs.progress} agent={reportingAgent} retries={taskRetries}>
             <UpdateProgressPrompt
               projectName={projectName}
               progressFile={progressFile}
@@ -145,7 +155,7 @@ export function SuperRalph({
         ) : (
           <Parallel maxConcurrency={maxConcurrency}>
             {focuses.map(({ id, name }) => (
-              <Task key={id} id={`codebase-review:${id}`} output={outputs.category_review} agent={agents.reviewing} retries={taskRetries}>
+              <Task key={id} id={`codebase-review:${id}`} output={outputs.category_review} agent={reviewingAgent} retries={taskRetries}>
                 <CategoryReviewPrompt categoryId={id} categoryName={name} relevantDirs={focusDirs[id] ?? null} />
               </Task>
             ))}
@@ -153,7 +163,7 @@ export function SuperRalph({
         ))}
 
         {!skipPhases.has("DISCOVER") && (customDiscover || (
-          <Task id="discover" output={outputs.discover} agent={agents.planning} retries={taskRetries}>
+          <Task id="discover" output={outputs.discover} agent={planningAgent} retries={taskRetries}>
             <DiscoverPrompt
               projectName={projectName}
               specsPath={specsPath}
@@ -171,7 +181,7 @@ export function SuperRalph({
             {focuses.map(({ id, name }) => {
               const suiteInfo = focusTestSuites[id] ?? { suites: [], setupHints: [], testDirs: [] };
               return (
-                <Task key={id} id={`integration-test:${id}`} output={outputs.integration_test} agent={agents.testing} retries={taskRetries}>
+                <Task key={id} id={`integration-test:${id}`} output={outputs.integration_test} agent={testingAgent} retries={taskRetries}>
                   <IntegrationTestPrompt
                     categoryId={id}
                     categoryName={name}
@@ -196,7 +206,7 @@ export function SuperRalph({
             <Worktree key={ticket.id} id={`wt-${ticket.id}`} path={`/tmp/workflow-wt-${ticket.id}`}>
               <Sequence skipIf={ctx.outputMaybe(outputs.report, { nodeId: `${ticket.id}:report` })?.status === "complete"}>
                 {customResearch || (
-                  <Task id={`${ticket.id}:research`} output={outputs.research} agent={agents.planning} retries={taskRetries}>
+                  <Task id={`${ticket.id}:research`} output={outputs.research} agent={planningAgent} retries={taskRetries}>
                     <ResearchPrompt
                       ticketId={ticket.id}
                       ticketTitle={ticket.title}
@@ -211,7 +221,7 @@ export function SuperRalph({
                 )}
 
                 {customPlan || (
-                  <Task id={`${ticket.id}:plan`} output={outputs.plan} agent={agents.planning} retries={taskRetries}>
+                  <Task id={`${ticket.id}:plan`} output={outputs.plan} agent={planningAgent} retries={taskRetries}>
                     <PlanPrompt
                       ticketId={ticket.id}
                       ticketTitle={ticket.title}
@@ -257,7 +267,7 @@ export function SuperRalph({
                     return (
                       <>
                         {customImplement || (
-                          <Task id={`${ticket.id}:implement`} output={outputs.implement} agent={agents.implementation} retries={taskRetries}>
+                          <Task id={`${ticket.id}:implement`} output={outputs.implement} agent={implementationAgent} retries={taskRetries}>
                             <ImplementPrompt
                               ticketId={ticket.id}
                               ticketTitle={ticket.title}
@@ -281,7 +291,7 @@ export function SuperRalph({
                         )}
 
                         {customTest || (
-                          <Task id={`${ticket.id}:test`} output={outputs.test_results} agent={agents.testing} retries={taskRetries}>
+                          <Task id={`${ticket.id}:test`} output={outputs.test_results} agent={testingAgent} retries={taskRetries}>
                             <TestPrompt
                               ticketId={ticket.id}
                               ticketTitle={ticket.title}
@@ -298,7 +308,7 @@ export function SuperRalph({
                         )}
 
                         {customBuildVerify || (
-                          <Task id={`${ticket.id}:build-verify`} output={outputs.build_verify} agent={agents.testing} retries={taskRetries}>
+                          <Task id={`${ticket.id}:build-verify`} output={outputs.build_verify} agent={testingAgent} retries={taskRetries}>
                             <BuildVerifyPrompt
                               ticketId={ticket.id}
                               ticketTitle={ticket.title}
@@ -312,7 +322,7 @@ export function SuperRalph({
 
                         <Parallel maxConcurrency={maxConcurrency}>
                           {customSpecReview || (
-                            <Task id={`${ticket.id}:spec-review`} output={outputs.spec_review} agent={agents.reviewing} retries={taskRetries}>
+                            <Task id={`${ticket.id}:spec-review`} output={outputs.spec_review} agent={reviewingAgent} retries={taskRetries}>
                               <SpecReviewPrompt
                                 ticketId={ticket.id}
                                 ticketTitle={ticket.title}
@@ -332,7 +342,7 @@ export function SuperRalph({
                           )}
 
                           {customCodeReview || (
-                            <Task id={`${ticket.id}:code-review`} output={outputs.code_review} agent={agents.reviewing} retries={taskRetries}>
+                            <Task id={`${ticket.id}:code-review`} output={outputs.code_review} agent={reviewingAgent} retries={taskRetries}>
                               <CodeReviewPrompt
                                 ticketId={ticket.id}
                                 ticketTitle={ticket.title}
@@ -346,7 +356,7 @@ export function SuperRalph({
                         </Parallel>
 
                         {customReviewFix || (!noReviewIssues && (
-                          <Task id={`${ticket.id}:review-fix`} output={outputs.review_fix} agent={agents.implementation} retries={taskRetries}>
+                          <Task id={`${ticket.id}:review-fix`} output={outputs.review_fix} agent={implementationAgent} retries={taskRetries}>
                             <ReviewFixPrompt
                               ticketId={ticket.id}
                               ticketTitle={ticket.title}
@@ -370,7 +380,7 @@ export function SuperRalph({
                 </Sequence>
 
                 {customReport || (
-                  <Task id={`${ticket.id}:report`} output={outputs.report} agent={agents.reporting} retries={taskRetries}>
+                  <Task id={`${ticket.id}:report`} output={outputs.report} agent={reportingAgent} retries={taskRetries}>
                     <ReportPrompt
                       ticketId={ticket.id}
                       ticketTitle={ticket.title}

package/src/mdx.d.ts

@@ -0,0 +1,4 @@
+declare module "*.mdx" {
+  const content: any;
+  export default content;
+}