@msn-control/liftoff 0.3.0 → 0.3.1

package/README.md

@@ -87,6 +87,39 @@ liftoff regions search korea --cloud azure
 
 Azure is the available V1 provider. AWS and GCP are listed as planned provider adapters and are rejected before generation.
 
+## Strict Commands And Safe Recovery
+
+Liftoff validates each command before running it. Unknown flags or subcommands, missing flag values, invalid booleans, incompatible duplicates, and extra positional arguments exit 1 without generating files or printing a fallback helper command. Use command-specific help to see the accepted syntax:
+
+```bash
+liftoff create --help
+liftoff update --help
+liftoff regions --help
+```
+
+`liftoff update --apply` preflights every path and destination before its first mutation. A new or moved artifact is adopted when the destination already contains the rendered bytes; different pre-existing bytes are reported as a conflict and skipped. `--force` overwrites reviewed conflicts. Orphans are reported but never deleted automatically. Any write, replacement, cleanup, or manifest failure exits 1 without a success summary or false manifest state, so fixing the filesystem issue and retrying is safe.
+
+Manifest paths must be portable path-part arrays confined to the project. Traversal, absolute, drive-qualified, UNC, embedded-separator, empty, and symlink-escaping paths are rejected before artifact access. If validation reports an unsafe or malformed manifest, restore `liftoff.manifest.json` from version control or regenerate a fresh project with the matching Liftoff version. Do not repair the issue by weakening path validation or by retaining a hand-edited unsafe path.
+
+## Generated Integration Configuration
+
+GenAI starters contain executable, offline-testable integration boundaries:
+
+- `PYDANTIC_AI_MODEL` selects the production PydanticAI model. Invoking an unconfigured production agent raises a clear configuration error rather than returning a successful placeholder.
+- Redis Streams publishing uses `REDIS_URL` and `REDIS_STREAM_NAME`.
+- Azure Service Bus publishing uses `SERVICE_BUS_QUEUE_NAME` and either `SERVICE_BUS_CONNECTION_STRING` or `SERVICE_BUS_FULLY_QUALIFIED_NAMESPACE`; `AZURE_CLIENT_ID` selects a user-assigned managed identity.
+- Langfuse tracing requires both `LANGFUSE_PUBLIC_KEY` and `LANGFUSE_SECRET_KEY`, with optional `LANGFUSE_HOST`. Without both keys, tracing is explicitly disabled and reports no remote trace ID.
+- Generated frontends read `VITE_API_BASE_URL` from `frontend/.env`, call the route selected by the project pattern or API stack, and expose loading, response, and failure states.
+- Generated backends allow the local frontend origin by default. Set the comma-separated `CORS_ALLOWED_ORIGINS` value whenever `VITE_API_BASE_URL` points at a frontend on another origin; generated Azure infrastructure sets it to the deployed frontend URL.
+
+Generated backend, messaging, tracing, and orchestration tests require no external model, Redis, Service Bus, or Langfuse service. Each generated README includes the fresh-project install, build, and test commands for its selected stack.
+
+## Azure Deployment Contracts
+
+Environment tfvars contain a deterministic 12-character lowercase alphanumeric `resource_suffix` for globally scoped Azure names. If Azure reports a collision, replace that environment's suffix with another unique value matching `^[a-z0-9]{12}$`; `tofu validate` rejects invalid overrides.
+
+Worker-enabled projects configure `ServiceBusConnection__fullyQualifiedNamespace` and `ServiceBusConnection__clientId` for the attached user-assigned identity, and grant that identity's principal the Service Bus Data Receiver role. `function_worker_queue_name` drives the provisioned queue, Function setting, and output. Function host storage uses one complete key-backed `AzureWebJobsStorage` configuration rather than mixed partial identity settings.
+
 ## Generated Project Structure
 
 Generated paths below are logical project structure examples. The CLI writes them using platform-correct filesystem handling on macOS, Linux, and Windows, and machine-readable manifests store path parts rather than joined path strings.
@@ -141,7 +174,7 @@ Generated projects contain two root files with different ownership models:
 - `liftoff.config.json` is user-owned desired state after creation. Liftoff writes it once during generation and does not machine-rewrite it afterwards. Supported changes, such as adding an environment or enabling frontend output, are reconciled by `liftoff update`. Project type, API stack, and GenAI pattern changes are migrations and should use `liftoff migrate`.
 - `liftoff.manifest.json` is the CLI-owned compatibility record. Manifest schema v2 records `artifactVersion`, the generating `liftoffVersion`, project type, API stack, applicable GenAI pattern, durable generated artifact `logicalName`s, categories, OS-neutral path parts, and `sha256:` content hashes.
 
-The manifest lets `liftoff validate`, `liftoff doctor`, and `liftoff update` distinguish clean generated files from local edits. Seed content, such as the initial OpenSpec bootstrap change, is written once and intentionally omitted from the durable manifest so it can follow its own lifecycle.
+The manifest lets `liftoff validate`, `liftoff doctor`, and `liftoff update` distinguish clean generated files from local edits. Seed content, such as the initial OpenSpec bootstrap change, is written once and intentionally omitted from the durable manifest so it can follow its own lifecycle. Treat the manifest as CLI-owned: restore or regenerate it when validation fails rather than hand-editing artifact paths or hashes.
 
 ## Contract Conventions
 
@@ -181,4 +214,4 @@ npm run smoke:package --workspace @msn-control/liftoff
 
 The `Release Liftoff` workflow builds, tests, packs, smoke-installs, and publishes only the `@msn-control/liftoff` workspace package. Stable versions publish with the `latest` npm dist-tag; prerelease versions publish with `next`.
 
-Prefer npm trusted publishing with provenance for release authentication. If trusted publishing is not configured for the repository and npm organization, create a scoped npm automation token and store it as the repository secret `NPM_TOKEN`.
+Prefer npm trusted publishing for release authentication. The workflow disables provenance while the source repository is private because npm accepts GitHub Actions provenance only from public repositories. If trusted publishing is not configured for the repository and npm organization, create a scoped npm automation token and store it as the repository secret `NPM_TOKEN`.

package/dist/args.d.ts

@@ -1,5 +1,24 @@
 import type { ParsedArgs } from './types.js';
+type FlagKind = 'boolean' | 'value';
+interface FlagDefinition {
+    kind: FlagKind;
+    negatable?: boolean;
+}
+export interface CommandDefinition {
+    description: string;
+    usage: string;
+    flags: Readonly<Record<string, FlagDefinition>>;
+    subcommands?: readonly string[];
+    defaultMaxPositionals: number;
+    subcommandMaxPositionals?: Readonly<Record<string, number>>;
+}
+export declare const commandDefinitions: Readonly<Record<string, CommandDefinition>>;
+export declare class UsageError extends Error {
+    constructor(message: string);
+}
 export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function formatCommandHelp(command: string): string;
 export declare function readStringFlag(flags: ParsedArgs['flags'], name: string): string | undefined;
 export declare function readBooleanFlag(flags: ParsedArgs['flags'], name: string): boolean | undefined;
 export declare function readListFlag(flags: ParsedArgs['flags'], name: string): string[] | undefined;
+export {};

package/dist/args.js

@@ -1,65 +1,242 @@
-const commandsWithSubcommands = new Set(['regions', 'dev', 'infra']);
-const booleanFlags = new Set(['yes', 'frontend', 'genai', 'help', 'json', 'print']);
-const valueFlags = new Set(['api', 'pattern', 'cloud', 'region', 'spec', 'environments', 'config', 'project', 'env', 'profile']);
+const booleanFlag = (negatable = false) => ({ kind: 'boolean', negatable });
+const valueFlag = () => ({ kind: 'value' });
+const helpFlag = { help: booleanFlag() };
+const projectFlags = {
+    project: valueFlag(),
+    genai: booleanFlag(true),
+    api: valueFlag(),
+    pattern: valueFlag(),
+    cloud: valueFlag(),
+    region: valueFlag(),
+    frontend: booleanFlag(true),
+    environments: valueFlag(),
+    spec: valueFlag(),
+    config: valueFlag()
+};
+export const commandDefinitions = {
+    help: {
+        description: 'Show general or command-specific help',
+        usage: '[command]',
+        flags: helpFlag,
+        defaultMaxPositionals: 1
+    },
+    create: {
+        description: 'Generate a new project',
+        usage: '[project-name]',
+        flags: { ...projectFlags, yes: booleanFlag(), ...helpFlag },
+        defaultMaxPositionals: 1
+    },
+    plan: {
+        description: 'Preview generated artifacts',
+        usage: '',
+        flags: { ...projectFlags, ...helpFlag },
+        defaultMaxPositionals: 0
+    },
+    patterns: {
+        description: 'List GenAI patterns',
+        usage: '',
+        flags: helpFlag,
+        defaultMaxPositionals: 0
+    },
+    providers: {
+        description: 'List cloud providers',
+        usage: '',
+        flags: helpFlag,
+        defaultMaxPositionals: 0
+    },
+    regions: {
+        description: 'List or search provider regions',
+        usage: '[search <query>]',
+        flags: { cloud: valueFlag(), region: valueFlag(), ...helpFlag },
+        subcommands: ['search'],
+        defaultMaxPositionals: 0,
+        subcommandMaxPositionals: { search: 1 }
+    },
+    validate: {
+        description: 'Validate a generated project manifest',
+        usage: '[project-path]',
+        flags: { project: valueFlag(), ...helpFlag },
+        defaultMaxPositionals: 1
+    },
+    update: {
+        description: 'Reconcile a project with current templates',
+        usage: '[project-path]',
+        flags: {
+            project: valueFlag(),
+            apply: booleanFlag(),
+            force: booleanFlag(),
+            json: booleanFlag(),
+            ...helpFlag
+        },
+        defaultMaxPositionals: 1
+    },
+    migrate: {
+        description: 'Adopt an existing project',
+        usage: '<source-path>',
+        flags: { ...projectFlags, yes: booleanFlag(), ...helpFlag },
+        defaultMaxPositionals: 1
+    },
+    doctor: {
+        description: 'Check local and project readiness',
+        usage: '',
+        flags: { cloud: valueFlag(), json: booleanFlag(), ...helpFlag },
+        defaultMaxPositionals: 0
+    },
+    dev: {
+        description: 'Print Docker Compose helper commands',
+        usage: '[up|down|logs|reset]',
+        flags: { profile: valueFlag(), ...helpFlag },
+        subcommands: ['up', 'down', 'logs', 'reset'],
+        defaultMaxPositionals: 0,
+        subcommandMaxPositionals: { up: 0, down: 0, logs: 0, reset: 0 }
+    },
+    infra: {
+        description: 'Print OpenTofu helper commands',
+        usage: '[init|plan|apply|output]',
+        flags: { env: valueFlag(), ...helpFlag },
+        subcommands: ['init', 'plan', 'apply', 'output'],
+        defaultMaxPositionals: 0,
+        subcommandMaxPositionals: { init: 0, plan: 0, apply: 0, output: 0 }
+    }
+};
+export class UsageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UsageError';
+    }
+}
+function assignFlag(flags, name, value) {
+    if (Object.hasOwn(flags, name)) {
+        throw new UsageError(`Flag --${name} may be provided only once.`);
+    }
+    flags[name] = value;
+}
+function parseBooleanValue(name, value) {
+    if (value === 'true') {
+        return true;
+    }
+    if (value === 'false') {
+        return false;
+    }
+    throw new UsageError(`Flag --${name} expects true or false.`);
+}
 export function parseArgs(argv) {
-    const [command, maybeSubcommand, ...rest] = argv;
+    if (argv.length === 0) {
+        return { positional: [], flags: {} };
+    }
+    if (argv[0] === '--help') {
+        return { command: 'help', positional: [], flags: {} };
+    }
+    const command = argv[0];
+    if (command.startsWith('-')) {
+        throw new UsageError(`Unknown option: ${command}. Run \`liftoff help\` for usage.`);
+    }
+    const definition = commandDefinitions[command];
+    if (!definition) {
+        throw new UsageError(`Unknown command: ${command}. Run \`liftoff help\` for usage.`);
+    }
+    const tokens = argv.slice(1);
+    let subcommand;
+    if (definition.subcommands && tokens[0] && !tokens[0].startsWith('-')) {
+        const candidate = tokens.shift();
+        if (!definition.subcommands.includes(candidate)) {
+            throw new UsageError(`Unsupported ${command} subcommand: ${candidate}. Use one of: ${definition.subcommands.join(', ')}.`);
+        }
+        subcommand = candidate;
+    }
     const positional = [];
     const flags = {};
-    const hasSubcommand = Boolean(command && maybeSubcommand && !maybeSubcommand.startsWith('-') && commandsWithSubcommands.has(command));
-    const tokens = hasSubcommand ? rest : argv.slice(1);
-    const subcommand = hasSubcommand ? maybeSubcommand : undefined;
+    let positionalOnly = false;
     for (let index = 0; index < tokens.length; index += 1) {
         const token = tokens[index];
-        if (!token.startsWith('--')) {
-            positional.push(token);
+        if (token === '--') {
+            positionalOnly = true;
             continue;
         }
-        const withoutPrefix = token.slice(2);
-        if (withoutPrefix.startsWith('no-')) {
-            flags[withoutPrefix.slice(3)] = false;
+        if (positionalOnly || !token.startsWith('-')) {
+            positional.push(token);
             continue;
         }
+        if (!token.startsWith('--')) {
+            throw new UsageError(`Unknown option: ${token}. Liftoff options use --long-name syntax.`);
+        }
+        const withoutPrefix = token.slice(2);
         const equalsIndex = withoutPrefix.indexOf('=');
-        if (equalsIndex >= 0) {
-            const key = withoutPrefix.slice(0, equalsIndex);
-            flags[key] = withoutPrefix.slice(equalsIndex + 1);
+        const rawName = equalsIndex >= 0 ? withoutPrefix.slice(0, equalsIndex) : withoutPrefix;
+        const inlineValue = equalsIndex >= 0 ? withoutPrefix.slice(equalsIndex + 1) : undefined;
+        const negated = rawName.startsWith('no-');
+        const name = negated ? rawName.slice(3) : rawName;
+        const flagDefinition = definition.flags[name];
+        if (!flagDefinition) {
+            throw new UsageError(`Unknown flag for ${command}: --${rawName}.`);
+        }
+        if (negated) {
+            if (inlineValue !== undefined || flagDefinition.kind !== 'boolean' || !flagDefinition.negatable) {
+                throw new UsageError(`Flag --${name} does not support the --no-${name} form.`);
+            }
+            assignFlag(flags, name, false);
             continue;
         }
-        if (booleanFlags.has(withoutPrefix)) {
-            flags[withoutPrefix] = true;
+        if (flagDefinition.kind === 'boolean') {
+            assignFlag(flags, name, inlineValue === undefined ? true : parseBooleanValue(name, inlineValue));
             continue;
         }
-        if (valueFlags.has(withoutPrefix)) {
-            const next = tokens[index + 1];
-            if (!next || next.startsWith('--')) {
-                throw new Error(`Missing value for --${withoutPrefix}.`);
+        if (inlineValue !== undefined) {
+            if (inlineValue.length === 0) {
+                throw new UsageError(`Missing value for --${name}.`);
             }
-            flags[withoutPrefix] = next;
-            index += 1;
+            assignFlag(flags, name, inlineValue);
             continue;
         }
-        flags[withoutPrefix] = true;
-    }
-    return {
-        command,
-        subcommand,
-        positional,
-        flags
-    };
+        const next = tokens[index + 1];
+        if (!next || next.startsWith('-')) {
+            throw new UsageError(`Missing value for --${name}.`);
+        }
+        assignFlag(flags, name, next);
+        index += 1;
+    }
+    const maxPositionals = subcommand
+        ? definition.subcommandMaxPositionals?.[subcommand] ?? 0
+        : definition.defaultMaxPositionals;
+    if (positional.length > maxPositionals) {
+        throw new UsageError(`Too many positional arguments for ${command}${subcommand ? ` ${subcommand}` : ''}. ` +
+            `Usage: liftoff ${command}${definition.usage ? ` ${definition.usage}` : ''}`);
+    }
+    if (command === 'help' && positional[0] && !commandDefinitions[positional[0]]) {
+        throw new UsageError(`Unknown command for help: ${positional[0]}.`);
+    }
+    return { command, subcommand, positional, flags };
+}
+export function formatCommandHelp(command) {
+    const definition = commandDefinitions[command];
+    if (!definition) {
+        throw new UsageError(`Unknown command for help: ${command}.`);
+    }
+    const lines = [
+        `${command} - ${definition.description}`,
+        '',
+        `Usage: liftoff ${command}${definition.usage ? ` ${definition.usage}` : ''}`
+    ];
+    if (definition.subcommands) {
+        lines.push('', `Subcommands: ${definition.subcommands.join(', ')}`);
+    }
+    const flagNames = Object.entries(definition.flags).map(([name, flag]) => {
+        const value = flag.kind === 'value' ? ' <value>' : '';
+        const negated = flag.negatable ? ` / --no-${name}` : '';
+        return `  --${name}${value}${negated}`;
+    });
+    if (flagNames.length > 0) {
+        lines.push('', 'Options:', ...flagNames);
+    }
+    return `${lines.join('\n')}\n`;
 }
 export function readStringFlag(flags, name) {
     const value = flags[name];
-    if (typeof value === 'string') {
-        return value;
-    }
-    return undefined;
+    return typeof value === 'string' ? value : undefined;
 }
 export function readBooleanFlag(flags, name) {
     const value = flags[name];
-    if (typeof value === 'boolean') {
-        return value;
-    }
-    return undefined;
+    return typeof value === 'boolean' ? value : undefined;
 }
 export function readListFlag(flags, name) {
     const value = flags[name];

package/dist/args.js.map

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

package/dist/cli.js

@@ -1,11 +1,16 @@
 #!/usr/bin/env node
 import { parseArgs } from './args.js';
 import { runCommand } from './commands.js';
-const parsed = parseArgs(process.argv.slice(2));
-const exitCode = await runCommand(parsed, {
-    cwd: process.cwd(),
-    stdout: process.stdout,
-    stderr: process.stderr
-});
-process.exitCode = exitCode;
+try {
+    const parsed = parseArgs(process.argv.slice(2));
+    process.exitCode = await runCommand(parsed, {
+        cwd: process.cwd(),
+        stdout: process.stdout,
+        stderr: process.stderr
+    });
+}
+catch (error) {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+}
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;IACxC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;IAClB,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,MAAM,EAAE,OAAO,CAAC,MAAM;CACvB,CAAC,CAAC;AAEH,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,IAAI,CAAC;IACH,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,QAAQ,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;QAC1C,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC,CAAC;AACL,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/commands.js

@@ -3,9 +3,9 @@ import { existsSync } from 'node:fs';
 import { cp, mkdir, mkdtemp, rm, stat, writeFile } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
-import { readBooleanFlag, readListFlag, readStringFlag } from './args.js';
+import { formatCommandHelp, readBooleanFlag, readListFlag, readStringFlag } from './args.js';
 import { apiStacks, listRegions, patterns, providers, searchRegions } from './catalogs.js';
-import { artifactPath, assertNewOrEmptyDirectory, deleteProjectFile, findProjectRoot, loadManifest, manifestDisplayPath, resolveTargetRoot, validateGeneratedProject, writeArtifacts, writeProjectFile } from './file-system.js';
+import { artifactPath, assertNewOrEmptyDirectory, deleteProjectFile, findProjectRoot, loadManifest, manifestDisplayPath, resolveProjectPath, resolveTargetRoot, validateGeneratedProject, writeArtifacts, writeProjectFile } from './file-system.js';
 import { confirmPlan, promptForCreateOptions } from './interactive.js';
 import { renderMigrationChecklist, renderMigrationProposal, renderMigrationTasks, seedMigrationGroups } from './migrate-plan.js';
 import { buildProjectPlan, formatProjectPlan, loadConfigOptions, mergeOptions, PlanValidationError } from './planner.js';
@@ -16,11 +16,20 @@ import { buildArtifacts, buildManifest } from './templates.js';
 import { liftoffVersion } from './version.js';
 export async function runCommand(parsed, context) {
     try {
+        if (parsed.command && readBooleanFlag(parsed.flags, 'help')) {
+            context.stdout.write(formatCommandHelp(parsed.command));
+            return 0;
+        }
         switch (parsed.command) {
             case undefined:
             case 'help':
             case '--help':
-                printHelp(context.stdout);
+                if (parsed.positional[0]) {
+                    context.stdout.write(formatCommandHelp(parsed.positional[0]));
+                }
+                else {
+                    printHelp(context.stdout);
+                }
                 return 0;
             case 'create':
                 return await createCommand(parsed, context);
@@ -281,6 +290,23 @@ function isDirtyGitWorktree(projectRoot) {
     const result = spawnSync('git', ['status', '--porcelain'], { cwd: projectRoot, encoding: 'utf8' });
     return result.status === 0 && result.stdout.trim().length > 0;
 }
+async function preflightUpdate(projectRoot, entries, force) {
+    for (const entry of entries) {
+        const writesDestination = entry.status === 'new' ||
+            entry.status === 'missing' ||
+            entry.status === 'upgrade' ||
+            entry.status === 'moved' && (entry.cleanMove === true || force) ||
+            entry.status === 'conflict' && force;
+        if (writesDestination) {
+            await resolveProjectPath(projectRoot, entry.pathParts);
+        }
+        if (entry.previousPathParts &&
+            (entry.status === 'moved' && (entry.cleanMove === true || force) || entry.status === 'conflict' && force)) {
+            await resolveProjectPath(projectRoot, entry.previousPathParts);
+        }
+    }
+    await resolveProjectPath(projectRoot, ['liftoff.manifest.json']);
+}
 async function updateCommand(parsed, context) {
     const apply = readBooleanFlag(parsed.flags, 'apply') ?? false;
     const force = readBooleanFlag(parsed.flags, 'force') ?? false;
@@ -353,6 +379,7 @@ async function updateCommand(parsed, context) {
     if (isDirtyGitWorktree(projectRoot)) {
         context.stdout.write('Hint: the project worktree has uncommitted changes - consider committing before applying.\n');
     }
+    await preflightUpdate(projectRoot, entries, force);
     const written = [];
     const skipped = [];
     for (const entry of entries) {
@@ -365,7 +392,9 @@ async function updateCommand(parsed, context) {
                 break;
             case 'moved':
                 if (entry.cleanMove || force) {
-                    await writeProjectFile(projectRoot, entry.pathParts, entry.rendered.content);
+                    if (!entry.destinationMatches) {
+                        await writeProjectFile(projectRoot, entry.pathParts, entry.rendered.content);
+                    }
                     await deleteProjectFile(projectRoot, entry.previousPathParts);
                     written.push(entry);
                 }
@@ -376,6 +405,9 @@ async function updateCommand(parsed, context) {
             case 'conflict':
                 if (force) {
                     await writeProjectFile(projectRoot, entry.pathParts, entry.rendered.content);
+                    if (entry.previousPathParts) {
+                        await deleteProjectFile(projectRoot, entry.previousPathParts);
+                    }
                     written.push(entry);
                 }
                 else {
@@ -389,16 +421,19 @@ async function updateCommand(parsed, context) {
     const oldByName = new Map(manifest.artifacts.map((artifact) => [artifact.logicalName, artifact]));
     const skippedByName = new Map(skipped.map((entry) => [entry.logicalName, entry]));
     const nextManifest = buildManifest(plan, render.filter((artifact) => artifact.logicalName !== 'manifest'));
-    nextManifest.artifacts = nextManifest.artifacts.map((artifact) => {
+    nextManifest.artifacts = nextManifest.artifacts.flatMap((artifact) => {
         // config is user-owned after create: carry the recorded entry forward untouched
         if (artifact.logicalName === 'liftoff-config') {
-            return oldByName.get('liftoff-config') ?? artifact;
+            return [oldByName.get('liftoff-config') ?? artifact];
         }
         if (!skippedByName.has(artifact.logicalName)) {
-            return artifact;
+            return [artifact];
         }
         const previous = oldByName.get(artifact.logicalName);
-        return { ...artifact, pathParts: previous.pathParts, contentHash: previous.contentHash };
+        if (!previous) {
+            return [];
+        }
+        return [{ ...artifact, pathParts: previous.pathParts, contentHash: previous.contentHash }];
     });
     for (const entry of entries) {
         if (entry.status === 'orphan') {