@sentiness/cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yan Lucas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,10 @@
+# @sentiness/cli
+
+The thin global launcher for Sentiness. It reads the project's engine pin and
+`sentiness.lock`, fetches `@sentiness/core` at the pinned version into
+`~/.sentiness/cache` (overridable with `SENTINESS_HOME`), and spawns it with
+`--cache-root`, forwarding every argument and the engine's exit code. It has no
+dependency on `@sentiness/core` — that is what it fetches. Install it once with
+`npm i -g @sentiness/cli`. For local engine development, point
+`SENTINESS_ENGINE_PATH` at a built `@sentiness/core` checkout to bypass the
+fetch.

package/dist/bootstrap.d.ts

@@ -0,0 +1,16 @@
+import type { FileSystem, Logger, ProcessRunner } from '@sentiness/check-sdk';
+export interface LauncherDeps {
+    readonly cwd: string;
+    readonly env: Readonly<Record<string, string>>;
+    readonly fs: FileSystem;
+    readonly process: ProcessRunner;
+    readonly logger: Logger;
+    readonly stdout: {
+        write(text: string): void;
+    };
+    readonly stderr: {
+        write(text: string): void;
+    };
+}
+export declare function run(argv: readonly string[], deps: LauncherDeps): Promise<number>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAChD;AAmED,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCtF"}

package/dist/bootstrap.js

@@ -0,0 +1,79 @@
+import { join } from 'node:path';
+const MARKER = '.sentiness-materialized';
+function cacheRootFrom(env) {
+    return env.SENTINESS_HOME ?? join(env.HOME ?? env.USERPROFILE ?? '.', '.sentiness');
+}
+async function readJson(fs, path) {
+    if (!(await fs.exists(path))) {
+        return undefined;
+    }
+    try {
+        const parsed = JSON.parse(await fs.readFile(path));
+        return typeof parsed === 'object' && parsed !== null
+            ? parsed
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function fetchEngine(deps, slot, version) {
+    await deps.fs.mkdir(slot, { recursive: true });
+    await deps.fs.writeFile(join(slot, 'package.json'), JSON.stringify({ private: true }));
+    const result = await deps.process.execFile('npm', [
+        'install',
+        '--prefix',
+        slot,
+        '--no-save',
+        '--no-audit',
+        '--no-fund',
+        `@sentiness/core@${version}`,
+    ]);
+    if (result.exitCode !== 0) {
+        deps.stderr.write(`Failed to fetch @sentiness/core@${version}: ${result.stderr.trim()}\n`);
+        return 3;
+    }
+    await deps.fs.writeFile(join(slot, MARKER), new Date().toISOString());
+    return 0;
+}
+async function spawnEngine(deps, engineEntry, cacheRoot, argv) {
+    const result = await deps.process.execFile('node', [engineEntry, '--cache-root', cacheRoot, ...argv], {
+        cwd: deps.cwd,
+    });
+    if (result.stdout.length > 0) {
+        deps.stdout.write(result.stdout);
+    }
+    if (result.stderr.length > 0) {
+        deps.stderr.write(result.stderr);
+    }
+    return result.exitCode;
+}
+export async function run(argv, deps) {
+    // Dev bypass: a local engine checkout.
+    const enginePathOverride = deps.env.SENTINESS_ENGINE_PATH;
+    const config = (await readJson(deps.fs, join(deps.cwd, 'sentiness.config.json'))) ??
+        (await readJson(deps.fs, join(deps.cwd, 'sentiness.config.js')));
+    if (!config && !enginePathOverride) {
+        deps.stderr.write('No sentiness.config.json found. Run `sentiness init` first.\n');
+        return 3;
+    }
+    const cacheRoot = cacheRootFrom(deps.env);
+    if (enginePathOverride) {
+        return spawnEngine(deps, join(enginePathOverride, 'dist', 'cli', 'index.js'), cacheRoot, argv);
+    }
+    const lock = await readJson(deps.fs, join(deps.cwd, 'sentiness.lock'));
+    const engineVersion = lock?.engine?.version;
+    if (!engineVersion) {
+        deps.stderr.write('sentiness.lock is missing or has no engine version. Run `sentiness install`.\n');
+        return 3;
+    }
+    const engineSlot = join(cacheRoot, 'cache', 'engine', engineVersion);
+    if (!(await deps.fs.exists(join(engineSlot, MARKER)))) {
+        const fetched = await fetchEngine(deps, engineSlot, engineVersion);
+        if (fetched !== 0) {
+            return fetched;
+        }
+    }
+    return spawnEngine(deps, join(engineSlot, 'node_modules', '@sentiness', 'core', 'dist', 'cli', 'index.js'), cacheRoot, argv);
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/bootstrap.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { writeSync } from 'node:fs';
+import process from 'node:process';
+import { run } from './bootstrap.js';
+import { createLogger } from './logger.js';
+import { createNodeFileSystem } from './node-fs.js';
+import { createProcessRunner } from './node-process.js';
+function envRecord() {
+    const result = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value !== undefined) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+async function main() {
+    const deps = {
+        cwd: process.cwd(),
+        env: envRecord(),
+        fs: createNodeFileSystem(),
+        process: createProcessRunner(),
+        logger: createLogger(),
+        stdout: { write: (text) => writeSync(process.stdout.fd, text) },
+        stderr: { write: (text) => writeSync(process.stderr.fd, text) },
+    };
+    const code = await run(process.argv.slice(2), deps);
+    process.exitCode = code;
+}
+await main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,SAAS,SAAS;IAChB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG;QACX,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,SAAS,EAAE;QAChB,EAAE,EAAE,oBAAoB,EAAE;QAC1B,OAAO,EAAE,mBAAmB,EAAE;QAC9B,MAAM,EAAE,YAAY,EAAE;QACtB,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE;QACvE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE;KACxE,CAAC;IACF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,MAAM,IAAI,EAAE,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,3 @@
+import type { Logger } from '@sentiness/check-sdk';
+export declare function createLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAInD,wBAAgB,YAAY,IAAI,MAAM,CAWrC"}

package/dist/logger.js

@@ -0,0 +1,16 @@
+import { writeSync } from 'node:fs';
+// A minimal stderr Logger. stdout is reserved for the engine's report JSON, so
+// every level goes to fd 2.
+export function createLogger() {
+    const emit = (level, message, fields) => {
+        const suffix = fields && Object.keys(fields).length > 0 ? ` ${JSON.stringify(fields)}` : '';
+        writeSync(2, `[sentiness:${level}] ${message}${suffix}\n`);
+    };
+    return {
+        debug: (message, fields) => emit('debug', message, fields),
+        info: (message, fields) => emit('info', message, fields),
+        warn: (message, fields) => emit('warn', message, fields),
+        error: (message, fields) => emit('error', message, fields),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,+EAA+E;AAC/E,4BAA4B;AAC5B,MAAM,UAAU,YAAY;IAC1B,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,OAAe,EAAE,MAAgC,EAAQ,EAAE;QACtF,MAAM,MAAM,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,SAAS,CAAC,CAAC,EAAE,cAAc,KAAK,KAAK,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC;IAC7D,CAAC,CAAC;IACF,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;QAC1D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QACxD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC;QACxD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/node-fs.d.ts

@@ -0,0 +1,3 @@
+import type { FileSystem } from '@sentiness/check-sdk';
+export declare function createNodeFileSystem(): FileSystem;
+//# sourceMappingURL=node-fs.d.ts.map

package/dist/node-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-fs.d.ts","sourceRoot":"","sources":["../src/node-fs.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKvD,wBAAgB,oBAAoB,IAAI,UAAU,CA+BjD"}

package/dist/node-fs.js

@@ -0,0 +1,38 @@
+import { appendFile, chmod, mkdir, readdir, readFile, realpath, rename, rm, stat, writeFile, } from 'node:fs/promises';
+// A FileSystem over node:fs/promises. The launcher uses only a subset (exists,
+// readFile, writeFile, mkdir), but the full interface is implemented so it can
+// stand in wherever a FileSystem is expected without depending on @sentiness/core.
+export function createNodeFileSystem() {
+    return {
+        readFile: (path) => readFile(path, 'utf8'),
+        writeFile: (path, content) => writeFile(path, content, 'utf8'),
+        appendFile: (path, content) => appendFile(path, content, 'utf8'),
+        rename: (from, to) => rename(from, to),
+        async exists(path) {
+            try {
+                await stat(path);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        async mkdir(path, options) {
+            await mkdir(path, { recursive: options?.recursive ?? false });
+        },
+        rm: (path, options) => rm(path, { recursive: options?.recursive, force: options?.force }),
+        chmod: (path, mode) => chmod(path, mode),
+        readDir: (path) => readdir(path),
+        async stat(path) {
+            const stats = await stat(path);
+            return {
+                isFile: stats.isFile(),
+                isDirectory: stats.isDirectory(),
+                size: stats.size,
+                mtimeMs: stats.mtimeMs,
+            };
+        },
+        realpath: (path) => realpath(path),
+    };
+}
+//# sourceMappingURL=node-fs.js.map

package/dist/node-fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-fs.js","sourceRoot":"","sources":["../src/node-fs.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,EACL,KAAK,EACL,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,EAAE,EACF,IAAI,EACJ,SAAS,GACV,MAAM,kBAAkB,CAAC;AAG1B,+EAA+E;AAC/E,+EAA+E;AAC/E,mFAAmF;AACnF,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAC1C,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;QAC9D,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;QAChE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjB,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO;YACvB,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC;QAChE,CAAC;QACD,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACzF,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;QACxC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,IAAI;YACb,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO;gBACL,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;gBACtB,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;gBAChC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC;QACJ,CAAC;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/node-process.d.ts

@@ -0,0 +1,3 @@
+import type { ProcessRunner } from '@sentiness/check-sdk';
+export declare function createProcessRunner(): ProcessRunner;
+//# sourceMappingURL=node-process.d.ts.map

package/dist/node-process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-process.d.ts","sourceRoot":"","sources":["../src/node-process.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAmC,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAM3F,wBAAgB,mBAAmB,IAAI,aAAa,CAuBnD"}

package/dist/node-process.js

@@ -0,0 +1,30 @@
+import { spawn } from 'node:child_process';
+// A ProcessRunner that streams child stdio straight to the launcher's own stdio
+// with `inherit`. Long-running engine checks must show output live rather than
+// buffering, so stdout/stderr are returned empty and the child writes directly
+// to the terminal. The launcher only inspects the exit code in that case.
+export function createProcessRunner() {
+    return {
+        execFile(command, args, options) {
+            return new Promise((resolve) => {
+                const child = spawn(command, [...args], {
+                    cwd: options?.cwd,
+                    stdio: 'inherit',
+                    signal: options?.signal,
+                });
+                child.on('error', (error) => {
+                    resolve({ stdout: '', stderr: error.message, exitCode: 1 });
+                });
+                child.on('close', (code, signal) => {
+                    resolve({
+                        stdout: '',
+                        stderr: '',
+                        exitCode: code ?? 1,
+                        ...(signal ? { signal } : {}),
+                    });
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=node-process.js.map

package/dist/node-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-process.js","sourceRoot":"","sources":["../src/node-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAG3C,gFAAgF;AAChF,+EAA+E;AAC/E,+EAA+E;AAC/E,0EAA0E;AAC1E,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,OAAyB;YAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;oBACtC,GAAG,EAAE,OAAO,EAAE,GAAG;oBACjB,KAAK,EAAE,SAAS;oBAChB,MAAM,EAAE,OAAO,EAAE,MAAM;iBACxB,CAAC,CAAC;gBACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;oBAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC9D,CAAC,CAAC,CAAC;gBACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;oBACjC,OAAO,CAAC;wBACN,MAAM,EAAE,EAAE;wBACV,MAAM,EAAE,EAAE;wBACV,QAAQ,EAAE,IAAI,IAAI,CAAC;wBACnB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC9B,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@sentiness/cli",
+  "version": "0.2.0",
+  "description": "Thin global launcher for Sentiness: resolves the pinned engine and dispatches.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Arateki/Sentiness.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/Arateki/Sentiness#readme",
+  "bugs": "https://github.com/Arateki/Sentiness/issues",
+  "type": "module",
+  "bin": {
+    "sentiness": "./dist/index.js"
+  },
+  "engines": {
+    "node": ">=20.10"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@sentiness/check-sdk": "0.3.0"
+  },
+  "devDependencies": {
+    "typescript": "latest",
+    "vitest": "latest",
+    "@sentiness/_test-utils": "0.1.2"
+  },
+  "scripts": {
+    "build": "node ../../scripts/clean-dist.mjs && tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config ../../vitest.config.base.ts src"
+  }
+}