@vordsec/cli 0.1.0

package/dist/report/scan.js

@@ -0,0 +1,170 @@
+import { SEVERITY, skipSummary } from '@vordsec/core';
+const at = (f) => where(f.location);
+/**
+ * `경로:줄`. **확인 불가도 같은 형식으로 쓴다** — 취약과 톤은 다르지만
+ * *"어디를 봐야 하는가"* 는 똑같이 필요하다 (B-10 실측: 없으면 사용자가
+ * `howToCheck` 문장을 끝까지 읽어야 파일 이름을 안다).
+ */
+const where = (loc) => loc === undefined ? '' : `${loc.path}${loc.line === undefined ? '' : `:${loc.line}`}`;
+const label = (s) => `${SEVERITY[s].label}(LV${SEVERITY[s].lv})`;
+const ORDER = ['CRITICAL', 'DANGER', 'CAUTION', 'POTENTIAL', 'POTENTIAL_LOW'];
+function bySeverity(a, b) {
+    const d = ORDER.indexOf(a.severity) - ORDER.indexOf(b.severity);
+    return d !== 0 ? d : (at(a) < at(b) ? -1 : 1);
+}
+// ────────────────────────────────── pretty
+export function renderPretty(out) {
+    const { report } = out;
+    const lines = [];
+    const findings = [...report.findings].sort(bySeverity);
+    for (const f of findings) {
+        lines.push(`${f.cross === undefined ? '✗' : '↳'} ${f.rule} ${label(f.severity)}  ${at(f)}`);
+        lines.push(`    ${f.message}`);
+        if (f.fix !== undefined && f.fix !== '')
+            lines.push(`    고치는 법: ${f.fix}`);
+        lines.push('');
+    }
+    if (report.unknowns.length > 0) {
+        // **문구를 취약과 분리한다** — 판정 못 함이 아니라 "코드 밖에 근거가 있다" 다
+        lines.push('확인 불가 — 코드만으로는 판정되지 않는다. 위험하다는 뜻이 아니다.');
+        for (const u of report.unknowns) {
+            // 자리가 있으면 **먼저** 보인다. 근거가 코드 밖이면(대시보드·콘솔) 없는 것이 맞다
+            const spot = where(u.location);
+            lines.push(`  ? ${u.rule}  ${spot === '' ? '' : `${spot}  `}${u.reason}`);
+            lines.push(`      확인 방법: ${u.howToCheck}`);
+        }
+        lines.push('');
+    }
+    if (report.notApplicable.length > 0) {
+        lines.push(`해당 없음: ${report.notApplicable.join(' · ')} (판정할 것이 없다)`);
+    }
+    const skips = skipSummary(report.skipped);
+    const skipped = Object.entries(skips).filter(([, n]) => n > 0);
+    if (skipped.length > 0) {
+        // 계약 4 — **반드시 표시한다**
+        lines.push(`건너뜀: ${skipped.map(([k, n]) => `${k} ${n}`).join(' · ')}`);
+    }
+    if (out.suppressed.length > 0) {
+        lines.push(`무시 규칙으로 뺀 것: ${out.suppressed.length}건 (\`vord ignore list\` 로 확인)`);
+    }
+    if (report.failures.length > 0) {
+        lines.push(`룰 오류: ${report.failures.map((f) => `${f.rule}(${f.error})`).join(' · ')}`);
+    }
+    const counts = findings.length === 0
+        ? '취약 0건'
+        : `취약 ${findings.length}건`;
+    lines.push(`${counts} · 확인 불가 ${report.unknowns.length}건 — ${out.root}`);
+    return lines;
+}
+// ────────────────────────────────── json
+export function renderJson(out) {
+    const { report } = out;
+    return [JSON.stringify({
+            root: out.root,
+            findings: report.findings.map((f) => ({
+                rule: f.rule,
+                severity: f.severity,
+                lv: SEVERITY[f.severity].lv,
+                path: f.location.path,
+                line: f.location.line,
+                message: f.message,
+                fix: f.fix,
+                flags: f.flags ?? [],
+                cross: f.cross ?? [],
+            })),
+            unknowns: report.unknowns.map((u) => ({
+                rule: u.rule,
+                // **기계용 출력에도 자리를 싣는다** — 없으면 소비자가 문장을 파싱해야 한다
+                path: u.location?.path ?? null,
+                line: u.location?.line ?? null,
+                reason: u.reason,
+                howToCheck: u.howToCheck,
+                flags: u.flags ?? [],
+            })),
+            notApplicable: report.notApplicable,
+            suppressed: out.suppressed.map((f) => ({ rule: f.rule, path: f.location.path })),
+            skipped: skipSummary(report.skipped),
+            failures: report.failures,
+        })];
+}
+// ────────────────────────────────── sarif
+/** SARIF 는 세 등급뿐이다. LV1·2 → error · LV3 → warning · 그 아래 → note */
+function sarifLevel(s) {
+    if (s === 'CRITICAL' || s === 'DANGER')
+        return 'error';
+    if (s === 'CAUTION')
+        return 'warning';
+    return 'note';
+}
+const location = (path, line) => ({
+    physicalLocation: {
+        artifactLocation: { uri: path },
+        ...(line === undefined ? {} : { region: { startLine: line } }),
+    },
+});
+/**
+ * SARIF 2.1.0. GitHub code scanning 이 읽는 형식이다.
+ *
+ * **확인 불가도 싣는다** — `note` 등급에 `vord.verdict: unknown` 을 붙인다.
+ * 안 실으면 "검사했는데 아무것도 없었다" 와 구분이 안 된다.
+ */
+export function renderSarif(out, version = '0.0.0') {
+    const { report } = out;
+    const ruleIds = [...new Set([
+            ...report.findings.map((f) => f.rule),
+            ...report.unknowns.map((u) => u.rule),
+        ])].sort();
+    const results = [
+        ...report.findings.map((f) => ({
+            ruleId: f.rule,
+            level: sarifLevel(f.severity),
+            message: { text: f.fix === undefined ? f.message : `${f.message}\n\n고치는 법: ${f.fix}` },
+            locations: [location(f.location.path, f.location.line)],
+            properties: {
+                'vord.severity': f.severity,
+                'vord.lv': SEVERITY[f.severity].lv,
+                'vord.flags': f.flags ?? [],
+                ...(f.cross === undefined ? {} : { 'vord.cross': f.cross }),
+            },
+        })),
+        ...report.unknowns.map((u) => ({
+            ruleId: u.rule,
+            level: 'note',
+            message: { text: `확인 불가 — ${u.reason}\n\n확인 방법: ${u.howToCheck}` },
+            // **자리가 있으면 그 파일에 붙인다.** 예전엔 전부 `.` 로 나가 code scanning 에서
+            // 확인 불가가 통째로 레포 루트에 뭉쳤다 — 삼항의 양쪽이 같은 값이었다 (B-10)
+            locations: [u.location === undefined
+                    ? location('.')
+                    : location(u.location.path, u.location.line)],
+            properties: { 'vord.verdict': 'unknown', 'vord.flags': u.flags ?? [] },
+        })),
+    ];
+    return [JSON.stringify({
+            $schema: 'https://json.schemastore.org/sarif-2.1.0.json',
+            version: '2.1.0',
+            runs: [{
+                    tool: {
+                        driver: {
+                            name: 'Vord',
+                            version,
+                            informationUri: 'https://github.com/createrman343212/Vord',
+                            rules: ruleIds.map((id) => ({ id, name: id })),
+                        },
+                    },
+                    results,
+                    invocations: [{
+                            executionSuccessful: report.failures.length === 0,
+                            // 계약 4 — 건너뛴 파일은 리포트에 남는다
+                            properties: { 'vord.skipped': skipSummary(report.skipped) },
+                        }],
+                }],
+        })];
+}
+export function renderScan(out, format, version) {
+    if (format === 'json')
+        return renderJson(out);
+    if (format === 'sarif')
+        return renderSarif(out, version);
+    return renderPretty(out);
+}
+//# sourceMappingURL=scan.js.map

package/dist/report/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/report/scan.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAUtD,MAAM,EAAE,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,KAAK,GAAG,CAAC,GAAkE,EAAU,EAAE,CAC3F,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;AAExF,MAAM,KAAK,GAAG,CAAC,CAAW,EAAU,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;AAEnF,MAAM,KAAK,GAAwB,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;AAEnG,SAAS,UAAU,CAAC,CAAU,EAAE,CAAU;IACxC,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAChE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,4CAA4C;AAE5C,MAAM,UAAU,YAAY,CAAC,GAAe;IAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACvB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEvD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC5F,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,EAAE;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,kDAAkD;QAClD,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACrD,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAChC,mDAAmD;YACnD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC1E,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,sBAAsB;QACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,gBAAgB,GAAG,CAAC,UAAU,CAAC,MAAM,+BAA+B,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC;QAClC,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,GAAG,CAAC;IAC7B,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,YAAY,MAAM,CAAC,QAAQ,CAAC,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0CAA0C;AAE1C,MAAM,UAAU,UAAU,CAAC,GAAe;IACxC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;YACrB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE;gBAC3B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI;gBACrB,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI;gBACrB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;gBACpB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;aACrB,CAAC,CAAC;YACH,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACpC,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,8CAA8C;gBAC9C,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,IAAI,IAAI;gBAC9B,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,IAAI,IAAI;gBAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;aACrB,CAAC,CAAC;YACH,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAChF,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC;YACpC,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC,CAAC;AACN,CAAC;AAED,2CAA2C;AAE3C,mEAAmE;AACnE,SAAS,UAAU,CAAC,CAAW;IAC7B,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IACvD,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtC,OAAO,MAAM,CAAC;AAChB,CAAC;AAUD,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,IAAa,EAAE,EAAE,CAAC,CAAC;IACjD,gBAAgB,EAAE;QAChB,gBAAgB,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE;QAC/B,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;KAC/D;CACF,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAe,EAAE,OAAO,GAAG,OAAO;IAC5D,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACvB,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC;YAC1B,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACrC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SACtC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEX,MAAM,OAAO,GAAkB;QAC7B,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,MAAM,EAAE,CAAC,CAAC,IAAI;YACd,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC7B,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,cAAc,CAAC,CAAC,GAAG,EAAE,EAAE;YACtF,SAAS,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACvD,UAAU,EAAE;gBACV,eAAe,EAAE,CAAC,CAAC,QAAQ;gBAC3B,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE;gBAClC,YAAY,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;gBAC3B,GAAG,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;aAC5D;SACF,CAAC,CAAC;QACH,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,MAAM,EAAE,CAAC,CAAC,IAAI;YACd,KAAK,EAAE,MAAe;YACtB,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,MAAM,cAAc,CAAC,CAAC,UAAU,EAAE,EAAE;YAClE,0DAA0D;YAC1D,iDAAiD;YACjD,SAAS,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS;oBAClC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;oBACf,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC/C,UAAU,EAAE,EAAE,cAAc,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE;SACvE,CAAC,CAAC;KACJ,CAAC;IAEF,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;YACrB,OAAO,EAAE,+CAA+C;YACxD,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,CAAC;oBACL,IAAI,EAAE;wBACJ,MAAM,EAAE;4BACN,IAAI,EAAE,MAAM;4BACZ,OAAO;4BACP,cAAc,EAAE,0CAA0C;4BAC1D,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;yBAC/C;qBACF;oBACD,OAAO;oBACP,WAAW,EAAE,CAAC;4BACZ,mBAAmB,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;4BACjD,0BAA0B;4BAC1B,UAAU,EAAE,EAAE,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;yBAC5D,CAAC;iBACH,CAAC;SACH,CAAC,CAAC,CAAC;AACN,CAAC;AAID,MAAM,UAAU,UAAU,CAAC,GAAe,EAAE,MAAkB,EAAE,OAAgB;IAC9E,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACzD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/shim/artifacts.d.ts

@@ -0,0 +1,54 @@
+/**
+ * PATH shim 아티팩트 생성 — ADR-026.
+ *
+ * **확장자별로 파일이 따로 필요하고, 없으면 조용히 통과한다.**
+ * 실측에서 `npm` 만 두고 `node -e "execSync('npm install axios')"` 를 돌리니
+ * `added 27 packages` 가 그대로 나왔다. Node 의 `execSync` 는 Windows 에서 cmd.exe 를 쓰고
+ * cmd.exe 는 `PATHEXT` 로 해석하기 때문이다. `npm.cmd` 를 넣으니 걸렸다.
+ * **게이트가 조용히 통과시키는 실패 모드**라 가장 위험하다 — 사용자는 켜 뒀다고 믿는다.
+ *
+ * 순수 함수다. 파일을 쓰지 않는다 — 내용만 만든다.
+ *
+ * **모든 래퍼는 자기가 못 뜨면 원본으로 넘긴다.** 깨진 shim 을 넣고 재보니 종료코드 127 로
+ * npm 이 전부 죽었다. 그건 fail-closed 가 아니라 **툴체인 브릭**이고, 브릭을 겪은 사용자는
+ * shim 을 지운다 — 영구 우회가 된다.
+ */
+/** Phase 1 대상. 데이터셋 기준 JS 레포 71개 중 70개(99%)가 이 둘이다 */
+export declare const SHIM_MANAGERS: readonly ["npm", "pnpm"];
+export type ShimManager = typeof SHIM_MANAGERS[number];
+/** 확장자별 3종. 하나라도 빠지면 그 경로가 조용히 통과한다 */
+export declare const SHIM_EXTENSIONS: readonly ["", ".cmd", ".ps1"];
+export type ShimExtension = typeof SHIM_EXTENSIONS[number];
+/** 런타임 진입점. 세 래퍼가 전부 이 파일 하나로 모인다 — 로직이 갈리면 안 된다 */
+export declare const RUNTIME_FILENAME = "vord-shim.mjs";
+export interface ShimTarget {
+    readonly manager: ShimManager;
+    readonly extension: ShimExtension;
+    /** 원본 실행 파일의 절대 경로. **설치 시점에 박아 둔다** */
+    readonly realPath: string;
+}
+export interface ShimArtifact {
+    /** shim 디렉터리 안의 파일 이름 */
+    readonly filename: string;
+    readonly contents: string;
+    /** POSIX 에서 실행 비트를 세워야 하는가 */
+    readonly executable: boolean;
+}
+/** 셸 문자열 안에 그대로 넣어도 되는 경로인지. 따옴표·개행이 섞이면 거부한다 */
+export declare function isSafePath(p: string): boolean;
+export declare class UnsafePathError extends Error {
+    readonly which: string;
+    constructor(which: string);
+}
+/** 아티팩트 하나를 만든다 */
+export declare function buildArtifact(target: ShimTarget, runtimePath: string): ShimArtifact;
+/**
+ * 대상 전체의 아티팩트를 만든다.
+ *
+ * **6개가 나와야 한다** (매니저 2 × 확장자 3). 하나라도 빠지면 그 실행 경로가
+ * 조용히 통과하고, 사용자는 게이트가 켜져 있다고 믿는다.
+ */
+export declare function buildArtifacts(targets: readonly ShimTarget[], runtimePath: string): readonly ShimArtifact[];
+/** 설치돼야 하는 파일 이름 전체 — 검증이 이 목록과 실제를 대조한다 */
+export declare function expectedFilenames(managers?: readonly ShimManager[]): readonly string[];
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/shim/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/shim/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,sDAAsD;AACtD,eAAO,MAAM,aAAa,0BAA2B,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAEvD,uCAAuC;AACvC,eAAO,MAAM,eAAe,+BAAgC,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;AAE3D,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,qBAAa,eAAgB,SAAQ,KAAK;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAInC;AAkDD,mBAAmB;AACnB,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CAgBnF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,WAAW,EAAE,MAAM,GAClB,SAAS,YAAY,EAAE,CAEzB;AAED,4CAA4C;AAC5C,wBAAgB,iBAAiB,CAC/B,QAAQ,GAAE,SAAS,WAAW,EAAkB,GAC/C,SAAS,MAAM,EAAE,CAInB"}

package/dist/shim/artifacts.js

@@ -0,0 +1,114 @@
+/**
+ * PATH shim 아티팩트 생성 — ADR-026.
+ *
+ * **확장자별로 파일이 따로 필요하고, 없으면 조용히 통과한다.**
+ * 실측에서 `npm` 만 두고 `node -e "execSync('npm install axios')"` 를 돌리니
+ * `added 27 packages` 가 그대로 나왔다. Node 의 `execSync` 는 Windows 에서 cmd.exe 를 쓰고
+ * cmd.exe 는 `PATHEXT` 로 해석하기 때문이다. `npm.cmd` 를 넣으니 걸렸다.
+ * **게이트가 조용히 통과시키는 실패 모드**라 가장 위험하다 — 사용자는 켜 뒀다고 믿는다.
+ *
+ * 순수 함수다. 파일을 쓰지 않는다 — 내용만 만든다.
+ *
+ * **모든 래퍼는 자기가 못 뜨면 원본으로 넘긴다.** 깨진 shim 을 넣고 재보니 종료코드 127 로
+ * npm 이 전부 죽었다. 그건 fail-closed 가 아니라 **툴체인 브릭**이고, 브릭을 겪은 사용자는
+ * shim 을 지운다 — 영구 우회가 된다.
+ */
+/** Phase 1 대상. 데이터셋 기준 JS 레포 71개 중 70개(99%)가 이 둘이다 */
+export const SHIM_MANAGERS = ['npm', 'pnpm'];
+/** 확장자별 3종. 하나라도 빠지면 그 경로가 조용히 통과한다 */
+export const SHIM_EXTENSIONS = ['', '.cmd', '.ps1'];
+/** 런타임 진입점. 세 래퍼가 전부 이 파일 하나로 모인다 — 로직이 갈리면 안 된다 */
+export const RUNTIME_FILENAME = 'vord-shim.mjs';
+/** 셸 문자열 안에 그대로 넣어도 되는 경로인지. 따옴표·개행이 섞이면 거부한다 */
+export function isSafePath(p) {
+    return p.length > 0 && p.length < 4096 && !/["'`\r\n$%!^&|<>]/.test(p);
+}
+export class UnsafePathError extends Error {
+    which;
+    constructor(which) {
+        super(`${which} 경로에 셸에서 위험한 문자가 있다 — shim 을 만들지 않는다`);
+        this.which = which;
+        this.name = 'UnsafePathError';
+    }
+}
+function posixWrapper(m, real, runtime) {
+    return `#!/bin/sh
+# vord 설치 경계 shim (ADR-026). \`vord install-gate --shell --remove\` 로 지운다.
+# 이 파일을 직접 고치지 않는다 — 재설치하면 덮어쓴다.
+VORD_REAL='${real}'
+VORD_RUNTIME='${runtime}'
+
+# 런타임을 못 띄우면 원본으로 넘긴다. 툴체인을 죽이지 않는 것이 먼저다.
+if command -v node >/dev/null 2>&1 && [ -f "$VORD_RUNTIME" ]; then
+  exec node "$VORD_RUNTIME" ${m} "$VORD_REAL" "$@"
+fi
+exec "$VORD_REAL" "$@"
+`;
+}
+function cmdWrapper(m, real, runtime) {
+    // `%*` 는 인자를 원문 그대로 넘긴다. 재조립하면 따옴표가 깨진다.
+    return `@echo off
+rem vord 설치 경계 shim (ADR-026). vord install-gate --shell --remove 로 지운다.
+setlocal
+set "VORD_REAL=${real}"
+set "VORD_RUNTIME=${runtime}"
+where node >nul 2>nul || goto vord_passthrough
+if not exist "%VORD_RUNTIME%" goto vord_passthrough
+node "%VORD_RUNTIME%" ${m} "%VORD_REAL%" %*
+exit /b %errorlevel%
+:vord_passthrough
+"%VORD_REAL%" %*
+exit /b %errorlevel%
+`;
+}
+function ps1Wrapper(m, real, runtime) {
+    return `# vord 설치 경계 shim (ADR-026). vord install-gate --shell --remove 로 지운다.
+$VordReal = '${real}'
+$VordRuntime = '${runtime}'
+
+$node = Get-Command node -ErrorAction SilentlyContinue
+if ($node -and (Test-Path $VordRuntime)) {
+  & node $VordRuntime ${m} $VordReal @args
+  exit $LASTEXITCODE
+}
+# 런타임을 못 띄우면 원본으로 넘긴다 — 툴체인을 죽이지 않는다
+& $VordReal @args
+exit $LASTEXITCODE
+`;
+}
+/** 아티팩트 하나를 만든다 */
+export function buildArtifact(target, runtimePath) {
+    if (!isSafePath(target.realPath))
+        throw new UnsafePathError('원본');
+    if (!isSafePath(runtimePath))
+        throw new UnsafePathError('런타임');
+    const { manager, extension, realPath } = target;
+    const contents = extension === '.cmd'
+        ? cmdWrapper(manager, realPath, runtimePath)
+        : extension === '.ps1'
+            ? ps1Wrapper(manager, realPath, runtimePath)
+            : posixWrapper(manager, realPath, runtimePath);
+    return {
+        filename: `${manager}${extension}`,
+        contents,
+        executable: extension === '',
+    };
+}
+/**
+ * 대상 전체의 아티팩트를 만든다.
+ *
+ * **6개가 나와야 한다** (매니저 2 × 확장자 3). 하나라도 빠지면 그 실행 경로가
+ * 조용히 통과하고, 사용자는 게이트가 켜져 있다고 믿는다.
+ */
+export function buildArtifacts(targets, runtimePath) {
+    return targets.map((t) => buildArtifact(t, runtimePath));
+}
+/** 설치돼야 하는 파일 이름 전체 — 검증이 이 목록과 실제를 대조한다 */
+export function expectedFilenames(managers = SHIM_MANAGERS) {
+    const out = [];
+    for (const m of managers)
+        for (const e of SHIM_EXTENSIONS)
+            out.push(`${m}${e}`);
+    return out;
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/shim/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/shim/artifacts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,sDAAsD;AACtD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAGtD,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAG7D,oDAAoD;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAiBhD,iDAAiD;AACjD,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACnB;IAArB,YAAqB,KAAa;QAChC,KAAK,CAAC,GAAG,KAAK,sCAAsC,CAAC,CAAC;QADnC,UAAK,GAAL,KAAK,CAAQ;QAEhC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,SAAS,YAAY,CAAC,CAAc,EAAE,IAAY,EAAE,OAAe;IACjE,OAAO;;;aAGI,IAAI;gBACD,OAAO;;;;8BAIO,CAAC;;;CAG9B,CAAC;AACF,CAAC;AAED,SAAS,UAAU,CAAC,CAAc,EAAE,IAAY,EAAE,OAAe;IAC/D,yCAAyC;IACzC,OAAO;;;iBAGQ,IAAI;oBACD,OAAO;;;wBAGH,CAAC;;;;;CAKxB,CAAC;AACF,CAAC;AAED,SAAS,UAAU,CAAC,CAAc,EAAE,IAAY,EAAE,OAAe;IAC/D,OAAO;eACM,IAAI;kBACD,OAAO;;;;wBAID,CAAC;;;;;;CAMxB,CAAC;AACF,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,aAAa,CAAC,MAAkB,EAAE,WAAmB;IACnE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,MAAM,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;IAE/D,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAChD,MAAM,QAAQ,GAAG,SAAS,KAAK,MAAM;QACnC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;QAC5C,CAAC,CAAC,SAAS,KAAK,MAAM;YACpB,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC;YAC5C,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEnD,OAAO;QACL,QAAQ,EAAE,GAAG,OAAO,GAAG,SAAS,EAAE;QAClC,QAAQ;QACR,UAAU,EAAE,SAAS,KAAK,EAAE;KAC7B,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,OAA8B,EAC9B,WAAmB;IAEnB,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,iBAAiB,CAC/B,WAAmC,aAAa;IAEhD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,KAAK,MAAM,CAAC,IAAI,eAAe;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChF,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/shim/decide.d.ts

@@ -0,0 +1,68 @@
+/**
+ * shim 이 무엇을 할지 정한다 — **순수 함수** (ADR-026 · ADR-017).
+ *
+ * 프로세스를 띄우지도 파일을 읽지도 않는다. 게이트 결과와 크래시 여부만 받아
+ * "원본을 실행할 것인가" 를 낸다. 그래야 픽스처만으로 시험할 수 있다.
+ *
+ * ## 실패 종류를 셋으로 가른다
+ *
+ * ADR-026 이 드러낸 것이 이것이다. ADR-017 은 **레지스트리 조회 실패** 하나만 정했다.
+ *
+ * | 실패 | 처리 | 근거 |
+ * |------|------|------|
+ * | 레지스트리 조회 실패 | **막는다** (확인 불가 등급) | ADR-017 — 실패를 유도하는 것이 곧 우회가 된다 |
+ * | shim 런타임을 못 띄움 | **통과** + 기록 | 래퍼가 이미 원본으로 넘긴 뒤다. 브릭을 피한다 |
+ * | **게이트 코드가 크래시** | **잠정: 통과 + 기록** | **B-3 미결.** 아래 설명 |
+ *
+ * ## 크래시 기본값이 왜 통과인가 — 잠정이다
+ *
+ * ADR-017 의 논리(실패 유도 = 우회)는 크래시에도 적용된다. 그런데 실측에서 깨진 shim 은
+ * **종료코드 127 로 npm 을 통째로 죽였다.** 브릭을 겪은 사용자는 shim 을 지우고,
+ * 지워진 shim 은 **영구 우회**다 — 한 번의 차단보다 나쁘다.
+ *
+ * 그리고 B-3 을 정하려면 크래시 빈도와 사유가 필요한데, fail-closed 로 두면
+ * 사용자가 shim 을 지워서 **그 데이터가 안 모인다.**
+ *
+ * **이건 보안 결정이고 사람이 정한다.** 여기서는 뒤집을 수 있는 상수 하나로 두고,
+ * 어느 쪽이든 **반드시 기록한다** — 그게 ADR-026 이 고정한 유일한 제약이다.
+ */
+import type { ShimOutcome } from './log.js';
+/** 게이트 판정 요약 — `@vordsec/core` 의 `GateReport` 에서 필요한 것만 옮겨 담는다 */
+export interface GateSummary {
+    readonly stop: boolean;
+    readonly notApplicable?: string;
+    /** 사람에게 보여줄 줄들 */
+    readonly lines: readonly string[];
+    /** 막은 것 중 "확인 불가" 가 있는가 (ADR-017 등급 3) */
+    readonly hasUnverifiable: boolean;
+    readonly packages: readonly string[];
+}
+/**
+ * **B-3 이 정할 자리.** 크래시했을 때 통과시킬 것인가.
+ *
+ * `true` = 통과(잠정 기본값) · `false` = 막음.
+ * B-3 이 확정되면 이 상수를 지우고 별도 ADR 을 만든다 (ADR-026 재검토 조건).
+ */
+export declare const CRASH_PASSES_THROUGH_PROVISIONAL = true;
+export interface DecideInput {
+    readonly manager: string;
+    /** 게이트가 정상적으로 끝났으면 그 요약 */
+    readonly gate?: GateSummary;
+    /** 게이트가 예외를 던졌으면 그 사유 */
+    readonly crash?: string;
+    /** 크래시 시 통과 여부. 테스트가 양쪽을 다 시험한다 */
+    readonly crashPassesThrough?: boolean;
+}
+export interface Decision {
+    /** 원본 매니저를 실행할 것인가 */
+    readonly runReal: boolean;
+    readonly outcome: ShimOutcome;
+    /** stderr 로 낼 줄들. **에이전트가 읽는다** (ADR-010 §2) */
+    readonly stderr: readonly string[];
+    /** 막을 때의 종료 코드. 통과면 원본의 코드를 쓴다 */
+    readonly exitCode?: number;
+    readonly packages: readonly string[];
+    readonly detail?: string;
+}
+export declare function decide(input: DecideInput): Decision;
+//# sourceMappingURL=decide.d.ts.map

package/dist/shim/decide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../src/shim/decide.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB;IAClB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,QAAQ;IACvB,sBAAsB;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,QAAQ,CAyDnD"}

package/dist/shim/decide.js

@@ -0,0 +1,62 @@
+import { EXIT } from '../exit-codes.js';
+/**
+ * **B-3 이 정할 자리.** 크래시했을 때 통과시킬 것인가.
+ *
+ * `true` = 통과(잠정 기본값) · `false` = 막음.
+ * B-3 이 확정되면 이 상수를 지우고 별도 ADR 을 만든다 (ADR-026 재검토 조건).
+ */
+export const CRASH_PASSES_THROUGH_PROVISIONAL = true;
+const BANNER = 'vord: 설치 경계';
+export function decide(input) {
+    const { manager, gate, crash } = input;
+    const passOnCrash = input.crashPassesThrough ?? CRASH_PASSES_THROUGH_PROVISIONAL;
+    // ── 게이트가 크래시했다. **B-3 이 정할 자리**
+    if (crash !== undefined) {
+        return passOnCrash
+            ? {
+                runReal: true,
+                outcome: 'gate-crash',
+                packages: [],
+                detail: crash,
+                stderr: [
+                    `${BANNER}: 검사에 실패해 그대로 진행한다 (${crash}).`,
+                    '이 설치는 검사되지 않았다. `vord install-gate --shell --status` 로 기록을 본다.',
+                ],
+            }
+            : {
+                runReal: false,
+                outcome: 'gate-crash',
+                // 크래시는 "위험하다" 가 아니라 "판단하지 못했다" 다 — 확인 불가 쪽이다
+                exitCode: EXIT.UNVERIFIABLE,
+                packages: [],
+                detail: crash,
+                stderr: [`${BANNER}: 검사에 실패해 설치를 멈춘다 (${crash}).`],
+            };
+    }
+    if (gate === undefined) {
+        // 게이트도 크래시도 없다 — 호출부의 버그다. 통과시키되 기록한다
+        return {
+            runReal: true, outcome: 'gate-crash', packages: [], detail: '판정 결과 없음',
+            stderr: [`${BANNER}: 판정 결과가 없어 그대로 진행한다.`],
+        };
+    }
+    if (gate.notApplicable !== undefined) {
+        return { runReal: true, outcome: 'not-applicable', packages: [], stderr: [] };
+    }
+    if (!gate.stop) {
+        return { runReal: true, outcome: 'passed', packages: gate.packages, stderr: [] };
+    }
+    // ── 막는다. **"위험함" 과 "모름" 을 다른 말로 낸다** (ADR-017 장치 3)
+    const head = gate.hasUnverifiable
+        ? `${BANNER}: 확인하지 못해 설치를 멈췄다. 위험해서 막은 것이 아니다.`
+        : `${BANNER}: 설치를 막았다.`;
+    return {
+        runReal: false,
+        outcome: gate.hasUnverifiable ? 'unverifiable' : 'blocked',
+        // **차단과 확인 불가를 종료 코드에서도 가른다.** CI 는 메시지를 안 읽고 코드만 본다
+        exitCode: gate.hasUnverifiable ? EXIT.UNVERIFIABLE : EXIT.BLOCKED,
+        packages: gate.packages,
+        stderr: [head, ...gate.lines, `(${manager} 명령은 실행되지 않았다)`],
+    };
+}
+//# sourceMappingURL=decide.js.map

package/dist/shim/decide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.js","sourceRoot":"","sources":["../../src/shim/decide.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAaxC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC;AAwBrD,MAAM,MAAM,GAAG,aAAa,CAAC;AAE7B,MAAM,UAAU,MAAM,CAAC,KAAkB;IACvC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,WAAW,GAAG,KAAK,CAAC,kBAAkB,IAAI,gCAAgC,CAAC;IAEjF,iCAAiC;IACjC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,WAAW;YAChB,CAAC,CAAC;gBACA,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,YAAY;gBACrB,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE;oBACN,GAAG,MAAM,uBAAuB,KAAK,IAAI;oBACzC,gEAAgE;iBACjE;aACF;YACD,CAAC,CAAC;gBACA,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,YAAY;gBACrB,6CAA6C;gBAC7C,QAAQ,EAAE,IAAI,CAAC,YAAY;gBAC3B,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,CAAC,GAAG,MAAM,sBAAsB,KAAK,IAAI,CAAC;aACnD,CAAC;IACN,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,sCAAsC;QACtC,OAAO;YACL,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU;YACtE,MAAM,EAAE,CAAC,GAAG,MAAM,uBAAuB,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAChF,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACnF,CAAC;IAED,qDAAqD;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe;QAC/B,CAAC,CAAC,GAAG,MAAM,oCAAoC;QAC/C,CAAC,CAAC,GAAG,MAAM,YAAY,CAAC;IAE1B,OAAO;QACL,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;QAC1D,qDAAqD;QACrD,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO;QACjE,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,OAAO,gBAAgB,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/shim/install.d.ts

@@ -0,0 +1,76 @@
+import { type ShimExtension, type ShimManager } from './artifacts.js';
+export declare const DEFAULT_SHIM_DIRNAME: string;
+export declare function defaultShimDir(home?: string): string;
+export interface Env {
+    readonly PATH: string;
+    readonly PATHEXT?: string;
+}
+/** PATH 를 나눈다. 구분자는 플랫폼마다 다르다 */
+export declare function splitPath(pathEnv: string, delimiter?: ";" | ":"): string[];
+/**
+ * PATH 에서 **shim 디렉터리를 빼고** 원본을 찾는다.
+ *
+ * shim 이 이미 깔린 뒤에 다시 설치하면 shim 이 자기 자신을 원본으로 박는다 —
+ * 무한 재귀다. 그래서 항상 자기 디렉터리를 빼고 찾는다.
+ */
+export declare function findRealBinary(manager: ShimManager, extension: ShimExtension, env: Env, shimDir: string, exists?: (p: string) => boolean): string | undefined;
+export interface InstallPlanEntry {
+    readonly manager: ShimManager;
+    readonly extension: ShimExtension;
+    readonly realPath?: string;
+    /** 원본을 못 찾았다 — 이 경로는 shim 을 만들지 않는다 */
+    readonly missing: boolean;
+}
+export interface InstallPlan {
+    readonly shimDir: string;
+    readonly entries: readonly InstallPlanEntry[];
+    /**
+     * **조용히 통과할 경로가 있는가.** 확장자 하나가 비면 그 실행 경로는 게이트를 지나간다.
+     * 사용자가 "켰다" 고 믿는 상태에서 안 걸리는 것이 가장 위험한 실패다.
+     */
+    readonly silentGaps: readonly string[];
+}
+export declare function planInstall(env: Env, shimDir: string, managers?: readonly ShimManager[], exists?: (p: string) => boolean): InstallPlan;
+export interface InstallResult {
+    readonly shimDir: string;
+    readonly written: readonly string[];
+    readonly skipped: readonly string[];
+    readonly silentGaps: readonly string[];
+    /** PATH 에 shim 디렉터리가 **앞쪽에** 있는가 */
+    readonly onPath: boolean;
+    readonly instructions: readonly string[];
+}
+/** 런타임 진입점 본문. 빌드된 CLI 를 부르는 얇은 파일이다 */
+export declare function runtimeSource(cliRunPath: string): string;
+export declare function install(env: Env, opts: {
+    readonly shimDir?: string;
+    readonly managers?: readonly ShimManager[];
+    readonly cliRunPath: string;
+}): InstallResult;
+/**
+ * shim 디렉터리가 PATH 에 있고, **원본보다 앞인가.**
+ * 뒤에 있으면 아무것도 안 걸린다 — 있는 것과 없는 것이 같다.
+ */
+export declare function isShimFirst(env: Env, shimDir: string, manager?: ShimManager): boolean;
+export declare function pathInstructions(shimDir: string): readonly string[];
+export interface RemoveResult {
+    readonly shimDir: string;
+    readonly removed: readonly string[];
+    readonly remaining: readonly string[];
+}
+/**
+ * 우리가 만든 것만 지운다.
+ * **사용자가 그 디렉터리에 둔 다른 파일은 건드리지 않는다** — 디렉터리째 지우지 않는다.
+ */
+export declare function remove(shimDir: string): RemoveResult;
+export interface VerifyResult {
+    readonly shimDir: string;
+    readonly installed: readonly string[];
+    /** 있어야 하는데 없는 것. **이게 조용히 통과하는 경로다** */
+    readonly missing: readonly string[];
+    readonly runtimePresent: boolean;
+    readonly onPath: boolean;
+    readonly healthy: boolean;
+}
+export declare function verify(env: Env, shimDir: string): VerifyResult;
+//# sourceMappingURL=install.d.ts.map

package/dist/shim/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/shim/install.ts"],"names":[],"mappings":"AAUA,OAAO,EAGL,KAAK,aAAa,EAAE,KAAK,WAAW,EACrC,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,oBAAoB,QAA6B,CAAC;AAE/D,wBAAgB,cAAc,CAAC,IAAI,GAAE,MAAqB,GAAG,MAAM,CAElE;AAED,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,iCAAiC;AACjC,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,YAAiB,GAAG,MAAM,EAAE,CAE/E;AAOD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,aAAa,EACxB,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAiC,GACvD,MAAM,GAAG,SAAS,CAQpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,GAAG,EACR,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,SAAS,WAAW,EAAkB,EAChD,MAAM,GAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAiC,GACvD,WAAW,CAwBb;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,GAAG,EACR,IAAI,EAAE;IACJ,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GACA,aAAa,CAqCf;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,WAAmB,GAAG,OAAO,CAO5F;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAUnE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAYpD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAkB9D"}