@copado/agentia-cli 1.0.0 → 1.1.0

package/dist/lib/setup-skills.js

@@ -1,4 +1,5 @@
 import {modules} from './runtime.js';
+const SETUP_RULES_MANAGED_MARKER = modules["setup-skills.js"]["SETUP_RULES_MANAGED_MARKER"]
 const SETUP_SKILL_MANAGED_MARKER = modules["setup-skills.js"]["SETUP_SKILL_MANAGED_MARKER"]
 const SETUP_SKILL_PACKS = modules["setup-skills.js"]["SETUP_SKILL_PACKS"]
 const SETUP_SKILL_TARGETS = modules["setup-skills.js"]["SETUP_SKILL_TARGETS"]
@@ -9,8 +10,10 @@ const resetSetupSkillsDepsForTests = modules["setup-skills.js"]["resetSetupSkill
 const resolveSelectedSkillPacks = modules["setup-skills.js"]["resolveSelectedSkillPacks"]
 const resolveSetupSkillTarget = modules["setup-skills.js"]["resolveSetupSkillTarget"]
 const resolveSetupSkillTargets = modules["setup-skills.js"]["resolveSetupSkillTargets"]
+const rulesDestinationForTarget = modules["setup-skills.js"]["rulesDestinationForTarget"]
+const runSetupRules = modules["setup-skills.js"]["runSetupRules"]
 const runSetupSkills = modules["setup-skills.js"]["runSetupSkills"]
 const setSetupSkillsDepsForTests = modules["setup-skills.js"]["setSetupSkillsDepsForTests"]
 const skillDirectoryForPack = modules["setup-skills.js"]["skillDirectoryForPack"]
 const skillRootDirectory = modules["setup-skills.js"]["skillRootDirectory"]
-export {SETUP_SKILL_MANAGED_MARKER, SETUP_SKILL_PACKS, SETUP_SKILL_TARGETS, formatSetupSkillPack, isSetupSkillPack, isSetupSkillTarget, resetSetupSkillsDepsForTests, resolveSelectedSkillPacks, resolveSetupSkillTarget, resolveSetupSkillTargets, runSetupSkills, setSetupSkillsDepsForTests, skillDirectoryForPack, skillRootDirectory};
+export {SETUP_RULES_MANAGED_MARKER, SETUP_SKILL_MANAGED_MARKER, SETUP_SKILL_PACKS, SETUP_SKILL_TARGETS, formatSetupSkillPack, isSetupSkillPack, isSetupSkillTarget, resetSetupSkillsDepsForTests, resolveSelectedSkillPacks, resolveSetupSkillTarget, resolveSetupSkillTargets, rulesDestinationForTarget, runSetupRules, runSetupSkills, setSetupSkillsDepsForTests, skillDirectoryForPack, skillRootDirectory};

package/dist/lib/setup-templates.js

@@ -1,13 +1,10 @@
 import {modules} from './runtime.js';
-const AGENTIA_AGENTS_END_MARKER = modules["setup-templates.js"]["AGENTIA_AGENTS_END_MARKER"]
-const AGENTIA_AGENTS_START_MARKER = modules["setup-templates.js"]["AGENTIA_AGENTS_START_MARKER"]
 const AGENTIA_APEX_TESTS_GITIGNORE_ENTRY = modules["setup-templates.js"]["AGENTIA_APEX_TESTS_GITIGNORE_ENTRY"]
 const AGENTIA_DIR_GITIGNORE_ENTRIES = modules["setup-templates.js"]["AGENTIA_DIR_GITIGNORE_ENTRIES"]
 const AGENTIA_GITIGNORE_ENTRIES = modules["setup-templates.js"]["AGENTIA_GITIGNORE_ENTRIES"]
 const AGENTIA_GITIGNORE_ENTRY = modules["setup-templates.js"]["AGENTIA_GITIGNORE_ENTRY"]
 const AGENTIA_IDEX_GITIGNORE_ENTRY = modules["setup-templates.js"]["AGENTIA_IDEX_GITIGNORE_ENTRY"]
-const BUNDLED_AGENTS_MD = modules["setup-templates.js"]["BUNDLED_AGENTS_MD"]
 const SAMPLE_QUALITY_GATES_UNIX = modules["setup-templates.js"]["SAMPLE_QUALITY_GATES_UNIX"]
 const SAMPLE_QUALITY_GATES_WINDOWS = modules["setup-templates.js"]["SAMPLE_QUALITY_GATES_WINDOWS"]
 const qualityGatesExplanation = modules["setup-templates.js"]["qualityGatesExplanation"]
-export {AGENTIA_AGENTS_END_MARKER, AGENTIA_AGENTS_START_MARKER, AGENTIA_APEX_TESTS_GITIGNORE_ENTRY, AGENTIA_DIR_GITIGNORE_ENTRIES, AGENTIA_GITIGNORE_ENTRIES, AGENTIA_GITIGNORE_ENTRY, AGENTIA_IDEX_GITIGNORE_ENTRY, BUNDLED_AGENTS_MD, SAMPLE_QUALITY_GATES_UNIX, SAMPLE_QUALITY_GATES_WINDOWS, qualityGatesExplanation};
+export {AGENTIA_APEX_TESTS_GITIGNORE_ENTRY, AGENTIA_DIR_GITIGNORE_ENTRIES, AGENTIA_GITIGNORE_ENTRIES, AGENTIA_GITIGNORE_ENTRY, AGENTIA_IDEX_GITIGNORE_ENTRY, SAMPLE_QUALITY_GATES_UNIX, SAMPLE_QUALITY_GATES_WINDOWS, qualityGatesExplanation};

package/dist/lib/template-types.js

@@ -3,6 +3,8 @@ const TEMPLATES_API_BASE = modules["template-types.js"]["TEMPLATES_API_BASE"]
 const TEMPLATE_API_NAME_REGEX = modules["template-types.js"]["TEMPLATE_API_NAME_REGEX"]
 const TEMPLATE_DISK_DIR = modules["template-types.js"]["TEMPLATE_DISK_DIR"]
 const TEMPLATE_LIST_TYPES = modules["template-types.js"]["TEMPLATE_LIST_TYPES"]
+const TEMPLATE_STEP_RESPONSE_ONLY_KEYS = modules["template-types.js"]["TEMPLATE_STEP_RESPONSE_ONLY_KEYS"]
+const TEMPLATE_UPSERT_RESPONSE_ONLY_KEYS = modules["template-types.js"]["TEMPLATE_UPSERT_RESPONSE_ONLY_KEYS"]
 const assertValidTemplateApiName = modules["template-types.js"]["assertValidTemplateApiName"]
 const defaultTemplateDiskPath = modules["template-types.js"]["defaultTemplateDiskPath"]
 const diskDocumentToTemplateInput = modules["template-types.js"]["diskDocumentToTemplateInput"]
@@ -18,4 +20,4 @@ const templateEndpoint = modules["template-types.js"]["templateEndpoint"]
 const templateToDiskDocument = modules["template-types.js"]["templateToDiskDocument"]
 const templatesEndpoint = modules["template-types.js"]["templatesEndpoint"]
 const writeTemplateDiskFile = modules["template-types.js"]["writeTemplateDiskFile"]
-export {TEMPLATES_API_BASE, TEMPLATE_API_NAME_REGEX, TEMPLATE_DISK_DIR, TEMPLATE_LIST_TYPES, assertValidTemplateApiName, defaultTemplateDiskPath, diskDocumentToTemplateInput, formatTemplateDetail, formatTemplateTable, normalizeTemplate, normalizeTemplateUpsertPayload, normalizeTemplatesList, normalizeTemplatesListPage, resolveTemplateOutputPath, templateDefaultsEndpoint, templateEndpoint, templateToDiskDocument, templatesEndpoint, writeTemplateDiskFile};
+export {TEMPLATES_API_BASE, TEMPLATE_API_NAME_REGEX, TEMPLATE_DISK_DIR, TEMPLATE_LIST_TYPES, TEMPLATE_STEP_RESPONSE_ONLY_KEYS, TEMPLATE_UPSERT_RESPONSE_ONLY_KEYS, assertValidTemplateApiName, defaultTemplateDiskPath, diskDocumentToTemplateInput, formatTemplateDetail, formatTemplateTable, normalizeTemplate, normalizeTemplateUpsertPayload, normalizeTemplatesList, normalizeTemplatesListPage, resolveTemplateOutputPath, templateDefaultsEndpoint, templateEndpoint, templateToDiskDocument, templatesEndpoint, writeTemplateDiskFile};

package/dist/lib/work-committed-metadata.js

@@ -0,0 +1,4 @@
+import {modules} from './runtime.js';
+const fetchWorkCommittedMetadata = modules["work-committed-metadata.js"]["fetchWorkCommittedMetadata"]
+const formatCommittedMetadataSection = modules["work-committed-metadata.js"]["formatCommittedMetadataSection"]
+export {fetchWorkCommittedMetadata, formatCommittedMetadataSection};

package/dist/lib/work-get.js

@@ -1,4 +1,5 @@
 import {modules} from './runtime.js';
 const fetchWorkItem = modules["work-get.js"]["fetchWorkItem"]
+const fetchWorkItemWithOptions = modules["work-get.js"]["fetchWorkItemWithOptions"]
 const fetchWorkItems = modules["work-get.js"]["fetchWorkItems"]
-export {fetchWorkItem, fetchWorkItems};
+export {fetchWorkItem, fetchWorkItemWithOptions, fetchWorkItems};

package/oclif.manifest.json

@@ -33,7 +33,7 @@
     "setup": {
       "aliases": [],
       "args": {},
-      "description": "Prepare this machine and the current project for Agentia. Guides CICD, AI, and CRT authentication, Cursor MCP, local quality gates, and AGENTS.md. Use --skip-auth to skip authentication and continue with Cursor MCP and project setup. Git is optional: .gitignore is updated only inside a repository, and generated files are not committed.",
+      "description": "Prepare this machine and the current project for Agentia. Guides CICD, AI, and CRT authentication, Cursor MCP, local quality gates, Agent Skills, agent rules, and removal of a legacy AGENTS.md section. Use --skip-auth to skip authentication and continue with Cursor MCP and project setup. Git is optional: .gitignore is updated only inside a repository, and generated files are not committed.",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --skip-auth"
@@ -3104,7 +3104,7 @@
           "required": false
         }
       },
-      "description": "Create a Copado cloud metadata commit for a user story. Preflights the story, submits POST /release/commit, and polls the job monitor by default. For local Git work, use git add/commit then `cicd work publish`. Permission and full-metadata selections belong on `cicd work publish`.",
+      "description": "Create a Copado cloud metadata commit for a user story.\nPreflights the story, submits POST /release/commit, and polls the job monitor by default.\nFor local Git work, use git add/commit then `cicd work publish`. Permission and full-metadata selections belong on `cicd work publish`.\n\nNOTE: Do not use this command along with local development (git operations, cicd work push/submit).",
       "examples": [
         "<%= config.bin %> <%= command.id %> --message \"Commit AccountService\" --metadata-name AccountService --metadata-type ApexClass --metadata-category SFDX --action Add",
         "<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --message \"Update Aura files\" --metadata-name accountEditor --metadata-type AuraDefinitionBundle --metadata-category SFDX --action SelectiveCommit --selection accountEditor/accountEditor.cmp --selection accountEditor/accountEditorController.js",
@@ -3177,7 +3177,7 @@
           "type": "option"
         },
         "metadata-category": {
-          "description": "Metadata category for simple input. Maps to change field c. For Salesforce metadata, always set SFDX so Copado stores c:SFDX. Omitting it omits c, and SFDX deploy steps log \"Salesforce changes not found.\" and skip the deploy while the job can still report Successful.",
+          "description": "Required metadata category for simple input. Maps to change field c. For Salesforce metadata, set SFDX so Copado stores c:SFDX. Without c:SFDX, SFDX deploy steps log \"Salesforce changes not found.\" and skip the deploy while the job can still report Successful.",
           "name": "metadata-category",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -3947,6 +3947,405 @@
         "update.js"
       ]
     },
+    "cicd:extension:create": {
+      "aliases": [],
+      "args": {},
+      "description": "Create or refresh a Copado extension manifest at copado/extension_manifest.json (scans copado/functions and copado/templates)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --name my-extension --version 1.0.0",
+        "<%= config.bin %> <%= command.id %> --name my-extension --overwrite --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "name": {
+          "char": "n",
+          "description": "Extension name (alphanumeric, underscore, hyphen)",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "overwrite": {
+          "description": "Overwrite an existing extension_manifest.json",
+          "name": "overwrite",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "version": {
+          "description": "Initial semver version written to the manifest (X.Y.Z)",
+          "name": "version",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:extension:create",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "extension",
+        "create.js"
+      ]
+    },
+    "cicd:extension:install": {
+      "aliases": [],
+      "args": {
+        "source": {
+          "description": "Git repository URL, owner/repo slug, or local directory path",
+          "name": "source",
+          "required": false
+        }
+      },
+      "description": "Install a Copado extension from a git URL or local folder: upsert functions and job templates via the CICD Gateway; deploy force-app with Salesforce CLI unless excluded",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> https://gitlab.com/org/my-ext.git --version 1.2.0 --yes",
+        "<%= config.bin %> <%= command.id %> ./my-extension --version 0.1.0 --exclude-sf-deploy --yes",
+        "<%= config.bin %> <%= command.id %> /tmp/my-extension.git --ref v0.1.0 --sf-alias destOrg --yes",
+        "<%= config.bin %> <%= command.id %> ./my-extension --version 1.2.0 --exclude-sf-deploy --yes --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry-run": {
+          "description": "Materialize and validate, print the install plan, but do not upsert or deploy",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "exclude-sf-deploy": {
+          "description": "Skip Salesforce metadata deploy even when force-app is present",
+          "name": "exclude-sf-deploy",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "ignore-unknown-assets": {
+          "description": "Ignore unsupported manifest asset arrays instead of failing",
+          "name": "ignore-unknown-assets",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "ref": {
+          "description": "Git ref to install (tag, branch, or commit). Prefer --version for semver tags.",
+          "name": "ref",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "sf-alias": {
+          "description": "Salesforce CLI org alias or username for force-app deploy (required when force-app is present unless --exclude-sf-deploy)",
+          "name": "sf-alias",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source": {
+          "description": "Git URL or local path (alternative to the positional source argument)",
+          "name": "source",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "description": "Deprecated alias of --source",
+          "hidden": true,
+          "name": "url",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version": {
+          "description": "Semver version to install (checks out tag vX.Y.Z)",
+          "name": "version",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip the interactive confirmation prompt (required for non-interactive / --json installs that are not --dry-run)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:extension:install",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "extension",
+        "install.js"
+      ]
+    },
+    "cicd:extension:package": {
+      "aliases": [],
+      "args": {},
+      "description": "Validate a Copado extension for publish (requires semver version; optional --version bump)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --version 1.2.0 --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "version": {
+          "description": "Set or bump the manifest semver version before validating",
+          "name": "version",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:extension:package",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "extension",
+        "package.js"
+      ]
+    },
+    "cicd:extension:publish": {
+      "aliases": [],
+      "args": {},
+      "description": "Push the current extension commit and create an annotated semver git tag (vX.Y.Z) for install pinning",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --version 1.2.0 --remote origin --json",
+        "<%= config.bin %> <%= command.id %> --version 0.1.0 --local --force"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "allow-dirty": {
+          "description": "Allow publish with a dirty working tree",
+          "name": "allow-dirty",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "force": {
+          "description": "Recreate the local tag and push even if the tag already exists",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "local": {
+          "description": "Create the annotated tag locally without pushing to a remote (offline / local e2e)",
+          "name": "local",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "remote": {
+          "description": "Git remote to push (default origin; ignored with --local)",
+          "name": "remote",
+          "default": "origin",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version": {
+          "description": "Require this semver in the manifest before tagging (writes it only if already committed; fails if the bump is uncommitted)",
+          "name": "version",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:extension:publish",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "extension",
+        "publish.js"
+      ]
+    },
+    "cicd:extension:uninstall": {
+      "aliases": [],
+      "args": {
+        "source": {
+          "description": "Git repository URL, owner/repo slug, or local directory path",
+          "name": "source",
+          "required": false
+        }
+      },
+      "description": "Uninstall a Copado extension by deleting the functions and job templates listed in its manifest from the authenticated Copado org",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> ./my-extension --version 0.1.0 --yes",
+        "<%= config.bin %> <%= command.id %> https://gitlab.com/org/my-ext.git --ref v0.1.0 --yes --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry-run": {
+          "description": "Show which assets would be deleted without calling the gateway",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "ref": {
+          "description": "Git ref to read the manifest from",
+          "name": "ref",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "source": {
+          "description": "Git URL or local path (alternative to the positional source argument)",
+          "name": "source",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "version": {
+          "description": "Semver version whose tag (vX.Y.Z) supplies the manifest",
+          "name": "version",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip the interactive confirmation prompt (required for non-interactive / --json uninstalls that are not --dry-run)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:extension:uninstall",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "extension",
+        "uninstall.js"
+      ]
+    },
+    "cicd:extension:validate": {
+      "aliases": [],
+      "args": {},
+      "description": "Validate a Copado extension manifest against copado/functions and copado/templates on disk",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --require-version --json"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "require-version": {
+          "description": "Require a semver version field (needed for package/publish)",
+          "name": "require-version",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "cicd:extension:validate",
+      "pluginAlias": "@copado/agentia-cli",
+      "pluginName": "@copado/agentia-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "experimental": true,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cicd",
+        "extension",
+        "validate.js"
+      ]
+    },
     "cicd:function:defaults": {
       "aliases": [],
       "args": {},
@@ -7624,7 +8023,7 @@
           "type": "option"
         },
         "metadata-category": {
-          "description": "Metadata category for simple input. Maps to change field c. For Salesforce metadata, always set SFDX so Copado stores c:SFDX. Omitting it omits c, and SFDX deploy steps log \"Salesforce changes not found.\" and skip the deploy while the job can still report Successful.",
+          "description": "Required metadata category for simple input. Maps to change field c. For Salesforce metadata, set SFDX so Copado stores c:SFDX. Without c:SFDX, SFDX deploy steps log \"Salesforce changes not found.\" and skip the deploy while the job can still report Successful.",
           "name": "metadata-category",
           "hasDynamicHelp": false,
           "multiple": false,
@@ -8122,6 +8521,8 @@
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU",
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --json",
+        "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --committed-metadata",
+        "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --committed-metadata --json",
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --user-stories-ahead-behind",
         "<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --user-stories-ahead-behind --json"
       ],
@@ -8133,6 +8534,12 @@
           "allowNo": false,
           "type": "boolean"
         },
+        "committed-metadata": {
+          "description": "Also include the Story committed metadata list in output",
+          "name": "committed-metadata",
+          "allowNo": false,
+          "type": "boolean"
+        },
         "user-stories-ahead-behind": {
           "description": "When the user story has a pipeline and source environment, compare user stories ahead of and behind the next pipeline environment",
           "name": "user-stories-ahead-behind",
@@ -9092,7 +9499,7 @@
           "type": "boolean"
         },
         "force": {
-          "description": "Replace conflicting unmanaged Agentia skill files",
+          "description": "Replace conflicting unmanaged Agentia skill or rules files",
           "name": "force",
           "allowNo": false,
           "type": "boolean"
@@ -9179,7 +9586,7 @@
           "type": "boolean"
         },
         "force": {
-          "description": "Replace conflicting unmanaged Agentia skill files",
+          "description": "Replace conflicting unmanaged Agentia skill or rules files",
           "name": "force",
           "allowNo": false,
           "type": "boolean"
@@ -20441,5 +20848,5 @@
       ]
     }
   },
-  "version": "1.0.0"
+  "version": "1.1.0"
 }

package/package.json

@@ -235,7 +235,7 @@
     }
   },
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "x-agentia-protected-build": true,
   "x-agentia-protected-files": [
     "dist/lib/runtime.js"

package/templates/rules/cursor/agentia.mdc

@@ -0,0 +1,29 @@
+---
+description: Use Agentia for Copado CICD, Testing, AI, and advanced pipeline workflows
+alwaysApply: false
+---
+
+<!-- Agentia managed rules: agentia setup skills -->
+
+# Agentia CLI
+
+Use Agentia to manage Copado work items. Prefer registered Agentia MCP tools; otherwise use the CLI with `--json`.
+
+Authentication must be configured before operational commands. Never print credentials, tokens, or unmasked environment variables.
+
+## Copado workflow
+
+`list → get → set → (implement & git commit) → test → publish → submit [--done|--deploy]`
+
+Read records before changing them and use IDs returned by Copado. Do not skip `work set` before coding; use one story per feature branch. Keep the working tree clean for lifecycle commands, and confirm promotion/deployment intent before `done`.
+
+## Agent Skills
+
+Load exactly one copy of each applicable installed Agentia skill:
+
+- `agentia-cicd`: Copado stories, commits, publish, submit, done, promotions, jobs, Functions, Job Templates, environments, pipelines, Slack notification configure, and data.
+- `agentia-testing`: Copado Robotic Testing operations.
+- `agentia-ai`: Copado AI operations.
+- `agentia-adv`: advanced pipeline workflows.
+
+Project-specific instructions take precedence over managed Agentia skills. Refresh managed skills with `agentia setup skills update`; do not hand-edit managed files.

package/templates/skills/agentia/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: agentia
+description: Use when working with Agentia or Copado CICD, Robotic Testing, AI, pipelines, user stories, commits, promotions, deployments, jobs, environments, credentials, or data templates.
+---
+
+<!-- Agentia managed skill file: agentia setup skills -->
+
+# Agentia CLI
+
+Use Agentia to manage Copado work items. Prefer registered Agentia MCP tools; otherwise use the CLI with `--json`.
+
+Authentication must be configured before operational commands. Never print credentials, tokens, or unmasked environment variables.
+
+## Copado workflow
+
+`list → get → set → (implement & git commit) → test → publish → submit [--done|--deploy]`
+
+Read records before changing them and use IDs returned by Copado. Do not skip `work set` before coding; use one story per feature branch. Keep the working tree clean for lifecycle commands, and confirm promotion/deployment intent before `done`.
+
+## Agent Skills
+
+Use the applicable installed domain skill for detailed instructions:
+
+- `agentia-cicd`: Copado stories, commits, publish, submit, done, promotions, jobs, Functions, Job Templates, environments, pipelines, Slack notification configure, and data.
+- `agentia-testing`: Copado Robotic Testing operations.
+- `agentia-ai`: Copado AI operations.
+- `agentia-adv`: advanced pipeline workflows.
+
+Project-specific instructions take precedence over managed Agentia skills. Refresh managed skills with `agentia setup skills update`; do not hand-edit managed files.

package/templates/skills/agentia-cicd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agentia-cicd
-description: Use this skill when managing Copado CICD work with the Agentia CLI or Agentia MCP tools: user stories (including current/active story context), cloud commit/promote, work publish/submit/done, promotion runs and conflicts, job executions, Copado Functions, Job Templates, environments, credentials, pipelines, stages, Slack pipeline notification subscriptions, and release data templates. Use it whenever the user asks an agent to operate Copado CICD from a terminal, IDE, or headless workflow.
+description: Use this skill when managing Copado CICD work with the Agentia CLI or Agentia MCP tools: user stories (including current/active story context), cloud commit/promote, work publish/submit/done, promotion runs and conflicts, job executions, Copado Functions, Job Templates, git-hosted CICD extensions, environments, credentials, pipelines, stages, Slack pipeline notification subscriptions, and release data templates. Use it whenever the user asks an agent to operate Copado CICD from a terminal, IDE, or headless workflow.
 ---
 
 <!-- Agentia managed skill file: agentia setup skills -->
@@ -24,6 +24,7 @@ Prefer Agentia MCP tools when they are available and match the task. Use CLI exa
 - Promotion lookup, run, resume, merge conflicts, and story-centric promotion: [references/promotions.md](references/promotions.md)
 - Copado JobExecution lookup, actions, logs, and monitoring: [references/jobs.md](references/jobs.md)
 - Copado Functions lifecycle, remote run/results, and local Docker run: [references/functions.md](references/functions.md)
+- Git-hosted Copado CICD extensions (`cicd extension`, experimental): [references/extensions.md](references/extensions.md)
 - Copado Job Templates (`cicd template`, not data templates): [references/templates.md](references/templates.md)
 - Copado environments, environment credentials, and browser authentication: [references/environments-and-credentials.md](references/environments-and-credentials.md)
 - Pipelines, environment connections, stages, and stage connections: [references/pipelines.md](references/pipelines.md)
@@ -38,6 +39,7 @@ Prefer Agentia MCP tools when they are available and match the task. Use CLI exa
 - For local project work, keep the tracked working tree clean before commands that require it: `work set`, `work publish`, and `work submit`. If `work set` returns `status: "warning"`, show the message and do not assume a feature branch was created; branch keys are cleared and the work item id/name/title are still recorded in config.user.json.
 - Treat `cicd job` as Copado CICD JobExecution. It is different from CRT `testing job`.
 - Treat `cicd function` as Copado Function definitions and runs. It is different from JobExecution (`cicd job`) and Job Templates (`cicd template`).
+- Treat `cicd extension` as experimental git-hosted packaging of Functions/Templates (plus optional `force-app`). It is different from per-asset `cicd function` / `cicd template` upserts.
 - Treat `cicd template` as Copado Job Templates via `/release/jobs/templates`. It is different from Release Data Templates (`cicd data template`).
 - Treat `cicd work test` as local quality gates (`--local` is the default). It is different from CRT `testing test run`.
 - Treat `cicd work test apex` as the Apex test runner that local quality gates (`.agentia_quality_gates.*`) usually call. An empty `--apex-test-classes` list skips Salesforce CLI. It can also be invoked directly. It is different from CRT.