hypomnema 1.6.2 → 1.7.0

package/templates/hypo-guide.md

@@ -2,6 +2,7 @@
 title: Wiki Operations Guide
 type: reference
 updated: YYYY-MM-DD
+version: 1
 tags: [wiki, guide, operations]
 ---
 
@@ -108,6 +109,11 @@ Ask: *"이 작업이 마무리되었나요? 세션을 정리(crystallize)할까
    committing the files, run `/hypo:crystallize` (`--mark-session-closed --session-id=<id> --transcript-path=<path>`).
    Both writers gate the marker on the SAME `precompactGateStatus` as `/compact`,
    so the marker only lands when step 6 would print **"Compact-ready"**.
+   `--session-id` is not optional on the apply path. Before it writes anything, the
+   apply reads that session's transcript for evidence the **user** asked to close, and
+   refuses the whole close (exit 1, nothing on disk, nothing committed) when the id is
+   missing, resolves to no transcript, or the user never asked. A refusal means the
+   close should not happen: ask, then re-run.
 
 Skip session close for: single bug fix, single-file edit, Q&A only.
 

package/scripts/check-bilingual.mjs

@@ -1,153 +0,0 @@
-#!/usr/bin/env node
-/**
- * check-bilingual.mjs — CLI gate for the bilingual release-doc rule.
- *
- * Modes:
- *   --changelog [version]   Validate CHANGELOG.md section for given version.
- *                           Defaults to package.json's "version" field.
- *                           Wired into npm `prepublishOnly` so publishes fail
- *                           when the Korean summary is missing.
- *
- *   --tag <ref>             Validate annotated tag body for given ref.
- *                           Wired into .github/workflows/release.yml so a
- *                           lightweight tag or a missing Korean section
- *                           blocks the npm publish step.
- *
- * Exits 0 on pass, 1 on fail with a stderr diagnostic.
- */
-
-import { readFileSync } from 'fs';
-import { spawnSync } from 'child_process';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-import {
-  validateChangelog,
-  validateTagBody,
-  listChangelogVersions,
-  meetsKoreanCutoff,
-} from './lib/check-bilingual.mjs';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const REPO_ROOT = join(__dirname, '..');
-
-const RULE_REF =
-  'Rule source: CLAUDE.md learned_behaviors (release-doc-bilingual, 2026-05-24). ' +
-  'OSS Hypomnema ships must carry English body + Korean summary in both CHANGELOG section and git tag annotation.';
-
-function fail(msg) {
-  process.stderr.write(`[check-bilingual] FAIL: ${msg}\n${RULE_REF}\n`);
-  process.exit(1);
-}
-
-function ok(msg) {
-  process.stdout.write(`[check-bilingual] OK: ${msg}\n`);
-  process.exit(0);
-}
-
-function usage(exitCode) {
-  process.stdout.write(
-    `Usage:\n` +
-      `  node scripts/check-bilingual.mjs --changelog [version]\n` +
-      `      Validate one CHANGELOG.md "## [<version>]" section (section model).\n` +
-      `      Default version: package.json.\n` +
-      `  node scripts/check-bilingual.mjs --changelog --all\n` +
-      `      Validate EVERY documented version (Korean enforced at >= 1.2.0,\n` +
-      `      English-only versions below the cutoff pass).\n` +
-      `  node scripts/check-bilingual.mjs --tag <ref>\n` +
-      `      Validate annotated tag body (lightweight tags are rejected).\n`,
-  );
-  process.exit(exitCode);
-}
-
-const args = process.argv.slice(2);
-const mode = args[0];
-const wantAll = args.includes('--all');
-
-if (mode === '--help' || mode === '-h') usage(0);
-if (!mode) usage(1);
-
-if (mode === '--changelog') {
-  let content;
-  try {
-    content = readFileSync(join(REPO_ROOT, 'CHANGELOG.md'), 'utf-8');
-  } catch (err) {
-    fail(`cannot read CHANGELOG.md: ${err.message}`);
-  }
-
-  if (wantAll) {
-    // Validate every documented version. Korean is enforced only at/after the
-    // cutoff; pre-cutoff versions pass on English presence (format.md §9). This
-    // is the migration gate — it must not green-pass a half-migrated file.
-    const versions = listChangelogVersions(content);
-    if (versions.length === 0) fail('no "## [<version>]" sections found in CHANGELOG.md');
-    const failures = [];
-    let enforced = 0;
-    for (const v of versions) {
-      const r = validateChangelog(content, v);
-      if (meetsKoreanCutoff(v)) enforced++;
-      if (!r.ok) failures.push(`  [${v}] ${r.reason}`);
-    }
-    if (failures.length) {
-      fail(`${failures.length}/${versions.length} version(s) failed:\n${failures.join('\n')}`);
-    }
-    ok(
-      `CHANGELOG.md --all: ${versions.length} versions conform ` +
-        `(${enforced} Korean-enforced at >= 1.2.0, ${versions.length - enforced} English-only below cutoff).`,
-    );
-  }
-
-  // single-version path (kept: prepublishOnly and release.yml call --changelog
-  // with no version, defaulting to package.json's).
-  let version = args[1] && !args[1].startsWith('--') ? args[1] : undefined;
-  if (!version) {
-    try {
-      const pkg = JSON.parse(readFileSync(join(REPO_ROOT, 'package.json'), 'utf-8'));
-      version = pkg.version;
-    } catch (err) {
-      fail(`cannot read package.json: ${err.message}`);
-    }
-  }
-  if (!version) fail('no version (arg empty, package.json has no "version" field)');
-
-  const result = validateChangelog(content, version);
-  if (!result.ok) fail(result.reason);
-  if (result.koreanExempt) {
-    ok(`CHANGELOG.md [${version}] — pre-cutoff version, English-only (Korean exempt).`);
-  } else {
-    ok(`CHANGELOG.md [${version}] — ${result.hangulCount} Hangul chars across "#### 한국어" sub-blocks.`);
-  }
-} else if (mode === '--tag') {
-  const ref = args[1];
-  if (!ref) fail('--tag requires a ref argument (e.g. v1.2.1)');
-
-  // Reject lightweight tags. `git rev-parse <ref>^{tag}` succeeds ONLY for
-  // annotated tags. For lightweight tags the ^{tag} peel fails because there
-  // is no tag object — the ref points straight at a commit.
-  const tagObj = spawnSync('git', ['rev-parse', '--verify', '--quiet', `${ref}^{tag}`], {
-    encoding: 'utf-8',
-    cwd: REPO_ROOT,
-  });
-  if (tagObj.status !== 0) {
-    const exists = spawnSync('git', ['rev-parse', '--verify', '--quiet', ref], {
-      encoding: 'utf-8',
-      cwd: REPO_ROOT,
-    });
-    if (exists.status !== 0) fail(`tag ${ref} not found`);
-    fail(
-      `tag ${ref} is a lightweight tag, not annotated. ` +
-        `Re-create with: git tag -a ${ref} -m "<English body>\n\n---\n\n<Korean summary>"`,
-    );
-  }
-
-  const tagBody = spawnSync('git', ['tag', '-l', `--format=%(contents)`, ref], {
-    encoding: 'utf-8',
-    cwd: REPO_ROOT,
-  });
-  if (tagBody.status !== 0) fail(`failed to read tag ${ref}: ${tagBody.stderr}`);
-
-  const result = validateTagBody(tagBody.stdout || '');
-  if (!result.ok) fail(`tag ${ref} — ${result.reason}`);
-  ok(`tag ${ref} annotation — ${result.hangulCount} Hangul chars after last "---" separator.`);
-} else {
-  fail(`unknown mode: ${mode}. Use --changelog or --tag (see --help).`);
-}

package/scripts/check-readme-version.mjs

@@ -1,126 +0,0 @@
-#!/usr/bin/env node
-// check-readme-version.mjs — assert the release version string is present in BOTH
-// README.md and README.ko.md. This is the machine FLOOR for the README-reconcile
-// step that was dropped three times (v1.2 / v1.3.0 / v1.3.1): a publish of vX.Y.Z
-// must not go out unless vX.Y.Z is written into both READMEs' version narrative.
-//
-// SCOPE (honest): this catches the GROSS drop — shipping a version whose sentence
-// was never added to the README at all. It does NOT verify the narrative is
-// accurate or that the first-viewport "current release" pointer was updated; that
-// stays a judgment step owned by the release checklist (docs/CONTRIBUTING.md
-// "Cutting a release"). README/CHANGELOG carry
-// prose version HISTORY (every past vX.Y.Z), so check-versions.mjs intentionally
-// excludes them — this script is their complement, not a duplicate.
-//
-// Usage:
-//   node scripts/check-readme-version.mjs                 # version from package.json
-//   node scripts/check-readme-version.mjs --version 1.4.0 # explicit version
-//   node scripts/check-readme-version.mjs --root <dir>    # point at a fixture (tests)
-//   node scripts/check-readme-version.mjs --json
-//
-// Exit 0 = both READMEs mention the version. Exit 1 = missing in one/both, or unreadable.
-
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-function parseArgs(argv) {
-  const args = { root: null, version: null, json: false };
-  for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
-    if (a.startsWith('--root=')) args.root = a.slice(7);
-    else if (a === '--root') args.root = argv[++i];
-    else if (a.startsWith('--version=')) args.version = a.slice(10);
-    else if (a === '--version') args.version = argv[++i];
-    else if (a === '--json') args.json = true;
-  }
-  return args;
-}
-
-const REPO_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
-
-const README_FILES = ['README.md', 'README.ko.md'];
-
-// Build a boundary-aware matcher so a version does not spuriously match inside a
-// LONGER version token yet still matches at a sentence boundary. The checked
-// version must be a standalone token, NOT a prefix of another version:
-//   - "1.3.40", "v11.3.4"      → reject (digit continuation)
-//   - "1.3.4.5"                → reject (dot-then-digit continuation)
-//   - "1.3.4-rc.1", "1.3.4+b"  → reject (a stable check must NOT pass on a
-//                                 prerelease/build string — that defeats the floor)
-//   - "1.3.0-rc.1a", "1.3.0-rc.10", "1.3.0-rc.1.alpha" → a prerelease check must
-//                                 reject these continuation tokens too
-//   - "shipped v1.3.4." / "v1.3.4**" / "(v1.3.4)" → match (sentence/markup boundary)
-// Leading: no digit/dot immediately before (an optional "v" is fine — it is
-// neither). Trailing: not a semver-continuation char ([0-9A-Za-z+-]) and not a
-// dot-then-alphanumeric (".5" / ".alpha" continuation); a sentence period
-// (dot followed by space / punctuation / end) is allowed.
-function versionPresent(text, version) {
-  const escaped = version.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-  return new RegExp(`(?<![\\d.])${escaped}(?![\\dA-Za-z+-])(?!\\.[\\dA-Za-z])`).test(text);
-}
-
-function checkReadmeVersions(root, version) {
-  const results = README_FILES.map((file) => {
-    const abs = join(root, file);
-    try {
-      const text = readFileSync(abs, 'utf-8');
-      return { file, present: versionPresent(text, version) };
-    } catch (err) {
-      return { file, present: false, error: err?.message ?? String(err) };
-    }
-  });
-  const ok = results.every((r) => r.present);
-  return { ok, version, results };
-}
-
-function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const root = args.root || REPO_ROOT;
-
-  let version = args.version;
-  if (!version) {
-    try {
-      version = JSON.parse(readFileSync(join(root, 'package.json'), 'utf-8')).version;
-    } catch (err) {
-      const msg = `cannot read package.json for version: ${err?.message ?? err}`;
-      if (args.json) console.log(JSON.stringify({ ok: false, error: msg }, null, 2));
-      else console.error(`✗ ${msg}`);
-      process.exit(1);
-    }
-  }
-  if (typeof version !== 'string' || !version) {
-    const msg = 'no version (—version empty and package.json has no "version" field)';
-    if (args.json) console.log(JSON.stringify({ ok: false, error: msg }, null, 2));
-    else console.error(`✗ ${msg}`);
-    process.exit(1);
-  }
-
-  const report = checkReadmeVersions(root, version);
-
-  if (args.json) {
-    console.log(JSON.stringify(report, null, 2));
-  } else {
-    for (const r of report.results) {
-      const mark = r.error ? `ERROR: ${r.error}` : r.present ? 'found' : 'MISSING';
-      console.log(`  ${r.file.padEnd(13)}  ${mark}`);
-    }
-    if (report.ok) {
-      console.log(`\n✓ both READMEs mention version ${version}`);
-    } else {
-      const missing = report.results
-        .filter((r) => !r.present)
-        .map((r) => (r.error ? `${r.file} (unreadable)` : r.file))
-        .join(', ');
-      console.error(
-        `\n✗ version ${version} missing from: ${missing}\n` +
-          `  Reconcile the version narrative in both READMEs before releasing ` +
-          `(the README reconcile step — see docs/CONTRIBUTING.md "Cutting a release").`,
-      );
-    }
-  }
-
-  process.exit(report.ok ? 0 : 1);
-}
-
-main();