Method commit

src/filesystem/transaction.ts:144–224

(summary?: string)

    // Scope gate — same contract as write() above.
    {
      const denial = checkWriteScope(abs);
      if (denial) {
        logger.info('Scope gate refused delete', { txnId: this.id, path: abs });
        throw new Error(denial);
      }
    }
    const content = await fs.readFile(abs, 'utf-8');
    const hash = hashContent(content);
    await this.journal.storeBlob(hash, content);

    await fs.unlink(abs);

    this.ops.push({
      operation: 'delete',
      path: abs,
      beforeHash: hash,
      afterHash: null,
      beforeContent: content,
    });
  }

  async commit(summary?: string): Promise<string | null> {
    this.ensureOpen();
    if (this.ops.length === 0) {
      this.status = 'committed';
      return null;
    }

    // Try git commit — categorize failures.
    let gitStatus: 'committed' | 'skipped-not-a-repo' | 'skipped-gitignored' | 'failed' = 'skipped-not-a-repo';
    let gitFailReason: string | null = null;
    try {
      const git = simpleGit(process.cwd());
      const isRepo = await git.checkIsRepo();
      if (isRepo) {
        const relPaths = this.ops.map(o => path.relative(process.cwd(), o.path));

        // Filter out paths that are ignored — git add will refuse them and abort the whole add.
        const trackable: string[] = [];
        const ignored: string[] = [];
        try {
          // simple-git checkIgnore returns paths that ARE ignored
          const ignoredPaths = await git.checkIgnore(relPaths);
          for (const p of relPaths) {
            if (ignoredPaths.includes(p)) ignored.push(p);
            else trackable.push(p);
          }
        } catch {
          // If checkIgnore fails for any reason, attempt to add everything
          trackable.push(...relPaths);
        }

        if (ignored.length > 0) {
          logger.warn('Git: some files are gitignored, transaction journal still tracks them', {
            ignored,
            txnId: this.id,
          });
          gitFailReason = `Gitignored (not in git): ${ignored.join(', ')}`;