@memoarchitect/tools 0.13.2 → 0.15.1

package/packages/tools/lib/toolchain/providers/syside-lowering.js

@@ -0,0 +1,497 @@
+// ─── SysIDE as a stage 1 compiler ────────────────────────────────────────────
+//
+// The lowering half of `toolchain.compiler: syside`
+// (plans/memo-compiler-stages-opensysml.md, milestone 3). SysIDE's Python API
+// loads the project with the libraries its resolution selects and, only when the
+// load is clean, hands over the OMG API JSON with an element index
+// (`python/memo_stage1_syside.py`). Stage 2 builds the MEMO model from that
+// handoff (`stage2/build-from-api.ts`); MEMO's own parser is not involved.
+//
+// The validator half is the existing `syside check` provider, unchanged, so the
+// `validator-exceptions.json` register keeps its meaning. `memo validate` runs
+// SysIDE once: stage 1's diagnostics are the validator's verdict whenever
+// `compileServesValidator` says so.
+//
+// The Python API is licensed: it needs the same Modeler licence `syside check`
+// does, found the same way (AGENTS.md, "The SysIDE licence").
+// ─────────────────────────────────────────────────────────────────────────────
+import { spawn, spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { createInterface } from 'node:readline';
+import { dirname, join, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { modelToDTO } from '../../model/semantic.js';
+import { findSysmlFiles } from '../../model/sysml-files.js';
+import { SYSML_IR_VERSION } from '../../model/sysml-ir.js';
+import { stage2FromHandoff } from '../../stage2/stage2-from-handoff.js';
+import { ApiModel } from '../../stage2/api-model.js';
+import { providerSettings } from '../effective.js';
+import { SYSMLC_IR_VERSION } from '../protocol.js';
+import { SYSIDE_PROVIDER_ID, parseSysideDiagnostics } from './syside.js';
+import { describeSysidePythonSearch, findSysidePython } from './syside-python.js';
+import { discoverProjectSources } from '../../model/native-project.js';
+import { findShipped, readShipped, readShippedIds, shippedLibraryKey, writeShipped, writeShippedIds, } from '../shipped-library.js';
+const SETTINGS_SCHEMA = [
+    {
+        path: `${SYSIDE_PROVIDER_ID}.python`,
+        type: 'string',
+        scope: 'user',
+        advanced: true,
+        description: 'Python interpreter with SysIDE\'s licensed API, for stage 1 export. Found in the usual places when not given: the active virtual environment, the project\'s `.venv`, `~/.venvs/syside`, then `python3` on PATH.',
+    },
+];
+/** The stage 1 export script, shipped beside the compiled library. */
+const EXPORT_SCRIPT = fileURLToPath(new URL('../../../python/memo_stage1_syside.py', import.meta.url));
+/**
+ * The Python the export runs in: the one named (setting, then variable), else
+ * the first in the usual places that can import SysIDE (`syside-python.ts`),
+ * else `python3`, whose failure then names where we looked.
+ */
+function python(config, projectDir = process.cwd()) {
+    return providerSettings(config, SYSIDE_PROVIDER_ID)?.python
+        ?? process.env.MEMO_SYSIDE_PYTHON
+        ?? findSysidePython(projectDir)
+        ?? 'python3';
+}
+/**
+ * The export script in `--serve` mode, kept running for one interpreter: it
+ * holds the libraries loaded between compiles and sends a project document
+ * again only when it changed (plans/memo-incremental-stage1.md). `held` is
+ * what it last sent, and `token` names that, so a document it reports as kept
+ * is the one held.
+ */
+class SysideWorker {
+    interpreter;
+    process;
+    waiting = [];
+    stderr = '';
+    failure;
+    token = null;
+    held = new Map();
+    constructor(interpreter, onExit) {
+        this.interpreter = interpreter;
+        this.process = spawn(interpreter, [EXPORT_SCRIPT, '--serve'], { stdio: ['pipe', 'pipe', 'pipe'] });
+        // A command that compiles once exits without closing the worker, which
+        // ends when its input does: the worker holds the process open only
+        // while a request waits for it.
+        this.hold(false);
+        createInterface({ input: this.process.stdout }).on('line', line => {
+            const next = this.waiting.shift();
+            if (this.waiting.length === 0)
+                this.hold(false);
+            if (!next)
+                return;
+            try {
+                next.resolve(JSON.parse(line));
+            }
+            catch (error) {
+                next.reject(error);
+            }
+        });
+        this.process.stderr.on('data', (chunk) => { this.stderr = (this.stderr + chunk.toString()).slice(-4000); });
+        const fail = (error) => {
+            this.failure = error;
+            onExit();
+            for (const pending of this.waiting.splice(0))
+                pending.reject(error);
+        };
+        this.process.on('error', fail);
+        // A worker that never started fails the request through `error`, not
+        // through a write to its closed input.
+        this.process.stdin.on('error', () => undefined);
+        this.process.on('exit', code => fail(new Error(`exited with ${code}: ${this.stderr.trim().split('\n').slice(-3).join(' ') || 'no output'}`)));
+    }
+    hold(held) {
+        for (const handle of [this.process, this.process.stdin, this.process.stdout, this.process.stderr]) {
+            const counted = handle;
+            if (held)
+                counted.ref?.();
+            else
+                counted.unref?.();
+        }
+    }
+    request(body) {
+        if (this.failure)
+            return Promise.reject(this.failure);
+        return new Promise((resolvePromise, reject) => {
+            this.waiting.push({ resolve: resolvePromise, reject });
+            this.hold(true);
+            this.process.stdin.write(`${JSON.stringify({ ...body, known: this.token })}\n`);
+        });
+    }
+}
+const workers = new Map();
+let requests = Promise.resolve();
+/** One request at a time per process: a worker answers in order, and `held` follows. */
+function serve(work) {
+    const run = requests.then(work, work);
+    requests = run.catch(() => undefined);
+    return run;
+}
+function workerFor(interpreter) {
+    let worker = workers.get(interpreter);
+    if (!worker) {
+        const started = new SysideWorker(interpreter, () => {
+            if (workers.get(interpreter) === started)
+                workers.delete(interpreter);
+        });
+        worker = started;
+        workers.set(interpreter, worker);
+    }
+    return worker;
+}
+/** The libraries' handoffs read so far, by path: each is written once and never changes. */
+const libraryHandoffs = new Map();
+function libraryHandoff(path) {
+    let handoff = libraryHandoffs.get(path);
+    if (!handoff) {
+        handoff = JSON.parse(readFileSync(path, 'utf8'));
+        libraryHandoffs.clear();
+        libraryHandoffs.set(path, handoff);
+    }
+    return handoff;
+}
+/** A project's handoff joined with its libraries' handoff: what stage 2 reads. */
+function joined(handoff) {
+    if (!handoff.library || !handoff.clean)
+        return handoff;
+    const library = libraryHandoff(handoff.library.path);
+    return {
+        ...handoff,
+        documents: [...(library.documents ?? []), ...(handoff.documents ?? [])],
+        index: { ...library.index, ...handoff.index },
+    };
+}
+/**
+ * Stage 1 from the worker: the project's handoff with every document whole
+ * (a kept one from what the worker sent before), and its index.
+ */
+async function servedHandoff(interpreter, projectDir, libraryDirs, libraryKey, libraryOut, files) {
+    return serve(async () => {
+        const worker = workerFor(interpreter);
+        let response;
+        try {
+            // The project's files as MEMO resolved them (its `include` roots may sit
+            // outside the project directory); without them the worker walks the directory.
+            response = await worker.request({ project: projectDir, libraries: libraryDirs, libraryKey, libraryOut, ...(files ? { files } : {}) });
+        }
+        catch (error) {
+            throw new Error(`SysIDE stage 1 could not run with "${interpreter}": ${error.message}. `
+                + `Set toolchain.${SYSIDE_PROVIDER_ID}.python to a Python with SysIDE's API.`);
+        }
+        if (response.error)
+            throw new Error(`SysIDE stage 1 failed: ${response.error}`);
+        if (!response.clean)
+            return { handoff: response, documents: [], sent: new Set() };
+        const documents = [];
+        const sent = new Set();
+        for (const document of response.documents ?? []) {
+            const whole = 'kept' in document ? worker.held.get(document.file) : document;
+            if (!whole)
+                throw new Error(`SysIDE stage 1 kept ${document.file}, which this process does not hold`);
+            if (!('kept' in document)) {
+                worker.held.set(document.file, document);
+                sent.add(document.file);
+            }
+            documents.push(whole);
+        }
+        worker.token = response.token ?? null;
+        return { handoff: withDocuments(response, documents), documents, sent };
+    });
+}
+/** A handoff carrying `documents` whole, their own indexes merged into its index. */
+function withDocuments(handoff, documents) {
+    const index = { ...handoff.index };
+    const whole = documents.map(({ index: own, ...rest }) => {
+        Object.assign(index, own);
+        return rest;
+    });
+    return { ...handoff, documents: whole, index };
+}
+/**
+ * The stage 1 output kept in a cache directory: `syside.json` names the
+ * project's documents, each stored apart (`syside-documents/`) so a compile
+ * rewrites only the documents the worker sent, and the libraries' handoff.
+ */
+const DOCUMENTS_DIR = `${SYSIDE_PROVIDER_ID}-documents`;
+function storedName(file) {
+    return `${createHash('sha256').update(file).digest('hex').slice(0, 24)}.json`;
+}
+function store(cacheDir, served) {
+    const directory = join(cacheDir, DOCUMENTS_DIR);
+    mkdirSync(directory, { recursive: true });
+    const names = new Set();
+    const listed = served.documents.map(document => {
+        const name = storedName(document.file);
+        names.add(name);
+        if (served.sent.has(document.file) || !existsSync(join(directory, name))) {
+            writeFileSync(join(directory, name), JSON.stringify(document));
+        }
+        return { file: document.file, role: document.role, root: document.root, stored: name };
+    });
+    for (const name of readdirSync(directory)) {
+        if (!names.has(name))
+            rmSync(join(directory, name), { force: true });
+    }
+    const { documents: _whole, index: _merged, ...rest } = served.handoff;
+    const standard = Object.fromEntries(Object.entries(served.handoff.index ?? {}).filter(([, entry]) => entry.role === 'standard'));
+    const manifest = { ...rest, documents: listed, index: standard };
+    writeFileSync(join(cacheDir, `${SYSIDE_PROVIDER_ID}.json`), JSON.stringify(manifest));
+}
+/** The stored handoff, its documents read back; undefined when any is missing. */
+function stored(cacheDir) {
+    const manifest = JSON.parse(readFileSync(join(cacheDir, `${SYSIDE_PROVIDER_ID}.json`), 'utf8'));
+    if (manifest.library && !existsSync(manifest.library.path))
+        return undefined;
+    const documents = [];
+    for (const document of manifest.documents ?? []) {
+        if (!('stored' in document)) {
+            documents.push(document);
+            continue;
+        }
+        const path = join(cacheDir, DOCUMENTS_DIR, document.stored);
+        if (!existsSync(path))
+            return undefined;
+        documents.push(JSON.parse(readFileSync(path, 'utf8')));
+    }
+    return withDocuments(manifest, documents);
+}
+/**
+ * Stage 1 through SysIDE, then stage 2. A stage 1 that reports an error yields
+ * no model: stage 2 never runs on a failed stage 1 (plan, Decisions).
+ */
+export async function compileWithSyside(options) {
+    const projectDir = resolve(options.projectDir);
+    const { libraryDirs, projectFiles, registries, filePackages } = options;
+    const interpreter = python(options.config, options.projectDir);
+    const libraryKey = sysideLibraryKey(interpreter, libraryDirs);
+    const files = [...projectFiles].map(file => resolve(projectDir, file));
+    const key = sysideInputKey(interpreter, projectDir, libraryKey, files);
+    const cacheDir = options.cacheDir;
+    const keyFile = cacheDir ? join(cacheDir, `${SYSIDE_PROVIDER_ID}.json.key`) : undefined;
+    let handoff;
+    let reused = false;
+    if (cacheDir && keyFile && !options.force && existsSync(join(cacheDir, `${SYSIDE_PROVIDER_ID}.json`))
+        && existsSync(keyFile) && readFileSync(keyFile, 'utf8') === key) {
+        handoff = stored(cacheDir);
+        reused = Boolean(handoff);
+    }
+    if (!handoff) {
+        const libraryOut = join(cacheDir ?? scratchDir(), `${SYSIDE_PROVIDER_ID}-library-${libraryKey.slice(0, 16)}.json`);
+        installShippedLibrary(interpreter, libraryDirs, libraryOut);
+        const served = await servedHandoff(interpreter, projectDir, libraryDirs, libraryKey, libraryOut, files);
+        handoff = served.handoff;
+        if (cacheDir && keyFile && handoff.clean) {
+            mkdirSync(cacheDir, { recursive: true });
+            // Tool output, never authored content: the directory ignores
+            // itself, so no project has to know to add it to its .gitignore.
+            const ignore = join(cacheDir, '.gitignore');
+            if (!existsSync(ignore))
+                writeFileSync(ignore, '*\n');
+            store(cacheDir, served);
+            writeFileSync(keyFile, key);
+            removeStaleLibraryHandoffs(cacheDir, libraryOut);
+        }
+    }
+    const diagnostics = parseSysideDiagnostics((handoff.diagnostics ?? []).map(d => d.text).join('\n'), handoff.providerVersion);
+    if (!handoff.clean)
+        return { accepted: false, diagnostics, providerVersion: handoff.providerVersion, cached: reused };
+    const api = new ApiModel(joined(handoff));
+    // The ontology is the handoff's, not MEMO's parse of it.
+    const stage2 = stage2FromHandoff(api, {
+        config: options.config, projectDir, projectFiles, resolveProject: options.resolveProject, provenance: options.provenance, registries, filePackages,
+    });
+    return { accepted: true, diagnostics, providerVersion: handoff.providerVersion, ...stage2, api, cached: reused };
+}
+/** The SysIDE a shipped export is keyed by: its version and the export script, per interpreter. */
+const versions = new Map();
+function sysideVersion(interpreter) {
+    let version = versions.get(interpreter);
+    if (version === undefined) {
+        const probe = spawnSync(interpreter, ['-c', 'import syside; print(syside.__version__)'], { encoding: 'utf8' });
+        version = `${probe.status === 0 ? probe.stdout.trim() : 'unknown'}\0${createHash('sha256').update(readFileSync(EXPORT_SCRIPT)).digest('hex')}`;
+        versions.set(interpreter, version);
+    }
+    return version;
+}
+function shippedKey(interpreter, libraryDirs) {
+    const roots = libraryDirs.map(dir => ({ dir, files: sysmlFilesUnder(dir) }));
+    return shippedLibraryKey(SYSIDE_PROVIDER_ID, sysideVersion(interpreter), roots);
+}
+/**
+ * Put the library set's shipped export where the worker looks for its library
+ * handoff, when the package carries one for exactly this set. The worker then
+ * loads the libraries as the environment a project loads over, and skips
+ * exporting them.
+ */
+function installShippedLibrary(interpreter, libraryDirs, libraryOut) {
+    const ids = `${libraryOut}.ids`;
+    if (existsSync(libraryOut) && existsSync(ids))
+        return;
+    const key = shippedKey(interpreter, libraryDirs);
+    const shipped = findShipped(SYSIDE_PROVIDER_ID, key, libraryDirs);
+    const shippedIds = findShipped(SYSIDE_PROVIDER_ID, key, libraryDirs, 'ids.gz');
+    if (!shipped || !shippedIds)
+        return;
+    mkdirSync(dirname(libraryOut), { recursive: true });
+    const partial = `.${process.pid}.partial`;
+    writeFileSync(ids + partial, readShippedIds(shippedIds));
+    writeFileSync(libraryOut + partial, readShipped(shipped, libraryDirs));
+    renameSync(ids + partial, ids);
+    renameSync(libraryOut + partial, libraryOut);
+}
+/**
+ * Export the library set once and write it as the shipped files a package
+ * carries (`memo ship-library`). The worker exports the libraries for an empty
+ * project, so what is written is exactly what a project's compile would keep.
+ */
+export async function shipSysideLibrary(config, libraryDirs, outDir) {
+    const interpreter = python(config);
+    const work = mkdtempSync(join(tmpdir(), 'memo-ship-syside-'));
+    try {
+        const project = join(work, 'project');
+        mkdirSync(project);
+        const libraryOut = join(work, `${SYSIDE_PROVIDER_ID}-library.json`);
+        const served = await servedHandoff(interpreter, project, libraryDirs, sysideLibraryKey(interpreter, libraryDirs), libraryOut);
+        if (!served.handoff.clean) {
+            const text = (served.handoff.diagnostics ?? []).map(d => d.text).join('\n');
+            throw new Error(`SysIDE did not accept the libraries, so there is nothing to ship:\n${text}`);
+        }
+        const key = shippedKey(interpreter, libraryDirs);
+        return [
+            writeShipped(outDir, SYSIDE_PROVIDER_ID, key, readFileSync(libraryOut, 'utf8'), libraryDirs),
+            writeShippedIds(outDir, SYSIDE_PROVIDER_ID, key, readFileSync(`${libraryOut}.ids`, 'utf8')),
+        ];
+    }
+    finally {
+        rmSync(work, { recursive: true, force: true });
+    }
+}
+let scratch;
+/** Where the libraries' handoff goes for a compile with no cache directory: one per process. */
+function scratchDir() {
+    return (scratch ??= mkdtempSync(join(tmpdir(), 'memo-stage1-')));
+}
+/** Libraries' handoffs of earlier library content: only the current one is read. */
+function removeStaleLibraryHandoffs(cacheDir, current) {
+    const prefix = `${SYSIDE_PROVIDER_ID}-library-`;
+    for (const name of readdirSync(cacheDir)) {
+        const path = join(cacheDir, name);
+        if (name.startsWith(prefix) && path !== current && path !== `${current}.ids`)
+            rmSync(path, { force: true });
+    }
+}
+/**
+ * What the libraries' part of a SysIDE stage 1 result depends on: the
+ * interpreter, the export script, and the content of every library file.
+ */
+export function sysideLibraryKey(interpreter, libraryDirs) {
+    const hash = createHash('sha256');
+    hash.update(`${SYSIDE_PROVIDER_ID}\0${interpreter}\0`);
+    hash.update(readFileSync(EXPORT_SCRIPT));
+    const files = libraryDirs.flatMap(sysmlFilesUnder).map(file => resolve(file));
+    for (const file of [...new Set(files)].sort()) {
+        hash.update(`\0${file}\0`);
+        hash.update(readFileSync(file));
+    }
+    return hash.digest('hex');
+}
+/**
+ * Everything a SysIDE stage 1 result depends on: the libraries' key
+ * (`sysideLibraryKey`: the interpreter, the export script and every library
+ * file) and the content of every project file. A result is reused only while
+ * this is unchanged; a SysIDE upgrade in the same interpreter is not seen,
+ * which is what `memo compile --force` is for.
+ */
+export function sysideInputKey(interpreter, projectDir, libraryKey, files) {
+    const hash = createHash('sha256');
+    hash.update(`${SYSIDE_PROVIDER_ID}\0${interpreter}\0${libraryKey}\0`);
+    // The files compiled, an include root outside the directory among them.
+    for (const file of [...new Set((files ?? findSysmlFiles(projectDir)).map(file => resolve(file)))].sort()) {
+        hash.update(`\0${file}\0`);
+        hash.update(readFileSync(file));
+    }
+    return hash.digest('hex');
+}
+function sysmlFilesUnder(dir) {
+    if (!existsSync(dir) || !statSync(dir).isDirectory())
+        return [];
+    return readdirSync(dir, { withFileTypes: true }).flatMap(entry => {
+        const path = join(dir, entry.name);
+        if (entry.isDirectory())
+            return ['node_modules', '.venv', 'site-packages', '.git'].includes(entry.name) ? [] : sysmlFilesUnder(path);
+        return entry.name.endsWith('.sysml') ? [path] : [];
+    });
+}
+export const sysideLoweringDescriptor = {
+    id: SYSIDE_PROVIDER_ID,
+    role: 'lowering',
+    capabilities: ['lower'],
+    settingsSchema: SETTINGS_SCHEMA,
+    compileModel: compileWithSyside,
+    shipLibrary: shipSysideLibrary,
+    // The Python load reports what `syside check --diagnose all` does, in the
+    // same text (`full_message`), so it is the validator's verdict too, unless
+    // a setting only the CLI reads is in effect: a syside.toml or a narrower
+    // diagnose scope.
+    compileServesValidator(config) {
+        const cli = providerSettings(config, SYSIDE_PROVIDER_ID) ?? {};
+        return !cli.configFile && (cli.diagnose ?? 'all') === 'all';
+    },
+    probe(context) {
+        const interpreter = python(context.config, context.projectDir);
+        const check = spawnSync(interpreter, ['-c', 'import syside; print(syside.__version__)'], { encoding: 'utf8' });
+        return check.status === 0
+            ? { available: true, transport: 'process', executable: interpreter, version: check.stdout.trim() }
+            : {
+                available: false, transport: 'process',
+                detail: `No Python that can import syside was found (using "${interpreter}"). `
+                    + `${describeSysidePythonSearch(context.projectDir)} Install it where one of those can see it (pip install syside), `
+                    + `or name the interpreter with MEMO_SYSIDE_PYTHON.`,
+            };
+    },
+    create(context) {
+        return {
+            id: SYSIDE_PROVIDER_ID,
+            role: 'lowering',
+            transport: 'process',
+            invocation: () => ({ command: python(context.config, context.projectDir), args: [EXPORT_SCRIPT], provider: SYSIDE_PROVIDER_ID }),
+            async run() {
+                // Every library root a locator offers, the project resolved from
+                // what was compiled: what each command compiles, so MEMO parses
+                // nothing and `.memo/stage1/` is shared with them.
+                const sources = discoverProjectSources(context.projectDir);
+                const result = await compileWithSyside({
+                    config: context.config,
+                    projectDir: context.projectDir,
+                    libraryDirs: [...new Set(sources.libraryRoots.map(root => root.sysmlDir))],
+                    projectFiles: new Set(sources.projectFiles.map(file => relative(context.projectDir, file))),
+                    resolveProject: true,
+                    cacheDir: join(context.projectDir, '.memo', 'stage1'),
+                });
+                const model = result.model
+                    ? modelToDTO(result.model)
+                    : { elements: {}, relationships: [], errors: [], packages: [] };
+                return {
+                    provider: SYSIDE_PROVIDER_ID,
+                    providerVersion: result.providerVersion,
+                    transport: 'process',
+                    accepted: result.accepted,
+                    diagnostics: result.diagnostics,
+                    registries: result.registries,
+                    ir: {
+                        irVersion: SYSMLC_IR_VERSION,
+                        model,
+                        parseErrors: [],
+                        accepted: result.accepted,
+                        // Stage 2 has no syntax tree to record; the standard JSON is the record.
+                        sysml: { irVersion: SYSML_IR_VERSION, elements: [], diagnostics: [] },
+                    },
+                };
+            },
+        };
+    },
+};
+//# sourceMappingURL=syside-lowering.js.map

package/packages/tools/lib/toolchain/providers/syside-lowering.js.map

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

package/packages/tools/lib/toolchain/providers/syside-python.d.ts

@@ -0,0 +1,9 @@
+/** Where a Python with SysIDE is looked for, in order, for a project. Candidates that do not exist are dropped. */
+export declare function sysidePythonCandidates(projectDir: string, env?: NodeJS.ProcessEnv): string[];
+/** Whether an interpreter can import SysIDE (remembered for the process: it does not change under us). */
+export declare function importsSyside(python: string): boolean;
+/** The first candidate that imports SysIDE, or undefined (the caller then names what was looked at). */
+export declare function findSysidePython(projectDir: string, env?: NodeJS.ProcessEnv): string | undefined;
+/** The places that were looked at, for the error that says none had SysIDE. */
+export declare function describeSysidePythonSearch(projectDir: string, env?: NodeJS.ProcessEnv): string;
+//# sourceMappingURL=syside-python.d.ts.map

package/packages/tools/lib/toolchain/providers/syside-python.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syside-python.d.ts","sourceRoot":"","sources":["../../../src/toolchain/providers/syside-python.ts"],"names":[],"mappings":"AA0BA,mHAAmH;AACnH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,EAAE,CAoBzG;AAID,0GAA0G;AAC1G,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOrD;AAED,wGAAwG;AACxG,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,GAAG,SAAS,CAE7G;AAED,+EAA+E;AAC/E,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAK3G"}

package/packages/tools/lib/toolchain/providers/syside-python.js

@@ -0,0 +1,69 @@
+// ─── Finding the Python that has SysIDE ──────────────────────────────────────
+//
+// A user chooses the compiler; they should not have to say where its tools are.
+// SysIDE's stage 1 export runs in a Python that can `import syside`, and people
+// keep that in a few usual places. This looks there, in order, and takes the first
+// interpreter that really imports it, so nothing needs configuring unless the
+// install is somewhere unusual (`toolchain.syside.python`, or `MEMO_SYSIDE_PYTHON`,
+// still win when given).
+// ─────────────────────────────────────────────────────────────────────────────
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { whichExecutable } from '../process.js';
+const WINDOWS = platform() === 'win32';
+const BIN = WINDOWS ? 'Scripts' : 'bin';
+const PYTHON = WINDOWS ? 'python.exe' : 'python';
+/** Virtual environment directory names people use for a project's own Python. */
+const PROJECT_ENVIRONMENTS = ['.syside-venv', '.venv', 'venv'];
+/** How far above the project to look: a repository's environment often sits beside several projects. */
+const PARENT_LEVELS = 3;
+/** Where a Python with SysIDE is looked for, in order, for a project. Candidates that do not exist are dropped. */
+export function sysidePythonCandidates(projectDir, env = process.env) {
+    const found = [];
+    const add = (path) => { if (path && !found.includes(path))
+        found.push(path); };
+    const inEnvironment = (dir) => join(dir, BIN, PYTHON);
+    // The environment the user is already in.
+    if (env.VIRTUAL_ENV)
+        add(inEnvironment(env.VIRTUAL_ENV));
+    // The project's own, then the repository's above it.
+    let dir = resolve(projectDir);
+    for (let level = 0; level <= PARENT_LEVELS; level++) {
+        for (const name of PROJECT_ENVIRONMENTS)
+            add(inEnvironment(join(dir, name)));
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Where SysIDE's own documentation puts it, then the interpreters on PATH.
+    add(inEnvironment(join(homedir(), '.venvs', 'syside')));
+    add(whichExecutable('python3', env));
+    add(whichExecutable('python', env));
+    return found.filter(candidate => existsSync(candidate));
+}
+const verdicts = new Map();
+/** Whether an interpreter can import SysIDE (remembered for the process: it does not change under us). */
+export function importsSyside(python) {
+    const known = verdicts.get(python);
+    if (known !== undefined)
+        return known;
+    const result = spawnSync(python, ['-c', 'import syside'], { stdio: 'ignore', timeout: 20_000 });
+    const ok = result.status === 0;
+    verdicts.set(python, ok);
+    return ok;
+}
+/** The first candidate that imports SysIDE, or undefined (the caller then names what was looked at). */
+export function findSysidePython(projectDir, env = process.env) {
+    return sysidePythonCandidates(projectDir, env).find(importsSyside);
+}
+/** The places that were looked at, for the error that says none had SysIDE. */
+export function describeSysidePythonSearch(projectDir, env = process.env) {
+    const looked = sysidePythonCandidates(projectDir, env);
+    return looked.length > 0
+        ? `Looked at: ${looked.join(', ')}. None can import syside.`
+        : 'No Python was found in the usual places.';
+}
+//# sourceMappingURL=syside-python.js.map

package/packages/tools/lib/toolchain/providers/syside-python.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"syside-python.js","sourceRoot":"","sources":["../../../src/toolchain/providers/syside-python.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,mFAAmF;AACnF,8EAA8E;AAC9E,oFAAoF;AACpF,yBAAyB;AACzB,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,OAAO,GAAG,QAAQ,EAAE,KAAK,OAAO,CAAC;AACvC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;AAEjD,iFAAiF;AACjF,MAAM,oBAAoB,GAAG,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAE/D,wGAAwG;AACxG,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,mHAAmH;AACnH,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC3F,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,GAAG,GAAG,CAAC,IAAwB,EAAE,EAAE,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACnG,MAAM,aAAa,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAE9D,0CAA0C;IAC1C,IAAI,GAAG,CAAC,WAAW;QAAE,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IACzD,qDAAqD;IACrD,IAAI,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC;QAClD,KAAK,MAAM,IAAI,IAAI,oBAAoB;YAAE,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACjB,CAAC;IACD,2EAA2E;IAC3E,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxD,GAAG,CAAC,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IACrC,GAAG,CAAC,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IACpC,OAAO,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE5C,0GAA0G;AAC1G,MAAM,UAAU,aAAa,CAAC,MAAc;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACtC,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAChG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC;AACd,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,MAAyB,OAAO,CAAC,GAAG;IACrF,OAAO,sBAAsB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACvE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,0BAA0B,CAAC,UAAkB,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC/F,MAAM,MAAM,GAAG,sBAAsB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC;QACpB,CAAC,CAAC,cAAc,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B;QAC5D,CAAC,CAAC,0CAA0C,CAAC;AACrD,CAAC"}

package/packages/tools/lib/toolchain/providers/syside.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syside.d.ts","sourceRoot":"","sources":["../../../src/toolchain/providers/syside.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAER,eAAe,EAEf,cAAc,EAEd,mBAAmB,EACtB,MAAM,gBAAgB,CAAC;AAGxB,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC7B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;CACtD;AAoCD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAgB9E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIlF;AA0CD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CA+BrF;AAED,eAAO,MAAM,yBAAyB,EAAE,mBA2DvC,CAAC"}
+{"version":3,"file":"syside.d.ts","sourceRoot":"","sources":["../../../src/toolchain/providers/syside.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAER,eAAe,EAEf,cAAc,EAEd,mBAAmB,EACtB,MAAM,gBAAgB,CAAC;AAGxB,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C,MAAM,WAAW,gBAAgB;IAC7B,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uEAAuE;IACvE,QAAQ,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;CACtD;AAsCD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAgB9E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAIlF;AA0CD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CA+BrF;AAED,eAAO,MAAM,yBAAyB,EAAE,mBA2DvC,CAAC"}

package/packages/tools/lib/toolchain/providers/syside.js

@@ -19,6 +19,8 @@ const SETTINGS_SCHEMA = [
     {
         path: `${SYSIDE_PROVIDER_ID}.executable`,
         type: 'string',
+        scope: 'user',
+        advanced: true,
         description: `Executable name or path. Defaults to \`${SYSIDE_PROVIDER_ID}\` on PATH.`,
     },
     {