@nerdvana/parism 0.1.0

package/README.md

@@ -0,0 +1,242 @@
+# Parism
+
+> Refract the Shell. Every command, structured.
+
+---
+
+## 셸은 당신을 위해 설계되지 않았다
+
+1969년 Ken Thompson이 Unix를 만들 때, 그는 출력 대상이 사람이라고 가정했다. 정확히 말하면 터미널 앞에 앉아 있는, 눈이 달린 생물.
+
+반세기가 지났다. 이제 터미널을 읽는 것은 사람만이 아니다.
+
+AI 에이전트는 `ls -la`를 실행하고, 그 출력을 받는다. 그리고 거기서 진짜 작업이 시작된다. 공백을 기준으로 분리하고, 첫 번째 열이 권한이고, 세 번째가 소유자이고, 파일명이 어디서 시작하는지를 토큰을 태워가며 추론한다. 인간의 눈이 0.1초에 처리하는 것을.
+
+이것은 번역이 아니다. 암호화된 적도 없는 메시지를 해독하는 일이다.
+
+---
+
+## 왜 문제인가
+
+세 번의 번역이 일어난다.
+
+첫 번째: 커널이 파일시스템 메타데이터를 `stat` 구조체로 관리한다. `inode`, `mode`, `uid`, `gid`, `size`, `mtime`. 이미 완벽하게 구조화된 데이터다.
+
+두 번째: `ls`가 그 구조를 인간이 읽기 좋은 텍스트로 평탄화한다. `drwxr-xr-x  2 user group 4096 Mar 06 09:23 src`. 구조가 텍스트로 무너진다.
+
+세 번째: 에이전트가 그 텍스트를 다시 구조로 되돌리려 한다. 무너진 것을 다시 세우는 작업이다.
+
+Parism이 개입하는 것은 두 번째와 세 번째 사이다. 한 번 버려진 구조를 되찾는 것이다.
+
+이것이 비용이다. `ls` 한 번 실행하고 파일 목록을 얻는 것처럼 보이지만, 실제로는 에이전트가 출력을 파싱하는 데 수십 번의 추론 단계를 거친다. 그리고 종종 틀린다. 경계 케이스, 예상치 못한 공백, OS별로 미묘하게 다른 출력 형식. 틀리면 재시도한다. 재시도는 다시 토큰이다.
+
+---
+
+## Parism이 하는 일
+
+프리즘은 빛을 파괴하지 않는다. 분해할 뿐이다.
+
+```
+"drwxr-xr-x  2 user group 4096 Mar 06 09:23 src"
+
+                    ↓  Parism
+
+{
+  "type": "directory",
+  "name": "src",
+  "permissions": { "owner": "rwx", "group": "r-x", "other": "r-x" },
+  "size_bytes": 4096,
+  "owner": "user",
+  "group": "group",
+  "modified_at": "2026-03-06T09:23:00"
+}
+```
+
+정보는 달라지지 않는다. 형태가 달라진다. 에이전트는 이제 파싱하지 않는다. 읽기만 한다.
+
+---
+
+## 어떻게 좋은가
+
+### 파싱 오류가 없어진다
+
+텍스트 파싱은 깨지기 쉽다. `ps aux`는 리눅스와 macOS에서 컬럼 순서가 다르다. `df -h`의 `1K-blocks` 헤더는 환경에 따라 다르게 나온다. 파일명에 공백이 있으면 `ls` 파싱은 거의 반드시 틀린다. Parism의 파서는 이 경우들을 직접 처리한다. 에이전트는 구조화된 데이터만 받는다.
+
+### 재시도가 줄어든다
+
+에이전트가 출력을 잘못 해석하면 재질문하거나, 다른 명령으로 다시 확인하거나, 잘못된 정보를 바탕으로 다음 단계를 진행한다. 세 가지 모두 토큰이 든다. 구조화된 출력은 오해의 여지를 줄인다. 파일이 몇 개인지 묻지 않아도 `entries.length`다.
+
+### raw가 항상 보존된다
+
+파서가 틀릴 수도 있다. 파서가 없는 명령어일 수도 있다. 그래서 Parism은 `raw`를 항상 유지한다. `parsed`는 보너스다. `raw`는 보험이다. 에이전트는 항상 원본으로 돌아갈 수 있다.
+
+```json
+"stdout": {
+  "raw": "drwxr-xr-x ...",
+  "parsed": { "entries": [ ... ] }
+}
+```
+
+### 응답 구조가 일정하다
+
+성공이든 실패든, `ok`와 `exitCode`는 항상 같은 자리에 있다. 에이전트가 분기 처리를 작성하는 방식이 단순해진다. "stdout을 파싱해서 오류인지 확인"이 아니라 `if (!result.ok)`다.
+
+### 실행 시간이 기록된다
+
+모든 응답에 `duration_ms`가 포함된다. 명령이 느린지 빠른지를 에이전트가 판단하는 데 쓸 수 있다. 디버깅할 때도 유용하다.
+
+---
+
+## 가드 — 에이전트를 신뢰하지 않는 이유
+
+`rm -rf /`는 세 개의 문자로 쓸 수 있다.
+
+에이전트는 오류를 범한다. 문맥을 잃고, 경로를 착각하고, 의도하지 않은 명령을 생성한다. Guard는 에이전트를 불신하는 것이 아니다. 에이전트의 실수가 파국으로 이어지지 않도록 설계하는 것이다.
+
+세 겹의 방어선이 있다.
+
+**화이트리스트**: `allowed_commands`에 없는 명령어는 실행되지 않는다. 프로세스를 만들지도 않는다. 설명 없이 거절한다.
+
+**경로 제한**: `allowed_paths`를 설정하면, 그 바깥의 경로를 참조하는 명령은 차단된다. 에이전트가 `/etc`를 건드리는 일이 없어진다.
+
+**인젝션 패턴 차단**: `;`, `$(`, `` ` ``, `&&`, `||`, `|`가 인자에 포함되면 실행하지 않는다. 에이전트가 의도했든 아니든.
+
+차단된 명령은 이런 응답을 반환한다.
+
+```json
+{
+  "ok": false,
+  "guard_error": {
+    "reason": "command_not_allowed",
+    "message": "Command 'rm' is not in the allowed list"
+  }
+}
+```
+
+에이전트는 실행 결과와 동일한 구조로 차단 이유를 받는다. 예외가 터지지 않는다. 파이프라인이 깨지지 않는다.
+
+---
+
+## 지원 명령어 — 31종 내장 파서
+
+| 카테고리 | 명령어 | 파싱 결과 |
+|---|---|---|
+| 파일시스템 | `ls` | `entries[]` — 이름, 타입, 권한, 크기, 수정 시각, 소유자 |
+| 파일시스템 | `find` | `paths[]` — 경로 목록 |
+| 파일시스템 | `stat` | `lines[]` — 원본 라인 배열 |
+| 파일시스템 | `du` | `entries[]` — 크기, 경로 |
+| 파일시스템 | `df` | `filesystems[]` — 파티션, 사용량, 마운트 위치 |
+| 파일시스템 | `tree` | `root`, `tree{}` — 계층 구조 노드, `total_files`, `total_dirs` |
+| 프로세스 | `ps` | `processes[]` — PID, CPU%, MEM%, 명령어 |
+| 프로세스 | `kill` | raw pass-through |
+| 네트워크 | `ping` | `target`, `packets_transmitted`, `packet_loss_percent`, `rtt_*_ms` |
+| 네트워크 | `curl -I` | `status_code`, `headers{}` |
+| 네트워크 | `netstat` | `connections[]` — proto, local/foreign address, state |
+| 네트워크 | `lsof -i` | `entries[]` — PID, 프로세스명, 프로토콜, 로컬/원격 주소, 상태 |
+| 네트워크 | `ss` | `entries[]` — 상태, 수신/발신 큐, 로컬/피어 주소, 프로세스 |
+| 네트워크 | `dig` | `query`, `answers[]` — 타입, 값, TTL, `query_time_ms` |
+| 텍스트 | `grep -n` | `matches[]` — 파일, 라인 번호, 텍스트 |
+| 텍스트 | `wc` | `entries[]` — count, 파일명 |
+| 텍스트 | `head`, `tail`, `cat` | `lines[]` |
+| Git | `git status` | `branch`, `staged[]`, `modified[]`, `untracked[]` |
+| Git | `git log --oneline` | `commits[]` — hash, message |
+| Git | `git diff` | `files_changed[]` |
+| Git | `git branch -vv` | `branches[]` — 이름, current, upstream, ahead/behind |
+| 환경 | `env` | `vars{}` — 키-값 맵 |
+| 환경 | `pwd` | `path` |
+| 환경 | `which` | `paths[]` |
+| 시스템 | `free` | `rows{}` — mem/swap별 total, used, free, available (bytes) |
+| 시스템 | `uname` | `kernel`, `hostname`, `release`, `version`, `arch`, `os` |
+| 시스템 | `id` | `uid`, `gid`, `username`, `groups[]` — id, name |
+| Windows | `dir` | `directory`, `entries[]` — 이름, 타입, 크기, 수정 시각, `free_bytes` |
+| Windows | `tasklist` | `processes[]` — 이름, PID, 세션, 메모리. CSV 형식 지원 |
+| Windows | `ipconfig` | `hostname`, `adapters[]` — IPv4/6, 서브넷, 게이트웨이, DNS, MAC |
+| Windows | `systeminfo` | `hostname`, `os_name`, 메모리, `hotfixes[]`, `network_cards[]` |
+
+파서가 없는 명령어는 `parsed: null`로 반환된다. `raw`는 그대로 있다.
+
+---
+
+## 설치
+
+### npx
+
+```bash
+npx parism
+```
+
+### 로컬 빌드
+
+```bash
+git clone https://github.com/your-org/parism
+cd parism
+npm install && npm run build
+node dist/index.js
+```
+
+---
+
+## Claude Desktop 연동
+
+`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
+`%APPDATA%\Claude\claude_desktop_config.json` (Windows)
+
+```json
+{
+  "mcpServers": {
+    "parism": {
+      "command": "npx",
+      "args": ["-y", "parism"]
+    }
+  }
+}
+```
+
+Claude Code (Linux):
+
+```json
+{
+  "mcpServers": {
+    "parism": {
+      "command": "node",
+      "args": ["/path/to/parism/dist/index.js"],
+      "cwd": "/path/to/parism"
+    }
+  }
+}
+```
+
+연결이 되면 `run` 도구 하나가 노출된다. 에이전트는 이 도구로 명령을 실행하고 JSON을 받는다.
+
+---
+
+## 설정
+
+`prism.config.json`을 프로젝트 루트에 두면 Guard 동작을 제어할 수 있다.
+
+```json
+{
+  "guard": {
+    "allowed_commands": ["ls", "git", "find", "grep", "env", "ps"],
+    "allowed_paths": ["/home/user/projects"],
+    "timeout_ms": 10000,
+    "block_patterns": [";", "$(", "`", "&&", "||", "|"]
+  }
+}
+```
+
+`allowed_paths`가 비어 있으면 경로 제한 없이 실행된다. 판단은 당신 몫이다.
+
+---
+
+## Parism이 아닌 것
+
+Parism은 새로운 셸이 아니다. bash를 대체하지 않는다. bash 위에 앉아서 출력을 받아 구조화할 뿐이다.
+
+Parism은 AI를 위한 운영체제가 아니다. 관심사는 하나다. 에이전트가 명령을 내렸을 때, 에이전트가 이해할 수 있는 형태로 결과를 돌려주는 것.
+
+Unix 철학은 "하나의 일을 잘 하라"였다. Parism은 그것을 이해한다.
+
+---
+
+*Parism — Refract the Shell.*

package/dist/config/loader.d.ts

@@ -0,0 +1,16 @@
+export interface PrismGuardConfig {
+    allowed_commands: string[];
+    allowed_paths: string[];
+    timeout_ms: number;
+    block_patterns: string[];
+}
+export interface PrismConfig {
+    guard: PrismGuardConfig;
+}
+export declare const DEFAULT_CONFIG: PrismConfig;
+/**
+ * 지정된 경로에서 prism.config.json을 로드한다.
+ * 파일이 없거나 파싱 실패 시 DEFAULT_CONFIG를 반환한다.
+ */
+export declare function loadConfig(configPath: string): Promise<PrismConfig>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAK,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAQ,MAAM,CAAC;IACzB,cAAc,EAAI,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED,eAAO,MAAM,cAAc,EAAE,WAe5B,CAAC;AAEF;;;GAGG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAWzE"}

package/dist/config/loader.js

@@ -0,0 +1,34 @@
+import { readFile } from "node:fs/promises";
+export const DEFAULT_CONFIG = {
+    guard: {
+        allowed_commands: [
+            "ls", "find", "stat", "du", "df",
+            "ps", "kill",
+            "ping", "curl", "netstat",
+            "grep", "wc", "head", "tail", "cat",
+            "git",
+            "env", "pwd", "which",
+            "echo", "date", "uname", "hostname",
+        ],
+        allowed_paths: [],
+        timeout_ms: 10000,
+        block_patterns: [";", "$(", "`", "&&", "||", ">", ">>", "<", "|"],
+    },
+};
+/**
+ * 지정된 경로에서 prism.config.json을 로드한다.
+ * 파일이 없거나 파싱 실패 시 DEFAULT_CONFIG를 반환한다.
+ */
+export async function loadConfig(configPath) {
+    try {
+        const raw = await readFile(configPath, "utf-8");
+        const json = JSON.parse(raw);
+        return {
+            guard: { ...DEFAULT_CONFIG.guard, ...(json.guard ?? {}) },
+        };
+    }
+    catch {
+        return DEFAULT_CONFIG;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAa5C,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,KAAK,EAAE;QACL,gBAAgB,EAAE;YAChB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;YAChC,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,MAAM,EAAE,SAAS;YACzB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK;YACnC,KAAK;YACL,KAAK,EAAE,KAAK,EAAE,OAAO;YACrB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU;SACpC;QACD,aAAa,EAAG,EAAE;QAClB,UAAU,EAAM,KAAK;QACrB,cAAc,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC;KAClE;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAI,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyB,CAAC;QAErD,OAAO;YACL,KAAK,EAAE,EAAE,GAAG,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE;SAC1D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/engine/executor.d.ts

@@ -0,0 +1,8 @@
+import type { ResponseEnvelope } from "../types/envelope.js";
+/**
+ * 지정한 명령을 execFile로 실행하고 ResponseEnvelope를 반환한다.
+ * - 셸을 거치지 않으므로 셸 확장/인젝션 위험 없음
+ * - 실행 실패(명령 없음 포함)는 예외 대신 ok=false 봉투로 반환
+ */
+export declare function execute(cmd: string, args: string[], cwd: string): Promise<ResponseEnvelope>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/engine/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/engine/executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAG,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAG,MAAM,GACX,OAAO,CAAC,gBAAgB,CAAC,CAyC3B"}

package/dist/engine/executor.js

@@ -0,0 +1,44 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+/**
+ * 지정한 명령을 execFile로 실행하고 ResponseEnvelope를 반환한다.
+ * - 셸을 거치지 않으므로 셸 확장/인젝션 위험 없음
+ * - 실행 실패(명령 없음 포함)는 예외 대신 ok=false 봉투로 반환
+ */
+export async function execute(cmd, args, cwd) {
+    const start = Date.now();
+    try {
+        const { stdout, stderr } = await execFileAsync(cmd, args, {
+            cwd,
+            maxBuffer: 10 * 1024 * 1024, // 10 MB
+        });
+        return {
+            ok: true,
+            exitCode: 0,
+            cmd,
+            args,
+            cwd,
+            duration_ms: Date.now() - start,
+            stdout: { raw: stdout, parsed: null },
+            stderr: { raw: stderr, parsed: null },
+            diff: null,
+        };
+    }
+    catch (err) {
+        const e = err;
+        const exitCode = typeof e.code === "number" ? e.code : 1;
+        return {
+            ok: false,
+            exitCode,
+            cmd,
+            args,
+            cwd,
+            duration_ms: Date.now() - start,
+            stdout: { raw: e.stdout ?? "", parsed: null },
+            stderr: { raw: e.stderr ?? e.message, parsed: null },
+            diff: null,
+        };
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/engine/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/engine/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAY,EACZ,IAAc,EACd,GAAY;IAEZ,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE;YACxD,GAAG;YACH,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,QAAQ;SACtC,CAAC,CAAC;QAEH,OAAO;YACL,EAAE,EAAW,IAAI;YACjB,QAAQ,EAAK,CAAC;YACd,GAAG;YACH,IAAI;YACJ,GAAG;YACH,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC/B,MAAM,EAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;YAC1C,MAAM,EAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;YAC1C,IAAI,EAAS,IAAI;SAClB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,GAIT,CAAC;QAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzD,OAAO;YACL,EAAE,EAAW,KAAK;YAClB,QAAQ;YACR,GAAG;YACH,IAAI;YACJ,GAAG;YACH,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC/B,MAAM,EAAO,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;YAClD,MAAM,EAAO,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;YACzD,IAAI,EAAS,IAAI;SAClB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/engine/guard.d.ts

@@ -0,0 +1,18 @@
+import type { PrismConfig } from "../config/loader.js";
+/**
+ * Execution Guard가 차단 시 던지는 오류.
+ */
+export declare class GuardError extends Error {
+    readonly reason: "command_not_allowed" | "path_not_allowed" | "injection_pattern";
+    constructor(message: string, reason: "command_not_allowed" | "path_not_allowed" | "injection_pattern");
+}
+/**
+ * 명령 실행 허용 여부를 검사한다. 차단 조건 충족 시 GuardError를 던진다.
+ *
+ * 검사 순서:
+ * 1. 화이트리스트 — cmd가 allowed_commands에 없으면 차단
+ * 2. 인젝션 패턴 — args 중 block_patterns에 포함된 패턴이 있으면 차단
+ * 3. 경로 제한 — allowed_paths가 설정된 경우 cwd가 허용 경로 하위인지 확인
+ */
+export declare function checkGuard(cmd: string, args: string[], cwd: string, config: PrismConfig): void;
+//# sourceMappingURL=guard.d.ts.map

package/dist/engine/guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.d.ts","sourceRoot":"","sources":["../../src/engine/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;aAGjB,MAAM,EAAE,qBAAqB,GAAG,kBAAkB,GAAG,mBAAmB;gBADxF,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,qBAAqB,GAAG,kBAAkB,GAAG,mBAAmB;CAK3F;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAK,MAAM,EACd,IAAI,EAAI,MAAM,EAAE,EAChB,GAAG,EAAK,MAAM,EACd,MAAM,EAAE,WAAW,GAClB,IAAI,CAkCN"}

package/dist/engine/guard.js

@@ -0,0 +1,42 @@
+/**
+ * Execution Guard가 차단 시 던지는 오류.
+ */
+export class GuardError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = "GuardError";
+    }
+}
+/**
+ * 명령 실행 허용 여부를 검사한다. 차단 조건 충족 시 GuardError를 던진다.
+ *
+ * 검사 순서:
+ * 1. 화이트리스트 — cmd가 allowed_commands에 없으면 차단
+ * 2. 인젝션 패턴 — args 중 block_patterns에 포함된 패턴이 있으면 차단
+ * 3. 경로 제한 — allowed_paths가 설정된 경우 cwd가 허용 경로 하위인지 확인
+ */
+export function checkGuard(cmd, args, cwd, config) {
+    const { guard } = config;
+    if (!guard.allowed_commands.includes(cmd)) {
+        throw new GuardError(`Command '${cmd}' is not in the allowed list`, "command_not_allowed");
+    }
+    const allArgs = args.join(" ");
+    for (const pattern of guard.block_patterns) {
+        if (allArgs.includes(pattern)) {
+            throw new GuardError(`Blocked pattern '${pattern}' detected in arguments`, "injection_pattern");
+        }
+    }
+    if (guard.allowed_paths.length > 0) {
+        const normalizedCwd = cwd.endsWith("/") ? cwd : cwd + "/";
+        const allowed = guard.allowed_paths.some((p) => {
+            const normalizedP = p.endsWith("/") ? p : p + "/";
+            return normalizedCwd.startsWith(normalizedP);
+        });
+        if (!allowed) {
+            throw new GuardError(`Working directory '${cwd}' is outside allowed paths`, "path_not_allowed");
+        }
+    }
+}
+//# sourceMappingURL=guard.js.map

package/dist/engine/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/engine/guard.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGjB;IAFlB,YACE,OAAe,EACC,MAAwE;QAExF,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,WAAM,GAAN,MAAM,CAAkE;QAGxF,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,GAAc,EACd,IAAgB,EAChB,GAAc,EACd,MAAmB;IAEnB,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAEzB,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,UAAU,CAClB,YAAY,GAAG,8BAA8B,EAC7C,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAC3C,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,UAAU,CAClB,oBAAoB,OAAO,yBAAyB,EACpD,mBAAmB,CACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,aAAa,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;QAC1D,MAAM,OAAO,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7C,MAAM,WAAW,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;YAClD,OAAO,aAAa,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,UAAU,CAClB,sBAAsB,GAAG,4BAA4B,EACrD,kBAAkB,CACnB,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+import { loadConfig } from "./config/loader.js";
+import path from "node:path";
+async function main() {
+    const configPath = path.join(process.cwd(), "prism.config.json");
+    const config = await loadConfig(configPath);
+    const server = createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("[parism] Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAc,aAAa,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAgB,oBAAoB,CAAC;AAC1D,OAAO,IAAI,MAA0B,WAAW,CAAC;AAEjD,KAAK,UAAU,IAAI;IACjB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACjE,MAAM,MAAM,GAAO,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;IAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/parsers/env/env.d.ts

@@ -0,0 +1,4 @@
+export declare function parseEnv(cmd: string, args: string[], raw: string): {
+    vars: Record<string, string>;
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/parsers/env/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/parsers/env/env.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAYnG"}

package/dist/parsers/env/env.js

@@ -0,0 +1,13 @@
+export function parseEnv(cmd, args, raw) {
+    const vars = {};
+    for (const line of raw.split("\n")) {
+        const eqIdx = line.indexOf("=");
+        if (eqIdx < 0)
+            continue;
+        const key = line.slice(0, eqIdx);
+        const value = line.slice(eqIdx + 1);
+        vars[key] = value;
+    }
+    return { vars };
+}
+//# sourceMappingURL=env.js.map

package/dist/parsers/env/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/parsers/env/env.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW;IAC/D,MAAM,IAAI,GAA2B,EAAE,CAAC;IAExC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC;YAAE,SAAS;QACxB,MAAM,GAAG,GAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,GAAK,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC"}

package/dist/parsers/env/index.d.ts

@@ -0,0 +1,4 @@
+export { parseEnv } from "./env.js";
+export { parsePwd } from "./pwd.js";
+export { parseWhich } from "./which.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/parsers/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/parsers/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAQ,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAQ,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/parsers/env/index.js

@@ -0,0 +1,4 @@
+export { parseEnv } from "./env.js";
+export { parsePwd } from "./pwd.js";
+export { parseWhich } from "./which.js";
+//# sourceMappingURL=index.js.map

package/dist/parsers/env/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parsers/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAQ,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAQ,UAAU,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/parsers/env/pwd.d.ts

@@ -0,0 +1,4 @@
+export declare function parsePwd(cmd: string, args: string[], raw: string): {
+    path: string;
+};
+//# sourceMappingURL=pwd.d.ts.map

package/dist/parsers/env/pwd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwd.d.ts","sourceRoot":"","sources":["../../../src/parsers/env/pwd.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAEnF"}

package/dist/parsers/env/pwd.js

@@ -0,0 +1,4 @@
+export function parsePwd(cmd, args, raw) {
+    return { path: raw.trim() };
+}
+//# sourceMappingURL=pwd.js.map

package/dist/parsers/env/pwd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pwd.js","sourceRoot":"","sources":["../../../src/parsers/env/pwd.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW;IAC/D,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;AAC9B,CAAC"}

package/dist/parsers/env/which.d.ts

@@ -0,0 +1,4 @@
+export declare function parseWhich(cmd: string, args: string[], raw: string): {
+    paths: string[];
+};
+//# sourceMappingURL=which.d.ts.map

package/dist/parsers/env/which.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"which.d.ts","sourceRoot":"","sources":["../../../src/parsers/env/which.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAExF"}

package/dist/parsers/env/which.js

@@ -0,0 +1,4 @@
+export function parseWhich(cmd, args, raw) {
+    return { paths: raw.split("\n").map(l => l.trim()).filter(Boolean) };
+}
+//# sourceMappingURL=which.js.map

package/dist/parsers/env/which.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"which.js","sourceRoot":"","sources":["../../../src/parsers/env/which.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW;IACjE,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/parsers/fs/df.d.ts

@@ -0,0 +1,12 @@
+export interface DfEntry {
+    filesystem: string;
+    blocks_1k: string;
+    used: string;
+    available: string;
+    use_percent: string;
+    mounted_on: string;
+}
+export declare function parseDf(cmd: string, args: string[], raw: string): {
+    filesystems: DfEntry[];
+};
+//# sourceMappingURL=df.d.ts.map

package/dist/parsers/fs/df.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"df.d.ts","sourceRoot":"","sources":["../../../src/parsers/fs/df.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,UAAU,EAAG,MAAM,CAAC;IACpB,SAAS,EAAI,MAAM,CAAC;IACpB,IAAI,EAAS,MAAM,CAAC;IACpB,SAAS,EAAI,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAG,MAAM,CAAC;CACrB;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,OAAO,EAAE,CAAA;CAAE,CAkB5F"}

package/dist/parsers/fs/df.js

@@ -0,0 +1,19 @@
+export function parseDf(cmd, args, raw) {
+    const lines = raw.split("\n").filter(Boolean);
+    const filesystems = [];
+    for (const line of lines.slice(1)) {
+        const parts = line.trim().split(/\s+/);
+        if (parts.length < 6)
+            continue;
+        filesystems.push({
+            filesystem: parts[0],
+            blocks_1k: parts[1],
+            used: parts[2],
+            available: parts[3],
+            use_percent: parts[4],
+            mounted_on: parts[5],
+        });
+    }
+    return { filesystems };
+}
+//# sourceMappingURL=df.js.map

package/dist/parsers/fs/df.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"df.js","sourceRoot":"","sources":["../../../src/parsers/fs/df.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW;IAC9D,MAAM,KAAK,GAAS,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,WAAW,GAAc,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC/B,WAAW,CAAC,IAAI,CAAC;YACf,UAAU,EAAG,KAAK,CAAC,CAAC,CAAC;YACrB,SAAS,EAAI,KAAK,CAAC,CAAC,CAAC;YACrB,IAAI,EAAS,KAAK,CAAC,CAAC,CAAC;YACrB,SAAS,EAAI,KAAK,CAAC,CAAC,CAAC;YACrB,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;YACrB,UAAU,EAAG,KAAK,CAAC,CAAC,CAAC;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,CAAC;AACzB,CAAC"}

package/dist/parsers/fs/du.d.ts

@@ -0,0 +1,8 @@
+export interface DuEntry {
+    size: string;
+    path: string;
+}
+export declare function parseDu(cmd: string, args: string[], raw: string): {
+    entries: DuEntry[];
+};
+//# sourceMappingURL=du.d.ts.map

package/dist/parsers/fs/du.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"du.d.ts","sourceRoot":"","sources":["../../../src/parsers/fs/du.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,EAAE,CAAA;CAAE,CAYxF"}

package/dist/parsers/fs/du.js

@@ -0,0 +1,13 @@
+export function parseDu(cmd, args, raw) {
+    const entries = [];
+    for (const line of raw.split("\n")) {
+        if (!line.trim())
+            continue;
+        const [size, ...rest] = line.split("\t");
+        if (size && rest.length) {
+            entries.push({ size: size.trim(), path: rest.join("\t").trim() });
+        }
+    }
+    return { entries };
+}
+//# sourceMappingURL=du.js.map

package/dist/parsers/fs/du.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"du.js","sourceRoot":"","sources":["../../../src/parsers/fs/du.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,OAAO,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW;IAC9D,MAAM,OAAO,GAAc,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC;AACrB,CAAC"}

package/dist/parsers/fs/find.d.ts

@@ -0,0 +1,4 @@
+export declare function parseFind(cmd: string, args: string[], raw: string): {
+    paths: string[];
+};
+//# sourceMappingURL=find.d.ts.map

package/dist/parsers/fs/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/parsers/fs/find.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAGvF"}