tink-harness 1.17.0 → 1.17.2

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "tink",
   "description": "A small harness layer for Claude Code and Codex.",
-  "version": "1.17.0",
+  "version": "1.17.2",
   "author": {
     "name": "dotori"
   }

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to Tink are tracked here.
 
 ## Unreleased
 
+## [1.17.2] - 2026-06-30
+
+- E2E 테스트 5종 추가: install smoke, update preservation, Codex surface, pack manifest, metadata 검증.
+- `package.json` scripts 분리: `test:templates`, `test:syntax`, `test:metadata`, `test:pack`, `test:e2e`, `check`.
+- CI에 macOS 매트릭스 추가 및 `test:pack`, `test:e2e` step 포함.
+- `CONTRIBUTING.md` 테스트 명령표 갱신, `README.md`/`README.ko.md`에 Verification 섹션 추가.
+
+## [1.17.1] - 2026-06-30
+
+- README / README.ko.md에 Before→After 대비 블록과 run record·verify evidence 실물 예시 추가.
+
 ## [1.17.0] - 2026-06-30
 
 - `loop-engineering` 하네스 추가: 측정 가능한 수용 신호(테스트·lint·build 통과, 커버리지, 벤치마크, 점수 등)를 향해 한 번에 한 병목씩 반복하고, 예산 초과 시 현재 상태·원인·다음 행동을 보고한다. 독립 평가(자기 채점 금지)와 반복 로그를 강제. `goal-checkpoint`(일반 다단계)·`bug-diagnosis-loop`(버그 진단)와 `use_when`에서 명시적으로 구분됨.

package/README.ko.md

@@ -83,6 +83,24 @@ $tink:cast 인증 모듈 리팩터링     # Codex
 
 ## 실제로 남는 것
 
+**Tink 없이 (Claude Code / Codex 단독):**
+
+```text
+"인증 모듈 리팩터링"
+→ 계획은 채팅 기록에만
+→ 완료 기준 없음
+→ 다음 세션에서 맥락 소실
+```
+
+**Tink 사용 후 (`/tink:cast 인증 모듈 리팩터링`):**
+
+```text
+→ .tink/current/contract.json  — 완료 조건
+→ plan.md / checks.md          — 보이는 계획 + 검증 단계
+→ /tink:verify                 — "된 것 같다"가 아닌 증거로 증명
+→ .tink/runs/…md               — 재사용 가능한 간결한 기록
+```
+
 사소하지 않은 작업마다 열어보고, diff하고, 커밋할 수 있는 평범한 파일이 남습니다:
 
 ```text
@@ -96,6 +114,34 @@ $tink:cast 인증 모듈 리팩터링     # Codex
   refactor-review.md                # 재사용 작업 방식 — 승인해야 저장
 ```
 
+<details>
+<summary><strong>완성된 run은 이렇게 남습니다</strong></summary>
+
+**Run 기록** (`.tink/runs/YYYY-MM-DD-HHMM-작업명.md`):
+
+```text
+Status: completed
+Goal: Codex에서 직접 호출 가능한 entrypoint 스킬 추가.
+Changed: `$tink:<action>` 별칭을 인식하도록 main `tink` 스킬 수정; 래퍼 스킬 추가.
+Evidence: `find … | rg 'tink(-|/)'` 로 모든 SKILL.md와 main 스킬 확인.
+Notes: 재사용 메모리·하네스 변경 없음.
+```
+
+**Verify 증거** (`/tink:verify`, 두 가지 사례):
+
+```text
+✅  evidence_kind: command
+    evidence_ref:  npm test
+    observed:      테스트 47개 통과, 실패 없음
+
+⚠️  evidence_kind: manual
+    evidence_ref:  클린 설치 스모크 테스트 (macOS)
+    observed:      미실행 — CI 러너는 Linux 전용
+    next_action:   배포 전 macOS에서 수동 실행 필요
+```
+
+</details>
+
 ## CLAUDE.md·슬래시 명령·스킬만으로는 왜 부족할까?
 
 | 도구 | 제공하는 것 | Tink가 얹는 것 |
@@ -250,9 +296,20 @@ npx tink-harness@latest update
 
 코딩 에이전트도, 워크플로 엔진도, 멀티 에이전트 런타임도, 프롬프트 라이브러리도 아닙니다. Claude Code와 Codex 위에 얹는 작은 하네스 레이어입니다.
 
+## 검증
+
+```bash
+npm test              # 템플릿 동기화, 문법, 버전 일치
+npm run test:pack     # 배포 파일 목록: 필수 파일 존재, 시크릿 미포함
+npm run test:e2e      # tmpdir 실제 설치, 업데이트 보존, Codex 서피스
+npm run check         # npm test + test:pack 한 번에
+```
+
+CI는 Ubuntu와 macOS에서 `npm test`, `test:pack`, `test:e2e`를 모두 실행합니다.
+
 ## 기여
 
-이슈와 PR을 환영합니다. [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요 — 핵심은 `npm test` 실행, 명령 템플릿 3벌 동기화, 문제/해결/검증 구조의 설명입니다.
+이슈와 PR을 환영합니다. [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요 — 핵심은 `npm test && npm run test:pack` 실행, 명령 템플릿 3벌 동기화, 문제/해결/검증 구조의 설명입니다.
 
 Tink가 시간을 아껴줬다면 ⭐ 하나가 다른 개발자들이 Tink를 찾는 데 큰 도움이 됩니다.
 

package/README.md

@@ -83,6 +83,24 @@ $tink:cast refactor the auth module     # Codex
 
 ## What you actually get
 
+**Before (plain Claude Code / Codex):**
+
+```text
+"refactor the auth module"
+→ plan lives in chat only
+→ no completion criteria
+→ context lost next session
+```
+
+**After (`/tink:cast refactor the auth module`):**
+
+```text
+→ .tink/current/contract.json  — what must be true when done
+→ plan.md / checks.md          — visible plan and verification steps
+→ /tink:verify                 — proves "done" with evidence, not vibes
+→ .tink/runs/…md               — compact record, reusable next time
+```
+
 Every non-trivial task leaves plain files you can open, diff, and commit:
 
 ```text
@@ -96,6 +114,34 @@ Every non-trivial task leaves plain files you can open, diff, and commit:
   refactor-review.md                # reusable ways of working — approval-gated
 ```
 
+<details>
+<summary><strong>What a finished run actually looks like</strong></summary>
+
+**Run record** (`.tink/runs/YYYY-MM-DD-HHMM-task.md`):
+
+```text
+Status: completed
+Goal: make Tink easier to invoke in Codex with direct entrypoint skills.
+Changed: updated main `tink` skill to recognize `$tink:<action>` aliases; added thin wrapper skills.
+Evidence: `find … | rg 'tink(-|/)'` showed all SKILL.md files plus the main skill.
+Notes: no reusable memory or harness was changed.
+```
+
+**Verify evidence** (`/tink:verify`, two outcomes):
+
+```text
+✅  evidence_kind: command
+    evidence_ref:  npm test
+    observed:      47 tests passed, 0 failures
+
+⚠️  evidence_kind: manual
+    evidence_ref:  clean install smoke (macOS)
+    observed:      not run — CI runner is Linux only
+    next_action:   run manually on macOS before publish
+```
+
+</details>
+
 ## Why not just CLAUDE.md / slash commands / skills?
 
 | Tooling | What it gives you | What Tink adds on top |
@@ -258,9 +304,20 @@ Verify: `docs/update-verification-recipe.md` or `docs/update-verification-recipe
 
 Tink is not a coding agent, workflow engine, multi-agent runtime, or prompt library. It is a small harness layer for Claude Code or Codex.
 
+## Verification
+
+```bash
+npm test              # template sync, syntax, version parity
+npm run test:pack     # pack manifest: required files, no secrets
+npm run test:e2e      # real install into tmpdir, update preservation, Codex surface
+npm run check         # npm test + test:pack together
+```
+
+CI runs `npm test`, `test:pack`, and `test:e2e` on Ubuntu and macOS.
+
 ## Contributing
 
-Issues and pull requests are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) — the short version: run `npm test`, keep command templates in sync across their three copies, and describe changes as problem / solution / verification.
+Issues and pull requests are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) — the short version: run `npm test && npm run test:pack`, keep command templates in sync across their three copies, and describe changes as problem / solution / verification.
 
 If Tink saves you time, a ⭐ helps other developers find it.
 

package/VERSIONING.md

@@ -1,6 +1,6 @@
 # Versioning
 
-Current version: `1.17.0`
+Current version: `1.17.2`
 
 Tink follows semver from `1.0.0` onward.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tink-harness",
-  "version": "1.17.0",
+  "version": "1.17.2",
   "description": "Self-growing harnesses for Claude Code and Codex.",
   "license": "MIT",
   "type": "module",
@@ -23,8 +23,13 @@
     "LICENSE"
   ],
   "scripts": {
-    "test": "python tests/test_templates.py && node --check bin/install.js",
-    "check": "npm test"
+    "test": "npm run test:templates && npm run test:syntax && npm run test:metadata",
+    "test:templates": "python tests/test_templates.py",
+    "test:syntax": "node --check bin/install.js",
+    "test:metadata": "node tests/test_metadata.mjs",
+    "test:pack": "node tests/test_pack.mjs",
+    "test:e2e": "node tests/test_install_smoke.mjs && node tests/test_update_preservation.mjs && node tests/test_codex_home.mjs",
+    "check": "npm test && npm run test:pack"
   },
   "keywords": [
     "claude-code",