@quolu/lattice 0.52.3 → 0.53.0

package/src/seam-commit-shared.mjs

@@ -1,22 +1,22 @@
-import { execFile } from 'node:child_process';
-import path from 'node:path';
-import { promisify } from 'node:util';
-
-export const execFileAsync = promisify(execFile);
-
-export const GIT_SHA1 = /^[0-9a-f]{40}$/u;
-
-export const SEAM_REF_PREFIX = 'refs/lattice/seam';
-
-export async function git(args, cwd) {
-  const { stdout } = await execFileAsync('git', args, {
-    cwd, encoding: 'utf8', maxBuffer: 32 * 1024 * 1024,
-  });
-  return stdout;
-}
-
-export function safeRelative(target) {
-  return typeof target === 'string' && target.length > 0 && !target.includes('\0')
-    && !path.posix.isAbsolute(target) && target === path.posix.normalize(target)
-    && !target.split('/').includes('..');
-}
+import { execFile } from 'node:child_process';
+import path from 'node:path';
+import { promisify } from 'node:util';
+
+export const execFileAsync = promisify(execFile);
+
+export const GIT_SHA1 = /^[0-9a-f]{40}$/u;
+
+export const SEAM_REF_PREFIX = 'refs/lattice/seam';
+
+export async function git(args, cwd) {
+  const { stdout } = await execFileAsync('git', args, {
+    cwd, encoding: 'utf8', maxBuffer: 32 * 1024 * 1024,
+  });
+  return stdout;
+}
+
+export function safeRelative(target) {
+  return typeof target === 'string' && target.length > 0 && !target.includes('\0')
+    && !path.posix.isAbsolute(target) && target === path.posix.normalize(target)
+    && !target.split('/').includes('..');
+}

package/src/seam-commit-transform.mjs

@@ -1,81 +1,81 @@
-import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import path from 'node:path';
-import { GIT_SHA1, execFileAsync, git, safeRelative } from './seam-commit-shared.mjs';
-import { seamRefFor } from './seam-ref.mjs';
-
-/**
- * 採用された変換をcommitへ確定し、そのshaを返す。
- *
- * 本repositoryの作業ツリーは触らない。使い捨てworktreeをbaseへ張り、変換後のfileを書き、
- * detached HEADでcommitし、refへ繋いでからworktreeを畳む。commit objectはobject DBを共有する
- * ので、worktreeを消してもshaは生き残る——refはそれをGCから守るためである。
- *
- * @param {object} options
- * @param {string} options.repoRoot 本repository
- * @param {string} options.baseSha 変換前のbase
- * @param {object} options.files pathごとの変換後text
- * @param {string} options.candidateId ref名に使う識別子
- * @param {string} options.message commit message
- * @returns {Promise<{commitSha: string, ref: string}>}
- */
-export async function commitSeamTransform({
-  repoRoot, baseSha, files, candidateId, message,
-} = {}) {
-  if (typeof repoRoot !== 'string' || repoRoot.length === 0) throw new TypeError('repoRootが不正');
-  if (!GIT_SHA1.test(baseSha ?? '')) throw new TypeError('baseShaが不正');
-  if (files === null || typeof files !== 'object' || Array.isArray(files)
-    || Object.keys(files).length === 0) throw new TypeError('filesが不正');
-  const targets = Object.keys(files);
-  if (!targets.every(safeRelative)) throw new TypeError('変換後pathがrepo相対規律を満たさない');
-  if (typeof candidateId !== 'string' || !/^[0-9A-Za-z][\w.-]{0,127}$/u.test(candidateId)) {
-    throw new TypeError('candidateIdが不正');
-  }
-
-  const worktreeRoot = await mkdtemp(path.join(tmpdir(), 'lattice-seam-commit-'));
-  const worktreePath = path.join(worktreeRoot, 'tree');
-  let commitSha;
-  try {
-    await git(['worktree', 'add', '--detach', '--quiet', worktreePath, baseSha], repoRoot);
-    for (const [target, text] of Object.entries(files)) {
-      const absolute = path.join(worktreePath, target);
-      await mkdir(path.dirname(absolute), { recursive: true });
-      await writeFile(absolute, text);
-    }
-    await git(['add', '--', ...targets], worktreePath);
-    // 変換で1 byteも変わらなかったなら、確定すべき成果が無い。空commitで
-    // 「進んだ」ように見せない。
-    const staged = await git(['diff', '--cached', '--name-only'], worktreePath);
-    if (staged.trim() === '') throw new TypeError('変換後の差分が無い');
-    await git([
-      '-c', 'user.email=lattice@localhost', '-c', 'user.name=lattice',
-      'commit', '--quiet', '-m', message ?? `seam transform ${candidateId}`,
-    ], worktreePath);
-    commitSha = (await git(['rev-parse', 'HEAD'], worktreePath)).trim();
-    if (!GIT_SHA1.test(commitSha)) throw new TypeError('commit shaが不正');
-  } finally {
-    await git(['worktree', 'remove', '--force', worktreePath], repoRoot).catch(() => {});
-    await rm(worktreeRoot, { recursive: true, force: true });
-  }
-
-  // worktreeを畳んだ後にrefを張る。object DBは共有なのでshaは生きているが、
-  // refが無いとGCの対象になる。
-  const ref = seamRefFor(candidateId);
-  // 同じcandidateへ2回目の変換が来た時、黙って上書きすると1回目の証跡が消える。
-  // 連鎖は「前の変換を含むbaseの上で次を確定する」形でしか正しくならないので、
-  // 既存refが今回のbaseの祖先を指していなければ拒む（ADR 0142 / ADR 0141 OQ2）。
-  const existing = await git(['for-each-ref', '--format=%(objectname)', ref], repoRoot)
-    .then((stdout) => stdout.trim())
-    .catch(() => '');
-  if (GIT_SHA1.test(existing) && existing !== commitSha) {
-    const chained = await execFileAsync('git', ['merge-base', '--is-ancestor', existing, baseSha], {
-      cwd: repoRoot, encoding: 'utf8',
-    }).then(() => true).catch(() => false);
-    if (!chained) {
-      throw new Error(`seam ref ${ref} は既に ${existing} を指しており、今回のbaseはその子孫でない`
-        + '。前の変換を含むbaseの上で確定するか、別のcandidate idを使う');
-    }
-  }
-  await git(['update-ref', ref, commitSha], repoRoot);
-  return { commitSha, ref };
-}
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { GIT_SHA1, execFileAsync, git, safeRelative } from './seam-commit-shared.mjs';
+import { seamRefFor } from './seam-ref.mjs';
+
+/**
+ * 採用された変換をcommitへ確定し、そのshaを返す。
+ *
+ * 本repositoryの作業ツリーは触らない。使い捨てworktreeをbaseへ張り、変換後のfileを書き、
+ * detached HEADでcommitし、refへ繋いでからworktreeを畳む。commit objectはobject DBを共有する
+ * ので、worktreeを消してもshaは生き残る——refはそれをGCから守るためである。
+ *
+ * @param {object} options
+ * @param {string} options.repoRoot 本repository
+ * @param {string} options.baseSha 変換前のbase
+ * @param {object} options.files pathごとの変換後text
+ * @param {string} options.candidateId ref名に使う識別子
+ * @param {string} options.message commit message
+ * @returns {Promise<{commitSha: string, ref: string}>}
+ */
+export async function commitSeamTransform({
+  repoRoot, baseSha, files, candidateId, message,
+} = {}) {
+  if (typeof repoRoot !== 'string' || repoRoot.length === 0) throw new TypeError('repoRootが不正');
+  if (!GIT_SHA1.test(baseSha ?? '')) throw new TypeError('baseShaが不正');
+  if (files === null || typeof files !== 'object' || Array.isArray(files)
+    || Object.keys(files).length === 0) throw new TypeError('filesが不正');
+  const targets = Object.keys(files);
+  if (!targets.every(safeRelative)) throw new TypeError('変換後pathがrepo相対規律を満たさない');
+  if (typeof candidateId !== 'string' || !/^[0-9A-Za-z][\w.-]{0,127}$/u.test(candidateId)) {
+    throw new TypeError('candidateIdが不正');
+  }
+
+  const worktreeRoot = await mkdtemp(path.join(tmpdir(), 'lattice-seam-commit-'));
+  const worktreePath = path.join(worktreeRoot, 'tree');
+  let commitSha;
+  try {
+    await git(['worktree', 'add', '--detach', '--quiet', worktreePath, baseSha], repoRoot);
+    for (const [target, text] of Object.entries(files)) {
+      const absolute = path.join(worktreePath, target);
+      await mkdir(path.dirname(absolute), { recursive: true });
+      await writeFile(absolute, text);
+    }
+    await git(['add', '--', ...targets], worktreePath);
+    // 変換で1 byteも変わらなかったなら、確定すべき成果が無い。空commitで
+    // 「進んだ」ように見せない。
+    const staged = await git(['diff', '--cached', '--name-only'], worktreePath);
+    if (staged.trim() === '') throw new TypeError('変換後の差分が無い');
+    await git([
+      '-c', 'user.email=lattice@localhost', '-c', 'user.name=lattice',
+      'commit', '--quiet', '-m', message ?? `seam transform ${candidateId}`,
+    ], worktreePath);
+    commitSha = (await git(['rev-parse', 'HEAD'], worktreePath)).trim();
+    if (!GIT_SHA1.test(commitSha)) throw new TypeError('commit shaが不正');
+  } finally {
+    await git(['worktree', 'remove', '--force', worktreePath], repoRoot).catch(() => {});
+    await rm(worktreeRoot, { recursive: true, force: true });
+  }
+
+  // worktreeを畳んだ後にrefを張る。object DBは共有なのでshaは生きているが、
+  // refが無いとGCの対象になる。
+  const ref = seamRefFor(candidateId);
+  // 同じcandidateへ2回目の変換が来た時、黙って上書きすると1回目の証跡が消える。
+  // 連鎖は「前の変換を含むbaseの上で次を確定する」形でしか正しくならないので、
+  // 既存refが今回のbaseの祖先を指していなければ拒む（ADR 0142 / ADR 0141 OQ2）。
+  const existing = await git(['for-each-ref', '--format=%(objectname)', ref], repoRoot)
+    .then((stdout) => stdout.trim())
+    .catch(() => '');
+  if (GIT_SHA1.test(existing) && existing !== commitSha) {
+    const chained = await execFileAsync('git', ['merge-base', '--is-ancestor', existing, baseSha], {
+      cwd: repoRoot, encoding: 'utf8',
+    }).then(() => true).catch(() => false);
+    if (!chained) {
+      throw new Error(`seam ref ${ref} は既に ${existing} を指しており、今回のbaseはその子孫でない`
+        + '。前の変換を含むbaseの上で確定するか、別のcandidate idを使う');
+    }
+  }
+  await git(['update-ref', ref, commitSha], repoRoot);
+  return { commitSha, ref };
+}

package/src/seam-commit.mjs

@@ -1,18 +1,18 @@
-/**
- * 採用された変換を、branchを動かさずにcommitとして確定する（ADR 0141）。
- *
- * 再開先が実在するbaseを要る。後継planへ旧baseを渡すと、splitが「T1は新pathを所有する」と
- * 述べるのに、再開したworkerのworktreeにそのfileが無い——所有すると宣言されたものが存在しない。
- *
- * canonical branchへは出さない。detached HEADでcommitし、`refs/lattice/seam/<id>`へ繋いでGCから
- * 守る。branchは動かず外部へ効果を出さないまま、worktreeを張れる実在のcommitになる。
- */
-
-import { execFile } from 'node:child_process';
-import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import path from 'node:path';
-import { promisify } from 'node:util';
-export { commitSeamTransform } from './seam-commit-transform.mjs';
-export { seamRefFor } from './seam-ref.mjs';
-
+/**
+ * 採用された変換を、branchを動かさずにcommitとして確定する（ADR 0141）。
+ *
+ * 再開先が実在するbaseを要る。後継planへ旧baseを渡すと、splitが「T1は新pathを所有する」と
+ * 述べるのに、再開したworkerのworktreeにそのfileが無い——所有すると宣言されたものが存在しない。
+ *
+ * canonical branchへは出さない。detached HEADでcommitし、`refs/lattice/seam/<id>`へ繋いでGCから
+ * 守る。branchは動かず外部へ効果を出さないまま、worktreeを張れる実在のcommitになる。
+ */
+
+import { execFile } from 'node:child_process';
+import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { promisify } from 'node:util';
+export { commitSeamTransform } from './seam-commit-transform.mjs';
+export { seamRefFor } from './seam-ref.mjs';
+