@rudderhq/cli 0.2.7-canary.2 → 0.2.7-canary.20

package/README.md

@@ -1,76 +1,76 @@
 # Rudder
 
-> Collaborate with agents the way humans work together.
+> Build your self-improving Agent Team.
 
-Rudder is an orchestration and control platform for agent work, and the operating layer for agent teams. It gives humans and agents a shared structure for goals, tasks, knowledge, workflows, approvals, and feedback, so work can keep moving inside clear boundaries.
+Agents that think, build, play, and learn from real work.
 
-Rudder began from a fork of an early version of Paperclip. That gave us a practical starting point for agent operations. Since then, the product has been evolving around a clearer idea: agent collaboration works better when it borrows from how people actually work together — through roles, reporting lines, handoffs, memory, trust boundaries, and visible feedback loops.
+Rudder turns goals, issues, agent runs, reviews, and feedback into a work loop for agent teams. It gives humans and agents a shared operating structure for assigning work, running agents, reviewing outputs, controlling spend, and preserving the lessons that should make the next run better.
 
-Rudder is built for the moment when agent work stops looking like a single prompt and starts looking like a real team.
-
-## The Design Idea
+Rudder began as a fork of an early version of Paperclip. That gave the project a practical starting point for agent operations; Rudder is now evolving around a sharper product idea: agent teams improve when real work leaves behind durable context, decisions, feedback, and reusable operating patterns.
 
-Rudder is shaped by a simple belief: the most useful way to work with agents is closer to the way humans coordinate with each other.
+Rudder is built for the moment when agent work stops looking like a single prompt and starts looking like a real team.
 
-People do not operate through one giant shared prompt. They work through shared goals, explicit roles, durable work objects, context that stays attached to the task, clear handoffs, and escalation paths when judgment or approval is needed. Teams also need visibility: what is moving, what is blocked, what it costs, and where intervention matters.
+## The Work Loop
 
-Rudder turns those coordination patterns into product primitives for agent teams.
+Rudder is designed around the loop that makes agent work compound:
 
-![](./doc/assets/readme_imgs/1.png)
+```text
+Goal -> Issue -> Agent run -> Review -> Feedback -> Learning -> Better future runs
+```
 
-![](./doc/assets/readme_imgs/9.png)
+The control plane matters because this loop needs structure. Goals explain why work exists. Issues make work durable. Heartbeats run agents in a visible way. Reviews and approvals keep autonomy governable. Feedback, comments, documents, run history, and skills give the team a place to keep what it learned.
 
-![](./doc/assets/readme_imgs/10.png)
+Rudder does not assume every lesson is automatically promoted into a new skill or workflow. The product direction is to make those promotion paths explicit, reviewable, and reusable instead of leaving them buried in chat transcripts or one-off prompts.
 
-![](./doc/assets/readme_imgs/2.png)
+## The Design Idea
 
-![](./doc/assets/readme_imgs/3.png)
+The most useful way to work with agents is closer to the way humans coordinate with each other.
 
-![](./doc/assets/readme_imgs/4.png)
+People do not operate through one giant shared prompt. They work through shared goals, explicit roles, durable work objects, context attached to the task, clear handoffs, and escalation paths when judgment or approval is needed. Teams also need visibility: what is moving, what is blocked, what it costs, and where intervention matters.
 
-![](./doc/assets/readme_imgs/5.png)
+Rudder turns those coordination patterns into product primitives for agent teams:
 
-![](./doc/assets/readme_imgs/6.png)
+![Rudder issue board](./doc/assets/readme_imgs/1.png)
 
-![](./doc/assets/readme_imgs/7.png)
+![Rudder calendar](./doc/assets/readme_imgs/9.png)
 
-![](./doc/assets/readme_imgs/8.png)
+![Rudder organization structure](./doc/assets/readme_imgs/10.png)
 
+![Rudder approvals](./doc/assets/readme_imgs/2.png)
 
+![Rudder issue proposal](./doc/assets/readme_imgs/3.png)
 
-That means:
+![Rudder heartbeats](./doc/assets/readme_imgs/4.png)
 
-- work belongs to an organization, not a loose thread
-- every task should trace back to a goal
-- agents should have explicit roles, runtime config, and reporting lines
-- chat should help clarify and route work, while durable execution stays attached to issues, approvals, and outputs
-- autonomy should stay legible, governable, and budget-aware
+![Rudder skills](./doc/assets/readme_imgs/5.png)
 
-## Why Rudder
+![Rudder run transcript](./doc/assets/readme_imgs/6.png)
 
-As soon as agent work becomes ongoing, three things start to matter very quickly: structure, continuity, and control.
+![Rudder organization focused view](./doc/assets/readme_imgs/7.png)
 
-You need a place where goals stay visible, tasks remain durable, knowledge compounds over time, approvals have a clear surface, and spend does not disappear into hidden runtime loops. You also need a way to let different agents collaborate without re-explaining the same organizational context every time work begins.
+![Rudder issue detail](./doc/assets/readme_imgs/8.png)
 
-Rudder provides that control layer. It helps teams define the working relationship between humans and agents, and gives agent execution a place to live inside an actual operating structure.
+- work belongs to an organization, not a loose thread
+- every issue should trace back to a goal
+- agents have roles, runtime config, reporting lines, and skills
+- chat helps clarify and route work, while durable execution stays attached to issues, approvals, outputs, and run history
+- autonomy stays legible, governable, and budget-aware
 
 ## What Rudder Is
 
-Rudder is the operating layer for agent teams. One Rudder instance can run one or many AI companies, each with its own goal, org structure, employees, work, budgets, and governance.
-
-
-| Human company pattern | Rudder equivalent                               |
-| --------------------- | ----------------------------------------------- |
-| Company mission       | Company goal                                    |
-| Employees             | AI agents                                       |
-| Org chart             | Agent reporting structure                       |
-| Work ownership        | Issues and assignments                          |
-| Team workflow         | Workflow definitions and execution paths        |
-| Operational memory    | Knowledge, comments, logs, and activity history |
-| Manager check-ins     | Agent heartbeats                                |
-| Executive review      | Board approvals                                 |
-| Budget discipline     | Spend tracking and hard stops                   |
+Rudder is the operating layer for self-improving agent teams. One Rudder instance can run one or many organizations, each with its own goal, org structure, agents, issues, budgets, approvals, feedback, and governance.
 
+| Human team pattern | Rudder equivalent |
+| --- | --- |
+| Mission | Organization goal |
+| Employees | AI agents |
+| Org chart | Agent reporting structure |
+| Work ownership | Issues and assignments |
+| Team workflow | Workflow definitions and execution paths |
+| Operational memory | Comments, documents, run history, activity, and skills |
+| Manager check-ins | Agent heartbeats |
+| Executive review | Board approvals |
+| Budget discipline | Spend tracking and hard stops |
 
 Rudder coordinates agents. It does not force one runtime, one model, one prompt format, or one execution environment.
 
@@ -78,15 +78,13 @@ Rudder coordinates agents. It does not force one runtime, one model, one prompt
 
 ### Try Rudder
 
-The fastest path installs the per-user portable Rudder Desktop app and prepares
-the matching persistent CLI:
+The fastest path installs the per-user portable Rudder Desktop app and prepares the matching persistent CLI:
 
 ```bash
 npx @rudderhq/cli@latest start
 ```
 
-After the persistent CLI is available, the direct `rudder` form is the same
-command surface:
+After the persistent CLI is available, the direct `rudder` form is the same command surface:
 
 ```bash
 rudder start
@@ -110,13 +108,16 @@ Rudder defaults to embedded PostgreSQL in development. If `DATABASE_URL` is unse
 
 1. Create an organization.
 2. Define the organization goal.
-3. Hire a CEO agent and configure its runtime.
-4. Build the org tree by adding reports.
+3. Create or use a default agent with a clear role and runtime.
+4. Add more agents only when repeated work needs stable ownership.
 5. Create or convert work into issues.
 6. Let agents pick up work through heartbeat invocations.
 7. Review outputs, approvals, activity, and spend from the board.
+8. Leave feedback on the run, issue, or output.
+9. Preserve reusable lessons as better context, skills, decisions, or workflows.
+10. Future runs use the improved team context.
 
-Every durable piece of work should still answer one question: why does this task exist? In Rudder, the intended answer is traceable all the way back to the organization goal.
+Every durable piece of work should still answer one question: why does this issue exist? In Rudder, the intended answer is traceable all the way back to the organization goal.
 
 ## Contributing
 

package/dist/index.js

@@ -747,7 +747,7 @@ var init_resource = __esm({
 
 // ../packages/shared/dist/validators/chat.js
 import { z as z8 } from "zod";
-var chatConversationStatusSchema, chatIssueCreationModeSchema, chatMessageRoleSchema, chatMessageKindSchema, chatMessageStatusSchema, chatContextEntityTypeSchema, createChatContextLinkSchema, createChatConversationSchema, setChatProjectContextSchema, updateChatConversationSchema, addChatMessageSchema, chatRichReferenceDisplaySchema, chatIssueIdentifierSchema, chatAskUserIdentifierSchema, chatAskUserOptionSchema, chatAskUserQuestionSchema, chatAskUserRequestSchema, chatIssueRichReferenceSchema, chatIssueCommentRichReferenceSchema, chatRichReferenceSchema, chatRichReferencesSchema, createChatAttachmentMetadataSchema, chatIssueProposalSchema, convertChatToIssueSchema, chatOperationProposalSchema, resolveChatOperationProposalSchema, updateChatConversationUserStateSchema;
+var chatConversationStatusSchema, chatIssueCreationModeSchema, chatMessageRoleSchema, chatMessageKindSchema, chatMessageStatusSchema, chatContextEntityTypeSchema, createChatContextLinkSchema, createChatConversationSchema, setChatProjectContextSchema, updateChatConversationSchema, addChatMessageSchema, chatRichReferenceDisplaySchema, chatIssueIdentifierSchema, chatAskUserIdentifierSchema, chatAskUserOptionSchema, chatAskUserQuestionSchema, chatAskUserRequestSchema, chatIssueRichReferenceSchema, chatIssueCommentRichReferenceSchema, chatRichReferenceSchema, chatRichReferencesSchema, chatAutomationCreateSchema, createChatAttachmentMetadataSchema, chatIssueProposalSchema, convertChatToIssueSchema, chatOperationProposalSchema, resolveChatOperationProposalSchema, updateChatConversationUserStateSchema;
 var init_chat = __esm({
   "../packages/shared/dist/validators/chat.js"() {
     "use strict";
@@ -798,6 +798,7 @@ var init_chat = __esm({
       header: z8.string().trim().min(1).max(32).optional(),
       question: z8.string().trim().min(1).max(240),
       options: z8.array(chatAskUserOptionSchema).min(2).max(3),
+      selectionMode: z8.enum(["single", "multiple"]).optional(),
       allowFreeform: z8.boolean().optional()
     }).superRefine((question, ctx) => {
       const optionIds = /* @__PURE__ */ new Set();
@@ -851,6 +852,24 @@ var init_chat = __esm({
       chatIssueCommentRichReferenceSchema
     ]);
     chatRichReferencesSchema = z8.array(chatRichReferenceSchema).max(5);
+    chatAutomationCreateSchema = z8.object({
+      title: z8.string().trim().min(1).max(200),
+      description: z8.string().trim().max(2e4).optional().nullable(),
+      projectId: z8.string().uuid().optional().nullable(),
+      goalId: z8.string().uuid().optional().nullable(),
+      parentIssueId: z8.string().uuid().optional().nullable(),
+      priority: z8.enum(["critical", "high", "medium", "low"]).optional().default("medium"),
+      status: z8.enum(AUTOMATION_STATUSES).optional().default("active"),
+      concurrencyPolicy: z8.enum(AUTOMATION_CONCURRENCY_POLICIES).optional().default("coalesce_if_active"),
+      catchUpPolicy: z8.enum(AUTOMATION_CATCH_UP_POLICIES).optional().default("skip_missed"),
+      outputMode: z8.enum(AUTOMATION_OUTPUT_MODES).optional().default("chat_output"),
+      schedule: z8.object({
+        cronExpression: z8.string().trim().min(1),
+        timezone: z8.string().trim().min(1),
+        label: z8.string().trim().max(120).optional().nullable(),
+        enabled: z8.boolean().optional().default(true)
+      })
+    });
     createChatAttachmentMetadataSchema = z8.object({
       messageId: z8.string().uuid()
     });
@@ -2598,11 +2617,12 @@ var init_project_mentions = __esm({
 
 // ../packages/shared/dist/config-schema.js
 import { z as z27 } from "zod";
-var configMetaSchema, llmConfigSchema, databaseBackupConfigSchema, databaseConfigSchema, loggingConfigSchema, serverConfigSchema, authConfigSchema, storageLocalDiskConfigSchema, storageS3ConfigSchema, storageConfigSchema, secretsLocalEncryptedConfigSchema, secretsConfigSchema, langfuseConfigSchema, rudderConfigSchema;
+var DEFAULT_DATABASE_BACKUP_MAX_ESTIMATED_BYTES, configMetaSchema, llmConfigSchema, databaseBackupConfigSchema, databaseConfigSchema, loggingConfigSchema, serverConfigSchema, authConfigSchema, storageLocalDiskConfigSchema, storageS3ConfigSchema, storageConfigSchema, secretsLocalEncryptedConfigSchema, secretsConfigSchema, langfuseConfigSchema, rudderConfigSchema;
 var init_config_schema = __esm({
   "../packages/shared/dist/config-schema.js"() {
     "use strict";
     init_constants();
+    DEFAULT_DATABASE_BACKUP_MAX_ESTIMATED_BYTES = 256 * 1024 * 1024;
     configMetaSchema = z27.object({
       version: z27.literal(1),
       updatedAt: z27.string(),
@@ -2616,6 +2636,7 @@ var init_config_schema = __esm({
       enabled: z27.boolean().default(true),
       intervalMinutes: z27.number().int().min(1).max(7 * 24 * 60).default(60),
       retentionDays: z27.number().int().min(1).max(3650).default(30),
+      maxEstimatedBytes: z27.number().int().min(1).default(DEFAULT_DATABASE_BACKUP_MAX_ESTIMATED_BYTES),
       dir: z27.string().default("~/.rudder/instances/default/data/backups")
     });
     databaseConfigSchema = z27.object({
@@ -2627,6 +2648,7 @@ var init_config_schema = __esm({
         enabled: true,
         intervalMinutes: 60,
         retentionDays: 30,
+        maxEstimatedBytes: DEFAULT_DATABASE_BACKUP_MAX_ESTIMATED_BYTES,
         dir: "~/.rudder/instances/default/data/backups"
       })
     });
@@ -3140,6 +3162,7 @@ async function promptDatabase(current) {
       enabled: true,
       intervalMinutes: 60,
       retentionDays: 30,
+      maxEstimatedBytes: DEFAULT_DATABASE_BACKUP_MAX_ESTIMATED_BYTES,
       dir: defaultBackupDir
     }
   };
@@ -3248,6 +3271,20 @@ async function promptDatabase(current) {
     p.cancel("Setup cancelled.");
     process.exit(0);
   }
+  const backupMaxEstimatedInput = await p.text({
+    message: "Scheduled backup max database estimate (bytes)",
+    defaultValue: String(base.backup.maxEstimatedBytes || DEFAULT_DATABASE_BACKUP_MAX_ESTIMATED_BYTES),
+    placeholder: String(DEFAULT_DATABASE_BACKUP_MAX_ESTIMATED_BYTES),
+    validate: (val) => {
+      const n = Number(val);
+      if (!Number.isInteger(n) || n < 1) return "Max estimate must be a positive integer byte count";
+      return void 0;
+    }
+  });
+  if (p.isCancel(backupMaxEstimatedInput)) {
+    p.cancel("Setup cancelled.");
+    process.exit(0);
+  }
   return {
     mode,
     connectionString,
@@ -3257,6 +3294,7 @@ async function promptDatabase(current) {
       enabled: backupEnabled,
       intervalMinutes: Number(backupIntervalInput || "60"),
       retentionDays: Number(backupRetentionInput || "30"),
+      maxEstimatedBytes: Number(backupMaxEstimatedInput || String(DEFAULT_DATABASE_BACKUP_MAX_ESTIMATED_BYTES)),
       dir: backupDirInput || defaultBackupDir
     }
   };
@@ -3264,6 +3302,7 @@ async function promptDatabase(current) {
 var init_database = __esm({
   "src/prompts/database.ts"() {
     "use strict";
+    init_schema();
     init_home();
   }
 });
@@ -5471,6 +5510,18 @@ function parseNumberFromEnv(rawValue) {
   if (!Number.isFinite(parsed)) return null;
   return parsed;
 }
+function parseBytesFromEnv(rawValue) {
+  const value = rawValue?.trim();
+  if (!value) return null;
+  const match = value.match(/^(\d+(?:\.\d+)?)\s*(b|kb|kib|mb|mib|gb|gib)?$/i);
+  if (!match) return null;
+  const amount = Number(match[1]);
+  const unit = match[2]?.toLowerCase() ?? "b";
+  const multiplier = unit === "gb" || unit === "gib" ? 1024 ** 3 : unit === "mb" || unit === "mib" ? 1024 ** 2 : unit === "kb" || unit === "kib" ? 1024 : 1;
+  const parsed = Math.floor(amount * multiplier);
+  if (!Number.isSafeInteger(parsed) || parsed < 1) return null;
+  return parsed;
+}
 function parseEnumFromEnv(rawValue, allowedValues) {
   if (!rawValue) return null;
   return allowedValues.includes(rawValue) ? rawValue : null;
@@ -5516,6 +5567,7 @@ function quickstartDefaultsFromEnv() {
     1,
     parseNumberFromEnv(process.env.RUDDER_DB_BACKUP_RETENTION_DAYS) ?? 30
   );
+  const databaseBackupMaxEstimatedBytes = parseBytesFromEnv(process.env.RUDDER_DB_BACKUP_MAX_ESTIMATED_BYTES) ?? DEFAULT_DATABASE_BACKUP_MAX_ESTIMATED_BYTES;
   const defaults = {
     database: {
       mode: databaseUrl ? "postgres" : "embedded-postgres",
@@ -5529,6 +5581,7 @@ function quickstartDefaultsFromEnv() {
         enabled: databaseBackupEnabled,
         intervalMinutes: databaseBackupIntervalMinutes,
         retentionDays: databaseBackupRetentionDays,
+        maxEstimatedBytes: databaseBackupMaxEstimatedBytes,
         dir: resolvePathFromEnv(process.env.RUDDER_DB_BACKUP_DIR) ?? resolveDefaultBackupDir(instanceId)
       }
     },
@@ -5880,6 +5933,7 @@ var init_onboard = __esm({
       "RUDDER_DB_BACKUP_INTERVAL_MINUTES",
       "RUDDER_DB_BACKUP_RETENTION_DAYS",
       "RUDDER_DB_BACKUP_DIR",
+      "RUDDER_DB_BACKUP_MAX_ESTIMATED_BYTES",
       "RUDDER_DEPLOYMENT_MODE",
       "RUDDER_DEPLOYMENT_EXPOSURE",
       "HOST",
@@ -6211,6 +6265,7 @@ function quoteShellValue(value) {
 
 // src/commands/configure.ts
 init_store();
+init_schema();
 init_secrets_key();
 init_database();
 init_llm();
@@ -6248,6 +6303,7 @@ function defaultConfig() {
         enabled: true,
         intervalMinutes: 60,
         retentionDays: 30,
+        maxEstimatedBytes: DEFAULT_DATABASE_BACKUP_MAX_ESTIMATED_BYTES,
         dir: resolveDefaultBackupDir(instanceId)
       }
     },