@rudderhq/cli 0.2.0-canary.27 → 0.2.0-canary.29

package/dist/index.js

@@ -1476,7 +1476,7 @@ var init_project = __esm({
 
 // ../packages/shared/src/validators/issue.ts
 import { z as z13 } from "zod";
-var executionWorkspaceStrategySchema2, issueExecutionWorkspaceSettingsSchema, issueAssigneeAdapterOverridesSchema, createIssueSchema, createIssueLabelSchema, updateIssueLabelSchema, updateIssueSchema, reorderIssueSchema, checkoutIssueSchema, addIssueCommentSchema, linkIssueApprovalSchema, createIssueAttachmentMetadataSchema, createIssueWorkspaceAttachmentSchema, ISSUE_DOCUMENT_FORMATS, issueDocumentFormatSchema, issueDocumentKeySchema, upsertIssueDocumentSchema;
+var executionWorkspaceStrategySchema2, issueExecutionWorkspaceSettingsSchema, issueAssigneeAdapterOverridesSchema, createIssueSchema, createIssueLabelSchema, updateIssueLabelSchema, updateIssueSchema, reorderIssueSchema, checkoutIssueSchema, addIssueCommentSchema, reportIssueCommitSchema, linkIssueApprovalSchema, createIssueAttachmentMetadataSchema, createIssueWorkspaceAttachmentSchema, ISSUE_DOCUMENT_FORMATS, issueDocumentFormatSchema, issueDocumentKeySchema, upsertIssueDocumentSchema;
 var init_issue = __esm({
   "../packages/shared/src/validators/issue.ts"() {
     "use strict";
@@ -1563,6 +1563,14 @@ var init_issue = __esm({
       reopen: z13.boolean().optional(),
       interrupt: z13.boolean().optional()
     });
+    reportIssueCommitSchema = z13.object({
+      sha: z13.string().trim().regex(/^[0-9a-f]{7,64}$/i, "Commit SHA must be 7 to 64 hexadecimal characters"),
+      message: z13.string().trim().min(1).max(500),
+      branch: z13.string().trim().min(1).max(255).optional().nullable(),
+      repoPath: z13.string().trim().min(1).max(2048).optional().nullable(),
+      workspacePath: z13.string().trim().min(1).max(2048).optional().nullable(),
+      commitCount: z13.number().int().positive().max(1e3).optional()
+    });
     linkIssueApprovalSchema = z13.object({
       approvalId: z13.string().uuid()
     });
@@ -7270,11 +7278,13 @@ var ApiRequestError = class extends Error {
 var RudderApiClient = class {
   apiBase;
   apiKey;
+  agentId;
   runId;
   recoverAuth;
   constructor(opts) {
     this.apiBase = opts.apiBase.replace(/\/+$/, "");
     this.apiKey = opts.apiKey?.trim() || void 0;
+    this.agentId = opts.agentId?.trim() || void 0;
     this.runId = opts.runId?.trim() || void 0;
     this.recoverAuth = opts.recoverAuth;
   }
@@ -7323,8 +7333,13 @@ var RudderApiClient = class {
     if (this.apiKey) {
       headers.authorization = `Bearer ${this.apiKey}`;
     }
-    if (this.runId && shouldAttachRunId(init.method)) {
-      headers["x-rudder-run-id"] = this.runId;
+    if (shouldAttachAgentContext(init.method)) {
+      if (this.agentId) {
+        headers["x-rudder-agent-id"] = this.agentId;
+      }
+      if (this.runId) {
+        headers["x-rudder-run-id"] = this.runId;
+      }
     }
     const response = await fetch(url, {
       ...init,
@@ -7358,7 +7373,7 @@ var RudderApiClient = class {
     return safeParseJson(text6);
   }
 };
-function shouldAttachRunId(method) {
+function shouldAttachAgentContext(method) {
   const normalized = String(method ?? "GET").toUpperCase();
   return normalized !== "GET" && normalized !== "HEAD";
 }
@@ -7433,6 +7448,7 @@ function resolveCommandContext(options, opts) {
   const api = new RudderApiClient({
     apiBase,
     apiKey,
+    agentId,
     runId,
     recoverAuth: explicitApiKey || !canAttemptInteractiveBoardAuth() ? void 0 : async ({ error }) => {
       const requestedAccess = error.message.includes("Instance admin required") ? "instance_admin_required" : "board";
@@ -9396,6 +9412,18 @@ var AGENT_CLI_CAPABILITIES = [
     requiresRunId: false,
     attachesRunIdWhenAvailable: true
   },
+  {
+    id: "issue.commit",
+    command: "rudder issue commit <issue> --sha <sha> --message <subject>",
+    category: "issue",
+    description: "Report a code commit created during issue work as structured issue activity.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
   {
     id: "issue.done",
     command: "rudder issue done <issue> --comment <text> [--image <path>]",
@@ -9818,6 +9846,25 @@ function registerIssueCommands(program) {
       }
     })
   );
+  addCommonClientOptions(
+    issue.command("commit").description(getAgentCliCapabilityById("issue.commit").description).argument("<issueId>", "Issue ID").requiredOption("--sha <sha>", "Commit SHA").requiredOption("--message <subject>", "Commit subject or message").option("--branch <name>", "Branch name").option("--repo-path <path>", "Repository path").option("--workspace-path <path>", "Workspace path").option("--count <n>", "Number of commits represented by this report").action(async (issueId, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const payload = reportIssueCommitSchema.parse({
+          sha: opts.sha,
+          message: opts.message,
+          branch: opts.branch,
+          repoPath: opts.repoPath,
+          workspacePath: opts.workspacePath,
+          commitCount: parseOptionalInt(opts.count)
+        });
+        const reported = await ctx.api.post(`/api/issues/${issueId}/commit`, payload);
+        printOutput(reported, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    })
+  );
   addCommonClientOptions(
     issue.command("done").description(getAgentCliCapabilityById("issue.done").description).argument("<issueId>", "Issue ID").requiredOption("--comment <text>", "Required completion comment").option("--image <path>", "Image file to upload and append to the completion comment; may be repeated", collectImagePath, []).action(async (issueId, opts) => {
       try {
@@ -10144,12 +10191,18 @@ var RUDDER_AGENT_OPERATING_CONTRACT = [
   "- Shared organization workspace root lives under `$RUDDER_ORG_WORKSPACE_ROOT`.",
   "- Shared organization skills live under `$RUDDER_ORG_SKILLS_DIR`.",
   "- Shared organization plans live under `$RUDDER_ORG_PLANS_DIR`.",
+  "- Shared organization artifacts live under `$RUDDER_ORG_ARTIFACTS_DIR`.",
+  "- Durable generated outputs such as screenshots, images, mockups, reports, CSVs, handoff logs, and other user-visible files should be written under `$RUDDER_ORG_ARTIFACTS_DIR` when available.",
+  "- Use `/tmp` only for transient scratch files and temporary verification artifacts; do not put durable work product there.",
+  "- Local trusted runtimes may expose the host operator home as `$RUDDER_OPERATOR_HOME`; use it only when a local skill or script intentionally needs operator-owned desktop app or CLI state. Do not replace `$HOME` with it.",
   "- Durable shared work output should prefer these managed workspace paths instead of ad-hoc top-level `projects/` folders.",
   "",
   "When you create or copy a skill under `$AGENT_HOME/skills/<slug>/`, check the agent's Skills snapshot before claiming it will load in future runs. If it is installed but not enabled, say exactly that future runs will not load it until enabled, and offer to enable it with `rudder agent skills enable <agent-id> <selection-ref>` when you have permission.",
   "",
   "When you write issue comments or chat replies, match the language of the user's or board's most recent substantive message unless they explicitly ask for a different language.",
   "",
+  "When an issue comment, done comment, or blocker comment cites visual evidence from a local screenshot/image path, attach the image with the Rudder CLI `--image <path>` option instead of leaving only the filesystem path in the text.",
+  "",
   "## Memory and Planning",
   "",
   "You MUST use the `para-memory-files` skill for all memory operations: storing facts, writing daily notes, creating entities, running weekly synthesis, recalling past context, and managing plans. The skill defines your three-layer memory system (knowledge graph, daily notes, tacit knowledge), the PARA folder structure, atomic fact schemas, memory decay rules, and recall/planning conventions.",