tink-harness 1.9.14 → 1.9.15

package/.claude-plugin/plugin.json

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

package/CHANGELOG.md

@@ -6,6 +6,12 @@ All notable changes to Tink are tracked here.
 
 No unreleased changes yet.
 
+## [1.9.15] - 2026-06-11
+
+### Changed
+
+- Harness map controls now match common 3D-tool conventions by default: left-drag rotates, right-drag moves. On Mac trackpads and Magic Mouse, two-finger scroll moves the map and pinch zooms (trackpads are detected from wheel-event characteristics); classic mouse wheels still zoom. The in-map hint, map help text, and README were updated accordingly.
+
 ## [1.9.14] - 2026-06-11
 
 ### Changed

package/README.ko.md

@@ -8,7 +8,7 @@ Claude Code와 Codex를 위한 작은 하네스 레이어입니다.
 
 Tink는 지금 작업에 맞는 하네스를 고르고, 실행 상태를 보이게 만들고, 실제 사용 중 생긴 실패와 피드백으로 하네스 세트를 개선합니다.
 
-**최신 패키지:** v1.9.14 — 로컬 건강 리포트가 탭형 대시보드로 바뀌었습니다. 3D 하네스 지도, 쉬운 말 건강 요약, Claude Code와 Codex 양쪽 복사-붙여넣기 명령이 포함된 다음 행동 제안을 제공합니다. 전체 변경 이력은 [CHANGELOG](CHANGELOG.md)를 확인하세요.
+**최신 패키지:** v1.9.15 — 로컬 건강 리포트가 탭형 대시보드로 바뀌었습니다. 3D 하네스 지도, 쉬운 말 건강 요약, Claude Code와 Codex 양쪽 복사-붙여넣기 명령이 포함된 다음 행동 제안을 제공합니다. 전체 변경 이력은 [CHANGELOG](CHANGELOG.md)를 확인하세요.
 
 [English](README.md) · **한국어** · [변경 이력](CHANGELOG.md)
 
@@ -183,7 +183,7 @@ node .tink/tools/generate-harness-lifecycle-summary.mjs
 node .tink/tools/render-harness-health-report.mjs
 ```
 
-리포트는 정적인 탭형 로컬 페이지입니다. 홈 요약, 사용량 순 하네스 카드와 평가·생성 히스토리, 메모리 참조, run 활동 피드, 그리고 인터랙티브 3D 하네스 지도(드래그 이동, 우클릭 드래그 회전, 휠 확대 — three.js를 CDN에서 불러오며 오프라인이면 안내가 표시됩니다)를 제공합니다. 하네스나 건강 그룹을 선택하면 쉬운 말 요약과 함께 Claude Code(`/tink:...`)·Codex(`$tink:...`) 양쪽 복사용 명령이 포함된 다음 행동을 제안합니다. 여전히 서버를 시작하거나, 파일을 감시하거나, hidden cache를 만들거나, 새 public `tink index` 명령을 추가하지 않습니다 — 제안만 하며, 재사용 상태 변경은 기존 승인 절차를 그대로 따릅니다.
+리포트는 정적인 탭형 로컬 페이지입니다. 홈 요약, 사용량 순 하네스 카드와 평가·생성 히스토리, 메모리 참조, run 활동 피드, 그리고 인터랙티브 3D 하네스 지도(드래그 회전, 우클릭 드래그·두 손가락 스크롤 이동, 휠·핀치 확대 — three.js를 CDN에서 불러오며 오프라인이면 안내가 표시됩니다)를 제공합니다. 하네스나 건강 그룹을 선택하면 쉬운 말 요약과 함께 Claude Code(`/tink:...`)·Codex(`$tink:...`) 양쪽 복사용 명령이 포함된 다음 행동을 제안합니다. 여전히 서버를 시작하거나, 파일을 감시하거나, hidden cache를 만들거나, 새 public `tink index` 명령을 추가하지 않습니다 — 제안만 하며, 재사용 상태 변경은 기존 승인 절차를 그대로 따릅니다.
 
 선택된 하네스에 따라 `.tink/current/goals.json`에는 현재 실행의 목표 체크포인트가, `.tink/current/delegation.md`에는 인수인계 패킷이 추가될 수 있습니다. Tink는 이런 브리프를 보이는 상태로 준비하지만, 별도 승인된 워크플로가 아니면 worker, tmux pane, worktree를 시작하지 않습니다.
 

package/README.md

@@ -17,14 +17,14 @@
 </p>
 
 <p>
-  <a href="https://github.com/dotoricode/tink-harness/releases/tag/v1.9.14"><img src="https://img.shields.io/github/v/release/dotoricode/tink-harness?label=release&color=2ea44f" alt="GitHub release"></a>
+  <a href="https://github.com/dotoricode/tink-harness/releases/tag/v1.9.15"><img src="https://img.shields.io/github/v/release/dotoricode/tink-harness?label=release&color=2ea44f" alt="GitHub release"></a>
   <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>
   <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>
   <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>
   <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>
 </p>
 
-<p><strong>Latest package:</strong> v1.9.14 - 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>
+<p><strong>Latest package:</strong> v1.9.15 - 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>
 
 **English** · [한국어](README.ko.md) · [Changelog](CHANGELOG.md)
 
@@ -254,7 +254,7 @@ node .tink/tools/generate-harness-lifecycle-summary.mjs
 node .tink/tools/render-harness-health-report.mjs
 ```
 
-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 move, right-drag to rotate, wheel 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.
+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.
 
 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.
 

package/VERSIONING.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tink-harness",
-  "version": "1.9.14",
+  "version": "1.9.15",
   "description": "Self-growing harnesses for Claude Code and Codex.",
   "license": "MIT",
   "type": "module",

package/templates/tink/tools/render-harness-health-report.mjs

@@ -48,7 +48,7 @@ const COPY = {
     heroText: 'Every visible Tink run, rule, memory reference, and harness relationship mapped into one local dashboard. This report only prepares suggestions and never edits reusable state.',
     generated: 'GENERATED',
     harnessMap: 'HARNESS MAP',
-    mapHelp: 'Harnesses, rules, memory, and stages are mapped from visible Tink records in 3D. Drag to move, right-drag to rotate, scroll to zoom, click an orb to inspect it.',
+    mapHelp: 'Harnesses, rules, memory, and stages are mapped from visible Tink records in 3D. Drag to rotate, right-drag or two-finger scroll to move, wheel or pinch to zoom, click an orb to inspect it.',
     graph3dOffline: 'The 3D map needs an internet connection to load three.js. Reconnect and refresh this report.',
     graphControls: 'Graph controls',
     full: 'Full',
@@ -188,7 +188,7 @@ const COPY = {
       unknown: 'An item found in the records.'
     },
     timesSuffix: '',
-    hintPan: 'drag = move · right-drag = rotate · wheel = zoom · double-click = reset',
+    hintPan: 'drag = rotate · right-drag / two-finger scroll = move · wheel / pinch = zoom · double-click = reset',
     hintRotate: 'drag = rotate · right-drag = move · wheel = zoom · double-click = reset',
     runWindow: 'Run window',
     totalRuns: 'Runs',
@@ -326,7 +326,7 @@ COPY.ko = {
     unknown: '기록에서 발견된 항목입니다.'
   },
   timesSuffix: '회',
-  hintPan: '드래그 = 이동 · 우클릭 드래그 = 회전 · 휠 = 확대/축소 · 더블클릭 = 처음 시점',
+  hintPan: '드래그 = 회전 · 우클릭/두 손가락 = 이동 · 휠/핀치 = 확대 · 더블클릭 = 처음 시점',
   hintRotate: '드래그 = 회전 · 우클릭 드래그 = 이동 · 휠 = 확대/축소 · 더블클릭 = 처음 시점',
   runWindow: '기록 기간',
   totalRuns: 'Run 수',
@@ -371,7 +371,7 @@ COPY.ko = {
   heroText: '보이는 Tink run, rule, memory reference, harness 관계를 하나의 로컬 대시보드로 보여줍니다. 이 보고서는 제안만 준비하며 재사용 상태를 직접 수정하지 않습니다.',
   generated: '생성 시각',
   harnessMap: '하네스 지도',
-  mapHelp: '보이는 Tink 기록에서 하네스, rule, memory, stage 관계를 3D로 그립니다. 드래그로 이동, 우클릭 드래그로 회전, 휠로 확대, 원을 클릭하면 자세히 볼 수 있습니다.',
+  mapHelp: '보이는 Tink 기록에서 하네스, rule, memory, stage 관계를 3D로 그립니다. 드래그로 회전, 우클릭 드래그나 두 손가락 스크롤로 이동, 휠·핀치로 확대, 원을 클릭하면 자세히 볼 수 있습니다.',
   graph3dOffline: '3D 지도를 불러오려면 인터넷 연결이 필요합니다 (three.js CDN). 연결 후 보고서를 새로고침하세요.',
   graphControls: '그래프 조작',
   full: '전체',
@@ -1766,19 +1766,53 @@ function renderGraph3DModule(copy) {
       const controls = new OrbitControls(camera, renderer.domElement);
       controls.enableDamping = true;
       controls.dampingFactor = 0.1;
-      controls.enableZoom = true;
-      controls.zoomSpeed = 1.1;
+      controls.enableZoom = false;
       controls.screenSpacePanning = true;
       controls.panSpeed = 1.1;
       controls.mouseButtons = {
-        LEFT: THREE.MOUSE.PAN,
+        LEFT: THREE.MOUSE.ROTATE,
         MIDDLE: THREE.MOUSE.DOLLY,
-        RIGHT: THREE.MOUSE.ROTATE
+        RIGHT: THREE.MOUSE.PAN
       };
       controls.touches = {
-        ONE: THREE.TOUCH.PAN,
-        TWO: THREE.TOUCH.DOLLY_ROTATE
+        ONE: THREE.TOUCH.ROTATE,
+        TWO: THREE.TOUCH.DOLLY_PAN
       };
+
+      // wheel routing: mouse wheel = zoom, trackpad two-finger = pan, pinch (ctrlKey) = zoom
+      let likelyTrackpad = false;
+      const panRight = new THREE.Vector3();
+      const panUp = new THREE.Vector3();
+      const panMove = new THREE.Vector3();
+      function panBy(deltaX, deltaY) {
+        const height = renderer.domElement.clientHeight || 1;
+        const distance = camera.position.distanceTo(controls.target);
+        const factor = (2 * Math.tan((camera.fov * Math.PI / 180) / 2) * distance) / height;
+        panRight.setFromMatrixColumn(camera.matrix, 0).multiplyScalar(-deltaX * factor);
+        panUp.setFromMatrixColumn(camera.matrix, 1).multiplyScalar(deltaY * factor);
+        panMove.copy(panRight).add(panUp);
+        camera.position.add(panMove);
+        controls.target.add(panMove);
+      }
+      function dollyBy(deltaY) {
+        const offset = camera.position.clone().sub(controls.target);
+        offset.multiplyScalar(Math.exp(deltaY * 0.0022));
+        offset.setLength(Math.min(220, Math.max(8, offset.length())));
+        camera.position.copy(controls.target).add(offset);
+      }
+      renderer.domElement.addEventListener('wheel', (event) => {
+        event.preventDefault();
+        const fractional = event.deltaY !== Math.round(event.deltaY) || event.deltaX !== Math.round(event.deltaX);
+        if (event.deltaX !== 0 || fractional) likelyTrackpad = true;
+        if (event.ctrlKey || event.metaKey) {
+          dollyBy(event.deltaY * 2.4);
+        } else if (likelyTrackpad || (event.deltaMode === 0 && event.deltaY !== 0 && Math.abs(event.deltaY) < 40)) {
+          panBy(event.deltaX, event.deltaY);
+        } else {
+          dollyBy(event.deltaY);
+        }
+        controls.update();
+      }, { passive: false });
       controls.autoRotate = false;
       controls.minDistance = 8;
       controls.maxDistance = 220;