@copado/agentia-cli 1.0.0-beta.1 → 1.0.0-beta.2

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

@@ -1,141 +1,137 @@
-import { confirm } from '@inquirer/prompts';
 import { Args, Flags } from '@oclif/core';
 import { AgentiaCommand } from '../../../lib/agentia-command.js';
-import { formatPromotionRunResult, isPromotionRunExecutionError, parseIgnoredMetadataJson, performPromotionRun, PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS, promotionRunErrorJson, PromotionRunValidationError, resolvePromotionIdForWorkItem, } from '../../../lib/promotion-run.js';
-import { resolveWorkItemId, WorkActiveResolutionError } from '../../../lib/work-active.js';
+import { collectPromoteUserStoryIds, formatWorkPromoteResult, performWorkPromote, WorkPromoteConflictError, WorkPromoteValidationError, } from '../../../lib/work-promote.js';
 export default class WorkPromote extends AgentiaCommand {
     static args = {
-        id: Args.string({
-            description: 'User Story ID (defaults to the active work item from `work set`)',
+        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.',
+            multiple: true,
             required: false,
         }),
     };
     static description = [
-        'Promote the explicit or active User Story through its Copado Promotion.',
-        'Requires --cloud and selects promote-only unless --deploy is passed.',
+        'Experimental: skips Quality Gates. Requires enableLocalPromote true in .agentia/config.json.',
+        'Create a promotion for one or more user stories and merge each feature/<name> branch into promotion/<promotionName>.',
+        'The promotion branch is created from the destination environment branch.',
+        'Without --backpromote, the stories promote forward from their source environment to the next pipeline environment.',
+        'With --backpromote, pass --destination-branch. The destination environment is the pipeline environment whose connection branch matches that name, and the source is the next environment above it.',
+        'Story merges stop at the first conflict and the promotion status is set to Merge Conflict.',
+        'Resolve those files, then re-run with --promotion=<name-or-id> --continue to commit the merge, merge any remaining stories, and finish the promotion.',
+        'To discard a conflicted merge, re-run with --promotion=<name-or-id> --abort (runs git merge --abort and sets the promotion status to Draft).',
+        'That continue command repeats --validate or --deploy and --sf-alias when the original command used them.',
+        'After every story merges, the promotion branch is pushed.',
+        'Without --validate or --deploy, the promotion status is set to Completed.',
+        'With --validate or --deploy, --sf-alias is required. The command writes a temporary package.xml and postdestructivechanges.xml from the promotion metadata and runs sf project deploy start --test-level NoTestRun -o <alias>.',
+        '--validate adds --dry-run, does not merge the destination branch, and sets the promotion status to Validated.',
+        '--deploy merges the promotion branch into the destination branch and sets the promotion status to Completed only after that deployment succeeds.',
+        'User story records are not updated.',
     ].join(' ');
     static examples = [
-        '<%= config.bin %> <%= command.id %> --cloud',
-        '<%= config.bin %> <%= command.id %> a07XXXXXXXXXXXXXXX --cloud --promotion-id a0BXXXXXXXXXXXXXXX',
-        '<%= config.bin %> <%= command.id %> --cloud --deploy --json',
+        '<%= config.bin %> <%= command.id %> a16P7000006By3pIAC',
+        '<%= config.bin %> <%= command.id %> a16P7000006By3pIAC a16P7000006By4qIAC',
+        '<%= config.bin %> <%= command.id %> a16P7000006By3pIAC --backpromote --destination-branch dev1-sfp',
+        '<%= config.bin %> <%= command.id %> a16P7000006By3pIAC --validate --sf-alias destOrg',
+        '<%= config.bin %> <%= command.id %> a16P7000006By3pIAC --deploy --sf-alias destOrg',
+        '<%= config.bin %> <%= command.id %> --promotion=P29354 --continue',
+        '<%= config.bin %> <%= command.id %> --promotion=P29354 --abort',
+        '<%= config.bin %> <%= command.id %> a16P7000006By3pIAC --json',
     ];
     static flags = {
-        cloud: Flags.boolean({
+        abort: Flags.boolean({
             default: false,
-            description: 'Use the Copado cloud promotion API. Required for this command.',
+            description: 'Abort an in-progress merge (`git merge --abort`) and set the promotion status to Draft. Requires --promotion. Exclusive with --continue.',
+            exclusive: ['continue'],
         }),
-        deploy: Flags.boolean({
+        backpromote: Flags.boolean({
             default: false,
-            description: 'Use merge_and_deploy instead of promote-only merge.',
+            description: 'Create a back promotion. Requires --destination-branch. Omit to promote forward to the next pipeline environment.',
         }),
-        'deployment-step-id': Flags.string({
-            description: 'Ordered deployment-step Salesforce ID. Can be provided multiple times with --deploy.',
-            multiple: true,
+        continue: Flags.boolean({
+            default: false,
+            description: 'Commit a resolved merge on promotion/<name> and finish the remaining story merges. Requires --promotion.',
+            exclusive: ['abort'],
         }),
-        'ignored-metadata-json': Flags.string({
-            description: 'JSON array to persist through ignored-metadata before starting the promotion.',
+        deploy: Flags.boolean({
+            default: false,
+            description: 'Deploy the promotion metadata with sf project deploy start, then merge the promotion branch into the destination branch and set the promotion status to Completed. Requires --sf-alias.',
+            exclusive: ['validate'],
         }),
-        'promotion-id': Flags.string({
-            description: 'Explicit 18-character Promotion ID when the User Story belongs to multiple promotions.',
+        'destination-branch': Flags.string({
+            dependsOn: ['backpromote'],
+            description: 'Destination environment Git branch for --backpromote. The destination environment is the pipeline environment whose connection branch matches this name.',
         }),
-        'recreate-promotion-branch': Flags.boolean({
-            description: 'Recreate the promotion branch before execution. Requires confirmation or --yes.',
+        'destination-credential': Flags.string({
+            description: 'Credential ID posted as destinationCredentialId. Defaults to the destination environment default credential for a forward promotion, or the next/source environment default credential for --backpromote.',
         }),
-        wait: Flags.boolean({
-            allowNo: true,
-            default: true,
-            description: 'Poll promotion and deployment executions to terminal status.',
+        promotion: Flags.string({
+            description: 'Promotion Id or name for --continue after a merge conflict, or for --abort.',
         }),
-        'wait-timeout': Flags.integer({
-            default: PROMOTION_RUN_DEFAULT_TIMEOUT_SECONDS,
-            description: 'Maximum total seconds to wait for promotion and deployment executions.',
+        'sf-alias': Flags.string({
+            description: 'Salesforce org alias or username for --validate or --deploy. Passed to sf project deploy start -o.',
         }),
-        yes: Flags.boolean({
-            char: 'y',
+        validate: Flags.boolean({
             default: false,
-            description: 'Confirm promotion branch recreation without prompting.',
+            description: 'Validate the promotion metadata with sf project deploy start --dry-run. Does not merge the destination branch. Sets the promotion status to Validated. Requires --sf-alias.',
+            exclusive: ['deploy'],
         }),
     };
     async run() {
         const { args, flags } = await this.parse(WorkPromote);
-        const promoteFlags = flags;
-        if (!promoteFlags.cloud) {
-            this.error('Only cloud promotion is supported for this command. Pass --cloud.', { exit: 2 });
-        }
-        if (!Number.isInteger(promoteFlags['wait-timeout']) || promoteFlags['wait-timeout'] <= 0) {
-            this.error('--wait-timeout must be a positive integer.', { exit: 2 });
-        }
-        if (!promoteFlags.deploy && promoteFlags['deployment-step-id'] !== undefined) {
-            this.error('--deployment-step-id requires --deploy.', { exit: 2 });
-        }
-        let workItemId;
+        const userStoryIds = collectPromoteUserStoryIds(args.userStoryIds);
         try {
-            workItemId = await resolveWorkItemId(args.id);
-        }
-        catch (error) {
-            if (error instanceof WorkActiveResolutionError) {
-                this.error(error.message, {
-                    exit: 1,
-                    suggestions: [`${this.config.bin} cicd work set <id>`],
-                });
-            }
-            throw error;
-        }
-        try {
-            const promotionId = await this.withSpinner('Resolving User Story promotion', () => resolvePromotionIdForWorkItem(workItemId, promoteFlags['promotion-id']));
-            if (promoteFlags['recreate-promotion-branch'] === true && !promoteFlags.yes) {
-                if (this.jsonEnabled() || !process.stdin.isTTY) {
-                    this.error('Promotion branch recreation requires confirmation. Pass --yes for headless or JSON execution.', {
-                        exit: 2,
-                    });
-                }
-                const confirmed = await confirm({
-                    default: false,
-                    message: `Recreate the promotion branch for ${promotionId}? Existing promotion branch changes may be replaced.`,
-                });
-                if (!confirmed) {
-                    this.error('Promotion canceled.', { exit: 1 });
-                }
-            }
-            const result = await performPromotionRun({
-                deploymentStepIds: promoteFlags['deployment-step-id'],
+            const result = await performWorkPromote({
+                backpromote: flags.backpromote === true,
+                cliBin: this.config.bin,
                 hooks: {
-                    log: (message) => this.display(() => this.log(message)),
+                    log: (message) => {
+                        this.display(() => {
+                            this.log(message);
+                        });
+                    },
                     withSpinner: (message, action) => this.withSpinner(message, action),
                 },
-                ignoredMetadata: parseIgnoredMetadataJson(promoteFlags['ignored-metadata-json']),
-                operation: promoteFlags.deploy ? 'merge_and_deploy' : 'merge',
-                promotionId,
-                recreatePromotionBranch: promoteFlags['recreate-promotion-branch'],
-                timeoutSeconds: promoteFlags['wait-timeout'],
-                wait: promoteFlags.wait,
+                userStoryIds,
+                ...(flags.abort ? { abort: true } : {}),
+                ...(flags.continue ? { continue: true } : {}),
+                ...(flags.deploy ? { deploy: true } : {}),
+                ...(flags['destination-branch'] === undefined ? {} : { destinationBranch: flags['destination-branch'] }),
+                ...(flags['destination-credential'] === undefined
+                    ? {}
+                    : { destinationCredentialId: flags['destination-credential'] }),
+                ...(flags.promotion === undefined ? {} : { promotion: flags.promotion }),
+                ...(flags['sf-alias'] === undefined ? {} : { sfAlias: flags['sf-alias'] }),
+                ...(flags.validate ? { validate: true } : {}),
             });
-            const workResult = { ...result, workItemId };
             this.display(() => {
-                this.log(`User Story: ${workItemId}`);
-                this.log(formatPromotionRunResult(result));
+                this.log(formatWorkPromoteResult(result));
             });
-            return workResult;
+            return result;
         }
         catch (error) {
-            if (error instanceof PromotionRunValidationError) {
-                this.error(error.message, { exit: 2 });
+            if (error instanceof WorkPromoteConflictError) {
+                const { suggestions } = error;
+                const suggestionOptions = suggestions === undefined ? {} : { suggestions };
+                if (this.jsonEnabled()) {
+                    const message = error.gitStatus === undefined || error.gitStatus.length === 0
+                        ? error.message
+                        : `${error.message}\n\n${error.gitStatus}`;
+                    this.error(message, { exit: error.exit, ...suggestionOptions });
+                }
+                this.error(error.message, { exit: false, ...suggestionOptions });
+                if (error.gitStatus !== undefined && error.gitStatus.length > 0) {
+                    this.log('');
+                    this.log(error.gitStatus);
+                }
+                this.exit(error.exit);
             }
-            if (isPromotionRunExecutionError(error)) {
-                this.display(() => {
-                    if (error.result !== undefined) {
-                        this.log(`User Story: ${workItemId}`);
-                        this.log(formatPromotionRunResult(error.result));
-                    }
+            if (error instanceof WorkPromoteValidationError) {
+                this.error(error.message, {
+                    exit: error.exit,
+                    ...(error.suggestions === undefined ? {} : { suggestions: error.suggestions }),
                 });
-                error.oclif = { exit: 1 };
             }
             throw error;
         }
     }
-    toErrorJson(err) {
-        const base = super.toErrorJson(err);
-        return promotionRunErrorJson(base, err);
-    }
 }
 //# sourceMappingURL=promote.js.map

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

@@ -5,7 +5,7 @@ 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 { performWorkSetNone, WorkSetNoneValidationError } from '../../../lib/work-set-none.js';
-import { isWorkSetWarning, parseWorkSetSelection, toWorkSetWarningResult } from '../../../lib/work-set-selection.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 {
     static args = {
@@ -20,7 +20,8 @@ export default class WorkSet extends AgentiaCommand {
         'fetches the work item base branch from origin, fetches the feature branch when it',
         'exists on origin, then creates or checks out feature/<user-story-name> from the',
         'remote feature branch when present, otherwise from the base branch.',
-        'A gateway warning prints the message, skips git, and leaves local work context unchanged.',
+        '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).',
@@ -111,6 +112,7 @@ export default class WorkSet extends AgentiaCommand {
             this.log(setResponse.message);
         });
         if (isWorkSetWarning(setResponse)) {
+            await writeWorkSetWarningSelection(setResponse);
             return toWorkSetWarningResult(setResponse);
         }
         let selection;

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

@@ -10,6 +10,7 @@ import { openUrl } from '../../../lib/open-browser.js';
 import { pickWorkDoneFlags, runWorkDone, workDoneFlags } from '../../../lib/work-done.js';
 import { reportLocalQualityGatesFailure, reportLocalQualityGatesOutcome, } from '../../../lib/work-local-run-tests.js';
 import { performWorkPush, resolveActiveFeatureWorkItem, resolveWorkPushContext, resolveWorkPushNeed, 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 {
@@ -19,6 +20,7 @@ export default class WorkSubmit extends AgentiaCommand {
         'pushes and registers commits when the branch is ahead of origin, then calls headless work/submit',
         '(Promote Action with validate=true).',
         'When the last pending related job template name contains Commit, waits up to 5 minutes for that job before submitting.',
+        'Before submit or promote, counts user stories ahead and behind between the source environment and the next pipeline environment, and warns when stories behind might cause promotion conflicts.',
         '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(' ');
@@ -201,6 +203,10 @@ export default class WorkSubmit extends AgentiaCommand {
                     this.log('Branch is up to date with origin; skipping push.');
                 });
             }
+            const userStoriesAheadBehind = await reportSubmitUserStoriesAheadBehind(workItem, {
+                log: (message) => this.display(() => this.log(message)),
+                warn: (message) => this.warn(message),
+            });
             await waitForPendingCommitJobBeforeSubmit(this, workItem);
             const submit = await this.withSpinner('Submitting work item', () => CicdGateway.call({
                 body: attachCapturedOutputLogs({ workItem }),
@@ -221,6 +227,7 @@ export default class WorkSubmit extends AgentiaCommand {
                 pushed: needsPush,
                 qualityGates,
                 submit,
+                ...(userStoriesAheadBehind === undefined ? {} : { userStoriesAheadBehind }),
                 workItem,
             };
         }, commandStdioCaptureOptions(this));

package/dist/lib/defaults-store.js

@@ -8,6 +8,7 @@ const isValidUserContext = modules["defaults-store.js"]["isValidUserContext"]
 const migrateUserSettingsFromProjectConfig = modules["defaults-store.js"]["migrateUserSettingsFromProjectConfig"]
 const readCredentialSyncReceipt = modules["defaults-store.js"]["readCredentialSyncReceipt"]
 const readDefaults = modules["defaults-store.js"]["readDefaults"]
+const readEnableLocalPromote = modules["defaults-store.js"]["readEnableLocalPromote"]
 const readLastApexTestClassesSelected = modules["defaults-store.js"]["readLastApexTestClassesSelected"]
 const readLastBaseBranch = modules["defaults-store.js"]["readLastBaseBranch"]
 const readLastDevOrgBranch = modules["defaults-store.js"]["readLastDevOrgBranch"]
@@ -31,4 +32,4 @@ const writeDefaults = modules["defaults-store.js"]["writeDefaults"]
 const writeLastCommitSelections = modules["defaults-store.js"]["writeLastCommitSelections"]
 const writeLastWorkSelection = modules["defaults-store.js"]["writeLastWorkSelection"]
 const writeUserContext = modules["defaults-store.js"]["writeUserContext"]
-export {DEFAULT_WORK_PUSH_RETRY_TIMEOUT_SECONDS, clearCredentialSyncReceipt, clearLastKeysFromUserConfig, clearUserContext, getDefaultsStorePaths, isValidUserContext, migrateUserSettingsFromProjectConfig, readCredentialSyncReceipt, readDefaults, readLastApexTestClassesSelected, readLastBaseBranch, readLastDevOrgBranch, readLastFullMetadataSelected, readLastPermissionSelected, readLastPullRequestBaseUrl, readLastWorkItem, readLastWorkItemId, readLastWorkItemTitle, readSkipNestedMetadataDetection, readSkipPullRequest, readUserContext, readWorkPushRetryTimeoutSeconds, resetDefaultsStorePathsForTests, resolveDefaults, setDefaultsStorePathsForTests, setDefaultsStoreProjectRoot, unsetDefaults, writeCredentialSyncReceipt, writeDefaults, writeLastCommitSelections, writeLastWorkSelection, writeUserContext};
+export {DEFAULT_WORK_PUSH_RETRY_TIMEOUT_SECONDS, clearCredentialSyncReceipt, clearLastKeysFromUserConfig, clearUserContext, getDefaultsStorePaths, isValidUserContext, migrateUserSettingsFromProjectConfig, readCredentialSyncReceipt, readDefaults, readEnableLocalPromote, readLastApexTestClassesSelected, readLastBaseBranch, readLastDevOrgBranch, readLastFullMetadataSelected, readLastPermissionSelected, readLastPullRequestBaseUrl, readLastWorkItem, readLastWorkItemId, readLastWorkItemTitle, readSkipNestedMetadataDetection, readSkipPullRequest, readUserContext, readWorkPushRetryTimeoutSeconds, resetDefaultsStorePathsForTests, resolveDefaults, setDefaultsStorePathsForTests, setDefaultsStoreProjectRoot, unsetDefaults, writeCredentialSyncReceipt, writeDefaults, writeLastCommitSelections, writeLastWorkSelection, writeUserContext};

package/dist/lib/git-sizer.js

@@ -0,0 +1,5 @@
+import {modules} from './runtime.js';
+const analyzeGitRepository = modules["git-sizer.js"]["analyzeGitRepository"]
+const gitSizerRows = modules["git-sizer.js"]["gitSizerRows"]
+const parseGitSizerMetrics = modules["git-sizer.js"]["parseGitSizerMetrics"]
+export {analyzeGitRepository, gitSizerRows, parseGitSizerMetrics};

package/dist/lib/git-worktree.js

@@ -6,8 +6,11 @@ const checkoutFeatureBranch = modules["git-worktree.js"]["checkoutFeatureBranch"
 const checkoutPreferredBranch = modules["git-worktree.js"]["checkoutPreferredBranch"]
 const commitAllTrackedChanges = modules["git-worktree.js"]["commitAllTrackedChanges"]
 const commitAllowEmpty = modules["git-worktree.js"]["commitAllowEmpty"]
+const commitCurrentMerge = modules["git-worktree.js"]["commitCurrentMerge"]
 const commitStagedChanges = modules["git-worktree.js"]["commitStagedChanges"]
 const countCommitsSince = modules["git-worktree.js"]["countCommitsSince"]
+const createAndCheckoutBranch = modules["git-worktree.js"]["createAndCheckoutBranch"]
+const fetchAndCheckoutBranch = modules["git-worktree.js"]["fetchAndCheckoutBranch"]
 const fetchOriginBranch = modules["git-worktree.js"]["fetchOriginBranch"]
 const fetchOriginBranchIfExists = modules["git-worktree.js"]["fetchOriginBranchIfExists"]
 const getCommitsNameStatus = modules["git-worktree.js"]["getCommitsNameStatus"]
@@ -15,22 +18,34 @@ const getCurrentBranch = modules["git-worktree.js"]["getCurrentBranch"]
 const getFileAtRef = modules["git-worktree.js"]["getFileAtRef"]
 const getGitRepoRoot = modules["git-worktree.js"]["getGitRepoRoot"]
 const getHeadCommitId = modules["git-worktree.js"]["getHeadCommitId"]
+const getHumanGitStatus = modules["git-worktree.js"]["getHumanGitStatus"]
 const getMergeBase = modules["git-worktree.js"]["getMergeBase"]
 const getRemoteUrl = modules["git-worktree.js"]["getRemoteUrl"]
 const hasUnpushedCommits = modules["git-worktree.js"]["hasUnpushedCommits"]
+const isAncestor = modules["git-worktree.js"]["isAncestor"]
 const isInsideGitWorkTree = modules["git-worktree.js"]["isInsideGitWorkTree"]
+const isMergeInProgress = modules["git-worktree.js"]["isMergeInProgress"]
+const isSafeGitBranchName = modules["git-worktree.js"]["isSafeGitBranchName"]
+const listDiffNamesVsHead = modules["git-worktree.js"]["listDiffNamesVsHead"]
 const listPendingChanges = modules["git-worktree.js"]["listPendingChanges"]
 const listStagedChanges = modules["git-worktree.js"]["listStagedChanges"]
+const listUnmergedFiles = modules["git-worktree.js"]["listUnmergedFiles"]
 const localBranchExists = modules["git-worktree.js"]["localBranchExists"]
+const mergeFfOnly = modules["git-worktree.js"]["mergeFfOnly"]
+const mergeNoFf = modules["git-worktree.js"]["mergeNoFf"]
+const mergeNoFfNoCommit = modules["git-worktree.js"]["mergeNoFfNoCommit"]
 const mergeTheirsIgnoreSpaceChange = modules["git-worktree.js"]["mergeTheirsIgnoreSpaceChange"]
 const originBranchRef = modules["git-worktree.js"]["originBranchRef"]
 const originFetchRefspec = modules["git-worktree.js"]["originFetchRefspec"]
+const parseNameOnly = modules["git-worktree.js"]["parseNameOnly"]
 const parsePorcelainPaths = modules["git-worktree.js"]["parsePorcelainPaths"]
 const pullOriginBranch = modules["git-worktree.js"]["pullOriginBranch"]
 const pushOriginBranch = modules["git-worktree.js"]["pushOriginBranch"]
+const pushOriginBranches = modules["git-worktree.js"]["pushOriginBranches"]
 const resetGitExecForTests = modules["git-worktree.js"]["resetGitExecForTests"]
 const resetHardHead = modules["git-worktree.js"]["resetHardHead"]
 const restoreFeatureBranch = modules["git-worktree.js"]["restoreFeatureBranch"]
+const restoreHeadPaths = modules["git-worktree.js"]["restoreHeadPaths"]
 const setGitExecForTests = modules["git-worktree.js"]["setGitExecForTests"]
 const stageAndCommit = modules["git-worktree.js"]["stageAndCommit"]
-export {NAME_STATUS_PRETTY_FORMAT, abortMerge, checkoutBranch, checkoutFeatureBranch, checkoutPreferredBranch, commitAllTrackedChanges, commitAllowEmpty, commitStagedChanges, countCommitsSince, fetchOriginBranch, fetchOriginBranchIfExists, getCommitsNameStatus, getCurrentBranch, getFileAtRef, getGitRepoRoot, getHeadCommitId, getMergeBase, getRemoteUrl, hasUnpushedCommits, isInsideGitWorkTree, listPendingChanges, listStagedChanges, localBranchExists, mergeTheirsIgnoreSpaceChange, originBranchRef, originFetchRefspec, parsePorcelainPaths, pullOriginBranch, pushOriginBranch, resetGitExecForTests, resetHardHead, restoreFeatureBranch, setGitExecForTests, stageAndCommit};
+export {NAME_STATUS_PRETTY_FORMAT, abortMerge, checkoutBranch, checkoutFeatureBranch, checkoutPreferredBranch, commitAllTrackedChanges, commitAllowEmpty, commitCurrentMerge, commitStagedChanges, countCommitsSince, createAndCheckoutBranch, fetchAndCheckoutBranch, fetchOriginBranch, fetchOriginBranchIfExists, getCommitsNameStatus, getCurrentBranch, getFileAtRef, getGitRepoRoot, getHeadCommitId, getHumanGitStatus, getMergeBase, getRemoteUrl, hasUnpushedCommits, isAncestor, isInsideGitWorkTree, isMergeInProgress, isSafeGitBranchName, listDiffNamesVsHead, listPendingChanges, listStagedChanges, listUnmergedFiles, localBranchExists, mergeFfOnly, mergeNoFf, mergeNoFfNoCommit, mergeTheirsIgnoreSpaceChange, originBranchRef, originFetchRefspec, parseNameOnly, parsePorcelainPaths, pullOriginBranch, pushOriginBranch, pushOriginBranches, resetGitExecForTests, resetHardHead, restoreFeatureBranch, restoreHeadPaths, setGitExecForTests, stageAndCommit};

package/dist/lib/health-check.js

@@ -0,0 +1,3 @@
+import {modules} from './runtime.js';
+const runOrganizationHealthChecks = modules["health-check.js"]["runOrganizationHealthChecks"]
+export {runOrganizationHealthChecks};

package/dist/lib/mcp/command-id.js

@@ -24,6 +24,7 @@ const HYPHENATED_TOKEN_REPLACEMENTS = [
     ['preview_updates', 'preview-updates'],
     ['convert_old', 'convert-old'],
     ['get_detail', 'get-detail'],
+    ['health_check', 'health-check'],
     ['save_detail', 'save-detail'],
     ['stage_connection', 'stage-connection'],
     ['run_local', 'run-local'],

package/dist/lib/mcp/health-check-tools.js

@@ -0,0 +1,16 @@
+import { runOrganizationHealthChecks } from '../health-check.js';
+import { safelyHandleTool } from './result.js';
+async function healthCheck() {
+    return runOrganizationHealthChecks();
+}
+export const agentiaMcpHealthCheckToolHandlers = {
+    healthCheck,
+};
+export function registerAgentiaMcpHealthCheckTools(server) {
+    server.registerTool('agentia_health_check', {
+        description: 'Run organization-scoped governance health checks via the CICD gateway.',
+        inputSchema: {},
+        title: 'Agentia Health Check',
+    }, () => safelyHandleTool(() => healthCheck()));
+}
+//# sourceMappingURL=health-check-tools.js.map

package/dist/lib/mcp/server.js

@@ -6,6 +6,7 @@ import { migrateUserSettingsFromProjectConfig } from '../defaults-store.js';
 import { applyProjectRoot } from '../project-root.js';
 import { runWithMcpRequestSignal } from './request-context.js';
 import { runWithMcpToolContext } from './result.js';
+import { withToolAnnotations } from './tool-annotations.js';
 import { registerAgentiaMcpTools } from './tools.js';
 const require = createRequire(import.meta.url);
 const packageJson = require('../../../package.json');
@@ -43,7 +44,7 @@ function combineSignals(requestSignal, lifecycleSignal) {
 }
 function wrapMcpToolRegistration(server, lifecycleSignal) {
     const registerTool = server.registerTool.bind(server);
-    server.registerTool = ((name, config, handler) => registerTool(name, config, (...args) => {
+    server.registerTool = ((name, config, handler) => registerTool(name, withToolAnnotations(name, config), (...args) => {
         const extra = args.at(-1);
         const { dispose, signal } = combineSignals(extra?.signal, lifecycleSignal);
         return runWithMcpRequestSignal(signal, async () => {