@logicseek/hello-cc 0.1.0 → 0.1.2

package/scripts/regression.mjs

@@ -473,6 +473,31 @@ async function expectWebSocketMarker(peer, marker) {
   });
 }
 
+async function expectResizeReplaceSnapshot(peer, marker) {
+  await new Promise((resolve, reject) => {
+    let sawSnapshot = false;
+    const ws = new WebSocket(`ws://127.0.0.1:${port}/ws/terminal/${encodeURIComponent(peer)}`);
+    const timer = setTimeout(() => reject(new Error(`${peer} resize replace timeout`)), 5000);
+    ws.on('open', () => {
+      const result = hccMaybe(['inject', peer, `echo ${marker}`]);
+      if (result.status !== 0) reject(new Error(result.stderr || result.stdout || 'inject failed'));
+    });
+    ws.on('message', (raw) => {
+      const msg = JSON.parse(String(raw));
+      if (msg.type === 'snapshot') {
+        sawSnapshot = true;
+        ws.send(JSON.stringify({ type: 'resize', cols: 96, rows: 28 }));
+      }
+      if (sawSnapshot && msg.type === 'replace' && String(msg.data || '').includes(marker)) {
+        clearTimeout(timer);
+        ws.close();
+        resolve();
+      }
+    });
+    ws.on('error', reject);
+  });
+}
+
 function tmuxStreamNodes() {
   const dir = path.join(root, '.hello-cc', 'bufs');
   if (!fs.existsSync(dir)) return [];
@@ -871,6 +896,7 @@ async function tmuxBackedStartWorkflow() {
   hcc(['inject', 'shell-a', `echo PTY_OK > ${file}`]);
   await waitForFile(file, 'PTY_OK', 'pty injection');
   await expectWebSocketMarker('shell-a', 'WS_PTY_OK');
+  await expectResizeReplaceSnapshot('shell-a', 'WS_RESIZE_OK');
   await expectBoundedTmuxStream('tmux-backed FIFO stream');
 
   await stopRuntime();
@@ -1098,7 +1124,17 @@ async function downGcPackWorkflow() {
   await stopRuntime();
   await waitFor(() => !fs.existsSync(path.join(root, '.hello-cc', 'runtime.json')), 'runtime cleanup', 5000);
   hcc(['gc', '--older-than', '0', '--yes']);
-  run('npm', ['pack', '--dry-run']);
+  const pack = JSON.parse(run('npm', ['pack', '--dry-run', '--json']));
+  const files = new Set(pack[0]?.files?.map((entry) => entry.path) || []);
+  for (const file of ['assets/logo.svg', 'CHANGELOG.md', 'docs/commands.md', 'docs/commands.zh-CN.md']) {
+    if (!files.has(file)) fail(`npm package missing ${file}`);
+  }
+  const releaseCheck = run('npm', ['run', 'release:check']);
+  if (!releaseCheck.includes('release notes ok: 0.1.2')) fail(`release check output wrong:\n${releaseCheck}`);
+  const releaseNotes = run('npm', ['run', 'release:notes']);
+  if (!releaseNotes.includes('## 0.1.2') || !releaseNotes.includes('### Summary')) {
+    fail(`release notes output wrong:\n${releaseNotes}`);
+  }
 }
 
 function oldNameScan() {
@@ -1131,12 +1167,51 @@ function syntaxAndHelp() {
   run(process.execPath, ['--check', path.join(repoRoot, 'lib', 'setup.mjs')]);
   run(process.execPath, ['--check', path.join(repoRoot, 'lib', 'discover.mjs')]);
   const mainHelp = run(process.execPath, [hccBin, '--help']);
-  if (mainHelp.includes('setup') || mainHelp.includes('uninstall') || mainHelp.includes('--web-managed')) {
+  if (mainHelp.includes('setup') || mainHelp.includes('--web-managed')) {
     fail(`public help exposes maintenance or removed commands:\n${mainHelp}`);
   }
+  if (!mainHelp.includes('  update                       Update the global npm install of hello-cc')) {
+    fail(`main help missing update command:\n${mainHelp}`);
+  }
+  if (!mainHelp.includes('  uninstall                    Remove hooks, shims, and optional project data')) {
+    fail(`main help missing uninstall command:\n${mainHelp}`);
+  }
+  const updateHelp = run(process.execPath, [hccBin, 'update', '--help']);
+  if (!updateHelp.includes('hcc update') || !updateHelp.includes('npm install -g @logicseek/hello-cc@TAG')) {
+    fail(`update help missing expected content:\n${updateHelp}`);
+  }
+  const uninstallHelp = run(process.execPath, [hccBin, 'uninstall', '--help']);
+  if (!uninstallHelp.includes('hcc uninstall') || !uninstallHelp.includes('hcc uninstall [--purge --yes]')) {
+    fail(`uninstall help missing expected content:\n${uninstallHelp}`);
+  }
+  const updateDryRun = run(process.execPath, [hccBin, 'update', '--dry-run']);
+  if (!updateDryRun.includes('would run: npm install -g @logicseek/hello-cc@latest')) {
+    fail(`update dry-run output wrong:\n${updateDryRun}`);
+  }
+  const updateJson = JSON.parse(run(process.execPath, [hccBin, '--json', 'update', '--dry-run', '--tag', '0.1.2']));
+  if (!updateJson.ok || updateJson.data.command !== 'npm install -g @logicseek/hello-cc@0.1.2') {
+    fail(`update json dry-run output wrong:\n${JSON.stringify(updateJson)}`);
+  }
+  const updateBuildJson = JSON.parse(run(process.execPath, [hccBin, '--json', 'update', '--dry-run', '--tag', '1.2.3+build.1']));
+  if (!updateBuildJson.ok || updateBuildJson.data.command !== 'npm install -g @logicseek/hello-cc@1.2.3+build.1') {
+    fail(`update build-metadata dry-run output wrong:\n${JSON.stringify(updateBuildJson)}`);
+  }
   const runHelp = run(process.execPath, [hccBin, 'run', '--help']);
   if (runHelp.includes('--web-managed')) fail(`run help exposes removed --web-managed:\n${runHelp}`);
-  if (!run(process.execPath, [hccBin, 'peer', '--help']).includes('peer attach')) fail('peer attach missing from help');
+  const subcommandHelpCases = [
+    ['task', 'done', 'hcc task done'],
+    ['msg', 'ack', 'hcc msg ack'],
+    ['peer', 'attach', 'peer attach'],
+    ['lock', 'release', 'hcc lock release'],
+    ['handoff', 'create', 'hcc handoff create'],
+    ['event', 'tail', 'hcc event tail']
+  ];
+  for (const [group, subcommand, expected] of subcommandHelpCases) {
+    const help = run(process.execPath, [hccBin, group, subcommand, '--help']);
+    if (!help.includes(expected)) {
+      fail(`${group} ${subcommand} help missing expected content:\n${help}`);
+    }
+  }
   const removed = runMaybe(process.execPath, [hccBin, '--root', root, 'run', '--peer', 'bad', '--kind', 'shell', '--web-managed', '--', 'bash']);
   if (removed.status === 0 || !String(removed.stderr || removed.stdout).includes('unknown option --web-managed')) {
     fail(`run --web-managed was not rejected:\n${removed.stdout}\n${removed.stderr}`);

package/scripts/release-notes.mjs

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+
+const repoRoot = path.resolve(import.meta.dirname, '..');
+
+function usage() {
+  console.log(`release-notes
+
+Usage:
+  node scripts/release-notes.mjs [--version VERSION] [--check]
+
+Reads CHANGELOG.md and prints the section for VERSION. If VERSION is omitted,
+the current package.json version is used.
+
+Keep one top-level CHANGELOG.md file. For each release, add a new section:
+
+  ## 0.1.3
+
+The printed section is the source for GitHub Release notes and detailed npm
+package release descriptions.
+`);
+}
+
+function readJson(file) {
+  return JSON.parse(fs.readFileSync(file, 'utf8'));
+}
+
+function parseArgs(argv) {
+  const opts = { check: false, help: false, version: null };
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--help' || arg === '-h') {
+      opts.help = true;
+    } else if (arg === '--check') {
+      opts.check = true;
+    } else if (arg === '--version') {
+      opts.version = argv[++i];
+      if (opts.version === undefined) throw new Error('Missing value for --version');
+    } else if (arg.startsWith('--version=')) {
+      opts.version = arg.slice('--version='.length);
+    } else {
+      throw new Error(`Unknown argument: ${arg}`);
+    }
+  }
+  return opts;
+}
+
+function releaseSection(markdown, version) {
+  const lines = markdown.split(/\r?\n/);
+  const heading = `## ${version}`;
+  const start = lines.findIndex((line) => line.trim() === heading);
+  if (start < 0) return null;
+
+  let end = lines.length;
+  for (let i = start + 1; i < lines.length; i += 1) {
+    if (/^##\s+/.test(lines[i])) {
+      end = i;
+      break;
+    }
+  }
+  return lines.slice(start, end).join('\n').trimEnd();
+}
+
+function validateSection(section, version) {
+  const problems = [];
+  if (!section) {
+    problems.push(`CHANGELOG.md is missing section ## ${version}`);
+    return problems;
+  }
+  if (!section.includes('### Summary')) problems.push(`## ${version} is missing ### Summary`);
+  if (!section.includes('### Highlights')) problems.push(`## ${version} is missing ### Highlights`);
+  if (section.includes('TODO') || section.includes('TBD')) problems.push(`## ${version} still contains TODO/TBD text`);
+  const bulletCount = (section.match(/^- /gm) || []).length;
+  if (bulletCount < 2) problems.push(`## ${version} should include at least two release-note bullets`);
+  return problems;
+}
+
+function main() {
+  const opts = parseArgs(process.argv.slice(2));
+  if (opts.help) {
+    usage();
+    return;
+  }
+
+  const pkg = readJson(path.join(repoRoot, 'package.json'));
+  const version = opts.version || pkg.version;
+  const changelog = fs.readFileSync(path.join(repoRoot, 'CHANGELOG.md'), 'utf8');
+  const section = releaseSection(changelog, version);
+  const problems = validateSection(section, version);
+
+  if (opts.check) {
+    if (problems.length) {
+      console.error(problems.join('\n'));
+      process.exitCode = 1;
+      return;
+    }
+    console.log(`release notes ok: ${version}`);
+    return;
+  }
+
+  if (problems.length) {
+    console.error(problems.join('\n'));
+    process.exitCode = 1;
+    return;
+  }
+  console.log(section);
+}
+
+main();