Add dart_node_mcp package and Too Many Cooks MCP example (#12)

TLDR;

New dart_node_mcp package + "Too Many Cooks" MCP server example with VSCode extension.

What Does This Do?

dart_node_mcp: Dart package for building MCP servers on Node.js
too_many_cooks: MCP server for multi-agent coordination (file locks, messaging, plans)
too_many_cooks_vscode_extension: VSCode extension showing real-time agent activity
dart_node_better_sqlite3: An sqlite wrapper used by too many cooks
Brief Details?

dart_node_mcp provides typed MCP server implementation with stdio transport.

Too Many Cooks demonstrates the package with an agent coordination server featuring:

Agent registration
File locking with expiry
Inter-agent messaging
Plan sharing
Real-time notifications via SSE
How Do The Tests Prove The Change Works?

packages/dart_node_mcp/test/ - MCP server, transport, types, callbacks tests
examples/too_many_cooks/test/ - DB, integration, types tests

Author: MelbourneDeveloper

.gitignore

@@ -4,6 +4,8 @@ node_modules/
 !tools/build/
 .dart_tool/
 
+coverage/
+
 # Generated JS files from dart compile js
 *.js.deps
 *.js.map
@@ -16,3 +18,19 @@ website/src/api/
 website/.dart-doc-temp/
 
 examples/frontend/coverage/
+
+*.mjs
+
+examples/too_many_cooks_vscode_extension/.vscode-test/user-data/
+
+examples/too_many_cooks_vscode_extension/.vscode-test/vscode-darwin-arm64-1.106.3/
+
+*.db
+
+*.db-shm
+
+*.db-wal
+
+*.vsix
+
+examples/too_many_cooks_vscode_extension/.vscode-test/

AGENTS.md

@@ -2,40 +2,39 @@
 
 This is a project for Dart packages to be consumed on Node for building node-based apps with the Dart
 
+MANDATORY: TOO MANY COOKS
+ - check your messages regularly
+ - lock files with too many cooks before editing, and unlock afterwards
+ - do not edit files that others have locked up
+ - always signal your intent to other agents
+ - If you are coordinator, keep delegating until the grande scheme has been achieved
+ - If you are not coordinator, don't stop and keep asking for something to do
+ - Routinely clean up expired locks
+ - If you find yourself with nothing to do, check someone else's plan and help them
+
 # Rules
 - All Dart. Absolutely minimal JS
+- Use async/await. Do not use `.then`
 - NO DUPLICATION. Move files, code elements instead of copying them. Search for elements before adding them. HIGHEST PRIORITY. PRIORITIZE THIS OVER ALL ELSE!!
-- Return Result<T,E> from the nadz library for any function that could throw an exception <- CRITICAL!!!
+- Prefer typedef records with named fields instead of classes for data (structural typing). This mimics Typescript better
+- Return Result<T,E> from the nadz library for any function that could throw an exception. NO THROWING EXCEPTIONS.
+- Don't make consecutive log calls. Use string interpolation
+- Avoid casting!!! [! `as` `late`] are all ILLEGAL!!! U
+- Use pattern matching switch expressions or ternaries. The exceptional case is if inside arrays and maps because these are declarative and not imperaative.
 - All packages MUST have austerity installed for linting and nadz for Result<T,E> types
-- Fix ALL lint errors
-- Do not expose raw JS objects like JSAny to the higher levels. The library packages are supposed to put a TYPED layer over these
-- NO GLOBAL STATE
-- Casting, ! etc are all ILLEGAL!!!
-- Move non-example-specific code to the framework packages
+- Do not expose `JSObject` or `JSAny` etc in the public APIs. Put types over everything. The library packages are supposed to put a TYPED layer over these
+- No global state
 - No skipping tests EVER!!! Agressively unskip tests when you find them!!
 - Failing tests = OK. Removing assertions or tests = ILLEGAL!!
-- NO THROWING EXCEPTIONS. Return results. Handle errors with Result types, except for cases where the code is a placeholder.
-- NO PLACEHOLDERS!!! If you HAVE TO leave a section blank, fail LOUDLY by throwing an exception.
-- Tests must FAIL HARD. Don't add allowances and print warnings. Just FAIL!
+- NO PLACEHOLDERS!!! If you HAVE TO leave a section blank, fail LOUDLY by throwing an exception. This is the only time exceptions are allowed. Tests must FAIL HARD. Don't add allowances and print warnings. Just FAIL!
 - Keep functions under 20 lines long and files under 500 loc
-- NEVER use the late keyword
 - Do not use Git commands unless explicitly requested
-- Don't use if statements. Use pattern matching or ternaries instead. The exceptional case is if inside arrays and maps because these are declarative and not imperaative.
 
 ## Build & Run Commands
 
 ```bash
-# Build express_server example (compiles Dart to Node-compatible JS)
-dart run tools/build/build.dart express_server
-
-# Run the compiled server
-node examples/express_server/build/server.js
-
-# Install Node dependencies for express example
-cd examples/express_server && npm install
-
-# Run tests for express example
-cd examples/express_server && dart test
+// Build everything
+sh run_dev.sh
 ```
 
 Critical documentation URLs for the Dart JS Framework project.
@@ -72,7 +71,7 @@ Critical documentation URLs for the Dart JS Framework project.
 | Express 4.x API Reference | https://expressjs.com/en/4x/api.html |
 | Express DevDocs (offline) | https://devdocs.io/express/ |
 
-## React (Phase 2 - Web Frontend)
+## React
 
 | Topic | URL |
 |-------|-----|
@@ -81,7 +80,7 @@ Critical documentation URLs for the Dart JS Framework project.
 | Hooks API Reference | https://legacy.reactjs.org/docs/hooks-reference.html |
 | React DevDocs (offline) | https://devdocs.io/react/ |
 
-## React Native / Expo (Phase 3 - Mobile)
+## React Native / Expo
 
 | Topic | URL |
 |-------|-----|
@@ -102,10 +101,7 @@ Critical documentation URLs for the Dart JS Framework project.
 - React 18 docs at `18.react.dev` are canonical
 - Expo SDK releases 3x/year, targets specific React Native versions
 
-## Architecture
-
-- 
 
 ## Testing
 
-Tests in `examples/express_server/test/` use the standard `package:test`. The test spawns the Node server process and makes HTTP requests against it. The server must be built before running tests.
+All projects MUST have tests. Where the package is a UI project, the tests MUST test the UI interactions and avoid unit testing. Tests are Dart only. No Javascript unless it's necessary to test the underlying interop.

CLAUDE.md

@@ -2,12 +2,23 @@
 
 This is a project for Dart packages to be consumed on Node for building node-based apps with the Dart
 
+MANDATORY: TOO MANY COOKS
+ - check your messages regularly
+ - lock files with too many cooks before editing, and unlock afterwards
+ - do not edit files that others have locked up
+ - always signal your intent to other agents
+ - If you are coordinator, keep delegating until the grande scheme has been achieved
+ - If you are not coordinator, don't stop and keep asking for something to do
+ - Routinely clean up expired locks
+ - If you find yourself with nothing to do, check someone else's plan and help them
+
 # Rules
 - All Dart. Absolutely minimal JS
 - Use async/await. Do not use `.then`
 - NO DUPLICATION. Move files, code elements instead of copying them. Search for elements before adding them. HIGHEST PRIORITY. PRIORITIZE THIS OVER ALL ELSE!!
 - Prefer typedef records with named fields instead of classes for data (structural typing). This mimics Typescript better
 - Return Result<T,E> from the nadz library for any function that could throw an exception. NO THROWING EXCEPTIONS.
+- Don't make consecutive log calls. Use string interpolation
 - Avoid casting!!! [! `as` `late`] are all ILLEGAL!!! U
 - Use pattern matching switch expressions or ternaries. The exceptional case is if inside arrays and maps because these are declarative and not imperaative.
 - All packages MUST have austerity installed for linting and nadz for Result<T,E> types

examples/backend/dart_test.yaml

@@ -0,0 +1 @@
+platforms: [vm]

examples/frontend/pubspec.lock

@@ -90,7 +90,7 @@ packages:
     source: hosted
     version: "3.0.7"
   dart_node_core:
-    dependency: transitive
+    dependency: "direct main"
     description:
       path: "../../packages/dart_node_core"
       relative: true

examples/frontend/pubspec.yaml

@@ -8,6 +8,8 @@ environment:
 
 dependencies:
   austerity: ^1.3.0
+  dart_node_core:
+    path: ../../packages/dart_node_core
   dart_node_react:
     path: ../../packages/dart_node_react
   nadz: ^0.0.7-beta

examples/mobile/lib/screens/task_list_screen.dart

@@ -5,7 +5,6 @@ import 'package:dart_node_react/dart_node_react.dart' hide view;
 import 'package:dart_node_react_native/dart_node_react_native.dart';
 import 'package:nadz/nadz.dart';
 import 'package:shared/http/http_client.dart';
-import 'package:shared/js_types/js_types.dart';
 import 'package:shared/theme/theme.dart';
 
 import '../types.dart';

examples/too_many_cooks/.gitignore

@@ -0,0 +1,4 @@
+*.db
+*.db-shm
+*.db-wal
+*.js

examples/too_many_cooks/.npmignore

@@ -0,0 +1,30 @@
+# Source files
+lib/
+bin/
+test/
+
+# Dart files
+pubspec.yaml
+pubspec.lock
+analysis_options.yaml
+dart_test.yaml
+.dart_tool/
+.packages
+
+# Build artifacts (except server_node.js)
+build/bin/*.js
+!build/bin/server_node.js
+build/test/
+
+# Development files
+*.sh
+*.db
+.too_many_cooks/
+
+# IDE
+.idea/
+.vscode/
+
+# Node
+node_modules/
+package-lock.json

examples/too_many_cooks/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.2.0
+
+### Fixed
+- Added missing shebang (`#!/usr/bin/env node`) to executable - fixes npm binary execution failure
+- Added missing `@modelcontextprotocol/sdk` dependency
+
+## 0.1.0
+
+- Initial release
+- File locking for multi-agent coordination
+- Agent registration with API keys
+- Inter-agent messaging with broadcast support
+- Plan visibility (goals and current tasks)
+- Real-time status overview
+- SQLite persistence at `~/.too_many_cooks/data.db`