@copado/agentia-cli 1.1.0 → 1.3.0

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

@@ -1,9 +1,9 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { openNavigationTarget } from '../../../lib/navigation-open.js';
 import { resolveNavigationTarget } from '../../../lib/navigation.js';
 import { resolveWorkItemId, WorkActiveResolutionError } from '../../../lib/work-active.js';
-export default class WorkOpen extends AgentiaCommand {
+export default class WorkOpen extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'User story ID (defaults to the active work item from `work set`)',

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

@@ -1,7 +1,7 @@
 import { Args, Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { collectPromoteUserStoryIds, formatWorkPromoteResult, performWorkPromote, WorkPromoteConflictError, WorkPromoteValidationError, } from '../../../lib/work-promote.js';
-export default class WorkPromote extends AgentiaCommand {
+export default class WorkPromote extends CicdCommand {
     static args = {
         userStoryIds: Args.string({
             description: 'User story ID. Pass more than one to merge those feature branches in order. Omit when using --promotion with --continue or --abort.',

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

@@ -1,7 +1,7 @@
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { commandStdioCaptureOptions, withCapturedCommandOutput } from '../../../lib/command-output-buffer.js';
 import { runWorkPublish, WORK_PUBLISH_DESCRIPTION, workPublishFlags, } from '../../../lib/work-publish-command.js';
-export default class WorkPublish extends AgentiaCommand {
+export default class WorkPublish extends CicdCommand {
     static description = WORK_PUBLISH_DESCRIPTION;
     static examples = [
         '<%= config.bin %> <%= command.id %>',

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

@@ -1,11 +1,11 @@
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { commandStdioCaptureOptions, withCapturedCommandOutput } from '../../../lib/command-output-buffer.js';
 import { runWorkPublish, workPublishFlags, } from '../../../lib/work-publish-command.js';
 /**
  * Compatibility alias of `cicd work publish`.
  * Prefer `agentia cicd work publish` in scripts and docs.
  */
-export default class WorkPush extends AgentiaCommand {
+export default class WorkPush extends CicdCommand {
     static description = [
         'Alias of cicd work publish.',
         'Publishes the current feature/<lastWorkItem> branch and registers commits with Copado.',

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

@@ -1,20 +1,21 @@
 import { Args, Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 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';
-export default class WorkSet extends AgentiaCommand {
+export default class WorkSet extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'User story ID or name (omit with --none)',
             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/status.js

@@ -1,10 +1,10 @@
 import { Args, Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { readLastWorkItem } from '../../../lib/defaults-store.js';
 import { resolveRecordedWorkBranchMetadata, } from '../../../lib/work-branch-metadata.js';
 import { formatWorkBranchMetadata, formatWorkStatus, workStatusEndpoint, } from '../../../lib/work-types.js';
-export default class WorkStatus extends AgentiaCommand {
+export default class WorkStatus extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'User story ID or name (defaults to the last work item from `work set`)',

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

@@ -1,6 +1,6 @@
 import { Flags } from '@oclif/core';
 import path from 'node:path';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { commandStdioCaptureOptions, withCapturedCommandOutput } from '../../../lib/command-output-buffer.js';
 import { readLastBaseBranch, readLastPullRequestBaseUrl, readSkipPullRequest, } from '../../../lib/defaults-store.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 = [
+export default class WorkSubmit extends CicdCommand {
+    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/test/apex.js

@@ -1,8 +1,8 @@
 import { Flags } from '@oclif/core';
-import { AgentiaCommand } from '../../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../../lib/cicd-command.js';
 import { planWorkApexTestRun, recordWorkApexTestOutcome, WorkApexRerunError, } from '../../../../lib/work-apex-test-failures.js';
 import { DEFAULT_APEX_TEST_WAIT_MINUTES, formatWorkApexTestHuman, parseApexTestClassNames, runWorkApexTests, skippedWorkApexTestResult, validateApexTestWaitMinutes, WorkApexTestError, } from '../../../../lib/work-apex-test.js';
-export default class WorkTestApex extends AgentiaCommand {
+export default class WorkTestApex extends CicdCommand {
     static description = [
         'Run specified Apex test classes via Salesforce CLI (`sf apex run test`) with code coverage.',
         'Usually run from project-root local quality gates (`.agentia_quality_gates.sh` / `.agentia_quality_gates.cmd`) when those scripts are configured.',

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

@@ -1,12 +1,12 @@
 import { Flags } from '@oclif/core';
 import path from 'node:path';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { getCurrentBranch } from '../../../lib/git-worktree.js';
 import { LocalQualityGatesError, parseQualityGatesEnvAssignments, resolveLocalQualityGatesScript, } from '../../../lib/local-quality-gates.js';
 import { runWorkTestLocalQualityGates } from '../../../lib/stock-quality-gates.js';
 import { reportLocalQualityGatesFailure, reportLocalQualityGatesOutcome, } from '../../../lib/work-local-run-tests.js';
 import { extractUserStoryFromFeatureBranch } from '../../../lib/work-types.js';
-export default class WorkTest extends AgentiaCommand {
+export default class WorkTest extends CicdCommand {
     static description = [
         'Run quality gates for the current work item.',
         'With --local (the default) it runs project-root .agentia_quality_gates.sh (macOS/Linux) or',

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

@@ -1,10 +1,10 @@
 import { Args } from '@oclif/core';
-import { AgentiaCommand } from '../../../lib/agentia-command.js';
+import { CicdCommand } from '../../../lib/cicd-command.js';
 import { CicdGateway } from '../../../lib/cicd-gateway.js';
 import { resolveWorkItemId, WorkActiveResolutionError } from '../../../lib/work-active.js';
 import { buildWorkMutationPayload, collectWorkMutationFlagKeys, validateWorkMutationPayload, workMutationFlags, } from '../../../lib/work-flags.js';
 import { workEndpoint } from '../../../lib/work-types.js';
-export default class WorkUpdate extends AgentiaCommand {
+export default class WorkUpdate extends CicdCommand {
     static args = {
         id: Args.string({
             description: 'User story ID (defaults to the active work item from `work set`)',
@@ -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/help-agent.js

@@ -0,0 +1,15 @@
+import { AgentiaCommand } from '../lib/agentia-command.js';
+import { runInteractiveHelpAgent } from '../lib/help-agent-command.js';
+export default class HelpAgent extends AgentiaCommand {
+    static description = `Chat interactively with the Copado Help Agent.
+
+Starts without a credential preflight, sends bounded non-secret CLI context, and requests a fresh short-lived AI token through the CICD gateway for every turn. Type /help during the session to list chat commands.`;
+    static enableJsonFlag = false;
+    static examples = ['<%= config.bin %> <%= command.id %>'];
+    static experimental = true;
+    async run() {
+        await this.parse(HelpAgent);
+        return runInteractiveHelpAgent(this);
+    }
+}
+//# sourceMappingURL=help-agent.js.map

package/dist/commands/help.js

@@ -0,0 +1,38 @@
+import { Args, Flags, loadHelpClass } from '@oclif/core';
+import { AgentiaCommand } from '../lib/agentia-command.js';
+import { runInteractiveHelpAgent } from '../lib/help-agent-command.js';
+export default class Help extends AgentiaCommand {
+    static args = {
+        command: Args.string({ description: 'Command to show help for.', required: false }),
+    };
+    static description = 'Display help for <%= config.bin %> or open the interactive Copado support expert.';
+    static enableJsonFlag = false;
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> <command>',
+        '<%= config.bin %> <%= command.id %> --agent',
+    ];
+    static flags = {
+        agent: Flags.boolean({
+            description: 'Open the interactive Copado support expert.',
+        }),
+        'nested-commands': Flags.boolean({
+            char: 'n',
+            description: 'Include all nested commands in the output.',
+        }),
+    };
+    static strict = false;
+    async run() {
+        const { argv, flags } = await this.parse(Help);
+        if (flags.agent) {
+            if (argv.length > 0 || flags['nested-commands']) {
+                this.error('--agent cannot be combined with a command or --nested-commands.', { exit: 2 });
+            }
+            return runInteractiveHelpAgent(this);
+        }
+        const HelpClass = await loadHelpClass(this.config);
+        const help = new HelpClass(this.config, { all: flags['nested-commands'] });
+        await help.showHelp(argv);
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/history/clear.js

@@ -0,0 +1,42 @@
+import { confirm } from '@inquirer/prompts';
+import { Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { clearCommandHistory } from '../../lib/command-history.js';
+import { clearHelpAgentInteractions } from '../../lib/help-agent-interaction-history.js';
+import { redactErrorMessage } from '../../lib/secret-redaction.js';
+export default class HistoryClear extends AgentiaCommand {
+    static description = 'Clear temporary command and Help Agent interaction history';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> --yes',
+        '<%= config.bin %> <%= command.id %> --yes --json',
+    ];
+    static flags = {
+        yes: Flags.boolean({
+            char: 'y',
+            default: false,
+            description: 'Confirm clearing temporary history without prompting.',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(HistoryClear);
+        if (!flags.yes) {
+            if (this.jsonEnabled() || process.stdin.isTTY !== true || process.stdout.isTTY !== true) {
+                this.error('Clearing temporary history requires confirmation. Pass --yes for headless or JSON execution.', {
+                    exit: 2,
+                });
+            }
+            if (!(await confirm({ default: false, message: 'Clear temporary command and Help Agent history?' }))) {
+                this.error('History clearing canceled.', { exit: 1 });
+            }
+        }
+        try {
+            await Promise.all([clearCommandHistory(), clearHelpAgentInteractions()]);
+        }
+        catch (error) {
+            this.error(`Could not clear temporary history: ${redactErrorMessage(error)}`, { exit: 1 });
+        }
+        this.display(() => this.log('Temporary history cleared.'));
+        return { cleared: true };
+    }
+}
+//# sourceMappingURL=clear.js.map

package/dist/commands/history/list.js

@@ -0,0 +1,50 @@
+import { Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { COMMAND_HISTORY_DEFAULT_LIST_LIMIT, COMMAND_HISTORY_LIMIT, readCommandHistory, } from '../../lib/command-history.js';
+import { table } from '../../lib/format.js';
+export default class HistoryList extends AgentiaCommand {
+    static description = 'List recent sanitized Agentia CLI command executions';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --limit 10',
+        '<%= config.bin %> <%= command.id %> --limit 10 --json',
+    ];
+    static flags = {
+        limit: Flags.integer({
+            default: COMMAND_HISTORY_DEFAULT_LIST_LIMIT,
+            description: 'Maximum entries to return (newest first).',
+            max: COMMAND_HISTORY_LIMIT,
+            min: 1,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(HistoryList);
+        const history = await readCommandHistory();
+        const entries = history.slice(-flags.limit).reverse();
+        this.display(() => {
+            if (entries.length === 0) {
+                this.log('No command history.');
+                return;
+            }
+            this.log(table([
+                { alias: 'Timestamp', value: 'timestamp' },
+                { alias: 'Command', minContentWidth: 12, value: 'commandId' },
+                { alias: 'Origin', value: 'clientOrigin' },
+                { alias: 'Status', value: 'status' },
+                { alias: 'Exit', value: 'exitCode' },
+                { alias: 'Duration', value: 'duration' },
+                { alias: 'Workspace', minContentWidth: 8, value: 'workspace' },
+            ], entries.map((entry) => ({
+                clientOrigin: entry.clientOrigin ?? 'unknown',
+                commandId: entry.commandId,
+                duration: `${entry.durationMs}ms`,
+                exitCode: entry.exitCode,
+                status: entry.status,
+                timestamp: entry.timestamp,
+                workspace: entry.workspace,
+            }))));
+        });
+        return { entries, limit: flags.limit, total: history.length };
+    }
+}
+//# sourceMappingURL=list.js.map

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/support.js

@@ -0,0 +1,15 @@
+import { AgentiaCommand } from '../lib/agentia-command.js';
+import { runInteractiveHelpAgent } from '../lib/help-agent-command.js';
+export default class Support extends AgentiaCommand {
+    static description = `Chat interactively with the Copado support expert.
+
+Sends bounded local CLI context and requests a fresh short-lived AI token through the CICD gateway for every turn. Type /help during the session to list chat commands.`;
+    static enableJsonFlag = false;
+    static examples = ['<%= config.bin %> <%= command.id %>'];
+    static experimental = true;
+    async run() {
+        await this.parse(Support);
+        return runInteractiveHelpAgent(this);
+    }
+}
+//# sourceMappingURL=support.js.map