@opensip-cli/core 0.1.0

package/dist/lib/__tests__/logger.test.js

@@ -0,0 +1,284 @@
+import { existsSync, mkdtempSync, readFileSync, readdirSync, rmSync, utimesSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { LoggerImpl, logger, configureLogger } from '../../lib/logger.js';
+describe('logger', () => {
+    const stderrCalls = [];
+    beforeEach(() => {
+        stderrCalls.length = 0;
+        // Reset the singleton to defaults before each test. T1 Item C
+        // collapsed the four prior free mutators into `configureLogger`.
+        configureLogger({ silent: false, debugMode: false, runId: '' });
+        vi.spyOn(process.stderr, 'write').mockImplementation((chunk) => {
+            stderrCalls.push(String(chunk));
+            return true;
+        });
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    describe('level filtering', () => {
+        it('at default level (warn), debug and info do not output', () => {
+            // Construct a fresh logger at warn level + debug-mode for stderr
+            // output. Phase 6 Task 6.5 removed setLogLevel, so adjusting the
+            // singleton's level by helper isn't possible; tests that need a
+            // non-default level construct their own logger.
+            const fresh = new LoggerImpl({ level: 'warn' });
+            fresh.setDebugMode(true);
+            // After setDebugMode the level becomes 'debug' — we re-enter the
+            // original test contract (warn-only output despite debug mode) by
+            // constructing a fresh warn-level logger and verifying its filter:
+            const warnOnly = new LoggerImpl({ level: 'warn' });
+            // Force stderr output via debugMode without changing the level —
+            // achievable by directly setting the underlying field via the
+            // public API: enable silent=false (default) + warn-level.
+            // We just call info and expect no stderr-write at warn level.
+            warnOnly.debug('d');
+            warnOnly.info('i');
+            const calls = stderrCalls;
+            const debugCalls = calls.filter((c) => c.includes('"level":"debug"'));
+            const infoCalls = calls.filter((c) => c.includes('"level":"info"'));
+            expect(debugCalls).toHaveLength(0);
+            expect(infoCalls).toHaveLength(0);
+            // Reference `fresh` so it's not an unused declaration.
+            expect(fresh).toBeInstanceOf(LoggerImpl);
+        });
+        it('at debug level with debug mode, all levels output to stderr', () => {
+            configureLogger({ debugMode: true }); // sets level to debug and enables stderr
+            logger.debug('d');
+            logger.info('i');
+            logger.warn('w');
+            logger.error('e');
+            const calls = stderrCalls;
+            expect(calls.some((c) => c.includes('"level":"debug"'))).toBe(true);
+            expect(calls.some((c) => c.includes('"level":"info"'))).toBe(true);
+            expect(calls.some((c) => c.includes('"level":"warn"'))).toBe(true);
+            expect(calls.some((c) => c.includes('"level":"error"'))).toBe(true);
+        });
+    });
+    describe('silent mode', () => {
+        it('suppresses stderr output when silent is true (even in debug mode)', () => {
+            configureLogger({ debugMode: true, silent: true });
+            logger.debug('d');
+            logger.info('i');
+            logger.warn('w');
+            logger.error('e');
+            expect(stderrCalls).toHaveLength(0);
+        });
+        it('resumes stderr output when silent is turned off', () => {
+            configureLogger({ debugMode: true, silent: true });
+            logger.debug('silent');
+            configureLogger({ silent: false });
+            logger.debug('audible');
+            const calls = stderrCalls;
+            expect(calls.some((c) => c.includes('"msg":"audible"'))).toBe(true);
+            expect(calls.some((c) => c.includes('"msg":"silent"'))).toBe(false);
+        });
+    });
+    describe('structured output', () => {
+        it('outputs JSON with ts, level, and msg fields', () => {
+            configureLogger({ debugMode: true });
+            logger.debug('hello world');
+            expect(stderrCalls.length).toBeGreaterThan(0);
+            const output = stderrCalls[0];
+            const entry = JSON.parse(output.trim());
+            expect(entry.ts).toBeDefined();
+            expect(entry.level).toBe('debug');
+            expect(entry.msg).toBe('hello world');
+        });
+        it('includes runId when set', () => {
+            configureLogger({ debugMode: true, runId: 'RUN_test123' });
+            logger.debug('test');
+            const output = stderrCalls[0];
+            const entry = JSON.parse(output.trim());
+            expect(entry.runId).toBe('RUN_test123');
+        });
+        it('spreads structured object fields into the entry', () => {
+            configureLogger({ debugMode: true });
+            logger.debug({ evt: 'cli.start', msg: 'starting', cwd: '/tmp' });
+            const output = stderrCalls[0];
+            const entry = JSON.parse(output.trim());
+            expect(entry.evt).toBe('cli.start');
+            expect(entry.msg).toBe('starting');
+            expect(entry.cwd).toBe('/tmp');
+        });
+        it('merges data parameter into the entry', () => {
+            configureLogger({ debugMode: true });
+            logger.debug('test', { extra: 42 });
+            const output = stderrCalls[0];
+            const entry = JSON.parse(output.trim());
+            expect(entry.msg).toBe('test');
+            expect(entry.extra).toBe(42);
+        });
+    });
+    describe('debug mode', () => {
+        it('does not output to stderr when debug mode is off', () => {
+            // A fresh debug-level logger with debugMode off — still no
+            // stderr output (the gating is debugMode, not just level).
+            const debugLogger = new LoggerImpl({ level: 'debug' });
+            debugLogger.debug('invisible');
+            expect(stderrCalls).toHaveLength(0);
+        });
+        it('outputs to stderr when debug mode is on', () => {
+            configureLogger({ debugMode: true });
+            logger.debug('visible');
+            expect(stderrCalls.length).toBeGreaterThan(0);
+        });
+    });
+    describe('runId', () => {
+        it('configureLogger({ runId }) stamps the value on entries when no scope is bound', () => {
+            configureLogger({ debugMode: true, runId: 'RUN_xyz' });
+            logger.info({ evt: 'runid.check' });
+            const matched = stderrCalls
+                .map((c) => JSON.parse(c.trim()))
+                .find((e) => e.evt === 'runid.check');
+            expect(matched?.runId).toBe('RUN_xyz');
+        });
+    });
+    describe('initLogFile', () => {
+        let tempDir;
+        beforeEach(() => {
+            tempDir = mkdtempSync(join(tmpdir(), 'opensip-logger-'));
+        });
+        afterEach(() => {
+            rmSync(tempDir, { recursive: true, force: true });
+        });
+        it('creates the log dir and writes info+ entries to a dated JSONL file', () => {
+            configureLogger({ logDir: tempDir });
+            logger.info('hello');
+            const today = new Date().toISOString().slice(0, 10);
+            const expectedPath = join(tempDir, `${today}.jsonl`);
+            expect(existsSync(expectedPath)).toBe(true);
+            const content = readFileSync(expectedPath, 'utf8').trim().split('\n');
+            const entry = JSON.parse(content.at(-1) ?? '{}');
+            expect(entry.msg).toBe('hello');
+            expect(entry.level).toBe('info');
+        });
+        it('does NOT write debug entries when debug mode is off', () => {
+            configureLogger({ logDir: tempDir });
+            // setLogLevel('warn') is the default; debug mode off
+            logger.debug('debug-msg');
+            const today = new Date().toISOString().slice(0, 10);
+            const path = join(tempDir, `${today}.jsonl`);
+            // Either no file, or file has no debug entries
+            if (!existsSync(path))
+                return;
+            const content = readFileSync(path, 'utf8');
+            expect(content).not.toContain('debug-msg');
+        });
+        it('writes debug entries to file when debug mode is on', () => {
+            configureLogger({ logDir: tempDir, debugMode: true });
+            logger.debug('debug-msg');
+            const today = new Date().toISOString().slice(0, 10);
+            const path = join(tempDir, `${today}.jsonl`);
+            expect(readFileSync(path, 'utf8')).toContain('debug-msg');
+        });
+        it('writes still happen in silent mode (silent suppresses stderr only)', () => {
+            configureLogger({ logDir: tempDir, silent: true });
+            logger.warn('still-logged');
+            const today = new Date().toISOString().slice(0, 10);
+            const path = join(tempDir, `${today}.jsonl`);
+            expect(readFileSync(path, 'utf8')).toContain('still-logged');
+        });
+        it('prunes JSONL files older than 7 days', () => {
+            const oldFile = join(tempDir, '2020-01-01.jsonl');
+            writeFileSync(oldFile, '{"old":true}\n');
+            // Touch to a clearly-old mtime
+            const ancient = new Date('2020-01-01T00:00:00Z');
+            utimesSync(oldFile, ancient, ancient);
+            configureLogger({ logDir: tempDir });
+            expect(existsSync(oldFile)).toBe(false);
+        });
+        it('does not prune non-JSONL files', () => {
+            const stranger = join(tempDir, 'README.txt');
+            writeFileSync(stranger, 'leave me alone');
+            configureLogger({ logDir: tempDir });
+            expect(existsSync(stranger)).toBe(true);
+        });
+        it('does not crash if the directory cannot be created', () => {
+            // Pass a path under a non-writable parent — best-effort, no throw
+            expect(() => configureLogger({ logDir: '/dev/null/nope' })).not.toThrow();
+        });
+        it('skips files whose date prefix is not parseable', () => {
+            writeFileSync(join(tempDir, 'not-a-date.jsonl'), '{}');
+            // Should not throw, and the file remains
+            expect(() => configureLogger({ logDir: tempDir })).not.toThrow();
+            expect(existsSync(join(tempDir, 'not-a-date.jsonl'))).toBe(true);
+        });
+    });
+    describe('writeToFile error handling', () => {
+        let tempDir;
+        beforeEach(() => {
+            tempDir = mkdtempSync(join(tmpdir(), 'opensip-logger-err-'));
+        });
+        afterEach(() => {
+            rmSync(tempDir, { recursive: true, force: true });
+        });
+        it('does not throw when the log file becomes unwritable mid-run', () => {
+            configureLogger({ logDir: tempDir });
+            logger.info('first');
+            // Remove the directory out from under the logger; subsequent writes
+            // should swallow the error rather than crash the CLI.
+            rmSync(tempDir, { recursive: true, force: true });
+            expect(() => logger.info('second')).not.toThrow();
+        });
+        it('prune skips files it cannot delete', () => {
+            // Create an old file in a read-only parent — exercise the inner catch.
+            // We simulate by passing a directory that doesn't exist after creation.
+            const today = new Date().toISOString().slice(0, 10);
+            const path = join(tempDir, `${today}.jsonl`);
+            writeFileSync(path, '{}');
+            // Ensure readdirSync will succeed but unlink may not — rely on
+            // configureLogger not throwing whatever happens.
+            expect(() => configureLogger({ logDir: tempDir })).not.toThrow();
+            expect(readdirSync(tempDir)).toContain(`${today}.jsonl`);
+        });
+    });
+    describe('LoggerImpl (fresh instance)', () => {
+        let tempDir;
+        beforeEach(() => {
+            tempDir = mkdtempSync(join(tmpdir(), 'opensip-logger-fresh-'));
+        });
+        afterEach(() => {
+            rmSync(tempDir, { recursive: true, force: true });
+        });
+        it('a fresh LoggerImpl has independent state from the singleton', () => {
+            const fresh = new LoggerImpl();
+            // Mutate the fresh instance only.
+            fresh.setDebugMode(true);
+            fresh.setRunId('FRESH_RUN');
+            fresh.initLogFile(tempDir);
+            // The fresh instance round-trips its own runId.
+            expect(fresh.getRunId()).toBe('FRESH_RUN');
+            // The fresh instance writes to the supplied dir; the singleton writes
+            // nowhere because we never called initLogFile() on it in this case.
+            fresh.warn({ msg: 'fresh-only' });
+            const today = new Date().toISOString().slice(0, 10);
+            const filePath = join(tempDir, `${today}.jsonl`);
+            expect(existsSync(filePath)).toBe(true);
+            expect(readFileSync(filePath, 'utf8')).toContain('fresh-only');
+        });
+        it("fresh instances do not see each other's state", () => {
+            const a = new LoggerImpl();
+            const b = new LoggerImpl();
+            a.setRunId('a');
+            b.setRunId('b');
+            expect(a.getRunId()).toBe('a');
+            expect(b.getRunId()).toBe('b');
+        });
+        it('configureLogger still targets the singleton', () => {
+            // Item 2 removed the `getRunId()` free function — the singleton's
+            // runId is now observable only via emitted entries. Verify the
+            // round-trip by stamping a known id and inspecting a log line.
+            configureLogger({ silent: false, debugMode: true, runId: 'SINGLETON' });
+            expect(logger).toBeInstanceOf(LoggerImpl);
+            logger.info({ evt: 'singleton.runid.probe' });
+            const matched = stderrCalls
+                .map((c) => JSON.parse(c.trim()))
+                .find((e) => e.evt === 'singleton.runid.probe');
+            expect(matched?.runId).toBe('SINGLETON');
+        });
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/dist/lib/__tests__/logger.test.js.map

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

package/dist/lib/__tests__/package-version.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=package-version.test.d.ts.map

package/dist/lib/__tests__/package-version.test.d.ts.map

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

package/dist/lib/__tests__/package-version.test.js

@@ -0,0 +1,47 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { readPackageVersion } from '../package-version.js';
+let tmp;
+beforeEach(() => {
+    tmp = mkdtempSync(join(tmpdir(), 'pkgver-'));
+});
+afterEach(() => {
+    rmSync(tmp, { recursive: true, force: true });
+});
+describe('readPackageVersion', () => {
+    it('returns the version field of the nearest package.json', () => {
+        writeFileSync(join(tmp, 'package.json'), JSON.stringify({ version: '1.2.3' }), 'utf8');
+        const fakeMetaUrl = pathToFileURL(join(tmp, 'src', 'whatever.ts')).href;
+        expect(readPackageVersion(fakeMetaUrl)).toBe('1.2.3');
+    });
+    it('walks up directories until it finds a package.json', () => {
+        writeFileSync(join(tmp, 'package.json'), JSON.stringify({ version: '4.5.6' }), 'utf8');
+        const fakeMetaUrl = pathToFileURL(join(tmp, 'a', 'b', 'c', 'mod.ts')).href;
+        expect(readPackageVersion(fakeMetaUrl)).toBe('4.5.6');
+    });
+    it('returns 0.0.0 when no package.json is found anywhere up the tree', () => {
+        // /tmp/<random-empty-dir>/x.ts — definitely no package.json above
+        // until the FS root, where there's also nothing.
+        // (The tmp dir itself has no package.json since we didn't write one.)
+        const fakeMetaUrl = pathToFileURL(join(tmp, 'x.ts')).href;
+        // Result depends on whether any parent dir has a package.json. On
+        // most systems /tmp doesn't, so we expect '0.0.0'. Allow either '0.0.0'
+        // or the actual package found — the function correctness is the same.
+        const result = readPackageVersion(fakeMetaUrl);
+        expect(typeof result).toBe('string');
+    });
+    it('skips a package.json that lacks a version field and keeps walking up', () => {
+        // child dir: package.json with no version
+        // parent dir: package.json with version
+        const childDir = join(tmp, 'child');
+        mkdirSync(childDir, { recursive: true });
+        writeFileSync(join(childDir, 'package.json'), JSON.stringify({ name: 'no-version' }), 'utf8');
+        writeFileSync(join(tmp, 'package.json'), JSON.stringify({ version: '7.8.9' }), 'utf8');
+        const fakeMetaUrl = pathToFileURL(join(childDir, 'src', 'mod.ts')).href;
+        expect(readPackageVersion(fakeMetaUrl)).toBe('7.8.9');
+    });
+});
+//# sourceMappingURL=package-version.test.js.map

package/dist/lib/__tests__/package-version.test.js.map

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

package/dist/lib/__tests__/paths.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Path resolver contract tests.
+ */
+export {};
+//# sourceMappingURL=paths.test.d.ts.map

package/dist/lib/__tests__/paths.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.test.d.ts","sourceRoot":"","sources":["../../../src/lib/__tests__/paths.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/lib/__tests__/paths.test.js

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview Path resolver contract tests.
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { describe, expect, it } from 'vitest';
+import { resolveProjectPaths, resolveUserPaths } from '../paths.js';
+// eslint-disable-next-line sonarjs/publicly-writable-directories -- string-only fixture; resolver is pure (no fs touch)
+const PROJECT = '/tmp/test-project';
+describe('resolveProjectPaths', () => {
+    it('places the config at the project root', () => {
+        const p = resolveProjectPaths(PROJECT);
+        expect(p.configFile).toBe(join(PROJECT, 'opensip-cli.config.yml'));
+    });
+    it('resolves user-source plugin dirs generically via userPluginDir(domain, kind)', () => {
+        const p = resolveProjectPaths(PROJECT);
+        expect(p.userSourceDir).toBe(join(PROJECT, 'opensip-cli'));
+        expect(p.userPluginDir('fit', 'checks')).toBe(join(PROJECT, 'opensip-cli', 'fit', 'checks'));
+        expect(p.userPluginDir('fit', 'recipes')).toBe(join(PROJECT, 'opensip-cli', 'fit', 'recipes'));
+        expect(p.userPluginDir('sim', 'scenarios')).toBe(join(PROJECT, 'opensip-cli', 'sim', 'scenarios'));
+        expect(p.userPluginDir('sim', 'recipes')).toBe(join(PROJECT, 'opensip-cli', 'sim', 'recipes'));
+    });
+    it('places runtime state under opensip-cli/.runtime', () => {
+        const p = resolveProjectPaths(PROJECT);
+        expect(p.runtimeDir).toBe(join(PROJECT, 'opensip-cli', '.runtime'));
+        expect(p.sessionsDir).toBe(join(p.runtimeDir, 'sessions'));
+        expect(p.reportsDir).toBe(join(p.runtimeDir, 'reports'));
+        expect(p.logsDir).toBe(join(p.runtimeDir, 'logs'));
+        expect(p.cacheDir).toBe(join(p.runtimeDir, 'cache'));
+    });
+    it('resolves per-domain plugin install dirs under runtime/plugins', () => {
+        const p = resolveProjectPaths(PROJECT);
+        expect(p.pluginsDir('fit')).toBe(join(p.runtimeDir, 'plugins', 'fit'));
+        expect(p.pluginsDir('sim')).toBe(join(p.runtimeDir, 'plugins', 'sim'));
+    });
+    it('places TRACKED authored Tool sidecars under opensip-cli/tools (beside fit/sim, NOT under .runtime)', () => {
+        const p = resolveProjectPaths(PROJECT);
+        expect(p.authoredToolsDir).toBe(join(PROJECT, 'opensip-cli', 'tools'));
+        // Load-bearing: the authored tools root is the tracked sibling of fit/sim,
+        // never under the gitignored .runtime tree.
+        expect(p.authoredToolsDir.startsWith(p.runtimeDir)).toBe(false);
+    });
+});
+describe('resolveUserPaths', () => {
+    it('places user-level config at ~/.opensip-cli/config.yml', () => {
+        const u = resolveUserPaths();
+        expect(u.userHomeDir).toBe(join(homedir(), '.opensip-cli'));
+        expect(u.configFile).toBe(join(u.userHomeDir, 'config.yml'));
+    });
+    it('places user-global plugins under ~/.opensip-cli/plugins/<domain>', () => {
+        const u = resolveUserPaths();
+        expect(u.pluginsDir('tool')).toBe(join(u.userHomeDir, 'plugins', 'tool'));
+    });
+    it('places global authored Tool sidecars under ~/.opensip-cli/tools (trusted-by-default)', () => {
+        const u = resolveUserPaths();
+        expect(u.authoredToolsDir).toBe(join(u.userHomeDir, 'tools'));
+    });
+});
+//# sourceMappingURL=paths.test.js.map

package/dist/lib/__tests__/paths.test.js.map

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

package/dist/lib/__tests__/payload-version.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=payload-version.test.d.ts.map

package/dist/lib/__tests__/payload-version.test.d.ts.map

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

package/dist/lib/__tests__/payload-version.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect } from 'vitest';
+import { extractPayloadVersion } from '../payload-version.js';
+describe('extractPayloadVersion', () => {
+    it('returns the version when present and numeric > 0', () => {
+        expect(extractPayloadVersion({ __version: 1, foo: 'bar' })).toBe(1);
+        expect(extractPayloadVersion({ __version: 2 })).toBe(2);
+        expect(extractPayloadVersion({ __version: 99, nested: { x: 1 } })).toBe(99);
+    });
+    it('returns undefined for legacy / missing / empty', () => {
+        expect(extractPayloadVersion({})).toBeUndefined();
+        expect(extractPayloadVersion({ foo: 1 })).toBeUndefined();
+        expect(extractPayloadVersion(null)).toBeUndefined();
+        expect(extractPayloadVersion(undefined)).toBeUndefined();
+        expect(extractPayloadVersion('string')).toBeUndefined();
+        expect(extractPayloadVersion(123)).toBeUndefined();
+        expect(extractPayloadVersion([])).toBeUndefined();
+    });
+    it('returns undefined for invalid numeric values (non-positive, non-finite)', () => {
+        expect(extractPayloadVersion({ __version: 0 })).toBeUndefined();
+        expect(extractPayloadVersion({ __version: -1 })).toBeUndefined();
+        expect(extractPayloadVersion({ __version: Number.NaN })).toBeUndefined();
+        expect(extractPayloadVersion({ __version: Infinity })).toBeUndefined();
+        expect(extractPayloadVersion({ __version: '2' })).toBeUndefined();
+        expect(extractPayloadVersion({ __version: true })).toBeUndefined();
+    });
+    it('does not throw on weird inputs', () => {
+        expect(() => extractPayloadVersion(Object.create(null))).not.toThrow();
+        expect(extractPayloadVersion(Object.create(null))).toBeUndefined();
+        const circular = {};
+        circular.self = circular;
+        expect(() => extractPayloadVersion(circular)).not.toThrow();
+        expect(extractPayloadVersion(circular)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=payload-version.test.js.map

package/dist/lib/__tests__/payload-version.test.js.map

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

package/dist/lib/__tests__/phantom-detect.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Unit tests for `detectPhantomRuntimes`.
+ *
+ * The "conservative" filter is the critical assertion: only flag
+ * directories where `opensip-cli/` contains EXCLUSIVELY `.runtime/`.
+ * Any legitimate user content disqualifies the directory — false
+ * positives would lead users to delete real work.
+ */
+export {};
+//# sourceMappingURL=phantom-detect.test.d.ts.map

package/dist/lib/__tests__/phantom-detect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phantom-detect.test.d.ts","sourceRoot":"","sources":["../../../src/lib/__tests__/phantom-detect.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/lib/__tests__/phantom-detect.test.js

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview Unit tests for `detectPhantomRuntimes`.
+ *
+ * The "conservative" filter is the critical assertion: only flag
+ * directories where `opensip-cli/` contains EXCLUSIVELY `.runtime/`.
+ * Any legitimate user content disqualifies the directory — false
+ * positives would lead users to delete real work.
+ */
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { detectPhantomRuntimes } from '../phantom-detect.js';
+let testDir;
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-phantom-detect-'));
+});
+afterEach(() => {
+    rmSync(testDir, { recursive: true, force: true });
+});
+function createPhantomAt(parent) {
+    const phantomDir = join(parent, 'opensip-cli', '.runtime', 'logs');
+    mkdirSync(phantomDir, { recursive: true });
+    writeFileSync(join(phantomDir, 'old.jsonl'), '{}\n', 'utf8');
+    return join(parent, 'opensip-cli');
+}
+describe('detectPhantomRuntimes', () => {
+    it('returns empty when cwd === root (no ancestors to scan)', () => {
+        expect(detectPhantomRuntimes(testDir, testDir)).toEqual([]);
+    });
+    it('returns empty when cwd is not below root', () => {
+        const other = mkdtempSync(join(tmpdir(), 'opensip-phantom-unrelated-'));
+        try {
+            expect(detectPhantomRuntimes(other, testDir)).toEqual([]);
+        }
+        finally {
+            rmSync(other, { recursive: true, force: true });
+        }
+    });
+    it('flags a phantom .runtime/ between cwd and root', () => {
+        const sub = join(testDir, 'sub');
+        mkdirSync(sub);
+        const phantomPath = createPhantomAt(sub);
+        const cwd = join(sub, 'deep');
+        mkdirSync(cwd);
+        const phantoms = detectPhantomRuntimes(cwd, testDir);
+        expect(phantoms).toContain(phantomPath);
+    });
+    it('does NOT flag when opensip-cli/ contains user content (fit/checks)', () => {
+        const sub = join(testDir, 'sub');
+        mkdirSync(join(sub, 'opensip-cli', 'fit', 'checks'), { recursive: true });
+        mkdirSync(join(sub, 'opensip-cli', '.runtime'), { recursive: true });
+        writeFileSync(join(sub, 'opensip-cli', 'fit', 'checks', 'custom.mjs'), '\n', 'utf8');
+        expect(detectPhantomRuntimes(sub, testDir)).toEqual([]);
+    });
+    it('flags when opensip-cli/ has .runtime/ + dotfiles only', () => {
+        const sub = join(testDir, 'sub');
+        mkdirSync(sub);
+        createPhantomAt(sub);
+        writeFileSync(join(sub, 'opensip-cli', '.gitignore'), '.runtime/\n', 'utf8');
+        const phantoms = detectPhantomRuntimes(sub, testDir);
+        expect(phantoms).toHaveLength(1);
+        expect(phantoms[0]).toBe(join(sub, 'opensip-cli'));
+    });
+    it('flags multiple phantoms in a chain', () => {
+        const a = join(testDir, 'a');
+        const b = join(a, 'b');
+        mkdirSync(b, { recursive: true });
+        createPhantomAt(a);
+        createPhantomAt(b);
+        const phantoms = detectPhantomRuntimes(b, testDir);
+        expect(phantoms).toHaveLength(2);
+        expect(phantoms).toContain(join(a, 'opensip-cli'));
+        expect(phantoms).toContain(join(b, 'opensip-cli'));
+    });
+    it('does not infinite-loop when reaching filesystem root unexpectedly', () => {
+        // cwd is below root by string, but the walker is bounded by `stop`.
+        const sub = join(testDir, 'a', 'b');
+        mkdirSync(sub, { recursive: true });
+        const phantoms = detectPhantomRuntimes(sub, testDir);
+        expect(phantoms).toEqual([]);
+    });
+});
+//# sourceMappingURL=phantom-detect.test.js.map

package/dist/lib/__tests__/phantom-detect.test.js.map

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

package/dist/lib/__tests__/project-context.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Unit tests for `resolveProjectContext`.
+ *
+ * Critical isolation note: every fixture uses `mkdtempSync` + `stopAt` so
+ * the walker cannot escape into the real opensip-cli repo's
+ * `opensip-cli.config.yml` (which sits somewhere above the test runner's
+ * cwd). Tests that omit `stopAt` would be machine-dependent and flaky.
+ */
+export {};
+//# sourceMappingURL=project-context.test.d.ts.map

package/dist/lib/__tests__/project-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.test.d.ts","sourceRoot":"","sources":["../../../src/lib/__tests__/project-context.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}