@copado/agentia-cli 1.1.0 → 1.2.0

package/dist/commands/cicd/pipeline/quality-gate/get.js

@@ -0,0 +1,32 @@
+import { Args, Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { assertRequired } from '../../../../lib/assert.js';
+import { fetchPipelineQualityGate } from '../../../../lib/pipeline-quality-gate-ops.js';
+import { formatPipelineQualityGateDetail, } from '../../../../lib/pipeline-quality-gate-types.js';
+export default class PipelineQualityGateGet extends AgentiaCommand {
+    static args = {
+        id: Args.string({
+            description: 'Quality gate ID or name',
+            required: true,
+        }),
+    };
+    static description = 'Get a Copado pipeline quality gate';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> <rule-id> --pipeline-id <pipeline-id>',
+        '<%= config.bin %> <%= command.id %> <rule-id> --pipeline-id <pipeline-id> --json',
+    ];
+    static flags = {
+        'pipeline-id': Flags.string({
+            description: 'Pipeline ID or name',
+            required: true,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(PipelineQualityGateGet);
+        const pipelineId = assertRequired(flags['pipeline-id'], '--pipeline-id');
+        const gate = await this.withSpinner('Fetching pipeline quality gate', () => fetchPipelineQualityGate(pipelineId, args.id));
+        this.display(() => this.log(formatPipelineQualityGateDetail(gate)));
+        return gate;
+    }
+}
+//# sourceMappingURL=get.js.map

package/dist/commands/cicd/pipeline/quality-gate/list.js

@@ -0,0 +1,34 @@
+import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { assertRequired } from '../../../../lib/assert.js';
+import { displayListPagination } from '../../../../lib/list-pagination.js';
+import { pipelineQualityGateListFlags } from '../../../../lib/pipeline-quality-gate-flags.js';
+import { fetchPipelineQualityGates } from '../../../../lib/pipeline-quality-gate-ops.js';
+import { formatPipelineQualityGateTable, } from '../../../../lib/pipeline-quality-gate-types.js';
+export default class PipelineQualityGateList extends AgentiaCommand {
+    static description = 'List Copado pipeline quality gates';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --pipeline-id <pipeline-id>',
+        '<%= config.bin %> <%= command.id %> --pipeline-id <pipeline-id> --tool Selenium --json',
+    ];
+    static flags = pipelineQualityGateListFlags;
+    async run() {
+        const { flags } = await this.parse(PipelineQualityGateList);
+        const pipelineId = assertRequired(flags['pipeline-id'], '--pipeline-id');
+        const page = await this.withSpinner('Fetching pipeline quality gates', () => fetchPipelineQualityGates(pipelineId, {
+            cursor: flags.cursor,
+            name: flags.name,
+            pageSize: flags['page-size'],
+            tool: flags.tool,
+        }));
+        this.display(() => {
+            if (page.data.length === 0) {
+                this.log('No pipeline quality gates found.');
+                return;
+            }
+            this.log(formatPipelineQualityGateTable(page.data));
+            displayListPagination(this.log.bind(this), page);
+        });
+        return page;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/cicd/pipeline/quality-gate/open.js

@@ -0,0 +1,38 @@
+import { Args } from '@oclif/core';
+import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { openNavigationTarget } from '../../../../lib/navigation-open.js';
+import { resolveNavigationTarget } from '../../../../lib/navigation.js';
+import { assertSalesforceLifecycleId } from '../../../../lib/pipeline-lifecycle-id.js';
+export default class PipelineQualityGateOpen extends AgentiaCommand {
+    static args = {
+        id: Args.string({
+            description: 'Quality gate Salesforce ID',
+            required: true,
+        }),
+    };
+    static description = 'Open a Copado pipeline quality gate in the browser';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> <rule-id>',
+        '<%= config.bin %> <%= command.id %> <rule-id> --json',
+    ];
+    async run() {
+        const { args } = await this.parse(PipelineQualityGateOpen);
+        let ruleId;
+        try {
+            ruleId = assertSalesforceLifecycleId(args.id, 'Quality gate ID');
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
+        }
+        const target = await this.withSpinner('Resolving navigation URL', () => resolveNavigationTarget({
+            id: ruleId,
+            resourceType: 'quality_gate_rule',
+        }));
+        await openNavigationTarget(target, {
+            jsonEnabled: this.jsonEnabled(),
+            log: this.log.bind(this),
+        });
+        return target;
+    }
+}
+//# sourceMappingURL=open.js.map

package/dist/commands/cicd/pipeline/quality-gate/update.js

@@ -0,0 +1,38 @@
+import { Args } from '@oclif/core';
+import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { assertRequired } from '../../../../lib/assert.js';
+import { buildPipelineQualityGateUpdatePayload, pipelineQualityGateUpdateFlags, } from '../../../../lib/pipeline-quality-gate-flags.js';
+import { updatePipelineQualityGate } from '../../../../lib/pipeline-quality-gate-ops.js';
+import { formatPipelineQualityGateDetail, } from '../../../../lib/pipeline-quality-gate-types.js';
+export default class PipelineQualityGateUpdate extends AgentiaCommand {
+    static args = {
+        id: Args.string({
+            description: 'Quality gate ID or name',
+            required: true,
+        }),
+    };
+    static description = 'Update an inactive Copado pipeline quality gate';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> <rule-id> --pipeline-id <pipeline-id> --execution-sequence Before',
+        '<%= config.bin %> <%= command.id %> <rule-id> --pipeline-id <pipeline-id> --environment-id <env-id> --json',
+    ];
+    static flags = pipelineQualityGateUpdateFlags;
+    async run() {
+        const { args, flags } = await this.parse(PipelineQualityGateUpdate);
+        const pipelineId = assertRequired(flags['pipeline-id'], '--pipeline-id');
+        let payload;
+        try {
+            payload = await buildPipelineQualityGateUpdatePayload(flags);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error), { exit: 2 });
+        }
+        const updated = await this.withSpinner('Updating pipeline quality gate', () => updatePipelineQualityGate(pipelineId, args.id, payload));
+        this.display(() => {
+            this.log(`Updated quality gate (ID: ${updated.id ?? args.id}).`);
+            this.log(formatPipelineQualityGateDetail(updated));
+        });
+        return updated;
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/cicd/work/create.js

@@ -9,6 +9,7 @@ export default class WorkCreate extends AgentiaCommand {
     static description = 'Create a Copado user story';
     static examples = [
         '<%= config.bin %> <%= command.id %> --title "My story" --status Draft',
+        '<%= config.bin %> <%= command.id %> --title "My story" --custom-field JIRA_Key__c=CICD-1',
         '<%= config.bin %> <%= command.id %> --title "My story" --json',
     ];
     static flags = workMutationFlags;

package/dist/commands/cicd/work/environment-sync.js

@@ -10,27 +10,28 @@ export default class WorkEnvironmentSync extends AgentiaCommand {
         'Resolves the next-environment Git branch from --destination-environment or --dev-org-branch (the dest pipeline connection destinationBranch, or that destination environment\'s outbound branch).',
         'Merges origin/<next-env> with --no-ff --no-commit, restores every other path from HEAD, commits the guessed pathspecs,',
         'and pushes the dest org branch (and the feature branch when HEAD starts with feature/).',
-        'If guessed pathspecs still conflict, PATCH the back-promotion status to Merge Conflict, resolve the files, and re-run with --promotion and --continue. The promotion destination environment supplies the dest org branch and the next-env branch.',
-        'To discard a conflicted merge, re-run with --promotion and --abort (runs git merge --abort and sets the back-promotion status to Draft).',
-        'After a successful sync, PATCH the back-promotion status to Completed.',
+        'If guessed pathspecs still conflict, PATCH the back-promotion status to Merge Conflict, store lastEnvironmentSyncName, resolve the files, and re-run with --continue (optional --promotion). The promotion destination environment supplies the dest org branch and the next-env branch.',
+        'To discard a conflicted merge, re-run with --abort (optional --promotion); runs git merge --abort and sets the back-promotion status to Draft.',
+        'After a successful sync, PATCH the back-promotion status to Completed and clear lastEnvironmentSyncName.',
         'On git/merge failure (including conflicts) and after a successful --continue, uploads the captured command transcript as a Salesforce File on the back-promotion (`Environment Sync Logs <name-or-id> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not change the environment-sync outcome.',
     ].join(' ');
     static examples = [
         '<%= config.bin %> <%= command.id %> --destination-environment=dev1',
         '<%= config.bin %> <%= command.id %> --dev-org-branch=dev1-sfp',
+        '<%= config.bin %> <%= command.id %> --continue',
+        '<%= config.bin %> <%= command.id %> --abort',
         '<%= config.bin %> <%= command.id %> --promotion=P29334 --continue',
-        '<%= config.bin %> <%= command.id %> --promotion=P29334 --abort',
         '<%= config.bin %> <%= command.id %> --destination-environment=dev1 --json',
     ];
     static flags = {
         abort: Flags.boolean({
             default: false,
-            description: 'Abort an in-progress merge (`git merge --abort`) and set the back-promotion status to Draft. Requires --promotion. Exclusive with --continue.',
+            description: 'Abort an in-progress merge (`git merge --abort`) and set the back-promotion status to Draft. Uses --promotion or lastEnvironmentSyncName. Exclusive with --continue.',
             exclusive: ['continue'],
         }),
         continue: Flags.boolean({
             default: false,
-            description: 'Finish after merge conflicts. If the merge is still in progress (conflicts fixed and staged, but not committed), commits it; if you already committed, continues from there through the remaining git steps.',
+            description: 'Finish after merge conflicts. If the merge is still in progress (conflicts fixed and staged, but not committed), commits it; if you already committed, continues from there through the remaining git steps. Uses --promotion or lastEnvironmentSyncName.',
             exclusive: ['abort'],
         }),
         'destination-credential': Flags.string({
@@ -48,7 +49,7 @@ export default class WorkEnvironmentSync extends AgentiaCommand {
             description: 'Pipeline ID. Defaults to the active work item from `cicd work set`.',
         }),
         promotion: Flags.string({
-            description: 'Back-promotion Id or name to PATCH when this run stops on merge conflicts, finishes successfully, continues, or aborts. Included in the conflict continue and abort commands. Defaults to the back-promotion created in this run.',
+            description: 'Back-promotion Id or name to PATCH when this run stops on merge conflicts, finishes successfully, continues, or aborts. Optional for --continue/--abort when lastEnvironmentSyncName was stored from a prior environment-sync run. Defaults to the back-promotion created in this run.',
         }),
     };
     async run() {

package/dist/commands/cicd/work/set.js

@@ -4,6 +4,7 @@ import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { reconcileWorkSetCredential } from '../../../lib/credential-sync.js';
 import { writeLastWorkSelection } from '../../../lib/defaults-store.js';
 import { checkoutFeatureBranch, fetchOriginBranch, fetchOriginBranchIfExists, listPendingChanges, } from '../../../lib/git-worktree.js';
+import { withLocalDevelopmentFlow } from '../../../lib/work-local-development-flow.js';
 import { performWorkSetNone, WorkSetNoneValidationError } from '../../../lib/work-set-none.js';
 import { isWorkSetWarning, parseWorkSetSelection, toWorkSetWarningResult, writeWorkSetWarningSelection, } from '../../../lib/work-set-selection.js';
 import { featureBranchName, workSetEndpoint, } from '../../../lib/work-types.js';
@@ -14,7 +15,7 @@ export default class WorkSet extends AgentiaCommand {
             required: false,
         }),
     };
-    static description = [
+    static description = withLocalDevelopmentFlow([
         'Set the active work item and prepare a local feature branch.',
         'Calls the CICD gateway work/set endpoint, requires a clean tracked working tree,',
         'fetches the work item base branch from origin, fetches the feature branch when it',
@@ -23,11 +24,12 @@ export default class WorkSet extends AgentiaCommand {
         'A gateway warning prints the message, skips git, clears lastBaseBranch/lastDevOrgBranch/lastPullRequestBaseUrl,',
         'and records lastWorkItemId/lastWorkItem/lastWorkItemTitle from the returned work item.',
         'After work/set returns, compares the Story source credential with the CICD project default:',
-        'warns when the default or Story credential is missing, and warns without changing the Story',
-        'when they differ (shows the current credential and environment; use work update to change it).',
+        'warns when the Story credential is missing, skips comparison when a bound Story has no project default,',
+        'and warns without changing the Story when they differ (shows the current credential and environment;',
+        'use work update to change it).',
         'With --none, clears every last* key from `.agentia/config.user.json` and checks out',
         'the previous lastBaseBranch when present, else main, else master, else stays put.',
-    ].join(' ');
+    ].join(' '));
     static examples = [
         '<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU',
         '<%= config.bin %> <%= command.id %> US-0001 --json',

package/dist/commands/cicd/work/submit.js

@@ -9,13 +9,14 @@ import { LocalQualityGatesError, resolveLocalQualityGatesScript, runLocalQuality
 import { openUrl } from '../../../lib/open-browser.js';
 import { resolveWorkItemId } from '../../../lib/work-active.js';
 import { pickWorkDoneFlags, runWorkDone, workDoneFlags } from '../../../lib/work-done.js';
+import { withLocalDevelopmentFlow } from '../../../lib/work-local-development-flow.js';
 import { reportLocalQualityGatesFailure, reportLocalQualityGatesOutcome, } from '../../../lib/work-local-run-tests.js';
 import { performWorkPush, resolveActiveFeatureWorkItem, resolveWorkPushContext, resolveWorkPushNeed, uploadCapturedPublishLogsBestEffort, WorkPushValidationError, } from '../../../lib/work-push.js';
 import { reportSubmitUserStoriesAheadBehind } from '../../../lib/work-submit-ahead-behind.js';
 import { waitForPendingCommitJobBeforeSubmit } from '../../../lib/work-submit-wait.js';
 import { buildPullRequestCompareUrl, formatWorkCommandMessage, workSubmitEndpoint, } from '../../../lib/work-types.js';
 export default class WorkSubmit extends AgentiaCommand {
-    static description = [
+    static description = withLocalDevelopmentFlow([
         'Submit the current feature/<lastWorkItem> work item for pipeline quality gates and validation.',
         'Runs project-root .agentia_quality_gates.sh (macOS/Linux) or .agentia_quality_gates.cmd (Windows) when present,',
         'pushes and registers commits when the branch is ahead of origin, then calls headless work/submit',
@@ -25,7 +26,7 @@ export default class WorkSubmit extends AgentiaCommand {
         'After a successful submit or promote, uploads the captured command output as a Salesforce File on the user story (`Local Commit Logs <commitId> <datetime>.txt`) via `/agentia/headless/file/upload`. HTTP 404 is ignored until that endpoint is rolled out; other upload failures are warned and do not fail the command.',
         'With --done or --deploy, matches Copado UI Submit when promoting (validate=false / headless work/done).',
         'cicd work done is a compatibility alias of this command with --done.',
-    ].join(' ');
+    ].join(' '));
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --apex-test-classes=MyTest,OtherTest',

package/dist/commands/cicd/work/update.js

@@ -14,6 +14,7 @@ export default class WorkUpdate extends AgentiaCommand {
     static description = 'Update a Copado user story by ID';
     static examples = [
         '<%= config.bin %> <%= command.id %> --title "Updated story"',
+        '<%= config.bin %> <%= command.id %> --custom-field JIRA_Key__c=CICD-1',
         '<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --title "Updated story"',
         '<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --status "In Progress" --json',
     ];

package/dist/commands/plugins/install.js

@@ -1,7 +1,7 @@
 import { confirm } from '@inquirer/prompts';
 import { Args, Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../lib/agentia-command.js';
-import { assessInstalls, enforceInstalls, parseInstallArguments, PluginTrustError, stockInstallArguments, uncheckedWarning } from '../../lib/plugin-trust/gate.js';
+import { assessInstalls, enforceInstalls, parseInstallArguments, PluginTrustError, stockInstallArguments } from '../../lib/plugin-trust/gate.js';
 export default class PluginsInstall extends AgentiaCommand {
     static aliases = ['plugins:add'];
     static args = {
@@ -11,7 +11,7 @@ export default class PluginsInstall extends AgentiaCommand {
 
 Official and Verified plugins install without a prompt. Community, unlisted, and git URL plugins ask first. Use --allow-unverified when there is no terminal or with --json.
 
-A revoked version, or an npm tarball that differs from the hash in the catalog, is always refused. If the catalog cannot be reached, the command warns and the install continues.`;
+A revoked version, or an npm tarball that differs from the hash in the catalog, is always refused. If the catalog cannot be reached, plugins cannot be checked, so the command warns and asks first, even for Official and Verified plugins. Use --allow-unverified to install without the check.`;
     static examples = [
         '<%= config.bin %> <%= command.id %> @acme/agentia-plugin-x',
         '<%= config.bin %> <%= command.id %> @acme/agentia-plugin-x@1.2.0 --allow-unverified --json',
@@ -35,9 +35,6 @@ A revoked version, or an npm tarball that differs from the hash in the catalog,
             const registryVariable = this.config.scopedEnvVarKey('NPM_REGISTRY');
             const customRegistry = Boolean(process.env[registryVariable]);
             const { assessments } = await assessInstalls(inputs, { resolve: !customRegistry });
-            const skipped = uncheckedWarning(assessments);
-            if (skipped)
-                this.display(() => this.warn(skipped));
             if (customRegistry)
                 this.display(() => this.warn(`${registryVariable} is set, so versions cannot be checked against the catalog.`));
             plugins = await enforceInstalls(assessments, {

package/dist/commands/setup/skills/create.js

@@ -1,5 +1,6 @@
 import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { createPluginSkillLoader, pluginRefsFromConfig, selectPluginSkills, } from '../../../lib/plugin-skills.js';
 import { createInquirerSetupPrompts, isPromptCanceled } from '../../../lib/setup-prompts.js';
 import { resolveSelectedSkillPacks, runSetupSkills, SETUP_SKILL_TARGETS, } from '../../../lib/setup-skills.js';
 export default class SetupSkillsCreate extends AgentiaCommand {
@@ -10,6 +11,7 @@ export default class SetupSkillsCreate extends AgentiaCommand {
         '<%= config.bin %> <%= command.id %> --cicd --target agents --no-prompt',
         '<%= config.bin %> <%= command.id %> --testing --ai --target cursor --no-prompt',
         '<%= config.bin %> <%= command.id %> --json',
+        '<%= config.bin %> <%= command.id %> --plugin @acme/agentia-plugin-release --target cursor --no-prompt',
     ];
     static flags = {
         adv: Flags.boolean({
@@ -30,6 +32,10 @@ export default class SetupSkillsCreate extends AgentiaCommand {
             default: false,
             description: 'Skip interactive prompts; defaults the target to .agents/skills when --target is omitted',
         }),
+        plugin: Flags.string({
+            description: 'Also install the skills this installed plugin contributes through its agentia:contribute hook (repeatable). Without pack flags only plugin skills are written',
+            multiple: true,
+        }),
         target: Flags.string({
             description: 'Project skill root to write (repeatable)',
             multiple: true,
@@ -43,8 +49,17 @@ export default class SetupSkillsCreate extends AgentiaCommand {
         const { flags } = await this.parse(SetupSkillsCreate);
         const noPrompt = flags['no-prompt'] || this.jsonEnabled();
         try {
-            return await runSetupSkills({
+            const pluginNames = flags.plugin ?? [];
+            const hasPackFlag = flags.adv || flags.ai || flags.cicd || flags.testing;
+            const packs = pluginNames.length > 0 && !hasPackFlag ? [] : resolveSelectedSkillPacks(flags);
+            // The agentia:contribute hook runs only through this loader, once, and only when plugin skills are needed.
+            const loadPluginSkills = createPluginSkillLoader(this.config);
+            const plugin = pluginNames.length > 0
+                ? await selectPluginSkills(pluginRefsFromConfig(this.config), pluginNames, loadPluginSkills)
+                : undefined;
+            const result = await runSetupSkills({
                 force: flags.force,
+                loadPluginSkills,
                 log: (message) => {
                     this.display(() => {
                         this.log(message);
@@ -52,11 +67,22 @@ export default class SetupSkillsCreate extends AgentiaCommand {
                 },
                 mode: 'create',
                 noPrompt,
-                packs: resolveSelectedSkillPacks(flags),
+                offerPluginSkills: pluginNames.length === 0 && !hasPackFlag,
+                packs,
+                pluginRefs: pluginRefsFromConfig(this.config),
+                pluginSkills: plugin?.skills,
+                rules: packs.length > 0,
+                skippedPluginSkills: plugin?.skipped,
                 targets: flags.target,
             }, {
                 prompts: noPrompt ? undefined : createInquirerSetupPrompts(),
             });
+            for (const item of result.skippedPluginSkills) {
+                this.display(() => {
+                    this.warn(`Skipped plugin skill ${item.plugin}/${item.skill}: ${item.reason}`);
+                });
+            }
+            return result;
         }
         catch (error) {
             if (isPromptCanceled(error)) {

package/dist/commands/setup/skills/list.js

@@ -0,0 +1,55 @@
+import { Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { createPluginSkillLoader, pluginRefsFromConfig, selectPluginSkills, } from '../../../lib/plugin-skills.js';
+export default class SetupSkillsList extends AgentiaCommand {
+    static description = 'List skills that installed plugins contribute through their agentia:contribute hook (what "setup skills create|update --plugin" can install) and why invalid ones are skipped';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --plugin @acme/agentia-plugin-release --json',
+    ];
+    static flags = {
+        plugin: Flags.string({
+            description: 'Only list skills from this installed plugin (repeatable)',
+            multiple: true,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(SetupSkillsList);
+        const plugins = pluginRefsFromConfig(this.config);
+        const load = createPluginSkillLoader(this.config);
+        let discovery;
+        try {
+            discovery =
+                flags.plugin && flags.plugin.length > 0
+                    ? await selectPluginSkills(plugins, flags.plugin, load)
+                    : await load();
+        }
+        catch (error) {
+            this.error(error.message, { exit: 1 });
+        }
+        const result = {
+            skills: discovery.skills.map((skill) => ({
+                description: skill.description,
+                files: skill.files.length,
+                id: skill.id,
+                plugin: skill.plugin,
+                skill: skill.name,
+                version: skill.version,
+            })),
+            skipped: discovery.skipped,
+        };
+        this.display(() => {
+            if (result.skills.length === 0 && result.skipped.length === 0) {
+                this.log('No installed plugin ships skills.');
+            }
+            for (const item of result.skills) {
+                this.log(`${item.skill} (${item.plugin}@${item.version}, ${item.files} files): ${item.description}`);
+            }
+            for (const item of result.skipped) {
+                this.log(`skipped ${item.plugin}/${item.skill}: ${item.reason}`);
+            }
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/setup/skills/update.js

@@ -1,15 +1,18 @@
 import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { createPluginSkillLoader, pluginRefsFromConfig, selectPluginSkills, } from '../../../lib/plugin-skills.js';
 import { createInquirerSetupPrompts, isPromptCanceled } from '../../../lib/setup-prompts.js';
 import { resolveSelectedSkillPacks, runSetupSkills, SETUP_SKILL_TARGETS, } from '../../../lib/setup-skills.js';
 export default class SetupSkillsUpdate extends AgentiaCommand {
-    static description = 'Update Agentia-managed Markdown skill files and restore missing files in this project';
+    static description = 'Update Agentia-managed Markdown skill files and restore missing files in this project; without flags it also refreshes plugin skills already installed';
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> --ai --target cursor --no-prompt',
         '<%= config.bin %> <%= command.id %> --adv --target agents --no-prompt',
         '<%= config.bin %> <%= command.id %> --cicd --testing --target agents --no-prompt',
         '<%= config.bin %> <%= command.id %> --force --json',
+        '<%= config.bin %> <%= command.id %> --prune --target cursor --no-prompt',
+        '<%= config.bin %> <%= command.id %> --plugin @acme/agentia-plugin-release --target cursor --no-prompt',
     ];
     static flags = {
         adv: Flags.boolean({
@@ -30,6 +33,15 @@ export default class SetupSkillsUpdate extends AgentiaCommand {
             default: false,
             description: 'Skip interactive prompts; defaults the target to .agents/skills when --target is omitted',
         }),
+        plugin: Flags.string({
+            description: 'Also install the skills this installed plugin contributes through its agentia:contribute hook (repeatable). Without pack flags only plugin skills are written',
+            multiple: true,
+        }),
+        prune: Flags.boolean({
+            default: false,
+            description: 'Also delete installed plugin skills whose plugin is uninstalled or no longer contributes them (only files carrying that plugin\'s managed marker)',
+            exclusive: ['plugin'],
+        }),
         target: Flags.string({
             description: 'Project skill root to write (repeatable)',
             multiple: true,
@@ -43,8 +55,17 @@ export default class SetupSkillsUpdate extends AgentiaCommand {
         const { flags } = await this.parse(SetupSkillsUpdate);
         const noPrompt = flags['no-prompt'] || this.jsonEnabled();
         try {
-            return await runSetupSkills({
+            const pluginNames = flags.plugin ?? [];
+            const hasPackFlag = flags.adv || flags.ai || flags.cicd || flags.testing;
+            const packs = pluginNames.length > 0 && !hasPackFlag ? [] : resolveSelectedSkillPacks(flags);
+            // The agentia:contribute hook runs only through this loader, once, and only when plugin skills are needed.
+            const loadPluginSkills = createPluginSkillLoader(this.config);
+            const plugin = pluginNames.length > 0
+                ? await selectPluginSkills(pluginRefsFromConfig(this.config), pluginNames, loadPluginSkills)
+                : undefined;
+            const result = await runSetupSkills({
                 force: flags.force,
+                loadPluginSkills,
                 log: (message) => {
                     this.display(() => {
                         this.log(message);
@@ -52,11 +73,23 @@ export default class SetupSkillsUpdate extends AgentiaCommand {
                 },
                 mode: 'update',
                 noPrompt,
-                packs: resolveSelectedSkillPacks(flags),
+                packs,
+                pluginRefs: pluginRefsFromConfig(this.config),
+                pluginSkills: plugin?.skills,
+                prune: flags.prune,
+                refreshPlugins: pluginNames.length === 0 && !hasPackFlag,
+                rules: packs.length > 0,
+                skippedPluginSkills: plugin?.skipped,
                 targets: flags.target,
             }, {
                 prompts: noPrompt ? undefined : createInquirerSetupPrompts(),
             });
+            for (const item of result.skippedPluginSkills) {
+                this.display(() => {
+                    this.warn(`Skipped plugin skill ${item.plugin}/${item.skill}: ${item.reason}`);
+                });
+            }
+            return result;
         }
         catch (error) {
             if (isPromptCanceled(error)) {

package/dist/commands/setup.js

@@ -6,8 +6,8 @@ import { runSetupWizard } from '../lib/setup-wizard.js';
 export default class Setup extends AgentiaCommand {
     static 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.',
+        'Guides CICD, AI, and CRT authentication, Cursor and Claude Code 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 and Claude Code MCP and project setup.',
         'Git is optional: .gitignore is updated only inside a repository, and generated files are not committed.',
     ].join(' ');
     static enableJsonFlag = false;
@@ -18,7 +18,7 @@ export default class Setup extends AgentiaCommand {
     static flags = {
         'skip-auth': Flags.boolean({
             default: false,
-            description: 'Skip CICD, AI, and CRT authentication; continue with Cursor MCP and project setup',
+            description: 'Skip CICD, AI, and CRT authentication; continue with Cursor and Claude Code MCP and project setup',
         }),
     };
     async run() {

package/dist/commands/testing/data-table/create.js

@@ -1,8 +1,7 @@
 import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
 import { confirmTestingAction } from '../../../lib/testing-confirmation.js';
-import { formatTestingDataTableHuman, parseTestingDataTopics, prepareTestingDataInput, testingDataInputFlags, testingDataJobFlag, } from '../../../lib/testing-data-command.js';
-import { createTestingDataTable } from '../../../lib/testing-data-operations.js';
+import { createTestingDataTable, formatTestingDataTableHuman, parseTestingDataTopics, prepareTestingDataInput, testingDataInputFlags, testingDataJobFlag, } from '../../../lib/testing-data-table.js';
 import { testingProjectFlag } from '../../../lib/testing-flags.js';
 export default class TestingDataTableCreate extends AgentiaCommand {
     static description = 'Create a Copado Robotic Testing data table';

package/dist/commands/testing/data-table/delete.js

@@ -1,8 +1,7 @@
 import { Args, Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
 import { confirmTestingAction } from '../../../lib/testing-confirmation.js';
-import { testingDataJobFlag } from '../../../lib/testing-data-command.js';
-import { deleteTestingDataTable } from '../../../lib/testing-data-operations.js';
+import { deleteTestingDataTable, testingDataJobFlag } from '../../../lib/testing-data-table.js';
 import { testingProjectFlag } from '../../../lib/testing-flags.js';
 export default class TestingDataTableDelete extends AgentiaCommand {
     static args = {

package/dist/commands/testing/data-table/export.js

@@ -2,11 +2,7 @@ import { Args, Flags } from '@oclif/core';
 import { existsSync } from 'node:fs';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
 import { confirmTestingAction } from '../../../lib/testing-confirmation.js';
-import { testingDataJobFlag, testingDataRevisionFlag } from '../../../lib/testing-data-command.js';
-import { parseTestingDatasetSelector, sliceTestingDataTable, unwrapTestingDataHeaders, } from '../../../lib/testing-data-core.js';
-import { normalizeTestingDataPath, writeTestingDataFile } from '../../../lib/testing-data-export.js';
-import { getTestingDataTable } from '../../../lib/testing-data-operations.js';
-import { TESTING_DATA_EXPORT_FORMATS } from '../../../lib/testing-data-types.js';
+import { getTestingDataTable, normalizeTestingDataPath, selectTestingDataTableDatasets, TESTING_DATA_EXPORT_FORMATS, testingDataJobFlag, testingDataRevisionFlag, unwrapTestingDataHeaders, writeTestingDataFile, } from '../../../lib/testing-data-table.js';
 import { testingProjectFlag } from '../../../lib/testing-flags.js';
 export default class TestingDataTableExport extends AgentiaCommand {
     static args = {
@@ -48,7 +44,7 @@ export default class TestingDataTableExport extends AgentiaCommand {
             tableId: args.id,
             version: flags.revision,
         }));
-        const selected = flags.datasets === undefined ? table : sliceTestingDataTable(table, parseTestingDatasetSelector(flags.datasets));
+        const selected = selectTestingDataTableDatasets(table, flags.datasets);
         if (selected.data === undefined)
             throw new Error(`Data table ${args.id} has no data to export.`);
         const result = await writeTestingDataFile(output, unwrapTestingDataHeaders(selected.data), flags.format);

package/dist/commands/testing/data-table/get.js

@@ -1,8 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { formatTestingDataTableHuman, testingDataJobFlag, testingDataRevisionFlag, } from '../../../lib/testing-data-command.js';
-import { parseTestingDatasetSelector, sliceTestingDataTable } from '../../../lib/testing-data-core.js';
-import { getTestingDataTable } from '../../../lib/testing-data-operations.js';
+import { formatTestingDataTableHuman, getTestingDataTable, selectTestingDataTableDatasets, testingDataJobFlag, testingDataRevisionFlag, } from '../../../lib/testing-data-table.js';
 import { testingProjectFlag } from '../../../lib/testing-flags.js';
 export default class TestingDataTableGet extends AgentiaCommand {
     static args = {
@@ -27,7 +25,7 @@ export default class TestingDataTableGet extends AgentiaCommand {
             tableId: args.id,
             version: flags.revision,
         }));
-        const selected = flags.datasets === undefined ? table : sliceTestingDataTable(table, parseTestingDatasetSelector(flags.datasets));
+        const selected = selectTestingDataTableDatasets(table, flags.datasets);
         this.display(() => this.log(formatTestingDataTableHuman(selected)));
         return { projectId: flags.project, table: selected };
     }

package/dist/commands/testing/data-table/list.js

@@ -1,7 +1,6 @@
 import { Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { testingDataJobFlag, testingDataRevisionFlag } from '../../../lib/testing-data-command.js';
-import { listTestingDataTables } from '../../../lib/testing-data-operations.js';
+import { listTestingDataTables, testingDataJobFlag, testingDataRevisionFlag } from '../../../lib/testing-data-table.js';
 import { testingProjectFlag } from '../../../lib/testing-flags.js';
 import { formatTestingTable } from '../../../lib/testing-types.js';
 export default class TestingDataTableList extends AgentiaCommand {