container-superposition 0.1.1

package/dist/tool/schema/overlay-loader.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Overlay registry loader
+ *
+ * This module provides functions to load overlay metadata from:
+ * 1. Individual overlay.yml manifests (new approach)
+ * 2. Fallback to central overlays/index.yml (backward compatibility)
+ */
+import type { OverlayMetadata, OverlaysConfig, PackageManager } from './types.js';
+/**
+ * Load overlay manifest from individual overlay directory
+ */
+export declare function loadOverlayManifest(overlayDir: string): OverlayMetadata | null;
+/**
+ * Scan overlay directories and load all manifests
+ */
+export declare function loadOverlayManifests(overlaysDir: string): Map<string, OverlayMetadata>;
+/**
+ * Load preset metadata from presets directory
+ */
+export declare function loadPresetMetadata(overlaysDir: string): OverlayMetadata[];
+/**
+ * Load base images from registry file
+ */
+export declare function loadBaseImages(overlaysDir: string): Array<{
+    id: string;
+    name: string;
+    description: string;
+    image: string | null;
+    package_manager?: PackageManager;
+}>;
+/**
+ * Load base templates from registry file
+ */
+export declare function loadBaseTemplates(overlaysDir: string): Array<{
+    id: string;
+    name: string;
+    description: string;
+}>;
+/**
+ * Build OverlaysConfig from individual manifests
+ */
+export declare function buildOverlaysConfigFromManifests(overlaysDir: string): OverlaysConfig;
+/**
+ * Load overlays config with fallback to index.yml
+ */
+export declare function loadOverlaysConfig(overlaysDir: string, indexYmlPath: string): OverlaysConfig;
+//# sourceMappingURL=overlay-loader.d.ts.map

package/dist/tool/schema/overlay-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-loader.d.ts","sourceRoot":"","sources":["../../../tool/schema/overlay-loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAElF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA+D9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAyCtF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,EAAE,CAyCzE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,eAAe,CAAC,EAAE,cAAc,CAAC;CACpC,CAAC,CAeD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC,CAeD;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,CA0BpF;AACD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,cAAc,CA+C5F"}

package/dist/tool/schema/overlay-loader.js

@@ -0,0 +1,252 @@
+/**
+ * Overlay registry loader
+ *
+ * This module provides functions to load overlay metadata from:
+ * 1. Individual overlay.yml manifests (new approach)
+ * 2. Fallback to central overlays/index.yml (backward compatibility)
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import yaml from 'js-yaml';
+/**
+ * Load overlay manifest from individual overlay directory
+ */
+export function loadOverlayManifest(overlayDir) {
+    const manifestPath = path.join(overlayDir, 'overlay.yml');
+    if (!fs.existsSync(manifestPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(manifestPath, 'utf8');
+        const manifest = yaml.load(content);
+        // Validate required fields
+        if (!manifest.id || !manifest.name || !manifest.description || !manifest.category) {
+            console.warn(`Warning: Invalid manifest in ${overlayDir}`);
+            return null;
+        }
+        // Validate and coerce array fields to ensure they are actual arrays
+        const ensureArray = (value) => {
+            if (Array.isArray(value)) {
+                // Validate all elements are strings
+                if (!value.every((item) => typeof item === 'string')) {
+                    console.warn(`Warning: Non-string values in array field in ${overlayDir}`);
+                    return value.filter((item) => typeof item === 'string');
+                }
+                return value;
+            }
+            if (typeof value === 'string') {
+                // Single string value - wrap in array
+                console.warn(`Warning: Scalar value instead of array in ${overlayDir}, wrapping in array`);
+                return [value];
+            }
+            return [];
+        };
+        const ensureNumberArray = (value) => {
+            if (Array.isArray(value)) {
+                // Validate all elements are numbers
+                if (!value.every((item) => typeof item === 'number')) {
+                    console.warn(`Warning: Non-number values in ports array in ${overlayDir}`);
+                    return value.filter((item) => typeof item === 'number');
+                }
+                return value;
+            }
+            return [];
+        };
+        // Set defaults for optional fields with type validation
+        return {
+            ...manifest,
+            supports: ensureArray(manifest.supports),
+            requires: ensureArray(manifest.requires),
+            suggests: ensureArray(manifest.suggests),
+            conflicts: ensureArray(manifest.conflicts),
+            tags: ensureArray(manifest.tags),
+            ports: ensureNumberArray(manifest.ports),
+        };
+    }
+    catch (error) {
+        console.warn(`Warning: Failed to parse manifest in ${overlayDir}:`, error);
+        return null;
+    }
+}
+/**
+ * Scan overlay directories and load all manifests
+ */
+export function loadOverlayManifests(overlaysDir) {
+    const manifests = new Map();
+    if (!fs.existsSync(overlaysDir)) {
+        return manifests;
+    }
+    const entries = fs.readdirSync(overlaysDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        // Skip special directories (but not presets - handled separately)
+        if (entry.name.startsWith('.')) {
+            continue;
+        }
+        // Skip presets directory (presets are loaded separately)
+        if (entry.name === 'presets') {
+            continue;
+        }
+        const overlayDir = path.join(overlaysDir, entry.name);
+        const manifest = loadOverlayManifest(overlayDir);
+        if (manifest) {
+            // Validate ID matches directory name
+            if (manifest.id !== entry.name) {
+                console.warn(`Warning: Manifest ID '${manifest.id}' doesn't match directory name '${entry.name}'`);
+                continue;
+            }
+            manifests.set(manifest.id, manifest);
+        }
+    }
+    return manifests;
+}
+/**
+ * Load preset metadata from presets directory
+ */
+export function loadPresetMetadata(overlaysDir) {
+    const presetsDir = path.join(overlaysDir, 'presets');
+    const presets = [];
+    if (!fs.existsSync(presetsDir)) {
+        return presets;
+    }
+    try {
+        const files = fs.readdirSync(presetsDir);
+        for (const file of files) {
+            if (!file.endsWith('.yml') && !file.endsWith('.yaml')) {
+                continue;
+            }
+            const presetPath = path.join(presetsDir, file);
+            const content = fs.readFileSync(presetPath, 'utf8');
+            const preset = yaml.load(content);
+            // Extract metadata from preset definition
+            if (preset.id && preset.name && preset.description) {
+                presets.push({
+                    id: preset.id,
+                    name: preset.name,
+                    description: preset.description,
+                    category: 'preset',
+                    supports: preset.supports || [],
+                    requires: [],
+                    suggests: [],
+                    conflicts: [],
+                    tags: preset.tags || [],
+                    ports: [],
+                });
+            }
+        }
+    }
+    catch (error) {
+        console.warn('Warning: Failed to load preset metadata:', error);
+    }
+    return presets;
+}
+/**
+ * Load base images from registry file
+ */
+export function loadBaseImages(overlaysDir) {
+    const registryPath = path.join(overlaysDir, '.registry', 'base-images.yml');
+    if (!fs.existsSync(registryPath)) {
+        return [];
+    }
+    try {
+        const content = fs.readFileSync(registryPath, 'utf8');
+        const data = yaml.load(content);
+        return data.base_images || [];
+    }
+    catch (error) {
+        console.warn('Warning: Failed to load base images:', error);
+        return [];
+    }
+}
+/**
+ * Load base templates from registry file
+ */
+export function loadBaseTemplates(overlaysDir) {
+    const registryPath = path.join(overlaysDir, '.registry', 'base-templates.yml');
+    if (!fs.existsSync(registryPath)) {
+        return [];
+    }
+    try {
+        const content = fs.readFileSync(registryPath, 'utf8');
+        const data = yaml.load(content);
+        return data.base_templates || [];
+    }
+    catch (error) {
+        console.warn('Warning: Failed to load base templates:', error);
+        return [];
+    }
+}
+/**
+ * Build OverlaysConfig from individual manifests
+ */
+export function buildOverlaysConfigFromManifests(overlaysDir) {
+    const manifests = loadOverlayManifests(overlaysDir);
+    const presetOverlays = loadPresetMetadata(overlaysDir);
+    // Sort function used below
+    const sortByOrderThenName = (a, b) => {
+        if (a.order !== undefined && b.order !== undefined) {
+            return a.order - b.order;
+        }
+        if (a.order !== undefined)
+            return -1;
+        if (b.order !== undefined)
+            return 1;
+        return a.name.localeCompare(b.name);
+    };
+    // New approach: Single overlays array (category-agnostic)
+    const allOverlays = [...manifests.values()];
+    if (presetOverlays) {
+        allOverlays.push(...presetOverlays);
+    }
+    allOverlays.sort(sortByOrderThenName);
+    return {
+        base_images: loadBaseImages(overlaysDir),
+        base_templates: loadBaseTemplates(overlaysDir),
+        overlays: allOverlays,
+    };
+}
+/**
+ * Load overlays config with fallback to index.yml
+ */
+export function loadOverlaysConfig(overlaysDir, indexYmlPath) {
+    // First, try to load from individual manifests
+    const registryPath = path.join(overlaysDir, '.registry', 'base-images.yml');
+    if (fs.existsSync(registryPath)) {
+        // New approach: load from individual manifests
+        return buildOverlaysConfigFromManifests(overlaysDir);
+    }
+    // Fallback to old centralized index.yml
+    if (fs.existsSync(indexYmlPath)) {
+        const content = fs.readFileSync(indexYmlPath, 'utf8');
+        const legacyConfig = yaml.load(content);
+        // Check if this is the new format (has 'overlays' field) or old format (per-category arrays)
+        if (legacyConfig.overlays && Array.isArray(legacyConfig.overlays)) {
+            // New format - already has overlays array
+            return legacyConfig;
+        }
+        // Old format - convert per-category arrays to single overlays array
+        const allOverlays = [];
+        const categoryKeys = [
+            'language_overlays',
+            'database_overlays',
+            'observability_overlays',
+            'cloud_tool_overlays',
+            'dev_tool_overlays',
+            'preset_overlays',
+        ];
+        for (const key of categoryKeys) {
+            if (legacyConfig[key] && Array.isArray(legacyConfig[key])) {
+                allOverlays.push(...legacyConfig[key]);
+            }
+        }
+        return {
+            base_images: legacyConfig.base_images || [],
+            base_templates: legacyConfig.base_templates || [],
+            overlays: allOverlays,
+        };
+    }
+    throw new Error('No overlay configuration found. Expected either .registry/ directory or index.yml');
+}
+//# sourceMappingURL=overlay-loader.js.map

package/dist/tool/schema/overlay-loader.js.map

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

package/dist/tool/schema/types.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Configuration schema for container-superposition initialization
+ */
+export type Stack = 'plain' | 'compose';
+export type BaseImage = 'bookworm' | 'trixie' | 'alpine' | 'ubuntu' | 'custom';
+export type PackageManager = 'apt' | 'apk';
+export type LanguageOverlay = 'dotnet' | 'nodejs' | 'python' | 'mkdocs' | 'java' | 'go' | 'rust' | 'bun' | 'powershell';
+export type DatabaseOverlay = 'postgres' | 'redis' | 'mongodb' | 'mysql' | 'sqlserver' | 'sqlite' | 'minio' | 'rabbitmq' | 'redpanda' | 'nats';
+export type CloudTool = 'azure-cli' | 'aws-cli' | 'gcloud' | 'kubectl-helm' | 'terraform' | 'pulumi';
+export type DevTool = 'docker-in-docker' | 'docker-sock' | 'codex' | 'playwright' | 'git-helpers' | 'pre-commit' | 'commitlint' | 'just' | 'direnv' | 'modern-cli-tools' | 'ngrok';
+export type ObservabilityTool = 'otel-collector' | 'jaeger' | 'prometheus' | 'grafana' | 'loki';
+export type Database = 'none' | 'postgres' | 'redis' | 'postgres+redis';
+export interface DevContainerConfig {
+    /**
+     * The base template to use (plain or compose)
+     */
+    stack: Stack;
+    /**
+     * Language/framework overlay
+     */
+    language?: LanguageOverlay;
+    /**
+     * Database requirements
+     */
+    database?: Database;
+    /**
+     * Include Playwright for browser automation
+     */
+    playwright?: boolean;
+    /**
+     * Cloud/orchestration tools to include
+     */
+    cloudTools?: CloudTool[];
+    /**
+     * Observability tools to include
+     */
+    observability?: ObservabilityTool[];
+    /**
+     * Where to write the devcontainer configuration
+     */
+    outputPath?: string;
+}
+/**
+ * Questionnaire response interface
+ */
+export interface QuestionnaireAnswers {
+    stack: Stack;
+    baseImage: BaseImage;
+    customImage?: string;
+    containerName?: string;
+    preset?: string;
+    presetChoices?: Record<string, string>;
+    presetGlueConfig?: PresetGlueConfig;
+    language?: LanguageOverlay[];
+    needsDocker: boolean;
+    database?: DatabaseOverlay[];
+    playwright: boolean;
+    cloudTools: CloudTool[];
+    devTools: DevTool[];
+    observability: ObservabilityTool[];
+    outputPath: string;
+    portOffset?: number;
+}
+/**
+ * Port attributes configuration
+ */
+export interface PortAttributes {
+    label?: string;
+    onAutoForward?: 'notify' | 'openBrowser' | 'openPreview' | 'silent' | 'ignore';
+    elevateIfNeeded?: boolean;
+    requireLocalPort?: boolean;
+    protocol?: 'http' | 'https';
+}
+/**
+ * DevContainer JSON structure (minimal typing)
+ */
+export interface DevContainer {
+    name?: string;
+    image?: string;
+    build?: {
+        dockerfile?: string;
+        context?: string;
+    };
+    features?: Record<string, any>;
+    customizations?: {
+        vscode?: {
+            extensions?: string[];
+            settings?: Record<string, any>;
+        };
+    };
+    forwardPorts?: number[];
+    portsAttributes?: Record<string, PortAttributes>;
+    mounts?: string[];
+    remoteEnv?: Record<string, string>;
+    postCreateCommand?: string | Record<string, string>;
+    postStartCommand?: string | Record<string, string>;
+    remoteUser?: string;
+    workspaceFolder?: string;
+    [key: string]: any;
+}
+/**
+ * Overlay categories - just metadata for grouping in UI
+ */
+export type OverlayCategory = 'language' | 'database' | 'observability' | 'cloud' | 'dev' | 'preset';
+/**
+ * Overlay metadata from overlays.yml
+ */
+export interface OverlayMetadata {
+    id: string;
+    name: string;
+    description: string;
+    category: OverlayCategory;
+    supports?: string[];
+    requires?: string[];
+    suggests?: string[];
+    conflicts?: string[];
+    tags?: string[];
+    ports?: number[];
+    order?: number;
+}
+/**
+ * User choice configuration for presets
+ */
+export interface PresetUserChoice {
+    id: string;
+    prompt: string;
+    options: string[];
+    defaultOption?: string;
+}
+/**
+ * Glue configuration for presets
+ */
+export interface PresetGlueConfig {
+    environment?: Record<string, string>;
+    portMappings?: Record<string, number>;
+    readme?: string;
+}
+/**
+ * Meta-overlay (preset) definition
+ */
+export interface MetaOverlay {
+    id: string;
+    name: string;
+    description: string;
+    category: 'preset';
+    type: 'meta';
+    supports?: string[];
+    tags?: string[];
+    selects: {
+        required: string[];
+        userChoice?: Record<string, PresetUserChoice>;
+    };
+    glueConfig?: PresetGlueConfig;
+}
+/**
+ * Overlays configuration structure
+ */
+export interface OverlaysConfig {
+    base_images: Array<{
+        id: string;
+        name: string;
+        description: string;
+        image: string | null;
+        package_manager?: PackageManager;
+    }>;
+    base_templates: Array<{
+        id: string;
+        name: string;
+        description: string;
+    }>;
+    /** All overlays, regardless of category */
+    overlays: OverlayMetadata[];
+}
+/**
+ * Superposition manifest generated alongside devcontainer.json
+ */
+export interface SuperpositionManifest {
+    version: string;
+    generated: string;
+    baseTemplate: Stack;
+    baseImage: string;
+    overlays: string[];
+    portOffset?: number;
+    preset?: string;
+    presetChoices?: Record<string, string>;
+    autoResolved?: {
+        added: string[];
+        reason: string;
+    };
+    containerName?: string;
+    customizations?: {
+        enabled: boolean;
+        location: string;
+    };
+}
+/**
+ * Custom patch configuration loaded from .devcontainer/custom/
+ */
+export interface CustomizationConfig {
+    devcontainerPatch?: DevContainer;
+    dockerComposePatch?: any;
+    environmentVars?: Record<string, string>;
+    scripts?: {
+        postCreate?: string[];
+        postStart?: string[];
+    };
+    files?: Array<{
+        source: string;
+        destination: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tool/schema/types.d.ts.map

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

package/dist/tool/schema/types.js

@@ -0,0 +1,5 @@
+/**
+ * Configuration schema for container-superposition initialization
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tool/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../tool/schema/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}