pattyeng 1.0.4 → 1.0.7

package/README.md

@@ -1,94 +1,154 @@
-# pattyeng 🐾
+# pattyeng
 
-> Patty 엔지니어로 살아남기 위한 첫 번째 관문
+Patty 엔지니어용 작업 환경 도구.
 
-입사 첫날, 아무도 Codex 어떻게 설치하는지 안 알려줬죠?  
-이거 하나면 됩니다.
+새 노트북이든, WSL이든, 오래 방치한 개발환경이든 — Patty에서 일하는 데 필요한 기본 세팅을 한 번에 맞춥니다.
+
+지금은 Codex 설정, 스킬 동기화, 업그레이드를 담당합니다. 앞으로는 MCP, hooks, 공통 환경설정까지 같은 방식으로 붙일 예정입니다.
 
 ---
 
-## 뭐 하는 툴임?
+## 설치
+
+```bash
+npm install -g pattyeng
+```
 
-명령어 하나로:
+설치 후 아래 명령어로 시작합니다.
 
-- Codex 설치 + 최신 버전 업데이트
-- Patty SSO 로그인 (브라우저 자동 열림)
-- API 키 환경변수 자동 등록
-- `codex` 명령어에 Patty 설정 자동 연결
+```bash
+pattyeng install codex
+```
 
-손으로 할 거 다 해줌. 커피나 타세요.
+브라우저가 열리면 Patty 계정으로 로그인하세요. 로그인 후 필요한 값은 자동으로 설정됩니다.
 
 ---
 
-## 사전 조건
+## 명령어
 
-- Node.js 18+
-- `@patty.io` 계정
-- `pattyeng` 그룹 멤버 (아직 아니면 관리자한테 Slack DM)
+### `pattyeng install codex`
 
----
+Codex를 Patty 환경에 맞게 세팅합니다.
 
-## 시작
+처리하는 일:
 
-**1. 설치**
+- Codex 설치 확인
+- Codex 최신 버전 업데이트
+- Patty 설정 파일 복사
+- Patty SSO 로그인
+- `PATTY_AGENT_API_KEY` 등록
+- `codex` 명령어가 Patty 프로필을 쓰도록 설정
+
+실행:
 
 ```bash
-npm install -g pattyeng
+pattyeng install codex
 ```
 
-**2. 실행**
+마지막에 터미널만 다시 불러오면 됩니다.
+
+macOS / Linux / WSL:
 
 ```bash
-pattyeng install codex
+exec zsh    # zsh 사용자
+exec bash   # bash 사용자
+```
+
+Windows:
+
+```text
+터미널을 닫고 새로 열기
 ```
 
-브라우저 열리면 Patty 계정으로 로그인하세요.  
-그게 끝임. 진짜로.
+---
 
-**3. 터미널 재시작**
+### `pattyeng upgrade`
+
+로컬 도구를 최신 상태로 맞춥니다.
 
 ```bash
-exec zsh    # zsh
-exec bash   # bash
+pattyeng upgrade
 ```
 
-Windows면 그냥 터미널 껐다 켜세요.
+업데이트 대상:
+
+- `pattyeng`
+- Codex CLI
 
 ---
 
-## 잘 됐는지 확인
+### `pattyeng skills list`
+
+설치된 스킬 이름을 짧게 봅니다.
 
 ```bash
-codex "나 이제 Patty 엔지니어임?"
+pattyeng skills list
 ```
 
-뭔가 응답 오면 성공입니다 🎉
+설명까지 보고 싶으면:
 
----
+```bash
+pattyeng skills list --long
+```
 
-## 뭔가 잘못됨?
+---
 
-**브라우저가 안 열려요**  
-터미널에 출력된 `🔗 로그인 URL` 복사해서 브라우저에 그냥 붙여넣기
+### `pattyeng skills sync`
 
-**"pattyeng 그룹에 없다"고 함**  
-관리자한테 그룹 추가 요청하세요. 당신 잘못 아님.
+Patty dotfiles에 있는 최신 스킬을 `~/.codex/skills`로 동기화합니다.
 
-**codex 명령어 없다고 함**  
 ```bash
-npm install -g @openai/codex
+pattyeng skills sync
 ```
 
-**Windows에서 뭔가 터짐**  
-터미널 관리자 권한으로 열고 다시 시도
+스킬이 바뀌었거나 새로 추가됐을 때 실행하면 됩니다.
 
 ---
 
 ## 지원 환경
 
-macOS, Linux, WSL2, Windows — 다 됩니다.  
-IE는 지원 안 함 (당연히)
+- macOS
+- Linux
+- WSL 2
+- Windows PowerShell
+- Windows CMD
+
+Node.js 18 이상이 필요합니다.
+
+---
+
+## 자주 나는 문제
+
+### 브라우저가 자동으로 안 열림
+
+터미널에 출력된 로그인 URL을 복사해서 브라우저에 붙여넣으세요.
+
+### `pattyeng` 그룹이 아니라고 나옴
+
+Patty 관리자에게 `pattyeng` 그룹 추가를 요청하세요.
+
+### 환경변수가 바로 안 잡힘
+
+새 터미널을 열거나 아래 명령어를 실행하세요.
+
+```bash
+exec zsh
+# 또는
+exec bash
+```
+
+Windows는 터미널을 닫고 새로 열면 됩니다.
+
+### Codex가 이상하게 동작함
+
+한 번 업데이트하세요.
+
+```bash
+pattyeng upgrade
+```
 
 ---
 
-문제 있으면 Slack으로. 이슈 올려도 됨.
+## 한 줄 요약
+
+Patty에서 쓰는 개발환경 세팅을 사람 손 덜 타게 만드는 도구입니다.

package/bin/pattyeng.js

@@ -1,10 +1,17 @@
 #!/usr/bin/env node
 'use strict';
 
+process.stdout.on('error', (err) => {
+  if (err.code === 'EPIPE') process.exit(0);
+  throw err;
+});
+
 const { install } = require('../lib/install');
+const { upgrade } = require('../lib/upgrade');
+const { skills }  = require('../lib/skills');
 
-const args = process.argv.slice(2);
-const cmd = args[0];
+const args   = process.argv.slice(2);
+const cmd    = args[0];
 const subcmd = args[1];
 
 async function main() {
@@ -16,6 +23,15 @@ async function main() {
         console.log('\n사용법: pattyeng install codex\n');
       }
       break;
+
+    case 'upgrade':
+      await upgrade();
+      break;
+
+    case 'skills':
+      await skills(args.slice(1));
+      break;
+
     default:
       printHelp();
   }
@@ -24,23 +40,18 @@ async function main() {
 function printHelp() {
   console.log(`
 ╔══════════════════════════════════════════╗
-║        pattyeng CLI v1.0.0               ║
+║        pattyeng CLI                      ║
 ╚══════════════════════════════════════════╝
 
-사용법 (Usage):
-  pattyeng install codex    Codex 설치 및 SSO 로그인 설정
-
-명령어 (Commands):
-  install codex - Codex 설치, 최신 버전 업데이트, Patty SSO 로그인,
-                  API 키 환경변수 설정, alias 등록을 한번에 수행합니다.
-  help          - 이 도움말을 표시합니다.
-
-예시 (Examples):
-  pattyeng install codex
+명령어:
+  install codex    Codex 설치 + SSO 로그인 + 환경설정
+  upgrade          pattyeng, Codex 최신 버전으로 업데이트
+  skills list      설치된 스킬 목록
+  skills sync      스킬 최신 버전으로 동기화
 `);
 }
 
 main().catch((err) => {
-  console.error('\n❌ 오류 발생:', err.message);
+  console.error('\n❌ 오류:', err.message);
   process.exit(1);
 });

package/lib/skills.js

@@ -0,0 +1,198 @@
+'use strict';
+
+const { execSync } = require('child_process');
+const fs   = require('fs');
+const path = require('path');
+const os   = require('os');
+
+const HOME       = os.homedir();
+const DEST_DIR   = path.join(HOME, '.codex', 'skills');
+
+// Source: npm registry tarball for pattyeng — skills are bundled inside package
+// Fallback: look for dotfiles repo next to package install location
+function findSourceSkillsDir() {
+  const candidates = [
+    // bundled inside the npm package itself (skills/ at package root)
+    path.join(__dirname, '..', 'skills'),
+    // dotfiles repo sibling
+    path.join(__dirname, '..', '..', 'skills'),
+    path.join(__dirname, '..', '..', 'dotfiles', 'skills'),
+  ];
+  return candidates.find(d => fs.existsSync(d) && fs.statSync(d).isDirectory()) || null;
+}
+
+function log(msg)  { process.stdout.write(msg + '\n'); }
+function step(msg) { log(`\n🔧 ${msg}`); }
+function ok(msg)   { log(`✅ ${msg}`); }
+function warn(msg) { log(`⚠️  ${msg}`); }
+function info(msg) { log(`   ${msg}`); }
+
+// Read SKILL.md name/description
+function readSkillMeta(skillDir) {
+  const mdPath = path.join(skillDir, 'SKILL.md');
+  if (!fs.existsSync(mdPath)) return { name: path.basename(skillDir), description: '' };
+  const content = fs.readFileSync(mdPath, 'utf8');
+  const nameMatch = content.match(/^name:\s*(.+)$/m);
+  const descMatch = content.match(/^description:\s*(.+)$/m);
+  return {
+    name:        cleanYamlScalar(nameMatch ? nameMatch[1] : path.basename(skillDir)),
+    description: descMatch ? cleanYamlScalar(descMatch[1]) : '',
+  };
+}
+
+function cleanYamlScalar(value) {
+  return String(value || '')
+    .trim()
+    .replace(/^['\"]|['\"]$/g, '')
+    .replace(/^>\s*/, '')
+    .trim();
+}
+
+function cleanDescription(value) {
+  const cleaned = cleanYamlScalar(value).replace(/\s+/g, ' ');
+  return cleaned.length > 82 ? cleaned.slice(0, 79) + '...' : cleaned;
+}
+
+// Diff two SKILL.md files — returns true if different
+function isDifferent(srcFile, destFile) {
+  if (!fs.existsSync(destFile)) return true;
+  return fs.readFileSync(srcFile, 'utf8') !== fs.readFileSync(destFile, 'utf8');
+}
+
+// Copy a skill folder recursively
+function copySkill(srcDir, destDir) {
+  if (!fs.existsSync(destDir)) fs.mkdirSync(destDir, { recursive: true });
+  for (const file of fs.readdirSync(srcDir)) {
+    const src  = path.join(srcDir, file);
+    const dest = path.join(destDir, file);
+    if (fs.statSync(src).isDirectory()) {
+      copySkill(src, dest);
+    } else {
+      fs.copyFileSync(src, dest);
+    }
+  }
+}
+
+async function skills(args) {
+  const sub = args[0];
+
+  if (!sub || sub === 'list') {
+    return listSkills(args.includes('--long'));
+  }
+  if (sub === 'sync') {
+    return syncSkills();
+  }
+
+  log(`\n사용법:\n  pattyeng skills list          — 스킬 이름만 보기\n  pattyeng skills list --long   — 설명까지 보기\n  pattyeng skills sync          — 스킬 최신 버전으로 동기화\n`);
+}
+
+function listSkills(long = false) {
+  log(`\n📚 스킬 목록 (${DEST_DIR})\n`);
+
+  if (!fs.existsSync(DEST_DIR)) {
+    warn('~/.codex/skills 폴더가 없습니다. pattyeng skills sync 를 먼저 실행하세요.');
+    return;
+  }
+
+  const skills = fs.readdirSync(DEST_DIR).filter(f => {
+    try { return fs.statSync(path.join(DEST_DIR, f)).isDirectory(); }
+    catch { return false; } // broken symlink — skip
+  });
+
+  if (skills.length === 0) {
+    warn('스킬이 없습니다. pattyeng skills sync 를 실행하세요.');
+    return;
+  }
+
+  const names = skills
+    .sort()
+    .map(skill => readSkillMeta(path.join(DEST_DIR, skill)).name)
+    .filter(name => !name.startsWith('.'));
+
+  if (!long) {
+    const width = Math.max(18, ...names.map(n => n.length + 2));
+    for (let i = 0; i < names.length; i += 3) {
+      log('  ' + names.slice(i, i + 3).map(n => n.padEnd(width)).join(''));
+    }
+    log(`\n  총 ${names.length}개. 설명 보기: pattyeng skills list --long\n`);
+    return;
+  }
+
+  for (const skill of skills.sort()) {
+    const meta = readSkillMeta(path.join(DEST_DIR, skill));
+    if (meta.name.startsWith('.')) continue;
+    const desc = cleanDescription(meta.description);
+    log(`  • ${meta.name.padEnd(20)} ${desc ? `— ${desc}` : ''}`);
+  }
+  log('');
+}
+
+function syncSkills() {
+  log(`
+╔══════════════════════════════════════════╗
+║   pattyeng skills sync 시작              ║
+╚══════════════════════════════════════════╝
+`);
+
+  const srcDir = findSourceSkillsDir();
+  if (!srcDir) {
+    warn('스킬 소스 폴더를 찾을 수 없습니다.');
+    warn('dotfiles 저장소가 있어야 합니다: ~/projects/dotfiles/skills/');
+    process.exit(1);
+  }
+  log(`  소스: ${srcDir}`);
+  log(`  대상: ${DEST_DIR}\n`);
+
+  if (!fs.existsSync(DEST_DIR)) fs.mkdirSync(DEST_DIR, { recursive: true });
+
+  const srcSkills  = fs.readdirSync(srcDir).filter(f =>
+    fs.statSync(path.join(srcDir, f)).isDirectory()
+  );
+
+  let added   = 0;
+  let updated = 0;
+  let skipped = 0;
+
+  for (const skill of srcSkills.sort()) {
+    const src  = path.join(srcDir, skill);
+    const dest = path.join(DEST_DIR, skill);
+    const meta = readSkillMeta(src);
+    const srcMd  = path.join(src, 'SKILL.md');
+    const destMd = path.join(dest, 'SKILL.md');
+
+    const destExists = fs.existsSync(dest);
+    const destLstat  = destExists ? null : null, lstat = (() => { try { return fs.lstatSync(dest); } catch { return null; } })();
+    const isSymlink  = lstat && lstat.isSymbolicLink();
+    const alreadyPointsHere = isSymlink && fs.readlinkSync(dest) === src;
+
+    if (!lstat) {
+      // doesn’t exist at all
+      fs.symlinkSync(src, dest);
+      log(`  ✨ 새로 추가: ${meta.name}`);
+      added++;
+    } else if (alreadyPointsHere) {
+      // already correct symlink
+      skipped++;
+    } else if (isSymlink) {
+      // symlink pointing somewhere else — update
+      fs.unlinkSync(dest);
+      fs.symlinkSync(src, dest);
+      log(`  🔄 업데이트: ${meta.name}`);
+      updated++;
+    } else if (isDifferent(srcMd, destMd)) {
+      // real dir with changed content — overwrite
+      copySkill(src, dest);
+      log(`  🔄 업데이트: ${meta.name}`);
+      updated++;
+    } else {
+      skipped++;
+    }
+  }
+
+  log(`
+  추가: ${added}개   업데이트: ${updated}개   변경없음: ${skipped}개
+
+✅ 스킬 동기화 완료`);
+}
+
+module.exports = { skills };

package/lib/upgrade.js

@@ -0,0 +1,46 @@
+'use strict';
+
+const { execSync } = require('child_process');
+
+function log(msg)  { process.stdout.write(msg + '\n'); }
+function step(msg) { log(`\n🔧 ${msg}`); }
+function ok(msg)   { log(`✅ ${msg}`); }
+function warn(msg) { log(`⚠️  ${msg}`); }
+
+async function upgrade() {
+  log(`
+╔══════════════════════════════════════════╗
+║   pattyeng upgrade 시작                  ║
+╚══════════════════════════════════════════╝
+`);
+
+  // 1. pattyeng itself
+  step('pattyeng 최신 버전으로 업데이트 중...');
+  try {
+    const before = execSync('npm list -g pattyeng --depth=0 2>/dev/null', { encoding: 'utf8' }).trim();
+    execSync('npm install -g pattyeng@latest', { stdio: 'inherit' });
+    const after = execSync('npm list -g pattyeng --depth=0 2>/dev/null', { encoding: 'utf8' }).trim();
+    if (before !== after) {
+      ok('pattyeng 업데이트 완료');
+    } else {
+      ok('pattyeng 이미 최신 버전');
+    }
+  } catch (e) {
+    warn('pattyeng 업데이트 실패: ' + e.message);
+  }
+
+  // 2. codex
+  step('Codex 최신 버전으로 업데이트 중...');
+  try {
+    execSync('npm install -g @openai/codex@latest', { stdio: 'inherit' });
+    ok('Codex 업데이트 완료');
+  } catch (e) {
+    warn('Codex 업데이트 실패: ' + e.message);
+  }
+
+  log(`
+✨ 업그레이드 완료!
+`);
+}
+
+module.exports = { upgrade };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pattyeng",
-  "version": "1.0.4",
+  "version": "1.0.7",
   "description": "Patty Engineering CLI - Codex SSO setup tool",
   "bin": {
     "pattyeng": "./bin/pattyeng.js"
@@ -26,7 +26,9 @@
     "access": "public"
   },
   "files": [
-    "bin/",
-    "lib/"
+    "bin",
+    "lib",
+    "skills",
+    "README.md"
   ]
 }

package/skills/.system/.codex-system-skills.marker

@@ -0,0 +1 @@
+66eb33bbe0eb99ac