claude-token-saver 3.38.0 → 3.39.0

package/README.ko.md

@@ -602,11 +602,26 @@ npm uninstall -g claude-cache-monitor && npm i -g claude-token-saver
 
 전체 내역은 [CHANGELOG.md](./CHANGELOG.md)로 옮겼습니다. 최근 변경은 다음과 같습니다.
 
+- **v3.39.0**: `feedback` 서브커맨드가 터미널이나 Claude 세션에서 버그 제보·기능 제안을 바로 제출합니다. gh CLI가 있으면 이슈 직접 등록, 없으면 로그인 없는 익명 제출(릴레이가 이슈로 자동 등록), 오프라인이면 로컬 저장. `install`은 기존 statusline이 있으면 조용히 건너뛰지 않고 교체 여부를 묻습니다.
 - **v3.38.0**: `cohesion on`이 응집성 다섯 원칙을 영어 블록으로 주입합니다. 옵트인이고, korean 지침이 켜져 있으면 중복 주입을 막습니다.
 - **v3.37.0**: 한국어 지침에 보강 지침(supplement)이 붙습니다. 번역투·상투 패턴·응집성(문장 이어짐) 조항이며, 쓰기 시점 검사에도 번역투 5종이 추가됐습니다. 실파일 255개 실측에서 오탐 1건으로 검증했습니다.
 - **v3.35.0**: 이번 달 1일 00시 이후 지출 추정치를 `💵 Sep $42` 세그먼트로 상시 표시합니다. LiteLLM 게이트웨이 사용자는 키의 max_budget/spend 를 `🔑 budget` 게이지로 봅니다 (5h/7d cap 이 없는 Bedrock·LiteLLM 환경 대응).
 - **v3.34.0**: seed 프리셋 제안, 설치 시 출력 언어 선택, 컨텍스트 경고 500k 상향. 상세는 CHANGELOG 참고.
 
+## 피드백
+
+버그 제보와 기능 제안은 GitHub 이슈로 받습니다: https://github.com/rootstudioyaml/claude-token-saver/issues
+
+브라우저나 GitHub 로그인이 어려운 환경(사내망, 세션 도중)이라면 터미널에서 바로 제출할 수 있고, Claude에게 대신 제출해 달라고 요청해도 됩니다.
+
+```bash
+claude-token-saver feedback "Bedrock에서 5m TTL 칩이 사라지지 않아요"
+```
+
+`gh` CLI가 인증되어 있으면 GitHub 이슈로 바로 등록하고, 없으면 로그인이 필요 없는 익명 경로로 제출합니다(github.com이 막힌 사내망에서도 동작합니다). `gh` 경로를 건너뛰려면 `--anonymous`를 붙입니다. 도구 버전과 OS 정보는 자동으로 첨부됩니다.
+
+버그를 제보하실 때는 도구 버전(`claude-token-saver --version`)과 OS를 함께 적어 주시고, statusline이나 경고 관련 문제라면 statusline 출력이나 `claude-token-saver last` 결과를 덧붙여 주시면 원인을 빨리 찾을 수 있습니다.
+
 ## 라이선스
 
 MIT

package/README.md

@@ -723,11 +723,26 @@ Also update `statusLine.command` in `~/.claude/settings.json` to `claude-token-s
 
 The full history moved to [CHANGELOG.md](./CHANGELOG.md) (Korean; version headings and command names are language-neutral). Recent changes:
 
+- **v3.39.0**: `feedback` subcommand — file bug reports and feature requests straight from the terminal or a Claude session, via the gh CLI, an anonymous no-login form (auto-filed as a GitHub issue by an Apps Script relay), or a local fallback. `install` now asks before replacing an existing statusline instead of silently skipping.
 - **v3.38.0**: `cohesion on` — the language-neutral cohesion rules from the Korean supplement become a standalone English injection (given-before-new, one referent per pronoun, subject consistency, bridging, merging choppy sentences). Opt-in, ~0.5k tokens per session, suppressed while `korean on` already carries them.
 - **v3.37.0**: Korean guidance grows a conservative supplement (translationese, AI-writing tics, a research-backed cohesion section whose principles apply to English prose too) and the write-time lint gains 5 translationese patterns, validated at 1 false positive across 255 real files.
 - **v3.35.0**: A `💵 Sep $42` segment now shows estimated spend since 00:00 on the 1st of the current month, always on — including gateway setups with no 5h/7d caps. LiteLLM gateway users get a `🔑 budget ▰▱ 34% $34/$100` gauge built from the key's budget (`GET /key/info` + `GET /user/info`, team-membership budget first, then key, then internal user — verified against a Dockerized LiteLLM).
 - **v3.34.0**: seed presets offered one at a time, output-language choice at install, context warning raised to 500k.
 
+## Feedback
+
+Found a bug, or want a feature? Open an issue: https://github.com/rootstudioyaml/claude-token-saver/issues
+
+No browser or GitHub login handy (corporate network, mid-session)? Submit straight from the terminal — or ask Claude to do it for you:
+
+```bash
+claude-token-saver feedback "the 5m TTL chip never clears on Bedrock"
+```
+
+It files a GitHub issue via the `gh` CLI when one is authenticated; otherwise it submits anonymously (no login, works where github.com is blocked). Pass `--anonymous` to skip the `gh` path. Version and OS metadata are attached automatically.
+
+When reporting a bug, please include the tool version (`claude-token-saver --version`), your OS, and — if it is a statusline or warning issue — the statusline output or the `claude-token-saver last` result.
+
 ## License
 
 MIT

package/bin/cli.js

@@ -87,7 +87,7 @@ function readUpdateChip() {
 const KNOWN_SUBCOMMANDS = new Set([
   'last', 'brief', 'history', 'handoff', 'install', 'uninstall', 'mode', 'korean', 'cohesion',
   'doc2md', 'harness', 'route-scan', 'compact-window', 'update-check', 'upgrade',
-  'seed', 'litellm-budget',
+  'seed', 'litellm-budget', 'feedback',
 ]);
 
 const USAGE = `claude-token-saver — Claude Code token usage, cache health, and model routing
@@ -107,6 +107,7 @@ Usage:
   claude-token-saver last               most recent warning + how to handle it
   claude-token-saver history            recent warning transitions
   claude-token-saver handoff            write a session handoff file
+  claude-token-saver feedback "<msg>"   file a bug report / feature request (no browser needed)
   claude-token-saver upgrade            install the latest release
   claude-token-saver --install-hook     install cache-monitor PostToolUse hook
   claude-token-saver --uninstall-hook   remove that hook
@@ -114,6 +115,7 @@ Usage:
       --verbose / --no-color / --icon / --no-timer / --single-line
 
 Run any subcommand with --help for its own options where available.
+Bug reports & feature requests: https://github.com/rootstudioyaml/claude-token-saver/issues
 `;
 
 async function main() {
@@ -161,6 +163,14 @@ async function main() {
   // hits.
   //   claude-token-saver handoff             # write to cwd
   //   claude-token-saver handoff --cwd PATH  # custom directory
+  // Subcommand: feedback — file a bug report / feature request without a
+  // browser. Tries gh CLI, then an anonymous form POST, then a local save
+  // with a prefilled GitHub issue URL. See src/commands/feedback.js.
+  if (args[0] === 'feedback') {
+    const { userDataDir } = await import('../src/paths.js');
+    return (await import('../src/commands/feedback.js')).run({ args, getArg, version: PKG_VERSION, dataDir: userDataDir() });
+  }
+
   if (args[0] === 'handoff') {
     return (await import('../src/commands/handoff.js')).run({ getArg });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-token-saver",
-  "version": "3.38.0",
+  "version": "3.39.0",
   "description": "Route the easy work your expensive Claude model keeps repeating down to haiku/sonnet — post-hoc session analysis, no realtime router, no extra LLM calls.",
   "type": "module",
   "bin": {

package/src/commands/feedback.js

@@ -0,0 +1,132 @@
+/**
+ * Subcommand: feedback — submit a bug report or feature request from the
+ * terminal (or from a Claude Code session) without opening a browser.
+ *
+ *   claude-token-saver feedback "statusline이 IntelliJ에서 깨져요"
+ *   claude-token-saver feedback --title "cache chip" "5m TTL 칩이 안 사라짐"
+ *
+ * Why this exists: GitHub issues require a logged-in browser session, and
+ * corporate networks often block github.com entirely. This command tries
+ * three transports in order and reports which one carried the message:
+ *
+ *   1. `gh` CLI, if installed and authenticated — files a real GitHub issue.
+ *   2. Anonymous Google Form POST — no login, no GitHub access needed.
+ *      (Only when the form endpoint below is configured for this build.)
+ *   3. Local fallback — saves the report to a Markdown file and prints a
+ *      prefilled GitHub new-issue URL to use from an unblocked machine.
+ *
+ * Metadata (tool version, OS, Node version) is attached automatically so a
+ * report is diagnosable without a follow-up round trip.
+ */
+
+import { spawnSync } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import os from 'node:os';
+import { debug } from '../debug.js';
+
+const REPO = 'rootstudioyaml/claude-token-saver';
+const ISSUES_URL = `https://github.com/${REPO}/issues`;
+
+// Anonymous submission endpoint (Google Form). A Google Form's formResponse
+// URL accepts unauthenticated POSTs, which is exactly the property a
+// login-free, GitHub-blocked-network path needs. Responses land in the
+// maintainer's "claude-token-saver 피드백 (Feedback)" form (published
+// 2026-09-13, responder access: anyone with the link).
+//   id      — the /d/e/<id>/ segment of the form URL
+//   message — entry.NNNN field id of the message question
+//   meta    — entry.NNNN field id of the metadata question
+const FORM = {
+  id: '1FAIpQLScISjU8_t9y8xfp-X3jvLV6_RcSjQIJ4aydATC8NazkxcJbgg',
+  message: 'entry.79517542',
+  meta: 'entry.112678638',
+};
+
+function metadata(version) {
+  return [
+    `version: ${version}`,
+    `os: ${process.platform} ${os.release()}`,
+    `node: ${process.version}`,
+  ].join('\n');
+}
+
+function tryGhCli(title, body) {
+  try {
+    const auth = spawnSync('gh', ['auth', 'status'], { encoding: 'utf8', timeout: 10_000 });
+    if (auth.status !== 0) return null;
+    const res = spawnSync('gh', ['issue', 'create', '-R', REPO, '--title', title, '--body', body],
+      { encoding: 'utf8', timeout: 30_000 });
+    if (res.status !== 0) { debug('feedback:gh', res.stderr); return null; }
+    const url = String(res.stdout).trim().split('\n').pop();
+    return { transport: 'gh', url };
+  } catch (e) { debug('feedback:gh', e); return null; }
+}
+
+async function tryForm(title, body, meta) {
+  if (!FORM) return null;
+  try {
+    const params = new URLSearchParams();
+    params.set(FORM.message, `${title}\n\n${body}`);
+    params.set(FORM.meta, meta);
+    const res = await fetch(`https://docs.google.com/forms/d/e/${FORM.id}/formResponse`, {
+      method: 'POST',
+      headers: { 'content-type': 'application/x-www-form-urlencoded' },
+      body: params.toString(),
+      signal: AbortSignal.timeout(15_000),
+    });
+    if (!res.ok) { debug('feedback:form', `HTTP ${res.status}`); return null; }
+    return { transport: 'form' };
+  } catch (e) { debug('feedback:form', e); return null; }
+}
+
+function saveLocal(title, body, dataDir) {
+  const dir = join(dataDir, 'feedback');
+  mkdirSync(dir, { recursive: true });
+  const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+  const file = join(dir, `${stamp}.md`);
+  writeFileSync(file, `# ${title}\n\n${body}\n`);
+  const prefilled = `${ISSUES_URL}/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}`;
+  return { transport: 'local', file, prefilled };
+}
+
+export async function run({ args, getArg, version, dataDir }) {
+  // --anonymous skips the gh transport: for people whose gh CLI is signed in
+  // with an account they do not want attached to the report.
+  const anonymous = args.includes('--anonymous');
+  const rest = args.slice(1).filter((a, i, all) => {
+    if (a === '--title') return false;
+    if (all[i - 1] === '--title') return false;
+    return !a.startsWith('--');
+  });
+  const message = rest.join(' ').trim();
+  const explicitTitle = getArg('--title');
+
+  if (!message) {
+    console.log('usage: claude-token-saver feedback [--title "<제목>"] "<내용>"');
+    console.log(`       (GitHub에서 직접 제보: ${ISSUES_URL})`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const title = explicitTitle || (message.length > 60 ? `${message.slice(0, 57)}...` : message);
+  const meta = metadata(version);
+  const body = `${message}\n\n---\n${meta}`;
+
+  const viaGh = anonymous ? null : tryGhCli(title, body);
+  if (viaGh) {
+    console.log(`feedback: GitHub 이슈로 등록했습니다 — ${viaGh.url}`);
+    return;
+  }
+
+  const viaForm = await tryForm(title, message, meta);
+  if (viaForm) {
+    console.log('feedback: 제출했습니다. 감사합니다. (익명 제출이라 답변 추적은 GitHub 이슈에서만 가능합니다)');
+    console.log(`          공개 트래커: ${ISSUES_URL}`);
+    return;
+  }
+
+  const local = saveLocal(title, body, dataDir);
+  console.log(`feedback: 온라인 제출 경로가 없어 로컬에 저장했습니다: ${local.file}`);
+  console.log('          GitHub 접근이 가능한 환경에서 아래 주소를 열면 내용이 채워진 이슈 작성 화면이 나옵니다:');
+  console.log(`          ${local.prefilled}`);
+}

package/src/commands/install.js

@@ -73,7 +73,31 @@ export async function run({ hasFlag }) {
     print('SessionStart hook (route-scan)', r.sessionStartHook);
     print('UserPromptSubmit hook (brief)', r.briefHook);
     {
-      const s = r.statusline;
+      let s = r.statusline;
+      // A different statusline is already installed. Replacing it silently
+      // would be rude and leaving it silently loses the tool's main surface,
+      // so with a human attached the install asks. Default is "keep yours":
+      // an accidental Enter must not clobber someone's custom statusline.
+      if (s.action === 'skipped' && s.conflict && interactive) {
+        console.log('');
+        console.log(lang === 'ko'
+          ? `  statusline: 기존 statusline이 이미 설정되어 있습니다: ${s.existingCommand}`
+          : `  statusline: an existing statusline is already configured: ${s.existingCommand}`);
+        console.log(lang === 'ko'
+          ? '              교체하면 토큰·캐시·상한 경고가 statusline에 표시됩니다. 기존 설정은 사라집니다.'
+          : '              replacing it shows token/cache/cap warnings in the statusline; the current one is removed.');
+        const replace = await confirm(lang === 'ko'
+          ? '              claude-token-saver statusline으로 교체할까요?'
+          : '              Replace it with the claude-token-saver statusline?', { defaultValue: false });
+        if (replace) {
+          const { installStatusline } = await import('../installer.js');
+          s = installStatusline({ force: true });
+        } else {
+          s = { ...s, reason: lang === 'ko'
+            ? '기존 statusline을 유지했습니다. 교체하려면 `claude-token-saver install --force`'
+            : 'kept your statusline — replace later with `claude-token-saver install --force`' };
+        }
+      }
       const verb = s.action === 'exists' ? 'already configured (refreshInterval=5)'
         : s.action === 'skipped' ? `skipped — ${s.reason}`
         : s.reason ? `${s.action} — ${s.reason}`
@@ -326,5 +350,9 @@ export async function run({ hasFlag }) {
       console.log('');
       console.log('Tip: re-run with --force to overwrite the existing skill file.');
     }
+    console.log('');
+    console.log(lang === 'ko'
+      ? '버그 제보·기능 제안: https://github.com/rootstudioyaml/claude-token-saver/issues'
+      : 'Bug reports & feature requests: https://github.com/rootstudioyaml/claude-token-saver/issues');
     return;
 }

package/src/installer.js

@@ -114,6 +114,12 @@ honor that for the rest of the turn without changing the saved setting.
   capturing git status + cap snapshot, so a fresh session can resume cleanly.
 - \`claude-token-saver mode\` — show statusline preferences.
 - \`claude-token-saver mode icon verbose 1d\` — change preferences.
+- \`claude-token-saver feedback "<message>"\` — file a bug report or feature
+  request for this tool right from the session (tries the gh CLI, then an
+  anonymous no-login submission, then saves locally with a prefilled GitHub
+  issue URL; \`--anonymous\` skips the gh path).
+  Use it whenever the user says the tool itself misbehaves or wishes it did
+  something it does not — offer to submit the report for them.
 
 ## Storage layout (for reference)
 
@@ -197,7 +203,10 @@ export function installStatusline({ force = false } = {}) {
   }
 
   if (!force) {
-    return { path: file, action: 'skipped', reason: `existing statusLine command (${cur.command}) — re-run with --force to overwrite` };
+    // `conflict` lets the interactive install distinguish "someone else's
+    // statusline is here" (worth asking about) from other skip reasons
+    // (unreadable JSON), which a prompt cannot fix.
+    return { path: file, action: 'skipped', conflict: true, existingCommand: cur.command, reason: `existing statusLine command (${cur.command}) — re-run with --force to overwrite` };
   }
   settings.statusLine = {
     type: 'command',