Changelog

All notable changes to this project will be documented in this file.

The format loosely follows Keep a Changelog.

Unreleased

[0.9.0] – 2026-03-23

Summary

• Opens the 0.9 release line with Sparkle 2 in-app updates, Forge-macos-arm64.app.zip on tagged releases, and CI generate_appcast refreshing docs/appcast.xml—verified green on v0.8.14. See [0.8.13] and [0.8.14] for full notes.

[0.8.14] – 2026-03-22

Distribution / CI

• Sparkle appcast — release workflow runs generate_appcast twice so docs/appcast.xml regenerates for ad hoc–signed Forge.app CI builds (Sparkle’s strict code-sign check on first unarchive; see packaging/SPARKLE_SIGNING.md).

[0.8.13] – 2026-03-22

Forge.app

• Sparkle 2 — in-app updates via SUFeedURL (docs/appcast.xml on main), SUPublicEDKey, automatic daily checks (SUScheduledCheckInterval), and Check for Updates…. Sparkle.framework is embedded next to the executable (SwiftPM @loader_path layout). See packaging/SPARKLE_SIGNING.md and GitHub secret SPARKLE_EDDSA_PRIVATE_KEY for release signing.
• Removed the earlier custom GitHub REST + ditto updater.

Distribution

• Forge-macos-arm64.app.zip — release workflow builds forge-menubar (release) and assembles Forge.app via packaging/assemble_forge_app.sh, uploaded next to the CLI zip; when the signing secret is set, generate_appcast refreshes docs/appcast.xml and the workflow commits it to main after publishing the release assets.
• build.sh — delegates app bundle assembly to packaging/assemble_forge_app.sh.

0.8.12 – 2026-03-21

Forge.app (menubar and board)

• Default terminal — preferences can persist a chosen terminal (config.yaml terminal:): Auto, Ghostty, kitty, iTerm, Warp, cmux, or Terminal. forge … and editor launches honour this choice.
• Vim in terminal — editor option renamed to “Vim (in selected terminal)”; legacy “Vim (in default terminal)” still maps correctly.
• Centralised EditorLauncher — shared open-file/folder logic for the terminal editor and GUI editors.

Terminal integration

• TerminalLauncher — reliable launches per app (Ghostty surface config, kitty remote launch, iTerm/Terminal AppleScript, Warp YAML, cmux new-pane + send, fallbacks).
• openNeovim — opens the real file with cd dir && vim relative-file (bare vim on PATH); kitty still execs the nvim binary with a relative file argument.
• Environment — resolve HOME from the login record (getpwuid) and set XDG_* / PATH so Neovim plugin managers (e.g. lazy.nvim) use the same data dirs as a normal shell.
• cmux — warn when socket/automation mode blocks Forge; subprocess env allows automation where needed.

0.8.11 – 2026-03-20

Distribution

• Ship the pre-built CLI as Apple Silicon (arm64) only — single swift build on macos-15, release asset forge-macos-arm64.zip (Intel: build from source). Update site and README download links accordingly.

0.8.10 – 2026-03-20

Distribution

• Run the CLI release workflow on macos-15 so Swift 6 matches swift-tools-version 6.0; keep universal builds via swift build --triple for both slices.

0.8.9 – 2026-03-20

Distribution

• Fix the release workflow: use swift build --triple for arm64 and x86_64 (the --arch flag is not accepted on the GitHub Actions Swift toolchain).

0.8.8 – 2026-03-20

Distribution

• Add a GitHub Actions workflow that builds a universal (arm64 + x86_64) forge CLI on each version tag and attaches forge-macos-universal.zip to the release (stable URL: …/releases/latest/download/forge-macos-universal.zip).
• Add packaging/README-BINARY.txt with install and Gatekeeper notes; link the download from the project site hero and the README quick start.

0.8.6 – 2026-03-20

Documentation and site

• Publish the main documentation as static HTML on the GitHub Pages site (cli.html, app.html, neovim.html, manual.html, privacy.html, readme.html), generated from markdown via docs/build_site.py and docs/requirements.txt (Python markdown).
• Extend the landing page navigation and cross-links to those pages; add shared assets/theme.js and prose styles in assets/site.css.
• Document regeneration steps and the page ↔ source mapping in the README Project website section.

0.8.5 – 2026-03-20

Documentation and site

• Add a static project landing page under docs/ for GitHub Pages: hero, feature grid, forge/fire-themed styling (light/dark), quick start, and links to repository docs.
• Promote the live URL in the README and expand the Project website section with source file pointers and Pages setup.

[0.8.4] – 2026-03-20

CLI due and review

• forge due --areas now considers due dates in all markdown files under Forge/tasks/, including inbox.md and someday-maybe.md, and skips only the generated due.md summary (avoids feedback loops).
• forge review prints task IDs on key list items so you can jump straight to forge done / edits.

[0.8.3] – 2026-03-18

Sync correctness future-proofing

• Prefer a completed duplicate when the same task ID appears multiple times in markdown (so markdown completions propagate correctly).
• Add unit tests around sync input-selection and duplicate handling, plus refactor small decision helpers to be testable.
• Improve future reminder relinking by exposing looser signature helpers for unit testing.

[0.8.2] – 2026-03-18

Menubar correctness and freshness

• Keep menubar overdue / due-today counts aligned with forge due by avoiding double-counting and refreshing cached results periodically.
• Make task discovery more robust in the menubar app by falling back to a bounded scan of configured project roots when the task index database is unavailable.

[0.8.1] – 2026-03-17

Menubar and sync correctness

• Fix the menubar dropdown counts (overdue / due today) not always updating after a sync completes.
• Pull reminder due-date changes from Reminders.app back into markdown during sync.
• Ensure the board app’s toolbar refresh runs an in-process background sync (same as the menubar app) before reloading projects.

[0.8.0] – 2026-03-13

Board Radar and delegation polish

• Add a Radar filter to the kanban board that slices projects into three buckets based on urgency and neglect:
• Calm – recently-touched, non-urgent projects.
• Watch – projects whose TASKS.md has not changed for roughly a week.
• Heat – projects tagged with an URGENT… meta tag (for example URGENT ⚠️), or projects whose TASKS.md has been neglected for several weeks.
• Base neglect scoring on the last modification time of each project's TASKS.md file, falling back to the project directory when needed.
• Refine the board toolbar:
• Replace the generic meta-tag picker with the Radar picker so urgency and neglect are first-class filters.
• Rename the top-level delegation filter label from "All" to "Delegation" while keeping assignee filtering unchanged.

[0.7.1] – 2026-03-13

Documentation

• Add a “Who is Forge for?” section to the README and user manual, clarifying that Forge is a files-first, tag-driven system combining kanban-style project flow with GTD-inspired task management.

[0.7.0] – 2026-03-12

Linting and task discovery

• Preserve ## Notes sections in TASKS.md files when forge lint --fix runs and ensure canonical section order is Next Actions, Waiting For, Completed, Notes.
• Tighten heading and list formatting rules:
• Enforce exactly one empty line above and below headings when surrounded by content.
• Disallow blank lines between consecutive list items within the same section.
• Enforce trailing whitespace and EOF conventions:
• Remove trailing spaces and tabs from all lines.
• Require documents to end with exactly one empty line (a single trailing blank line terminated by a newline).
• Extend the task index to support explicit full rescans:
• Add a forceFullRescan flag on DatabaseTaskIndex and thread it through TaskDiscoveryService.
• Expose --rebuild-index flags on forge sync and forge due to force a fresh recursive scan of project roots and rebuild the task index database.

[0.6.2] – 2026-03-10

Menubar and board

• Refresh the kanban board view after each background sync (or “Sync Now”) so that newly applied Finder tags (e.g. column tags) and meta tags appear without reopening the board or restarting the app.

[0.6.1] – 2026-03-10

Privacy, licensing, and install UX

• Clarify Forge’s local-first, privacy-respecting data model in the README and manual, including how markdown files, the task file database, and Reminders/Calendar sync fit together.
• Add a dedicated PRIVACY.md describing what Forge stores, how sync works via macOS frameworks, and how to run in markdown-only or local-only modes.
• Add an Apache-2.0 LICENSE file and link it from the README.
• Update .gitignore to exclude tasks/, .cache/, and local config.yaml files so private task content, caches, and machine-specific configuration are not committed.
• Replace the tracked config.yaml with a sanitised config.sample.yaml that new users can copy and edit locally.

Build script and menubar polish

• Harden build.sh with a Swift toolchain check and clearer messaging, and warn when the chosen install directory for forge is not on PATH.
• Improve the Forge.app About panel copy to emphasise that all data stays in your own files.
• Add a small initial-sync window in the menubar app so the first background sync is visible without being modal.

[0.6.0] – 2026-03-10

Delegated projects and tasks

• Treat Finder tags starting with # on project folders (for example #PeggySue) as person tags and surface them as assignees on Project values.
• Extend the kanban board UI to show assignees on project cards and add an Assignee filter alongside existing column/meta/domain filters.
• Add assignee support to the board CLI:
• forge board --assignee Name filters projects by #Name.
• The list view shows both meta tags and @Name assignees.

Task-level delegation and CLI filters

• Extend ForgeTask and MarkdownIO to support task-level assignees via an inline @person(#Name) tag, in addition to existing @waiting(Name) semantics.
• Add a shared helper on ForgeTask so CLI commands can match both explicit assignees and waitingOn names consistently.
• Add --assignee filters to:
• forge next – filter next actions and waiting-for items by assignee and show @Name alongside existing due/context/waiting labels.
• forge due – filter due and upcoming tasks by assignee and show assignees in the output.
• forge waiting – narrow waiting-for items to a specific person.

Delegated overview and menubar integration

• Add a new forge delegated command that lists all delegated tasks (non-completed, non-deferred with an assignee) grouped by assignee and then by project/area.
• Extend the menubar app with a Delegation submenu (backed by a small list of favourite assignees) which can open:
• forge board --assignee Name
• forge next --assignee Name
• forge waiting --assignee Name

[0.5.0] – 2026-03-10

Performance

• Introduce a SQLite-backed task file database (TaskFileDatabase) to cache project and area task files and their metadata.
• Replace hot-path TaskFileFinder.findAll calls with a database-backed TaskIndex (DatabaseTaskIndex) and a one-off TaskDiscoveryService, substantially reducing repeated filesystem walks on forge sync, forge due, and menubar refresh.

Behaviour and architecture

• Wire SyncEngine, the CLI forge sync/forge due commands, and the menubar app to use the database-backed task index for TASKS.md discovery.
• Lay the groundwork for future incremental updates and cached counts (via TaskFileDatabase.filesNeedingParse, updateCounts, and aggregateCounts) without changing user-visible behaviour.
• Add documentation for:
• The task file database and event-driven discovery plan (docs/task-file-db-plan.md).
• A high-level Forge user manual describing core concepts, sync behaviour, and typical workflows (docs/forge-manual.md).
• Updated performance benchmarking guidance that explains how and when Forge syncs with Reminders and Calendar.

0.4.0 – 2026-03-10

Performance

• Cache project TASKS.md discovery via a shared task index to avoid repeated deep filesystem walks (df0da65).
• Improve menubar and CLI performance by refining recursive TASKS.md discovery under project roots (f999cc8, 937bed1, c695eec).
• Make menubar sync lighter while still regenerating the due summary (95b7ed8).
• Add several rounds of performance tuning across the CLI and menubar:
• Limit markdown size and Finder tag operations, and make CLI scans more asynchronous (48df623, 7dc44f2, 501887e, ba6bbda).

Behaviour and features

• Improve calendar event deduplication to avoid duplicate events for the same task (c654a75, 8253020).
• Refine inbox processing flow to better fit GTD-style capture and clarify how items move from inbox into projects and areas (83ae89c).
• Add markdown due summary generation and integrate it into the sync flow (279ee93), producing a Forge/tasks/due.md overview.
• Add a dedicated forge lint command and TaskFileLinter to enforce markdown conventions:
• Headings and spacing.
• Placement and formatting of completed tasks.
• Better handling of mail URLs and list spacing (be0861c, b1d30b6, 98a9390, f9a0cd5, d3d0f35, 1abeee5, add8ff7).
• Enhance capture:
• Support capture from Bookends and Obsidian (50865f5).
• Add a selection capture feature to inbox for quickly turning selected content into tasks (99f5f77).
• Improve CLI and board features:
• Add EditTasksCommand for opening task files from the CLI (5cbe8d5).
• Extend CLI commands to use the shared taskFilesRoot for all task-related operations (ee4aaf9, 60e8246).
• Add and refine the board UI (6b4fa73, 02c1616).

Menubar and board app

• Improve the menubar app:
• Use Forge tasks paths consistently for task files.
• Refine the board window, preferences, and status bar layout (87dc71e, 9f9da02).
• Fix menubar overdue count and address Calendar sendability warnings (4a51103).
• Add a dedicated board app (forge-board) backed by the same ForgeCore and ForgeUI components (6b4fa73).

Configuration and tooling

• Tidy configuration:
• Simplify project roots and improve shortcuts preferences layout (250bc69, e7f1f26).
• Update .gitignore to better match the Swift/Forge project:
• Ignore build artefacts, SwiftPM directories, and local tasks/ content as appropriate (a573c0d, 92d2ee5).
• Add small tooling and release-prep changes:
• Centralise version information.
• Provide a help URL and AppleScript usage description.
• Update the generate_icon script (7767ca9, d0b87fa, 23db3b1, a4742ff).