consolidate-session.py

#!/usr/bin/env python3
"""Session consolidation - close out a session and feed the brain.

Runs at session end ("good night"). Takes the session's decisions, learnings,
artifacts and pending items, and writes them into the vault: a session note,
log entries, recent.md changelog, and decision log entries (via the same
DEC-### convention as register-decision.py).

Usage:
    python3 bin/consolidate-session.py \
        --objective "what the session was about" \
        --decisions "DEC-001|Title of decision" \
        --learnings "learning one|learning two" \
        --artifacts "/abs/path:what it is" \
        --pending "open item|owner|deadline" \
        [--vault PATH] [--dry-run]

Config:
    BRAINSTACK_VAULT env var (default: ~/vault)
"""
import argparse
import os
import re
import sys
from datetime import datetime
from pathlib import Path


def get_vault(args) -> Path:
    return Path(args.vault or os.environ.get("BRAINSTACK_VAULT", "~/vault")).expanduser()


def append(path: Path, text: str):
    with path.open("a", encoding="utf-8") as f:
        f.write(text)


def main():
    ap = argparse.ArgumentParser(description="Session-end consolidation")
    ap.add_argument("--objective", default="", help="session objective")
    ap.add_argument("--decisions", default="", help="pipe-separated 'DEC-ID|title' items")
    ap.add_argument("--learnings", default="", help="pipe-separated learnings")
    ap.add_argument("--artifacts", default="", help="pipe-separated 'path:description' items")
    ap.add_argument("--pending", default="", help="pipe-separated 'item|owner|deadline' items")
    ap.add_argument("--vault", help="vault path (or BRAINSTACK_VAULT env)")
    ap.add_argument("--dry-run", action="store_true")
    args = ap.parse_args()

    vault = get_vault(args)
    if not vault.is_dir():
        sys.exit(f"vault not found: {vault}")
    now = datetime.now()
    stamp = now.strftime("%Y-%m-%d %H:%M")
    day = now.strftime("%Y-%m-%d")

    # Build the session note
    note = [f"# Session - {day}\n"]
    if args.objective:
        note.append(f"## Objective\n{args.objective}\n")
    if args.learnings:
        note.append("## Learnings")
        for l in args.learnings.split("|"):
            note.append(f"- {l.strip()}")
        note.append("")
    if args.decisions:
        note.append("## Decisions")
        for d in args.decisions.split("|"):
            d = d.strip()
            did, _, title = d.partition(" ")
            note.append(f"- [[{did}]] {title}")
        note.append("")
    if args.pending:
        note.append("## Pending")
        for p in args.pending.split("|"):
            parts = [x.strip() for x in p.split(",")]
            item = parts[0] if parts else ""
            owner = parts[1] if len(parts) > 1 else "?"
            deadline = parts[2] if len(parts) > 2 else "?"
            note.append(f"- [ ] {item} (owner: {owner}, by: {deadline})")
        note.append("")
    if args.artifacts:
        note.append("## Artifacts")
        for a in args.artifacts.split("|"):
            path, _, desc = a.partition(":")
            note.append(f"- `{path.strip()}` - {desc.strip()}")
        note.append("")

    session_dir = vault / "01-Wiki" / "Meeting-Notes"
    session_file = session_dir / f"{day}-session.md"
    body = "\n".join(note)

    if args.dry_run:
        print(f"[dry-run] would write {session_file}\n{body}")
        return

    session_dir.mkdir(parents=True, exist_ok=True)
    if session_file.exists():
        # Merge: only append if this is a different session (multi-session days)
        append(session_file, "\n---\n\n" + body)
    else:
        session_file.write_text(body, encoding="utf-8")

    # Log + changelog
    append(vault / "log.md",
           f"- **{stamp}** | Session consolidated: [[{day}-session]]\n")
    recent = vault / "01-Wiki" / "now" / "recent.md"
    if recent.exists():
        append(recent, f"- **{stamp}** | Session consolidated: [[{day}-session]]\n")

    print(f"session consolidated -> {session_file.relative_to(vault)}")


if __name__ == "__main__":
    main()