@software-dlc/cli 0.157.2

package/dist/cli-branch-history.js

@@ -0,0 +1,319 @@
+import { setTimeout as sleep } from 'node:timers/promises';
+import { parseArgs } from 'node:util';
+import { z } from 'zod';
+import { applyWorkspaceProposal, approvePullRequest, buildPullRequestReviewEvidence, commitBranch, getBranchSummary, getPullRequest, GraphBranchHistoryError, mergePullRequest, preparePullRequestReview } from '@software-dlc/graph/client';
+import { BRANCH_APPLY_USAGE, BRANCH_COMMIT_USAGE, PULL_REQUEST_USAGE } from './cli-help.js';
+import { checkOperation, operationSignal } from './local/operation.js';
+const uuid = z.string().uuid();
+function parseOptions(input) {
+    const option_names = Object.keys(input.schema.shape);
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: input.args,
+            options: Object.fromEntries(option_names.map((name) => [name, { type: 'string' }])),
+            strict: true,
+            allowPositionals: false,
+            tokens: true
+        });
+    }
+    catch (error) {
+        throw new Error(`${error instanceof Error ? error.message : String(error)}\n${input.usage}`);
+    }
+    const seen = new Set();
+    for (const token of parsed.tokens ?? []) {
+        if (token.kind !== 'option')
+            continue;
+        if (seen.has(token.name)) {
+            throw new Error(`Duplicate --${token.name}.\n${input.usage}`);
+        }
+        seen.add(token.name);
+    }
+    const result = input.schema.strict().safeParse(parsed.values);
+    if (!result.success) {
+        const issue = result.error.issues[0];
+        throw new Error(`Invalid --${String(issue?.path[0] ?? 'option')}: ${issue?.message ?? 'invalid value'}\n${input.usage}`);
+    }
+    return result.data;
+}
+async function call(request) {
+    checkOperation();
+    try {
+        return await request();
+    }
+    catch (error) {
+        if (error instanceof GraphBranchHistoryError) {
+            throw new Error(`${error.message} (status ${error.status}${error.reason ? `, reason ${error.reason}` : ''})`);
+        }
+        throw error;
+    }
+    finally {
+        checkOperation();
+    }
+}
+function requireProject(input) {
+    if (input.project_id !== input.expected_project_id) {
+        throw new Error(`${input.what} belongs to project ${input.project_id}, not this checkout's project ${input.expected_project_id}.`);
+    }
+}
+function localRevision(local_workspace, workspace_id) {
+    return local_workspace?.worktree_id === workspace_id
+        ? local_workspace.revision
+        : null;
+}
+/**
+ * The apply command for a workspace. Its key names the proposal and Working
+ * revisions, so after an apply moves the Working graph the next suggestion is
+ * a new key, not a replay of the finished one.
+ */
+function applyCommand(input) {
+    const branch = input.explicit_branch ? ` --branch-id ${input.branch_id}` : '';
+    return input.revision === null || input.working_revision === null
+        ? `sdlc branch apply --idempotency-key <key> --expected-workspace-revision <n>${branch}`
+        : `sdlc branch apply --idempotency-key apply-${input.workspace_id}-r${input.revision}-w${input.working_revision}${branch}`;
+}
+/** About 100 seconds of waits for a commit whose graph validation is running. */
+const VALIDATION_WAIT_MS = [2, 3, 5, 5, 10, 15, 20, 20, 20].map((seconds) => seconds * 1000);
+/** `sdlc branch commit`: commits the bound (or named) branch's Working changes. */
+export async function branchCommitCommand(input) {
+    const options = parseOptions({
+        args: input.args,
+        usage: BRANCH_COMMIT_USAGE,
+        schema: z.object({
+            message: z.string().trim().min(1).max(5_000),
+            'expected-head': uuid,
+            'branch-id': uuid.optional()
+        })
+    });
+    const branch_id = options['branch-id'] ?? input.bound_branch_id;
+    if (!branch_id) {
+        throw new Error(`Current Git branch is not bound; pass --branch-id.\n${BRANCH_COMMIT_USAGE}`);
+    }
+    if (!options['branch-id']) {
+        // Say which branch the binding chose before writing to it.
+        process.stderr.write(`[sdlc] committing bound branch ${branch_id}\n`);
+    }
+    const branch = await call(() => getBranchSummary(input.client, branch_id, { signal: operationSignal() }));
+    requireProject({
+        what: `Branch ${branch_id}`,
+        project_id: branch.repository_id,
+        expected_project_id: input.project_id
+    });
+    // A commit waits while the branch's graph validation runs: answered 202, or
+    // 409 when the graph changed while committing. Neither writes, so the
+    // command asks again after each delay instead of making the caller loop
+    // (iss-493).
+    const delays = input.validation_wait_ms ?? VALIDATION_WAIT_MS;
+    let response;
+    for (let attempt = 0;; attempt += 1) {
+        const last = attempt >= delays.length;
+        const answer = await call(async () => {
+            try {
+                return await commitBranch(input.client, {
+                    branch_id,
+                    message: options.message,
+                    expected_head_commit_id: options['expected-head']
+                }, { signal: operationSignal() });
+            }
+            catch (error) {
+                if (!last &&
+                    error instanceof GraphBranchHistoryError &&
+                    error.reason === 'graph_validation_pending') {
+                    return null;
+                }
+                throw error;
+            }
+        });
+        const waiting = answer === null ||
+            ('reason' in answer && answer.reason === 'graph_validation_pending');
+        if (answer !== null && (!waiting || last)) {
+            response = answer;
+            break;
+        }
+        const delay = delays[attempt];
+        process.stderr.write(`[sdlc] graph validation is still running; asking again in ${Math.round(delay / 1000)}s\n`);
+        await sleep(delay, undefined, { signal: operationSignal() });
+    }
+    const pending = 'reason' in response && response.reason === 'graph_validation_pending';
+    if ('reason' in response &&
+        response.reason === 'no_changes' &&
+        branch.worktree_id) {
+        // sdlc save writes the AI workspace proposal, not the Working graph, so a
+        // commit right after a save finds nothing until the proposal is applied.
+        // The branch summary does not say whether a proposal waits, so the hint
+        // is conditional.
+        const apply_command = applyCommand({
+            branch_id,
+            workspace_id: branch.worktree_id,
+            revision: localRevision(input.local_workspace ?? null, branch.worktree_id),
+            working_revision: branch.working_revision,
+            explicit_branch: Boolean(options['branch-id'])
+        });
+        const hint = `The Working graph has no uncommitted changes. If you saved changes with sdlc save since the last apply, they wait in the branch's AI workspace ${branch.worktree_id}: run ${apply_command}, then commit again.`;
+        process.stderr.write(`[sdlc] ${hint}\n`);
+        return {
+            output: { branch_id, ...response, hint, apply_command },
+            exit_code: 0
+        };
+    }
+    return { output: { branch_id, ...response }, exit_code: pending ? 2 : 0 };
+}
+const revision = z
+    .string()
+    .regex(/^\d+$/, 'expected a non-negative integer')
+    .transform(Number)
+    .refine(Number.isSafeInteger, 'expected a safe integer');
+/**
+ * `sdlc branch apply`: applies the bound (or named) branch's AI workspace
+ * proposal to its Working graph. --expected-workspace-revision is the proposal
+ * revision the caller approved, by default the one this checkout last saved or
+ * synced; the workspace and the Working revision default to the branch's
+ * current ones.
+ */
+export async function branchApplyCommand(input) {
+    const options = parseOptions({
+        args: input.args,
+        usage: BRANCH_APPLY_USAGE,
+        schema: z.object({
+            'idempotency-key': z.string().trim().min(16).max(200),
+            'expected-workspace-revision': revision.optional(),
+            'expected-workspace-id': uuid.optional(),
+            'expected-branch-revision': revision.optional(),
+            'branch-id': uuid.optional()
+        })
+    });
+    const branch_id = options['branch-id'] ?? input.bound_branch_id;
+    if (!branch_id) {
+        throw new Error(`Current Git branch is not bound; pass --branch-id.\n${BRANCH_APPLY_USAGE}`);
+    }
+    if (!options['branch-id']) {
+        // Say which branch the binding chose before writing to it.
+        process.stderr.write(`[sdlc] applying to bound branch ${branch_id}\n`);
+    }
+    const branch = await call(() => getBranchSummary(input.client, branch_id, { signal: operationSignal() }));
+    requireProject({
+        what: `Branch ${branch_id}`,
+        project_id: branch.repository_id,
+        expected_project_id: input.project_id
+    });
+    const workspace_id = options['expected-workspace-id'] ?? branch.worktree_id;
+    const branch_revision = options['expected-branch-revision'] ?? branch.working_revision;
+    if (!workspace_id) {
+        throw new Error(`Branch ${branch_id} has no AI workspace to apply.`);
+    }
+    if (branch_revision === null) {
+        throw new Error(`Branch ${branch_id} did not report its Working revision; pass --expected-branch-revision.`);
+    }
+    let workspace_revision = options['expected-workspace-revision'];
+    if (workspace_revision === undefined) {
+        const saved = localRevision(input.local_workspace ?? null, workspace_id);
+        if (saved === null) {
+            throw new Error(`This checkout has no saved or synced revision of workspace ${workspace_id}; pass --expected-workspace-revision.\n${BRANCH_APPLY_USAGE}`);
+        }
+        workspace_revision = saved;
+        process.stderr.write(`[sdlc] applying workspace revision ${saved}, the one this checkout last saved or synced\n`);
+    }
+    const expected_workspace_revision = workspace_revision;
+    // The apply runs as a job the client polls; each step it reaches is said
+    // once, so a long apply shows it is still moving.
+    let reported_step = null;
+    const response = await call(() => applyWorkspaceProposal(input.client, {
+        branch_id,
+        idempotency_key: options['idempotency-key'],
+        expected_workspace_id: workspace_id,
+        expected_workspace_revision,
+        expected_branch_graph_revision: branch_revision
+    }, {
+        signal: operationSignal(),
+        on_progress: (running) => {
+            if (running.step === reported_step)
+                return;
+            reported_step = running.step;
+            process.stderr.write(`[sdlc] apply job ${running.job_id}: ${running.step}\n`);
+        }
+    }));
+    return { output: { branch_id, ...response }, exit_code: 0 };
+}
+/** `sdlc pr review|approve|merge`: pull-request steps as the key's user. */
+export async function pullRequestCommand(input) {
+    const [subcommand, ...args] = input.args;
+    const request_options = { signal: operationSignal() };
+    const readPullRequest = async (pull_request_id) => {
+        const pull_request = await call(() => getPullRequest(input.client, pull_request_id, request_options));
+        requireProject({
+            what: `Pull request ${pull_request_id}`,
+            project_id: pull_request.repository_id,
+            expected_project_id: input.project_id
+        });
+        return pull_request;
+    };
+    if (subcommand === 'review') {
+        const options = parseOptions({
+            args,
+            usage: PULL_REQUEST_USAGE,
+            schema: z.object({
+                'pr-id': uuid,
+                'comparison-diff-id': uuid.optional(),
+                'comparison-manifest-hash': z
+                    .string()
+                    .regex(/^sha256:[0-9a-f]{64}$/)
+                    .optional(),
+                'expected-source': uuid.optional(),
+                'expected-target': uuid.optional()
+            })
+        });
+        const evidence_flags = [
+            options['comparison-diff-id'],
+            options['comparison-manifest-hash'],
+            options['expected-source'],
+            options['expected-target']
+        ];
+        const given = evidence_flags.filter((flag) => flag !== undefined).length;
+        if (given !== 0 && given !== evidence_flags.length) {
+            throw new Error(`Pass all four evidence options, or none to read the pull request's evidence.\n${PULL_REQUEST_USAGE}`);
+        }
+        const pull_request = await readPullRequest(options['pr-id']);
+        const evidence = given === 0
+            ? await call(() => buildPullRequestReviewEvidence(input.client, pull_request, request_options))
+            : {
+                comparison_diff_id: options['comparison-diff-id'],
+                comparison_manifest_hash: options['comparison-manifest-hash'],
+                expected_source_commit_id: options['expected-source'],
+                expected_target_commit_id: options['expected-target']
+            };
+        const output = await call(() => preparePullRequestReview(input.client, { pull_request_id: options['pr-id'], ...evidence }, request_options));
+        return { output, exit_code: 0 };
+    }
+    if (subcommand === 'approve') {
+        const options = parseOptions({
+            args,
+            usage: PULL_REQUEST_USAGE,
+            schema: z.object({
+                'pr-id': uuid,
+                'expected-source': uuid,
+                'expected-target': uuid,
+                'review-hash': z.string().min(1).max(200)
+            })
+        });
+        await readPullRequest(options['pr-id']);
+        const output = await call(() => approvePullRequest(input.client, {
+            pull_request_id: options['pr-id'],
+            expected_source_commit_id: options['expected-source'],
+            expected_target_commit_id: options['expected-target'],
+            expected_review_hash: options['review-hash']
+        }, request_options));
+        return { output, exit_code: 0 };
+    }
+    if (subcommand === 'merge') {
+        const options = parseOptions({
+            args,
+            usage: PULL_REQUEST_USAGE,
+            schema: z.object({ 'pr-id': uuid })
+        });
+        await readPullRequest(options['pr-id']);
+        const output = await call(() => mergePullRequest(input.client, { pull_request_id: options['pr-id'] }, request_options));
+        return { output, exit_code: 0 };
+    }
+    throw new Error(PULL_REQUEST_USAGE);
+}
+//# sourceMappingURL=cli-branch-history.js.map

package/dist/cli-branch-history.js.map

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

package/dist/cli-branches.d.ts

@@ -0,0 +1,22 @@
+import { type GraphClientOptions } from '@software-dlc/graph/client';
+import { OperationRefusalError } from './local/operation.js';
+export declare const BRANCHES_USAGE = "Usage: sdlc branches [--timeout-ms <1000..600000>]";
+/**
+ * The refusal for a command that needs this Git ref's binding. It is an
+ * OperationRefusalError so checkout and refresh show it instead of a bare
+ * operation_failed.
+ */
+export declare function unboundBranchError(): OperationRefusalError;
+/**
+ * `sdlc branches`: the active project's hosted branches, with the one this Git
+ * ref is bound to marked. Read-only; it needs no binding.
+ */
+export declare function branchesCommand(input: {
+    args: string[];
+    client: GraphClientOptions;
+    project_id: string;
+    bound_branch_id: string | null;
+    /** The checkout's named Git ref; null on a detached HEAD, which cannot be bound. */
+    source_ref: string | null;
+}): Promise<unknown>;
+//# sourceMappingURL=cli-branches.d.ts.map

package/dist/cli-branches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-branches.d.ts","sourceRoot":"","sources":["../src/cli-branches.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGL,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,eAAO,MAAM,cAAc,uDAC2B,CAAC;AAWvD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,qBAAqB,CAI1D;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE;IAC3C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,oFAAoF;IACpF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BnB"}

package/dist/cli-branches.js

@@ -0,0 +1,59 @@
+import { GraphBranchHistoryError, listProjectBranches } from '@software-dlc/graph/client';
+import { checkOperation, operationSignal, OperationRefusalError } from './local/operation.js';
+export const BRANCHES_USAGE = 'Usage: sdlc branches [--timeout-ms <1000..600000>]';
+/** Only --timeout-ms is taken; runCliOperation reads and enforces it. */
+function onlyTimeout(args) {
+    for (let index = 0; index < args.length; index++) {
+        if (args[index] === '--timeout-ms')
+            index++;
+        else if (!args[index].startsWith('--timeout-ms='))
+            return false;
+    }
+    return true;
+}
+/**
+ * The refusal for a command that needs this Git ref's binding. It is an
+ * OperationRefusalError so checkout and refresh show it instead of a bare
+ * operation_failed.
+ */
+export function unboundBranchError() {
+    return new OperationRefusalError('Current Git branch is not bound to an SDLC branch. Run sdlc branches to list this project\'s branches, then sdlc branch bind --branch-id <id>.');
+}
+/**
+ * `sdlc branches`: the active project's hosted branches, with the one this Git
+ * ref is bound to marked. Read-only; it needs no binding.
+ */
+export async function branchesCommand(input) {
+    if (!onlyTimeout(input.args))
+        throw new Error(BRANCHES_USAGE);
+    checkOperation();
+    let branches;
+    try {
+        branches = await listProjectBranches(input.client, input.project_id, {
+            signal: operationSignal()
+        });
+    }
+    catch (error) {
+        if (error instanceof GraphBranchHistoryError) {
+            throw new Error(`${error.message} (status ${error.status}${error.reason ? `, reason ${error.reason}` : ''})`);
+        }
+        throw error;
+    }
+    finally {
+        checkOperation();
+    }
+    return {
+        project_id: input.project_id,
+        bound_branch_id: input.bound_branch_id,
+        branches: branches.map((branch) => ({
+            ...branch,
+            bound: branch.id === input.bound_branch_id
+        })),
+        next: input.bound_branch_id
+            ? null
+            : input.source_ref
+                ? 'sdlc branch bind --branch-id <id> binds this Git ref to one of them.'
+                : 'This checkout is a detached HEAD, which cannot be bound: check out a named Git branch, then run sdlc branch bind --branch-id <id>.'
+    };
+}
+//# sourceMappingURL=cli-branches.js.map

package/dist/cli-branches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-branches.js","sourceRoot":"","sources":["../src/cli-branches.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EAEpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,cAAc,EACd,eAAe,EACf,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,CAAC,MAAM,cAAc,GACzB,oDAAoD,CAAC;AAEvD,yEAAyE;AACzE,SAAS,WAAW,CAAC,IAAc;IACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACjD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,cAAc;YAAE,KAAK,EAAE,CAAC;aACvC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC;YAAE,OAAO,KAAK,CAAC;IAClE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,qBAAqB,CAC9B,gJAAgJ,CACjJ,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAOrC;IACC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;IAC9D,cAAc,EAAE,CAAC;IACjB,IAAI,QAAQ,CAAC;IACb,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE;YACnE,MAAM,EAAE,eAAe,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,CAAC,OAAO,YAAY,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAC7F,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,cAAc,EAAE,CAAC;IACnB,CAAC;IACD,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClC,GAAG,MAAM;YACT,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,KAAK,CAAC,eAAe;SAC3C,CAAC,CAAC;QACH,IAAI,EAAE,KAAK,CAAC,eAAe;YACzB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,KAAK,CAAC,UAAU;gBAChB,CAAC,CAAC,sEAAsE;gBACxE,CAAC,CAAC,oIAAoI;KAC3I,CAAC;AACJ,CAAC"}

package/dist/cli-deploy.d.ts

@@ -0,0 +1,14 @@
+export declare const SDLC_DEPLOY_USAGE = "Usage: sdlc deploy record --environment <key> --revision <sha> --organization <id> --project <id> [--source-id <id>] [--url <https url>] [--at <iso time>] [--origin <origin>]";
+export declare const SDLC_DEPLOY_HELP = "Usage: sdlc deploy record --environment <key> --revision <sha> --organization <id> --project <id> [--source-id <id>] [--url <https url>] [--at <iso time>] [--origin <origin>]\nRecords that the Environment began running the revision (a full commit id), with the deployments:write API key in SDLC_API_KEY (create one with Record deployments under Developers \u2192 API keys), acting as the key's user. API keys are for CI; people sign in with sdlc login. It posts to https://www.softwaredlc.com unless --origin names another; the environment never chooses where the key goes, and no redirect is followed. Prints the recorded deployment as JSON and exits 0, also when the same --source-id or the Environment's newest revision is sent again; on a refusal prints {code, error} and exits 1. Pass --source-id (your CI's deployment or run id) so a late retry is never recorded as a rollback.";
+export type DeployDeps = {
+    fetch: typeof fetch;
+    environment: Readonly<Record<string, string | undefined>>;
+    out: (text: string) => void;
+    note: (text: string) => void;
+};
+/**
+ * Runs sdlc deploy. Returns null for any other command, else the exit code:
+ * 0 when the deployment is recorded, 1 when the server refused it.
+ */
+export declare function runCliDeploy(args: string[], overrides?: Partial<DeployDeps>): Promise<number | null>;
+//# sourceMappingURL=cli-deploy.d.ts.map

package/dist/cli-deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-deploy.d.ts","sourceRoot":"","sources":["../src/cli-deploy.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,iBAAiB,mLACoJ,CAAC;AACnL,eAAO,MAAM,gBAAgB,w3BAA0tB,CAAC;AAgBxvB,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAE1D,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B,CAAC;AAIF;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,SAAS,GAAE,OAAO,CAAC,UAAU,CAAM,GAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqFxB"}

package/dist/cli-deploy.js

@@ -0,0 +1,164 @@
+import { ApiVersionRefusedError } from '@software-dlc/graph/client/api-version';
+import { normalizeServiceOrigin } from './local/environment-sidecar.js';
+import { ProjectDeletedError, sdlcPlatformFetch } from './local/api-client.js';
+import { SDLC_LOGIN_DEFAULT_ORIGIN } from './cli-login.js';
+// sdlc deploy record: CI tells SoftwareDLC that a project's Environment began
+// running a revision, through the v1 deployments route with a user API key.
+// docs/specs/release-environments-and-deployments.md (CLI).
+export const SDLC_DEPLOY_USAGE = 'Usage: sdlc deploy record --environment <key> --revision <sha> --organization <id> --project <id> [--source-id <id>] [--url <https url>] [--at <iso time>] [--origin <origin>]';
+export const SDLC_DEPLOY_HELP = `${SDLC_DEPLOY_USAGE}\nRecords that the Environment began running the revision (a full commit id), with the deployments:write API key in SDLC_API_KEY (create one with Record deployments under Developers → API keys), acting as the key's user. API keys are for CI; people sign in with sdlc login. It posts to ${SDLC_LOGIN_DEFAULT_ORIGIN} unless --origin names another; the environment never chooses where the key goes, and no redirect is followed. Prints the recorded deployment as JSON and exits 0, also when the same --source-id or the Environment's newest revision is sent again; on a refusal prints {code, error} and exits 1. Pass --source-id (your CI's deployment or run id) so a late retry is never recorded as a rollback.`;
+const KEY_VARIABLE = 'SDLC_API_KEY';
+const REQUEST_TIMEOUT_MS = 30_000;
+const OPTIONS = {
+    '--environment': 'environment',
+    '--revision': 'revision',
+    '--organization': 'organization',
+    '--project': 'project',
+    '--source-id': 'source_id',
+    '--url': 'url',
+    '--at': 'at',
+    '--origin': 'origin'
+};
+class DeployError extends Error {
+}
+/**
+ * Runs sdlc deploy. Returns null for any other command, else the exit code:
+ * 0 when the deployment is recorded, 1 when the server refused it.
+ */
+export async function runCliDeploy(args, overrides = {}) {
+    const [command, subcommand, ...rest] = args;
+    if (command !== 'deploy')
+        return null;
+    if (subcommand !== 'record')
+        throw new DeployError(SDLC_DEPLOY_USAGE);
+    const deps = { ...defaultDeps(), ...overrides };
+    const options = parseOptions(rest);
+    const required = ['environment', 'revision', 'organization', 'project'];
+    const missing = required.filter((name) => !options[name]);
+    if (missing.length > 0) {
+        throw new DeployError(`Missing ${missing.map((name) => `--${name}`).join(', ')}.\n${SDLC_DEPLOY_USAGE}`);
+    }
+    const key = deps.environment[KEY_VARIABLE]?.trim();
+    if (!key) {
+        throw new DeployError(`Set ${KEY_VARIABLE} to an API key with the deployments:write scope (Record deployments under Developers → API keys).`);
+    }
+    // A header refuses a control character with an error quoting the value, so
+    // refuse it here, without the key, before it can reach a CI log.
+    if (!/^[\x21-\x7e]+$/.test(key)) {
+        throw new DeployError(`${KEY_VARIABLE} holds spaces, line breaks or other characters an API key never has.`);
+    }
+    const origin = deployOrigin(options.origin);
+    if (!options.source_id) {
+        deps.note('No --source-id: a retry that arrives after a newer deployment is recorded again, as a rollback.\n');
+    }
+    const path = ['organizations', options.organization, 'projects', options.project, 'environments', options.environment, 'deployments']
+        .map(encodeURIComponent)
+        .join('/');
+    const url = new URL(`/api/v1/${path}`, origin);
+    const send = sdlcPlatformFetch({
+        fetch_impl: deps.fetch,
+        environment: deps.environment
+    });
+    let response;
+    try {
+        response = await send(url, {
+            method: 'POST',
+            headers: {
+                authorization: `Bearer ${key}`,
+                'content-type': 'application/json'
+            },
+            body: JSON.stringify({
+                revision: options.revision,
+                source_deployment_id: options.source_id ?? null,
+                url: options.url ?? null,
+                reported_at: options.at ?? null,
+                channel: 'cli'
+            }),
+            redirect: 'manual',
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+        });
+    }
+    catch (error) {
+        // The server answered, refusing this CLI's API version: a refusal like any other.
+        if (error instanceof ApiVersionRefusedError) {
+            deps.out(json({ code: error.refusal.code, error: error.message }));
+            return 1;
+        }
+        // So is a deleted project's 410. Deploy binds no checkout, so it prints the
+        // server's own answer rather than the checkout's reconnect advice.
+        if (error instanceof ProjectDeletedError) {
+            deps.out(json({ code: 'project_deleted', error: 'The project was deleted.' }));
+            return 1;
+        }
+        // A header error quotes the value it refused, which may be a secret.
+        let message = error instanceof Error ? error.message : String(error);
+        for (const secret of [key, deps.environment.SDLC_PROTECTION_BYPASS?.trim()]) {
+            if (secret)
+                message = message.split(secret).join('[redacted]');
+        }
+        throw new DeployError(`Could not reach ${origin}: ${message}.`);
+    }
+    const body = await response.json().catch(() => null);
+    if (response.status === 200 || response.status === 201) {
+        deps.out(json(body));
+        return 0;
+    }
+    deps.out(json(refusal(response, body, origin)));
+    return 1;
+}
+function parseOptions(args) {
+    const options = {};
+    for (let index = 0; index < args.length; index++) {
+        const match = /^(--[a-z-]+)(?:=(.*))?$/.exec(args[index]);
+        const name = match ? OPTIONS[match[1]] : undefined;
+        const value = match ? (match[2] ?? args[++index]) : undefined;
+        if (!name || options[name] !== undefined) {
+            throw new DeployError(SDLC_DEPLOY_USAGE);
+        }
+        // A dot segment would move the request to another route.
+        if (!value || value.startsWith('--') || value === '.' || value === '..') {
+            throw new DeployError(`${match[1]} needs a value.\n${SDLC_DEPLOY_USAGE}`);
+        }
+        options[name] = value;
+    }
+    return options;
+}
+// An origin only: a path would let a flag send the key to a page of a host.
+function deployOrigin(value) {
+    const origin = normalizeServiceOrigin(value ?? SDLC_LOGIN_DEFAULT_ORIGIN);
+    if (new URL(origin).pathname !== '/') {
+        throw new DeployError(`--origin must be an origin like https://host[:port].`);
+    }
+    return origin;
+}
+// The route's {code, error}, or one made from the status for any other answer.
+function refusal(response, body, origin) {
+    if (body &&
+        typeof body === 'object' &&
+        typeof body.code === 'string' &&
+        typeof body.error === 'string') {
+        return body;
+    }
+    if (response.status >= 300 && response.status < 400) {
+        return {
+            code: 'redirected',
+            error: `${origin} answered with a redirect, which sdlc deploy record does not follow; pass the origin it serves the API from with --origin.`
+        };
+    }
+    return {
+        code: `http_${response.status}`,
+        error: `${origin} answered HTTP ${response.status}.`
+    };
+}
+function json(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+function defaultDeps() {
+    return {
+        fetch: globalThis.fetch,
+        environment: process.env,
+        out: (text) => process.stdout.write(text),
+        note: (text) => process.stderr.write(text)
+    };
+}
+//# sourceMappingURL=cli-deploy.js.map

package/dist/cli-deploy.js.map

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

package/dist/cli-health.d.ts

@@ -0,0 +1,3 @@
+/** Dispatch before ordinary context bootstrap; the inspector owns the sole budget. */
+export declare function runCliHealth(args: string[]): Promise<boolean>;
+//# sourceMappingURL=cli-health.d.ts.map

package/dist/cli-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-health.d.ts","sourceRoot":"","sources":["../src/cli-health.ts"],"names":[],"mappings":"AAIA,sFAAsF;AACtF,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAwEnE"}