Skip to content

Releases

v2.0.2

Choose a tag to compare

@M-Pineapple M-Pineapple released this 10 Nov 10:40

Fixed

  • The desk server no longer mints a new write token on every start. It reuses desk/.write-token when that file is a regular file (not a symlink) owned by the current user, mode 0600, holding exactly 64 lowercase hex characters. A missing file mints a token. A file that fails any check is never trusted: it is replaced with a fresh 0600 token and a warning goes to stderr without the token. Session cookies from before a restart keep working, so the Dock app no longer shows "Move failed" after a restart (#29).
  • dpc start_desk_server --rotate and start_desk_server rotate=true now rotate on a fresh start too, after the port bind succeeds. A rotate start that finds the port busy leaves the token file alone. Rotation stays the only way to replace a valid token.
  • A new desk directory is created with mode 0700. A desk directory that is a symlink or writable by group or others gets a stderr warning. The token file is flushed with fsync before it is renamed into place.

v2.0.1

Choose a tag to compare

@M-Pineapple M-Pineapple released this 10 Nov 03:56
7107cff

Added

  • Done cards older than 14 days are hidden on the Kanban Done column. Show archived (N) reveals them, muted. The window is DPC_ARCHIVE_DAYS or archiveDays in security-config.json (default 14). Cards are never deleted, and cards.json gains no archive field.
  • Optional note on a card for a short evidence line (a commit or a URL). Omitted from cards.json when empty. Set from add_card, update_card, and move_card. Shown on the board and matched by search_desk.

Fixed

  • Card writes from the desk page and MCP tools now hold the same flock on <knowledge base>/.dpc.lock as the dpc wrapper around the whole load, change and save, so a write landing at the same moment as another no longer drops one change. The dpc wrapper, which holds the lock while it runs this binary, passes its locked descriptor as DPC_LOCK_FD. The binary skips taking the lock only when that descriptor is the same file as .dpc.lock and a fresh handle on the file is refused the lock. The desk server always ignores the variable. A write waits up to 15 seconds for the lock without blocking a thread, then reports an error. The lock file is opened with O_NOFOLLOW and O_CLOEXEC.
  • A cards.json that exists but cannot be read or parsed now returns an error to the caller instead of quietly keeping the old board in memory. A missing cards.json is an empty board, including one removed while a long-running process holds the old board in memory.

Changed

  • get_desk_summary and get_project_status omit archived cards from lists and report an archived count. Pass includeArchived to list them. search_desk still returns archived cards and marks them. Moving a card out of done, or any edit that refreshes updated, brings it back. The Done in 7 days stat and the analytics tab are unchanged.

Fixed

  • Saving cards.json on Linux uses rename(2). FileManager.replaceItemAt fails there even when the file exists, so a second save never landed.

v2.0.0, Dev Project Coordinator

Choose a tag to compare

@cursor cursor released this 31 Oct 10:05
bdf22fe

This release renames the project from Claude Project Coordinator to Dev Project Coordinator. The old GitHub URLs redirect. From v2.0.0 the project is licensed under the Apache License 2.0. Earlier releases stay under the MIT licence.

[2.0.0] - 2026-10-31

Licence

  • Relicensed from MIT to Apache License 2.0, with a NOTICE file. Earlier releases stay under MIT.

Added

  • Multi-language detector (swift, python, javascript, typescript, node, go, rust, ruby, php, java, kotlin, csharp, dotnet, cpp, docker, web, plus spm / xcode-project / xcode-workspace / swiftui from a shallow scan)
  • Non-coding project kinds with optional path, including accounting and business
  • Analytics tab dashboard: project health gauges, 14-day activity heat map, technology trends, collapsible status timeline, shared with the MCP tools
  • Kind-aware health: non-coding projects are not penalised for missing code docs or a tech stack
  • Automatic register from working directory and git remote
  • Find-or-create, rename, and merge for non-coding work
  • Kanban cards and default columns backlog, doing, review, done, parked
  • Optional memoryRef on cards (opaque; DPC never calls a memory service)
  • get_desk_summary with an 800-token cap
  • Local Analytics + Kanban HTML page (open_desk)
  • Opt-in loopback desk server for drag-and-drop (127.0.0.1:47821, write token mode 0600, Safari Add to Dock)
  • Desk logo, favicon, and PWA manifest for a standalone Dock web app
  • Kanban cards with kind, PR, and memoryRef chips, relative time, keyboard move, and optimistic drag
  • dpc executable alias
  • DPC_KNOWLEDGE_BASE (preferred over CPC_KNOWLEDGE_BASE)
  • Grok Bot paste-in prompt and skill under docs/grok-bot/

Changed

  • Display name is Dev Project Coordinator. MCP server key stays project-coordinator
  • Log prefix is [DPC]
  • add_project no longer requires a path
  • Search is search_desk (search_code_patterns remains as an alias)
  • Security allowlist honours security-config.json and DPC_ALLOWED_PATHS
  • ~/Desktop is not an allowed root by default (only ~/Desktop/Development); add it through security-config.json or DPC_ALLOWED_PATHS if you need it
  • README and Quick Start rewritten for the product
  • Desk server uses a fixed port and a one-time sign-in code (?signin=, valid once, for 10 minutes). The bookmark URL has no token. The write token is long-lived until rotation
  • Desk subtitle: nothing leaves this machine

Fixed

  • *-analytics.json is not loaded as a project
  • KnowledgeBase templates are written only when missing
  • Swift-only fallback on add is gone
  • Quick Start no longer shows --port 3000
  • Desk server rejects an empty, duplicate, or oversized Content-Length with 400 instead of trapping
  • Desk server matches the Content-Length header name exactly (case-insensitive)
  • Desk server checks Host on every request and rejects a Host header without a port
  • Desk server Host/Origin allowlist is IPv4 loopback only (127.0.0.1 and localhost)
  • Desk token file is created 0600; path checks resolve symlinks and drop forbidden roots
  • Desk sign-in uses a single-use in-memory code. ?token= is rejected. Calling start_desk_server while running mints a new code without rotating
  • Desk responses send Referrer-Policy: no-referrer. PR chips are https-only with rel="noopener noreferrer" and target="_blank"
  • Invalid DPC_DESK_PORT logs a warning and falls back. Invalid deskPort in security-config is ignored without rewriting the file
  • The generated project-index.md is no longer tracked in git, so your private project list can't be committed by accident (#20).

Deprecated

  • CPC_KNOWLEDGE_BASE and the project-coordinator server key. Removal in v3.0

Analytics

Kanban drag

v1.4.2

Choose a tag to compare

@M-Pineapple M-Pineapple released this 15 Oct 09:48
6c0e7ed

Maintenance release.

  • CI now runs with a read-only token and pinned actions (#13). No changes to the server itself.

v1.4.1

Choose a tag to compare

@M-Pineapple M-Pineapple released this 14 Oct 20:08
6d8fd30

Documentation-only release: removes internal governance references from the repository docs. No code changes.

v1.4.0 - Official MCP SDK modernization

Choose a tag to compare

@M-Pineapple M-Pineapple released this 02 Aug 18:58
f7bdd8d

Highlights

  • Official Swift MCP SDK
  • Security allowlist fix (home directory no longer accepted)
  • Stdio-safe logging (stderr only)
  • Analytics migrate-once semantics restored
  • Real tests + GitHub Actions CI
  • README supports Claude Desktop, Cursor, and Claude Code
  • Personal analytics scrubbed from the public tree

Upgrade

git pull
swift build -c release

Point your MCP host at .build/release/project-coordinator and restart it.

Requires Swift 6.0+.

If older installs still show wrong creation dates, run ./scripts/repair-analytics-dates.sh.

Full changelog: https://github.com/M-Pineapple/Claude-Project-Coordinator/blob/main/CHANGELOG.md

v1.3.2 - Critical Analytics Fix

Choose a tag to compare

@M-Pineapple M-Pineapple released this 04 Jul 06:56

🚨 Critical Bug Fix Release

This release fixes a critical bug that caused analytics data to be re-migrated on every restart, resulting in incorrect project creation dates and loss of timeline accuracy.

What's Fixed

🐛 Analytics Re-Migration Bug (Issue #4)

  • Problem: Projects were re-migrated to analytics on every Claude Desktop restart
  • Impact: All projects showed today's date as creation date instead of actual creation date
  • Solution: Now properly checks for analytics file existence on disk before migration

📅 Date Preservation

  • Project creation dates now correctly use file system timestamps
  • Historical data is preserved during migration
  • Timeline features show accurate project ages

What's New

🔧 Repair Script

For users affected by the date corruption bug:

./scripts/repair-analytics-dates.sh

This script will:

  • Automatically detect date discrepancies
  • Create a backup of your data
  • Fix creation dates using macOS file system timestamps
  • Preserve all historical data (status changes, activity logs, etc.)

📊 Better Logging

  • Added detailed migration logs to track what's happening
  • Logs show which projects are migrated vs skipped
  • Easier to diagnose issues

Installation

New Users

Follow the standard installation instructions in the README.

Existing Users (Upgrade from v1.3.0/v1.3.1)

  1. Update your CPC installation
  2. Run the repair script if your dates are incorrect:
    cd /path/to/Claude-Project-Coordinator
    ./scripts/repair-analytics-dates.sh
  3. Restart Claude Desktop

Technical Details

The fix changes the migration logic in ProjectManager.swift to check for file existence:

let analyticsPath = \"\\(knowledgeBasePath)/projects/\\(project.name)-analytics.json\"
let fileExists = FileManager.default.fileExists(atPath: analyticsPath)

Full Changelog: https://github.com/M-Pineapple/Claude-Project-Coordinator/blob/main/CHANGELOG.md`
}

v1.3.0 - Analytics Release 📊

Choose a tag to compare

@M-Pineapple M-Pineapple released this 13 Jun 07:07

Analytics Release 📊

This major release introduces comprehensive project analytics to Claude Project Coordinator, providing automatic insights into your development workflow.

✨ Highlights

  • Time Tracking - Automatically track time in each project status
  • Activity Heat Maps - See which projects are hot 🔥
  • Technology Analysis - Understand your tech stack usage
  • Health Scoring - Identify projects needing attention

🛠️ New Commands

  • get_project_timeline - View complete status history
  • get_activity_heatmap - See project activity levels
  • get_technology_trends - Analyze framework usage
  • get_project_health - Get health reports

🚀 Quick Start

git pull
swift build -c release
# Update Claude Desktop config with executable path
# Restart Claude Desktop

Your existing projects will automatically migrate to include analytics!

📚 Documentation

See [ANALYTICS-EXAMPLES.md] https://github.com/M-Pineapple/Claude-Project-Coordinator/blob/main/ANALYTICS-EXAMPLES.md for real output examples and productive prompts.

Full changelog: https://github.com/M-Pineapple/Claude-Project-Coordinator/compare/v1.2.0...v1.3.0

v1.1.0 - Portable Installation & Bug Fixes

Choose a tag to compare

@M-Pineapple M-Pineapple released this 04 Jun 21:40
66f2ed3

🐛 Bug Fixes

This release fixes several important issues that improve installation and reliability:

Fixed

  • Portable Installation - Fixed hardcoded path issue by using relative path construction from executable location. The tool now works correctly regardless of where it's installed
  • JSON Date Decoding - Fixed error when loading existing projects by adding ISO8601 date decoding strategy
  • Build Script Arguments - Removed unnecessary port configuration from build script
  • EXAMPLE File Loading - Added exclusion for EXAMPLE files to prevent loading template files as real projects

Changed

  • Knowledge base path is now constructed relative to the executable location, making the tool truly portable
  • Project loading now properly handles date formats in existing project files
  • Build script now provides correct MCP configuration without port arguments

Technical Details

  • ProjectManager.swift: Dynamic path construction using Bundle.main.executablePath
  • ProjectManager.swift: Added decoder.dateDecodingStrategy = .iso8601 in loadProjects()
  • ProjectManager.swift: Added && !file.contains("EXAMPLE") filter
  • scripts/build.sh: Updated to use "args": [] instead of ["--port", "3000"]

📦 Installation

# Clone the repository
git clone https://github.com/M-Pineapple/Claude-Project-Coordinator.git
cd Claude-Project-Coordinator

# Build the project
./scripts/build.sh

Initial Alpha Release - MCP for Xcode/Swift Projects

Choose a tag to compare

@M-Pineapple M-Pineapple released this 02 Jun 06:40

🍍 Claude Project Coordinator v0.1.0-alpha

Initial alpha release of the Swift-based MCP server for managing Xcode projects.

✨ Features

  • Track multiple Xcode projects
  • Search code patterns across projects
  • Maintain development knowledge base
  • Auto-detect Swift/SwiftUI patterns

📦 Installation

git clone https://github.com/M-Pineapple/Claude-Project-Coordinator
cd Claude-Project-Coordinator
./scripts/build.sh