@rudderhq/cli 0.2.10-canary.2 → 0.2.10-canary.21

package/dist/index.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 };
 
 // ../packages/shared/dist/constants.js
-var ORGANIZATION_STATUSES, ORGANIZATION_INTELLIGENCE_PROFILE_PURPOSES, ORGANIZATION_INTELLIGENCE_PROFILE_STATUSES, DEPLOYMENT_MODES, DEPLOYMENT_EXPOSURES, AUTH_BASE_URL_MODES, AGENT_STATUSES, AGENT_RUNTIME_TYPES, AGENT_ROLES, AGENT_ICON_NAMES, AGENT_DICEBEAR_NOTIONISTS_ICON_PREFIX, AGENT_AVATAR_BACKGROUND_PRESET_IDS, ISSUE_STATUSES, ISSUE_PRIORITIES, CALENDAR_SOURCE_TYPES, CALENDAR_OWNER_TYPES, CALENDAR_VISIBILITIES, CALENDAR_SOURCE_STATUSES, CALENDAR_EVENT_KINDS, CALENDAR_EVENT_STATUSES, CALENDAR_SOURCE_MODES, CHAT_CONVERSATION_STATUSES, CHAT_ISSUE_CREATION_MODES, CHAT_MESSAGE_ROLES, CHAT_MESSAGE_KINDS, CHAT_MESSAGE_STATUSES, CHAT_CONTEXT_ENTITY_TYPES, GOAL_LEVELS, GOAL_STATUSES, PROJECT_STATUSES, ORGANIZATION_RESOURCE_KINDS, PROJECT_RESOURCE_ATTACHMENT_ROLES, AUTOMATION_STATUSES, AUTOMATION_CONCURRENCY_POLICIES, AUTOMATION_CATCH_UP_POLICIES, AUTOMATION_OUTPUT_MODES, AUTOMATION_TRIGGER_SIGNING_MODES, PROJECT_COLORS, APPROVAL_TYPES, SECRET_PROVIDERS, STORAGE_PROVIDERS, BILLING_TYPES, FINANCE_EVENT_KINDS, FINANCE_DIRECTIONS, FINANCE_UNITS, BUDGET_SCOPE_TYPES, BUDGET_METRICS, BUDGET_WINDOW_KINDS, BUDGET_INCIDENT_RESOLUTION_ACTIONS, INVITE_JOIN_TYPES, JOIN_REQUEST_TYPES, JOIN_REQUEST_STATUSES, PERMISSION_KEYS, PLUGIN_STATUSES, PLUGIN_CATEGORIES, PLUGIN_CAPABILITIES, PLUGIN_UI_SLOT_TYPES, PLUGIN_RESERVED_COMPANY_ROUTE_SEGMENTS, PLUGIN_LAUNCHER_PLACEMENT_ZONES, PLUGIN_LAUNCHER_ACTIONS, PLUGIN_LAUNCHER_BOUNDS, PLUGIN_LAUNCHER_RENDER_ENVIRONMENTS, PLUGIN_UI_SLOT_ENTITY_TYPES, PLUGIN_STATE_SCOPE_KINDS;
+var ORGANIZATION_STATUSES, ORGANIZATION_INTELLIGENCE_PROFILE_PURPOSES, ORGANIZATION_INTELLIGENCE_PROFILE_STATUSES, DEPLOYMENT_MODES, DEPLOYMENT_EXPOSURES, AUTH_BASE_URL_MODES, AGENT_STATUSES, AGENT_RUNTIME_TYPES, AGENT_ROLES, AGENT_ICON_NAMES, AGENT_DICEBEAR_NOTIONISTS_ICON_PREFIX, AGENT_AVATAR_BACKGROUND_PRESET_IDS, ISSUE_STATUSES, ISSUE_PRIORITIES, CALENDAR_SOURCE_TYPES, CALENDAR_OWNER_TYPES, CALENDAR_VISIBILITIES, CALENDAR_SOURCE_STATUSES, CALENDAR_EVENT_KINDS, CALENDAR_EVENT_STATUSES, CALENDAR_SOURCE_MODES, CHAT_CONVERSATION_STATUSES, CHAT_ISSUE_CREATION_MODES, CHAT_MESSAGE_ROLES, CHAT_MESSAGE_KINDS, CHAT_MESSAGE_STATUSES, CHAT_CONTEXT_ENTITY_TYPES, GOAL_LEVELS, GOAL_STATUSES, PROJECT_STATUSES, ORGANIZATION_RESOURCE_KINDS, ORGANIZATION_RESOURCE_SOURCE_TYPES, PROJECT_RESOURCE_ATTACHMENT_ROLES, AUTOMATION_STATUSES, AUTOMATION_CONCURRENCY_POLICIES, AUTOMATION_CATCH_UP_POLICIES, AUTOMATION_OUTPUT_MODES, AUTOMATION_TRIGGER_SIGNING_MODES, PROJECT_COLORS, APPROVAL_TYPES, SECRET_PROVIDERS, STORAGE_PROVIDERS, BILLING_TYPES, FINANCE_EVENT_KINDS, FINANCE_DIRECTIONS, FINANCE_UNITS, BUDGET_SCOPE_TYPES, BUDGET_METRICS, BUDGET_WINDOW_KINDS, BUDGET_INCIDENT_RESOLUTION_ACTIONS, INVITE_JOIN_TYPES, JOIN_REQUEST_TYPES, JOIN_REQUEST_STATUSES, PERMISSION_KEYS, PLUGIN_STATUSES, PLUGIN_CATEGORIES, PLUGIN_CAPABILITIES, PLUGIN_UI_SLOT_TYPES, PLUGIN_RESERVED_COMPANY_ROUTE_SEGMENTS, PLUGIN_LAUNCHER_PLACEMENT_ZONES, PLUGIN_LAUNCHER_ACTIONS, PLUGIN_LAUNCHER_BOUNDS, PLUGIN_LAUNCHER_RENDER_ENVIRONMENTS, PLUGIN_UI_SLOT_ENTITY_TYPES, PLUGIN_STATE_SCOPE_KINDS;
 var init_constants = __esm({
   "../packages/shared/dist/constants.js"() {
     "use strict";
@@ -150,6 +150,10 @@ var init_constants = __esm({
       "url",
       "connector_object"
     ];
+    ORGANIZATION_RESOURCE_SOURCE_TYPES = [
+      "external",
+      "library"
+    ];
     PROJECT_RESOURCE_ATTACHMENT_ROLES = [
       "working_set",
       "reference",
@@ -511,7 +515,7 @@ var init_budget = __esm({
 
 // ../packages/shared/dist/validators/organization.js
 import { z as z3 } from "zod";
-var logoAssetIdSchema, brandColorSchema, createOrganizationSchema, updateOrganizationSchema, updateOrganizationBrandingSchema, updateOrganizationWorkspaceFileSchema;
+var logoAssetIdSchema, brandColorSchema, createOrganizationSchema, updateOrganizationSchema, updateOrganizationBrandingSchema, updateOrganizationWorkspaceFileSchema, createOrganizationWorkspaceFileSchema, createOrganizationWorkspaceDirectorySchema, renameOrganizationWorkspaceEntrySchema, moveOrganizationWorkspaceEntrySchema;
 var init_organization = __esm({
   "../packages/shared/dist/validators/organization.js"() {
     "use strict";
@@ -543,6 +547,19 @@ var init_organization = __esm({
     updateOrganizationWorkspaceFileSchema = z3.object({
       content: z3.string()
     });
+    createOrganizationWorkspaceFileSchema = z3.object({
+      filePath: z3.string().trim().min(1).max(1e3),
+      content: z3.string().optional().default("")
+    });
+    createOrganizationWorkspaceDirectorySchema = z3.object({
+      directoryPath: z3.string().trim().min(1).max(1e3)
+    });
+    renameOrganizationWorkspaceEntrySchema = z3.object({
+      name: z3.string().trim().min(1).max(255)
+    });
+    moveOrganizationWorkspaceEntrySchema = z3.object({
+      destinationDirectoryPath: z3.string().trim().max(1e3).default("")
+    });
   }
 });
 
@@ -706,27 +723,66 @@ var init_organization_intelligence_profile = __esm({
 
 // ../packages/shared/dist/validators/resource.js
 import { z as z7 } from "zod";
-var organizationResourceKindSchema, projectResourceAttachmentRoleSchema, createOrganizationResourceSchema, updateOrganizationResourceSchema, projectResourceAttachmentInputSchema, updateProjectResourceAttachmentSchema, createProjectInlineResourceSchema;
+function isValidLibraryRelativePath(locator) {
+  const trimmed = locator.trim();
+  if (!trimmed)
+    return false;
+  if (LIBRARY_PATH_SCHEME_RE.test(trimmed))
+    return false;
+  if (trimmed.startsWith("/") || trimmed.startsWith("\\") || trimmed.startsWith("~"))
+    return false;
+  if (trimmed.includes("\\"))
+    return false;
+  const parts = trimmed.split("/");
+  if (!parts.every((part) => part.length > 0 && part !== "." && part !== ".."))
+    return false;
+  return !PROTECTED_LIBRARY_RESOURCE_ROOTS.has(parts[0] ?? "");
+}
+function validateLibraryResourceContract(value, ctx) {
+  if (value.sourceType !== "library")
+    return;
+  if (value.kind !== void 0 && value.kind !== "file" && value.kind !== "directory") {
+    ctx.addIssue({
+      code: z7.ZodIssueCode.custom,
+      message: "Library resources must be file or directory resources.",
+      path: ["kind"]
+    });
+  }
+  if (value.locator !== void 0 && !isValidLibraryRelativePath(value.locator)) {
+    ctx.addIssue({
+      code: z7.ZodIssueCode.custom,
+      message: "Library resource locator must be a normalized relative path inside the organization Library.",
+      path: ["locator"]
+    });
+  }
+}
+var organizationResourceKindSchema, organizationResourceSourceTypeSchema, projectResourceAttachmentRoleSchema, LIBRARY_PATH_SCHEME_RE, PROTECTED_LIBRARY_RESOURCE_ROOTS, createOrganizationResourceBaseSchema, createOrganizationResourceSchema, updateOrganizationResourceSchema, projectResourceAttachmentInputSchema, updateProjectResourceAttachmentSchema, createProjectInlineResourceSchema;
 var init_resource = __esm({
   "../packages/shared/dist/validators/resource.js"() {
     "use strict";
     init_constants();
     organizationResourceKindSchema = z7.enum(ORGANIZATION_RESOURCE_KINDS);
+    organizationResourceSourceTypeSchema = z7.enum(ORGANIZATION_RESOURCE_SOURCE_TYPES);
     projectResourceAttachmentRoleSchema = z7.enum(PROJECT_RESOURCE_ATTACHMENT_ROLES);
-    createOrganizationResourceSchema = z7.object({
+    LIBRARY_PATH_SCHEME_RE = /^[a-z][a-z0-9+.-]*:/i;
+    PROTECTED_LIBRARY_RESOURCE_ROOTS = /* @__PURE__ */ new Set(["agents", "artifacts", "plans", "skills"]);
+    createOrganizationResourceBaseSchema = z7.object({
       name: z7.string().min(1),
       kind: organizationResourceKindSchema,
+      sourceType: organizationResourceSourceTypeSchema.optional().default("external"),
       locator: z7.string().min(1),
       description: z7.string().optional().nullable(),
       metadata: z7.record(z7.unknown()).optional().nullable()
     });
+    createOrganizationResourceSchema = createOrganizationResourceBaseSchema.superRefine(validateLibraryResourceContract);
     updateOrganizationResourceSchema = z7.object({
       name: z7.string().min(1).optional(),
       kind: organizationResourceKindSchema.optional(),
+      sourceType: organizationResourceSourceTypeSchema.optional(),
       locator: z7.string().min(1).optional(),
       description: z7.string().optional().nullable(),
       metadata: z7.record(z7.unknown()).optional().nullable()
-    }).strict();
+    }).strict().superRefine(validateLibraryResourceContract);
     projectResourceAttachmentInputSchema = z7.object({
       resourceId: z7.string().uuid(),
       role: projectResourceAttachmentRoleSchema.optional(),
@@ -738,11 +794,11 @@ var init_resource = __esm({
       note: z7.string().optional().nullable(),
       sortOrder: z7.number().int().nonnegative().optional()
     }).strict();
-    createProjectInlineResourceSchema = createOrganizationResourceSchema.extend({
+    createProjectInlineResourceSchema = createOrganizationResourceBaseSchema.extend({
       role: projectResourceAttachmentRoleSchema.optional(),
       note: z7.string().optional().nullable(),
       sortOrder: z7.number().int().nonnegative().optional()
-    }).strict();
+    }).strict().superRefine(validateLibraryResourceContract);
   }
 });
 
@@ -877,6 +933,7 @@ var init_chat = __esm({
     chatIssueProposalSchema = z8.object({
       title: z8.string().trim().min(1).max(200),
       description: z8.string().trim().min(1).max(2e4),
+      status: z8.enum(ISSUE_STATUSES).optional().default("todo"),
       priority: z8.enum(["critical", "high", "medium", "low"]).optional().default("medium"),
       projectId: z8.string().uuid().optional().nullable(),
       goalId: z8.string().uuid().optional().nullable(),
@@ -1588,7 +1645,7 @@ 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, reportIssueCommitSchema, 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, createLibraryDocumentSchema, updateLibraryDocumentSchema, restoreLibraryDocumentRevisionSchema;
 var init_issue = __esm({
   "../packages/shared/dist/validators/issue.js"() {
     "use strict";
@@ -1697,6 +1754,22 @@ var init_issue = __esm({
       changeSummary: z14.string().trim().max(500).nullable().optional(),
       baseRevisionId: z14.string().uuid().nullable().optional()
     });
+    createLibraryDocumentSchema = z14.object({
+      title: z14.string().trim().max(200).nullable().optional(),
+      format: issueDocumentFormatSchema.optional().default("markdown"),
+      body: z14.string().max(524288).optional().default(""),
+      changeSummary: z14.string().trim().max(500).nullable().optional()
+    });
+    updateLibraryDocumentSchema = z14.object({
+      title: z14.string().trim().max(200).nullable().optional(),
+      format: issueDocumentFormatSchema.optional().default("markdown"),
+      body: z14.string().max(524288),
+      changeSummary: z14.string().trim().max(500).nullable().optional(),
+      baseRevisionId: z14.string().uuid().nullable().optional()
+    });
+    restoreLibraryDocumentRevisionSchema = z14.object({
+      changeSummary: z14.string().trim().max(500).nullable().optional()
+    });
   }
 });
 
@@ -1859,7 +1932,7 @@ var init_automation = __esm({
       status: z20.enum(AUTOMATION_STATUSES).optional().default("active"),
       concurrencyPolicy: z20.enum(AUTOMATION_CONCURRENCY_POLICIES).optional().default("coalesce_if_active"),
       catchUpPolicy: z20.enum(AUTOMATION_CATCH_UP_POLICIES).optional().default("skip_missed"),
-      outputMode: z20.enum(AUTOMATION_OUTPUT_MODES).optional().default("track_issue"),
+      outputMode: z20.enum(AUTOMATION_OUTPUT_MODES).optional().default("chat_output"),
       chatConversationId: z20.string().uuid().optional().nullable().default(null)
     });
     createAutomationSchema = automationBodySchema.superRefine((value, ctx) => {
@@ -2627,12 +2700,16 @@ var init_organization_skill_reference = __esm({
 });
 
 // ../packages/shared/dist/project-mentions.js
-var PROJECT_COLOR_VALUES;
+var AGENT_AVATAR_UUID_RE, AGENT_ASSET_ICON_RE, AGENT_DICEBEAR_NOTIONISTS_ICON_RE, PROJECT_COLOR_VALUES, AGENT_AVATAR_BACKGROUND_VALUES;
 var init_project_mentions = __esm({
   "../packages/shared/dist/project-mentions.js"() {
     "use strict";
     init_constants();
+    AGENT_AVATAR_UUID_RE = "[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}";
+    AGENT_ASSET_ICON_RE = new RegExp(`^asset:${AGENT_AVATAR_UUID_RE}(?:\\?bg=([a-z0-9-]+))?$`, "i");
+    AGENT_DICEBEAR_NOTIONISTS_ICON_RE = new RegExp(`^${AGENT_DICEBEAR_NOTIONISTS_ICON_PREFIX}${AGENT_AVATAR_UUID_RE}(?:\\?bg=([a-z0-9-]+))?$`, "i");
     PROJECT_COLOR_VALUES = new Set(PROJECT_COLORS);
+    AGENT_AVATAR_BACKGROUND_VALUES = new Set(AGENT_AVATAR_BACKGROUND_PRESET_IDS);
   }
 });
 
@@ -8147,41 +8224,41 @@ var RudderApiClient = class {
     this.runId = opts.runId?.trim() || void 0;
     this.recoverAuth = opts.recoverAuth;
   }
-  get(path22, opts) {
-    return this.request(path22, { method: "GET" }, opts);
+  get(path23, opts) {
+    return this.request(path23, { method: "GET" }, opts);
   }
-  post(path22, body, opts) {
-    return this.request(path22, {
+  post(path23, body, opts) {
+    return this.request(path23, {
       method: "POST",
       body: body === void 0 ? void 0 : JSON.stringify(body)
     }, opts);
   }
-  postForm(path22, form, opts) {
-    return this.request(path22, {
+  postForm(path23, form, opts) {
+    return this.request(path23, {
       method: "POST",
       body: form
     }, opts);
   }
-  patch(path22, body, opts) {
-    return this.request(path22, {
+  patch(path23, body, opts) {
+    return this.request(path23, {
       method: "PATCH",
       body: body === void 0 ? void 0 : JSON.stringify(body)
     }, opts);
   }
-  put(path22, body, opts) {
-    return this.request(path22, {
+  put(path23, body, opts) {
+    return this.request(path23, {
       method: "PUT",
       body: body === void 0 ? void 0 : JSON.stringify(body)
     }, opts);
   }
-  delete(path22, opts) {
-    return this.request(path22, { method: "DELETE" }, opts);
+  delete(path23, opts) {
+    return this.request(path23, { method: "DELETE" }, opts);
   }
   setApiKey(apiKey) {
     this.apiKey = apiKey?.trim() || void 0;
   }
-  async request(path22, init, opts, hasRetriedAuth = false) {
-    const url = buildUrl(this.apiBase, path22);
+  async request(path23, init, opts, hasRetriedAuth = false) {
+    const url = buildUrl(this.apiBase, path23);
     const headers = {
       accept: "application/json",
       ...toStringRecord(init.headers)
@@ -8211,13 +8288,13 @@ var RudderApiClient = class {
       const apiError = await toApiError(response);
       if (!hasRetriedAuth && this.recoverAuth) {
         const recoveredToken = await this.recoverAuth({
-          path: path22,
+          path: path23,
           method: String(init.method ?? "GET").toUpperCase(),
           error: apiError
         });
         if (recoveredToken) {
           this.setApiKey(recoveredToken);
-          return this.request(path22, init, opts, true);
+          return this.request(path23, init, opts, true);
         }
       }
       throw apiError;
@@ -8236,8 +8313,8 @@ function shouldAttachAgentContext(method) {
   const normalized = String(method ?? "GET").toUpperCase();
   return normalized !== "GET" && normalized !== "HEAD";
 }
-function buildUrl(apiBase, path22) {
-  const normalizedPath = path22.startsWith("/") ? path22 : `/${path22}`;
+function buildUrl(apiBase, path23) {
+  const normalizedPath = path23.startsWith("/") ? path23 : `/${path23}`;
   const [pathname, query] = normalizedPath.split("?");
   const url = new URL2(apiBase);
   url.pathname = `${url.pathname.replace(/\/+$/, "")}${pathname}`;
@@ -9008,13 +9085,13 @@ function buildImportSelectionCatalog(preview) {
       files: Array.from(organizationFiles).sort((left, right) => left.localeCompare(right))
     },
     projects: preview.manifest.projects.map((project) => {
-      const projectPath = normalizePortablePath(project.path);
-      const projectDir = projectPath.includes("/") ? projectPath.slice(0, projectPath.lastIndexOf("/")) : "";
+      const projectPath2 = normalizePortablePath(project.path);
+      const projectDir = projectPath2.includes("/") ? projectPath2.slice(0, projectPath2.lastIndexOf("/")) : "";
       return {
         key: project.slug,
         label: project.name,
         hint: project.slug,
-        files: collectEntityFiles(preview.files, projectPath, {
+        files: collectEntityFiles(preview.files, projectPath2, {
           excludePrefixes: projectDir ? [`${projectDir}/issues`] : []
         })
       };
@@ -10359,9 +10436,9 @@ var AGENT_CLI_CAPABILITIES = [
     id: "issue.documents.put",
     command: "rudder issue documents put <issue> <key> --body-file <path>",
     category: "issue",
-    description: "Create or update an issue document.",
+    description: "Legacy create or update of a DB-backed issue document; prefer `rudder library file put` for new docs.",
     mutating: true,
-    contract: "agent-v1",
+    contract: "compat",
     requiresOrgId: false,
     requiresAgentId: false,
     requiresRunId: false,
@@ -10379,6 +10456,90 @@ var AGENT_CLI_CAPABILITIES = [
     requiresRunId: false,
     attachesRunIdWhenAvailable: false
   },
+  {
+    id: "project.list",
+    command: "rudder project list --org-id <id>",
+    category: "project",
+    description: "List projects in an organization.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "project.get",
+    command: "rudder project get <project-id-or-shortname> [--org-id <id>]",
+    category: "project",
+    description: "Read one project by ID or shortname.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "project.create",
+    command: "rudder project create --org-id <id> --name <name>",
+    category: "project",
+    description: "Create a project in the organization.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "project.update",
+    command: "rudder project update <project-id-or-shortname> [--org-id <id>]",
+    category: "project",
+    description: "Update mutable project fields such as name, description, status, goals, lead agent, target date, color, or archivedAt.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: false,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
+  {
+    id: "library.file.list",
+    command: "rudder library file list [directory]",
+    category: "library",
+    description: "List path-based Library files and folders.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "library.file.get",
+    command: "rudder library file get <path>",
+    category: "library",
+    description: "Read one path-based Library file.",
+    mutating: false,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: false
+  },
+  {
+    id: "library.file.put",
+    command: "rudder library file put <path> --body-file <path>",
+    category: "library",
+    description: "Create or update one path-based Library file.",
+    mutating: true,
+    contract: "agent-v1",
+    requiresOrgId: true,
+    requiresAgentId: false,
+    requiresRunId: false,
+    attachesRunIdWhenAvailable: true
+  },
   {
     id: "issue.create",
     command: "rudder issue create --org-id <id> ... [--label-id <id> ...] [--label <name> ...]",
@@ -10539,8 +10700,10 @@ var AGENT_CLI_CAPABILITIES = [
 var CATEGORY_TITLES = {
   agent: "Agent",
   issue: "Issue",
+  project: "Project",
   approval: "Approval",
-  skill: "Skill"
+  skill: "Skill",
+  library: "Library"
 };
 function getAgentCliCapabilities() {
   return AGENT_CLI_CAPABILITIES.map((entry) => ({ ...entry }));
@@ -11160,6 +11323,96 @@ function formatIssueSearchMatch(match) {
   return `${match.field}${commentSuffix}: ${match.snippet}`;
 }
 
+// src/commands/client/project.ts
+init_dist();
+function registerProjectCommands(program) {
+  const project = program.command("project").description("Project operations");
+  addCommonClientOptions(
+    project.command("list").description(getAgentCliCapabilityById("project.list").description).option("-O, --org-id <id>", "Organization ID").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const rows = await ctx.api.get(`/api/orgs/${ctx.orgId}/projects`) ?? [];
+        printOutput(rows, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    project.command("get").description(getAgentCliCapabilityById("project.get").description).argument("<projectIdOrShortname>", "Project ID or shortname").option("-O, --org-id <id>", "Organization ID for shortname resolution").action(async (projectRef, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const row = await ctx.api.get(projectPath(projectRef, ctx.orgId));
+        printOutput(row, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    project.command("create").description(getAgentCliCapabilityById("project.create").description).option("-O, --org-id <id>", "Organization ID").requiredOption("--name <name>", "Project name").option("--description <text>", "Project description").option("--status <status>", "Project status").option("--goal-id <id>", "Primary goal ID").option("--goal-ids <csv>", "Comma-separated goal IDs").option("--lead-agent-id <id>", "Lead agent ID").option("--target-date <date>", "Target date").option("--color <value>", "Project color or supported gradient token").action(async (opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const payload = createProjectSchema.parse({
+          name: opts.name,
+          description: opts.description,
+          status: opts.status,
+          goalId: opts.goalId,
+          goalIds: parseCsv2(opts.goalIds),
+          leadAgentId: opts.leadAgentId,
+          targetDate: opts.targetDate,
+          color: opts.color
+        });
+        const created = await ctx.api.post(`/api/orgs/${ctx.orgId}/projects`, payload);
+        printOutput(created, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+  addCommonClientOptions(
+    project.command("update").description(getAgentCliCapabilityById("project.update").description).argument("<projectIdOrShortname>", "Project ID or shortname").option("-O, --org-id <id>", "Organization ID for shortname resolution").option("--name <name>", "Project name").option("--description <text>", "Project description").option("--status <status>", "Project status").option("--goal-id <id>", "Primary goal ID").option("--goal-ids <csv>", "Comma-separated goal IDs").option("--lead-agent-id <id>", "Lead agent ID").option("--target-date <date>", "Target date").option("--color <value>", "Project color or supported gradient token").option("--archived-at <iso8601|null>", "Set archivedAt timestamp or literal 'null'").action(async (projectRef, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts);
+        const payload = updateProjectSchema.parse({
+          name: opts.name,
+          description: opts.description,
+          status: opts.status,
+          goalId: opts.goalId,
+          goalIds: parseCsv2(opts.goalIds),
+          leadAgentId: opts.leadAgentId,
+          targetDate: opts.targetDate,
+          color: opts.color,
+          archivedAt: parseNullableOption(opts.archivedAt)
+        });
+        const updated = await ctx.api.patch(projectPath(projectRef, ctx.orgId), payload);
+        printOutput(updated, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: false }
+  );
+}
+function parseCsv2(value) {
+  if (!value) return void 0;
+  const items = value.split(",").map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+function parseNullableOption(value) {
+  if (value === void 0) return void 0;
+  return value === "null" ? null : value;
+}
+function projectPath(projectRef, orgId) {
+  const params = new URLSearchParams();
+  if (orgId) params.set("orgId", orgId);
+  const query = params.toString();
+  return `/api/projects/${encodeURIComponent(projectRef)}${query ? `?${query}` : ""}`;
+}
+
 // src/commands/client/agent.ts
 init_dist();
 
@@ -11195,7 +11448,10 @@ var RUDDER_AGENT_OPERATING_CONTRACT = [
   "- 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.",
+  '- Library-backed project resources use `sourceType: "library"`; their `locator` is a safe path relative to `$RUDDER_ORG_WORKSPACE_ROOT`, usually under `docs/`, so read them from `$RUDDER_ORG_WORKSPACE_ROOT/<locator>` when that root is available. Rudder does not use protected system roots such as `agents/`, `artifacts/`, `plans/`, or `skills/` as project Library resources.',
+  "- Project Context is explicit operator-curated context, not the whole knowledge boundary. When it is insufficient, inspect broader Library docs and org workspace know-how before concluding context is missing.",
+  "- Durable generated Markdown documents, plans, design docs, and decision notes should be written under `$RUDDER_ORG_WORKSPACE_ROOT/docs/` when available, preferably through `rudder library file put docs/<file>.md --body-file <path> --json`.",
+  "- Durable generated assets such as screenshots, images, mockups, reports, CSVs, handoff logs, and other user-visible non-doc 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.",
@@ -11609,7 +11865,7 @@ function registerAgentCommands(program) {
       try {
         const ctx = resolveCommandContext(opts);
         const snapshot = await ctx.api.post(`/api/agents/${agentId}/skills/sync`, {
-          desiredSkills: parseCsv2(opts.desiredSkills)
+          desiredSkills: parseCsv3(opts.desiredSkills)
         });
         printOutput(snapshot, { json: ctx.json });
       } catch (err) {
@@ -11731,7 +11987,7 @@ function registerAgentCommands(program) {
     { includeCompany: false }
   );
 }
-function parseCsv2(value) {
+function parseCsv3(value) {
   if (!value) return [];
   return value.split(",").map((entry) => entry.trim()).filter(Boolean);
 }
@@ -11817,7 +12073,7 @@ function registerApprovalCommands(program) {
           type: opts.type,
           payload: payloadJson,
           requestedByAgentId: opts.requestedByAgentId,
-          issueIds: parseCsv3(opts.issueIds)
+          issueIds: parseCsv4(opts.issueIds)
         });
         const created = await ctx.api.post(`/api/orgs/${ctx.orgId}/approvals`, payload);
         printOutput(created, { json: ctx.json });
@@ -11923,7 +12179,7 @@ async function readStdinText2() {
   }
   return Buffer.concat(chunks).toString("utf8");
 }
-function parseCsv3(value) {
+function parseCsv4(value) {
   if (!value) return void 0;
   const rows = value.split(",").map((v) => v.trim()).filter(Boolean);
   return rows.length > 0 ? rows : void 0;
@@ -11952,8 +12208,8 @@ function registerActivityCommands(program) {
         if (opts.entityType) params.set("entityType", opts.entityType);
         if (opts.entityId) params.set("entityId", opts.entityId);
         const query = params.toString();
-        const path22 = `/api/orgs/${ctx.orgId}/activity${query ? `?${query}` : ""}`;
-        const rows = await ctx.api.get(path22) ?? [];
+        const path23 = `/api/orgs/${ctx.orgId}/activity${query ? `?${query}` : ""}`;
+        const rows = await ctx.api.get(path23) ?? [];
         if (ctx.json) {
           printOutput(rows, { json: true });
           return;
@@ -12081,7 +12337,7 @@ function registerSkillCommands(program) {
       try {
         const ctx = resolveCommandContext(opts, { requireCompany: true });
         const payload = organizationSkillLocalScanRequestSchema.parse({
-          roots: parseCsv4(opts.roots)
+          roots: parseCsv5(opts.roots)
         });
         const result = await ctx.api.post(
           `/api/orgs/${ctx.orgId}/skills/scan-local`,
@@ -12099,8 +12355,8 @@ function registerSkillCommands(program) {
       try {
         const ctx = resolveCommandContext(opts, { requireCompany: true });
         const payload = organizationSkillProjectScanRequestSchema.parse({
-          projectIds: parseCsv4(opts.projectIds),
-          workspaceIds: parseCsv4(opts.workspaceIds)
+          projectIds: parseCsv5(opts.projectIds),
+          workspaceIds: parseCsv5(opts.workspaceIds)
         });
         const result = await ctx.api.post(
           `/api/orgs/${ctx.orgId}/skills/scan-projects`,
@@ -12114,19 +12370,111 @@ function registerSkillCommands(program) {
     { includeCompany: false }
   );
 }
-function parseCsv4(value) {
+function parseCsv5(value) {
   if (!value) return void 0;
   const rows = value.split(",").map((entry) => entry.trim()).filter(Boolean);
   return rows.length > 0 ? rows : void 0;
 }
 
+// src/commands/client/library.ts
+import { readFile as readFile6 } from "node:fs/promises";
+import path20 from "node:path";
+function registerLibraryCommands(program) {
+  const library = program.command("library").description("Library file operations");
+  const file = library.command("file").description("Path-based Library file operations");
+  addCommonClientOptions(
+    file.command("list").description(getAgentCliCapabilityById("library.file.list").description).argument("[directoryPath]", "Library directory path", "docs").action(async (directoryPath, opts) => {
+      try {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const search = new URLSearchParams();
+        const normalizedPath = directoryPath.trim();
+        if (normalizedPath) search.set("path", normalizedPath);
+        const query = search.toString();
+        const result = await ctx.api.get(
+          `/api/orgs/${ctx.orgId}/workspace/files${query ? `?${query}` : ""}`
+        );
+        printOutput(result, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: true }
+  );
+  addCommonClientOptions(
+    file.command("get").description(getAgentCliCapabilityById("library.file.get").description).argument("<filePath>", "Library file path").action(async (filePath, opts) => {
+      try {
+        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()}`
+        );
+        printOutput(result, { json: ctx.json });
+      } 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 {
+        const ctx = resolveCommandContext(opts, { requireCompany: true });
+        const body = await resolveBodyFileInput(opts.bodyFile);
+        const search = new URLSearchParams();
+        search.set("path", filePath.trim());
+        const updatePath = `/api/orgs/${ctx.orgId}/workspace/file?${search.toString()}`;
+        const updated = await ctx.api.patch(
+          updatePath,
+          { content: body },
+          { ignoreNotFound: true }
+        );
+        if (updated) {
+          printOutput(updated, { json: ctx.json });
+          return;
+        }
+        const created = await ctx.api.post(
+          `/api/orgs/${ctx.orgId}/workspace/file`,
+          { filePath: filePath.trim(), content: body }
+        );
+        printOutput(created, { json: ctx.json });
+      } catch (err) {
+        handleCommandError(err);
+      }
+    }),
+    { includeCompany: true }
+  );
+}
+async function resolveBodyFileInput(inputPath) {
+  if (process.argv.includes("--body")) {
+    throw new Error("--body was removed; write the body to a file and use --body-file <path> or --body-file - for stdin");
+  }
+  if (inputPath === void 0) {
+    throw new Error("Provide --body-file <path>; use --body-file - for stdin");
+  }
+  if (inputPath === "-") {
+    return readStdinText3();
+  }
+  const resolvedPath = path20.resolve(process.cwd(), inputPath);
+  return readFile6(resolvedPath, "utf8").catch((err) => {
+    throw new Error(`Unable to read --body-file ${inputPath}: ${err instanceof Error ? err.message : String(err)}`);
+  });
+}
+async function readStdinText3() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf8");
+}
+
 // src/config/data-dir.ts
 init_home();
-import path20 from "node:path";
+import path21 from "node:path";
 function applyDataDirOverride(options, support = {}) {
   const rawDataDir = options.dataDir?.trim();
   if (!rawDataDir) return null;
-  const resolvedDataDir = path20.resolve(expandHomePrefix(rawDataDir));
+  const resolvedDataDir = path21.resolve(expandHomePrefix(rawDataDir));
   process.env.RUDDER_HOME = resolvedDataDir;
   if (support.hasConfigOption) {
     const hasConfigOverride = Boolean(options.config?.trim()) || Boolean(process.env.RUDDER_CONFIG?.trim());
@@ -12150,16 +12498,16 @@ init_env();
 init_local_env();
 
 // src/commands/client/plugin.ts
-import path21 from "node:path";
+import path22 from "node:path";
 import pc15 from "picocolors";
 function resolvePackageArg(packageArg, isLocal) {
   if (!isLocal) return packageArg;
-  if (path21.isAbsolute(packageArg)) return packageArg;
+  if (path22.isAbsolute(packageArg)) return packageArg;
   if (packageArg.startsWith("~")) {
     const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
-    return path21.resolve(home, packageArg.slice(1).replace(/^[\\/]/, ""));
+    return path22.resolve(home, packageArg.slice(1).replace(/^[\\/]/, ""));
   }
-  return path21.resolve(process.cwd(), packageArg);
+  return path22.resolve(process.cwd(), packageArg);
 }
 function formatPlugin(p16) {
   const statusColor = p16.status === "ready" ? pc15.green(p16.status) : p16.status === "error" ? pc15.red(p16.status) : p16.status === "disabled" ? pc15.dim(p16.status) : pc15.yellow(p16.status);
@@ -12493,11 +12841,13 @@ function createProgram() {
   registerContextCommands(program);
   registerCompanyCommands(program);
   registerIssueCommands(program);
+  registerProjectCommands(program);
   registerAgentCommands(program);
   registerApprovalCommands(program);
   registerActivityCommands(program);
   registerDashboardCommands(program);
   registerSkillCommands(program);
+  registerLibraryCommands(program);
   registerLazyWorktreeCommands(program);
   registerPluginCommands(program);
   registerLazyBenchmarkCommands(program);