@kaydash9999/banker-plugins 0.20.2 → 0.21.0

package/skills/setup-bypass-permissions/scripts/codex-bypass.mjs

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+/*
+ * setup-bypass-permissions 의 Codex 대상. Claude Code 의 bypassPermissions 에 해당하는 Codex 설정을 켜고 끈다:
+ * `$CODEX_HOME/config.toml` 최상위의 approval_policy = "never", sandbox_mode = "danger-full-access"
+ * (Codex 의 --dangerously-bypass-approvals-and-sandbox 와 같은 조합).
+ *
+ * - 켜기 전 두 키의 값(없으면 없음)을 config.toml.bypass-permissions.json 에 기록하고, 원본 바이트를
+ *   config.toml.bypass-permissions.bak 에 둔다. off 는 기록대로 되돌린다. 기록이 없으면 이 스크립트가 쓰는 값과
+ *   같은 키만 뺀다.
+ * - 조직 정책(/etc/codex/requirements.toml 의 allowed_approval_policies, allowed_sandbox_modes)이 이 값을 허용하지
+ *   않으면 켜지 않는다.
+ *
+ * 사용: node codex-bypass.mjs <on --yes|off|status>
+ * 종료: 0 완료 또는 이미 그 상태, 1 거부(파일은 그대로), 2 예기치 못한 오류, 3 이 계정이 쓸 수 없음(샌드박스 등)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { codexConfigFile, denied, eolOf, findKey, readToml, Refused, removeKey, setKey, tablesSetting, writeToml } from './codex-config.mjs';
+
+const WANT = { approval_policy: '"never"', sandbox_mode: '"danger-full-access"' };
+const KEYS = Object.keys(WANT);
+const POLICY_FILES = ['/etc/codex/requirements.toml', '/etc/codex/managed_config.toml'];
+
+const recordOf = (file) => `${file}.bypass-permissions.json`;
+const backupOf = (file) => `${file}.bypass-permissions.bak`;
+const valueOf = (text, key) => findKey(text, '', key)?.raw ?? null;
+const isOn = (text) => KEYS.every((k) => valueOf(text, k) === WANT[k]);
+
+// 조직 정책이 이 값을 막거나 정책 파일을 읽을 수 없으면 그 이유, 아니면 ''.
+export function policyBlock(files = POLICY_FILES) {
+  for (const f of files) {
+    let text = '';
+    try {
+      text = fs.readFileSync(f, 'utf8');
+    } catch (e) {
+      if (e.code === 'ENOENT') continue;
+      return `조직 정책 파일을 읽을 수 없음(${e.code}): ${f}`;
+    }
+    for (const [key, want] of [['allowed_approval_policies', 'never'], ['allowed_sandbox_modes', 'danger-full-access']]) {
+      const hit = findKey(text, '', key);
+      if (hit && !new RegExp(`["']${want}["']`).test(hit.raw)) return `${f} 의 ${key} 가 ${want} 를 허용하지 않음`;
+    }
+    // 옛 managed_config.toml 은 값 자체를 덮어쓴다. 다른 값이면 사용자 설정이 적용되지 않는다.
+    for (const k of KEYS) {
+      const forced = findKey(text, '', k)?.raw;
+      if (forced && forced.replace(/'/g, '"') !== WANT[k]) return `${f} 가 ${k} 를 ${forced} 로 정함`;
+    }
+  }
+  return '';
+}
+
+// 최상위 profile 이 고른 기본 프로필이 두 키를 따로 정하면 그 값이 이긴다. 그 프로필 이름, 없으면 ''.
+export function overridingProfile(text) {
+  const raw = findKey(text, '', 'profile')?.raw ?? '';
+  const m = /^"([^"]+)"$|^'([^']+)'$/.exec(raw);
+  if (!m) return '';
+  const name = m[1] ?? m[2];
+  const table = `profiles."${name}"`;
+  // [profiles.<이름>] 표의 키, 또는 최상위의 점 키 profiles.<이름>.<키>.
+  const sets = KEYS.some((k) => findKey(text, table, k) || findKey(text, '', `${table}.${k}`));
+  return sets ? `profiles.${name}` : '';
+}
+
+export function turnOn({ file = codexConfigFile(), policies = POLICY_FILES } = {}) {
+  const why = policyBlock(policies);
+  if (why) return { code: 1, msg: `켜지 않음: ${why}` };
+  const { text, mode, exists } = readToml(file);
+  const prof = overridingProfile(text);
+  if (prof) return { code: 1, msg: `켜지 않음: 기본 프로필 ${prof} 가 approval_policy 나 sandbox_mode 를 정해 최상위 값이 적용되지 않음. 그 프로필의 값을 직접 바꾸십시오` };
+  if (isOn(text)) return { code: 0, msg: '이미 켜져 있음' };
+  const before = Object.fromEntries(KEYS.map((k) => [k, valueOf(text, k)]));
+  let next = text;
+  for (const k of KEYS) next = setKey(next, '', k, WANT[k]);
+  if (!fs.existsSync(path.dirname(file))) return { code: 1, msg: `Codex 설정 폴더가 없음: ${path.dirname(file)}` };
+  // 켜져 있지 않은 상태에서 켜므로 지금 값이 되돌릴 값이다. 예전 기록이 남아 있어도(켬, 손으로 바꿈, 다시 켬) 지금 값으로 바꾼다.
+  // 설정을 먼저 쓰고 기록을 쓴다. 설정 쓰기가 실패하면 앞선 기록이 그대로 남는다.
+  const nl = eolOf(text);
+  writeToml(file, next.endsWith(nl) || !next ? next : `${next}${nl}`, { mode, backup: exists ? backupOf(file) : null });
+  writeToml(recordOf(file), `${JSON.stringify({ before, existed: exists })}\n`);
+  return { code: 0, msg: '켬: approval_policy = "never", sandbox_mode = "danger-full-access"' };
+}
+
+export function turnOff({ file = codexConfigFile() } = {}) {
+  const { text, mode, exists } = readToml(file);
+  let record = null;
+  try { record = JSON.parse(fs.readFileSync(recordOf(file), 'utf8')); } catch { /* 기록 없음 */ }
+  let next = text;
+  // 기록이 없으면 두 키가 모두 이 스크립트의 값일 때만 뺀다. 사용자가 스스로 둔 approval_policy = "never" 하나는 남긴다.
+  const ours = record || isOn(text);
+  for (const k of KEYS) {
+    const was = record?.before?.[k];
+    if (typeof was === 'string') next = setKey(next, '', k, was);
+    else if (ours) next = removeKey(next, '', k);
+  }
+  if (next !== text && exists) writeToml(file, next, { mode });
+  fs.rmSync(recordOf(file), { force: true });
+  return { code: 0, msg: next === text ? '이미 꺼져 있음' : record ? '끔: 켜기 전 값으로 되돌림' : '끔: 이 스크립트가 쓰는 두 값의 키를 뺌' };
+}
+
+export function status({ file = codexConfigFile(), policies = POLICY_FILES } = {}) {
+  const { text } = readToml(file);
+  const out = [`${isOn(text) ? '켜짐' : '꺼짐'}: approval_policy = ${valueOf(text, 'approval_policy') ?? '(없음)'}, sandbox_mode = ${valueOf(text, 'sandbox_mode') ?? '(없음)'}`];
+  const prof = overridingProfile(text);
+  if (prof) out.push(`기본 프로필 ${prof} 가 값을 정해 최상위 값이 적용되지 않음`);
+  const profiles = [...new Set(KEYS.flatMap((k) => tablesSetting(text, 'profiles', k)))];
+  if (profiles.length) out.push(`프로필이 따로 정함(그 프로필로 시작하면 그 값): ${profiles.join(', ')}`);
+  const why = policyBlock(policies);
+  if (why) out.push(`조직 정책: ${why}`);
+  if (fs.existsSync(recordOf(file))) out.push(`되돌리기 기록: ${recordOf(file)}`);
+  return { code: 0, msg: out.join('\n') };
+}
+
+function run(argv) {
+  const [cmd] = argv;
+  if (cmd === 'on' && !argv.includes('--yes')) return { code: 1, msg: '켜기는 확인을 받은 뒤 --yes 와 함께 실행' };
+  if (cmd === 'on') return turnOn();
+  if (cmd === 'off') return turnOff();
+  return status();
+}
+
+function main(argv) {
+  let r;
+  try {
+    r = run(argv);
+  } catch (e) {
+    r = e instanceof Refused ? { code: 1, msg: `거부: ${e.message}` } : denied(e) ? { code: 3, msg: `쓸 수 없음(${e.code}): ${e.path ?? ''}${e.code === 'EPERM' && process.platform === 'win32' ? '. 다른 프로그램(Codex, 편집기)이 파일을 잡고 있을 수 있음' : ''}` } : { code: 2, msg: `오류: ${e.message}` };
+  }
+  console.log(`${r.msg}\n설정 파일: ${codexConfigFile()}`);
+  return r.code;
+}
+
+const same = (a, b) => { try { return fs.realpathSync(a) === fs.realpathSync(b); } catch { return false; } };
+if (process.argv[1] && same(fileURLToPath(import.meta.url), path.resolve(process.argv[1]))) process.exitCode = main(process.argv.slice(2));

package/skills/setup-bypass-permissions/scripts/codex-config.mjs

@@ -0,0 +1,210 @@
+/*
+ * Codex 의 config.toml 을 줄 단위로 읽고 고치는 공통 모듈. setup-bypass-permissions 가 정본이고 setup-omc-hud 의
+ * assets/ 에 같은 사본을 둔다(scripts/sync-adapter.js 가 지킴).
+ *
+ * TOML 전체를 다시 쓰지 않는다. 바꾸는 키의 줄만 고쳐 주석, 순서, 다른 표는 그대로 둔다.
+ * - 줄을 훑으며 문자열(한 줄, 여러 줄)과 괄호 깊이를 따라가, 여러 줄 문자열이나 배열 안의 줄을 표 머리나 키로 보지 않는다.
+ * - 키 이름은 따옴표를 벗겨 비교한다(`"approval_policy"` 도 approval_policy). 값 끝의 주석은 값으로 보지 않는다.
+ * - 최상위가 표를 점 키나 인라인 표로 정했는지(definedInline) 알려, 그런 파일에 같은 표를 더하지 않게 한다.
+ * - 파일이 링크이거나 일반 파일이 아니면 고치지 않는다. 쓰기 전 원본을 백업(이 계정만 읽음)하고, 새 파일에 쓴 뒤
+ *   바꿔 넣으며 파일 모드를 지킨다.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+// Codex 처럼 상대 경로 CODEX_HOME 은 지금 폴더 기준으로 푼다.
+export function codexConfigFile(env = process.env) {
+  const home = env.CODEX_HOME ? path.resolve(env.CODEX_HOME) : path.join(os.homedir(), '.codex');
+  return path.join(home, 'config.toml');
+}
+
+export class Refused extends Error {}
+
+// { text, mode, exists }. 없으면 빈 글. 링크나 일반 파일이 아니면 Refused.
+export function readToml(file) {
+  let st;
+  try {
+    st = fs.lstatSync(file);
+  } catch (e) {
+    if (e.code === 'ENOENT') return { text: '', mode: null, exists: false };
+    throw e;
+  }
+  if (!st.isFile()) throw new Refused(`${file} 이 일반 파일이 아님(링크이거나 다른 종류)`);
+  return { text: fs.readFileSync(file, 'utf8'), mode: st.mode & 0o7777, exists: true };
+}
+
+// 원본을 backup 에 복사한 뒤(원본이 있을 때) 새 파일에 써서 바꿔 넣는다.
+export function writeToml(file, text, { mode = null, backup = null } = {}) {
+  if (backup && fs.existsSync(file)) {
+    fs.copyFileSync(file, backup);
+    fs.chmodSync(backup, 0o600); // 원본에 비밀 값이 있을 수 있다
+  }
+  const tmp = `${file}.${process.pid}.${Date.now()}.tmp`;
+  try {
+    fs.writeFileSync(tmp, text, { flag: 'wx', mode: mode ?? 0o600 });
+    if (mode !== null) fs.chmodSync(tmp, mode);
+    fs.renameSync(tmp, file);
+  } catch (e) {
+    fs.rmSync(tmp, { force: true });
+    throw e;
+  }
+}
+
+const lines = (text) => text.split(/\r?\n/);
+const eol = (text) => (text.includes('\r\n') ? '\r\n' : '\n');
+// 파일이 쓰는 줄바꿈(CRLF 가 하나라도 있으면 CRLF).
+export const eolOf = eol;
+const TRIPLE = ['"""', "'''"];
+
+// 키나 표 이름을 낱말 배열로. 따옴표 안의 점은 나누지 않는다(`profiles."a.b"` 는 ['profiles', 'a.b']).
+export const nameParts = (s) => (s.match(/"[^"]*"|'[^']*'|[^.\s]+/g) ?? []).map((p) => p.replace(/^"(.*)"$|^'(.*)'$/, '$1$2'));
+// 비교용 이름. 낱말 사이를 \u0000 으로 이어, 점이 든 낱말과 점으로 나뉜 낱말을 구분한다.
+const plainName = (s) => nameParts(s).join('\u0000');
+
+// 한 줄을 문자열 밖에서 훑는다. { d: 괄호 깊이 변화, multi: 줄 끝에 열려 있는 여러 줄 문자열 구분자, cut: 주석 시작 위치 }.
+function scanLine(s, multi = '') {
+  let d = 0;
+  for (let i = 0; i < s.length; i++) {
+    if (multi) {
+      if (s.startsWith(multi, i)) { i += 2; multi = ''; } else if (multi === TRIPLE[0] && s[i] === '\\') i++;
+      continue;
+    }
+    const c = s[i];
+    if (TRIPLE.some((t) => s.startsWith(t, i))) { multi = s.slice(i, i + 3); i += 2; }
+    else if (c === '"') { for (i++; i < s.length && s[i] !== '"'; i++) if (s[i] === '\\') i++; }
+    else if (c === "'") { const k = s.indexOf("'", i + 1); i = k < 0 ? s.length : k; }
+    else if (c === '#') return { d, multi, cut: i };
+    else if (c === '[' || c === '{') d++;
+    else if (c === ']' || c === '}') d--;
+  }
+  return { d, multi, cut: s.length };
+}
+
+// 표 머리. 이름 안의 따옴표 친 낱말에는 ] 가 들어갈 수 있다(`[projects."/a]b"]`).
+// 이름 부분은 탐욕 한 번으로 읽는다(겹치는 공백 패턴은 긴 줄에서 역추적이 폭증한다). 앞뒤 공백은 nameParts 가 지운다.
+const HEADER_RE = /^\s*\[\[?((?:"[^"]*"|'[^']*'|[^\]"'])+)\]\]?\s*(#.*)?$/;
+const KEY_RE = /^\s*((?:"[^"]*"|'[^']*'|[A-Za-z0-9_-]+)(?:\s*\.\s*(?:"[^"]*"|'[^']*'|[A-Za-z0-9_-]+))*)\s*=(.*)$/;
+
+// 줄마다 { kind: 'header'|'key'|'inside'|'other', name, end }. header 의 name 은 표 이름, key 의 name 은 키 이름이고
+// end 는 값이 끝나는 줄 다음. 여러 줄 문자열이나 배열 안의 줄은 inside.
+export function scan(text) {
+  const ls = lines(text);
+  const out = ls.map(() => ({ kind: 'other' }));
+  for (let i = 0; i < ls.length; i++) {
+    const header = HEADER_RE.exec(ls[i]);
+    if (header) { out[i] = { kind: 'header', name: plainName(header[1]) }; continue; }
+    const key = KEY_RE.exec(ls[i]);
+    if (!key) continue;
+    let { d, multi } = scanLine(key[2]);
+    let j = i + 1;
+    for (; (d > 0 || multi) && j < ls.length; j++) {
+      out[j] = { kind: 'inside' };
+      const r = scanLine(ls[j], multi);
+      d += r.d;
+      multi = r.multi;
+    }
+    out[i] = { kind: 'key', name: plainName(key[1]), end: j };
+    i = j - 1;
+  }
+  return out;
+}
+
+// 표의 줄 범위 [from, to). table '' 은 최상위. 표가 없으면 null.
+function tableRange(info, table) {
+  table = table.includes('\u0000') || !table ? table : plainName(table);
+  let from = table ? -1 : 0;
+  for (let i = 0; i < info.length; i++) {
+    if (info[i].kind !== 'header') continue;
+    if (from >= 0) return [from, i];
+    if (info[i].name === table) from = i + 1;
+  }
+  return from >= 0 ? [from, info.length] : null;
+}
+
+function keysOf(text, table) {
+  const info = scan(text);
+  const range = tableRange(info, table);
+  if (!range) return [];
+  const keys = [];
+  for (let i = range[0]; i < range[1]; i++) if (info[i].kind === 'key') keys.push({ at: i, end: info[i].end, name: info[i].name });
+  return keys;
+}
+
+// 키의 { at, end, raw }. raw 는 값 끝의 주석을 뺀 글. 없으면 null.
+export function findKey(text, table, key) {
+  const want = nameParts(key).join('\u0000');
+  const hit = keysOf(text, plainName(table)).find((k) => k.name === want);
+  if (!hit) return null;
+  const ls = lines(text).slice(hit.at, hit.end);
+  const parts = [ls[0].slice(ls[0].indexOf('=') + 1), ...ls.slice(1)];
+  let multi = '';
+  for (const part of parts.slice(0, -1)) multi = scanLine(part, multi).multi;
+  const last = parts.length - 1;
+  parts[last] = parts[last].slice(0, scanLine(parts[last], multi).cut); // 마지막 줄의 주석을 뗀다
+  const raw = parts.join('\n');
+  return { at: hit.at, end: hit.end, raw: raw.trim() };
+}
+
+// 최상위가 이 표를 점 키나 인라인 표로 정했는지(`tui.x = 1`, `tui = { ... }`). 그런 파일에 [표] 를 더하면 키가 겹쳐
+// Codex 가 설정을 읽지 못한다.
+export function definedInline(text, table) {
+  const t = plainName(table);
+  return keysOf(text, '').some((k) => k.name === t || k.name.startsWith(`${t}\u0000`));
+}
+
+// 키를 rawValue 로 둔다. 있으면 그 줄을 바꾸고, 없으면 표 끝(최상위는 첫 표 머리 앞)에 넣는다. 표가 없으면 끝에 만든다.
+// comment 가 있으면 키 바로 위에 그 주석 줄을 둔다.
+export function setKey(text, table, key, rawValue, comment = '') {
+  const ls = lines(text);
+  const nl = eol(text);
+  const line = [...(comment ? [comment] : []), `${key} = ${rawValue}`];
+  const hit = findKey(text, table, key);
+  if (hit) {
+    const above = comment && ls[hit.at - 1] === comment ? 1 : 0;
+    ls.splice(hit.at - above, hit.end - hit.at + above, ...line);
+    return ls.join(nl);
+  }
+  const range = tableRange(scan(text), table);
+  if (!range) {
+    while (ls.length && ls[ls.length - 1] === '') ls.pop();
+    return [...ls, ...(ls.length ? [''] : []), `[${table}]`, ...line, ''].join(nl);
+  }
+  // 다음 표 머리에 붙은 주석(`# MCP servers` 처럼 머리 바로 위의 주석 줄)과 그 앞 빈 줄은 건너뛰고 넣는다.
+  let at = range[1];
+  if (range[1] < ls.length) while (at > range[0] && ls[at - 1].trim().startsWith('#')) at--;
+  while (at > range[0] && ls[at - 1].trim() === '') at--;
+  ls.splice(at, 0, ...line);
+  return ls.join(nl);
+}
+
+// 키를 뺀다. comment 와 같은 주석 줄이 바로 위에 있으면 그것도 뺀다.
+export function removeKey(text, table, key, comment = '') {
+  const hit = findKey(text, table, key);
+  if (!hit) return text;
+  const ls = lines(text);
+  const above = comment && ls[hit.at - 1] === comment ? 1 : 0;
+  ls.splice(hit.at - above, hit.end - hit.at + above);
+  return ls.join(eol(text));
+}
+
+// 표에 키도 주석도 없으면 그 머리와 뒤의 빈 줄을 뺀다.
+export function dropEmptyTable(text, table) {
+  const info = scan(text);
+  const range = tableRange(info, table);
+  if (!range) return text;
+  const ls = lines(text);
+  if (ls.slice(range[0], range[1]).some((l) => l.trim())) return text;
+  ls.splice(range[0] - 1, range[1] - range[0] + 1);
+  return ls.join(eol(text));
+}
+
+// 이름이 prefix 로 시작하는 표들 중 key 를 정한 표 이름(예: profiles.* 의 approval_policy).
+export function tablesSetting(text, prefix, key) {
+  const p = plainName(prefix);
+  const names = scan(text).filter((x) => x.kind === 'header' && x.name.startsWith(`${p}\u0000`)).map((x) => x.name);
+  return [...new Set(names)].filter((n) => findKey(text, n, key)).map((n) => n.split('\u0000').join('.'));
+}
+
+// 쓰기 실패가 이 계정의 권한(샌드박스, 읽기 전용, 다른 소유자) 때문인지.
+export const denied = (e) => ['EACCES', 'EPERM', 'EROFS'].includes(e?.code);

package/skills/setup-harness-factory/SKILL.md

@@ -26,6 +26,22 @@ ls -la .claude/agents .claude/skills 2>/dev/null   # 기존 harness 산출물
 - 기존 `.claude/agents/`·`.claude/skills/`·`CLAUDE.md`에 harness 흔적이 있으면 신규 생성이 아니라
   확장·유지보수로 다룬다(harness 자신의 Phase 0 감사 원칙).
 
+### 네트워크 확인 (내려받기 전)
+
+이 스킬이 내려받는 원천에 10초 안에 닿는지 먼저 본다. 닿지 않으면 그 원천에서 받는 단계는 하지 않고, 이미 설치된 것의 확인만 한 뒤 "오프라인이라 설치하지 않음(필요한 것: <못 깐 것>)" 으로 보고한다.
+
+```bash
+[ "${CODEX_SANDBOX_NETWORK_DISABLED:-}" = 1 ] && echo "Codex sandbox 가 네트워크를 막음(아래 실패는 오프라인이 아님)"
+curl --ssl-no-revoke -sSI -o /dev/null --connect-timeout 5 --max-time 10 https://github.com   # 마켓플레이스, git clone
+```
+
+- `curl -sSI` 는 머리만 받는다(본문을 받지 않음). 닿지 못하면 종료 코드가 0 이 아니다(HTTP 상태와 관계없음). `curl` 은 `HTTPS_PROXY` 를 따른다. 확인 줄은 `--ssl-no-revoke` 를 준다. Windows 의 Git Bash curl 도 Schannel 이라, 폐지 목록 서버에 닿지 못하는 망에서 폐지 확인이 실패하면 종료 60 이다(Windows 박스 실측). 다른 curl 은 이 깃발을 받고 무시한다(macOS curl 8.7.1, Rocky 8.10 curl 7.61.1 실측).
+- Windows PowerShell 에서는 같은 주소를 `curl.exe --ssl-no-revoke -sSI -o NUL --connect-timeout 5 --max-time 10 <주소>` 로 보고 `$LASTEXITCODE` 가 0 인지 본다(PowerShell 5.1 의 `curl` 은 `Invoke-WebRequest` 별칭이다). `curl.exe` 는 Windows 시스템 프록시를 따르지 않고 `HTTPS_PROXY` 만 따른다. `--ssl-no-revoke` 는 폐지 목록 서버에 닿지 못하는 망에서 Schannel 의 폐지 확인 실패를 오프라인으로 읽지 않게 한다. 닿는지만 보고 받은 내용은 쓰지 않으므로 이 확인에만 준다. `curl.exe` 가 없으면 `$LASTEXITCODE` 에 앞 명령의 값이 남으므로 `Get-Command curl.exe -ErrorAction SilentlyContinue` 로 먼저 보고, 없으면 확인하지 못한 것으로 적는다.
+- 사내 미러만 열린 망이면 확인 주소를 그 미러로 바꿔 본다.
+- Codex sandbox 가 네트워크를 막는 모드(기본 `workspace-write`, `read-only`)에서는 `CODEX_SANDBOX_NETWORK_DISABLED=1` 이 서고 확인이 모두 실패한다(curl 종료 7, npm `EPERM`). 블록의 첫 줄이 그렇다고 알린다. 그때는 '오프라인' 이 아니라 'sandbox 가 네트워크를 막음' 으로 보고하고, 승인을 받아 sandbox 밖에서 확인부터 다시 한다. Claude Code sandbox 안(`SANDBOX_RUNTIME=1`)에서는 허용 목록 밖 주소를 sandbox 프록시가 막는다. Windows PowerShell 에서는 `$env:CODEX_SANDBOX_NETWORK_DISABLED -eq '1'` 로 본다.
+- 확인이 실패하면 보고에 그 명령, 종료 코드, stderr 첫 줄을 붙인다(예: `npm error code ETIMEDOUT`, `curl: (28) ...`). 원인을 '오프라인' 하나로 짐작하지 않는다.
+- curl 의 종료 60(인증서 검증 실패)도 오프라인이 아니다. 망은 열려 있고, TLS 를 가로채는 사내 프록시의 인증서를 OS 가 믿지 않는 것이다. '인증서 문제로 설치하지 않음' 으로 보고한다.
+
 ## 1. 설치
 ### Claude Code
 세션 안(슬래시 커맨드):
@@ -43,7 +59,7 @@ ls -la .claude/agents .claude/skills 2>/dev/null   # 기존 harness 산출물
 ### Codex CLI
 마켓플레이스 개념이 없고 Python 인스톨러를 쓴다:
 ```bash
-git clone https://github.com/SaehwanPark/meta-harness
+git -c http.lowSpeedLimit=1000 -c http.lowSpeedTime=30 clone https://github.com/SaehwanPark/meta-harness
 cd meta-harness
 python3 scripts/install_harness.py --scope user --layout codex
 # 프로젝트 범위: python3 scripts/install_harness.py --scope project --target <repo> --layout codex

package/skills/setup-insane-search/SKILL.md

@@ -8,6 +8,22 @@ description: "차단이나 봇 방어가 있는 사이트도 우회해 검색하
 차단 사이트 우회(WAF·봇방어; X·Reddit·YouTube·GitHub 등) 검색·페치를 제공하는 `insane-search` 플러그인을
 설치한다. 현재 도구(Claude Code / Codex)를 감지해 알맞은 경로로 진행하고, 이미 설치돼 있으면 skip(멱등). 답변은 한글.
 
+## 0. 네트워크 확인 (내려받기 전)
+
+이 스킬이 내려받는 원천에 10초 안에 닿는지 먼저 본다. 닿지 않으면 그 원천에서 받는 단계는 하지 않고, 이미 설치된 것의 확인만 한 뒤 "오프라인이라 설치하지 않음(필요한 것: <못 깐 것>)" 으로 보고한다.
+
+```bash
+[ "${CODEX_SANDBOX_NETWORK_DISABLED:-}" = 1 ] && echo "Codex sandbox 가 네트워크를 막음(아래 실패는 오프라인이 아님)"
+curl --ssl-no-revoke -sSI -o /dev/null --connect-timeout 5 --max-time 10 https://github.com   # 마켓플레이스(GitHub)
+```
+
+- `curl -sSI` 는 머리만 받는다(본문을 받지 않음). 닿지 못하면 종료 코드가 0 이 아니다(HTTP 상태와 관계없음). `curl` 은 `HTTPS_PROXY` 를 따른다. 확인 줄은 `--ssl-no-revoke` 를 준다. Windows 의 Git Bash curl 도 Schannel 이라, 폐지 목록 서버에 닿지 못하는 망에서 폐지 확인이 실패하면 종료 60 이다(Windows 박스 실측). 다른 curl 은 이 깃발을 받고 무시한다(macOS curl 8.7.1, Rocky 8.10 curl 7.61.1 실측).
+- Windows PowerShell 에서는 같은 주소를 `curl.exe --ssl-no-revoke -sSI -o NUL --connect-timeout 5 --max-time 10 <주소>` 로 보고 `$LASTEXITCODE` 가 0 인지 본다(PowerShell 5.1 의 `curl` 은 `Invoke-WebRequest` 별칭이다). `curl.exe` 는 Windows 시스템 프록시를 따르지 않고 `HTTPS_PROXY` 만 따른다. `--ssl-no-revoke` 는 폐지 목록 서버에 닿지 못하는 망에서 Schannel 의 폐지 확인 실패를 오프라인으로 읽지 않게 한다. 닿는지만 보고 받은 내용은 쓰지 않으므로 이 확인에만 준다. `curl.exe` 가 없으면 `$LASTEXITCODE` 에 앞 명령의 값이 남으므로 `Get-Command curl.exe -ErrorAction SilentlyContinue` 로 먼저 보고, 없으면 확인하지 못한 것으로 적는다.
+- 사내 미러만 열린 망이면 확인 주소를 그 미러로 바꿔 본다.
+- Codex sandbox 가 네트워크를 막는 모드(기본 `workspace-write`, `read-only`)에서는 `CODEX_SANDBOX_NETWORK_DISABLED=1` 이 서고 확인이 모두 실패한다(curl 종료 7, npm `EPERM`). 블록의 첫 줄이 그렇다고 알린다. 그때는 '오프라인' 이 아니라 'sandbox 가 네트워크를 막음' 으로 보고하고, 승인을 받아 sandbox 밖에서 확인부터 다시 한다. Claude Code sandbox 안(`SANDBOX_RUNTIME=1`)에서는 허용 목록 밖 주소를 sandbox 프록시가 막는다. Windows PowerShell 에서는 `$env:CODEX_SANDBOX_NETWORK_DISABLED -eq '1'` 로 본다.
+- 확인이 실패하면 보고에 그 명령, 종료 코드, stderr 첫 줄을 붙인다(예: `npm error code ETIMEDOUT`, `curl: (28) ...`). 원인을 '오프라인' 하나로 짐작하지 않는다.
+- curl 의 종료 60(인증서 검증 실패)도 오프라인이 아니다. 망은 열려 있고, TLS 를 가로채는 사내 프록시의 인증서를 OS 가 믿지 않는 것이다. '인증서 문제로 설치하지 않음' 으로 보고한다.
+
 ## Claude Code · 세션 안 (슬래시 커맨드)
 ```
 /plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git

package/skills/setup-java/SKILL.md

@@ -26,6 +26,25 @@ if (Get-Command java -ErrorAction SilentlyContinue) { java -version } else { "ja
 [Environment]::GetEnvironmentVariable('JAVA_HOME','User')
 ```
 
+### 네트워크 확인 (내려받기 전)
+
+이 스킬이 내려받는 원천에 10초 안에 닿는지 먼저 본다. 닿지 않으면 그 원천에서 받는 단계는 하지 않고, 이미 설치된 것의 확인만 한 뒤 "오프라인이라 설치하지 않음(필요한 것: <못 깐 것>)" 으로 보고한다.
+
+```bash
+[ "${CODEX_SANDBOX_NETWORK_DISABLED:-}" = 1 ] && echo "Codex sandbox 가 네트워크를 막음(아래 실패는 오프라인이 아님)"
+curl --ssl-no-revoke -sSI -o /dev/null --connect-timeout 5 --max-time 10 https://packages.adoptium.net   # Debian 12 의 Adoptium 저장소
+```
+
+- `curl -sSI` 는 머리만 받는다(본문을 받지 않음). 닿지 못하면 종료 코드가 0 이 아니다(HTTP 상태와 관계없음). `curl` 은 `HTTPS_PROXY` 를 따른다. 확인 줄은 `--ssl-no-revoke` 를 준다. Windows 의 Git Bash curl 도 Schannel 이라, 폐지 목록 서버에 닿지 못하는 망에서 폐지 확인이 실패하면 종료 60 이다(Windows 박스 실측). 다른 curl 은 이 깃발을 받고 무시한다(macOS curl 8.7.1, Rocky 8.10 curl 7.61.1 실측).
+- Windows PowerShell 에서는 같은 주소를 `curl.exe --ssl-no-revoke -sSI -o NUL --connect-timeout 5 --max-time 10 <주소>` 로 보고 `$LASTEXITCODE` 가 0 인지 본다(PowerShell 5.1 의 `curl` 은 `Invoke-WebRequest` 별칭이다). `curl.exe` 는 Windows 시스템 프록시를 따르지 않고 `HTTPS_PROXY` 만 따른다. `--ssl-no-revoke` 는 폐지 목록 서버에 닿지 못하는 망에서 Schannel 의 폐지 확인 실패를 오프라인으로 읽지 않게 한다. 닿는지만 보고 받은 내용은 쓰지 않으므로 이 확인에만 준다. `curl.exe` 가 없으면 `$LASTEXITCODE` 에 앞 명령의 값이 남으므로 `Get-Command curl.exe -ErrorAction SilentlyContinue` 로 먼저 보고, 없으면 확인하지 못한 것으로 적는다.
+- 사내 미러만 열린 망이면 확인 주소를 그 미러로 바꿔 본다.
+- OS 패키지 관리자(dnf, apt, brew, winget)의 단계는 자기 설정의 미러를 쓰므로 이 확인과 관계없이 시도하고, 실패하면 그 단계를 실패로 보고한다.
+  - 패킷을 버리거나 답하지 않는 망에서 dnf 는 저장소마다 약 2분(SYN 을 버리는 망 실측 121초), apt 는 원천마다 약 4분(답하지 않는 원천 실측 247초) 기다린 뒤 실패로 끝난다. 시간 제한은 관리자 설정을 따르므로 이 스킬이 바꾸지 않는다.
+  - `apt-get update` 는 받지 못해도 종료 0 이다. 출력의 `W: Failed to fetch` 가 있으면 그 단계를 실패로 보고한다.
+- Codex sandbox 가 네트워크를 막는 모드(기본 `workspace-write`, `read-only`)에서는 `CODEX_SANDBOX_NETWORK_DISABLED=1` 이 서고 확인이 모두 실패한다(curl 종료 7, npm `EPERM`). 블록의 첫 줄이 그렇다고 알린다. 그때는 '오프라인' 이 아니라 'sandbox 가 네트워크를 막음' 으로 보고하고, 승인을 받아 sandbox 밖에서 확인부터 다시 한다. Claude Code sandbox 안(`SANDBOX_RUNTIME=1`)에서는 허용 목록 밖 주소를 sandbox 프록시가 막는다. Windows PowerShell 에서는 `$env:CODEX_SANDBOX_NETWORK_DISABLED -eq '1'` 로 본다.
+- 확인이 실패하면 보고에 그 명령, 종료 코드, stderr 첫 줄을 붙인다(예: `npm error code ETIMEDOUT`, `curl: (28) ...`). 원인을 '오프라인' 하나로 짐작하지 않는다.
+- curl 의 종료 60(인증서 검증 실패)도 오프라인이 아니다. 망은 열려 있고, TLS 를 가로채는 사내 프록시의 인증서를 OS 가 믿지 않는 것이다. '인증서 문제로 설치하지 않음' 으로 보고한다.
+
 ## 1. Rocky Linux 8
 ```bash
 sudo dnf install -y java-21-openjdk-devel
@@ -51,7 +70,7 @@ export JAVA_HOME="$(dirname "$(dirname "$(readlink -f "$(command -v javac)")")")
 ⚠️ **default·backports 저장소 모두 JDK 21을 제공하지 않는다.** Adoptium 레포 추가가 유일한 경로(재확인: 배포판이 이후 21을 backport하면 이 단계는 생략 가능).
 ```bash
 sudo apt-get install -y wget gnupg
-wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | \
+wget -qO - --timeout=10 --tries=2 https://packages.adoptium.net/artifactory/api/gpg/key/public | \
   sudo gpg --dearmor -o /usr/share/keyrings/adoptium.gpg
 echo "deb [signed-by=/usr/share/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb bookworm main" | \
   sudo tee /etc/apt/sources.list.d/adoptium.list

package/skills/setup-lsp/SKILL.md

@@ -40,6 +40,44 @@ ls src/main/resources/application.* >/dev/null 2>&1 && echo "lang: spring"
 ```
 > Windows(PowerShell): `Get-Command claude,codex,npm,pipx,java`, `Test-Path tsconfig.json,pom.xml` 등으로 동일 감지. jdtls 는 `jdtls.bat`.
 
+### 네트워크 확인 (내려받기 전)
+
+이 스킬이 내려받는 원천에 닿는지 먼저 본다(curl 은 10초, npm 은 15초 안). 닿지 않으면 그 원천에서 받는 단계는 하지 않고, 이미 설치된 것의 확인만 한 뒤 "오프라인이라 설치하지 않음(필요한 것: <못 깐 것>)" 으로 보고한다.
+
+```bash
+[ "${CODEX_SANDBOX_NETWORK_DISABLED:-}" = 1 ] && echo "Codex sandbox 가 네트워크를 막음(아래 실패는 오프라인이 아님)"
+in15() { "$@" & p=$!; ( sleep 15 && kill "$p" ) > /dev/null 2>&1 & k=$!; wait "$p" 2>/dev/null; r=$?; kill "$k" 2>/dev/null; wait "$k" 2>/dev/null; [ "$r" = 143 ] && echo "15초 안에 끝나지 않아 멈춤(패킷을 버리는 망일 수 있음)"; return "$r"; }
+in15 sh -c 'cd ~ && exec npm ping --fetch-retries=0 --fetch-timeout=10000 --no-update-notifier'                              # ts, bash 서버(npm)
+# pip 이 읽는 설정 전부(PIP_CONFIG_FILE 포함)를 홈 폴더에서 읽는다. install 절이 global 절보다 앞선다
+L=$( (cd ~ && { pip config list || pip3 config list || python3.13 -m pip config list || python3.12 -m pip config list || python3.11 -m pip config list || python3 -m pip config list; }) 2>/dev/null) || echo "pip 설정을 읽지 못함(pip 이 없거나 10 미만). 사내 미러를 쓰면 확인 주소를 그 미러로 바꿔 본다"
+I="${PIP_INDEX_URL:-$(printf '%s\n' "$L" | sed -n "s/^install\.index-url='\(.*\)'$/\1/p")}"
+I="${I:-$(printf '%s\n' "$L" | sed -n "s/^global\.index-url='\(.*\)'$/\1/p")}"
+I=$(printf %s "${I:-https://pypi.org/simple}" | sed -E 's#^([A-Za-z][A-Za-z0-9+.-]*://)[^/]*@#\1#; s#/$##')   # 주소의 사용자 정보는 뗌
+printf 'url = "%s"\n' "$I/pip/" | curl --ssl-no-revoke -K - -sSI -o /dev/null --connect-timeout 5 --max-time 10   # py 서버(pipx)
+curl --ssl-no-revoke -sSI -o /dev/null --connect-timeout 5 --max-time 10 https://download.eclipse.org   # jdtls
+curl --ssl-no-revoke -sSI -o /dev/null --connect-timeout 5 --max-time 10 https://github.com             # lsp-mcp
+curl --ssl-no-revoke -sSI -o /dev/null --connect-timeout 5 --max-time 10 https://vmware.gallery.vsassets.io   # Spring Boot LS(VSIX)
+curl --ssl-no-revoke -sSI -o /dev/null --connect-timeout 5 --max-time 10 https://marketplace.visualstudio.com # Spring Boot LS(VSIX 대체 원천. 둘 중 하나만 닿아도 받을 수 있다)
+```
+
+- `npm ping` 은 홈 폴더에서 부른다. 지금 폴더에 있는 프로젝트의 `.npmrc` 가 정한 레지스트리와 토큰을 따르지 않게 하려는 것이다.
+- `npm ping` 은 15초 감시(`in15`) 안에서 부른다. 패킷을 버리는 망에서 npm 은 연결에 시간 제한을 두지 않아(`--fetch-timeout` 은 받는 중의 쉼만 잰다) OS 의 연결 재시도가 끝날 때까지 기다린다(Rocky 8.10 실측 130초). 15초 안에 끝나지 않으면 `15초 안에 끝나지 않아 멈춤(패킷을 버리는 망일 수 있음)` 과 종료 143 이다. `--no-update-notifier` 는 npm 이 제 판을 묻는 요청을 하나 더 내지 않게 한다.
+- `npm ping` 이 실패하면 ping 에 답하지 않는 사내 미러일 수 있다. `(cd ~ && T=$(mktemp -d) && { npm view bash-language-server version --fetch-retries=0 --fetch-timeout=10000 --cache "$T" --no-update-notifier; r=$?; rm -rf "$T"; exit $r; })` 도 실패해야 오프라인으로 본다. 이 스킬이 설치할 패키지(`bash-language-server`)를 빈 캐시로 물으므로 옛 값이 나올 수 없다. ping 이 15초 감시에 걸려 멈췄으면(종료 143) 이 확인은 하지 않는다. 같은 레지스트리라 같은 시간을 또 기다린다.
+- `npm` 이 없으면(명령 없음) 오프라인이 아니라 확인하지 못한 것이다. Node 를 먼저 갖춘다(`setup-node`).
+- `npm ping` 은 npm 의 프록시 설정(`proxy`, `https-proxy`)을 따른다. 사내 미러만 열린 망이면 그 미러가 쓰이는지 npm 설정을 본다.
+- `curl -sSI` 는 머리만 받는다(본문을 받지 않음). 닿지 못하면 종료 코드가 0 이 아니다(HTTP 상태와 관계없음). `curl` 은 `HTTPS_PROXY` 를 따른다. 확인 줄은 `--ssl-no-revoke` 를 준다. Windows 의 Git Bash curl 도 Schannel 이라, 폐지 목록 서버에 닿지 못하는 망에서 폐지 확인이 실패하면 종료 60 이다(Windows 박스 실측). 다른 curl 은 이 깃발을 받고 무시한다(macOS curl 8.7.1, Rocky 8.10 curl 7.61.1 실측).
+- PyPI 는 pip 이 쓰는 색인(`PIP_INDEX_URL`, `pip config list` 의 `install.index-url` 이나 `global.index-url`, 없으면 pypi.org)의 작은 쪽(`<색인>/pip/`)을 본다.
+- `pip config get` 은 `PIP_CONFIG_FILE` 로 준 파일을 읽지 않아(pip 25.0 실측) `pip config list` 를 읽는다.
+- Rocky 8 의 기본 pip(9.0.3, `pip3`)은 `config` 명령이 없고 `pip` 이름은 없다(Rocky 8.10 실측). 그래서 판 붙은 python(3.13, 3.12, 3.11)의 pip 도 차례로 본다.
+- 홈 폴더에서 읽는다. `python3 -m pip` 는 지금 폴더를 import 경로 맨 앞에 두어, 지금 폴더에 있는 남의 저장소의 `pip/` 가 실행될 수 있다.
+- bash 블록은 주소를 명령 인자가 아니라 표준 입력의 curl 설정(`-K -`)으로 넘긴다. 명령 인자는 같은 PC 의 다른 사용자가 `ps` 로 볼 수 있어, 경로나 질의에 든 토큰도 거기 싣지 않는다. 사용자 정보(`사용자:토큰@`)는 떼고 묻는다. 닿는지만 보므로 인증은 필요 없다(401 도 닿은 것이다). Windows 에서도 뗀 주소를 쓴다.
+- Windows PowerShell 에서는 같은 주소를 `curl.exe --ssl-no-revoke -sSI -o NUL --connect-timeout 5 --max-time 10 <주소>` 로 보고 `$LASTEXITCODE` 가 0 인지 본다(PowerShell 5.1 의 `curl` 은 `Invoke-WebRequest` 별칭이다). `curl.exe` 는 Windows 시스템 프록시를 따르지 않고 `HTTPS_PROXY` 만 따른다. `--ssl-no-revoke` 는 폐지 목록 서버에 닿지 못하는 망에서 Schannel 의 폐지 확인 실패를 오프라인으로 읽지 않게 한다. 닿는지만 보고 받은 내용은 쓰지 않으므로 이 확인에만 준다. `curl.exe` 가 없으면 `$LASTEXITCODE` 에 앞 명령의 값이 남으므로 `Get-Command curl.exe -ErrorAction SilentlyContinue` 로 먼저 보고, 없으면 확인하지 못한 것으로 적는다. `npm ping` 은 `Push-Location ~; npm ping --fetch-retries=0 --fetch-timeout=10000 --no-update-notifier; Pop-Location` 처럼 홈에서 부르고 돌아온다(돌아오지 않으면 뒤 단계가 프로젝트가 아니라 홈에서 돈다). PowerShell 에는 15초 감시를 두지 않는다(Windows 의 연결 시간 제한은 약 21초로 알려져 있다. 미실측).
+- 사내 미러만 열린 망이면 확인 주소를 그 미러로 바꿔 본다.
+- Codex sandbox 가 네트워크를 막는 모드(기본 `workspace-write`, `read-only`)에서는 `CODEX_SANDBOX_NETWORK_DISABLED=1` 이 서고 확인이 모두 실패한다(curl 종료 7, npm `EPERM`). 블록의 첫 줄이 그렇다고 알린다. 그때는 '오프라인' 이 아니라 'sandbox 가 네트워크를 막음' 으로 보고하고, 승인을 받아 sandbox 밖에서 확인부터 다시 한다. Claude Code sandbox 안(`SANDBOX_RUNTIME=1`)에서는 허용 목록 밖 주소를 sandbox 프록시가 막는다. Windows PowerShell 에서는 `$env:CODEX_SANDBOX_NETWORK_DISABLED -eq '1'` 로 본다.
+- 확인이 실패하면 보고에 그 명령, 종료 코드, stderr 첫 줄을 붙인다(예: `npm error code ETIMEDOUT`, `curl: (28) ...`). 원인을 '오프라인' 하나로 짐작하지 않는다.
+- curl 의 종료 60(인증서 검증 실패)도 오프라인이 아니다. 망은 열려 있고, TLS 를 가로채는 사내 프록시의 인증서를 OS 가 믿지 않는 것이다. '인증서 문제로 설치하지 않음' 으로 보고한다.
+- curl 은 닿는데 npm 만 인증서 오류(`UNABLE_TO_VERIFY_LEAF_SIGNATURE`, `SELF_SIGNED_CERT_IN_CHAIN`, `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`)로 실패하면 망은 열려 있고 npm 이 사내 인증서를 믿지 않는 것이다(npm 은 OS 인증서 저장소를 쓰지 않는다). '인증서 문제로 설치하지 않음' 으로 보고하고 `NODE_EXTRA_CA_CERTS=<사내 CA 파일>` 을 안내한다. Node 24 는 `NODE_OPTIONS=--use-system-ca` 도 된다.
+
 ## 1. 사전요구(preflight)
 
 각 서버는 선행 런타임이 필요하다 - **없으면 먼저 해당 setup 스킬을 실행**(추정·강행 금지):
@@ -86,10 +124,11 @@ for c in basedpyright-langserver ruff; do command -v $c >/dev/null && echo "✓
 **jdtls (Java LSP)** - Eclipse 최신 스냅샷:
 ```bash
 mkdir -p ~/.local/jdtls
-curl -fLo /tmp/jdtls.tar.gz \
-  "https://download.eclipse.org/jdtls/snapshots/jdt-language-server-latest.tar.gz"
-tar -xzf /tmp/jdtls.tar.gz -C ~/.local/jdtls
-rm /tmp/jdtls.tar.gz
+T=$(mktemp -d) \
+  && curl -fL --connect-timeout 10 --speed-limit 1000 --speed-time 30 -o "$T/jdtls.tar.gz" \
+       "https://download.eclipse.org/jdtls/snapshots/jdt-language-server-latest.tar.gz" \
+  && tar -xzf "$T/jdtls.tar.gz" -C ~/.local/jdtls
+rm -rf "$T"
 chmod +x ~/.local/jdtls/bin/jdtls
 which jdtls        # PATH 에 ~/.local/jdtls/bin 필요
 ```
@@ -97,28 +136,31 @@ which jdtls        # PATH 에 ~/.local/jdtls/bin 필요
 
 **Spring Boot Language Server** - VSIX(=ZIP) 다운로드. vsassets.io/marketplace 가 **HTML 에러페이지**를 반환할 수 있어 **ZIP 매직바이트(`504b0304`) 검증** 후 `find` 로 `*-exec.jar` 탐색 + 심볼릭 링크:
 ```bash
+(
 set -euo pipefail
-TARGET="$HOME/.local/spring-boot-ls"; VSIX=/tmp/sbls.vsix; LINK=spring-boot-language-server.jar
+TARGET="$HOME/.local/spring-boot-ls"; T=$(mktemp -d); trap 'rm -rf "$T"' EXIT; VSIX="$T/sbls.vsix"; LINK=spring-boot-language-server.jar
 mkdir -p "$TARGET"
 VSIX_URL="https://vmware.gallery.vsassets.io/_apis/public/gallery/publisher/vmware/extension/vscode-spring-boot/latest/assetbyname/Microsoft.VisualStudio.Services.VSIXPackage"
 FALLBACK="https://marketplace.visualstudio.com/_apis/public/gallery/publishers/vmware/vsextensions/vscode-spring-boot/latest/vspackage"
-curl -fL --connect-timeout 30 --retry 2 -H "User-Agent: Mozilla/5.0" -o "$VSIX" "$VSIX_URL" 2>/dev/null \
-  || curl -fL --connect-timeout 30 --retry 2 -H "User-Agent: Mozilla/5.0" -o "$VSIX" "$FALLBACK"
+curl -fL --connect-timeout 30 --speed-limit 1000 --speed-time 30 --retry 2 -H "User-Agent: Mozilla/5.0" -o "$VSIX" "$VSIX_URL" 2>/dev/null \
+  || curl -fL --connect-timeout 30 --speed-limit 1000 --speed-time 30 --retry 2 -H "User-Agent: Mozilla/5.0" -o "$VSIX" "$FALLBACK"
 # ZIP 매직 검증 (HTML 에러페이지면 즉시 중단)
 [ "$(xxd -l 4 "$VSIX" | awk 'NR==1{print $2$3}')" = "504b0304" ] \
   || { echo "✗ ZIP 아님(HTML 에러페이지?)"; rm -f "$VSIX"; exit 1; }
-rm -rf "${TARGET:?}"/*; unzip -o -q "$VSIX" -d "$TARGET"
+find "${TARGET:?}" -mindepth 1 -delete; unzip -o -q "$VSIX" -d "$TARGET"   # 글롭 없이 비움(zsh 는 빈 폴더의 * 에서 멈춤)
 JAR=$(find "$TARGET" -name "spring-boot-language-server-*-exec.jar" | sort -V | tail -1)
 [ -n "$JAR" ] || { echo "✗ exec.jar 미발견"; rm -f "$VSIX"; exit 1; }
 ln -sf "$(basename "$JAR")" "$(dirname "$JAR")/$LINK"     # 디렉토리 이동에도 유효한 상대 링크
 rm -f "$VSIX"; find ~/.local/spring-boot-ls -name "$LINK" -ls
+)
 ```
+블록 전체가 괄호 안의 서브셸에서 돈다. `set -e`, EXIT trap, `exit 1` 이 이 블록 안에만 머물러, 같은 셸의 다음 명령을 끝내거나 그 셸이 끝날 때 다른 `T` 를 지우지 않는다.
 > Windows: 심볼릭 링크는 **개발자 모드/관리자 권한** 필요 → 없으면 `Copy-Item` 복사 fallback(둘 다 동작). 매직검증·find 는 PowerShell 로 동일 수행, JAR 경로는 `.Replace('\','/')`. RHEL8 에 `xxd` 없으면 `dnf install -y vim-common` 또는 `od -An -tx1 -N4`.
 
 ## 6. lsp-mcp 브리지 설치 (Codex 경로 - Claude Code 는 건너뜀)
 ```bash
 mkdir -p ~/.local/src
-git clone https://github.com/CesarPetrescu/lsp-mcp.git ~/.local/src/lsp-mcp
+git -c http.lowSpeedLimit=1000 -c http.lowSpeedTime=30 clone https://github.com/CesarPetrescu/lsp-mcp.git ~/.local/src/lsp-mcp
 pipx install --editable ~/.local/src/lsp-mcp     # → ~/.local/bin/codex-lsp-bridge (Windows: .exe)
 which codex-lsp-bridge && codex-lsp-bridge --help | head -5
 ```
@@ -144,7 +186,7 @@ language_id = "spring-boot-properties"
 EOF
 # TOML 유효성 (중복/문법오류 즉시 감지). tomllib 는 Python 3.11+ - RHEL8/Rocky8 기본 python3(3.6)면 setup-python 의 3.11 을 쓴다:
 PY="$(command -v python3.12 || command -v python3.11 || command -v python3)"
-"$PY" -c "import tomllib; tomllib.loads(open('config/default.toml',encoding='utf-8').read()); print('OK lsp-mcp TOML')" 2>/dev/null \
+(cd ~ && "$PY" -c "import tomllib; tomllib.loads(open('$HOME/.local/src/lsp-mcp/config/default.toml',encoding='utf-8').read()); print('OK lsp-mcp TOML')") 2>/dev/null \
   || echo "⚠ tomllib(3.11+) 미가용 - append 는 위 grep guard 로 이미 적용됨, setup-python 설치 후 재검증"
 cd - >/dev/null
 ```
@@ -156,7 +198,7 @@ cd - >/dev/null
 ### 7-Codex - `[mcp_servers.lsp_bridge]` 등록
 OMX 가 배포한 기존 엔트리를 보존하려 **Python replace-or-append** 로 patch(전체 덮어쓰기 금지):
 ```bash
-python3 - << 'PY'
+(cd ~ && python3 - << 'PY'   # 홈에서: -c, -m, 표준 입력 스크립트는 지금 폴더의 모듈을 먼저 불러온다
 import re
 from pathlib import Path
 home = str(Path.home())                        # Windows: str(Path.home()).replace("\\","/")
@@ -178,8 +220,9 @@ txt = rep(txt, "mcp_servers.lsp_bridge", block + "\n")
 p.write_text(txt, encoding="utf-8")            # Windows: encoding 필수(CP949 회피)
 print("patched")
 PY
+)
 PY="$(command -v python3.12 || command -v python3.11 || command -v python3)"   # tomllib=3.11+
-"$PY" -c "import tomllib; tomllib.loads(open('$HOME/.codex/config.toml',encoding='utf-8').read()); print('OK config.toml valid')" 2>/dev/null \
+(cd ~ && "$PY" -c "import tomllib; tomllib.loads(open('$HOME/.codex/config.toml',encoding='utf-8').read()); print('OK config.toml valid')") 2>/dev/null \
   || echo "⚠ tomllib(3.11+) 미가용 - patch 는 적용됨, setup-python 후 재검증"
 ```
 
@@ -213,7 +256,7 @@ jdtls --version 2>/dev/null || which jdtls           # Windows: jdtls.bat
 codex-lsp-bridge --help | head -3
 grep -q 'lsp_bridge' ~/.codex/config.toml && echo "✓ config.toml lsp_bridge" || echo "✗ 미등록"
 PY="$(command -v python3.12 || command -v python3.11 || command -v python3)"   # tomllib=3.11+
-"$PY" -c "import tomllib; tomllib.loads(open('$HOME/.codex/config.toml',encoding='utf-8').read()); print('✓ config.toml valid')" 2>/dev/null || echo "⚠ tomllib(3.11+) 미가용 - setup-python 후 재검증"
+(cd ~ && "$PY" -c "import tomllib; tomllib.loads(open('$HOME/.codex/config.toml',encoding='utf-8').read()); print('✓ config.toml valid')") 2>/dev/null || echo "⚠ tomllib(3.11+) 미가용 - setup-python 후 재검증"
 # Claude 만: lsp_servers 도구로 인식 서버 나열
 ```
 4-field 보고: **변경**(설치 서버·브리지·config 배선) / **Evidence**(위 --version·valid 출력) / **검증**(각 서버 응답 + 브리지·config TOML valid + 런타임 인식) / **Unknown**(네트워크 차단으로 미설치·JDK 21 부재로 java/spring 스킵 등).