@copado/agentia-cli 0.16.0-alpha.0 → 0.18.0-alpha.0

package/dist/commands/work/done.js

@@ -0,0 +1,99 @@
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { CicdGateway } from '../../lib/cicd-gateway.js';
+import { readLastBaseBranch } from '../../lib/defaults-store.js';
+import { getCurrentBranch, hasUnpushedCommits, listPendingChanges } from '../../lib/git-worktree.js';
+import { performWorkPush, WorkPushValidationError } from '../../lib/work-push.js';
+import { extractUserStoryFromFeatureBranch, workDoneEndpoint, } from '../../lib/work-types.js';
+export default class WorkDone extends AgentiaCommand {
+    static description = [
+        'Mark the current feature/US-XXXX work item done and promote it to the next environment.',
+        'Pushes and registers commits when the branch is ahead of origin, then calls headless work/done',
+        '(Promote Action with validate=false).',
+    ].join(' ');
+    static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --json'];
+    async run() {
+        await this.parse(WorkDone);
+        const branch = await getCurrentBranch();
+        const workItem = extractUserStoryFromFeatureBranch(branch);
+        if (workItem === undefined) {
+            this.error(`Current branch '${branch}' is not a feature/US-XXXX branch.`, {
+                exit: 1,
+                suggestions: ['Checkout a feature/US-XXXX branch created by `agentia work set`.'],
+            });
+        }
+        const pendingFiles = await listPendingChanges();
+        if (pendingFiles.length > 0) {
+            this.error([
+                'Uncommitted tracked changes present. Commit them, then try again:',
+                ...pendingFiles.map((file) => `  ${file}`),
+            ].join('\n'), {
+                exit: 2,
+                suggestions: ['git add -A && git commit', `${this.config.bin} work done`],
+            });
+        }
+        this.display(() => {
+            this.log(`Branch: ${branch}`);
+            this.log(`Work item: ${workItem}`);
+        });
+        let pushResult;
+        const needsPush = await hasUnpushedCommits(branch);
+        if (needsPush) {
+            const baseBranch = (await readLastBaseBranch())?.trim();
+            if (baseBranch === undefined || baseBranch.length === 0) {
+                this.error('No base branch recorded. Run `agentia work set <work-item>` first.', {
+                    exit: 1,
+                });
+            }
+            this.display(() => {
+                this.log(`Base branch: ${baseBranch}`);
+                this.log('Unpushed commits detected; pushing before done.');
+            });
+            try {
+                pushResult = await performWorkPush({
+                    baseBranch,
+                    branch,
+                    hooks: {
+                        display: (render) => this.display(render),
+                        log: (message) => this.log(message),
+                        withSpinner: (message, action) => this.withSpinner(message, action),
+                    },
+                    workItem,
+                });
+            }
+            catch (error) {
+                if (error instanceof WorkPushValidationError) {
+                    this.error(error.message, {
+                        exit: error.exit,
+                        suggestions: error.suggestions,
+                    });
+                }
+                throw error;
+            }
+        }
+        else {
+            this.display(() => {
+                this.log('Branch is up to date with origin; skipping push.');
+            });
+        }
+        const doneBody = { workItem };
+        const done = await this.withSpinner('Marking work item done', () => CicdGateway.call({
+            body: doneBody,
+            endpoint: workDoneEndpoint(),
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            method: 'POST',
+        }));
+        this.display(() => {
+            this.log(done.message);
+        });
+        return {
+            branch,
+            done,
+            push: pushResult,
+            pushed: needsPush,
+            workItem,
+        };
+    }
+}
+//# sourceMappingURL=done.js.map

package/dist/commands/work/done.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"done.js","sourceRoot":"","sources":["../../../src/commands/work/done.ts"],"names":[],"mappings":"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"}

package/dist/commands/work/get.d.ts

@@ -2,7 +2,7 @@ import { AgentiaCommand } from '../../lib/agentia-command.js';
 import { type UserStory } from '../../lib/work-types.js';
 export default class WorkGet extends AgentiaCommand {
     static args: {
-        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
     static examples: string[];

package/dist/commands/work/get.js

@@ -1,23 +1,38 @@
 import { Args } from '@oclif/core';
 import { AgentiaCommand } from '../../lib/agentia-command.js';
 import { CicdGateway } from '../../lib/cicd-gateway.js';
+import { resolveWorkItemId, WorkActiveResolutionError } from '../../lib/work-active.js';
 import { formatUserStoryDetail, workEndpoint } from '../../lib/work-types.js';
 export default class WorkGet extends AgentiaCommand {
     static args = {
         id: Args.string({
-            description: 'User story ID',
-            required: true,
+            description: 'User story ID (defaults to the active work item from `work set`)',
+            required: false,
         }),
     };
     static description = 'Get a Copado user story by ID';
     static examples = [
+        '<%= config.bin %> <%= command.id %>',
         '<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU',
         '<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --json',
     ];
     async run() {
         const { args } = await this.parse(WorkGet);
+        let workItemId;
+        try {
+            workItemId = await resolveWorkItemId(args.id);
+        }
+        catch (error) {
+            if (error instanceof WorkActiveResolutionError) {
+                this.error(error.message, {
+                    exit: 1,
+                    suggestions: [`${this.config.bin} work set <id>`],
+                });
+            }
+            throw error;
+        }
         const userStory = await this.withSpinner('Fetching user story', () => CicdGateway.call({
-            endpoint: workEndpoint(args.id),
+            endpoint: workEndpoint(workItemId),
             method: 'GET',
         }));
         this.display(() => {

package/dist/commands/work/get.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/work/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,cAAc,EAAC,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAC,qBAAqB,EAAkB,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAE3F,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,cAAc;IACjD,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,eAAe;YAC5B,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IACD,MAAM,CAAU,WAAW,GAAG,+BAA+B,CAAA;IAC7D,MAAM,CAAU,QAAQ,GAAG;QACzB,uDAAuD;QACvD,8DAA8D;KAC/D,CAAA;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAExC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE,GAAG,EAAE,CACnE,WAAW,CAAC,IAAI,CAAY;YAC1B,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,EAAE,KAAK;SACd,CAAC,CACH,CAAA;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAA;QAC5C,CAAC,CAAC,CAAA;QAEF,OAAO,SAAS,CAAA;IAClB,CAAC"}
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../src/commands/work/get.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,cAAc,EAAC,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAC,iBAAiB,EAAE,yBAAyB,EAAC,MAAM,0BAA0B,CAAA;AACrF,OAAO,EAAC,qBAAqB,EAAkB,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAE3F,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,cAAc;IACjD,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,kEAAkE;YAC/E,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAA;IACD,MAAM,CAAU,WAAW,GAAG,+BAA+B,CAAA;IAC7D,MAAM,CAAU,QAAQ,GAAG;QACzB,qCAAqC;QACrC,uDAAuD;QACvD,8DAA8D;KAC/D,CAAA;IAEM,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,IAAI,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAExC,IAAI,UAAkB,CAAA;QAEtB,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,yBAAyB,EAAE,CAAC;gBAC/C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE;oBACxB,IAAI,EAAE,CAAC;oBACP,WAAW,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,gBAAgB,CAAC;iBAClD,CAAC,CAAA;YACJ,CAAC;YAED,MAAM,KAAK,CAAA;QACb,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE,GAAG,EAAE,CACnE,WAAW,CAAC,IAAI,CAAY;YAC1B,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC;YAClC,MAAM,EAAE,KAAK;SACd,CAAC,CACH,CAAA;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,IAAI,CAAC,GAAG,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAA;QAC5C,CAAC,CAAC,CAAA;QAEF,OAAO,SAAS,CAAA;IAClB,CAAC"}

package/dist/commands/work/push.d.ts

@@ -0,0 +1,7 @@
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { type WorkPushResult } from '../../lib/work-types.js';
+export default class WorkPush extends AgentiaCommand {
+    static description: string;
+    static examples: string[];
+    run(): Promise<WorkPushResult>;
+}

package/dist/commands/work/push.js

@@ -0,0 +1,67 @@
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { readLastBaseBranch } from '../../lib/defaults-store.js';
+import { getCurrentBranch, listPendingChanges } from '../../lib/git-worktree.js';
+import { performWorkPush, WorkPushValidationError } from '../../lib/work-push.js';
+import { extractUserStoryFromFeatureBranch } from '../../lib/work-types.js';
+export default class WorkPush extends AgentiaCommand {
+    static description = [
+        'Push the current feature/US-XXXX branch and register commits with Copado.',
+        'Requires a clean working tree and a base branch from `agentia work set`.',
+        'Locks the tip commit, runs `git push origin <branch>`, then calls headless work/push.',
+    ].join(' ');
+    static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --json'];
+    async run() {
+        await this.parse(WorkPush);
+        const branch = await getCurrentBranch();
+        const workItem = extractUserStoryFromFeatureBranch(branch);
+        if (workItem === undefined) {
+            this.error(`Current branch '${branch}' is not a feature/US-XXXX branch.`, {
+                exit: 1,
+                suggestions: ['Checkout a feature/US-XXXX branch created by `agentia work set`.'],
+            });
+        }
+        const pendingFiles = await listPendingChanges();
+        if (pendingFiles.length > 0) {
+            this.error([
+                'Uncommitted tracked changes present. Commit them, then try again:',
+                ...pendingFiles.map((file) => `  ${file}`),
+            ].join('\n'), {
+                exit: 2,
+                suggestions: ['git add -A && git commit', `${this.config.bin} work push`],
+            });
+        }
+        const baseBranch = (await readLastBaseBranch())?.trim();
+        if (baseBranch === undefined || baseBranch.length === 0) {
+            this.error('No base branch recorded. Run `agentia work set <work-item>` first.', {
+                exit: 1,
+            });
+        }
+        this.display(() => {
+            this.log(`Branch: ${branch}`);
+            this.log(`Work item: ${workItem}`);
+            this.log(`Base branch: ${baseBranch}`);
+        });
+        try {
+            return await performWorkPush({
+                baseBranch,
+                branch,
+                hooks: {
+                    display: (render) => this.display(render),
+                    log: (message) => this.log(message),
+                    withSpinner: (message, action) => this.withSpinner(message, action),
+                },
+                workItem,
+            });
+        }
+        catch (error) {
+            if (error instanceof WorkPushValidationError) {
+                this.error(error.message, {
+                    exit: error.exit,
+                    suggestions: error.suggestions,
+                });
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=push.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../src/commands/work/push.ts"],"names":[],"mappings":"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"}

package/dist/commands/work/set.d.ts

@@ -0,0 +1,13 @@
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { type WorkSetResult } from '../../lib/work-types.js';
+export default class WorkSet extends AgentiaCommand {
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        'base-branch': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<WorkSetResult>;
+}

package/dist/commands/work/set.js

@@ -0,0 +1,103 @@
+import { Args, Flags } from '@oclif/core';
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { CicdGateway } from '../../lib/cicd-gateway.js';
+import { writeLastWorkSelection } from '../../lib/defaults-store.js';
+import { checkoutFeatureBranch, fetchOriginBranch, listPendingChanges } from '../../lib/git-worktree.js';
+import { featureBranchName, workSetEndpoint, } from '../../lib/work-types.js';
+export default class WorkSet extends AgentiaCommand {
+    static args = {
+        id: Args.string({
+            description: 'User story ID or name',
+            required: true,
+        }),
+    };
+    static description = [
+        '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, then creates or checks out',
+        'feature/<user-story-name>.',
+    ].join(' ');
+    static examples = [
+        '<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU',
+        '<%= config.bin %> <%= command.id %> US-0001 --json',
+        '<%= config.bin %> <%= command.id %> US-0001 --base-branch develop',
+    ];
+    static flags = {
+        'base-branch': Flags.string({
+            description: 'Override the base branch returned by the work/set endpoint',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorkSet);
+        const setResponse = await this.withSpinner('Setting work item', () => CicdGateway.call({
+            body: { workItem: args.id },
+            endpoint: workSetEndpoint(),
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            method: 'POST',
+        }));
+        this.display(() => {
+            this.log(setResponse.message);
+        });
+        const overrideBaseBranch = flags['base-branch']?.trim();
+        const baseBranch = (overrideBaseBranch !== undefined && overrideBaseBranch.length > 0
+            ? overrideBaseBranch
+            : setResponse.baseBranch?.trim());
+        if (baseBranch === undefined || baseBranch.length === 0) {
+            this.error('Work set response did not include a base branch.', { exit: 1 });
+        }
+        const userStoryId = setResponse.workItem.id?.trim();
+        if (userStoryId === undefined || userStoryId.length === 0) {
+            this.error('Work set response did not include a user story ID.', { exit: 1 });
+        }
+        const userStoryName = setResponse.workItem.name?.trim();
+        if (userStoryName === undefined || userStoryName.length === 0) {
+            this.error('Work set response did not include a user story name for the feature branch.', { exit: 1 });
+        }
+        const branch = featureBranchName(userStoryName);
+        const pendingFiles = await listPendingChanges();
+        if (pendingFiles.length > 0) {
+            this.error([
+                'Pending tracked changes present. Stash or commit them, then try again:',
+                ...pendingFiles.map((file) => `  ${file}`),
+            ].join('\n'), {
+                exit: 2,
+                suggestions: [`git stash push && ${this.config.bin} work set ${args.id}`],
+            });
+        }
+        this.display(() => {
+            this.log('Working tree is clean.');
+        });
+        await this.withSpinner(`Fetching origin/${baseBranch}`, () => fetchOriginBranch(baseBranch));
+        this.display(() => {
+            this.log(`Fetched origin/${baseBranch}.`);
+        });
+        const checkout = await this.withSpinner(`Checking out ${branch}`, () => checkoutFeatureBranch(branch, baseBranch));
+        this.display(() => {
+            if (checkout.created) {
+                this.log(`Created and checked out ${checkout.branch} from ${baseBranch}.`);
+            }
+            else {
+                this.log(`Checked out existing branch ${checkout.branch}.`);
+            }
+        });
+        await writeLastWorkSelection({
+            lastBaseBranch: baseBranch,
+            lastWorkItem: userStoryName,
+            lastWorkItemId: userStoryId,
+        });
+        return {
+            baseBranch,
+            command: setResponse.command,
+            git: {
+                branch: checkout.branch,
+                branchCreated: checkout.created,
+                fetched: true,
+            },
+            message: setResponse.message,
+            workItem: setResponse.workItem,
+        };
+    }
+}
+//# sourceMappingURL=set.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../src/commands/work/set.ts"],"names":[],"mappings":"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"}

package/dist/commands/work/submit.d.ts

@@ -0,0 +1,7 @@
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { type WorkSubmitResult } from '../../lib/work-types.js';
+export default class WorkSubmit extends AgentiaCommand {
+    static description: string;
+    static examples: string[];
+    run(): Promise<WorkSubmitResult>;
+}

package/dist/commands/work/submit.js

@@ -0,0 +1,99 @@
+import { AgentiaCommand } from '../../lib/agentia-command.js';
+import { CicdGateway } from '../../lib/cicd-gateway.js';
+import { readLastBaseBranch } from '../../lib/defaults-store.js';
+import { getCurrentBranch, hasUnpushedCommits, listPendingChanges } from '../../lib/git-worktree.js';
+import { performWorkPush, WorkPushValidationError } from '../../lib/work-push.js';
+import { extractUserStoryFromFeatureBranch, workSubmitEndpoint, } from '../../lib/work-types.js';
+export default class WorkSubmit extends AgentiaCommand {
+    static description = [
+        'Submit the current feature/US-XXXX work item for pipeline quality gates and validation.',
+        'Pushes and registers commits when the branch is ahead of origin, then calls headless work/submit',
+        '(Promote Action with validate=true).',
+    ].join(' ');
+    static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --json'];
+    async run() {
+        await this.parse(WorkSubmit);
+        const branch = await getCurrentBranch();
+        const workItem = extractUserStoryFromFeatureBranch(branch);
+        if (workItem === undefined) {
+            this.error(`Current branch '${branch}' is not a feature/US-XXXX branch.`, {
+                exit: 1,
+                suggestions: ['Checkout a feature/US-XXXX branch created by `agentia work set`.'],
+            });
+        }
+        const pendingFiles = await listPendingChanges();
+        if (pendingFiles.length > 0) {
+            this.error([
+                'Uncommitted tracked changes present. Commit them, then try again:',
+                ...pendingFiles.map((file) => `  ${file}`),
+            ].join('\n'), {
+                exit: 2,
+                suggestions: ['git add -A && git commit', `${this.config.bin} work submit`],
+            });
+        }
+        this.display(() => {
+            this.log(`Branch: ${branch}`);
+            this.log(`Work item: ${workItem}`);
+        });
+        let pushResult;
+        const needsPush = await hasUnpushedCommits(branch);
+        if (needsPush) {
+            const baseBranch = (await readLastBaseBranch())?.trim();
+            if (baseBranch === undefined || baseBranch.length === 0) {
+                this.error('No base branch recorded. Run `agentia work set <work-item>` first.', {
+                    exit: 1,
+                });
+            }
+            this.display(() => {
+                this.log(`Base branch: ${baseBranch}`);
+                this.log('Unpushed commits detected; pushing before submit.');
+            });
+            try {
+                pushResult = await performWorkPush({
+                    baseBranch,
+                    branch,
+                    hooks: {
+                        display: (render) => this.display(render),
+                        log: (message) => this.log(message),
+                        withSpinner: (message, action) => this.withSpinner(message, action),
+                    },
+                    workItem,
+                });
+            }
+            catch (error) {
+                if (error instanceof WorkPushValidationError) {
+                    this.error(error.message, {
+                        exit: error.exit,
+                        suggestions: error.suggestions,
+                    });
+                }
+                throw error;
+            }
+        }
+        else {
+            this.display(() => {
+                this.log('Branch is up to date with origin; skipping push.');
+            });
+        }
+        const submitBody = { workItem };
+        const submit = await this.withSpinner('Submitting work item', () => CicdGateway.call({
+            body: submitBody,
+            endpoint: workSubmitEndpoint(),
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            method: 'POST',
+        }));
+        this.display(() => {
+            this.log(submit.message);
+        });
+        return {
+            branch,
+            push: pushResult,
+            pushed: needsPush,
+            submit,
+            workItem,
+        };
+    }
+}
+//# sourceMappingURL=submit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"submit.js","sourceRoot":"","sources":["../../../src/commands/work/submit.ts"],"names":[],"mappings":"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"}

package/dist/commands/work/update.d.ts

@@ -2,7 +2,7 @@ import { AgentiaCommand } from '../../lib/agentia-command.js';
 import { type UserStory } from '../../lib/work-types.js';
 export default class WorkUpdate extends AgentiaCommand {
     static args: {
-        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        id: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static description: string;
     static examples: string[];

package/dist/commands/work/update.js

@@ -1,17 +1,19 @@
 import { Args } from '@oclif/core';
 import { AgentiaCommand } from '../../lib/agentia-command.js';
 import { CicdGateway } from '../../lib/cicd-gateway.js';
+import { resolveWorkItemId, WorkActiveResolutionError } from '../../lib/work-active.js';
 import { buildWorkMutationPayload, collectWorkMutationFlagKeys, validateNonEmptyStringFields, WORK_STRING_VALIDATION_KEYS, workMutationFlags, } from '../../lib/work-flags.js';
 import { workEndpoint } from '../../lib/work-types.js';
 export default class WorkUpdate extends AgentiaCommand {
     static args = {
         id: Args.string({
-            description: 'User story ID',
-            required: true,
+            description: 'User story ID (defaults to the active work item from `work set`)',
+            required: false,
         }),
     };
     static description = 'Update a Copado user story by ID';
     static examples = [
+        '<%= config.bin %> <%= command.id %> --title "Updated story"',
         '<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --title "Updated story"',
         '<%= config.bin %> <%= command.id %> a0SKC000000CmZ2AU --status "In Progress" --json',
     ];
@@ -23,8 +25,8 @@ export default class WorkUpdate extends AgentiaCommand {
             this.error('Must provide at least one flag to update.', {
                 exit: 2,
                 suggestions: [
-                    `${this.config.bin} work update ${args.id} --title <title>`,
-                    `${this.config.bin} work update ${args.id} --status <status>`,
+                    `${this.config.bin} work update --title <title>`,
+                    `${this.config.bin} work update --status <status>`,
                 ],
             });
         }
@@ -33,9 +35,22 @@ export default class WorkUpdate extends AgentiaCommand {
         if (validationError !== undefined) {
             this.error(validationError, { exit: 2 });
         }
+        let workItemId;
+        try {
+            workItemId = await resolveWorkItemId(args.id);
+        }
+        catch (error) {
+            if (error instanceof WorkActiveResolutionError) {
+                this.error(error.message, {
+                    exit: 1,
+                    suggestions: [`${this.config.bin} work set <id>`],
+                });
+            }
+            throw error;
+        }
         const userStory = await this.withSpinner('Updating user story', () => CicdGateway.call({
             body: payload,
-            endpoint: workEndpoint(args.id),
+            endpoint: workEndpoint(workItemId),
             headers: {
                 'Content-Type': 'application/json',
             },
@@ -43,7 +58,7 @@ export default class WorkUpdate extends AgentiaCommand {
         }));
         this.display(() => {
             const name = userStory.name ?? userStory.title ?? 'unknown name';
-            const id = userStory.id ?? args.id;
+            const id = userStory.id ?? workItemId;
             this.log(`Updated user story ${name} (ID: ${id}).`);
         });
         return userStory;

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

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/work/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,aAAa,CAAA;AAEhC,OAAO,EAAC,cAAc,EAAC,MAAM,8BAA8B,CAAA;AAC3D,OAAO,EAAC,WAAW,EAAC,MAAM,2BAA2B,CAAA;AACrD,OAAO,EACL,wBAAwB,EACxB,2BAA2B,EAC3B,4BAA4B,EAC5B,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,yBAAyB,CAAA;AAChC,OAAO,EAAiB,YAAY,EAAC,MAAM,yBAAyB,CAAA;AAEpE,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,cAAc;IACpD,MAAM,CAAU,IAAI,GAAG;QACrB,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;YACd,WAAW,EAAE,eAAe;YAC5B,QAAQ,EAAE,IAAI;SACf,CAAC;KACH,CAAA;IACD,MAAM,CAAU,WAAW,GAAG,kCAAkC,CAAA;IAChE,MAAM,CAAU,QAAQ,GAAG;QACzB,+EAA+E;QAC/E,qFAAqF;KACtF,CAAA;IACD,MAAM,CAAU,KAAK,GAAG,iBAAiB,CAAA;IAElC,KAAK,CAAC,GAAG;QACd,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;QAClD,MAAM,YAAY,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAA;QAEvD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,2CAA2C,EAAE;gBACtD,IAAI,EAAE,CAAC;gBACP,WAAW,EAAE;oBACX,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,gBAAgB,IAAI,CAAC,EAAE,kBAAkB;oBAC3D,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,gBAAgB,IAAI,CAAC,EAAE,oBAAoB;iBAC9D;aACF,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,eAAe,GAAG,4BAA4B,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAA;QAE1F,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,EAAC,IAAI,EAAE,CAAC,EAAC,CAAC,CAAA;QACxC,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE,GAAG,EAAE,CACnE,WAAW,CAAC,IAAI,CAAY;YAC1B,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;aACnC;YACD,MAAM,EAAE,OAAO;SAChB,CAAC,CACH,CAAA;QAED,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,IAAI,cAAc,CAAA;YAChE,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAA;YAClC,IAAI,CAAC,GAAG,CAAC,sBAAsB,IAAI,SAAS,EAAE,IAAI,CAAC,CAAA;QACrD,CAAC,CAAC,CAAA;QAEF,OAAO,SAAS,CAAA;IAClB,CAAC"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/commands/work/update.ts"],"names":[],"mappings":"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"}

package/dist/lib/cicd-gateway.d.ts

@@ -44,13 +44,20 @@ export type CicdEndpointOptions = {
     region?: CicdRegion;
 };
 export type HttpRequestFn = (url: URL, method: string, headers: Record<string, string>, body: unknown) => Promise<string>;
+export type CicdGatewayErrorRequest = {
+    method?: string;
+    url?: string;
+};
 export declare class CicdGatewayError extends Error {
     readonly categories: string[];
     readonly code?: string;
+    readonly requestMethod?: string;
+    readonly requestUrl?: string;
     readonly statusCode?: number;
     constructor(message: string, options?: {
         categories?: string[];
         code?: string;
+        request?: CicdGatewayErrorRequest;
         statusCode?: number;
     });
 }
@@ -58,7 +65,8 @@ export declare function gatewayUserAgent(): string;
 export declare function createTransactionId(): string;
 export declare function normalizeCicdBaseUrl(value: string): string;
 export declare function sanitizeCicdErrorMessage(message: string): string;
-export declare function formatCicdGatewayError(status: number, raw: string): Error;
+export declare function maskUrlSecrets(url: string | URL): string;
+export declare function formatCicdGatewayError(status: number, raw: string, request?: CicdGatewayErrorRequest): Error;
 export declare function cicdApiUrl(serverUrl: string, apiKey: string): URL;
 export declare function maskedCicdApiUrl(serverUrl: string): string;
 export declare function discoverCicdBaseUrl(apiKey: string): Promise<string>;