staticforge 0.0.0-stage → 0.1.0

package/dist/commands/provision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provision.d.ts","sourceRoot":"","sources":["../../src/commands/provision.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,eAAe,CAAC;AAKrD,UAAU,UAAU;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAQjF;AAgCD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAmHlF"}

package/dist/commands/provision.js

@@ -0,0 +1,133 @@
+import { ErrorCode, SforgeError } from '@staticforge/core';
+import { action } from '../command.js';
+import { confirmer, formatPlan, targetContext, truthy } from '../cloud.js';
+import { displayPath } from '../paths.js';
+import { loadProjectConfig } from '../project.js';
+/** --local-state is for experiments: refused in CI unless forced. */
+export function localStateFrom(flags, env) {
+    if (flags.localState !== true)
+        return false;
+    if (truthy(env.CI) && flags.forceLocalState !== true) {
+        throw new SforgeError(ErrorCode.Usage, '--local-state is refused in CI', {
+            hint: 'Local state is lost with the runner. Use the remote backend, or pass --force-local-state.',
+        });
+    }
+    return true;
+}
+function describe(result, cwd) {
+    const lines = [];
+    if (result.bootstrap) {
+        lines.push(result.bootstrap.created
+            ? `Created the state backend ${result.bootstrap.description}`
+            : `State backend: ${result.bootstrap.description}`);
+    }
+    lines.push(formatPlan(result.plan));
+    lines.push(...result.notices);
+    if (result.pending) {
+        lines.push(`Run \`sforge provision ${result.target}\` again once the records resolve.`);
+    }
+    else if (result.applied) {
+        lines.push(`Applied: ${result.apply?.add ?? 0} added, ${result.apply?.change ?? 0} changed, ${result.apply?.remove ?? 0} destroyed.`);
+    }
+    const outputs = result.outputs ?? {};
+    if (typeof outputs.url === 'string')
+        lines.push(`URL: ${outputs.url}`);
+    const dns = outputs.dns_records;
+    if (dns && dns.length > 0 && result.applied) {
+        lines.push('Point your DNS at CloudFront (skip if Route 53 manages the zone):');
+        lines.push(...dns.map((r) => `  ${r.name} ${r.type} ${r.value}`));
+    }
+    if (typeof outputs.ci_role_arn === 'string')
+        lines.push(`CI deploy role: ${outputs.ci_role_arn}`);
+    lines.push(`Workspace: ${displayPath(cwd, result.workspace)}`);
+    return lines.join('\n');
+}
+export function registerProvisionCommands(program, runtime) {
+    program
+        .command('provision')
+        .description('Create or update the infrastructure of a target with OpenTofu/Terraform')
+        .argument('<target>', 'target name from the config')
+        .option('--diff', 'only show what would change (plan), change nothing')
+        .option('--bootstrap-state', "create the target's remote state backend first, if missing")
+        .option('--local-state', 'keep state in .sforge/iac/<target>/ (experiments only)')
+        .option('--force-local-state', 'allow --local-state in CI')
+        .option('--no-wait', 'create the certificate, print its DNS records and stop')
+        .option('-y, --yes', 'apply without asking')
+        .action(action(runtime, async (ctx, { args, options }) => {
+        const loaded = await loadProjectConfig(ctx);
+        const target = await targetContext(runtime, ctx, loaded, args[0], localStateFrom(options, ctx.io.env));
+        const { provision } = await import('@staticforge/iac');
+        const result = await provision({
+            ...target.iac,
+            diff: options.diff === true,
+            bootstrapState: options.bootstrapState === true,
+            noWait: options.wait === false,
+            confirm: confirmer(ctx, options.yes === true),
+        });
+        return { data: result, text: describe(result, ctx.cwd) };
+    }));
+    program
+        .command('status')
+        .description("Show a target's current version and URL, and detect infrastructure drift")
+        .argument('<target>', 'target name from the config')
+        .option('--local-state', 'use the state in .sforge/iac/<target>/')
+        .option('--force-local-state', 'allow --local-state in CI')
+        .action(action(runtime, async (ctx, { args, options }) => {
+        const loaded = await loadProjectConfig(ctx);
+        const target = await targetContext(runtime, ctx, loaded, args[0], localStateFrom(options, ctx.io.env));
+        const { detectDrift } = await import('@staticforge/iac');
+        const drift = await detectDrift(target.iac);
+        let versionId = null;
+        try {
+            const deployer = target.provider.createDeployer({
+                rootDir: loaded.rootDir,
+                config: loaded.config,
+                targetName: target.targetName,
+                target: target.target,
+                outputs: drift.outputs,
+                env: ctx.io.env,
+                logger: ctx.logger,
+            });
+            versionId = (await deployer.current()).versionId;
+        }
+        catch (error) {
+            // Not provisioned yet, or not deployable: drift is still useful.
+            if (!(error instanceof SforgeError) || error.code !== ErrorCode.NotProvisioned)
+                throw error;
+        }
+        const url = typeof drift.outputs.url === 'string' ? drift.outputs.url : undefined;
+        const lines = [
+            `${target.targetName} (${target.target.provider}): ${url ?? 'not provisioned'}`,
+            `Active version: ${versionId ?? 'none'}`,
+            drift.drifted
+                ? `Drift detected:\n${drift.drift.map((d) => `  ! ${d.address} (${d.action})`).join('\n') || '  (the plan has changes)'}`
+                : 'No drift: the infrastructure matches the last apply.',
+        ];
+        // Drift is a finding: exit 1 so CI can alert on it.
+        return { ok: !drift.drifted, data: { ...drift, url, versionId }, text: lines.join('\n') };
+    }));
+    program
+        .command('destroy')
+        .description('Delete every resource of a target, including its deployed content')
+        .argument('<target>', 'target name from the config')
+        .requiredOption('--confirm <target>', 'repeat the target name to confirm')
+        .option('--local-state', 'use the state in .sforge/iac/<target>/')
+        .option('--force-local-state', 'allow --local-state in CI')
+        .action(action(runtime, async (ctx, { args, options }) => {
+        const name = args[0];
+        if (options.confirm !== name) {
+            throw new SforgeError(ErrorCode.ConfirmationRequired, `--confirm must repeat the target name "${name}"`);
+        }
+        const loaded = await loadProjectConfig(ctx);
+        const target = await targetContext(runtime, ctx, loaded, name, localStateFrom(options, ctx.io.env));
+        const { destroy } = await import('@staticforge/iac');
+        const result = await destroy(target.iac);
+        return {
+            data: result,
+            text: result.destroyed
+                ? `Destroyed ${result.plan.remove} resources of "${name}". The state backend was kept.`
+                : `Nothing to destroy for "${name}".`,
+        };
+    }));
+}
+//# sourceMappingURL=provision.js.map

package/dist/commands/provision.js.map

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

package/dist/commands/schema.d.ts

@@ -0,0 +1,4 @@
+import { type Command } from 'commander';
+import { type Runtime } from '../command.js';
+export declare function registerSchemaCommand(program: Command, runtime: Runtime): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/commands/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAGnD,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,eAAe,CAAC;AAWrD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAa9E"}

package/dist/commands/schema.js

@@ -0,0 +1,21 @@
+import { Argument } from 'commander';
+import { checkReportJsonSchema } from '@staticforge/checker/report-schema';
+import { configJsonSchema } from '@staticforge/core';
+import { action } from '../command.js';
+import { outputJsonSchema } from '../output.js';
+const schemas = {
+    config: configJsonSchema,
+    diagnostics: checkReportJsonSchema,
+    output: outputJsonSchema,
+};
+export function registerSchemaCommand(program, runtime) {
+    program
+        .command('schema')
+        .description('Print a JSON Schema: the config file, the check report (diagnostics), or the --json envelope')
+        .addArgument(new Argument('<name>', 'schema to print').choices(Object.keys(schemas)))
+        .action(action(runtime, async (_ctx, { args }) => {
+        const schema = schemas[args[0]]();
+        return { data: schema, text: JSON.stringify(schema, null, 2) };
+    }));
+}
+//# sourceMappingURL=schema.js.map

package/dist/commands/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/commands/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAgB,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAgB,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,MAAM,OAAO,GAAG;IACd,MAAM,EAAE,gBAAgB;IACxB,WAAW,EAAE,qBAAqB;IAClC,MAAM,EAAE,gBAAgB;CAChB,CAAC;AAIX,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,OAAgB;IACtE,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CACV,8FAA8F,CAC/F;SACA,WAAW,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;SACpF,MAAM,CACL,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACvC,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAe,CAAC,EAAE,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IACjE,CAAC,CAAC,CACH,CAAC;AACN,CAAC"}

package/dist/commands/version.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+import { type Runtime } from '../command.js';
+export declare function registerVersionCommand(program: Command, runtime: Runtime): void;
+//# sourceMappingURL=version.d.ts.map

package/dist/commands/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,eAAe,CAAC;AAGrD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAe/E"}

package/dist/commands/version.js

@@ -0,0 +1,17 @@
+import { action } from '../command.js';
+import { VERSION } from '../version.js';
+export function registerVersionCommand(program, runtime) {
+    program
+        .command('version')
+        .description('Print version information')
+        .action(action(runtime, async () => ({
+        data: {
+            version: VERSION,
+            node: process.versions.node,
+            platform: process.platform,
+            arch: process.arch,
+        },
+        text: `sforge ${VERSION} (node ${process.versions.node}, ${process.platform}-${process.arch})`,
+    })));
+}
+//# sourceMappingURL=version.js.map

package/dist/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,OAAgB;IACvE,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CACL,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,IAAI,EAAE;YACJ,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;YAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB;QACD,IAAI,EAAE,UAAU,OAAO,UAAU,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,GAAG;KAC/F,CAAC,CAAC,CACJ,CAAC;AACN,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,27 @@
+import type { Command } from 'commander';
+import { type Logger } from '@staticforge/core';
+import type { Io } from './io.js';
+/** Options accepted by every command. */
+export interface GlobalOptions {
+    json?: boolean;
+    quiet?: boolean;
+    verbose?: boolean;
+    cwd?: string;
+    config?: string;
+    color?: boolean;
+    nonInteractive?: boolean;
+}
+export interface CommandContext {
+    io: Io;
+    logger: Logger;
+    /** Absolute working directory (from --cwd or the process). */
+    cwd: string;
+    /** Explicit config path from --config. */
+    configPath: string | undefined;
+    json: boolean;
+    /** False under CI, without a TTY, or with --non-interactive: never prompt. */
+    interactive: boolean;
+    color: boolean;
+}
+export declare function createContext(command: Command, io: Io): CommandContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,KAAK,MAAM,EAAgC,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAElC,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,EAAE,CAAC;IACP,MAAM,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,8EAA8E;IAC9E,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,GAAG,cAAc,CAgBtE"}

package/dist/context.js

@@ -0,0 +1,19 @@
+import { resolve } from 'node:path';
+import { createLogger, shouldUseColor } from '@staticforge/core';
+export function createContext(command, io) {
+    const opts = command.optsWithGlobals();
+    const json = opts.json === true;
+    const color = opts.color !== false && shouldUseColor(io.stderr, io.env);
+    const level = opts.quiet ? 'error' : opts.verbose ? 'debug' : 'info';
+    const ci = io.env.CI !== undefined && io.env.CI !== '' && io.env.CI !== 'false';
+    return {
+        io,
+        logger: createLogger({ level, color, stream: io.stderr }),
+        cwd: opts.cwd !== undefined ? resolve(io.cwd, opts.cwd) : io.cwd,
+        configPath: opts.config,
+        json,
+        interactive: opts.nonInteractive !== true && !ci && io.stdinIsTTY,
+        color,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAe,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA2B9E,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,EAAM;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,eAAe,EAAiB,CAAC;IACtD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,KAAK,IAAI,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACrE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,OAAO,CAAC;IAEhF,OAAO;QACL,EAAE;QACF,MAAM,EAAE,YAAY,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC;QACzD,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG;QAChE,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,UAAU;QACjE,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,19 @@
+import type { Writable } from 'node:stream';
+/** Process boundary, injectable so commands can be tested without spawning. */
+export interface Io {
+    stdout: Writable & {
+        isTTY?: boolean;
+    };
+    stderr: Writable & {
+        isTTY?: boolean;
+    };
+    stdinIsTTY: boolean;
+    env: NodeJS.ProcessEnv;
+    cwd: string;
+    /** Run `handler` once on SIGINT/SIGTERM; returns an unsubscribe function. */
+    onShutdown(handler: () => void): () => void;
+    /** Ask a question on stderr and read one line from stdin (interactive runs only). */
+    prompt(question: string): Promise<string>;
+}
+export declare function processIo(): Io;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,+EAA+E;AAC/E,MAAM,WAAW,EAAE;IACjB,MAAM,EAAE,QAAQ,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACvC,MAAM,EAAE,QAAQ,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACvC,UAAU,EAAE,OAAO,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,qFAAqF;IACrF,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,SAAS,IAAI,EAAE,CA2B9B"}

package/dist/io.js

@@ -0,0 +1,34 @@
+import { createInterface } from 'node:readline/promises';
+export function processIo() {
+    return {
+        stdout: process.stdout,
+        stderr: process.stderr,
+        stdinIsTTY: process.stdin.isTTY === true,
+        env: process.env,
+        cwd: process.cwd(),
+        onShutdown(handler) {
+            const signals = ['SIGINT', 'SIGTERM'];
+            const once = () => {
+                for (const signal of signals)
+                    process.off(signal, once);
+                handler();
+            };
+            for (const signal of signals)
+                process.on(signal, once);
+            return () => {
+                for (const signal of signals)
+                    process.off(signal, once);
+            };
+        },
+        async prompt(question) {
+            const rl = createInterface({ input: process.stdin, output: process.stderr });
+            try {
+                return await rl.question(question);
+            }
+            finally {
+                rl.close();
+            }
+        },
+    };
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.js","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAgBzD,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI;QACxC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,UAAU,CAAC,OAAO;YAChB,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;YAC/C,MAAM,IAAI,GAAG,GAAG,EAAE;gBAChB,KAAK,MAAM,MAAM,IAAI,OAAO;oBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBACxD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YACF,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACvD,OAAO,GAAG,EAAE;gBACV,KAAK,MAAM,MAAM,IAAI,OAAO;oBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1D,CAAC,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,QAAQ;YACnB,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7E,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;oBAAS,CAAC;gBACT,EAAE,CAAC,KAAK,EAAE,CAAC;YACb,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+import { ExitCode } from '@staticforge/core';
+import type { Runtime } from './command.js';
+import { type Io } from './io.js';
+export { defineConfig } from '@staticforge/core';
+export type { SforgeConfig, SforgeConfigInput } from '@staticforge/core';
+export declare function createProgram(runtime: Runtime): Command;
+/** Run the CLI and return the process exit code. */
+export declare function run(argv: string[], io?: Io, hooks?: Pick<Runtime, 'providers' | 'onResult'>): Promise<ExitCode>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AACpD,OAAO,EAAa,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAc5C,OAAO,EAAE,KAAK,EAAE,EAAa,MAAM,SAAS,CAAC;AAI7C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAmCvD;AAED,oDAAoD;AACpD,wBAAsB,GAAG,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,EAAgB,EACpB,KAAK,GAAE,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAAM,GAClD,OAAO,CAAC,QAAQ,CAAC,CAsBnB"}

package/dist/main.js

@@ -0,0 +1,81 @@
+import { Command, CommanderError } from 'commander';
+import { ErrorCode, ExitCode } from '@staticforge/core';
+import { registerBuildCommand } from './commands/build.js';
+import { registerCheckCommand } from './commands/check.js';
+import { registerConfigCommands } from './commands/config.js';
+import { registerDeployCommands } from './commands/deploy.js';
+import { registerDevCommand } from './commands/dev.js';
+import { registerIacCommand } from './commands/iac.js';
+import { registerInitCommand } from './commands/init.js';
+import { registerMcpCommand } from './commands/mcp.js';
+import { registerNewCommand } from './commands/new.js';
+import { registerPreviewCommand } from './commands/preview.js';
+import { registerProvisionCommands } from './commands/provision.js';
+import { registerSchemaCommand } from './commands/schema.js';
+import { registerVersionCommand } from './commands/version.js';
+import { processIo } from './io.js';
+import { OUTPUT_SCHEMA_VERSION } from './output.js';
+import { VERSION } from './version.js';
+export { defineConfig } from '@staticforge/core';
+export function createProgram(runtime) {
+    const { io } = runtime;
+    const program = new Command('sforge')
+        .description('staticforge: build, check, preview and deploy accessible static sites')
+        .version(VERSION, '-V, --version')
+        .option('--json', 'write a single JSON document to stdout (logs go to stderr)')
+        .option('-q, --quiet', 'only log errors')
+        .option('-v, --verbose', 'log debug output')
+        .option('--cwd <dir>', 'run as if started in <dir>')
+        .option('-c, --config <path>', 'config file, or the project directory containing it')
+        .option('--no-color', 'disable colored output')
+        .option('--non-interactive', 'never prompt (implied when CI is set or stdin is not a TTY)')
+        .showSuggestionAfterError()
+        .exitOverride()
+        .configureOutput({
+        writeOut: (s) => io.stdout.write(s),
+        writeErr: (s) => io.stderr.write(s),
+    });
+    // Subcommands created below inherit exitOverride and output settings.
+    registerInitCommand(program, runtime);
+    registerNewCommand(program, runtime);
+    registerBuildCommand(program, runtime);
+    registerCheckCommand(program, runtime);
+    registerDevCommand(program, runtime);
+    registerPreviewCommand(program, runtime);
+    registerProvisionCommands(program, runtime);
+    registerIacCommand(program, runtime);
+    registerDeployCommands(program, runtime);
+    registerConfigCommands(program, runtime);
+    registerSchemaCommand(program, runtime);
+    registerVersionCommand(program, runtime);
+    registerMcpCommand(program, runtime);
+    return program;
+}
+/** Run the CLI and return the process exit code. */
+export async function run(argv, io = processIo(), hooks = {}) {
+    const runtime = { io, exitCode: ExitCode.Ok, ...hooks };
+    const program = createProgram(runtime);
+    try {
+        await program.parseAsync(argv);
+        return runtime.exitCode;
+    }
+    catch (error) {
+        if (!(error instanceof CommanderError))
+            throw error;
+        // --help and --version exit through here with code 0.
+        if (error.exitCode === 0)
+            return ExitCode.Ok;
+        // Commander has already printed the usage error to stderr.
+        const envelope = {
+            schemaVersion: OUTPUT_SCHEMA_VERSION,
+            command: '',
+            ok: false,
+            error: { code: ErrorCode.Usage, message: error.message.replace(/^error: /, '') },
+        };
+        runtime.onResult?.({ envelope });
+        if (argv.includes('--json'))
+            io.stdout.write(`${JSON.stringify(envelope, null, 2)}\n`);
+        return ExitCode.Usage;
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/mcp/invoke.d.ts

@@ -0,0 +1,29 @@
+import { ExitCode } from '@staticforge/core';
+import type { Outcome, Runtime } from '../command.js';
+import type { Io } from '../io.js';
+/** The CLI entry point (`run` from main.ts), passed in to avoid an import cycle. */
+export type RunCli = (argv: string[], io: Io, hooks: Pick<Runtime, 'providers' | 'onResult'>) => Promise<ExitCode>;
+export interface InvokeOptions {
+    run: RunCli;
+    cwd: string;
+    /** Global options for every command, e.g. ["--config", "site.yaml", "--quiet"]. */
+    globalArgs?: string[];
+    env: NodeJS.ProcessEnv;
+    providers?: Runtime['providers'];
+    /** Receives each line the command logs. */
+    onLog?(line: string): void;
+}
+export interface Invocation {
+    /** The command's result, as soon as it has one (servers: once they listen). */
+    outcome: Promise<Outcome>;
+    /** Settles when the command has finished; servers run until {@link stop}. */
+    done: Promise<ExitCode>;
+    /** Stop a long-running command, as Ctrl+C would. */
+    stop(): void;
+}
+/**
+ * Run a CLI command in this process, exactly as `sforge <args> --json` would,
+ * without prompts. The envelope goes to `outcome`; stdout is discarded.
+ */
+export declare function invoke(args: string[], options: InvokeOptions): Invocation;
+//# sourceMappingURL=invoke.d.ts.map

package/dist/mcp/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/mcp/invoke.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAEnC,oFAAoF;AACpF,MAAM,MAAM,MAAM,GAAG,CACnB,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAAC,KAC3C,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,2CAA2C;IAC3C,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,6EAA6E;IAC7E,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxB,oDAAoD;IACpD,IAAI,IAAI,IAAI,CAAC;CACd;AAuBD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,aAAa,GAAG,UAAU,CAwDzE"}

package/dist/mcp/invoke.js

@@ -0,0 +1,82 @@
+import { Writable } from 'node:stream';
+import { ExitCode } from '@staticforge/core';
+/** A stream that hands complete lines to `onLine`. */
+function lineStream(onLine) {
+    let pending = '';
+    const stream = new Writable({
+        write(chunk, _encoding, done) {
+            pending += String(chunk);
+            for (let i = pending.indexOf('\n'); i !== -1; i = pending.indexOf('\n')) {
+                onLine(pending.slice(0, i));
+                pending = pending.slice(i + 1);
+            }
+            done();
+        },
+    });
+    return Object.assign(stream, {
+        flush() {
+            if (pending !== '')
+                onLine(pending);
+            pending = '';
+        },
+    });
+}
+/**
+ * Run a CLI command in this process, exactly as `sforge <args> --json` would,
+ * without prompts. The envelope goes to `outcome`; stdout is discarded.
+ */
+export function invoke(args, options) {
+    const shutdown = [];
+    const stderr = lineStream((line) => options.onLog?.(line));
+    const io = {
+        stdout: new Writable({ write: (_chunk, _encoding, done) => done() }),
+        stderr,
+        stdinIsTTY: false,
+        env: options.env,
+        cwd: options.cwd,
+        onShutdown(handler) {
+            shutdown.push(handler);
+            return () => {
+                const i = shutdown.indexOf(handler);
+                if (i !== -1)
+                    shutdown.splice(i, 1);
+            };
+        },
+        prompt: () => Promise.reject(new Error('Commands run over MCP cannot prompt')),
+    };
+    let settle;
+    let fail;
+    let settled = false;
+    const outcome = new Promise((resolve, reject) => {
+        settle = (value) => {
+            settled = true;
+            resolve(value);
+        };
+        fail = reject;
+    });
+    const argv = ['node', 'sforge', '--json', ...(options.globalArgs ?? []), ...args];
+    const done = options
+        .run(argv, io, {
+        ...(options.providers && { providers: options.providers }),
+        onResult: (result) => {
+            if (!settled)
+                settle(result);
+        },
+    })
+        .then((code) => {
+        stderr.flush();
+        if (!settled)
+            fail(new Error(`sforge ${args[0] ?? ''} ended without a result`));
+        return code;
+    }, (error) => {
+        stderr.flush();
+        fail(error);
+        return ExitCode.Internal;
+    });
+    return {
+        outcome,
+        done,
+        stop: () => shutdown.splice(0).forEach((handler) => handler()),
+    };
+}
+//# sourceMappingURL=invoke.js.map

package/dist/mcp/invoke.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,25 @@
+import { McpServer } from '@modelcontextprotocol/server';
+import type { Runtime } from '../command.js';
+import { type RunCli } from './invoke.js';
+export interface SforgeMcpOptions {
+    run: RunCli;
+    /** Project directory (or a directory below it). */
+    cwd: string;
+    /** Global options for every command, e.g. ["--config", "site.yaml"]. */
+    globalArgs?: string[];
+    env: NodeJS.ProcessEnv;
+    /** Also offer provision and destroy. */
+    allowInfra?: boolean;
+    /** Cloud providers to use instead of the real ones (tests). */
+    providers?: Runtime['providers'];
+    /** Where command logs go: stderr when serving over stdio. */
+    log?(line: string): void;
+}
+export interface SforgeMcp {
+    /** A server with every tool and resource. Over stdio, one connection may create two. */
+    createServer(): McpServer;
+    /** Stop the dev server, if one is running. */
+    close(): Promise<void>;
+}
+export declare function createSforgeMcp(options: SforgeMcpOptions): SforgeMcp;
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,SAAS,EAKV,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAK,EAAW,OAAO,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAmB,KAAK,MAAM,EAAU,MAAM,aAAa,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACjC,6DAA6D;IAC7D,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,wFAAwF;IACxF,YAAY,IAAI,SAAS,CAAC;IAC1B,8CAA8C;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAqID,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CA+oBpE"}