leerness 1.8.0 → 1.9.1

package/docs/PUBLISH_PRECHECK.md

@@ -0,0 +1,93 @@
+# Publish Pre-check (leerness 1.9.0)
+
+> ⚠ **Owner 권한 필수**: npm `leerness`의 메인테이너는 `gytlrgpfl <gytlrgpfl96@gmail.com>` 입니다. 이 계정으로 로그인되어 있거나 collaborator로 등록되어 있어야 publish가 통과합니다. 권한이 없으면 `E403 Forbidden`이 떨어집니다.
+
+## 1. 메타데이터 보강 (선택)
+
+`package.json`의 다음 필드는 비어 있거나 일반적입니다. 사용자 정보로 채우는 것을 권장합니다.
+
+```json
+{
+  "author": "leerness contributors",
+  "repository": { /* 비어있음 */ },
+  "bugs": { /* 비어있음 */ },
+  "homepage": ""
+}
+```
+
+예:
+
+```json
+"author": "Your Name <you@example.com>",
+"repository": { "type": "git", "url": "git+https://github.com/<user>/leerness.git" },
+"bugs": { "url": "https://github.com/<user>/leerness/issues" },
+"homepage": "https://github.com/<user>/leerness#readme"
+```
+
+publish 필수는 아니지만, npm 페이지 신뢰도와 사용자 경험을 위해 채워두면 좋습니다.
+
+## 2. 권한 확인
+
+```bash
+npm whoami
+# → 응답이 leerness의 owner인지 확인
+npm owner ls leerness
+# → 자신의 계정이 목록에 있는지 확인
+```
+
+권한이 없으면 collaborator 추가를 owner에게 요청해야 합니다.
+
+## 3. 로컬 검증
+
+```bash
+node ./bin/harness.js --version    # → 1.9.0
+npm pack --dry-run                 # 패키지 내용 미리보기
+node ./scripts/e2e.js              # 30+개 시나리오 통과
+```
+
+## 4. 1.8.0 → 1.9.0 자동 업그레이드 시연 (선택)
+
+```bash
+mkdir /tmp/lr-old; cd /tmp/lr-old
+npx -y leerness@1.8.0 init . --language ko --skills recommended
+LEERNESS_OFFLINE=1 npx -y -p /path/to/leerness-1.9.0.tgz leerness update . --yes
+cat .harness/HARNESS_VERSION       # → 1.9.0
+```
+
+## 5. publish dry-run
+
+```bash
+npm publish --dry-run
+# 또는
+npm publish leerness-1.9.0.tgz --dry-run
+```
+
+확인:
+- `package.json#files`와 실제 tarball 내용 일치
+- 총 크기 (≈30~40 kB)
+- bin → harness.js 매핑
+
+## 6. 실 publish
+
+```bash
+npm login                  # 권한 있는 계정으로
+npm publish --access public
+```
+
+## 7. publish 후 검증
+
+```bash
+npm view leerness version          # → 1.9.0
+npx -y leerness@latest --version   # → 1.9.0
+mkdir test-install && cd test-install
+npx -y leerness@latest init . --yes --language ko --skills recommended
+npx -y leerness@latest verify .
+```
+
+## 8. 롤백
+
+24시간 이내라면 `npm unpublish leerness@1.9.0` 가능. 이후엔 1.9.1 패치 또는 deprecate.
+
+```bash
+npm deprecate leerness@1.9.0 "Use 1.9.1+"
+```

package/package.json

@@ -1,49 +1,52 @@
 {
   "name": "leerness",
-  "version": "1.8.0",
-  "description": "Leerness: 비파괴 마이그레이션, 언어/스킬 선택 설치, 계획/작업 추적, 스킬 라이브러리, 디자인/기능 일관성을 관리하는 AX 최적화 AI 개발 하네스.",
+  "version": "1.9.1",
+  "description": "Leerness: 비파괴 마이그레이션, 자동 버전 감지·업데이트, 계획/진행/핸드오프 자동화, 게으름·시크릿·인코딩 자동 가드, Claude Code 슬래시 통합을 갖춘 한국어 우선 AI 개발 하네스.",
   "keywords": [
     "leerness",
     "ai",
     "agent",
     "harness",
     "context-engineering",
+    "claude",
+    "claude-code",
+    "cursor",
+    "copilot",
     "skill-library",
     "project-memory",
     "task-tracking",
     "planning",
+    "handoff",
+    "anti-laziness",
+    "encoding",
+    "secret-scan",
+    "auto-update",
     "design-system",
-    "developer-tools"
+    "developer-tools",
+    "korean"
   ],
+  "license": "MIT",
+  "author": "leerness contributors",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
   "bin": {
-    "leerness": "./bin/harness.js"
+    "leerness": "bin/harness.js"
   },
   "files": [
-    "bin/",
-    "skill-packs/",
-    "docs/",
-    "harness.js",
+    "bin",
+    "scripts",
+    "docs",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "scripts": {
-    "test": "node ./bin/harness.js --help && node ./bin/harness.js init --yes --language ko --skills office,commerce-api ./tmp-harness-test && node ./bin/harness.js status ./tmp-harness-test && node ./bin/harness.js plan add '테스트 계획' --path ./tmp-harness-test && node ./bin/harness.js readme sync ./tmp-harness-test && node ./bin/harness.js consistency check ./tmp-harness-test && node ./bin/harness.js debug ./tmp-harness-test && node ./bin/harness.js verify ./tmp-harness-test",
+    "test": "node ./bin/harness.js --version && node ./scripts/e2e.js",
+    "test:smoke": "node ./scripts/e2e.js",
     "prepack": "node ./bin/harness.js --version"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/gugu9999gu/leerness.git"
-  },
-  "bugs": {
-    "url": "https://github.com/gugu9999gu/leerness/issues"
-  },
-  "homepage": "https://github.com/gugu9999gu/leerness#readme",
-  "author": "gugu9999gu",
-  "license": "MIT",
-  "type": "commonjs",
-  "engines": {
-    "node": ">=18"
-  },
   "publishConfig": {
     "access": "public"
   }

package/scripts/e2e.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const cp = require('child_process');
+
+const CLI = path.resolve(__dirname, '..', 'bin', 'harness.js');
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-e2e-'));
+let failed = 0; let total = 0;
+
+function run(label, args, opts = {}) {
+  total++;
+  const r = cp.spawnSync(process.execPath, [CLI, ...args], { cwd: opts.cwd || tmp, encoding: 'utf8' });
+  const ok = (r.status === 0) === !opts.expectFail;
+  process.stdout.write(`${ok ? '✓' : '✗'} ${label} (exit=${r.status})\n`);
+  if (!ok) { failed++; process.stdout.write(r.stdout || ''); process.stderr.write(r.stderr || ''); }
+  return { ok, stdout: r.stdout || '', stderr: r.stderr || '', status: r.status };
+}
+
+console.log(`# leerness e2e smoke @ ${tmp}`);
+
+run('init',                ['init', tmp, '--yes', '--language', 'ko', '--skills', 'recommended']);
+run('status',              ['status', tmp]);
+run('verify',              ['verify', tmp]);
+run('debug',               ['debug', tmp]);
+run('check',               ['check', tmp]);
+run('audit',               ['audit', tmp]);
+run('scan secrets',        ['scan', 'secrets', tmp]);
+run('encoding check',      ['encoding', 'check', tmp]);
+
+const secretFile = path.join(tmp, 'fake-config.json');
+fs.writeFileSync(secretFile, JSON.stringify({ openai: 'sk-' + 'A'.repeat(48) }));
+run('scan secrets (detect)', ['scan', 'secrets', tmp], { expectFail: true });
+fs.unlinkSync(secretFile);
+
+run('plan add 1',          ['plan', 'add', '마일스톤 A', '--status', 'planned', '--path', tmp]);
+run('plan add 2',          ['plan', 'add', '마일스톤 B', '--status', 'in-progress', '--path', tmp]);
+run('task add',            ['task', 'add', '사용자 요청 X', '--status', 'requested', '--path', tmp]);
+run('task update T-0001',  ['task', 'update', 'T-0001', '--status', 'in-progress', '--next', '검증 실행', '--path', tmp]);
+run('task update T-0001 done', ['task', 'update', 'T-0001', '--status', 'done', '--evidence', 'review-evidence:e2e', '--path', tmp]);
+
+const tracker = fs.readFileSync(path.join(tmp, '.harness/progress-tracker.md'), 'utf8');
+const t1Count = (tracker.match(/^\| T-0001 \|/gm) || []).length;
+total++;
+if (t1Count === 1) console.log('✓ B1 in-place update: T-0001 row count = 1');
+else { failed++; console.log(`✗ B1 in-place update FAILED: T-0001 row count = ${t1Count} (expected 1)`); }
+
+fs.appendFileSync(path.join(tmp, '.harness/review-evidence.md'),
+  '\n## e2e\nTask: T-0001\nCommand: npm test\nExit: 0\nNote: e2e smoke\n');
+
+run('session close',       ['session', 'close', tmp]);
+run('handoff',             ['handoff', tmp]);
+run('audit (post close)',  ['audit', tmp]);
+run('lazy detect',         ['lazy', 'detect', tmp]);
+run('memory search',       ['memory', 'search', '마일스톤', '--path', tmp]);
+
+const offline = Object.assign({}, process.env, { LEERNESS_OFFLINE: '1' });
+total++;
+{
+  const r = cp.spawnSync(process.execPath, [CLI, 'update', tmp, '--check'], { env: offline, encoding: 'utf8' });
+  const ok = r.status === 0 && /up to date|migration available/.test(r.stdout || '');
+  console.log(ok ? '✓ update --check (offline)' : `✗ update --check (offline) exit=${r.status}`);
+  if (!ok) { failed++; console.log(r.stdout || ''); console.error(r.stderr || ''); }
+}
+
+run('auto-update install', ['auto-update', 'install', tmp]);
+total++;
+{
+  const settingsFile = path.join(tmp, '.claude/settings.local.json');
+  if (fs.existsSync(settingsFile)) {
+    const s = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
+    const hasHook = (s.hooks?.SessionStart || []).some(h => h.command && h.command.includes('leerness update'));
+    if (hasHook) console.log('✓ SessionStart hook for update --check installed');
+    else { failed++; console.log('✗ SessionStart hook missing'); }
+  } else { failed++; console.log('✗ .claude/settings.local.json missing'); }
+}
+
+// 1.9.1 P6 회귀: evidence가 plan:M-XXXX + 검증 키워드면 lazy detect가 통과해야 한다.
+total++;
+{
+  const trackerPath = path.join(tmp, '.harness/progress-tracker.md');
+  let cur = fs.readFileSync(trackerPath, 'utf8');
+  cur = cur.replace(/^\| T-0001 \|.*$/m, '| T-0001 | done | mile A | tests:32/32 (plan:M-0002) | next | 2026-05-08 |');
+  fs.writeFileSync(trackerPath, cur, 'utf8');
+  const r = cp.spawnSync(process.execPath, [CLI, 'lazy', 'detect', tmp], { encoding: 'utf8' });
+  const ok = r.status === 0;
+  console.log(ok ? '✓ B(P6) lazy detect: plan:M-XXXX + 검증 키워드 → pass' : `✗ B(P6) FAIL exit=${r.status}\n${r.stdout}`);
+  if (!ok) failed++;
+}
+// 1.9.1 P6 negative: plan:M-XXXX 단독은 여전히 경고
+total++;
+{
+  const trackerPath = path.join(tmp, '.harness/progress-tracker.md');
+  let cur = fs.readFileSync(trackerPath, 'utf8');
+  cur = cur.replace(/^\| T-0001 \|.*$/m, '| T-0001 | done | mile A | plan:M-0002 | next | 2026-05-08 |');
+  fs.writeFileSync(trackerPath, cur, 'utf8');
+  const r = cp.spawnSync(process.execPath, [CLI, 'lazy', 'detect', tmp], { encoding: 'utf8' });
+  const ok = r.status === 1 && /done row without verifiable evidence/.test(r.stdout);
+  console.log(ok ? '✓ B(P6 neg) lazy detect: plan:M-XXXX 단독 → warn 유지' : `✗ B(P6 neg) FAIL exit=${r.status}`);
+  if (!ok) failed++;
+  // restore
+  cur = cur.replace(/^\| T-0001 \|.*$/m, '| T-0001 | done | mile A | tests:32/32 (plan:M-0002) | next | 2026-05-08 |');
+  fs.writeFileSync(trackerPath, cur, 'utf8');
+}
+
+// 1.9.1 P1 회귀: legacy leerness-plus hook이 있으면 auto-update install이 정리해야 한다.
+total++;
+{
+  const settingsFile = path.join(tmp, '.claude/settings.local.json');
+  const s = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
+  s.hooks.SessionStart = [{ matcher: '*', command: 'leerness-plus update --check' }];
+  fs.writeFileSync(settingsFile, JSON.stringify(s, null, 2));
+  cp.spawnSync(process.execPath, [CLI, 'auto-update', 'install', tmp], { encoding: 'utf8' });
+  const after = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
+  const hasLegacy = (after.hooks?.SessionStart || []).some(h => /leerness-plus update/.test(h.command || ''));
+  const hasNew = (after.hooks?.SessionStart || []).some(h => /\bleerness update\b/.test(h.command || ''));
+  const ok = !hasLegacy && hasNew;
+  console.log(ok ? '✓ B(P1) legacy leerness-plus hook 자동 제거' : '✗ B(P1) legacy hook 남음');
+  if (!ok) failed++;
+}
+
+// 1.9.1 P4 회귀: NA 마커가 있으면 audit이 placeholder 경고를 스킵.
+total++;
+{
+  const ds = path.join(tmp, '.harness/design-system.md');
+  fs.appendFileSync(ds, '\n<!-- leerness:na CLI 프로젝트라 디자인 토큰 없음 -->\n');
+  const r = cp.spawnSync(process.execPath, [CLI, 'audit', tmp], { encoding: 'utf8' });
+  const ok = !/design-system\.md tokens not customized/.test(r.stdout) && /marked NA/.test(r.stdout);
+  console.log(ok ? '✓ B(P4) NA 마커 인식: design-system 경고 스킵' : '✗ B(P4) NA 마커 미작동');
+  if (!ok) failed++;
+}
+
+// 1.9.1 P7 회귀: init 직후 progress에 M-0001 연결 row가 자동으로 있다.
+total++;
+{
+  const tmp2 = fs.mkdtempSync(path.join(os.tmpdir(), 'leerness-e2e-p7-'));
+  cp.spawnSync(process.execPath, [CLI, 'init', tmp2, '--yes', '--language', 'ko', '--skills', 'recommended'], { encoding: 'utf8' });
+  const tracker = fs.readFileSync(path.join(tmp2, '.harness/progress-tracker.md'), 'utf8');
+  const ok = /M-0001/.test(tracker);
+  console.log(ok ? '✓ B(P7) init: M-0001 → progress row 자동 생성' : '✗ B(P7) progress에 M-0001 row 없음');
+  if (!ok) failed++;
+}
+
+run('viewwork install',    ['viewwork', 'install', tmp]);
+run('viewwork emit',       ['viewwork', 'emit', tmp, '--action', 'note', '--note', 'e2e ping']);
+run('route planning',      ['route', 'planning']);
+run('route bugfix',        ['route', 'bugfix']);
+run('skill list',          ['skill', 'list']);
+run('skill info',          ['skill', 'info', 'office']);
+run('readme sync',         ['readme', 'sync', tmp]);
+run('consistency check',   ['consistency', 'check', tmp]);
+run('--version',           ['--version']);
+run('--help',              ['--help']);
+
+console.log(`\nE2E result: ${total - failed}/${total} passed`);
+if (failed > 0) process.exit(1);

package/docs/AX_CONSISTENCY_GUIDE.md

@@ -1,9 +0,0 @@
-# AX Consistency Guide
-
-새 UI, API wrapper, validation, form, state handler를 만들기 전에 기존 요소를 확인합니다.
-
-1. `design-system.md` 확인
-2. `consistency-policy.md` 확인
-3. `reuse-map.md` 확인
-4. 동일 기능이 있으면 재사용 또는 확장
-5. 새로 만들 수밖에 없으면 이유를 `reuse-map.md`에 기록

package/docs/AX_MIGRATION_GUIDE.md

@@ -1,9 +0,0 @@
-# AX Migration Guide
-
-마이그레이션은 비파괴가 원칙입니다.
-
-- 기존 문서는 먼저 `.harness/archive/`에 보존합니다.
-- `.env.example`과 `.gitignore`는 덮어쓰기보다 병합합니다.
-- `.harness/`와 관련 지침 파일은 삭제하지 않습니다.
-- 기존 designguide 계열 문서는 `.harness/design-system.md`로 병합합니다.
-- 마이그레이션 후 `leerness verify .`, `leerness debug .`, `leerness session close .`를 실행합니다.

package/docs/AX_PLAN_GUIDE.md

@@ -1,9 +0,0 @@
-# AX Plan Guide
-
-AI 에이전트는 사용자 요청을 받으면 먼저 `plan.md`의 범위와 `progress-tracker.md`의 상태를 확인합니다.
-
-1. 기존 계획의 일부인지 확인합니다.
-2. 새 범위면 `plan.md`와 `progress-tracker.md`에 추가합니다.
-3. 사용자가 제외한 작업은 삭제하지 않고 `dropped`로 기록합니다.
-4. 완전히 신규 프로젝트라면 구현보다 계획표 작성이 우선입니다.
-5. 작업 종료 시 `session close` 기준으로 완료/진행/미완료/예정/대기/보류/차단/드랍을 표시합니다.

package/harness.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-require('./bin/harness.js');

package/skill-packs/ads-analytics/README.md

@@ -1,6 +0,0 @@
-# ads-analytics
-
-Leerness curated skill pack.
-
-- Sensitive data must be represented by environment variable names only.
-- Add verified implementation patterns here after AI review.

package/skill-packs/ai-verified-skill-publisher/README.md

@@ -1,6 +0,0 @@
-# ai-verified-skill-publisher
-
-Leerness curated skill pack.
-
-- Sensitive data must be represented by environment variable names only.
-- Add verified implementation patterns here after AI review.

package/skill-packs/appstore-review/README.md

@@ -1,6 +0,0 @@
-# appstore-review
-
-Leerness curated skill pack.
-
-- Sensitive data must be represented by environment variable names only.
-- Add verified implementation patterns here after AI review.

package/skill-packs/commerce-api/README.md

@@ -1,6 +0,0 @@
-# commerce-api
-
-Leerness curated skill pack.
-
-- Sensitive data must be represented by environment variable names only.
-- Add verified implementation patterns here after AI review.

package/skill-packs/crawling/README.md

@@ -1,6 +0,0 @@
-# crawling
-
-Leerness curated skill pack.
-
-- Sensitive data must be represented by environment variable names only.
-- Add verified implementation patterns here after AI review.

package/skill-packs/firebase/README.md

@@ -1,6 +0,0 @@
-# firebase
-
-Leerness curated skill pack.
-
-- Sensitive data must be represented by environment variable names only.
-- Add verified implementation patterns here after AI review.

package/skill-packs/office/README.md

@@ -1,6 +0,0 @@
-# office
-
-Leerness curated skill pack.
-
-- Sensitive data must be represented by environment variable names only.
-- Add verified implementation patterns here after AI review.