tink-harness 1.6.1 → 1.6.2

package/.claude-plugin/plugin.json

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

package/CHANGELOG.md

@@ -7,6 +7,21 @@ All notable changes to Tink are tracked here.
 No unreleased changes yet.
 
 
+## [1.6.2] - 2026-06-09
+
+### Changed
+
+- Codex action skill templates now install with names like `Tink: Cast`, `Tink: Verify`, and `Tink: Update` so the Codex picker shows the Tink namespace clearly.
+- The installer now separates `Claude Code Tink skill` and `Codex Tink skills` when both Claude Code and Codex surfaces are selected.
+- Install/update output now includes repo, shared `.tink`, Claude Code, Codex, and Codex picker cleanup target paths.
+
+### Added
+
+- `--clean-codex-picker` and `TINK_CLEAN_CODEX_PICKER=1` for removing repo-local Claude Tink command/skill surfaces that make Codex show noisy `Source Command Tink ...` entries.
+- Regression coverage for mixed-surface component choices, Codex skill display names, and Codex picker cleanup.
+- Korean PR history draft for the v1.6.2 patch in `docs/pr/2026-06-09-v1.6.2.ko.md`.
+
+
 ## [1.6.1] - 2026-06-09
 
 ### Fixed

package/README.ko.md

@@ -8,7 +8,7 @@ Claude Code와 Codex를 위한 작은 하네스 레이어입니다.
 
 Tink는 지금 작업에 맞는 하네스를 고르고, 실행 상태를 보이게 만들고, 실제 사용 중 생긴 실패와 피드백으로 하네스 세트를 개선합니다.
 
-**최신 패키지:** v1.6.1 — 기존 설치에서 `tink-harness update`를 실행할 때 generated legacy rule graph도 새 seed rules로 갱신합니다. 최신 마이너 릴리스 노트: [v1.6.0](https://github.com/dotoricode/tink-harness/releases/tag/v1.6.0).
+**최신 패키지:** v1.6.2 — Codex 설치가 `Tink: Cast` 같은 action skill을 보여주고, Claude/Codex skill 선택지를 분리하며, 오래된 Codex picker 항목을 정리할 수 있습니다. 최신 마이너 릴리스 노트: [v1.6.0](https://github.com/dotoricode/tink-harness/releases/tag/v1.6.0).
 
 [English](README.md) · **한국어**
 
@@ -59,12 +59,22 @@ npx tink-harness@latest update
 
 업데이트 후 Codex skill, schema, Windows 경고가 이상해 보이면 `docs/update-troubleshooting.ko.md` 또는 `docs/update-troubleshooting.md`를 확인하세요.
 
+## 1.6.2에서 달라진 점
+
+이번 패치는 Claude Code와 Codex를 함께 쓰는 설치 흐름을 더 명확하게 만듭니다.
+
+- Codex action skill이 이제 `Cast`/`Verify` 같은 일반 이름 대신 `Tink: Cast`, `Tink: Verify`, `Tink: Update`처럼 설치됩니다.
+- Claude Code와 Codex를 함께 선택했을 때 컴포넌트 선택지에서 `Claude Code Tink skill`과 `Codex Tink skills`가 분리되어 보입니다.
+- install/update 출력에 repo, shared `.tink`, Claude Code, Codex target 경로를 표시해서 선택한 항목이 어디에 설치되는지 바로 볼 수 있습니다.
+- `--clean-codex-picker` 또는 `TINK_CLEAN_CODEX_PICKER=1`로 Codex에 `Source Command Tink ...` 항목을 만들던 repo-local Claude Tink command/skill surface를 정리할 수 있습니다.
+
 ## 1.6.1에서 달라진 점
 
 이번 패치는 기존 설치의 update 경로를 고칩니다.
 
 - `tink-harness update`가 v1.5.x에서 생성된 기본 `.tink/rules/index.json`을 새 v1.6.x rule graph seed로 갱신합니다.
 - custom rule이나 rule evidence가 들어간 사용자 수정 rule graph는 계속 보존합니다.
+
 ## 1.6.0에서 달라진 점
 
 이번 릴리스는 Tink의 작은 rule graph를 실제 작업에서 더 쓸모 있게 만듭니다.

package/README.md

@@ -24,7 +24,7 @@
   <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.6.1 - Existing installs now refresh generated legacy rule graphs during <code>tink-harness update</code>. Latest minor release notes: <a href="https://github.com/dotoricode/tink-harness/releases/tag/v1.6.0">v1.6.0</a>.</p>
+<p><strong>Latest package:</strong> v1.6.2 - Codex installs now show focused <code>Tink: Cast</code> action skills, split Claude/Codex skill choices, and can clean stale Codex picker entries. Latest minor release notes: <a href="https://github.com/dotoricode/tink-harness/releases/tag/v1.6.0">v1.6.0</a>.</p>
 
 **English** · [한국어](README.ko.md)
 
@@ -124,6 +124,15 @@ To quickly verify the updated install, see `docs/update-verification-recipe.md`
 
 If an update looks stale or incomplete, see `docs/update-troubleshooting.md` or `docs/update-troubleshooting.ko.md`.
 
+## What's new in 1.6.2
+
+This patch makes the installer clearer for mixed Claude Code + Codex setups.
+
+- Codex action skills now install with names like `Tink: Cast`, `Tink: Verify`, and `Tink: Update` instead of generic `Cast`/`Verify` labels.
+- The component picker now separates `Claude Code Tink skill` from `Codex Tink skills` when both surfaces are selected.
+- Install/update output now prints the repo, shared `.tink`, Claude Code, and Codex target paths so you can see where the selected choices will land.
+- `--clean-codex-picker` and `TINK_CLEAN_CODEX_PICKER=1` can remove repo-local Claude Tink command/skill surfaces that make Codex show noisy `Source Command Tink ...` entries.
+
 ## What's new in 1.6.1
 
 This patch fixes the update path for existing installs.

package/VERSIONING.md

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

package/bin/install.js

@@ -14,6 +14,7 @@ const command = args[0] || 'install';
 const isUpdate = command === 'update';
 const dryRun = args.includes('--dry-run');
 const force = args.includes('--force');
+const cleanCodexPicker = args.includes('--clean-codex-picker') || process.env.TINK_CLEAN_CODEX_PICKER === '1';
 const yes = args.includes('--yes') || args.includes('-y');
 const interactive = process.stdin.isTTY && process.stdout.isTTY && !yes && !dryRun;
 const source = 'https://github.com/dotoricode/tink-harness.git';
@@ -120,7 +121,7 @@ function argValue(name) {
 }
 
 function usage() {
-  console.log(`Tink installer for Claude Code and Codex\n\nUsage:\n  npx tink-harness@latest [install] [--scope=repo|global] [--global] [--lang=en|ko|zh] [--yes] [--with-hook] [--dry-run] [--force]\n  npx tink-harness@latest update [--scope=repo|global] [--global] [--lang=en|ko|zh] [--yes] [--dry-run] [--force]\n\nCommands:\n  install  Install Tink.\n  update   Update Tink to the latest templates. Keeps user-modified files.\n\nDefault interactive flow:\n  1. Select language\n  2. Show TINK wizard\n  3. Select Claude Code, Codex, or both\n  4. Select components\n  5. Select repo/global installation scope\n  6. Select git tracking policy for project state\n\nScopes:\n  repo    Install shared .tink files into the current project.\n  global  Install shared .tink files into your home directory.\n`);
+  console.log(`Tink installer for Claude Code and Codex\n\nUsage:\n  npx tink-harness@latest [install] [--scope=repo|global] [--global] [--lang=en|ko|zh] [--yes] [--with-hook] [--clean-codex-picker] [--dry-run] [--force]\n  npx tink-harness@latest update [--scope=repo|global] [--global] [--lang=en|ko|zh] [--yes] [--clean-codex-picker] [--dry-run] [--force]\n\nCommands:\n  install  Install Tink.\n  update   Update Tink to the latest templates. Keeps user-modified files.\n\nDefault interactive flow:\n  1. Select language\n  2. Show TINK wizard\n  3. Select Claude Code, Codex, or both\n  4. Select components\n  5. Select repo/global installation scope\n  6. Select git tracking policy for project state\n\nOptions:\n  --clean-codex-picker  Remove repo-local Claude Tink command/skill surfaces from the current repo so Codex shows focused Tink skills instead of Source Command Tink entries.\n\nEnvironment:\n  TINK_INSTALL_SURFACES=claude|codex|all\n  TINK_CLEAN_CODEX_PICKER=1\n\nScopes:\n  repo    Install shared .tink files into the current project.\n  global  Install shared .tink files into your home directory.\n`);
 }
 
 function normalizeSurfaces(surfaces) {
@@ -159,7 +160,7 @@ function codexHome() {
   return process.env.CODEX_HOME || path.join(os.homedir(), '.codex');
 }
 
-function componentOptionsFor(agent, language) {
+function legacyComponentOptionsFor(agent, language) {
   const options = COMPONENTS[language].filter((item) => {
     if (item.value === 'commands') return includesClaude(agent);
     if (item.value === 'hook') return includesClaude(agent);
@@ -193,6 +194,76 @@ function componentOptionsFor(agent, language) {
   });
 }
 
+function componentOptionsFor(agent, language) {
+  const options = COMPONENTS[language].flatMap((item) => {
+    if (item.value === 'commands') return includesClaude(agent) ? [item] : [];
+    if (item.value === 'hook') return includesClaude(agent) ? [item] : [];
+    if (item.value !== 'skill') return [item];
+
+    const claudeSkill = {
+      value: 'claude-skill',
+      label: 'Claude Code Tink skill',
+      hint: language === 'ko'
+        ? 'Claude Code가 읽는 Tink 작업 원칙'
+        : 'Tink operating rules for Claude Code'
+    };
+    const codexSkills = {
+      value: 'codex-skills',
+      label: 'Codex Tink skills',
+      hint: language === 'ko'
+        ? 'Codex가 $tink:*로 읽는 Tink action skills'
+        : 'Tink action skills for Codex through $tink:*'
+    };
+
+    if (agent === 'claude') return [claudeSkill];
+    if (agent === 'codex') return [codexSkills];
+    return [claudeSkill, codexSkills];
+  });
+
+  if (includesCodex(agent)) {
+    options.push({
+      value: 'codex-picker-cleanup',
+      label: 'Codex picker cleanup',
+      hint: language === 'ko'
+        ? '현재 repo의 repo-local Claude Tink surface를 정리해 Codex의 Source Command Tink 항목을 줄입니다.'
+        : 'Remove repo-local Claude Tink surfaces so Codex shows focused Tink skills.'
+    });
+  }
+
+  return options;
+}
+
+function wantsClaudeSkill(components) {
+  return components.includes('skill') || components.includes('claude-skill');
+}
+
+function wantsCodexSkills(components) {
+  return components.includes('skill') || components.includes('codex-skills');
+}
+
+function wantsCodexPickerCleanup(components, agent) {
+  return cleanCodexPicker || components.includes('codex-picker-cleanup') || agent === 'codex';
+}
+
+function locationSummary(agent, scope) {
+  const repoTarget = process.cwd();
+  const installTarget = scope === 'global' ? os.homedir() : repoTarget;
+  return [
+    `Repo target: ${repoTarget}`,
+    `Shared .tink target: ${path.join(installTarget, '.tink')}`,
+    includesClaude(agent) ? `Claude Code command target: ${path.join(installTarget, '.claude/commands/tink')}` : null,
+    includesClaude(agent) ? `Claude Code skill target: ${path.join(installTarget, '.claude/skills/tink')}` : null,
+    includesCodex(agent) ? `Codex skills target: ${path.join(codexHome(), 'skills')}` : null,
+    includesCodex(agent) ? `Codex picker cleanup target: ${path.join(repoTarget, '.claude')}` : null
+  ].filter(Boolean).join('\n');
+}
+
+function defaultComponentValues(agent, language) {
+  return componentOptionsFor(agent, language)
+    .map((item) => item.value)
+    .filter((value) => value !== 'hook' && value !== 'codex-picker-cleanup');
+}
+
 function colorLine(line, color) {
   if (!process.stdout.isTTY && !interactive) return line;
   const [r, g, b] = color;
@@ -510,17 +581,20 @@ function copySelected(scope, components, agent) {
   const codexTarget = codexHome();
   const target = scope === 'global' ? globalTarget : repoTarget;
   const templateRoot = path.join(root, 'templates');
+  const cleanupCodexPicker = wantsCodexPickerCleanup(components, agent);
 
-  if (includesClaude(agent) && components.includes('commands')) {
+  if (includesClaude(agent) && components.includes('commands') && !cleanupCodexPicker) {
     copyTinkCommands(templateRoot, target);
   }
-  if (agent === 'codex') {
-    removeRepoLocalClaudeTinkSurface(target);
+  if (cleanupCodexPicker) {
+    removeRepoLocalClaudeTinkSurface(repoTarget);
   }
-  if (components.includes('skill')) {
-    if (includesClaude(agent)) {
+  if (wantsClaudeSkill(components)) {
+    if (includesClaude(agent) && !cleanupCodexPicker) {
       copyDir(path.join(templateRoot, 'claude/skills'), path.join(target, '.claude/skills'), target);
     }
+  }
+  if (wantsCodexSkills(components)) {
     if (includesCodex(agent)) {
       removeLegacyCodexSkill(codexTarget);
       copyDir(path.join(templateRoot, 'codex/skills'), path.join(codexTarget, 'skills'), codexTarget);
@@ -644,7 +718,7 @@ async function resolveChoices() {
   }
   if (!['en', 'ko', 'zh'].includes(language)) language = 'en';
 
-  let components = componentOptionsFor(agent, language).map((item) => item.value).filter((value) => value !== 'hook');
+  let components = defaultComponentValues(agent, language);
   if (includesClaude(agent) && args.includes('--with-hook')) components.push('hook');
   let gitPolicy = 'harnesses';
   let hookScope = 'off';
@@ -692,7 +766,7 @@ async function resolveChoices() {
     initialValues: agent === 'all' ? ['claude', 'codex'] : [agent],
     required: true
   })));
-  components = componentOptionsFor(agent, language).map((item) => item.value).filter((value) => value !== 'hook');
+  components = defaultComponentValues(agent, language);
   if (includesClaude(agent) && args.includes('--with-hook')) components.push('hook');
 
   components = handleCancel(await multiselect({
@@ -727,6 +801,8 @@ async function resolveChoices() {
     initialValue: scope || 'repo'
   }));
 
+  note(locationSummary(agent, scope), language === 'ko' ? '설치 위치' : 'Install locations');
+
   if (scope === 'repo' && components.some((item) => ['harnesses', 'memory', 'hook'].includes(item))) {
     note(copy.gitNote, copy.gitNoteTitle);
     gitPolicy = handleCancel(await select({
@@ -788,6 +864,7 @@ async function main() {
     console.log(`language ${language}`);
     console.log(`scope ${scope}`);
     console.log(`components ${components.join(', ')}`);
+    console.log(locationSummary(agent, scope));
   }
 
   const targets = copySelected(scope, components, agent);

package/docs/pr/2026-06-09-v1.6.2.ko.md

@@ -0,0 +1,29 @@
+# v1.6.2 패치 이력 초안
+
+## 문제
+
+- 다른 레포에서 update 후 Codex picker에 repo-local Claude Code command가 `Source Command Tink ...`로 많이 보였음.
+- Codex action skill은 `Cast`처럼 일반 이름으로 보여서 사용자가 기대한 `Tink: Cast` 항목을 찾기 어려웠음.
+- Claude Code와 Codex를 함께 설치할 때 컴포넌트 선택지에서 Codex 전용 skill 선택지가 분리되어 보이지 않았음.
+- 설치 또는 업데이트 중 선택한 surface가 실제 어느 경로에 설치되는지 중간에 확인하기 어려웠음.
+
+## 해결
+
+- Codex action skill 템플릿 이름을 `Tink: Cast`, `Tink: Verify`, `Tink: Update`처럼 Tink prefix가 보이도록 바꿨음.
+- installer의 컴포넌트 선택지를 `Claude Code Tink skill`과 `Codex Tink skills`로 분리했음.
+- install/update 출력에 repo target, shared `.tink` target, Claude Code target, Codex skills target, Codex picker cleanup target을 표시함.
+- `--clean-codex-picker`와 `TINK_CLEAN_CODEX_PICKER=1`을 추가해서 repo-local Claude Tink command/skill surface를 명시적으로 정리할 수 있게 했음.
+- Codex-only update는 기존처럼 repo-local Claude Tink surface를 자동 정리함.
+
+## 검증
+
+- `python tests/test_templates.py` 통과했음.
+- `node --check bin/install.js` 통과했음.
+- mixed Claude Code + Codex dry-run에서 `claude-skill`, `codex-skills`, 설치 위치 출력 확인했음.
+- cleanup smoke에서 `.claude/commands/tink/cast.md`와 `.claude/skills/tink/SKILL.md`가 제거되고 `Tink: Cast` Codex skill이 설치되는 것 확인했음.
+
+## 참고
+
+- patch 릴리스이므로 GitHub Release는 새로 만들지 않음.
+- 최신 마이너 릴리스 노트는 v1.6.0에 유지함.
+- Claude Code와 Codex를 같은 repo에서 동시에 쓰되 Codex picker를 깔끔하게 유지하려면 `--clean-codex-picker`를 사용하면 됨.

package/package.json

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

package/templates/codex/skills/tink-cast/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: cast
+name: "Tink: Cast"
 description: Start a Tink run for a non-trivial task.
 ---
 

package/templates/codex/skills/tink-frog/SKILL.md

@@ -1,13 +1,13 @@
----
-name: frog
-description: Propose safe cleanup for unused or redundant Tink harnesses.
----
-
-# Tink Frog
-
-This is the Codex alias for `$tink:frog`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:frog`.
-3. Follow the canonical Tink frog behavior and never delete without approval.
-4. Accept legacy `$tink frog` wording as the same action, but present `$tink:frog` in guidance.
+---
+name: "Tink: Frog"
+description: Propose safe cleanup for unused or redundant Tink harnesses.
+---
+
+# Tink Frog
+
+This is the Codex alias for `$tink:frog`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:frog`.
+3. Follow the canonical Tink frog behavior and never delete without approval.
+4. Accept legacy `$tink frog` wording as the same action, but present `$tink:frog` in guidance.

package/templates/codex/skills/tink-list/SKILL.md

@@ -1,13 +1,13 @@
----
-name: list
-description: Inspect available Tink harnesses and usage signals.
----
-
-# Tink List
-
-This is the Codex alias for `$tink:list`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:list`.
-3. Follow the canonical Tink list behavior.
-4. Accept legacy `$tink list` wording as the same action, but present `$tink:list` in guidance.
+---
+name: "Tink: List"
+description: Inspect available Tink harnesses and usage signals.
+---
+
+# Tink List
+
+This is the Codex alias for `$tink:list`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:list`.
+3. Follow the canonical Tink list behavior.
+4. Accept legacy `$tink list` wording as the same action, but present `$tink:list` in guidance.

package/templates/codex/skills/tink-setup/SKILL.md

@@ -1,13 +1,13 @@
----
-name: setup
-description: Configure Tink language, scope, git tracking, and policy.
----
-
-# Tink Setup
-
-This is the Codex alias for `$tink:setup`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:setup`.
-3. Follow the canonical Tink setup behavior.
-4. Accept legacy `$tink setup` wording as the same action, but present `$tink:setup` in guidance.
+---
+name: "Tink: Setup"
+description: Configure Tink language, scope, git tracking, and policy.
+---
+
+# Tink Setup
+
+This is the Codex alias for `$tink:setup`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:setup`.
+3. Follow the canonical Tink setup behavior.
+4. Accept legacy `$tink setup` wording as the same action, but present `$tink:setup` in guidance.

package/templates/codex/skills/tink-update/SKILL.md

@@ -1,13 +1,13 @@
----
-name: update
-description: Detect the Tink install source and show the safe update path.
----
-
-# Tink Update
-
-This is the Codex alias for `$tink:update`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:update`.
-3. Follow the canonical Tink update behavior.
-4. Accept legacy `$tink update` wording as the same action, but present `$tink:update` in guidance.
+---
+name: "Tink: Update"
+description: Detect the Tink install source and show the safe update path.
+---
+
+# Tink Update
+
+This is the Codex alias for `$tink:update`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:update`.
+3. Follow the canonical Tink update behavior.
+4. Accept legacy `$tink update` wording as the same action, but present `$tink:update` in guidance.

package/templates/codex/skills/tink-verify/SKILL.md

@@ -1,13 +1,13 @@
----
-name: verify
-description: Run or report the checks promised in the Tink contract.
----
-
-# Tink Verify
-
-This is the Codex alias for `$tink:verify`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:verify`.
-3. Plan checks from `.tink/current/contract.json`, then record evidence in `.tink/current/verification.json`.
-4. Accept legacy `$tink verify` wording as the same action, but present `$tink:verify` in guidance.
+---
+name: "Tink: Verify"
+description: Run or report the checks promised in the Tink contract.
+---
+
+# Tink Verify
+
+This is the Codex alias for `$tink:verify`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:verify`.
+3. Plan checks from `.tink/current/contract.json`, then record evidence in `.tink/current/verification.json`.
+4. Accept legacy `$tink verify` wording as the same action, but present `$tink:verify` in guidance.

package/templates/codex/skills/tink-weave/SKILL.md

@@ -1,13 +1,13 @@
----
-name: weave
-description: Improve Tink harnesses from real use, failures, and corrections.
----
-
-# Tink Weave
-
-This is the Codex alias for `$tink:weave`.
-
-1. Read `../tink-core/RULES.md` first.
-2. Treat this invocation as `$tink:weave`.
-3. Follow the canonical Tink weave behavior and save reusable changes only after separate approval.
-4. Accept legacy `$tink weave` wording as the same action, but present `$tink:weave` in guidance.
+---
+name: "Tink: Weave"
+description: Improve Tink harnesses from real use, failures, and corrections.
+---
+
+# Tink Weave
+
+This is the Codex alias for `$tink:weave`.
+
+1. Read `../tink-core/RULES.md` first.
+2. Treat this invocation as `$tink:weave`.
+3. Follow the canonical Tink weave behavior and save reusable changes only after separate approval.
+4. Accept legacy `$tink weave` wording as the same action, but present `$tink:weave` in guidance.