tink-harness 1.9.16 → 1.9.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (6) hide show
  1. package/.claude-plugin/plugin.json +1 -1
  2. package/CHANGELOG.md +16 -0
  3. package/README.ko.md +23 -38
  4. package/README.md +23 -55
  5. package/VERSIONING.md +1 -1
  6. package/package.json +1 -1
package/.claude-plugin/plugin.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "tink",
3
3
  "description": "A small harness layer for Claude Code and Codex.",
4
- "version": "1.9.16",
4
+ "version": "1.9.18",
5
5
  "author": {
6
6
  "name": "dotori"
7
7
  }
package/CHANGELOG.md CHANGED
@@ -6,6 +6,22 @@ All notable changes to Tink are tracked here.
6
6
 
7
7
  No unreleased changes yet.
8
8
 
9
+ ## [1.9.18] - 2026-06-11
10
+
11
+ ### Changed
12
+
13
+ - README (EN/KO) deduplicated: install instructions live once in "Install & quick start" (with a collapsible CODEX_HOME smoke test), and the dashboard description in "How it works" now points to the quick-start section instead of repeating it.
14
+
15
+ ### Added
16
+
17
+ - CONTRIBUTING.md (dev setup, three-copy rule, version-bump rule, PR conventions), a problem/solution/verification pull-request template, bug/feature issue templates, and a contributing + star call-to-action in both READMEs. GitHub repo description refreshed.
18
+
19
+ ## [1.9.17] - 2026-06-11
20
+
21
+ ### Changed
22
+
23
+ - README screenshots refreshed: the English README now shows an English-language dashboard, the Korean README uses Korean captures, and the 3D map shots are taken from a slightly rotated, zoomed-in camera so the orbs read with more depth.
24
+
9
25
  ## [1.9.16] - 2026-06-11
10
26
 
11
27
  ### Fixed
package/README.ko.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <p align="center">
2
- <img src=".github/assets/hero.gif" alt="Tink Hero Banner" width="100%">
2
+ <img src=".github/assets/hero.webp" alt="Tink Hero Banner" width="100%">
3
3
  </p>
4
4
 
5
5
  # Tink
@@ -8,7 +8,7 @@ Claude Code와 Codex를 위한 작은 하네스 레이어입니다.
8
8
 
9
9
  Tink는 지금 작업에 맞는 하네스를 고르고, 실행 상태를 보이게 만들고, 실제 사용 중 생긴 실패와 피드백으로 하네스 세트를 개선합니다.
10
10
 
11
- **최신 패키지:** v1.9.16 — 로컬 건강 리포트가 탭형 대시보드로 바뀌었습니다. 3D 하네스 지도, 쉬운 말 건강 요약, Claude Code와 Codex 양쪽 복사-붙여넣기 명령이 포함된 다음 행동 제안을 제공합니다. 전체 변경 이력은 [CHANGELOG](CHANGELOG.md)를 확인하세요.
11
+ **최신 패키지:** v1.9.18 — 로컬 건강 리포트가 탭형 대시보드로 바뀌었습니다. 3D 하네스 지도, 쉬운 말 건강 요약, Claude Code와 Codex 양쪽 복사-붙여넣기 명령이 포함된 다음 행동 제안을 제공합니다. 전체 변경 이력은 [CHANGELOG](CHANGELOG.md)를 확인하세요.
12
12
 
13
13
  [English](README.md) · **한국어** · [변경 이력](CHANGELOG.md)
14
14
 
@@ -33,6 +33,18 @@ Tink는 지금 작업에 맞는 하네스를 고르고, 실행 상태를 보이
33
33
  npx tink-harness@latest install
34
34
  ```
35
35
 
36
+ 설치 중 `Claude Code`, `Codex`, 또는 둘 다를 선택할 수 있고, 언어는 `LANG`을 자동 감지합니다(`--lang=en|ko|zh`로 변경). Codex에서는 `$tink:cast <task>`로 시작합니다.
37
+
38
+ <details>
39
+ <summary>repo 내부 Codex smoke 검증 (CODEX_HOME)</summary>
40
+
41
+ ```bash
42
+ set CODEX_HOME=%CD%\.codex
43
+ npx tink-harness@latest install
44
+ ```
45
+
46
+ </details>
47
+
36
48
  문서를 더 읽는 대신 실제 작업을 맡겨 보세요:
37
49
 
38
50
  ```text
@@ -54,11 +66,11 @@ node .tink/tools/render-harness-health-report.mjs
54
66
 
55
67
  하네스와 그들이 쓰는 규칙·메모리, 그 연결을 보여주는 인터랙티브 3D 지도 — 무리마다 고유한 색을 갖고, 살아있는 관계 위로 신호가 흐릅니다:
56
68
 
57
- ![Tink 하네스 지도 — 하네스·규칙·메모리·단계를 보여주는 인터랙티브 3D 뷰](.github/assets/dashboard-map.png)
69
+ ![Tink 하네스 지도 — 하네스·규칙·메모리·단계를 보여주는 인터랙티브 3D 뷰](.github/assets/dashboard-map.ko.png)
58
70
 
59
71
  실제 사용량 순으로 정렬된 하네스 카드 — 쉬운 말 건강 요약, 주의 점수, 승인 이력, 그리고 Claude Code·Codex 양쪽 복사용 명령이 포함된 다음 행동 제안:
60
72
 
61
- ![사용량 순 하네스 카드와 쉬운 말 건강 요약·히스토리](.github/assets/dashboard-harnesses.png)
73
+ ![사용량 순 하네스 카드와 쉬운 말 건강 요약·히스토리](.github/assets/dashboard-harnesses.ko.png)
62
74
 
63
75
  서버도, 텔레메트리도, 숨은 캐시도 없습니다 — 제안만 준비하는 정적 로컬 페이지입니다. 재사용되는 변경은 여전히 Tink의 승인 절차를 거칩니다.
64
76
 
@@ -70,32 +82,6 @@ node .tink/tools/render-harness-health-report.mjs
70
82
 
71
83
  Tink는 큰 프레임워크가 아닙니다. Claude Code나 Codex가 지금 작업에 필요한 절차만 고르고, 없으면 작은 임시 하네스를 만들고, 반복되는 실수만 승인 후 재사용 지식으로 남기도록 돕습니다.
72
84
 
73
- ## 설치
74
-
75
- Claude Code 플러그인:
76
-
77
- ```text
78
- /plugin marketplace add dotoricode/tink-harness
79
- /plugin install tink@tink-harness
80
- /reload-plugins
81
- /tink:setup
82
- ```
83
-
84
- Standalone / Codex 호환 설치:
85
-
86
- ```bash
87
- npx tink-harness@latest install
88
- ```
89
-
90
- 설치 중 `Claude Code`, `Codex`, 또는 둘 다를 선택할 수 있습니다. Codex에서는 `$tink:cast <task>`로 시작합니다.
91
-
92
- repo 내부 smoke 검증을 위해서는 `CODEX_HOME`을 고정해서 실행하세요.
93
-
94
- ```bash
95
- set CODEX_HOME=%CD%\.codex
96
- npx tink-harness@latest install
97
- ```
98
-
99
85
  ## 업데이트
100
86
 
101
87
  Claude Code 플러그인:
@@ -176,14 +162,7 @@ Tink는 직접 볼 수 있는 파일을 씁니다.
176
162
 
177
163
  Tink는 이 기록을 읽어 하네스 건강 요약도 만들 수 있습니다. 요약은 어떤 하네스가 쓰였는지, 어디서 check가 실패하거나 막혔는지, 어떤 하네스가 자주 함께 쓰였는지, 어떤 하네스가 weave 개선 후보인지, frog 정리 검토 후보인지, 병합 검토 후보인지, 오래 쉬어서 보관 검토 후보인지, 더 지켜봐야 하는지를 보여줍니다. 후보 점수, 생애주기 상태, graph 관계, 최근 run timeline도 함께 제공합니다. 이것은 여전히 제안일 뿐입니다. 하네스 수정, 병합, 보관, 삭제, memory 저장, rule 업데이트는 Tink의 기존 명시적 승인 절차를 거쳐야 합니다.
178
164
 
179
- 설치된 읽기 전용 helper로 JSON 요약과 로컬 HTML 리포트를 만들 수 있습니다.
180
-
181
- ```bash
182
- node .tink/tools/generate-harness-lifecycle-summary.mjs
183
- node .tink/tools/render-harness-health-report.mjs
184
- ```
185
-
186
- 리포트는 정적인 탭형 로컬 페이지입니다. 홈 요약, 사용량 순 하네스 카드와 평가·생성 히스토리, 메모리 참조, run 활동 피드, 그리고 인터랙티브 3D 하네스 지도(드래그 회전, 우클릭 드래그·두 손가락 스크롤 이동, 휠·핀치 확대 — three.js를 CDN에서 불러오며 오프라인이면 안내가 표시됩니다)를 제공합니다. 하네스나 건강 그룹을 선택하면 쉬운 말 요약과 함께 Claude Code(`/tink:...`)·Codex(`$tink:...`) 양쪽 복사용 명령이 포함된 다음 행동을 제안합니다. 여전히 서버를 시작하거나, 파일을 감시하거나, hidden cache를 만들거나, 새 public `tink index` 명령을 추가하지 않습니다 — 제안만 하며, 재사용 상태 변경은 기존 승인 절차를 그대로 따릅니다.
165
+ 읽기 전용 helper 두 개가 이 기록을 [빠른 시작](#하네스-건강을-눈으로-확인)에서 본 로컬 대시보드로 바꿔 줍니다. 리포트는 정적 로컬 페이지입니다 — 서버, 파일 감시, hidden cache, public `tink index` 명령이 없습니다. 제안만 준비하며, 재사용 상태 변경은 기존 승인 절차를 그대로 따릅니다.
187
166
 
188
167
  선택된 하네스에 따라 `.tink/current/goals.json`에는 현재 실행의 목표 체크포인트가, `.tink/current/delegation.md`에는 인수인계 패킷이 추가될 수 있습니다. Tink는 이런 브리프를 보이는 상태로 준비하지만, 별도 승인된 워크플로가 아니면 worker, tmux pane, worktree를 시작하지 않습니다.
189
168
 
@@ -201,6 +180,12 @@ Rule graph는 작게 유지합니다. Tink는 먼저 필수 규칙을 고르고,
201
180
 
202
181
  Tink는 코딩 에이전트, 워크플로 엔진, 멀티 에이전트 런타임, 프롬프트 라이브러리가 아닙니다. Claude Code와 Codex 위에 얹는 작은 하네스 레이어입니다.
203
182
 
183
+ ## 기여
184
+
185
+ 이슈와 PR을 환영합니다. [CONTRIBUTING.md](CONTRIBUTING.md)를 참고하세요 — 핵심은 `npm test` 실행, 명령 템플릿 3벌 동기화, [문제/해결/검증] 구조의 설명입니다.
186
+
187
+ Tink가 시간을 아껴줬다면 ⭐ 하나가 다른 개발자들이 Tink를 찾는 데 큰 도움이 됩니다.
188
+
204
189
  ## 라이선스
205
190
 
206
191
  MIT
package/README.md CHANGED
@@ -1,5 +1,5 @@
1
1
  <p align="center">
2
- <img src=".github/assets/hero.gif" alt="Tink Hero Banner" width="100%">
2
+ <img src=".github/assets/hero.webp" alt="Tink Hero Banner" width="100%">
3
3
  </p>
4
4
 
5
5
  <h1>
@@ -17,20 +17,20 @@
17
17
  </p>
18
18
 
19
19
  <p>
20
- <a href="https://github.com/dotoricode/tink-harness/releases/tag/v1.9.16"><img src="https://img.shields.io/github/v/release/dotoricode/tink-harness?label=release&color=2ea44f" alt="GitHub release"></a>
20
+ <a href="https://github.com/dotoricode/tink-harness/releases/tag/v1.9.18"><img src="https://img.shields.io/github/v/release/dotoricode/tink-harness?label=release&color=2ea44f" alt="GitHub release"></a>
21
21
  <a href="https://www.npmjs.com/package/tink-harness"><img src="https://img.shields.io/npm/v/tink-harness?label=npm&color=cb3837" alt="npm version"></a>
22
22
  <a href="https://github.com/dotoricode/tink-harness/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/dotoricode/tink-harness/ci.yml?branch=main&label=ci" alt="CI"></a>
23
23
  <a href="https://github.com/dotoricode/tink-harness/blob/main/LICENSE"><img src="https://img.shields.io/github/license/dotoricode/tink-harness" alt="License"></a>
24
24
  <a href="https://github.com/dotoricode/tink-harness/stargazers"><img src="https://img.shields.io/github/stars/dotoricode/tink-harness?style=social" alt="GitHub stars"></a>
25
25
  </p>
26
26
 
27
- <p><strong>Latest package:</strong> v1.9.16 - The local health report is now a tabbed dashboard with a 3D harness map, plain-language health summaries, and next-action suggestions with copy-paste commands for both Claude Code and Codex. See <a href="CHANGELOG.md">CHANGELOG</a> for release history.</p>
27
+ <p><strong>Latest package:</strong> v1.9.18 - The local health report is now a tabbed dashboard with a 3D harness map, plain-language health summaries, and next-action suggestions with copy-paste commands for both Claude Code and Codex. See <a href="CHANGELOG.md">CHANGELOG</a> for release history.</p>
28
28
 
29
29
  **English** · [한국어](README.ko.md) · [Changelog](CHANGELOG.md)
30
30
 
31
31
  ---
32
32
 
33
- ## Quick start
33
+ ## Install & quick start
34
34
 
35
35
  Try Tink in about a minute.
36
36
 
@@ -49,6 +49,18 @@ Try Tink in about a minute.
49
49
  npx tink-harness@latest install
50
50
  ```
51
51
 
52
+ The standalone installer auto-detects `LANG` (English fallback); pass `--lang=en|ko|zh` to override. During install you can pick `Claude Code`, `Codex`, or both - in Codex, start with `$tink:cast <task>`.
53
+
54
+ <details>
55
+ <summary>Repo-local Codex smoke test (CODEX_HOME)</summary>
56
+
57
+ ```bash
58
+ set CODEX_HOME=%CD%/.codex
59
+ npx tink-harness@latest install --yes
60
+ ```
61
+
62
+ </details>
63
+
52
64
  Then hand Tink a real task instead of reading more docs:
53
65
 
54
66
  ```text
@@ -94,49 +106,6 @@ Tink started from a simple question:
94
106
 
95
107
  Not by adding a big framework. Not by running more agents. Just by helping Claude or Codex choose the right harness for the current task, create one when nothing fits, and improve the set over time.
96
108
 
97
- ## Install
98
-
99
- Claude Code plugin install:
100
-
101
- ```text
102
- /plugin marketplace add dotoricode/tink-harness
103
- ```
104
-
105
- ```text
106
- /plugin install tink@tink-harness
107
- ```
108
-
109
- ```text
110
- /reload-plugins
111
- ```
112
-
113
- ```text
114
- /tink:setup
115
- ```
116
-
117
- Standalone compatibility installer:
118
-
119
- ```bash
120
- npx tink-harness@latest install
121
- ```
122
-
123
- Standalone installer auto-detects `LANG` (English fallback). Pass `--lang=en|ko|zh` to override.
124
-
125
- Codex skill install:
126
-
127
- ```bash
128
- npx tink-harness@latest install
129
- ```
130
-
131
- During install, select `Codex` when asked which agent surface to install. You can select both `Claude Code` and `Codex` in the same run. Then open Codex and use `$tink:cast <task>`.
132
-
133
- For repo-local smoke testing, fix the target with `CODEX_HOME`:
134
-
135
- ```bash
136
- set CODEX_HOME=%CD%/.codex
137
- npx tink-harness@latest install --yes
138
- ```
139
-
140
109
  ## Update
141
110
 
142
111
  Claude Code plugin users:
@@ -247,14 +216,7 @@ Tink uses files you can inspect:
247
216
 
248
217
  Tink can also read those records into a harness health summary. The summary shows which harnesses were used, where checks failed or got blocked, which harnesses often appear together, and which ones may deserve a weave improvement, frog cleanup review, merge review, dormant archive review, or more observation. It also includes an explainable candidate score, lifecycle state, graph relationships, and recent run timeline. It only prepares suggestions. Tink does not edit, merge, archive, delete, save memory, or update rules without the same explicit approval gates as the rest of Tink.
249
218
 
250
- The installed read-only helpers can generate that JSON summary and turn it into a local HTML report:
251
-
252
- ```bash
253
- node .tink/tools/generate-harness-lifecycle-summary.mjs
254
- node .tink/tools/render-harness-health-report.mjs
255
- ```
256
-
257
- The report is a static, tabbed local page: a home overview, usage-sorted harness cards with an evaluation/maintenance history, memory references, a run activity feed, and an interactive 3D harness map (drag to rotate, right-drag or two-finger scroll to move, wheel or pinch to zoom; rendered with three.js from a CDN, with an offline notice when unavailable). Selecting a harness or health group shows a plain-language summary plus a suggested next action with copy-paste commands for both Claude Code (`/tink:...`) and Codex (`$tink:...`). It still does not start a server, watch files, create a hidden cache, or add a public `tink index` command - suggestions only; reusable-state changes keep their approval gates.
219
+ Two read-only helpers turn those records into the local dashboard shown in [Install & quick start](#install--quick-start). The report is a static local page - no server, no file watching, no hidden cache, no public `tink index` command. It only prepares suggestions; reusable-state changes keep their approval gates.
258
220
 
259
221
  When selected, current-run artifacts may also include `.tink/current/goals.json` for goal checkpoints or `.tink/current/delegation.md` for handoff packets. Tink prepares those briefs as visible state; it does not start workers, tmux panes, or worktrees unless a separate approved workflow does so.
260
222
 
@@ -278,6 +240,12 @@ Tink is not:
278
240
 
279
241
  It is a small harness layer for Claude Code or Codex.
280
242
 
243
+ ## Contributing
244
+
245
+ 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.
246
+
247
+ If Tink saves you time, a ⭐ helps other developers find it.
248
+
281
249
  ## License
282
250
 
283
251
  MIT
package/VERSIONING.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Versioning
2
2
 
3
- Current version: `1.9.16`
3
+ Current version: `1.9.18`
4
4
 
5
5
  Tink follows semver from `1.0.0` onward.
6
6
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tink-harness",
3
- "version": "1.9.16",
3
+ "version": "1.9.18",
4
4
  "description": "Self-growing harnesses for Claude Code and Codex.",
5
5
  "license": "MIT",
6
6
  "type": "module",