@opensip-cli/core 0.1.0

package/dist/plugins/__tests__/scope-validation.test.js

@@ -0,0 +1,68 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { logger } from '../../lib/logger.js';
+import { VALID_NPM_SCOPE_REGEX, resolveScopes } from '../scope-validation.js';
+describe('VALID_NPM_SCOPE_REGEX', () => {
+    it('accepts well-formed npm scopes', () => {
+        expect(VALID_NPM_SCOPE_REGEX.test('@opensip-cli')).toBe(true);
+        expect(VALID_NPM_SCOPE_REGEX.test('@foo')).toBe(true);
+        expect(VALID_NPM_SCOPE_REGEX.test('@foo-bar')).toBe(true);
+        expect(VALID_NPM_SCOPE_REGEX.test('@foo.bar')).toBe(true);
+        expect(VALID_NPM_SCOPE_REGEX.test('@foo_bar')).toBe(true);
+        expect(VALID_NPM_SCOPE_REGEX.test('@0abc')).toBe(true);
+    });
+    it('rejects malformed scopes', () => {
+        expect(VALID_NPM_SCOPE_REGEX.test('foo')).toBe(false); // missing @
+        expect(VALID_NPM_SCOPE_REGEX.test('@')).toBe(false); // empty body
+        expect(VALID_NPM_SCOPE_REGEX.test('@Foo')).toBe(false); // uppercase
+        expect(VALID_NPM_SCOPE_REGEX.test('@foo/bar')).toBe(false); // slash
+        expect(VALID_NPM_SCOPE_REGEX.test('@..')).toBe(false); // path traversal-ish
+        expect(VALID_NPM_SCOPE_REGEX.test('@-foo')).toBe(false); // leading dash
+        expect(VALID_NPM_SCOPE_REGEX.test('')).toBe(false);
+    });
+});
+describe('resolveScopes', () => {
+    let warnSpy;
+    beforeEach(() => {
+        warnSpy = vi.spyOn(logger, 'warn').mockImplementation(() => undefined);
+    });
+    afterEach(() => {
+        warnSpy.mockRestore();
+    });
+    it('always includes the default scope first', () => {
+        const out = resolveScopes('@opensip-cli', [], 'plugin.invalid_scope');
+        expect(out).toEqual(['@opensip-cli']);
+    });
+    it('appends valid extra scopes after the default', () => {
+        const out = resolveScopes('@opensip-cli', ['@other', '@third'], 'plugin.invalid_scope');
+        expect(out).toEqual(['@opensip-cli', '@other', '@third']);
+    });
+    it('deduplicates extra scopes that match the default', () => {
+        const out = resolveScopes('@opensip-cli', ['@opensip-cli', '@other'], 'plugin.invalid_scope');
+        expect(out).toEqual(['@opensip-cli', '@other']);
+    });
+    it('deduplicates duplicate extra scopes', () => {
+        const out = resolveScopes('@opensip-cli', ['@other', '@other', '@third'], 'plugin.invalid_scope');
+        expect(out).toEqual(['@opensip-cli', '@other', '@third']);
+    });
+    it('drops invalid scopes with a structured warning', () => {
+        const out = resolveScopes('@opensip-cli', ['@valid', 'no-at-sign', '@Bad'], 'plugin.invalid_scope');
+        expect(out).toEqual(['@opensip-cli', '@valid']);
+        expect(warnSpy).toHaveBeenCalledTimes(2);
+        expect(warnSpy.mock.calls[0]?.[0]).toMatchObject({
+            evt: 'plugin.invalid_scope',
+            module: 'core:plugins',
+            scope: 'no-at-sign',
+        });
+        expect(warnSpy.mock.calls[1]?.[0]).toMatchObject({
+            evt: 'plugin.invalid_scope',
+            scope: '@Bad',
+        });
+    });
+    it('uses the supplied event name in warnings', () => {
+        resolveScopes('@opensip-cli', ['bad'], 'plugin.scenario_package.invalid_scope');
+        expect(warnSpy.mock.calls[0]?.[0]).toMatchObject({
+            evt: 'plugin.scenario_package.invalid_scope',
+        });
+    });
+});
+//# sourceMappingURL=scope-validation.test.js.map

package/dist/plugins/__tests__/scope-validation.test.js.map

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

package/dist/plugins/__tests__/single-core-guard.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * single-core-guard — the discovery-time policy that drops capability packs which
+ * resolve a DIFFERENT physical `@opensip-cli/core` than the running engine.
+ *
+ * `selfCore()` is the canonical core this runtime resolves; `foreignCorePath`
+ * probes a pack's resolved core; `filterSameCorePackages` keeps only same-core
+ * (or core-less) packs and reports each foreign drop via `onForeign`.
+ */
+export {};
+//# sourceMappingURL=single-core-guard.test.d.ts.map

package/dist/plugins/__tests__/single-core-guard.test.d.ts.map

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

package/dist/plugins/__tests__/single-core-guard.test.js

@@ -0,0 +1,89 @@
+/**
+ * single-core-guard — the discovery-time policy that drops capability packs which
+ * resolve a DIFFERENT physical `@opensip-cli/core` than the running engine.
+ *
+ * `selfCore()` is the canonical core this runtime resolves; `foreignCorePath`
+ * probes a pack's resolved core; `filterSameCorePackages` keeps only same-core
+ * (or core-less) packs and reports each foreign drop via `onForeign`.
+ */
+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 { filterSameCorePackages, foreignCorePath, selfCore } from '../single-core-guard.js';
+let testDir;
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-single-core-'));
+});
+afterEach(() => {
+    rmSync(testDir, { recursive: true, force: true });
+});
+/**
+ * Plant a self-contained `@opensip-cli/core` under `<dir>/node_modules` so a
+ * pack rooted at `dir` resolves THAT physical copy — a "foreign" core distinct
+ * from the test runner's own resolved core.
+ */
+function plantForeignCore(dir) {
+    const coreDir = join(dir, 'node_modules', '@opensip-cli', 'core');
+    mkdirSync(coreDir, { recursive: true });
+    writeFileSync(join(coreDir, 'package.json'), JSON.stringify({ name: '@opensip-cli/core', version: '0.0.0-foreign', main: 'index.js' }));
+    writeFileSync(join(coreDir, 'index.js'), 'module.exports = {};');
+}
+describe('selfCore', () => {
+    it('resolves a concrete path to the running @opensip-cli/core', () => {
+        const self = selfCore();
+        expect(self).toBeDefined();
+        // Resolves to core's own entry point (a workspace `packages/core/...` path
+        // in this monorepo, or a `node_modules/@opensip-cli/core/...` path when
+        // installed) — in either case a concrete, absolute file path.
+        expect(self).toMatch(/[/\\]core[/\\]/);
+    });
+});
+describe('foreignCorePath', () => {
+    it('returns undefined for a pack dir with no resolvable core (no core dep)', () => {
+        // testDir has no node_modules at all → resolution throws → "no foreign core".
+        expect(foreignCorePath(testDir)).toBeUndefined();
+    });
+    it('returns the foreign core path for a pack that vendors its own core', () => {
+        plantForeignCore(testDir);
+        const foreign = foreignCorePath(testDir);
+        expect(foreign).toBeDefined();
+        expect(foreign).toContain('@opensip-cli');
+        expect(foreign).toContain(testDir);
+        expect(foreign).not.toBe(selfCore());
+    });
+});
+describe('filterSameCorePackages', () => {
+    it('keeps packs with no core dependency', () => {
+        const pkgs = [{ name: 'no-core', packageDir: testDir }];
+        expect(filterSameCorePackages(pkgs)).toEqual(pkgs);
+    });
+    it('drops a foreign-core pack and reports it via onForeign', () => {
+        plantForeignCore(testDir);
+        const pkgs = [{ name: 'foreign-pack', packageDir: testDir }];
+        const dropped = [];
+        const kept = filterSameCorePackages(pkgs, (pkg, foreignCore) => {
+            dropped.push({ name: pkg.name, foreignCore });
+        });
+        expect(kept).toEqual([]);
+        expect(dropped).toHaveLength(1);
+        expect(dropped[0].name).toBe('foreign-pack');
+        expect(dropped[0].foreignCore).toContain('@opensip-cli');
+    });
+    it('keeps same-core packs and drops only the foreign one in a mixed set', () => {
+        const sameCoreDir = mkdtempSync(join(tmpdir(), 'opensip-same-core-'));
+        plantForeignCore(testDir);
+        try {
+            const pkgs = [
+                { name: 'same-core', packageDir: sameCoreDir },
+                { name: 'foreign', packageDir: testDir },
+            ];
+            const kept = filterSameCorePackages(pkgs);
+            expect(kept.map((p) => p.name)).toEqual(['same-core']);
+        }
+        finally {
+            rmSync(sameCoreDir, { recursive: true, force: true });
+        }
+    });
+});
+//# sourceMappingURL=single-core-guard.test.js.map

package/dist/plugins/__tests__/single-core-guard.test.js.map

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

package/dist/plugins/__tests__/tool-package-discovery.test.d.ts

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

package/dist/plugins/__tests__/tool-package-discovery.test.d.ts.map

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

package/dist/plugins/__tests__/tool-package-discovery.test.js

@@ -0,0 +1,215 @@
+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 { discoverPackagesInNodeModules } from '../marker-discovery.js';
+import { discoverToolPackages, discoverToolPackagesFromAnchors, readToolPackageMetadata, } from '../tool-package-discovery.js';
+let testDir;
+function writePkg(dir, json) {
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(join(dir, 'package.json'), JSON.stringify(json));
+}
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-tool-discover-'));
+});
+afterEach(() => {
+    rmSync(testDir, { recursive: true, force: true });
+});
+describe('discoverToolPackages', () => {
+    it('returns an empty list when node_modules is missing', () => {
+        expect(discoverToolPackages({ projectDir: testDir })).toEqual([]);
+    });
+    it('finds an unscoped package marked as a tool', () => {
+        writePkg(join(testDir, 'node_modules', 'audit'), {
+            name: 'audit',
+            opensipTools: { kind: 'tool' },
+        });
+        const out = discoverToolPackages({ projectDir: testDir });
+        expect(out.map((t) => t.name)).toEqual(['audit']);
+    });
+    it('finds a scoped package marked as a tool', () => {
+        writePkg(join(testDir, 'node_modules', '@opensip-cli', 'fitness'), {
+            name: '@opensip-cli/fitness',
+            opensipTools: { kind: 'tool' },
+        });
+        const out = discoverToolPackages({ projectDir: testDir });
+        expect(out.map((t) => t.name)).toEqual(['@opensip-cli/fitness']);
+    });
+    it('skips packages that are not marked as tools', () => {
+        writePkg(join(testDir, 'node_modules', 'random-pkg'), { name: 'random-pkg' });
+        expect(discoverToolPackages({ projectDir: testDir })).toEqual([]);
+    });
+    it('skips dot-prefixed entries (.bin, .pnpm, etc.)', () => {
+        writePkg(join(testDir, 'node_modules', '.bin', 'fake-tool'), {
+            name: 'fake-tool',
+            opensipTools: { kind: 'tool' },
+        });
+        expect(discoverToolPackages({ projectDir: testDir })).toEqual([]);
+    });
+    it('walks ancestor node_modules and dedupes by package name', () => {
+        const nested = join(testDir, 'project');
+        mkdirSync(nested, { recursive: true });
+        writePkg(join(testDir, 'node_modules', '@opensip-cli', 'fitness'), {
+            name: '@opensip-cli/fitness',
+            opensipTools: { kind: 'tool' },
+        });
+        writePkg(join(nested, 'node_modules', '@opensip-cli', 'fitness'), {
+            name: '@opensip-cli/fitness',
+            opensipTools: { kind: 'tool' },
+        });
+        const out = discoverToolPackages({ projectDir: nested });
+        expect(out).toHaveLength(1);
+        // Nearest-ancestor wins: the inner copy
+        expect(out[0]?.packageDir).toBe(join(nested, 'node_modules', '@opensip-cli', 'fitness'));
+    });
+    it('treats malformed package.json as non-tool (no crash)', () => {
+        const dir = join(testDir, 'node_modules', 'broken');
+        mkdirSync(dir, { recursive: true });
+        writeFileSync(join(dir, 'package.json'), '{not-json');
+        expect(discoverToolPackages({ projectDir: testDir })).toEqual([]);
+    });
+});
+describe('discoverPackagesInNodeModules (single-dir scan, no walk-up)', () => {
+    it('finds a tool in the exact node_modules dir', () => {
+        writePkg(join(testDir, 'host', 'node_modules', '@my', 'audit'), {
+            name: '@my/audit',
+            opensipTools: { kind: 'tool' },
+        });
+        const out = discoverPackagesInNodeModules(join(testDir, 'host', 'node_modules'), 'tool');
+        expect(out.map((t) => t.name)).toEqual(['@my/audit']);
+    });
+    it('does NOT walk up into ancestor node_modules', () => {
+        // A tool in an ANCESTOR node_modules must be invisible to the single-dir
+        // scan (this is the property that keeps a host-dir scan from pulling in
+        // $HOME/node_modules).
+        writePkg(join(testDir, 'node_modules', 'ancestor-tool'), {
+            name: 'ancestor-tool',
+            opensipTools: { kind: 'tool' },
+        });
+        const emptyHost = join(testDir, 'host', 'node_modules');
+        mkdirSync(emptyHost, { recursive: true });
+        expect(discoverPackagesInNodeModules(emptyHost, 'tool')).toEqual([]);
+    });
+    it('returns [] when the dir does not exist', () => {
+        expect(discoverPackagesInNodeModules(join(testDir, 'nope'), 'tool')).toEqual([]);
+    });
+});
+describe('discoverToolPackagesFromAnchors', () => {
+    it('merges walkUp + scanDir sources, first-occurrence-wins on duplicate name', () => {
+        // Project-local host dir (scanDir) pins audit@local; the cwd walk also
+        // sees a different copy — the earlier source wins.
+        writePkg(join(testDir, 'proj', '.runtime', 'plugins', 'tool', 'node_modules', 'audit'), {
+            name: 'audit',
+            opensipTools: { kind: 'tool' },
+        });
+        writePkg(join(testDir, 'cwd', 'node_modules', 'audit'), {
+            name: 'audit',
+            opensipTools: { kind: 'tool' },
+        });
+        writePkg(join(testDir, 'cwd', 'node_modules', 'other'), {
+            name: 'other',
+            opensipTools: { kind: 'tool' },
+        });
+        const out = discoverToolPackagesFromAnchors([
+            { dir: join(testDir, 'proj', '.runtime', 'plugins', 'tool'), mode: 'scanDir' },
+            { dir: join(testDir, 'cwd'), mode: 'walkUp' },
+        ]);
+        expect(out.map((t) => t.name).sort()).toEqual(['audit', 'other']);
+        // First source (project-local scanDir) wins for the duplicate name.
+        expect(out.find((t) => t.name === 'audit')?.packageDir).toBe(join(testDir, 'proj', '.runtime', 'plugins', 'tool', 'node_modules', 'audit'));
+    });
+    it('returns [] when no source yields a tool', () => {
+        expect(discoverToolPackagesFromAnchors([{ dir: join(testDir, 'empty'), mode: 'walkUp' }])).toEqual([]);
+    });
+});
+describe('readToolPackageMetadata', () => {
+    let pkgDir;
+    beforeEach(() => {
+        pkgDir = join(testDir, 'pkg');
+        mkdirSync(pkgDir, { recursive: true });
+    });
+    it('returns undefined when neither package.json nor an authored sidecar is present', () => {
+        expect(readToolPackageMetadata(pkgDir)).toBeUndefined();
+    });
+    it('returns undefined when package.json is malformed', () => {
+        writeFileSync(join(pkgDir, 'package.json'), '{');
+        expect(readToolPackageMetadata(pkgDir)).toBeUndefined();
+    });
+    it('returns undefined when name is missing', () => {
+        writeFileSync(join(pkgDir, 'package.json'), JSON.stringify({}));
+        expect(readToolPackageMetadata(pkgDir)).toBeUndefined();
+    });
+    it('falls back to ./index.js when no exports or main are declared', () => {
+        writeFileSync(join(pkgDir, 'package.json'), JSON.stringify({ name: 'pkg' }));
+        expect(readToolPackageMetadata(pkgDir)).toEqual({
+            name: 'pkg',
+            mainEntry: join(pkgDir, './index.js'),
+        });
+    });
+    it('uses pkg.main when declared', () => {
+        writeFileSync(join(pkgDir, 'package.json'), JSON.stringify({ name: 'pkg', main: './lib/main.js' }));
+        expect(readToolPackageMetadata(pkgDir)?.mainEntry).toBe(join(pkgDir, './lib/main.js'));
+    });
+    it('uses string-form exports when declared', () => {
+        writeFileSync(join(pkgDir, 'package.json'), JSON.stringify({ name: 'pkg', exports: './dist/index.js' }));
+        expect(readToolPackageMetadata(pkgDir)?.mainEntry).toBe(join(pkgDir, './dist/index.js'));
+    });
+    it('uses object-form exports["."]', () => {
+        writeFileSync(join(pkgDir, 'package.json'), JSON.stringify({ name: 'pkg', exports: { '.': './dist/dot.js' } }));
+        expect(readToolPackageMetadata(pkgDir)?.mainEntry).toBe(join(pkgDir, './dist/dot.js'));
+    });
+    it('uses exports["."]["import"] when present', () => {
+        writeFileSync(join(pkgDir, 'package.json'), JSON.stringify({
+            name: 'pkg',
+            exports: { '.': { import: './dist/import.js', default: './dist/default.js' } },
+        }));
+        expect(readToolPackageMetadata(pkgDir)?.mainEntry).toBe(join(pkgDir, './dist/import.js'));
+    });
+    it('falls back to exports["."]["default"] when import is absent', () => {
+        writeFileSync(join(pkgDir, 'package.json'), JSON.stringify({
+            name: 'pkg',
+            exports: { '.': { default: './dist/default.js' } },
+        }));
+        expect(readToolPackageMetadata(pkgDir)?.mainEntry).toBe(join(pkgDir, './dist/default.js'));
+    });
+    // Authored tools have NO package.json — entry resolves from the sidecar.
+    it("resolves an authored sidecar's `main` when there is no package.json", () => {
+        writeFileSync(join(pkgDir, 'opensip-tool.manifest.json'), JSON.stringify({
+            kind: 'tool',
+            id: 'audit',
+            name: '@my-co/audit',
+            version: '1.0.0',
+            main: './dist/audit.js',
+            commands: [],
+        }));
+        expect(readToolPackageMetadata(pkgDir)).toEqual({
+            name: '@my-co/audit',
+            mainEntry: join(pkgDir, './dist/audit.js'),
+        });
+    });
+    it('defaults an authored sidecar entry to ./index.js when `main` is absent, naming from id', () => {
+        writeFileSync(join(pkgDir, 'opensip-tool.manifest.json'), JSON.stringify({ kind: 'tool', id: 'bench', version: '1.0.0', commands: [] }));
+        expect(readToolPackageMetadata(pkgDir)).toEqual({
+            name: 'bench',
+            mainEntry: join(pkgDir, './index.js'),
+        });
+    });
+    it('prefers a real package.json over an authored sidecar when both exist', () => {
+        writeFileSync(join(pkgDir, 'package.json'), JSON.stringify({ name: 'pkg', main: './dist/pkg.js' }));
+        writeFileSync(join(pkgDir, 'opensip-tool.manifest.json'), JSON.stringify({ kind: 'tool', id: 'audit', main: './dist/sidecar.js', commands: [] }));
+        expect(readToolPackageMetadata(pkgDir)?.mainEntry).toBe(join(pkgDir, './dist/pkg.js'));
+    });
+    it('returns undefined for a malformed authored sidecar (no resolvable entry)', () => {
+        writeFileSync(join(pkgDir, 'opensip-tool.manifest.json'), '{not-json');
+        expect(readToolPackageMetadata(pkgDir)).toBeUndefined();
+    });
+    it('returns undefined when the authored sidecar parses to a non-object (e.g. a JSON array)', () => {
+        writeFileSync(join(pkgDir, 'opensip-tool.manifest.json'), JSON.stringify(['not', 'an', 'object']));
+        expect(readToolPackageMetadata(pkgDir)).toBeUndefined();
+    });
+    it('falls back to the directory name when the sidecar has neither name nor id', () => {
+        writeFileSync(join(pkgDir, 'opensip-tool.manifest.json'), JSON.stringify({ kind: 'tool', main: './dist/x.js', commands: [] }));
+        expect(readToolPackageMetadata(pkgDir)?.name).toBe('pkg');
+    });
+});
+//# sourceMappingURL=tool-package-discovery.test.js.map

package/dist/plugins/__tests__/tool-package-discovery.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-package-discovery.test.js","sourceRoot":"","sources":["../../../src/plugins/__tests__/tool-package-discovery.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EACL,oBAAoB,EACpB,+BAA+B,EAC/B,uBAAuB,GACxB,MAAM,8BAA8B,CAAC;AAEtC,IAAI,OAAe,CAAC;AAEpB,SAAS,QAAQ,CAAC,GAAW,EAAE,IAAY;IACzC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;YAC/C,IAAI,EAAE,OAAO;YACb,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE;YACjE,IAAI,EAAE,sBAAsB;YAC5B,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QAC9E,MAAM,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE;YAC3D,IAAI,EAAE,WAAW;YACjB,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;QACH,MAAM,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACxC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE;YACjE,IAAI,EAAE,sBAAsB;YAC5B,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,CAAC,EAAE;YAChE,IAAI,EAAE,sBAAsB;YAC5B,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5B,wCAAwC;QACxC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;QACpD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpC,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,WAAW,CAAC,CAAC;QACtD,MAAM,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,6DAA6D,EAAE,GAAG,EAAE;IAC3E,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE;YAC9D,IAAI,EAAE,WAAW;YACjB,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,6BAA6B,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC;QACzF,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,yEAAyE;QACzE,wEAAwE;QACxE,uBAAuB;QACvB,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,eAAe,CAAC,EAAE;YACvD,IAAI,EAAE,eAAe;YACrB,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC;QACxD,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,6BAA6B,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,6BAA6B,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,uEAAuE;QACvE,mDAAmD;QACnD,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;YACtF,IAAI,EAAE,OAAO;YACb,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;YACtD,IAAI,EAAE,OAAO;YACb,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE;YACtD,IAAI,EAAE,OAAO;YACb,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B,CAAC,CAAC;QAEH,MAAM,GAAG,GAAG,+BAA+B,CAAC;YAC1C,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;YAC9E,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC9C,CAAC,CAAC;QACH,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAClE,oEAAoE;QACpE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,CAC1D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,CAAC,CAC9E,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CACJ,+BAA+B,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CACnF,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,IAAI,MAAc,CAAC;IACnB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC9B,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,GAAG,CAAC,CAAC;QACjD,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7E,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9C,IAAI,EAAE,KAAK;YACX,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC;SACtC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAC5B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CACvD,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAC5B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAC5D,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC3F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAC5B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE,CAAC,CACnE,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAC5B,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE;SAC/E,CAAC,CACH,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAC5B,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE;SACnD,CAAC,CACH,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;IAEH,yEAAyE;IACzE,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,4BAA4B,CAAC,EAC1C,IAAI,CAAC,SAAS,CAAC;YACb,IAAI,EAAE,MAAM;YACZ,EAAE,EAAE,OAAO;YACX,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,EAAE;SACb,CAAC,CACH,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9C,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wFAAwF,EAAE,GAAG,EAAE;QAChG,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,4BAA4B,CAAC,EAC1C,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAC9E,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC9C,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC;SACtC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAC5B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CACvD,CAAC;QACF,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,4BAA4B,CAAC,EAC1C,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CACvF,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAClF,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,4BAA4B,CAAC,EAAE,WAAW,CAAC,CAAC;QACvE,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wFAAwF,EAAE,GAAG,EAAE;QAChG,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,4BAA4B,CAAC,EAC1C,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CACxC,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,GAAG,EAAE;QACnF,aAAa,CACX,IAAI,CAAC,MAAM,EAAE,4BAA4B,CAAC,EAC1C,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CACpE,CAAC;QACF,MAAM,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/plugins/authored-tool-discovery.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Authored-Tool sidecar discovery (kernel).
+ *
+ * Finds authored `Tool` sidecars — `<root>/<name>/opensip-tool.manifest.json`
+ * — under a single authored `tools/` root and returns source-tagged-by-caller
+ * candidates the host can route through admission.
+ *
+ * This is the authored analogue of the npm-marker walker
+ * (`marker-discovery.ts`): a `safeReaddir` over a directory, skipping
+ * dotfiles, returning `{name, dir}`. It differs in *shape* — it scans an
+ * authored `tools/` root (one level: each child dir is a tool), not a
+ * `node_modules` tree, and keys on the SIDECAR FILE's presence rather than a
+ * `package.json` marker. It reads NO module code (identity only) and does NOT
+ * call `loadToolManifest`/`admitTool` — discovery is *location*, admission is
+ * the caller's concern.
+ *
+ * The walk is intentionally SOURCE-AGNOSTIC: it takes a plain `string` root
+ * and never infers a `ToolSource` from path shape. The caller assigns the
+ * source per root (project root ⇒ `project-local`, global root ⇒
+ * `user-global`), so one walk serves both authored roots and the source tag
+ * is carried, never inferred inside the kernel.
+ */
+/** A directory under an authored `tools/` root that carries a sidecar manifest. */
+export interface AuthoredToolCandidate {
+    /** Directory containing the opensip-tool.manifest.json sidecar. */
+    readonly dir: string;
+    /** Directory name (the authored tool's folder name) — for diagnostics. */
+    readonly name: string;
+}
+/**
+ * Discover authored-Tool sidecars under an authored `tools/` root.
+ *
+ * Lists `root`'s immediate children (skipping dotfiles) and returns each child
+ * directory that contains an `opensip-tool.manifest.json` sidecar. A missing
+ * root yields `[]` (best-effort, mirrors `discoverPackagesInNodeModules`'s
+ * `existsSync` guard). Presence of the sidecar IS the discovery signal —
+ * validity/admission is the caller's concern, so the walk stays pure and
+ * source-agnostic (one walk serves the project and global roots).
+ *
+ * @param root An authored `tools/` root — `<project>/opensip-cli/tools` or
+ *   `~/.opensip-cli/tools`. NOT inferred-from here; the caller assigns the
+ *   `ToolSource` per root.
+ */
+export declare function discoverAuthoredToolSidecars(root: string): AuthoredToolCandidate[];
+//# sourceMappingURL=authored-tool-discovery.d.ts.map

package/dist/plugins/authored-tool-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-tool-discovery.d.ts","sourceRoot":"","sources":["../../src/plugins/authored-tool-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAUH,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAelF"}

package/dist/plugins/authored-tool-discovery.js

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview Authored-Tool sidecar discovery (kernel).
+ *
+ * Finds authored `Tool` sidecars — `<root>/<name>/opensip-tool.manifest.json`
+ * — under a single authored `tools/` root and returns source-tagged-by-caller
+ * candidates the host can route through admission.
+ *
+ * This is the authored analogue of the npm-marker walker
+ * (`marker-discovery.ts`): a `safeReaddir` over a directory, skipping
+ * dotfiles, returning `{name, dir}`. It differs in *shape* — it scans an
+ * authored `tools/` root (one level: each child dir is a tool), not a
+ * `node_modules` tree, and keys on the SIDECAR FILE's presence rather than a
+ * `package.json` marker. It reads NO module code (identity only) and does NOT
+ * call `loadToolManifest`/`admitTool` — discovery is *location*, admission is
+ * the caller's concern.
+ *
+ * The walk is intentionally SOURCE-AGNOSTIC: it takes a plain `string` root
+ * and never infers a `ToolSource` from path shape. The caller assigns the
+ * source per root (project root ⇒ `project-local`, global root ⇒
+ * `user-global`), so one walk serves both authored roots and the source tag
+ * is carried, never inferred inside the kernel.
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../lib/logger.js';
+import { PROJECT_LOCAL_MANIFEST_FILE } from './manifest-loader.js';
+import { safeReaddir } from './node-modules-walk.js';
+/**
+ * Discover authored-Tool sidecars under an authored `tools/` root.
+ *
+ * Lists `root`'s immediate children (skipping dotfiles) and returns each child
+ * directory that contains an `opensip-tool.manifest.json` sidecar. A missing
+ * root yields `[]` (best-effort, mirrors `discoverPackagesInNodeModules`'s
+ * `existsSync` guard). Presence of the sidecar IS the discovery signal —
+ * validity/admission is the caller's concern, so the walk stays pure and
+ * source-agnostic (one walk serves the project and global roots).
+ *
+ * @param root An authored `tools/` root — `<project>/opensip-cli/tools` or
+ *   `~/.opensip-cli/tools`. NOT inferred-from here; the caller assigns the
+ *   `ToolSource` per root.
+ */
+export function discoverAuthoredToolSidecars(root) {
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    for (const name of safeReaddir(root)) {
+        if (name.startsWith('.'))
+            continue;
+        const dir = join(root, name);
+        if (!existsSync(join(dir, PROJECT_LOCAL_MANIFEST_FILE)))
+            continue;
+        out.push({ dir, name });
+        logger.debug({
+            evt: 'core.authored_tool.discovered',
+            module: 'core:plugins',
+            dir,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=authored-tool-discovery.js.map

package/dist/plugins/authored-tool-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-tool-discovery.js","sourceRoot":"","sources":["../../src/plugins/authored-tool-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAUrD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC;YAAE,SAAS;QAClE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QACxB,MAAM,CAAC,KAAK,CAAC;YACX,GAAG,EAAE,+BAA+B;YACpC,MAAM,EAAE,cAAc;YACtB,GAAG;SACJ,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/plugins/capability-discovery.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview The generic capability-contribution discovery substrate (§5.3).
+ *
+ * One walker that, given a capability domain's manifest-declared discovery
+ * descriptor + resolved preferences, finds every contributing package (by marker
+ * OR name-pattern), dynamic-imports each one, reads its declared export, and
+ * yields the raw contributions. It hoists the machinery previously split across
+ * three bespoke loaders — fitness's `check-loader.ts`, simulation's
+ * `scenario-package-discovery.ts`, and graph's `graph-adapter-discovery.ts`.
+ *
+ * Pure infra: it takes NO scope, touches NO registry, and imports NO tool. It
+ * yields `{ contribution, sourcePackage }` records that the host's capability
+ * registry routes to the owning tool's registrar (Phase 2). Per-package failures
+ * are isolated — a bad export or an import that throws skips that package with a
+ * structured diagnostic, never the whole run.
+ */
+import type { CapabilityDiscoveryDescriptor } from '../tools/capability.js';
+/**
+ * Resolved discovery preferences for one domain. The host resolves these from
+ * project config (Phase 3) against the descriptor's `configKeys`; the substrate
+ * just applies them. Absent `packages` means "auto-discover"; `autoDiscover:
+ * false` disables it; an explicit `packages` list always wins over auto-discovery.
+ */
+export interface CapabilityDiscoveryPreferences {
+    /** Explicit package-name list. When present (even empty), auto-discovery is skipped. */
+    readonly packages?: readonly string[];
+    /** Disable auto-discovery (name-pattern/marker walk). Default: true (enabled). */
+    readonly autoDiscover?: boolean;
+    /** name-pattern mode only: scopes to scan, overriding the descriptor's `defaultScopes`. */
+    readonly scopes?: readonly string[];
+}
+/** A raw contribution yielded by discovery, tagged with the package it came from. */
+export interface RawCapabilityContribution {
+    /** The contribution value read from the package's declared export (unvalidated). */
+    readonly contribution: unknown;
+    /** npm package name the contribution came from, for diagnostics + provenance. */
+    readonly sourcePackage: string;
+    /**
+     * The domain this contribution routes to, when it is NOT the primary domain
+     * being discovered — i.e. a co-contribution (§5.3): a `recipes` export read from
+     * a fit-pack package, routed to the `fit-recipe` domain. `undefined` means the
+     * primary domain (`descriptor`'s own domain).
+     */
+    readonly targetDomainId?: string;
+}
+/** A structured non-fatal discovery diagnostic (missing package, bad export, import throw). */
+export interface CapabilityDiscoveryDiagnostic {
+    /** Stable event id, e.g. `capability.discovery.package_not_resolved`. */
+    readonly evt: string;
+    /** The package the diagnostic concerns, when known. */
+    readonly packageName?: string;
+    /** Human-readable message. */
+    readonly message: string;
+}
+/** Options for {@link discoverCapabilityContributions}. */
+export interface DiscoverCapabilityContributionsOptions {
+    /** The domain's manifest-declared discovery descriptor. */
+    readonly descriptor: CapabilityDiscoveryDescriptor;
+    /** Discovery anchor for consumer-owned packages (the project root). */
+    readonly projectDir: string;
+    /**
+     * Discovery anchor for BUILT-IN packages (those under `descriptor.builtinScope`).
+     * When the descriptor declares a `builtinScope`, packages under that scope are
+     * resolved from here (the CLI's own install tree) instead of `projectDir`, so a
+     * project pinning an older copy cannot shadow the bundled built-in. Ignored when
+     * the descriptor declares no `builtinScope`.
+     */
+    readonly cliDir?: string;
+    /** Resolved preferences (explicit list / opt-out / scopes). */
+    readonly preferences?: CapabilityDiscoveryPreferences;
+    /** Sink for non-fatal per-package diagnostics. */
+    readonly onDiagnostic?: (diagnostic: CapabilityDiscoveryDiagnostic) => void;
+}
+/**
+ * Discover + load every contributing package for one capability domain and
+ * return the flat list of raw contributions. See the file header for the
+ * contract; per-package failures are isolated via `onDiagnostic`.
+ */
+export declare function discoverCapabilityContributions(options: DiscoverCapabilityContributionsOptions): Promise<RawCapabilityContribution[]>;
+//# sourceMappingURL=capability-discovery.d.ts.map