throughline 0.10.16 → 0.10.17

package/CHANGELOG.md

@@ -10,6 +10,15 @@ shipped to npm but were not individually tagged on GitHub.
 
 ## [Unreleased]
 
+## [0.10.17] — 2026-09-12
+
+### 修正
+
+- npm 12が単一要素配列で返す公開版情報を自己更新で受け入れるようにした。
+  正常にpackageを更新しても`version_verification_failed`で停止する問題を修正した。
+  旧文字列形式を維持し、複数版・空配列・不正な値は後続の設定・移行処理の前に拒否する。
+- 公開前の梱包文書検査も、npm 12がpackage名をキーにして返す梱包情報に対応した。
+
 ## [0.10.16] — 2026-09-07
 
 ### 修正
@@ -1457,7 +1466,8 @@ two attempts, instrument first instead of patching again.
 
 ---
 
-[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.16...HEAD
+[Unreleased]: https://github.com/kitepon/Throughline/compare/v0.10.17...HEAD
+[0.10.17]: https://github.com/kitepon/Throughline/compare/v0.10.16...v0.10.17
 [0.10.16]: https://github.com/kitepon/Throughline/compare/v0.10.15...v0.10.16
 [0.10.15]: https://github.com/kitepon/Throughline/compare/v0.10.14...v0.10.15
 [0.10.14]: https://github.com/kitepon/Throughline/compare/v0.10.13...v0.10.14

package/docs/04_public_release_plan.md

@@ -44,6 +44,9 @@ Windows PowerShell 5.1へ切り替えない。更新前CLIを再利用せず、
 新CLI、公開PATHから起動したCLI、そのversion、`throughline.self_update.v1`成功結果がすべて
 一致した場合だけ完了とする。複数npm prefixが混在して公開PATHが旧実体を指す場合は失敗する。
 
+公開版の照合は、npmの旧文字列形式と[npm 12の単一結果配列](https://docs.npmjs.com/cli/v12/commands/npm-view/#output)を受け入れる。
+複数版・空配列・不正な版情報から一つを推測して選ばず、後続の設定・移行処理の前に失敗を返す。
+
 ## 明示的失敗の契約
 
 想定外の状態、外部入力違反、I/O失敗、依存不足を成功扱いにしない。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "throughline",
-    "version": "0.10.16",
+    "version": "0.10.17",
     "type": "module",
     "description": "Persistent memory hooks for Claude Code, Codex, Grok, and Cursor (/clear-safe context compression)",
     "keywords": [

package/src/cli/self-update.mjs

@@ -77,7 +77,8 @@ function succeeded(result) {
 function parseRegistryVersion(result) {
   if (!succeeded(result)) return null;
   try {
-    const value = JSON.parse(result.stdout);
+    let value = JSON.parse(result.stdout);
+    if (Array.isArray(value) && value.length === 1) [value] = value;
     return typeof value === 'string' && VERSION_PATTERN.test(value) ? value : null;
   } catch {
     return null;

package/src/cli/self-update.test.mjs

@@ -181,6 +181,52 @@ test('new CLI completes install, migration, and diagnostics in order', () => {
   });
 });
 
+test('自己更新はnpmの単一版を文字列と単一要素配列から読み取る', () => {
+  for (const platform of ['darwin', 'linux', 'win32']) {
+    for (const registryVersion of ['0.10.16', ['0.10.16']]) {
+      const stdout = sink();
+      const calls = [];
+      const runner = (command, args) => {
+        calls.push([command, ...args]);
+        if (command === 'npm' || command === 'pwsh.exe') return ok(JSON.stringify(registryVersion));
+        if (args.at(-1) === 'install') return ok();
+        if (args.at(-2) === 'migrate') return ok(JSON.stringify(migration()));
+        if (args.at(-2) === 'factory-diagnostics') return ok(JSON.stringify(readyDiagnostics('0.10.16')));
+        throw new Error('想定外の更新工程');
+      };
+      assert.equal(run(['--json'], {
+        stdout, stderr: sink(), runner, platform, packageVersion: '0.10.16',
+        nodePath: '/node', cliPath: '/throughline.mjs',
+        env: {
+          THROUGHLINE_SELF_UPDATE_PHASE: 'post-install',
+          THROUGHLINE_SELF_UPDATE_BEFORE_VERSION: '0.10.15',
+          THROUGHLINE_SELF_UPDATE_EXPECTED_VERSION: '0.10.16',
+        },
+      }), 0, `${platform}: ${JSON.stringify(registryVersion)}`);
+      assert.equal(calls.length, 4);
+      assert.deepEqual(JSON.parse(stdout.values.join('')), updateSuccess('0.10.15', '0.10.16'));
+    }
+  }
+});
+
+test('自己更新は複数版・空配列・不正な版情報で後続工程を始めない', () => {
+  for (const value of [[], ['0.10.16', '0.10.17'], [['0.10.16']], [null], [{ version: '0.10.16' }], ['invalid']]) {
+    const stdout = sink();
+    let calls = 0;
+    assert.equal(run(['--json'], {
+      stdout, stderr: sink(), packageVersion: '0.10.16', platform: 'darwin',
+      runner: () => { calls += 1; return ok(JSON.stringify(value)); },
+      env: {
+        THROUGHLINE_SELF_UPDATE_PHASE: 'post-install',
+        THROUGHLINE_SELF_UPDATE_BEFORE_VERSION: '0.10.15',
+        THROUGHLINE_SELF_UPDATE_EXPECTED_VERSION: '0.10.16',
+      },
+    }), 1);
+    assert.equal(calls, 1);
+    assert.equal(JSON.parse(stdout.values.join('')).stage, 'version_verification_failed');
+  }
+});
+
 test('self-update fails closed without reflecting command output', () => {
   const stdout = sink();
   const stderr = sink();

package/src/docs-contract.test.mjs

@@ -6,9 +6,20 @@ import { fileURLToPath } from 'node:url';
 import {
   extractMarkdownTargets,
   findMissingPackedTargets,
+  packedFileSet,
 } from '../scripts/verify-pack-markdown-links.mjs';
 import { spawnPortableSync } from './os/portable-spawn-sync.mjs';
 
+test('梱包文書検査はnpmの旧配列形式とpackage名をキーにする形式を読む', () => {
+  const packed = { name: 'throughline', files: [{ path: 'README.md' }, { path: 'docs/00_overview.md' }] };
+  for (const report of [[packed], { throughline: packed }]) {
+    assert.deepEqual([...packedFileSet(report)], ['README.md', 'docs/00_overview.md']);
+  }
+  for (const report of [null, {}, [], [packed, packed], { throughline: { files: null } }]) {
+    assert.throws(() => packedFileSet(report), /npm pack dry-run JSON shape invalid/);
+  }
+});
+
 test('Markdown-only CI runs the product-owned documentation contract', () => {
   const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
   assert.equal(