@itphx/synth-core 0.2.0 → 0.4.4

package/dist/engine/security/protected-paths.test.js

@@ -0,0 +1,166 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtemp, rm, mkdir, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import os from 'node:os';
+import { loadProtectedPaths, checkPath, clearProtectedPathsCache } from './protected-paths.js';
+const HOME = os.homedir();
+const CWD = '/workspace/project';
+function basePolicy() {
+    return {
+        deniedPaths: ['~/.ssh/id_rsa', '/etc/passwd'],
+        deniedPrefixes: ['~/.ssh', '/etc/sudoers.d'],
+        approvalPaths: ['~/.ssh/config'],
+        deniedCommandPrefixes: ['rm -rf /'],
+    };
+}
+describe('checkPath — приоритет deny > ask > deniedPrefixes', () => {
+    it('deniedPaths (точное совпадение) → deny', () => {
+        const d = checkPath('~/.ssh/id_rsa', CWD, basePolicy());
+        expect(d.action).toBe('deny');
+        expect(d.matchedRule).toBe('protected-paths.deny');
+        expect(d.messageId).toBe('deny-protected-path');
+    });
+    it('approvalPaths → ask', () => {
+        const d = checkPath('~/.ssh/config', CWD, basePolicy());
+        expect(d.action).toBe('ask');
+        expect(d.matchedRule).toBe('protected-paths.ask');
+        expect(d.messageId).toBe('ask-protected-path');
+    });
+    it('deniedPrefixes (директория) → deny, но approvalPaths проверяется раньше', () => {
+        // .ssh/config под префиксом ~/.ssh, но должен дать ask (approvalPaths раньше)
+        const d = checkPath('~/.ssh/config', CWD, basePolicy());
+        expect(d.action).toBe('ask');
+        // файл вне approvalPaths, внутри deniedPrefixes — deny (deny-protected-dir)
+        const d2 = checkPath('~/.ssh/authorized_keys', CWD, basePolicy());
+        expect(d2.action).toBe('deny');
+        expect(d2.matchedRule).toBe('protected-paths.deny');
+        expect(d2.messageId).toBe('deny-protected-dir');
+        expect(d2.params?.dir).toContain('.ssh');
+    });
+    it('обычный путь → allow', () => {
+        expect(checkPath('~/workspace/file.ts', CWD, basePolicy()).action).toBe('allow');
+    });
+});
+describe('checkPath — резолв путей', () => {
+    it('~ расширяется в домашний каталог', () => {
+        const d = checkPath('~/.ssh/id_rsa', CWD, basePolicy());
+        expect(d.action).toBe('deny');
+        expect(d.messageId).toBe('deny-protected-path');
+        expect(d.params?.path).toBe(join(HOME, '.ssh', 'id_rsa'));
+    });
+    it('$HOME расширяется в домашний каталог', () => {
+        const d = checkPath('$HOME/.ssh/id_rsa', CWD, basePolicy());
+        expect(d.action).toBe('deny');
+    });
+    it('$PWD расширяется в cwd', () => {
+        const policy = { ...basePolicy(), deniedPaths: ['$PWD/secret.txt'] };
+        const d = checkPath('$PWD/secret.txt', CWD, policy);
+        expect(d.action).toBe('deny');
+    });
+    it('относительный путь резолвится от cwd', () => {
+        const policy = { ...basePolicy(), deniedPaths: [join(CWD, 'secret.txt')] };
+        const d = checkPath('secret.txt', CWD, policy);
+        expect(d.action).toBe('deny');
+    });
+    it('динамический путь ($(...) / ${...}) — не блокируется (source unknown)', () => {
+        const d = checkPath('$(echo ~)/.ssh/id_rsa', CWD, basePolicy());
+        expect(d.action).toBe('allow');
+        expect(d.reason).toContain('dynamic parts');
+    });
+});
+describe('checkPath — пустая политика', () => {
+    it('пустые списки → allow', () => {
+        const empty = { deniedPaths: [], deniedPrefixes: [], approvalPaths: [], deniedCommandPrefixes: [] };
+        expect(checkPath('~/.ssh/id_rsa', CWD, empty).action).toBe('allow');
+    });
+});
+describe('loadProtectedPaths — каскад add/remove', () => {
+    let dir;
+    let systemDir;
+    let overrideDir;
+    let overridePath;
+    beforeEach(async () => {
+        dir = await mkdtemp(join(tmpdir(), 'synth-protected-paths-'));
+        systemDir = join(dir, 'system');
+        overrideDir = join(dir, 'security');
+        overridePath = join(overrideDir, 'protected-paths.json');
+        await mkdir(systemDir, { recursive: true });
+        await mkdir(overrideDir, { recursive: true });
+        await writeFile(join(systemDir, 'protected-paths.json'), JSON.stringify(basePolicy(), null, 2), 'utf-8');
+        clearProtectedPathsCache();
+    });
+    afterEach(async () => {
+        clearProtectedPathsCache();
+        await rm(dir, { recursive: true, force: true });
+    });
+    it('без override — возвращается системная политика', () => {
+        const p = loadProtectedPaths({ systemDir, overridePath });
+        expect(p.deniedPaths).toEqual(['~/.ssh/id_rsa', '/etc/passwd']);
+        expect(p.approvalPaths).toEqual(['~/.ssh/config']);
+    });
+    it('override add расширяет списки', async () => {
+        const ov = {
+            version: 1,
+            add: { deniedPaths: ['/extra/secret'], approvalPaths: ['/extra/ask'] },
+            remove: {},
+        };
+        await writeFile(overridePath, JSON.stringify(ov, null, 2), 'utf-8');
+        const p = loadProtectedPaths({ systemDir, overridePath });
+        expect(p.deniedPaths).toEqual(['~/.ssh/id_rsa', '/etc/passwd', '/extra/secret']);
+        expect(p.approvalPaths).toEqual(['~/.ssh/config', '/extra/ask']);
+    });
+    it('override remove убирает из базы', async () => {
+        const ov = {
+            version: 1,
+            add: {},
+            remove: { deniedPaths: ['/etc/passwd'] },
+        };
+        await writeFile(overridePath, JSON.stringify(ov, null, 2), 'utf-8');
+        const p = loadProtectedPaths({ systemDir, overridePath });
+        expect(p.deniedPaths).toEqual(['~/.ssh/id_rsa']);
+    });
+    it('add и remove одновременно: итог = base + add − remove', async () => {
+        const ov = {
+            version: 1,
+            add: { deniedPaths: ['/new'] },
+            remove: { deniedPaths: ['~/.ssh/id_rsa'] },
+        };
+        await writeFile(overridePath, JSON.stringify(ov, null, 2), 'utf-8');
+        const p = loadProtectedPaths({ systemDir, overridePath });
+        expect(p.deniedPaths).toEqual(['/etc/passwd', '/new']);
+    });
+    it('remove не ломает duplicate у add (set-семантика)', async () => {
+        const ov = {
+            version: 1,
+            add: { deniedPaths: ['/a', '/b'] },
+            remove: {},
+        };
+        await writeFile(overridePath, JSON.stringify(ov, null, 2), 'utf-8');
+        const p = loadProtectedPaths({ systemDir, overridePath });
+        expect(p.deniedPaths).toEqual(['~/.ssh/id_rsa', '/etc/passwd', '/a', '/b']);
+    });
+    it('кэшируется по ключу systemDir|overridePath', async () => {
+        const p1 = loadProtectedPaths({ systemDir, overridePath });
+        await writeFile(overridePath, JSON.stringify({ version: 1, add: { deniedPaths: ['/x'] }, remove: {} }, null, 2), 'utf-8');
+        const p2 = loadProtectedPaths({ systemDir, overridePath });
+        // кэш не перечитан — тот же результат (кэш)
+        expect(p1).toBe(p2);
+    });
+    it('невалидный override-файл — игнорируется (fallback на base)', async () => {
+        await writeFile(overridePath, '{ not json', 'utf-8');
+        const p = loadProtectedPaths({ systemDir, overridePath });
+        expect(p.deniedPaths).toEqual(['~/.ssh/id_rsa', '/etc/passwd']);
+    });
+    it('несуществующий override-файл — системная политика', async () => {
+        const p = loadProtectedPaths({ systemDir, overridePath: join(overrideDir, 'missing.json') });
+        expect(p.deniedPaths).toEqual(['~/.ssh/id_rsa', '/etc/passwd']);
+    });
+    it('использует реальный definitions/protected-paths.json (интеграция)', () => {
+        // без systemDir — читает definitions/protected-paths.json из пакета
+        const p = loadProtectedPaths({});
+        expect(p.deniedPaths).toContain('~/.ssh/id_rsa');
+        expect(p.deniedPaths).toContain('/etc/passwd');
+    });
+});
+//# sourceMappingURL=protected-paths.test.js.map

package/dist/engine/security/protected-paths.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protected-paths.test.js","sourceRoot":"","sources":["../../../src/engine/security/protected-paths.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAG/F,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;AAC1B,MAAM,GAAG,GAAG,oBAAoB,CAAC;AAEjC,SAAS,UAAU;IACjB,OAAO;QACL,WAAW,EAAE,CAAC,eAAe,EAAE,aAAa,CAAC;QAC7C,cAAc,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC;QAC5C,aAAa,EAAE,CAAC,eAAe,CAAC;QAChC,qBAAqB,EAAE,CAAC,UAAU,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,mDAAmD,EAAE,GAAG,EAAE;IACjE,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,CAAC,GAAG,SAAS,CAAC,eAAe,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnD,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,MAAM,CAAC,GAAG,SAAS,CAAC,eAAe,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAClD,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,GAAG,EAAE;QACjF,8EAA8E;QAC9E,MAAM,CAAC,GAAG,SAAS,CAAC,eAAe,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,4EAA4E;QAC5E,MAAM,EAAE,GAAG,SAAS,CAAC,wBAAwB,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;QAClE,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACpD,MAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAChD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,CAAC,SAAS,CAAC,qBAAqB,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,GAAG,SAAS,CAAC,eAAe,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;QACxD,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;QAChD,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,GAAG,SAAS,CAAC,mBAAmB,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5D,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,MAAM,GAAyB,EAAE,GAAG,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC3F,MAAM,CAAC,GAAG,SAAS,CAAC,iBAAiB,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAyB,EAAE,GAAG,UAAU,EAAE,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC;QACjG,MAAM,CAAC,GAAG,SAAS,CAAC,YAAY,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;QAC/E,MAAM,CAAC,GAAG,SAAS,CAAC,uBAAuB,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC;QAChE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,KAAK,GAAyB,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,qBAAqB,EAAE,EAAE,EAAE,CAAC;QAC1H,MAAM,CAAC,SAAS,CAAC,eAAe,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wCAAwC,EAAE,GAAG,EAAE;IACtD,IAAI,GAAW,CAAC;IAChB,IAAI,SAAiB,CAAC;IACtB,IAAI,WAAmB,CAAC;IACxB,IAAI,YAAoB,CAAC;IAEzB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,wBAAwB,CAAC,CAAC,CAAC;QAC9D,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAChC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACpC,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,sBAAsB,CAAC,CAAC;QACzD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,sBAAsB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACzG,wBAAwB,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,wBAAwB,EAAE,CAAC;QAC3B,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;QAChE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,EAAE,GAA2B;YACjC,OAAO,EAAE,CAAC;YACV,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC,YAAY,CAAC,EAAE;YACtE,MAAM,EAAE,EAAE;SACX,CAAC;QACF,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACpE,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,aAAa,EAAE,eAAe,CAAC,CAAC,CAAC;QACjF,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,EAAE,GAA2B;YACjC,OAAO,EAAE,CAAC;YACV,GAAG,EAAE,EAAE;YACP,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,aAAa,CAAC,EAAE;SACzC,CAAC;QACF,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACpE,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,EAAE,GAA2B;YACjC,OAAO,EAAE,CAAC;YACV,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC,MAAM,CAAC,EAAE;YAC9B,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,eAAe,CAAC,EAAE;SAC3C,CAAC;QACF,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACpE,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,EAAE,GAA2B;YACjC,OAAO,EAAE,CAAC;YACV,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;YAClC,MAAM,EAAE,EAAE;SACX,CAAC;QACF,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACpE,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,EAAE,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3D,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC1H,MAAM,EAAE,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC3D,4CAA4C;QAC5C,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QAC1D,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;QAC7F,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,oEAAoE;QACpE,MAAM,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACjD,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/engine/security/shell-guard.d.ts

@@ -0,0 +1,117 @@
+/** Политика безопасности execute_shell. */
+export interface ShellPolicy {
+    /** Точные пути, которые запрещено трогать (резолвятся с `~`). */
+    deniedPaths: string[];
+    /** Префиксы директорий, внутри которых всё запрещено. */
+    deniedPrefixes: string[];
+    /** Пути, которые разрешены только через подтверждение (ask). */
+    approvalPaths: string[];
+    /** Префиксы команд, запрещённые целиком (например "rm -rf /"). */
+    deniedCommandPrefixes: string[];
+}
+/** Путь, извлечённый из аргументов команды. */
+export interface ExtractedPath {
+    path: string;
+    source: 'literal' | 'unknown';
+}
+/** Результат checkShellCommand. */
+export interface ShellCheckResult {
+    action: 'allow' | 'deny' | 'ask';
+    reason: string;
+    matchedRule?: string;
+    deniedPath?: string;
+    /** Идентификатор локализованного сообщения (deny-command и т.д.). */
+    messageId?: string;
+    /** Параметры подстановки в сообщение ({{path}}, {{dir}}, {{command}}). */
+    params?: Record<string, string>;
+}
+/** Пустая политика — fallback, если файлы не найдены или невалидны. */
+export declare const DEFAULT_POLICY: ShellPolicy;
+/** Резолвит `~`/`~/...` в абсолютный путь (для записей политики). */
+export declare function expandHome(p: string): string;
+/**
+ * Лёгкий shlex-токенизатор (POSIX-подобный).
+ * - одинарные кавычки `'...'` — всё литерально;
+ * - двойные кавычки `"..."` — кавычки снимаются, `\` экранирует следующий символ;
+ * - `\` вне кавычек экранирует следующий символ;
+ * - незакрытые кавычки дочитываются до конца строки (не бросаем ошибку).
+ * Кавычки из токенов удаляются (как shlex.split).
+ */
+export declare function tokenizeCommand(command: string): string[];
+/**
+ * Разбивает команду на сегменты по разделителям: `;`, `&&`, `||`, `&`, `|`
+ * и переводу строки. Разделители ВНУТРИ кавычек (`'...'`, `"..."`) и внутри
+ * подстановок `$(...)` НЕ разбивают команду — shell не выполняет их как
+ * операторы. Каждый сегмент возвращается без ведущих/хвостовых пробелов.
+ */
+export declare function splitShellSegments(command: string): string[];
+/**
+ * Извлекает вложенную команду из обёрток, исполняющих строку как shell-код:
+ * `sh -c <cmd>`, `bash -c <cmd>`, `zsh -c <cmd>`, `eval <cmd>`, `sudo <cmd>`.
+ * Возвращает null, если команда не является обёрткой.
+ */
+export declare function extractWrappedCommand(segment: string, tokens: string[]): string | null;
+/** Пытается зарезолвить токен в абсолютный путь. */
+export declare function tryResolvePath(token: string, cwd: string): ExtractedPath | null;
+/**
+ * Извлекает пути из аргументов команды (первый токен — сама команда).
+ * Флаги (`-` префикс) пропускаются; после `--` всё считается аргументами.
+ * Токены с динамикой ($, *, ?, [, (, `) помечаются source: 'unknown'.
+ */
+export declare function extractCommandPaths(tokens: string[], cwd: string): ExtractedPath[];
+/**
+ * Является ли команда изменяющей состояние (для plan-режима и денлиста).
+ * Команда разбивается на сегменты по ВСЕМ разделителям (`;`, `&&`, `||`, `&`,
+ * `|`, `\n` вне кавычек/`$()`); если ЛЮБОЙ сегмент мутирующий — deny (B1).
+ * Read-only: ls, cat, pwd, echo, grep, find без -delete/-exec, git
+ * status/diff/log/show/blame/branch, head, tail, wc, sort, uniq, sed -n, awk,
+ * which, type, env, printenv, date, whoami, curl без write-флагов, wget без
+ * write-флагов.
+ */
+export declare function isMutatingCommand(tokens: string[], command: string): boolean;
+/** Поиск корня пакета @itphx/synth-core по package.json вверх (как в context/config.ts). */
+export declare function findPackageRoot(startDir: string): string;
+/**
+ * Каталог системных definitions: {root}/definitions (источник, публикуется
+ * в npm через files) с fallback на {root}/dist/definitions (Docker: рядом с
+ * package.json только dist/).
+ */
+export declare function resolveSystemDefinitionsDir(): string;
+export interface ShellPolicyOptions {
+    /** Каталог системных definitions (по умолчанию резолвится от пакета). */
+    systemDir?: string;
+    /** Пользовательский override: {dataDir}/context/shell-policy.json. */
+    overridePath?: string;
+}
+/** Сброс кэша (для тестов). */
+export declare function clearShellPolicyCache(): void;
+/**
+ * Загружает политику: системный дефолт definitions/shell-policy.json +
+ * override {dataDir}/context/shell-policy.json (если существует — полностью
+ * заменяет системный). Некорректные файлы игнорируются; результат кэшируется.
+ */
+export declare function loadShellPolicy(options?: ShellPolicyOptions): ShellPolicy;
+/**
+ * Проверяет команду по политике. Команда разбивается на сегменты по всем
+ * разделителям (`;`, `&&`, `||`, `&`, `|`, `\n`); если ЛЮБОЙ сегмент нарушает
+ * политику — deny/ask (B1/B2). Обёртки `sh -c`/`bash -c`/`zsh -c`/`eval`/`sudo`
+ * анализируются рекурсивно по вложенной команде (B4).
+ *
+ * Порядок внутри сегмента (deny-приоритет сверху вниз):
+ *   1. deniedCommandPrefixes — префиксы команд (по токенам сегмента);
+ *   2. deniedPaths — точные запрещённые пути;
+ *   3. approvalPaths — пути под подтверждение (ask);
+ *   4. deniedPrefixes — запрещённые префиксы директорий.
+ * ApprovalPaths проверяются ДО deniedPrefixes, чтобы ~/.ssh/config не
+ * «проглатывался» префиксом ~/.ssh (как в hermes file_safety.py).
+ */
+export declare function checkShellCommand(command: string, cwd: string, policy: ShellPolicy): ShellCheckResult;
+/**
+ * Матчит паттерн командного правила (permission.rules.shell) к команде.
+ * - `*` — любая команда;
+ * - `git commit *` / `npm install *` — префиксный матч по токенам;
+ * - без glob-символов — точное совпадение команды;
+ * - иначе — fallback на globMatch (редкие случаи).
+ */
+export declare function matchShellCommandPattern(pattern: string, command: string): boolean;
+//# sourceMappingURL=shell-guard.d.ts.map

package/dist/engine/security/shell-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-guard.d.ts","sourceRoot":"","sources":["../../../src/engine/security/shell-guard.ts"],"names":[],"mappings":"AAsBA,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,yDAAyD;IACzD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,gEAAgE;IAChE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kEAAkE;IAClE,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;CAC/B;AAED,mCAAmC;AACnC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,uEAAuE;AACvE,eAAO,MAAM,cAAc,EAAE,WAK5B,CAAC;AAIF,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI5C;AAOD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAsCzD;AAQD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CA8D5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAgBtF;AAOD,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAqC/E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CAkBlF;AAuFD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAG5E;AAQD,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CASxD;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAOpD;AAED,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD,+BAA+B;AAC/B,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAiBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAmB7E;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAuBrG;AA4GD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAUlF"}