@lyse-labs/lyse 0.1.0-alpha.2

package/dist/commands/init-write-lyse-md.js

@@ -0,0 +1,253 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { transform } from "lightningcss";
+import { normalizeToDtcg } from "../tokens/normalizer.js";
+import { isDtcgToken, isDtcgGroup } from "../tokens/dtcg-model.js";
+const NATIVE_TO_DS = [
+    ["button", "Button"],
+    ["input", "Input"],
+    ["select", "Select"],
+    ["textarea", "Textarea"],
+    ["a", "Link"],
+];
+export function writeLyseMd(inputs) {
+    const path = join(inputs.repoRoot, "LYSE.md");
+    const content = buildLyseMd(inputs);
+    const exists = existsSync(path);
+    const prev = exists ? readFileSync(path, "utf8") : null;
+    if (prev === content)
+        return { path, created: false, updated: false };
+    writeFileSync(path, content);
+    return { path, created: !exists, updated: exists };
+}
+export function buildLyseMd(inputs) {
+    const tokens = buildTokenSummary(inputs.repoRoot, inputs.stack.styling);
+    const lines = [];
+    lines.push("# LYSE.md");
+    lines.push("");
+    lines.push("Machine-readable summary of this repository's design-system surface.");
+    lines.push("Regenerate via `lyse init`. Sections below are deterministic.");
+    lines.push("");
+    lines.push("## Detected stack");
+    lines.push("");
+    lines.push(`- framework: ${inputs.stack.framework}`);
+    lines.push(`- styling: ${inputs.stack.styling}`);
+    lines.push(`- typescript: ${inputs.stack.hasTypeScript}`);
+    lines.push(`- test-runners: ${inputs.stack.testRunners.slice().sort().join(", ")}`);
+    lines.push("");
+    lines.push("## Design tokens (DTCG)");
+    lines.push("");
+    if (tokens.source) {
+        lines.push(`- source: ${tokens.source}`);
+        lines.push(`- total tokens: ${tokens.totalTokens}`);
+        lines.push("");
+        if (tokens.groups.length === 0) {
+            lines.push("_No tokens found in source._");
+            lines.push("");
+        }
+        else {
+            for (const g of tokens.groups) {
+                lines.push(`### ${g.name} (${g.count})`);
+                lines.push("");
+                for (const p of g.paths) {
+                    lines.push(`- ${p}`);
+                }
+                lines.push("");
+            }
+        }
+    }
+    else {
+        lines.push("_No token source detected. Add a `tailwind.config.{js,ts}`, a `@theme` block in CSS, or `tokens.json` (DTCG) at the repo root._");
+        lines.push("");
+    }
+    lines.push("## Component manifest");
+    lines.push("");
+    if (inputs.componentsModule) {
+        lines.push(`- components module: \`${inputs.componentsModule}\``);
+        if (inputs.componentInventory.length === 0) {
+            lines.push("- inventory: (none detected — run `lyse audit` to populate)");
+        }
+        else {
+            lines.push(`- inventory (${inputs.componentInventory.length}):`);
+            const sorted = inputs.componentInventory.slice().sort((a, b) => a.name.localeCompare(b.name));
+            for (const c of sorted) {
+                lines.push(`  - \`${c.name}\` from \`${c.module}\``);
+            }
+        }
+    }
+    else {
+        lines.push("_No `componentsModule` configured in `.lyse.yaml`. Set `designSystem.componentsModule: '@your-org/ui'` to enable the component manifest._");
+    }
+    lines.push("");
+    lines.push("## Approved imports");
+    lines.push("");
+    if (inputs.componentsModule) {
+        lines.push(`Use components from \`${inputs.componentsModule}\` instead of native HTML elements wherever a DS equivalent exists.`);
+    }
+    else {
+        lines.push("_No approved imports configured. Set `designSystem.componentsModule` in `.lyse.yaml`._");
+    }
+    lines.push("");
+    lines.push("## Deny-list (native HTML elements with DS equivalents)");
+    lines.push("");
+    for (const [native, ds] of NATIVE_TO_DS) {
+        lines.push(`- \`<${native}>\` → use \`<${ds}>\``);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+function buildTokenSummary(repoRoot, styling) {
+    const doc = loadDtcgDocument(repoRoot, styling);
+    if (!doc.document)
+        return { source: null, groups: [], totalTokens: 0 };
+    const groups = collectGroups(doc.document);
+    const totalTokens = groups.reduce((s, g) => s + g.count, 0);
+    return { source: doc.source, groups, totalTokens };
+}
+function loadDtcgDocument(repoRoot, styling) {
+    const dtcgPath = findDtcgFile(repoRoot);
+    if (dtcgPath) {
+        try {
+            const raw = JSON.parse(readFileSync(dtcgPath, "utf8"));
+            const norm = normalizeToDtcg({ source: "dtcg", data: raw });
+            return { source: `dtcg (${relative(repoRoot, dtcgPath)})`, document: norm.document };
+        }
+        catch {
+            // fall through
+        }
+    }
+    if (styling === "tailwind-v4") {
+        const decls = extractTailwindV4Decls(repoRoot);
+        if (decls.length > 0) {
+            const norm = normalizeToDtcg({ source: "tailwind-v4", data: decls });
+            return { source: "tailwind-v4", document: norm.document };
+        }
+    }
+    if (styling === "tailwind-v3") {
+        const cfg = loadTailwindV3Config(repoRoot);
+        if (cfg) {
+            const norm = normalizeToDtcg({ source: "tailwind-v3", data: cfg });
+            return { source: "tailwind-v3", document: norm.document };
+        }
+    }
+    return { source: null, document: null };
+}
+function findDtcgFile(repoRoot) {
+    const candidates = ["tokens.json", "design-tokens.json", "tokens/index.json"];
+    for (const c of candidates) {
+        const p = join(repoRoot, c);
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+function loadTailwindV3Config(repoRoot) {
+    const candidates = ["tailwind.config.js", "tailwind.config.cjs", "tailwind.config.mjs", "tailwind.config.ts"];
+    const found = candidates.find((c) => existsSync(join(repoRoot, c)));
+    if (!found)
+        return null;
+    try {
+        const src = readFileSync(join(repoRoot, found), "utf8");
+        const m = src.match(/module\.exports\s*=\s*(\{[\s\S]*\});?\s*$/);
+        if (!m || !m[1])
+            return null;
+        const jsonish = m[1].replace(/(['"])?([a-zA-Z0-9_]+)(['"])?\s*:/g, '"$2":');
+        return JSON.parse(jsonish);
+    }
+    catch {
+        return null;
+    }
+}
+function extractTailwindV4Decls(repoRoot) {
+    const candidates = [
+        "app.css",
+        "globals.css",
+        "src/app.css",
+        "src/globals.css",
+        "src/styles/globals.css",
+        "styles/globals.css",
+        "app/globals.css",
+    ];
+    for (const c of candidates) {
+        const path = join(repoRoot, c);
+        if (!existsSync(path))
+            continue;
+        try {
+            const css = readFileSync(path, "utf8");
+            if (!/@theme\b/.test(css))
+                continue;
+            try {
+                transform({ filename: path, code: Buffer.from(css), errorRecovery: true });
+            }
+            catch {
+                continue;
+            }
+            return parseThemeDecls(css);
+        }
+        catch {
+            // ignore
+        }
+    }
+    return [];
+}
+function parseThemeDecls(css) {
+    const decls = [];
+    const themeRegex = /@theme\b[^{]*\{/g;
+    let match;
+    while ((match = themeRegex.exec(css)) !== null) {
+        const start = match.index + match[0].length;
+        let depth = 1;
+        let i = start;
+        while (i < css.length && depth > 0) {
+            const ch = css[i];
+            if (ch === "{")
+                depth++;
+            else if (ch === "}")
+                depth--;
+            i++;
+        }
+        if (depth !== 0)
+            continue;
+        const body = css.slice(start, i - 1).replace(/\/\*[\s\S]*?\*\//g, "");
+        const declRegex = /(--[^\s:{}]+)\s*:\s*([^;]+?)\s*;/g;
+        let dm;
+        while ((dm = declRegex.exec(body)) !== null) {
+            const prop = dm[1];
+            const value = dm[2];
+            if (prop && value !== undefined)
+                decls.push([prop, value.trim()]);
+        }
+    }
+    return decls;
+}
+function collectGroups(doc) {
+    const out = [];
+    const keys = Object.keys(doc).filter((k) => !k.startsWith("$")).sort();
+    for (const key of keys) {
+        const entry = doc[key];
+        if (!isDtcgGroup(entry))
+            continue;
+        const paths = collectTokenPaths(entry, [key]).sort();
+        out.push({ name: key, count: paths.length, paths });
+    }
+    return out;
+}
+function collectTokenPaths(node, path) {
+    const out = [];
+    for (const k of Object.keys(node).filter((kk) => !kk.startsWith("$")).sort()) {
+        const v = node[k];
+        if (isDtcgToken(v)) {
+            out.push([...path, k].join("."));
+        }
+        else if (isDtcgGroup(v)) {
+            out.push(...collectTokenPaths(v, [...path, k]));
+        }
+    }
+    return out;
+}
+function relative(root, p) {
+    if (p.startsWith(root + "/"))
+        return p.slice(root.length + 1);
+    return p;
+}
+//# sourceMappingURL=init-write-lyse-md.js.map

package/dist/commands/init-write-lyse-md.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,8 @@
+export interface InitOptions {
+    cwd: string;
+    firstRun?: boolean;
+    yes?: boolean;
+    /** Skip Node.js version check (used in tests running on Node < 22). */
+    skipNodeCheck?: boolean;
+}
+export declare function runInit(opt: InitOptions): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,147 @@
+import { writeFile, access } from "node:fs/promises";
+import { join } from "node:path";
+import { runPreFlight, formatDetected } from "../detection/pre-flight.js";
+import { confirm } from "../menu/prompts.js";
+import { auditDirectory } from "./audit-pipeline.js";
+import { runFix } from "./fix.js";
+import { runMcpSetup } from "./mcp-setup.js";
+import { maybePromptForEmail } from "./email-prompt.js";
+import { appendAuditEvent, appendInitStepCompletedEvent } from "../history/ndjson-store.js";
+import { ensureGitignoreEntry } from "../util/gitignore.js";
+import { detectStack } from "./init-detect.js";
+import { writeLyseMd } from "./init-write-lyse-md.js";
+import { writeAgentsMd } from "./init-write-agents-md.js";
+export async function runInit(opt) {
+    console.log("\nWelcome to Lyse.\n");
+    // 1. Pre-flight + detection
+    const detected = await runPreFlight(opt.cwd, opt.skipNodeCheck ? { skipNodeCheck: true } : undefined);
+    console.log(formatDetected(detected));
+    console.log("");
+    await appendInitStepCompletedEvent(opt.cwd, "detection");
+    // 2. Confirm
+    if (!opt.yes) {
+        const ok = await confirm("Proceed with this configuration?", true);
+        if (!ok) {
+            console.log("Aborted.");
+            return;
+        }
+    }
+    // 3. Write .lyse.yaml
+    await writeLyseYaml(opt.cwd, detected);
+    // 4. Update .gitignore
+    await ensureGitignoreEntry(opt.cwd, ".lyse/");
+    // 5. Run first audit (static-only — Layer 4 is a no-op stub in v0.1).
+    console.log("Running first audit...\n");
+    const pipeline = await auditDirectory(opt.cwd, { staticOnly: true });
+    const result = pipeline.result;
+    await appendInitStepCompletedEvent(opt.cwd, "audit");
+    // 6. Append history — map AxisScore[] to the flat structure appendAuditEvent expects
+    const axisScore = (name) => {
+        const found = result.axes.find((a) => a.axis === name);
+        return typeof found?.score === "number" ? found.score : null;
+    };
+    await appendAuditEvent(opt.cwd, {
+        score: typeof result.finalScore === "number" ? result.finalScore : 0,
+        axes: {
+            tokens: axisScore("tokens"),
+            a11y: axisScore("a11y"),
+            components: axisScore("components"),
+            stories: axisScore("stories"),
+        },
+        findings_count: result.findings.length,
+    }, null);
+    console.log(`  Health Score: ${result.finalScore}/100\n`);
+    // 6b. Bootstrap AI-readiness surface: LYSE.md + AGENTS.md.
+    await writeAiReadinessSurface(opt.cwd, pipeline);
+    // 7. Offer auto-fix — findings where the rule has a codemod (no fixable flag on Finding type;
+    // treat all findings as potentially fixable and let runFix decide)
+    const fixableCount = result.findings.length;
+    if (fixableCount > 0) {
+        const doFix = opt.yes || (await confirm(`Apply ${fixableCount} potentially auto-fixable findings (creates a branch)?`, true));
+        if (doFix) {
+            try {
+                // forceOnDirty: true is intentional — init has just written .lyse.yaml + updated
+                // .gitignore + audit wrote .lyse/history.ndjson. All of these are deterministic
+                // setup artifacts, not user code, so they're safe to fix alongside.
+                const fixResult = await runFix({ cwd: opt.cwd, autoApprove: opt.yes ?? false, forceOnDirty: true });
+                const totalFixed = fixResult.ruleResults.reduce((sum, r) => sum + r.count, 0);
+                if (totalFixed > 0) {
+                    console.log(`  ✓ Applied ${totalFixed} fix${totalFixed !== 1 ? "es" : ""} on branch ${fixResult.branch}\n`);
+                }
+                else {
+                    console.log("  ✓ No high-confidence fixes available at this time.\n");
+                }
+                await appendInitStepCompletedEvent(opt.cwd, "fix");
+            }
+            catch (err) {
+                console.log(`  ⚠ Auto-fix skipped: ${err.message}\n`);
+            }
+        }
+    }
+    // 8. Offer MCP setup
+    if (detected.cursor.value || detected.claudeCode.value) {
+        const doMcp = opt.yes || (await confirm("Wire Lyse into your IDE (MCP)?", true));
+        if (doMcp) {
+            try {
+                await runMcpSetup({ cwd: opt.cwd, autoApprove: opt.yes ?? false });
+                await appendInitStepCompletedEvent(opt.cwd, "mcp-setup");
+            }
+            catch (err) {
+                console.log(`  ⚠ MCP setup skipped: ${err.message}\n`);
+            }
+        }
+    }
+    // 9. Optional opt-in email capture for release & security updates. Skippable
+    // via --yes, LYSE_NO_EMAIL_PROMPT=1, non-TTY, or just hitting Enter.
+    await maybePromptForEmail({ yes: opt.yes === true });
+    // 10. Summary
+    console.log("✓ Setup complete. Daily commands:");
+    console.log("    lyse audit       → re-check");
+    console.log("    lyse fix         → apply new auto-fixes\n");
+    console.log("⭐ Star the repo: github.com/lyse-labs/lyse\n");
+}
+async function writeAiReadinessSurface(cwd, pipeline) {
+    const stack = detectStack(cwd);
+    const componentsModule = pipeline.config.designSystem?.componentsModule ?? null;
+    const lyseResult = writeLyseMd({
+        repoRoot: cwd,
+        stack,
+        componentsModule,
+        componentInventory: pipeline.componentInventory,
+    });
+    const agentsResult = writeAgentsMd(cwd);
+    const lyseLabel = lyseResult.created ? "Created" : lyseResult.updated ? "Updated" : "Unchanged";
+    console.log(`  ${lyseLabel} LYSE.md`);
+    if (agentsResult.created)
+        console.log("  Created AGENTS.md (with lyse-managed block)");
+    else if (agentsResult.blockReplaced)
+        console.log("  Updated AGENTS.md (lyse-managed block)");
+    else if (agentsResult.blockAppended)
+        console.log("  Appended lyse-managed block to AGENTS.md");
+    else
+        console.log("  AGENTS.md unchanged");
+    console.log("");
+}
+async function writeLyseYaml(cwd, detected) {
+    const yamlPath = join(cwd, ".lyse.yaml");
+    try {
+        await access(yamlPath);
+        return; // already exists, don't overwrite
+    }
+    catch {
+        // does not exist — proceed to create
+    }
+    const lines = [
+        "# Generated by Lyse 0.1.0 — edit if needed.",
+        "# Schema reference: https://github.com/lyse-labs/lyse/blob/main/docs/configuration.md",
+        "designSystem:",
+    ];
+    if (detected.componentsModule.value) {
+        lines.push(`  componentsModule: ${JSON.stringify(detected.componentsModule.value)}`);
+    }
+    lines.push("excludePaths:");
+    lines.push('  - "**/node_modules/**"');
+    lines.push('  - "**/dist/**"');
+    await writeFile(yamlPath, lines.join("\n") + "\n");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAU1D,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAgB;IAC5C,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;IAEpC,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACtG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,MAAM,4BAA4B,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAEzD,aAAa;IACb,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,kCAAkC,EAAE,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEvC,uBAAuB;IACvB,MAAM,oBAAoB,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAE9C,sEAAsE;IACtE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,MAAM,4BAA4B,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAErD,qFAAqF;IACrF,MAAM,SAAS,GAAG,CAAC,IAAY,EAAiB,EAAE;QAChD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAY,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAClE,OAAO,OAAO,KAAK,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,CAAC,CAAC;IAEF,MAAM,gBAAgB,CACpB,GAAG,CAAC,GAAG,EACP;QACE,KAAK,EAAE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACpE,IAAI,EAAE;YACJ,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC;YAC3B,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC;YACvB,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC;YACnC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC;SAC9B;QACD,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;KACvC,EACD,IAAI,CACL,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,UAAU,QAAQ,CAAC,CAAC;IAE1D,2DAA2D;IAC3D,MAAM,uBAAuB,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAEjD,8FAA8F;IAC9F,mEAAmE;IACnE,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IAC5C,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,KAAK,GACT,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,OAAO,CAAC,SAAS,YAAY,wDAAwD,EAAE,IAAI,CAAC,CAAC,CAAC;QAClH,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC;gBACH,iFAAiF;gBACjF,gFAAgF;gBAChF,oEAAoE;gBACpE,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,GAAG,IAAI,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpG,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC9E,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;oBACnB,OAAO,CAAC,GAAG,CAAC,eAAe,UAAU,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;gBAC9G,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;gBACxE,CAAC;gBACD,MAAM,4BAA4B,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACrD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,yBAA0B,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACvD,MAAM,KAAK,GACT,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,OAAO,CAAC,gCAAgC,EAAE,IAAI,CAAC,CAAC,CAAC;QACrE,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;gBACnE,MAAM,4BAA4B,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;YAC3D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,0BAA2B,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,qEAAqE;IACrE,MAAM,mBAAmB,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC;IAErD,cAAc;IACd,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,uBAAuB,CACpC,GAAW,EACX,QAA8K;IAE9K,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,IAAI,IAAI,CAAC;IAChF,MAAM,UAAU,GAAG,WAAW,CAAC;QAC7B,QAAQ,EAAE,GAAG;QACb,KAAK;QACL,gBAAgB;QAChB,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;KAChD,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAExC,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;IAChG,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,UAAU,CAAC,CAAC;IACtC,IAAI,YAAY,CAAC,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;SAClF,IAAI,YAAY,CAAC,aAAa;QAAE,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;SACxF,IAAI,YAAY,CAAC,aAAa;QAAE,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;;QAC1F,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,GAAW,EACX,QAAkD;IAElD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,CAAC,kCAAkC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;IAED,MAAM,KAAK,GAAa;QACtB,6CAA6C;QAC7C,uFAAuF;QACvF,eAAe;KAChB,CAAC;IACF,IAAI,QAAQ,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,MAAM,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/commands/mcp-entry.d.ts

@@ -0,0 +1,33 @@
+export interface McpEntry {
+    command: string;
+    args: string[];
+}
+/**
+ * Options for resolving the MCP entry.
+ *
+ * - `argv1` undefined (or omitted) → falls back to `process.argv[1]`.
+ *   This is the documented default.
+ * - `argv1: ""` → treated as "no argv1 available" → forces dev mode.
+ *   Useful in tests and unusual runtime contexts (e.g. embedded).
+ * - `argv1: "/abs/path"` → used as-is (subject to realpath).
+ * - `dev: true` → forces dev mode regardless of argv1. Escape hatch
+ *   for fork checkouts that happen to live under a `node_modules/`
+ *   ancestor (rare).
+ */
+export interface ResolveOptions {
+    argv1?: string;
+    dev?: boolean;
+}
+export type InstallMode = "npm" | "dev";
+/**
+ * Detects whether the running Lyse process was launched from an npm
+ * install (under a `node_modules/` ancestor after realpath resolution)
+ * or from a local dev build.
+ *
+ * @returns `"npm"` if the resolved argv1 contains a `/node_modules/`
+ *   path segment; otherwise `"dev"`. Forced to `"dev"` if `opts.dev`
+ *   is `true` or argv1 is missing/empty. See ResolveOptions for input
+ *   semantics.
+ */
+export declare function detectInstallMode(opts?: ResolveOptions): InstallMode;
+export declare function resolveLyseMcpEntry(opts?: ResolveOptions): McpEntry;

package/dist/commands/mcp-entry.js

@@ -0,0 +1,47 @@
+import { realpathSync } from "node:fs";
+import { sep } from "node:path";
+function tryRealpath(p) {
+    if (!p)
+        return p;
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return p;
+    }
+}
+function resolve(opts) {
+    const argv1 = opts.argv1 ?? process.argv[1] ?? "";
+    if (opts.dev === true) {
+        return { mode: "dev", resolved: tryRealpath(argv1) };
+    }
+    if (!argv1) {
+        return { mode: "dev", resolved: "" };
+    }
+    const resolved = tryRealpath(argv1);
+    const mode = resolved.includes(`${sep}node_modules${sep}`)
+        ? "npm"
+        : "dev";
+    return { mode, resolved };
+}
+/**
+ * Detects whether the running Lyse process was launched from an npm
+ * install (under a `node_modules/` ancestor after realpath resolution)
+ * or from a local dev build.
+ *
+ * @returns `"npm"` if the resolved argv1 contains a `/node_modules/`
+ *   path segment; otherwise `"dev"`. Forced to `"dev"` if `opts.dev`
+ *   is `true` or argv1 is missing/empty. See ResolveOptions for input
+ *   semantics.
+ */
+export function detectInstallMode(opts = {}) {
+    return resolve(opts).mode;
+}
+export function resolveLyseMcpEntry(opts = {}) {
+    const { mode, resolved } = resolve(opts);
+    if (mode === "npm") {
+        return { command: "npx", args: ["-y", "@lyse-labs/lyse", "mcp"] };
+    }
+    return { command: "node", args: [resolved, "mcp"] };
+}
+//# sourceMappingURL=mcp-entry.js.map

package/dist/commands/mcp-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-entry.js","sourceRoot":"","sources":["../../src/commands/mcp-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AA+BhC,SAAS,WAAW,CAAC,CAAS;IAC5B,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,IAAoB;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAgB,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,eAAe,GAAG,EAAE,CAAC;QACrE,CAAC,CAAC,KAAK;QACP,CAAC,CAAC,KAAK,CAAC;IACV,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAuB,EAAE;IACzD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAuB,EAAE;IAC3D,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;AACtD,CAAC"}

package/dist/commands/mcp-setup.d.ts

@@ -0,0 +1,10 @@
+export interface McpSetupOptions {
+    cwd: string;
+    target?: "cursor" | "claude-code" | "both";
+    autoApprove?: boolean;
+    /** Force absolute-path entry instead of `npx -y lyse mcp`. Auto-detected by default. */
+    dev?: boolean;
+    /** Override `process.argv[1]` (test seam — see mcp-entry.ts). */
+    argv1?: string;
+}
+export declare function runMcpSetup(opt: McpSetupOptions): Promise<void>;

package/dist/commands/mcp-setup.js

@@ -0,0 +1,74 @@
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { detectFromFilesystem } from "../detection/from-filesystem.js";
+import { choice } from "../menu/prompts.js";
+import { appendMcpSetupCompletedEvent } from "../history/ndjson-store.js";
+import { resolveLyseMcpEntry, detectInstallMode } from "./mcp-entry.js";
+export async function runMcpSetup(opt) {
+    const fs = await detectFromFilesystem(opt.cwd);
+    const hasCursor = fs.cursor.value;
+    const hasClaude = fs.claudeCode.value;
+    if (!hasCursor && !hasClaude) {
+        throw new Error("No IDE detected (.cursor/ or .mcp.json). Configure manually — see docs/mcp-server.md.");
+    }
+    let target = opt.target;
+    if (!target) {
+        if (hasCursor && hasClaude) {
+            target = await choice("Install in:", [
+                { title: "Cursor only", value: "cursor" },
+                { title: "Claude Code only", value: "claude-code" },
+                { title: "Both", value: "both" },
+            ], "both");
+        }
+        else {
+            target = hasCursor ? "cursor" : "claude-code";
+        }
+    }
+    const detectOpts = {};
+    if (opt.argv1 !== undefined)
+        detectOpts.argv1 = opt.argv1;
+    if (opt.dev !== undefined)
+        detectOpts.dev = opt.dev;
+    const entry = resolveLyseMcpEntry(detectOpts);
+    const isDev = detectInstallMode(detectOpts) === "dev";
+    let anyWrite = false;
+    if (target === "cursor" || target === "both") {
+        const { wrote } = await addEntry(join(opt.cwd, ".cursor/mcp.json"), entry);
+        anyWrite ||= wrote;
+        console.log("✓ Added Lyse to .cursor/mcp.json");
+    }
+    if (target === "claude-code" || target === "both") {
+        const { wrote } = await addEntry(join(opt.cwd, ".mcp.json"), entry);
+        anyWrite ||= wrote;
+        console.log("✓ Added Lyse to .mcp.json");
+    }
+    if (isDev && anyWrite) {
+        console.log("ℹ Dev mode detected — wrote absolute Node path to MCP config.");
+    }
+    console.log("\nRestart your IDE to activate.\n");
+    // Emit telemetry event (opt-in only)
+    await appendMcpSetupCompletedEvent(opt.cwd, target);
+}
+async function addEntry(path, entry) {
+    let cfg = { mcpServers: {} };
+    try {
+        const raw = await readFile(path, "utf8");
+        cfg = JSON.parse(raw);
+        cfg.mcpServers ??= {};
+    }
+    catch (err) {
+        const e = err;
+        if (e.code !== "ENOENT") {
+            throw new Error(`Cannot parse ${path}. Fix the JSON syntax first, then re-run.`);
+        }
+    }
+    if (cfg.mcpServers.lyse) {
+        console.log(`  (Lyse already configured in ${path})`);
+        return { wrote: false };
+    }
+    cfg.mcpServers.lyse = entry;
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, JSON.stringify(cfg, null, 2) + "\n");
+    return { wrote: true };
+}
+//# sourceMappingURL=mcp-setup.js.map

package/dist/commands/mcp-setup.js.map

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

package/dist/commands/share.d.ts

@@ -0,0 +1,4 @@
+export interface ShareOptions {
+    quiet?: boolean;
+}
+export declare function runShare(cwd: string, opts?: ShareOptions): Promise<void>;