@rudderhq/cli 0.3.4-canary.4 → 0.3.4-canary.6

package/dist/index.js

@@ -1649,12 +1649,12 @@ var init_project = __esm({
 
 // ../packages/shared/dist/validators/issue.js
 import { z as z14 } from "zod";
-var executionWorkspaceStrategySchema2, issueExecutionWorkspaceSettingsSchema, issueAssigneeAdapterOverridesSchema, createIssueSchema, createIssueLabelSchema, updateIssueLabelSchema, updateIssueSchema, reorderIssueSchema, checkoutIssueSchema, addIssueCommentSchema, updateIssueCommentSchema, reportIssueCommitSchema, linkIssueApprovalSchema, createIssueAttachmentMetadataSchema, createIssueWorkspaceAttachmentSchema, ISSUE_DOCUMENT_FORMATS, issueDocumentFormatSchema, issueDocumentKeySchema, upsertIssueDocumentSchema, createLibraryDocumentSchema, updateLibraryDocumentSchema, restoreLibraryDocumentRevisionSchema;
+var runWorkspaceStrategySchema, issueRunWorkspaceSettingsSchema, issueAssigneeAdapterOverridesSchema, createIssueSchema, createIssueLabelSchema, updateIssueLabelSchema, updateIssueSchema, reorderIssueSchema, checkoutIssueSchema, addIssueCommentSchema, updateIssueCommentSchema, reportIssueCommitSchema, linkIssueApprovalSchema, createIssueAttachmentMetadataSchema, createIssueWorkspaceAttachmentSchema, ISSUE_DOCUMENT_FORMATS, issueDocumentFormatSchema, issueDocumentKeySchema, upsertIssueDocumentSchema, createLibraryDocumentSchema, updateLibraryDocumentSchema, restoreLibraryDocumentRevisionSchema;
 var init_issue = __esm({
   "../packages/shared/dist/validators/issue.js"() {
     "use strict";
     init_constants();
-    executionWorkspaceStrategySchema2 = z14.object({
+    runWorkspaceStrategySchema = z14.object({
       type: z14.enum(["project_primary", "git_worktree", "adapter_managed", "cloud_sandbox"]).optional(),
       baseRef: z14.string().optional().nullable(),
       branchTemplate: z14.string().optional().nullable(),
@@ -1662,9 +1662,9 @@ var init_issue = __esm({
       provisionCommand: z14.string().optional().nullable(),
       teardownCommand: z14.string().optional().nullable()
     }).strict();
-    issueExecutionWorkspaceSettingsSchema = z14.object({
+    issueRunWorkspaceSettingsSchema = z14.object({
       mode: z14.enum(["inherit", "shared_workspace", "isolated_workspace", "operator_branch", "reuse_existing", "agent_default"]).optional(),
-      workspaceStrategy: executionWorkspaceStrategySchema2.optional().nullable(),
+      workspaceStrategy: runWorkspaceStrategySchema.optional().nullable(),
       workspaceRuntime: z14.record(z14.unknown()).optional().nullable()
     }).strict();
     issueAssigneeAdapterOverridesSchema = z14.object({
@@ -1687,7 +1687,19 @@ var init_issue = __esm({
       requestDepth: z14.number().int().nonnegative().optional().default(0),
       billingCode: z14.string().optional().nullable(),
       assigneeAgentRuntimeOverrides: issueAssigneeAdapterOverridesSchema.optional().nullable(),
+      runWorkspaceId: z14.string().uuid().optional().nullable(),
+      runWorkspacePreference: z14.enum([
+        "inherit",
+        "shared_workspace",
+        "isolated_workspace",
+        "operator_branch",
+        "reuse_existing",
+        "agent_default"
+      ]).optional().nullable(),
+      runWorkspaceSettings: issueRunWorkspaceSettingsSchema.optional().nullable(),
+      /** @deprecated Use runWorkspaceId. */
       executionWorkspaceId: z14.string().uuid().optional().nullable(),
+      /** @deprecated Use runWorkspacePreference. */
       executionWorkspacePreference: z14.enum([
         "inherit",
         "shared_workspace",
@@ -1696,7 +1708,8 @@ var init_issue = __esm({
         "reuse_existing",
         "agent_default"
       ]).optional().nullable(),
-      executionWorkspaceSettings: issueExecutionWorkspaceSettingsSchema.optional().nullable(),
+      /** @deprecated Use runWorkspaceSettings. */
+      executionWorkspaceSettings: issueRunWorkspaceSettingsSchema.optional().nullable(),
       labelIds: z14.array(z14.string().uuid()).optional()
     });
     createIssueLabelSchema = z14.object({
@@ -1814,6 +1827,8 @@ var init_work_product = __esm({
     ]);
     createIssueWorkProductSchema = z15.object({
       projectId: z15.string().uuid().optional().nullable(),
+      runWorkspaceId: z15.string().uuid().optional().nullable(),
+      /** @deprecated Use runWorkspaceId. */
       executionWorkspaceId: z15.string().uuid().optional().nullable(),
       runtimeServiceId: z15.string().uuid().optional().nullable(),
       type: issueWorkProductTypeSchema,
@@ -1835,19 +1850,19 @@ var init_work_product = __esm({
 
 // ../packages/shared/dist/validators/execution-workspace.js
 import { z as z16 } from "zod";
-var executionWorkspaceStatusSchema, updateExecutionWorkspaceSchema;
+var runWorkspaceStatusSchema, updateRunWorkspaceSchema;
 var init_execution_workspace = __esm({
   "../packages/shared/dist/validators/execution-workspace.js"() {
     "use strict";
-    executionWorkspaceStatusSchema = z16.enum([
+    runWorkspaceStatusSchema = z16.enum([
       "active",
       "idle",
       "in_review",
       "archived",
       "cleanup_failed"
     ]);
-    updateExecutionWorkspaceSchema = z16.object({
-      status: executionWorkspaceStatusSchema.optional(),
+    updateRunWorkspaceSchema = z16.object({
+      status: runWorkspaceStatusSchema.optional(),
       cleanupEligibleAt: z16.string().datetime().optional().nullable(),
       cleanupReason: z16.string().optional().nullable(),
       metadata: z16.record(z16.unknown()).optional().nullable()
@@ -2727,7 +2742,7 @@ var init_project_mentions = __esm({
 });
 
 // ../packages/shared/dist/issue-activity.js
-var ISSUE_UPDATE_ACTIVITY_METADATA_KEYS, LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELDS, ISSUE_UPDATE_ACTIVITY_METADATA_KEY_SET, LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELD_SET;
+var ISSUE_UPDATE_ACTIVITY_METADATA_KEYS, LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELDS, INTERNAL_ISSUE_UPDATE_ACTIVITY_FIELDS, ISSUE_UPDATE_ACTIVITY_METADATA_KEY_SET, LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELD_SET, INTERNAL_ISSUE_UPDATE_ACTIVITY_FIELD_SET;
 var init_issue_activity = __esm({
   "../packages/shared/dist/issue-activity.js"() {
     "use strict";
@@ -2743,8 +2758,19 @@ var init_issue_activity = __esm({
       "normalizedReason"
     ];
     LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELDS = ["description", "title"];
+    INTERNAL_ISSUE_UPDATE_ACTIVITY_FIELDS = [
+      "executionWorkspaceId",
+      "executionWorkspacePreference",
+      "executionWorkspaceSettings",
+      "currentExecutionWorkspace",
+      "runWorkspaceId",
+      "runWorkspacePreference",
+      "runWorkspaceSettings",
+      "currentRunWorkspace"
+    ];
     ISSUE_UPDATE_ACTIVITY_METADATA_KEY_SET = new Set(ISSUE_UPDATE_ACTIVITY_METADATA_KEYS);
     LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELD_SET = new Set(LOW_SIGNAL_ISSUE_UPDATE_ACTIVITY_FIELDS);
+    INTERNAL_ISSUE_UPDATE_ACTIVITY_FIELD_SET = new Set(INTERNAL_ISSUE_UPDATE_ACTIVITY_FIELDS);
   }
 });
 
@@ -10693,7 +10719,7 @@ var AGENT_CLI_CAPABILITIES = [
     id: "issue.documents.put",
     command: "rudder issue documents put <issue> <key> --body-file <path>",
     category: "issue",
-    description: "Legacy create or update of a DB-backed issue document; prefer `rudder library file put` for durable project files.",
+    description: "Legacy create or update of a DB-backed issue document; prefer local project Library files under `$RUDDER_PROJECT_LIBRARY_ROOT` for durable project files.",
     mutating: true,
     contract: "compat",
     requiresOrgId: false,
@@ -10765,7 +10791,7 @@ var AGENT_CLI_CAPABILITIES = [
     id: "library.file.list",
     command: "rudder library file list [directory]",
     category: "library",
-    description: "List path-based Library files and folders.",
+    description: "List Library files and folders; file rows include `libraryEntryId` when a strong reference can be generated.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: true,
@@ -10777,7 +10803,31 @@ var AGENT_CLI_CAPABILITIES = [
     id: "library.file.get",
     command: "rudder library file get <path>",
     category: "library",
-    description: "Read one path-based Library file.",
+    description: "Fallback read when local filesystem access is unavailable; JSON includes `mentionHref` and `markdownLink`.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "library.file.ref",
+    command: "rudder library file ref <path>",
+    category: "library",
+    description: "Return the stable Markdown reference for one Library file without printing file content.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "library.file.link",
+    command: "rudder library file link <path>",
+    category: "library",
+    description: "Compatibility alias for `rudder library file ref <path>`.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: true,
@@ -10789,7 +10839,7 @@ var AGENT_CLI_CAPABILITIES = [
     id: "library.file.put",
     command: "rudder library file put <path> --body-file <path>",
     category: "library",
-    description: "Create or update one path-based Library file.",
+    description: "Fallback create/update when local filesystem access is unavailable; JSON includes `mentionHref` and `markdownLink`.",
     mutating: true,
     contract: "agent-v1",
     requiresOrgId: true,
@@ -11706,10 +11756,14 @@ var RUDDER_AGENT_OPERATING_CONTRACT = [
   "- Personal skills live under `$AGENT_HOME/skills`.",
   "- Shared organization workspace root lives under `$RUDDER_ORG_WORKSPACE_ROOT`.",
   "- Shared organization skills live under `$RUDDER_ORG_SKILLS_DIR`.",
-  '- Library-backed project resources use `sourceType: "library"`; their `locator` points into `library:projects/<project-name>/`.',
+  "- Project Library root lives under `$RUDDER_PROJECT_LIBRARY_ROOT` when the run has project context.",
+  "- Project Library locator lives in `$RUDDER_PROJECT_LIBRARY_PATH` when the run has project context, for example `projects/<project-key>`.",
+  '- Library-backed project resources use `sourceType: "library"`; their `locator` points into `library:projects/<project-key>/`.',
   "- Project Context is explicit operator-curated context, not the whole knowledge boundary. When it is insufficient, inspect broader Library and org workspace know-how before concluding context is missing.",
-  "- Durable generated project work files should be written under `library:projects/<project-name>/`.",
-  "- When you create or update a durable Library file, always include a user-visible Markdown link to that file in your final chat reply or issue comment. Use `library-file://file?p=<url-encoded-relative-path>&t=<url-encoded-title>` for Library file links.",
+  "- In local trusted runs, durable generated project work files should be written directly under `$RUDDER_PROJECT_LIBRARY_ROOT` with normal filesystem tools.",
+  "- `library:projects/<project-key>/...` is the Rudder product locator for those files, not the Markdown link syntax and not a reason to route ordinary local edits through the CLI.",
+  '- When you create or update a durable Library file, always include a user-visible Markdown link to that file in your final chat reply or issue comment. Use `rudder library file ref "$RUDDER_PROJECT_LIBRARY_PATH/<relative-file>" --json` and paste the returned `markdownLink`; do not pass the absolute `$RUDDER_PROJECT_LIBRARY_ROOT/...` path to `ref`, and do not hand-write `library-entry://...` or `library-file://...` links.',
+  '- If `$RUDDER_PROJECT_LIBRARY_ROOT` is unset or inaccessible, use `rudder library file get/put "$RUDDER_PROJECT_LIBRARY_PATH/<relative-file>"` as the remote or restricted runtime fallback.',
   "- Use `/tmp` only for transient scratch files and temporary verification files; 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.",
   "",
@@ -12703,9 +12757,27 @@ function parseCsv5(value) {
 // src/commands/client/library.ts
 import { readFile as readFile6 } from "node:fs/promises";
 import path20 from "node:path";
+function toLibraryFileLinkResult(detail) {
+  return {
+    filePath: detail.filePath,
+    libraryEntryId: detail.libraryEntryId,
+    mentionHref: detail.mentionHref,
+    markdownLink: detail.markdownLink
+  };
+}
+async function printLibraryFileReference(filePath, opts) {
+  const ctx = resolveCommandContext(opts, { requireCompany: true });
+  const search = new URLSearchParams();
+  search.set("path", filePath.trim());
+  const result = await ctx.api.get(
+    `/api/orgs/${ctx.orgId}/workspace/file?${search.toString()}`
+  );
+  if (!result) throw new Error("Library file not found");
+  printOutput(toLibraryFileLinkResult(result), { json: ctx.json });
+}
 function registerLibraryCommands(program) {
   const library = program.command("library").description("Library file operations");
-  const file = library.command("file").description("Path-based Library file operations");
+  const file = library.command("file").description("Library file operations");
   addCommonClientOptions(
     file.command("list").description(getAgentCliCapabilityById("library.file.list").description).argument("[directoryPath]", "Library directory path", "projects").action(async (directoryPath, opts) => {
       try {
@@ -12740,6 +12812,26 @@ function registerLibraryCommands(program) {
     }),
     { includeCompany: true }
   );
+  addCommonClientOptions(
+    file.command("link").description(getAgentCliCapabilityById("library.file.link").description).argument("<filePath>", "Library file path").action(async (filePath, opts) => {
+      try {
+        await printLibraryFileReference(filePath, opts);
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: true }
+  );
+  addCommonClientOptions(
+    file.command("ref").description(getAgentCliCapabilityById("library.file.ref").description).argument("<filePath>", "Library file path").action(async (filePath, opts) => {
+      try {
+        await printLibraryFileReference(filePath, opts);
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: true }
+  );
   addCommonClientOptions(
     file.command("put").description(getAgentCliCapabilityById("library.file.put").description).argument("<filePath>", "Library file path").option("--body-file <path>", "Read file content from a file, or '-' for stdin").action(async (filePath, opts) => {
       try {