@illumiarq/lumis 1.2.7 → 1.2.9

package/README.md

@@ -0,0 +1,38 @@
+# @lumiarq/lumis
+
+Lumis is the CLI host package for the Lumiarq code-generation and verification stack.
+
+## What it does
+
+- Detects the best framework pack for a project
+- Builds and updates IR from adapters
+- Runs commands like `doctor`, `init`, `runtime`, and `commands`
+- Orchestrates runtime profiles, transcript storage, and post-make tasks
+
+## Install
+
+```bash
+npm install -g @lumiarq/lumis
+```
+
+Or run locally in a project:
+
+```bash
+npx @lumiarq/lumis --help
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm turbo run build
+pnpm turbo run test
+pnpm turbo run typecheck
+```
+
+## Contributing
+
+1. Open an issue describing the feature or bug.
+2. Add tests with your change.
+3. Keep exports stable and update docs for user-facing behavior.
+4. Run `pnpm turbo run test typecheck build` before creating a PR.

package/dist/adapter-loader.d.ts

@@ -0,0 +1,67 @@
+import type { LumisAdapter, LumisPackModule } from '@lumiarq/context';
+export declare function getBuiltinPacks(): LumisPackModule[];
+/**
+ * Convenience helper for callers that still operate on adapters directly.
+ *
+ * @returns Built-in adapters derived from the built-in pack registry.
+ */
+export declare function getBuiltinAdapters(): LumisAdapter[];
+/**
+ * Discover and return all pack modules available to the current project.
+ * Combines built-in packs with packs declared in package.json dependencies.
+ *
+ * @param projectRoot - Path to the project for which to discover packs.
+ * @returns Array of discovered pack modules.
+ */
+export declare function getAvailablePacks(projectRoot: string): Promise<LumisPackModule[]>;
+/**
+ * Lookup a built-in pack by either manifest framework id or adapter name.
+ *
+ * @param framework - Framework or adapter name to lookup.
+ * @returns Matching pack or null if no match is found.
+ */
+export declare function getBuiltinPackByFramework(framework: string): LumisPackModule | null;
+export declare function detectBestPack(projectRoot: string, packs?: LumisPackModule[]): Promise<LumisPackModule | null>;
+/**
+ * Adapter-only detection path for backward compatibility.
+ *
+ * @param projectRoot - Path to the project for which to detect an adapter.
+ * @param adapters - Optional list of adapters to consider for detection. Defaults to built-in adapters.
+ * @returns Best matching adapter, or null when no compatible adapter is detected.
+ *
+ * Selection strategy: Highest detection confidence wins.
+ */
+export declare function detectBestAdapter(projectRoot: string, adapters?: LumisAdapter[]): Promise<LumisAdapter | null>;
+/**
+ * Resolve a pack for a project.
+ *
+ * @param projectRoot - Path to the project for which to resolve a pack.
+ * @param options.configuredAdapter - Optional adapter/framework hint from configuration. If provided, we will first attempt to match this to a built-in pack before falling back to detection.
+ * @param options.packs - Optional list of packs to consider for resolution. Defaults to built-in packs.
+ * @returns Resolved pack module, or null when no compatible pack can be resolved.
+ *
+ * Resolution strategy:
+ * If a configured adapter/framework is provided and matches a built-in pack,
+ * it is preferred. Otherwise we fall back to automatic detection.
+ */
+export declare function resolvePackForProject(projectRoot: string, options?: {
+    configuredAdapter?: string;
+    packs?: LumisPackModule[];
+}): Promise<LumisPackModule | null>;
+/**
+ * Resolve adapter for a project through pack resolution.
+ *
+ * @param projectRoot - Path to the project for which to resolve an adapter.
+ * @param options.configuredAdapter - Optional adapter/framework hint from configuration. If provided, we will first attempt to match this to a built-in pack before falling back to detection.
+ * @param options.packs - Optional list of packs to consider for resolution. Defaults to built-in packs.
+ * @returns Resolved adapter, or null when no compatible pack/adapter can be resolved.
+ *
+ * Resolution strategy:
+ * If a configured adapter/framework is provided and matches a built-in pack,
+ * it is preferred. Otherwise we fall back to automatic detection.
+ */
+export declare function resolveAdapterForProject(projectRoot: string, options?: {
+    configuredAdapter?: string;
+    packs?: LumisPackModule[];
+}): Promise<LumisAdapter | null>;
+//# sourceMappingURL=adapter-loader.d.ts.map

package/dist/adapter-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-loader.d.ts","sourceRoot":"","sources":["../src/adapter-loader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AA+GrE,wBAAgB,eAAe,IAAI,eAAe,EAAE,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,EAAE,CAEnD;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAmBvF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAMnF;AA0BD,wBAAsB,cAAc,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,eAAe,EAAE,GACvB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAmCjC;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACtC,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,YAAY,EAAyB,GAC7C,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAe9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACT,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;CACzB,GACC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAmCjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,wBAAwB,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACT,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;CACzB,GACC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAG9B"}

package/dist/adapter-loader.js

@@ -0,0 +1,273 @@
+/**
+ * Adapter/pack loading for the host `lumis` package.
+ *
+ * This module is intentionally host-owned (not pack-owned) so the CLI/runtime has
+ * one place to resolve built-in packs, detect project compatibility, and map to an adapter.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { LUMIARQ_SCOPE } from '@lumiarq/context';
+import { LUMIARQ_PACK_MANIFEST, LumiarqAdapter } from '@lumiarq/pack-lumiarq';
+import { NEXTJS_PACK_MANIFEST, NextjsAdapter } from '@lumiarq/pack-nextjs';
+import { DJANGO_PACK_MANIFEST, DjangoAdapter } from '@lumiarq/pack-django';
+import { LARAVEL_PACK_MANIFEST, LaravelAdapter } from '@lumiarq/pack-laravel';
+const BUILTIN_PACKS = [
+    {
+        manifest: LUMIARQ_PACK_MANIFEST,
+        adapter: LumiarqAdapter,
+    },
+    {
+        manifest: NEXTJS_PACK_MANIFEST,
+        adapter: NextjsAdapter,
+    },
+    {
+        manifest: DJANGO_PACK_MANIFEST,
+        adapter: DjangoAdapter,
+    },
+    {
+        manifest: LARAVEL_PACK_MANIFEST,
+        adapter: LaravelAdapter,
+    },
+];
+async function discoverPacksForProject(projectRoot) {
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+        return [];
+    }
+    let pkgContent;
+    try {
+        pkgContent = fs.readFileSync(packageJsonPath, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    let pkg;
+    try {
+        pkg = JSON.parse(pkgContent);
+    }
+    catch {
+        return [];
+    }
+    const dependencies = {
+        ...(pkg.dependencies ?? {}),
+        ...(pkg.devDependencies ?? {}),
+    };
+    const packs = [];
+    for (const depName of Object.keys(dependencies)) {
+        if (!depName.startsWith(`${LUMIARQ_SCOPE}/`)) {
+            continue;
+        }
+        if (depName === `${LUMIARQ_SCOPE}/lumis`) {
+            continue;
+        }
+        try {
+            // Attempt to resolve a known pack module by name.
+            const module = await import(depName);
+            const manifest = module.LUMIARQ_PACK_MANIFEST ??
+                module.LUMIS_PACK_MANIFEST ??
+                module.packManifest ??
+                module.default?.manifest;
+            const adapter = module.LumiarqAdapter ??
+                module.LumisAdapter ??
+                module.adapter ??
+                module.default?.adapter;
+            if (manifest && adapter) {
+                packs.push({ manifest, adapter });
+            }
+        }
+        catch {
+            // Fallback: if the dependency is a known built-in pack, use that module.
+            const fallbackPack = BUILTIN_PACKS.find((p) => p.manifest.name === depName);
+            if (fallbackPack) {
+                packs.push(fallbackPack);
+            }
+        }
+    }
+    return packs;
+}
+/**
+ * Return built-in packs sorted by detection priority (highest first).
+ *
+ * @returns A new array of built-in pack modules sorted by priority descending.
+ */
+function getPackFrameworks(pack) {
+    return Array.isArray(pack.manifest.frameworks) ? pack.manifest.frameworks : [];
+}
+function getPackPrimaryFramework(pack) {
+    return getPackFrameworks(pack)[0] ?? '';
+}
+export function getBuiltinPacks() {
+    return [...BUILTIN_PACKS].sort((left, right) => right.manifest.detectionPriority - left.manifest.detectionPriority);
+}
+/**
+ * Convenience helper for callers that still operate on adapters directly.
+ *
+ * @returns Built-in adapters derived from the built-in pack registry.
+ */
+export function getBuiltinAdapters() {
+    return getBuiltinPacks().map((pack) => pack.adapter);
+}
+/**
+ * Discover and return all pack modules available to the current project.
+ * Combines built-in packs with packs declared in package.json dependencies.
+ *
+ * @param projectRoot - Path to the project for which to discover packs.
+ * @returns Array of discovered pack modules.
+ */
+export async function getAvailablePacks(projectRoot) {
+    const discoveredPacks = await discoverPacksForProject(projectRoot);
+    const merged = new Map();
+    for (const pack of getBuiltinPacks()) {
+        const frameworkKey = getPackPrimaryFramework(pack);
+        if (frameworkKey) {
+            merged.set(frameworkKey, pack);
+        }
+    }
+    for (const pack of discoveredPacks) {
+        const frameworkKey = getPackPrimaryFramework(pack);
+        if (frameworkKey && !merged.has(frameworkKey)) {
+            merged.set(frameworkKey, pack);
+        }
+    }
+    return Array.from(merged.values());
+}
+/**
+ * Lookup a built-in pack by either manifest framework id or adapter name.
+ *
+ * @param framework - Framework or adapter name to lookup.
+ * @returns Matching pack or null if no match is found.
+ */
+export function getBuiltinPackByFramework(framework) {
+    return (BUILTIN_PACKS.find((pack) => getPackFrameworks(pack).includes(framework) || pack.adapter.name === framework) ?? null);
+}
+/**
+ * Detect the best matching pack for a project.
+ *
+ * @param projectRoot - Path to the project for which to detect a pack.
+ * @param packs - Optional list of packs to consider for detection. Defaults to built-in packs.
+ * @returns Promise<LumisPackModule | null> - Detected pack or null if no compatible pack is found.
+ *
+ * Selection strategy:
+ * 1) Highest adapter detection confidence wins.
+ * 2) If equal confidence, higher pack detection priority wins.
+ */
+function isLumisCoreCompatible(lumisCoreRange, coreVersion = '1.0.0') {
+    if (!lumisCoreRange || lumisCoreRange === '*') {
+        return true;
+    }
+    if (lumisCoreRange.startsWith('^')) {
+        const major = lumisCoreRange.slice(1).split('.')[0];
+        return coreVersion.startsWith(`${major}.`);
+    }
+    return lumisCoreRange === coreVersion;
+}
+export async function detectBestPack(projectRoot, packs) {
+    const candidates = packs ?? (await getAvailablePacks(projectRoot));
+    let best = null;
+    for (const pack of candidates) {
+        if (!isLumisCoreCompatible(pack.manifest.lumisCore)) {
+            continue;
+        }
+        const detection = await pack.adapter.detect(projectRoot);
+        if (!detection.detected) {
+            continue;
+        }
+        const candidate = {
+            pack,
+            confidence: detection.confidence,
+            priority: pack.manifest.detectionPriority,
+        };
+        if (!best) {
+            best = candidate;
+            continue;
+        }
+        const hasHigherConfidence = candidate.confidence > best.confidence;
+        const hasSameConfidenceHigherPriority = candidate.confidence === best.confidence && candidate.priority > best.priority;
+        if (hasHigherConfidence || hasSameConfidenceHigherPriority) {
+            best = candidate;
+        }
+    }
+    return best?.pack ?? null;
+}
+/**
+ * Adapter-only detection path for backward compatibility.
+ *
+ * @param projectRoot - Path to the project for which to detect an adapter.
+ * @param adapters - Optional list of adapters to consider for detection. Defaults to built-in adapters.
+ * @returns Best matching adapter, or null when no compatible adapter is detected.
+ *
+ * Selection strategy: Highest detection confidence wins.
+ */
+export async function detectBestAdapter(projectRoot, adapters = getBuiltinAdapters()) {
+    let best = null;
+    for (const adapter of adapters) {
+        const detection = await adapter.detect(projectRoot);
+        if (!detection.detected) {
+            continue;
+        }
+        if (!best || detection.confidence > best.confidence) {
+            best = { adapter, confidence: detection.confidence };
+        }
+    }
+    return best?.adapter ?? null;
+}
+/**
+ * Resolve a pack for a project.
+ *
+ * @param projectRoot - Path to the project for which to resolve a pack.
+ * @param options.configuredAdapter - Optional adapter/framework hint from configuration. If provided, we will first attempt to match this to a built-in pack before falling back to detection.
+ * @param options.packs - Optional list of packs to consider for resolution. Defaults to built-in packs.
+ * @returns Resolved pack module, or null when no compatible pack can be resolved.
+ *
+ * Resolution strategy:
+ * If a configured adapter/framework is provided and matches a built-in pack,
+ * it is preferred. Otherwise we fall back to automatic detection.
+ */
+export async function resolvePackForProject(projectRoot, options) {
+    const configuredAdapter = options?.configuredAdapter;
+    const packs = options?.packs ?? (await getAvailablePacks(projectRoot));
+    if (configuredAdapter) {
+        const configuredPack = packs.find((pack) => getPackFrameworks(pack).includes(configuredAdapter) || pack.adapter.name === configuredAdapter);
+        if (configuredPack) {
+            return configuredPack;
+        }
+    }
+    // If package.json declares a pack dependency, honor that preference before detection.
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+            const dependencies = {
+                ...(pkg.dependencies ?? {}),
+                ...(pkg.devDependencies ?? {}),
+            };
+            for (const depName of Object.keys(dependencies)) {
+                const declaredPack = packs.find((pack) => pack.manifest.name === depName);
+                if (declaredPack && isLumisCoreCompatible(declaredPack.manifest.lumisCore)) {
+                    return declaredPack;
+                }
+            }
+        }
+        catch {
+            // ignore parse errors and continue to detection
+        }
+    }
+    return detectBestPack(projectRoot, packs);
+}
+/**
+ * Resolve adapter for a project through pack resolution.
+ *
+ * @param projectRoot - Path to the project for which to resolve an adapter.
+ * @param options.configuredAdapter - Optional adapter/framework hint from configuration. If provided, we will first attempt to match this to a built-in pack before falling back to detection.
+ * @param options.packs - Optional list of packs to consider for resolution. Defaults to built-in packs.
+ * @returns Resolved adapter, or null when no compatible pack/adapter can be resolved.
+ *
+ * Resolution strategy:
+ * If a configured adapter/framework is provided and matches a built-in pack,
+ * it is preferred. Otherwise we fall back to automatic detection.
+ */
+export async function resolveAdapterForProject(projectRoot, options) {
+    const pack = await resolvePackForProject(projectRoot, options);
+    return pack?.adapter ?? null;
+}
+//# sourceMappingURL=adapter-loader.js.map

package/dist/adapter-loader.js.map

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

package/dist/cli.d.ts

@@ -1,3 +1,18 @@
-#!/usr/bin/env node
+type RunCliOptions = {
+    projectRoot?: string;
+    write?: (message: string) => void;
+    writeError?: (message: string) => void;
+    interactiveMode?: 'auto' | 'on' | 'off';
+    stdin?: NodeJS.ReadStream;
+    stdout?: NodeJS.WriteStream;
+};
+/**
+ * Execute the host CLI command flow.
+ *
+ * @param argv - CLI arguments excluding the node/script prefix.
+ * @param options - Optional execution overrides for project root and output writers.
+ * @returns Exit code (0 success, non-zero failure).
+ */
+export declare function runCli(argv: string[], options?: RunCliOptions): Promise<number>;
 export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAuDA,KAAK,aAAa,GAAG;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACjC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAA;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAA;CAC3B,CAAA;AAsED;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmFzF"}