@nerdvana/parism 0.3.0 → 0.5.0

package/dist/index.js

@@ -2,14 +2,40 @@
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { createServer } from "./server.js";
 import { loadConfig } from "./config/loader.js";
+import { createRegistry } from "./parsers/index.js";
+import { createCli } from "./cli.js";
 import path from "node:path";
-async function main() {
+const CLI_COMMANDS = ["capture", "init-parser", "test", "add", "inspect", "help", "--help", "-h", "--version", "-V"];
+function isCliMode() {
+    const firstArg = process.argv[2];
+    return firstArg != null && CLI_COMMANDS.includes(firstArg);
+}
+async function startMcpServer() {
     const configPath = path.join(process.cwd(), "prism.config.json");
     const config = await loadConfig(configPath);
-    const server = createServer(config);
+    const registry = createRegistry();
+    const { loadExternalParsers } = await import("./cli/auto-loader.js");
+    const { parismHome } = await import("./cli/paths.js");
+    const loaded = await loadExternalParsers(parismHome(), registry);
+    if (loaded > 0) {
+        console.error(`[parism] Loaded ${loaded} external parser(s)`);
+    }
+    const server = createServer(config, registry);
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }
+async function startCli() {
+    const program = createCli();
+    await program.parseAsync(process.argv);
+}
+async function main() {
+    if (isCliMode()) {
+        await startCli();
+    }
+    else {
+        await startMcpServer();
+    }
+}
 main().catch((err) => {
     console.error("[parism] Fatal error:", err);
     process.exit(1);

package/dist/index.js.map

@@ -1 +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"}
+{"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,EAAE,cAAc,EAAE,MAAY,oBAAoB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAiB,UAAU,CAAC;AAChD,OAAO,IAAI,MAA0B,WAAW,CAAC;AAEjD,MAAM,YAAY,GAAG,CAAC,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;AAErH,SAAS,SAAS;IAChB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,QAAQ,IAAI,IAAI,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,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;IAChD,MAAM,QAAQ,GAAK,cAAc,EAAE,CAAC;IAEpC,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACrE,MAAM,EAAE,UAAU,EAAE,GAAY,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,UAAU,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjE,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,qBAAqB,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,MAAM,GAAM,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,SAAS,EAAE,EAAE,CAAC;QAChB,MAAM,QAAQ,EAAE,CAAC;IACnB,CAAC;SAAM,CAAC;QACN,MAAM,cAAc,EAAE,CAAC;IACzB,CAAC;AACH,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/index.d.ts

@@ -1,6 +1,12 @@
 import { ParserRegistry } from "./registry.js";
 /**
- * 전역 싱글턴 Parser Registry. 서버 시작 시 한 번 초기화된다.
+ * 44개 내장 파서가 등록된 새 ParserRegistry 인스턴스를 생성한다.
+ * 호출할 때마다 새 인스턴스를 반환하므로, 테스트나 CLI에서 독립적으로 사용 가능.
+ */
+export declare function createRegistry(): ParserRegistry;
+/**
+ * 하위 호환용 전역 싱글턴. 기존 server.ts import를 깨지 않기 위해 유지.
+ * @deprecated 신규 코드는 createRegistry()를 사용할 것.
  */
 export declare const defaultRegistry: ParserRegistry;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAmD,eAAe,CAAC;AAa5F;;GAEG;AACH,eAAO,MAAM,eAAe,gBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAmD,eAAe,CAAC;AAa5F;;;GAGG;AACH,wBAAgB,cAAc,IAAI,cAAc,CAyD/C;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,gBAAmB,CAAC"}

package/dist/parsers/index.js

@@ -10,62 +10,71 @@ import { parseDir, parseTasklist, parseIpconfig, parseSysteminfo } from "./windo
 import { parseKubectl, parseDocker, parseGh, parseHelm, parseTerraform } from "./devops/index.js";
 import { parseNpm, parseCargo } from "./packages/index.js";
 /**
- * 전역 싱글턴 Parser Registry. 서버 시작 시 한 번 초기화된다.
+ * 44개 내장 파서가 등록된 새 ParserRegistry 인스턴스를 생성한다.
+ * 호출할 때마다 새 인스턴스를 반환하므로, 테스트나 CLI에서 독립적으로 사용 가능.
  */
-export const defaultRegistry = new ParserRegistry();
-defaultRegistry.register("ls", parseLs);
-defaultRegistry.register("find", parseFind);
-defaultRegistry.register("stat", parseStat);
-defaultRegistry.register("du", parseDu);
-defaultRegistry.register("df", parseDf);
-defaultRegistry.register("tree", parseTree);
-defaultRegistry.register("ps", parsePs);
-defaultRegistry.register("kill", parseKill);
-defaultRegistry.register("ping", parsePing);
-defaultRegistry.register("curl", parseCurl);
-defaultRegistry.register("netstat", parseNetstat);
-defaultRegistry.register("lsof", parseLsof);
-defaultRegistry.register("ss", parseSs);
-defaultRegistry.register("dig", parseDig);
-defaultRegistry.register("grep", parseGrep);
-defaultRegistry.register("wc", parseWc);
-defaultRegistry.register("head", parseHead);
-defaultRegistry.register("tail", parseTail);
-defaultRegistry.register("cat", parseCat);
-defaultRegistry.register("env", parseEnv);
-defaultRegistry.register("pwd", parsePwd);
-defaultRegistry.register("which", parseWhich);
-defaultRegistry.register("free", parseFree);
-defaultRegistry.register("uname", parseUname);
-defaultRegistry.register("id", parseId);
-defaultRegistry.register("systemctl", parseSystemctl);
-defaultRegistry.register("journalctl", parseJournalctl);
-defaultRegistry.register("dir", parseDir);
-defaultRegistry.register("tasklist", parseTasklist);
-defaultRegistry.register("ipconfig", parseIpconfig);
-defaultRegistry.register("systeminfo", parseSysteminfo);
-defaultRegistry.register("kubectl", parseKubectl);
-defaultRegistry.register("docker", parseDocker);
-defaultRegistry.register("gh", parseGh);
-defaultRegistry.register("helm", parseHelm);
-defaultRegistry.register("terraform", parseTerraform);
-defaultRegistry.register("apt", parseApt);
-defaultRegistry.register("brew", parseBrew);
-defaultRegistry.register("npm", parseNpm);
-defaultRegistry.register("pnpm", parseNpm);
-defaultRegistry.register("yarn", parseNpm);
-defaultRegistry.register("cargo", parseCargo);
-// git은 서브커맨드 기반 — args[0]으로 파서를 선택
-defaultRegistry.register("git", (cmd, args, raw) => {
-    const sub = args[0];
-    if (sub === "status")
-        return parseGitStatus(cmd, args, raw);
-    if (sub === "log")
-        return parseGitLog(cmd, args, raw);
-    if (sub === "diff")
-        return parseGitDiff(cmd, args, raw);
-    if (sub === "branch")
-        return parseGitBranch(cmd, args, raw);
-    return null;
-});
+export function createRegistry() {
+    const registry = new ParserRegistry();
+    registry.register("ls", parseLs);
+    registry.register("find", parseFind);
+    registry.register("stat", parseStat);
+    registry.register("du", parseDu);
+    registry.register("df", parseDf);
+    registry.register("tree", parseTree);
+    registry.register("ps", parsePs);
+    registry.register("kill", parseKill);
+    registry.register("ping", parsePing);
+    registry.register("curl", parseCurl);
+    registry.register("netstat", parseNetstat);
+    registry.register("lsof", parseLsof);
+    registry.register("ss", parseSs);
+    registry.register("dig", parseDig);
+    registry.register("grep", parseGrep);
+    registry.register("wc", parseWc);
+    registry.register("head", parseHead);
+    registry.register("tail", parseTail);
+    registry.register("cat", parseCat);
+    registry.register("env", parseEnv);
+    registry.register("pwd", parsePwd);
+    registry.register("which", parseWhich);
+    registry.register("free", parseFree);
+    registry.register("uname", parseUname);
+    registry.register("id", parseId);
+    registry.register("systemctl", parseSystemctl);
+    registry.register("journalctl", parseJournalctl);
+    registry.register("dir", parseDir);
+    registry.register("tasklist", parseTasklist);
+    registry.register("ipconfig", parseIpconfig);
+    registry.register("systeminfo", parseSysteminfo);
+    registry.register("kubectl", parseKubectl);
+    registry.register("docker", parseDocker);
+    registry.register("gh", parseGh);
+    registry.register("helm", parseHelm);
+    registry.register("terraform", parseTerraform);
+    registry.register("apt", parseApt);
+    registry.register("brew", parseBrew);
+    registry.register("npm", parseNpm);
+    registry.register("pnpm", parseNpm);
+    registry.register("yarn", parseNpm);
+    registry.register("cargo", parseCargo);
+    // git은 서브커맨드 기반 — args[0]으로 파서를 선택
+    registry.register("git", (cmd, args, raw) => {
+        const sub = args[0];
+        if (sub === "status")
+            return parseGitStatus(cmd, args, raw);
+        if (sub === "log")
+            return parseGitLog(cmd, args, raw);
+        if (sub === "diff")
+            return parseGitDiff(cmd, args, raw);
+        if (sub === "branch")
+            return parseGitBranch(cmd, args, raw);
+        return null;
+    });
+    return registry;
+}
+/**
+ * 하위 호환용 전역 싱글턴. 기존 server.ts import를 깨지 않기 위해 유지.
+ * @deprecated 신규 코드는 createRegistry()를 사용할 것.
+ */
+export const defaultRegistry = createRegistry();
 //# sourceMappingURL=index.js.map

package/dist/parsers/index.js.map

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

package/dist/parsers/registry.d.ts

@@ -17,17 +17,66 @@ export interface ParseContext {
  * 파서 함수 시그니처.
  */
 export type ParserFn = (cmd: string, args: string[], raw: string, ctx?: ParseContext) => unknown;
+/**
+ * Fixture: 파서 검증용 입출력 쌍.
+ */
+export interface Fixture {
+    input: string;
+    args: string[];
+    expected: unknown;
+}
+/**
+ * 파서 팩: 명령어 파서의 완전한 정의.
+ * name     -- 대상 명령어 (예: "htop")
+ * parse    -- raw stdout + args -> 구조화된 결과 (null이면 파싱 불가)
+ * schema   -- 출력 JSON 스키마 (검증/문서 용도)
+ * fixtures -- 입출력 쌍 (테스트/검증 용도)
+ * meta     -- 선택적 메타 정보
+ */
+export interface ParserPack {
+    name: string;
+    parse: (raw: string, args: string[], ctx?: ParseContext) => unknown;
+    schema: Record<string, unknown>;
+    fixtures: Fixture[];
+    meta?: {
+        os?: string[];
+        version?: string;
+    };
+}
+/**
+ * 파서 실행 결과. parsed가 null일 때 parse_error가 있으면 파서 예외, 없으면 파서 없음.
+ */
+export interface ParseResult {
+    parsed: unknown | null;
+    parse_error?: {
+        reason: "parser_exception";
+        message: string;
+    };
+}
 /**
  * 명령어 → 파서 함수의 매핑 테이블.
- * 파서가 없거나 실패하면 null을 반환한다 (graceful degradation).
+ * 파서가 없으면 parsed=null. 파서가 예외를 던지면 parsed=null, parse_error 설정.
  */
 export declare class ParserRegistry {
     private readonly parsers;
+    private readonly packs;
     register(cmd: string, fn: ParserFn): void;
+    /**
+     * ParserPack을 등록한다. parsers Map에도 어댑터를 등록하여 기존 parse() 경로와 호환.
+     */
+    registerPack(pack: ParserPack): void;
+    /**
+     * 등록된 ParserPack을 이름으로 조회한다.
+     */
+    getPack(name: string): ParserPack | undefined;
+    /**
+     * 등록된 모든 ParserPack 이름 목록을 반환한다.
+     */
+    listPacks(): string[];
     /**
      * cmd에 등록된 파서를 찾아 실행한다.
-     * 파서 없음 또는 예외 → null 반환.
+     * 파서 없음 → { parsed: null }. 파서 예외 → { parsed: null, parse_error }.
      */
-    parse(cmd: string, args: string[], raw: string, ctx?: ParseContext): unknown | null;
+    parse(cmd: string, args: string[], raw: string, ctx?: ParseContext): ParseResult;
 }
 //# sourceMappingURL=registry.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/parsers/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAI,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;AAEjG;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IAEvD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI;IAIzC;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,OAAO,GAAG,IAAI;CAUpF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/parsers/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAI,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;AAEjG;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAK,MAAM,CAAC;IACjB,IAAI,EAAM,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAO,MAAM,CAAC;IAClB,KAAK,EAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACxE,MAAM,EAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,EAAG,OAAO,EAAE,CAAC;IACrB,IAAI,CAAC,EAAM;QAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAO,OAAO,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE;QAAE,MAAM,EAAE,kBAAkB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmC;IAEzD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,IAAI;IAIzC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAKpC;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI7C;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;;OAGG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,GAAG,WAAW;CAYjF"}

package/dist/parsers/registry.js

@@ -1,25 +1,47 @@
 /**
  * 명령어 → 파서 함수의 매핑 테이블.
- * 파서가 없거나 실패하면 null을 반환한다 (graceful degradation).
+ * 파서가 없으면 parsed=null. 파서가 예외를 던지면 parsed=null, parse_error 설정.
  */
 export class ParserRegistry {
     parsers = new Map();
+    packs = new Map();
     register(cmd, fn) {
         this.parsers.set(cmd, fn);
     }
+    /**
+     * ParserPack을 등록한다. parsers Map에도 어댑터를 등록하여 기존 parse() 경로와 호환.
+     */
+    registerPack(pack) {
+        this.packs.set(pack.name, pack);
+        this.parsers.set(pack.name, (_cmd, args, raw, ctx) => pack.parse(raw, args, ctx));
+    }
+    /**
+     * 등록된 ParserPack을 이름으로 조회한다.
+     */
+    getPack(name) {
+        return this.packs.get(name);
+    }
+    /**
+     * 등록된 모든 ParserPack 이름 목록을 반환한다.
+     */
+    listPacks() {
+        return [...this.packs.keys()];
+    }
     /**
      * cmd에 등록된 파서를 찾아 실행한다.
-     * 파서 없음 또는 예외 → null 반환.
+     * 파서 없음 → { parsed: null }. 파서 예외 → { parsed: null, parse_error }.
      */
     parse(cmd, args, raw, ctx) {
         const fn = this.parsers.get(cmd);
         if (!fn)
-            return null;
+            return { parsed: null };
         try {
-            return fn(cmd, args, raw, ctx);
+            const parsed = fn(cmd, args, raw, ctx);
+            return { parsed: parsed ?? null };
         }
-        catch {
-            return null;
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { parsed: null, parse_error: { reason: "parser_exception", message } };
         }
     }
 }

package/dist/parsers/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/parsers/registry.ts"],"names":[],"mappings":"AAsBA;;;GAGG;AACH,MAAM,OAAO,cAAc;IACR,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IAEvD,QAAQ,CAAC,GAAW,EAAE,EAAY;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW,EAAE,GAAkB;QAChE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAErB,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/parsers/registry.ts"],"names":[],"mappings":"AAuDA;;;GAGG;AACH,MAAM,OAAO,cAAc;IACR,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IACtC,KAAK,GAAK,IAAI,GAAG,EAAsB,CAAC;IAEzD,QAAQ,CAAC,GAAW,EAAE,EAAY;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,IAAgB;QAC3B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACpF,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAW,EAAE,IAAc,EAAE,GAAW,EAAE,GAAkB;QAChE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;YACvC,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,EAAE,CAAC;QAChF,CAAC;IACH,CAAC;CACF"}

package/dist/server.d.ts

@@ -1,19 +1,20 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { PrismConfig } from "./config/loader.js";
+import type { ParserRegistry } from "./parsers/registry.js";
 import type { OutputFormat } from "./parsers/registry.js";
-export declare const PACKAGE_VERSION = "0.3.0";
+export declare const PACKAGE_VERSION = "0.5.0";
 /**
  * Guard 검사 → 실행 → JSON 직렬화까지의 파이프라인.
  * MCP 서버와 테스트 코드가 공통으로 사용한다.
  */
-export declare function buildRunResult(cmd: string, args: string[], cwd: string, config: PrismConfig, format?: OutputFormat): Promise<string>;
+export declare function buildRunResult(cmd: string, args: string[], cwd: string, config: PrismConfig, registry: ParserRegistry, format?: OutputFormat, includeDiff?: boolean): Promise<string>;
 /**
  * Guard 검사 → 실행 → 페이지 분할 → JSON 직렬화.
  * parsed는 항상 null (부분 출력은 구조화 파싱 불가).
  */
-export declare function buildPagedResult(cmd: string, args: string[], cwd: string, page: number, pageSize: number, config: PrismConfig): Promise<string>;
+export declare function buildPagedResult(cmd: string, args: string[], cwd: string, page: number, pageSize: number, config: PrismConfig, includeDiff?: boolean): Promise<string>;
 /**
  * MCP 서버를 생성하고 `run` 도구를 등록한다.
  */
-export declare function createServer(config: PrismConfig): McpServer;
+export declare function createServer(config: PrismConfig, registry: ParserRegistry): McpServer;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAY,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAW,uBAAuB,CAAC;AAI/D,eAAO,MAAM,eAAe,UAAU,CAAC;AAsBvC;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAK,MAAM,EACd,IAAI,EAAI,MAAM,EAAE,EAChB,GAAG,EAAK,MAAM,EACd,MAAM,EAAE,WAAW,EACnB,MAAM,GAAE,YAAqB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAuBjB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAO,MAAM,EAChB,IAAI,EAAM,MAAM,EAAE,EAClB,GAAG,EAAO,MAAM,EAChB,IAAI,EAAM,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAI,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,CAuBjB;AA2BD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CA8C3D"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAY,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAQ,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAW,uBAAuB,CAAC;AAI/D,eAAO,MAAM,eAAe,UAAU,CAAC;AAsBvC;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAU,MAAM,EACnB,IAAI,EAAS,MAAM,EAAE,EACrB,GAAG,EAAU,MAAM,EACnB,MAAM,EAAO,WAAW,EACxB,QAAQ,EAAK,cAAc,EAC3B,MAAM,GAAO,YAAqB,EAClC,WAAW,GAAE,OAAkB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAyBjB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAU,MAAM,EACnB,IAAI,EAAS,MAAM,EAAE,EACrB,GAAG,EAAU,MAAM,EACnB,IAAI,EAAS,MAAM,EACnB,QAAQ,EAAK,MAAM,EACnB,MAAM,EAAO,WAAW,EACxB,WAAW,GAAE,OAAc,GAC1B,OAAO,CAAC,MAAM,CAAC,CAwBjB;AA2BD;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,GAAG,SAAS,CAkDrF"}

package/dist/server.js

@@ -2,11 +2,10 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 import { execute } from "./engine/executor.js";
 import { checkGuard, GuardError } from "./engine/guard.js";
-import { defaultRegistry } from "./parsers/index.js";
 import { paginateLines } from "./engine/paginator.js";
 import { toCompact } from "./parsers/compact.js";
 import { tryParseNativeJson } from "./parsers/json-passthrough.js";
-export const PACKAGE_VERSION = "0.3.0";
+export const PACKAGE_VERSION = "0.5.0";
 /**
  * Guard 차단 시 반환하는 에러 봉투를 생성한다.
  */
@@ -28,7 +27,7 @@ function buildGuardErrorEnvelope(cmd, args, cwd, err) {
  * Guard 검사 → 실행 → JSON 직렬화까지의 파이프라인.
  * MCP 서버와 테스트 코드가 공통으로 사용한다.
  */
-export async function buildRunResult(cmd, args, cwd, config, format = "json") {
+export async function buildRunResult(cmd, args, cwd, config, registry, format = "json", includeDiff = true) {
     try {
         checkGuard(cmd, args, cwd, config);
     }
@@ -37,15 +36,16 @@ export async function buildRunResult(cmd, args, cwd, config, format = "json") {
             return buildGuardErrorEnvelope(cmd, args, cwd, err);
         throw err;
     }
-    const envelope = await execute(cmd, args, cwd, config.guard.env_secret_patterns, config.guard.timeout_ms, config.guard.max_output_bytes);
+    const envelope = await execute(cmd, args, cwd, config.guard.env_secret_patterns, config.guard.timeout_ms, config.guard.max_output_bytes, includeDiff);
     const parseFormat = format === "json-no-raw" ? "json" : format;
-    let parsed = defaultRegistry.parse(cmd, args, envelope.stdout.raw, { maxItems: config.guard.max_items, format: parseFormat });
+    const parseResult = registry.parse(cmd, args, envelope.stdout.raw, { maxItems: config.guard.max_items, format: parseFormat });
+    let parsed = parseResult.parsed;
     if (parsed == null)
         parsed = tryParseNativeJson(envelope.stdout.raw);
     const final = parseFormat === "compact" ? toCompact(parsed) : parsed;
     const stdout = format === "json-no-raw"
-        ? { raw: "", parsed: final }
-        : { ...envelope.stdout, parsed: final };
+        ? { raw: "", parsed: final, ...(parseResult.parse_error && { parse_error: parseResult.parse_error }) }
+        : { ...envelope.stdout, parsed: final, ...(parseResult.parse_error && { parse_error: parseResult.parse_error }) };
     const enriched = { ...envelope, stdout };
     return JSON.stringify(enriched, null, 2);
 }
@@ -53,7 +53,7 @@ export async function buildRunResult(cmd, args, cwd, config, format = "json") {
  * Guard 검사 → 실행 → 페이지 분할 → JSON 직렬화.
  * parsed는 항상 null (부분 출력은 구조화 파싱 불가).
  */
-export async function buildPagedResult(cmd, args, cwd, page, pageSize, config) {
+export async function buildPagedResult(cmd, args, cwd, page, pageSize, config, includeDiff = true) {
     try {
         checkGuard(cmd, args, cwd, config);
     }
@@ -63,7 +63,7 @@ export async function buildPagedResult(cmd, args, cwd, page, pageSize, config) {
         throw err;
     }
     // 전체 stdout이 필요하므로 max_output_bytes 비활성 (0)
-    const envelope = await execute(cmd, args, cwd, config.guard.env_secret_patterns, config.guard.timeout_ms, 0);
+    const envelope = await execute(cmd, args, cwd, config.guard.env_secret_patterns, config.guard.timeout_ms, 0, includeDiff);
     const { lines, page_info } = paginateLines(envelope.stdout.raw, page, pageSize);
     const pagedRaw = lines.join("\n") + (lines.length > 0 ? "\n" : "");
     const enriched = {
@@ -100,7 +100,7 @@ Usage:
 /**
  * MCP 서버를 생성하고 `run` 도구를 등록한다.
  */
-export function createServer(config) {
+export function createServer(config, registry) {
     const server = new McpServer({ name: "parism", version: PACKAGE_VERSION }, { instructions: MCP_INSTRUCTIONS });
     server.tool("run", "Execute a shell command and receive structured output. " +
         "All commands are filtered through an execution guard (whitelist + injection prevention). " +
@@ -110,8 +110,10 @@ export function createServer(config) {
         cwd: z.string().default(process.cwd()).describe("Working directory"),
         format: z.enum(["json", "compact", "json-no-raw"]).default("json")
             .describe("Output format. 'compact'=columnar. 'json-no-raw'=omit raw for token savings."),
-    }, async ({ cmd, args, cwd, format }) => {
-        const result = await buildRunResult(cmd, args, cwd, config, format);
+        includeDiff: z.boolean().default(false)
+            .describe("Include filesystem diff (created/deleted/modified). false=skip snapshot, lower latency."),
+    }, async ({ cmd, args, cwd, format, includeDiff }) => {
+        const result = await buildRunResult(cmd, args, cwd, config, registry, format, includeDiff);
         return {
             content: [{ type: "text", text: result }],
         };
@@ -125,8 +127,10 @@ export function createServer(config) {
         page: z.number().int().min(0).default(0).describe("Page index (0-based)"),
         page_size: z.number().int().min(1).default(config.guard.default_page_size)
             .describe("Lines per page"),
-    }, async ({ cmd, args, cwd, page, page_size }) => {
-        const result = await buildPagedResult(cmd, args, cwd, page, page_size, config);
+        includeDiff: z.boolean().default(false)
+            .describe("Include filesystem diff. false=skip snapshot, lower latency."),
+    }, async ({ cmd, args, cwd, page, page_size, includeDiff }) => {
+        const result = await buildPagedResult(cmd, args, cwd, page, page_size, config, includeDiff);
         return { content: [{ type: "text", text: result }] };
     });
     return server;

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAc,KAAK,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAqB,sBAAsB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAe,uBAAuB,CAAC;AAI/D,OAAO,EAAE,SAAS,EAAE,MAAmB,sBAAsB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAS,+BAA+B,CAAC;AAEtE,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC;;GAEG;AACH,SAAS,uBAAuB,CAC9B,GAAW,EAAE,IAAc,EAAE,GAAW,EAAE,GAAe;IAEzD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,EAAE,EAAW,KAAK;QAClB,QAAQ,EAAK,CAAC,CAAC;QACf,GAAG;QACH,IAAI;QACJ,GAAG;QACH,WAAW,EAAE,CAAC;QACd,MAAM,EAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;QACtC,MAAM,EAAO,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAC/C,IAAI,EAAS,IAAI;QACjB,WAAW,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;KAC1D,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAmB,EACnB,IAAqB,EACrB,GAAmB,EACnB,MAAwB,EACxB,QAA2B,EAC3B,SAA4B,MAAM,EAClC,cAA2B,IAAI;IAE/B,IAAI,CAAC;QACH,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,UAAU;YAAE,OAAO,uBAAuB,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACnF,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAC5B,GAAG,EAAE,IAAI,EAAE,GAAG,EACd,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAChC,MAAM,CAAC,KAAK,CAAC,UAAU,EACvB,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAC7B,WAAW,CACZ,CAAC;IACF,MAAM,WAAW,GAAI,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAChE,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9H,IAAI,MAAM,GAAU,WAAW,CAAC,MAAM,CAAC;IACvC,IAAI,MAAM,IAAI,IAAI;QAAE,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACrE,MAAM,KAAK,GAAS,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3E,MAAM,MAAM,GAAQ,MAAM,KAAK,aAAa;QAC1C,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,EAAE;QACtG,CAAC,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;IACpH,MAAM,QAAQ,GAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAmB,EACnB,IAAqB,EACrB,GAAmB,EACnB,IAAmB,EACnB,QAAmB,EACnB,MAAwB,EACxB,cAAuB,IAAI;IAE3B,IAAI,CAAC;QACH,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,UAAU;YAAE,OAAO,uBAAuB,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACnF,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,4CAA4C;IAC5C,MAAM,QAAQ,GAAiB,MAAM,OAAO,CAC1C,GAAG,EAAE,IAAI,EAAE,GAAG,EACd,MAAM,CAAC,KAAK,CAAC,mBAAmB,EAChC,MAAM,CAAC,KAAK,CAAC,UAAU,EACvB,CAAC,EACD,WAAW,CACZ,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAK,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAiB;QAC7B,GAAG,QAAQ;QACX,MAAM,EAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QAC1C,SAAS;KACV,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;wFAuB+D,CAAC;AAEzF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB,EAAE,QAAwB;IACxE,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,EAC5C,EAAE,YAAY,EAAE,gBAAgB,EAAE,CACnC,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,KAAK,EACL,yDAAyD;QACzD,2FAA2F;QAC3F,2DAA2D,EAC3D;QACE,GAAG,EAAU,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACnE,IAAI,EAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC1E,GAAG,EAAU,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC5E,MAAM,EAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;aACzD,QAAQ,CAAC,8EAA8E,CAAC;QACtG,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;aACzB,QAAQ,CAAC,yFAAyF,CAAC;KAClH,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE;QAChD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3F,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SACnD,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,WAAW,EACX,uDAAuD;QACvD,mEAAmE;QACnE,iEAAiE,EACjE;QACE,GAAG,EAAU,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QAChD,IAAI,EAAS,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC1E,GAAG,EAAU,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAC5E,IAAI,EAAS,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QAChF,SAAS,EAAI,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC;aAC9D,QAAQ,CAAC,gBAAgB,CAAC;QACxC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;aACzB,QAAQ,CAAC,8DAA8D,CAAC;KACvF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE;QACzD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5F,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAChE,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/types/envelope.d.ts

@@ -1,9 +1,18 @@
+/**
+ * 파서 예외 정보. 파서가 예외를 던졌을 때만 존재. "파서 없음"과 "파서 버그"를 구분한다.
+ */
+export interface ParseErrorField {
+    reason: "parser_exception";
+    message: string;
+}
 /**
  * 명령 stdout/stderr 필드. raw는 항상 보존되고, parsed는 파서 존재 시 채워진다.
+ * parse_error는 파서가 예외를 던졌을 때만 존재한다 (파서 없음과 구분).
  */
 export interface OutputField {
     raw: string;
     parsed: unknown | null;
+    parse_error?: ParseErrorField;
 }
 export type StdoutField = OutputField;
 /**

package/dist/types/envelope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/types/envelope.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAK,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACxB;AAGD,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAG,MAAM,EAAE,CAAC;IACnB,OAAO,EAAG,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAS,MAAM,CAAC;IACpB,SAAS,EAAI,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAK,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAW,OAAO,CAAC;IACrB,QAAQ,EAAK,MAAM,CAAC;IACpB,GAAG,EAAU,MAAM,CAAC;IACpB,IAAI,EAAS,MAAM,EAAE,CAAC;IACtB,GAAG,EAAU,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAO,WAAW,CAAC;IACzB,MAAM,EAAO,WAAW,CAAC;IACzB,IAAI,EAAS,SAAS,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAG,OAAO,CAAC;IACrB,SAAS,CAAC,EAAG,QAAQ,CAAC;CACvB"}
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../src/types/envelope.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAG,kBAAkB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAU,MAAM,CAAC;IACpB,MAAM,EAAO,OAAO,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAGD,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAEtC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAG,MAAM,EAAE,CAAC;IACnB,OAAO,EAAG,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAS,MAAM,CAAC;IACpB,SAAS,EAAI,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAK,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAW,OAAO,CAAC;IACrB,QAAQ,EAAK,MAAM,CAAC;IACpB,GAAG,EAAU,MAAM,CAAC;IACpB,IAAI,EAAS,MAAM,EAAE,CAAC;IACtB,GAAG,EAAU,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAO,WAAW,CAAC;IACzB,MAAM,EAAO,WAAW,CAAC;IACzB,IAAI,EAAS,SAAS,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAG,OAAO,CAAC;IACrB,SAAS,CAAC,EAAG,QAAQ,CAAC;CACvB"}

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@nerdvana/parism",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Structured shell output wrapper for AI agents",
   "type": "module",
   "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./types": "./dist/parsers/registry.js"
+  },
   "bin": {
     "parism": "dist/index.js"
   },
@@ -19,6 +23,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.10.0",
+    "commander": "^14.0.3",
     "zod": "^3.24.0"
   },
   "devDependencies": {

package/prism.config.json

@@ -15,12 +15,15 @@
       "terraform", "helm", "cargo",
       "systemctl", "journalctl", "apt", "brew"
     ],
-    "allowed_paths": [],
+    "allowed_paths": ["./"],
     "timeout_ms": 10000,
     "block_patterns": [";", "$(", "`", "&&", "||", ">", ">>", "<", "|"],
     "command_arg_restrictions": {
       "node": { "blocked_flags": ["-e", "--eval", "-r", "--require", "-p", "--print", "--input-type"] },
-      "npx":  { "blocked_flags": ["--yes", "-y"] }
+      "npx":  { "blocked_flags": ["--yes", "-y"] },
+      "curl": {
+        "blocked_flags": ["-d", "--data", "-F", "--upload-file", "-T", "-K", "--config", "-o", "--output", "-O"]
+      }
     },
     "env_secret_patterns": [
       "TOKEN", "SECRET", "AUTHZ", "PASSWORD", "PASSWD", "CREDENTIAL"