mma

Objective

Fold the oldest 2^k entries from _meta/log.md into a single summary page, reducing log.md size while preserving all information.

This command is operational only. Do not write /mma, /memory-mason:mma, or their execution chatter back into the vault.

Auto-Trigger

Routine archival runs automatically when mmc appends a build log entry that brings _meta/log.md to 32 or more entries. mmc folds the oldest 16 entries (k=4) into _meta/folds/ without requiring a manual /mma call.

Use /mma for:

• Manual runs outside the compile flow
• Custom batch sizes (--k 5 folds 32 entries at once)
• Dry-run inspection before committing a fold (--dry-run)

Path Resolution

Before any other reasoning, resolve vault config in this priority order:

1. Project ./.env
2. Project ./memory-mason.json
3. Global ~/.memory-mason/.env
4. Global ~/.memory-mason/config.json

Resolve:

• {vault}: absolute path to the Obsidian vault
• {subfolder}: plugin-managed subfolder inside the vault

Use the source that provides the vault path.

Subfolder rules:

• If the vault path comes from an .env file, use MEMORY_MASON_SUBFOLDER from that same file when present, otherwise default to ai-knowledge.
• If the vault path comes from memory-mason.json or ~/.memory-mason/config.json, use its subfolder.

Do not claim config is missing until you have attempted all four locations above. If none provide a vault path, fail fast with an explicit error that names every location checked.

Parameters

• --dry-run: Show what would be folded without writing anything. Default behavior.
• --k <n>: Batch exponent. Fold 2^n entries at once. Default: k=4 (16 entries).

Always dry-run first. Only write when user confirms or --commit is passed.

Steps

1. Read {vault}/{subfolder}/_meta/log.md.

   • Count total entries (each starts with ## [).
   • If under 32 entries, report "Nothing to fold yet (N entries, minimum 32)." and stop.

2. Determine fold range.

   • Take the oldest 2^k entries (default 16).
   • Record the earliest and latest timestamps from those entries.
   • Generate fold ID: fold-k{k}-from-{EARLIEST-DATE}-to-{LATEST-DATE}-n{COUNT} Example: fold-k4-from-2026-04-01-to-2026-04-16-n16

3. Generate fold summary.

   • Extractive: summarize what those entries recorded (compiles run, articles created/updated, queries answered).
   • Include exact wikilinks to articles mentioned.
   • Do NOT invent facts not present in the source entries.

4. Fold page format (_meta/folds/{fold-id}.md):

---
title: "Fold: {EARLIEST-DATE} to {LATEST-DATE}"
fold_id: "{fold-id}"
entries_folded: {COUNT}
source: "_meta/log.md"
created: {ISO-date}
---

# Build Log Fold: {EARLIEST-DATE} to {LATEST-DATE}

{COUNT} entries from {EARLIEST-DATE} to {LATEST-DATE}.

## Summary

- Compiles run: {count}
- Articles created: {count} ({list key ones with wikilinks})
- Articles updated: {count}
- Queries answered: {count}

## Source Entries

{verbatim copy of the folded entries}

5. Write the fold page to _meta/folds/{fold-id}.md.

6. Remove the folded entries from log.md.

   • Replace the folded section with a single back-reference line: <!-- folded: [[{subfolder}/_meta/folds/{fold-id}]] ({COUNT} entries, {EARLIEST-DATE} to {LATEST-DATE}) -->

7. Append to log.md:

## [{ISO-timestamp}] fold | {fold-id}
- Entries folded: {COUNT} ({EARLIEST-DATE} to {LATEST-DATE})
- Fold page: [[{subfolder}/_meta/folds/{fold-id}]]

Dry-run Output

Report without writing:

Fold plan:
- Entries to fold: {COUNT} (oldest 2^{k})
- Date range: {EARLIEST-DATE} to {LATEST-DATE}
- Fold ID: {fold-id}
- Fold page: _meta/folds/{fold-id}.md
- Remaining in log.md: {total - COUNT} entries

Run /mma --commit to execute.