@msn-control/liftoff 0.3.3 → 0.4.0

package/dist/framework-validation.js

@@ -0,0 +1,83 @@
+import { lstat, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { getFrameworkDefinition } from './catalogs.js';
+function errorCode(error) {
+    return typeof error === 'object' && error !== null && 'code' in error &&
+        typeof error.code === 'string'
+        ? error.code
+        : undefined;
+}
+async function markerIssue(root, pathParts) {
+    const display = pathParts.join('/');
+    try {
+        const details = await lstat(path.join(root, ...pathParts));
+        if (details.isSymbolicLink()) {
+            return `Framework marker is a forbidden symlink: ${display}`;
+        }
+        if (!details.isFile()) {
+            return `Framework marker is not a regular file: ${display}`;
+        }
+        return undefined;
+    }
+    catch (error) {
+        if (errorCode(error) === 'ENOENT') {
+            return `Missing framework marker: ${display}`;
+        }
+        return `Unable to inspect framework marker ${display}: ${error instanceof Error ? error.message : String(error)}`;
+    }
+}
+async function validateSpecKitState(root, selection) {
+    const issues = [];
+    let parsed;
+    try {
+        parsed = JSON.parse(await readFile(path.join(root, '.specify', 'integration.json'), 'utf8'));
+    }
+    catch (error) {
+        return [`Unable to read .specify/integration.json: ${error instanceof Error ? error.message : String(error)}`];
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        return ['Spec Kit integration state must be a JSON object.'];
+    }
+    const state = parsed;
+    const expectedDefault = selection.defaultAgent === 'github-copilot' ? 'copilot' : selection.defaultAgent;
+    const defaultIntegration = state.default_integration ?? state.integration;
+    if (defaultIntegration !== expectedDefault) {
+        issues.push(`Spec Kit default integration is ${JSON.stringify(defaultIntegration)}; expected ${JSON.stringify(expectedDefault)}.`);
+    }
+    const installed = state.installed_integrations;
+    if (!Array.isArray(installed) || installed.some((value) => typeof value !== 'string')) {
+        issues.push('Spec Kit installed_integrations must be a string array.');
+        return issues;
+    }
+    const expected = selection.agents.map((agent) => agent === 'github-copilot' ? 'copilot' : agent);
+    for (const integration of expected) {
+        if (!installed.includes(integration)) {
+            issues.push(`Spec Kit integration state does not include selected integration ${integration}.`);
+        }
+    }
+    return issues;
+}
+export async function validateFrameworkInstallation(root, selection) {
+    const definition = getFrameworkDefinition(selection.workflow);
+    const markers = [
+        ...definition.baseMarkers,
+        ...selection.agents.flatMap((agent) => definition.agentMarkers[agent])
+    ];
+    const issues = (await Promise.all(markers.map((marker) => markerIssue(root, marker))))
+        .filter((issue) => issue !== undefined);
+    if (selection.workflow === 'spec-kit' && !selection.defaultAgent) {
+        issues.push('Spec Kit framework state is missing its default agent.');
+    }
+    else if (selection.workflow === 'spec-kit') {
+        issues.push(...await validateSpecKitState(root, selection));
+    }
+    return issues;
+}
+export function frameworkSelectionFromPlan(plan) {
+    return {
+        workflow: plan.specWorkflow.id,
+        agents: plan.agents.map((agent) => agent.id),
+        ...(plan.defaultAgent ? { defaultAgent: plan.defaultAgent.id } : {})
+    };
+}
+//# sourceMappingURL=framework-validation.js.map

package/dist/framework-validation.js.map

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

package/dist/init-filesystem.d.ts

@@ -0,0 +1,102 @@
+import type { CommandRunner } from './process-runner.js';
+import type { GeneratedArtifact } from './types.js';
+export type InitTargetMode = 'in-place' | 'named-child';
+export type StagedOrigin = 'liftoff' | 'framework' | 'seed';
+export type TreeEntryType = 'file' | 'directory' | 'symlink' | 'other';
+export type PreflightAction = 'create' | 'identical' | 'replace' | 'merge-directory' | 'blocked';
+export interface GitRootDiscovery {
+    cwd: string;
+    canonicalCwd: string;
+    root?: string;
+    exact: boolean;
+}
+export interface InitTarget {
+    root: string;
+    mode: InitTargetMode;
+    gitRoot?: string;
+}
+export interface StagingArea {
+    root: string;
+    origins: Map<string, StagedOrigin>;
+    frameworkAllowedRoots: Set<string>;
+}
+export interface TreeStateEntry {
+    pathParts: string[];
+    type: TreeEntryType;
+    contentHash?: string;
+    mode?: number;
+}
+export interface ValidatedStagedFile {
+    pathParts: string[];
+    relativePath: string;
+    content: Buffer;
+    contentHash: string;
+    mode: number;
+    origin: StagedOrigin;
+}
+export interface TargetRootSnapshot {
+    state: 'missing' | 'directory';
+    canonicalPath: string;
+    parentCanonicalPath: string;
+    parentDevice: number;
+    parentInode: number;
+    device?: number;
+    inode?: number;
+}
+export interface PreflightEntry {
+    pathParts: readonly string[];
+    relativePath: string;
+    stagedType: 'file' | 'directory';
+    origin?: StagedOrigin;
+    action: PreflightAction;
+    detail: string;
+    stagedHash?: string;
+    stagedMode?: number;
+    destination: {
+        type: 'missing' | TreeEntryType;
+        contentHash?: string;
+        mode?: number;
+    };
+}
+export interface MergePreflight {
+    stagingRoot: string;
+    targetRoot: string;
+    targetRootSnapshot: TargetRootSnapshot;
+    entries: readonly PreflightEntry[];
+    replacements: readonly PreflightEntry[];
+    blocked: readonly PreflightEntry[];
+}
+export interface MergeResult {
+    created: string[];
+    replaced: string[];
+    identical: string[];
+    mergedDirectories: string[];
+}
+export interface RollbackReport {
+    restored: string[];
+    removed: string[];
+    failures: string[];
+}
+export declare class InitFileSystemError extends Error {
+    constructor(message: string);
+}
+export declare class MergeApplyError extends InitFileSystemError {
+    readonly rollback: RollbackReport;
+    constructor(message: string, rollback: RollbackReport);
+}
+export declare function normalizeComparisonPath(value: string, platform?: NodeJS.Platform): string;
+export declare function discoverGitRoot(cwd: string, runner: CommandRunner, platform?: NodeJS.Platform): Promise<GitRootDiscovery>;
+export declare function resolveInitTarget(cwd: string, safeProjectName: string, runner: CommandRunner, platform?: NodeJS.Platform): Promise<InitTarget>;
+export declare function resolveInitTargetFromDiscovery(git: GitRootDiscovery, safeProjectName: string): InitTarget;
+export declare function assertSafeInitTarget(target: InitTarget, confinementRoot?: string): Promise<void>;
+export declare function withStagingArea<T>(operation: (area: StagingArea) => Promise<T>): Promise<T>;
+export declare function writeStagedArtifacts(area: StagingArea, artifacts: GeneratedArtifact[], origin: StagedOrigin): Promise<void>;
+export declare function captureTreeState(root: string): Promise<Map<string, TreeStateEntry>>;
+export declare function claimFrameworkChanges(area: StagingArea, before: Map<string, TreeStateEntry>, allowedRoots: string[]): Promise<string[]>;
+export declare function validateStagedTree(area: StagingArea): Promise<ValidatedStagedFile[]>;
+export declare function buildMergePreflight(area: StagingArea, targetRoot: string): Promise<MergePreflight>;
+export declare function authorizeMergePreflight(preflight: MergePreflight, force: boolean, confirm?: (replacementPaths: readonly string[]) => Promise<boolean>): Promise<MergePreflight | undefined>;
+export declare function applyMergePreflight(preflight: MergePreflight, options?: {
+    onBeforeMutation?: (entry: PreflightEntry, index: number) => Promise<void>;
+    requireEmptyTarget?: boolean;
+}): Promise<MergeResult>;