tink-harness 1.6.2 → 1.6.3

package/.claude-plugin/plugin.json

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

package/CHANGELOG.md

@@ -7,6 +7,20 @@ All notable changes to Tink are tracked here.
 No unreleased changes yet.
 
 
+## [1.6.3] - 2026-06-09
+
+### Changed
+
+- Interactive install/update now includes an `Advanced options` step so `--dry-run`, `--force`, and `--clean-codex-picker` are available as visible choices instead of CLI-only flags.
+- Install/update output now prints selected option state for preview, force overwrite, and Codex picker cleanup.
+- Non-interactive CLI flags still work and seed the same option state used by the interactive wizard.
+
+### Added
+
+- Regression coverage for visible advanced option labels and selected option output.
+- Korean PR history draft for the v1.6.3 patch in `docs/pr/2026-06-09-v1.6.3.ko.md`.
+
+
 ## [1.6.2] - 2026-06-09
 
 ### Changed

package/README.ko.md

@@ -8,7 +8,7 @@ Claude Code와 Codex를 위한 작은 하네스 레이어입니다.
 
 Tink는 지금 작업에 맞는 하네스를 고르고, 실행 상태를 보이게 만들고, 실제 사용 중 생긴 실패와 피드백으로 하네스 세트를 개선합니다.
 
-**최신 패키지:** 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).
+**최신 패키지:** v1.6.3 — interactive install/update에서 preview, force overwrite, Codex picker cleanup 같은 고급 옵션을 실제 선택지로 제공합니다. 최신 마이너 릴리스 노트: [v1.6.0](https://github.com/dotoricode/tink-harness/releases/tag/v1.6.0).
 
 [English](README.md) · **한국어**
 
@@ -59,6 +59,13 @@ npx tink-harness@latest update
 
 업데이트 후 Codex skill, schema, Windows 경고가 이상해 보이면 `docs/update-troubleshooting.ko.md` 또는 `docs/update-troubleshooting.md`를 확인하세요.
 
+## 1.6.3에서 달라진 점
+
+이번 패치는 CLI 옵션을 interactive installer 안에서 직접 고를 수 있게 만듭니다.
+
+- wizard에 `Advanced options` 단계가 추가되어 `Preview only (--dry-run)`, `Overwrite user-modified files (--force)`, `Clean Codex picker (--clean-codex-picker)`를 선택할 수 있습니다.
+- install/update 출력에 선택된 옵션 상태를 표시해서 preview, force overwrite, Codex picker cleanup이 켜졌는지 바로 볼 수 있습니다.
+- 기존 CLI flag는 그대로 동작하며, interactive wizard에서는 같은 옵션의 초기 선택값으로 반영됩니다.
 ## 1.6.2에서 달라진 점
 
 이번 패치는 Claude Code와 Codex를 함께 쓰는 설치 흐름을 더 명확하게 만듭니다.

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.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>
+<p><strong>Latest package:</strong> v1.6.3 - Interactive install/update now offers advanced options such as preview, force overwrite, and Codex picker cleanup as real choices. 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,14 @@ 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.3
+
+This patch makes CLI options visible in the interactive installer.
+
+- The wizard now has an `Advanced options` step with `Preview only (--dry-run)`, `Overwrite user-modified files (--force)`, and `Clean Codex picker (--clean-codex-picker)` when Codex is selected.
+- Install/update output now prints the selected option state, so you can see whether preview, force overwrite, or Codex picker cleanup is active.
+- CLI flags still work for non-interactive runs and seed the same visible choices when the wizard is used.
+
 ## What's new in 1.6.2
 
 This patch makes the installer clearer for mixed Claude Code + Codex setups.

package/VERSIONING.md

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

package/bin/install.js

@@ -12,9 +12,9 @@ const root = path.resolve(__dirname, '..');
 const args = process.argv.slice(2);
 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';
+let dryRun = args.includes('--dry-run');
+let force = args.includes('--force');
+let 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';
@@ -220,16 +220,6 @@ function componentOptionsFor(agent, language) {
     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;
 }
 
@@ -245,6 +235,57 @@ function wantsCodexPickerCleanup(components, agent) {
   return cleanCodexPicker || components.includes('codex-picker-cleanup') || agent === 'codex';
 }
 
+function advancedOptionChoices(agent, language) {
+  const choices = [
+    {
+      value: 'dry-run',
+      label: 'Preview only (--dry-run)',
+      hint: language === 'ko'
+        ? '파일을 쓰거나 지우지 않고 어떤 작업을 할지만 보여줍니다.'
+        : 'Show planned writes/removals without changing files.'
+    },
+    {
+      value: 'force',
+      label: 'Overwrite user-modified files (--force)',
+      hint: language === 'ko'
+        ? '사용자가 수정한 파일도 덮어쓸 수 있는 위험 옵션입니다.'
+        : 'Risky. Allows overwriting user-modified files.'
+    }
+  ];
+  if (includesCodex(agent)) {
+    choices.push({
+      value: 'clean-codex-picker',
+      label: 'Clean Codex picker (--clean-codex-picker)',
+      hint: language === 'ko'
+        ? '현재 repo의 repo-local Claude Tink surface를 정리해 Source Command Tink 항목을 줄입니다.'
+        : 'Remove repo-local Claude Tink surfaces that show as Source Command Tink entries.'
+    });
+  }
+  return choices;
+}
+
+function defaultAdvancedValues(agent) {
+  return [
+    dryRun ? 'dry-run' : null,
+    force ? 'force' : null,
+    includesCodex(agent) && cleanCodexPicker ? 'clean-codex-picker' : null
+  ].filter(Boolean);
+}
+
+function applyAdvancedOptions(values) {
+  dryRun = values.includes('dry-run');
+  force = values.includes('force');
+  cleanCodexPicker = values.includes('clean-codex-picker');
+}
+
+function optionsSummary(agent) {
+  return [
+    `Preview only (--dry-run): ${dryRun ? 'yes' : 'no'}`,
+    `Overwrite user-modified files (--force): ${force ? 'yes' : 'no'}`,
+    includesCodex(agent) ? `Clean Codex picker (--clean-codex-picker): ${cleanCodexPicker ? 'yes' : 'no'}` : null
+  ].filter(Boolean).join('\n');
+}
+
 function locationSummary(agent, scope) {
   const repoTarget = process.cwd();
   const installTarget = scope === 'global' ? os.homedir() : repoTarget;
@@ -254,16 +295,15 @@ function locationSummary(agent, scope) {
     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
+    includesCodex(agent) ? `Codex picker cleanup target: ${path.join(process.cwd(), '.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');
+    .filter((value) => value !== 'hook');
 }
-
 function colorLine(line, color) {
   if (!process.stdout.isTTY && !interactive) return line;
   const [r, g, b] = color;
@@ -720,6 +760,7 @@ async function resolveChoices() {
 
   let components = defaultComponentValues(agent, language);
   if (includesClaude(agent) && args.includes('--with-hook')) components.push('hook');
+  let advancedOptions = defaultAdvancedValues(agent);
   let gitPolicy = 'harnesses';
   let hookScope = 'off';
 
@@ -768,6 +809,7 @@ async function resolveChoices() {
   })));
   components = defaultComponentValues(agent, language);
   if (includesClaude(agent) && args.includes('--with-hook')) components.push('hook');
+  advancedOptions = defaultAdvancedValues(agent);
 
   components = handleCancel(await multiselect({
     message: copy.components,
@@ -801,6 +843,15 @@ async function resolveChoices() {
     initialValue: scope || 'repo'
   }));
 
+  advancedOptions = handleCancel(await multiselect({
+    message: language === 'ko' ? '실행 옵션을 선택하세요 (space로 토글)' : 'Select run options (space to toggle)',
+    options: advancedOptionChoices(agent, language),
+    initialValues: advancedOptions,
+    required: false
+  }));
+  applyAdvancedOptions(advancedOptions);
+  note(optionsSummary(agent), language === 'ko' ? '선택된 옵션' : 'Selected options');
+
   note(locationSummary(agent, scope), language === 'ko' ? '설치 위치' : 'Install locations');
 
   if (scope === 'repo' && components.some((item) => ['harnesses', 'memory', 'hook'].includes(item))) {
@@ -864,6 +915,7 @@ async function main() {
     console.log(`language ${language}`);
     console.log(`scope ${scope}`);
     console.log(`components ${components.join(', ')}`);
+    console.log(optionsSummary(agent));
     console.log(locationSummary(agent, scope));
   }
 

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

@@ -0,0 +1,27 @@
+# v1.6.3 패치 이력 초안
+
+## 문제
+
+- `--clean-codex-picker`처럼 사용자가 알아야 하는 옵션이 CLI flag로는 있었지만, interactive install/update 흐름에서는 별도 선택지로 충분히 드러나지 않았음.
+- 사용자는 설치 중 “지금 어떤 옵션이 켜져 있는지”를 출력으로 확인하기 어려웠음.
+- `--dry-run`, `--force`, `--clean-codex-picker`가 모두 실행 방식에 영향을 주는데, 일부는 선택 화면이 아니라 명령어를 알아야만 쓸 수 있었음.
+
+## 해결
+
+- interactive wizard에 `Advanced options` 단계를 추가했음.
+- `Preview only (--dry-run)`, `Overwrite user-modified files (--force)`, `Clean Codex picker (--clean-codex-picker)`를 실제 선택지로 제공함.
+- 선택된 옵션 상태를 install/update 출력에 표시함.
+- 기존 CLI flag는 그대로 유지하고, interactive wizard에서는 같은 옵션의 초기 선택값으로 반영되도록 했음.
+
+## 검증
+
+- `npm test`로 installer 문구, 선택 상태 출력, package metadata 회귀 테스트를 확인할 예정임.
+- `git diff --check`로 공백 문제를 확인할 예정임.
+- `npm pack --dry-run --json`으로 패키지 포함 파일을 확인할 예정임.
+- publish 후 `@latest` smoke에서 option state 출력과 `--clean-codex-picker` 동작을 확인할 예정임.
+
+## 참고
+
+- patch 릴리스이므로 GitHub Release는 새로 만들지 않음.
+- 최신 마이너 릴리스 노트는 v1.6.0에 유지함.
+- 이 변경은 새 명령을 추가하지 않고 기존 installer/update wizard의 선택 흐름만 명확하게 만듦.

package/package.json

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