tuhdoo 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Brandon Bews
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,25 @@
+# tuhdoo
+
+A coordination fabric for agent fleets, steered by humans: a shared backlog,
+work queue, and activity ledger living in a git orphan branch inside the repo
+it plans. Synced through an ordinary git remote — no server, no vendor, no
+accounts.
+
+This package is a thin launcher: the real tuhdoo is a single static Go
+binary, installed for your platform via one of the `@tuhdoo/*`
+optionalDependencies. Installing as a devDependency pins the binary per
+project through your lockfile.
+
+```sh
+npm i -D tuhdoo
+npx tuhdoo init      # inside the repository you want to plan
+npx tuhdoo status
+```
+
+Agents connect through the stdio MCP shim:
+
+```json
+{ "mcpServers": { "tuhdoo": { "command": "npx", "args": ["tuhdoo", "mcp"] } } }
+```
+
+Docs, design record, and source: <https://github.com/brandonbews/tuhdoo>

package/bin/tuhdoo.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+'use strict';
+// Dumb launcher for the real tuhdoo binary, which ships in a per-platform
+// npm package (@tuhdoo/<os>-<cpu>) selected by npm via os/cpu fields on
+// optionalDependencies. This file must stay dependency-free and add
+// nothing to stdout/stderr on the happy path: the MCP stdio shim
+// (`tuhdoo mcp`) runs through it, and any stray byte corrupts JSON-RPC.
+
+const { spawn } = require('child_process');
+
+const PACKAGES = {
+  'darwin-arm64': '@tuhdoo/darwin-arm64',
+  'darwin-x64': '@tuhdoo/darwin-x64',
+  'linux-arm64': '@tuhdoo/linux-arm64',
+  'linux-x64': '@tuhdoo/linux-x64',
+};
+
+const key = process.platform + '-' + process.arch;
+const pkg = PACKAGES[key];
+if (!pkg) {
+  console.error(
+    'tuhdoo: unsupported platform ' + key +
+    ' (supported: ' + Object.keys(PACKAGES).join(', ') + ')'
+  );
+  process.exit(1);
+}
+
+let bin;
+try {
+  bin = require.resolve(pkg + '/bin/tuhdoo');
+} catch (_) {
+  console.error(
+    'tuhdoo: platform package ' + pkg + ' is not installed.\n' +
+    'It is an optionalDependency of tuhdoo; reinstall without ' +
+    '--no-optional / --omit=optional.'
+  );
+  process.exit(1);
+}
+
+const child = spawn(bin, process.argv.slice(2), { stdio: 'inherit' });
+
+// Forward termination signals; harnesses SIGTERM this pid, not the child.
+const SIGNALS = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+for (const sig of SIGNALS) {
+  process.on(sig, () => child.kill(sig));
+}
+
+child.on('error', (err) => {
+  console.error('tuhdoo: failed to launch ' + bin + ': ' + err.message);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    // Die by the same signal so our caller sees the child's true fate.
+    // Drop our forwarding handler first or the re-raise loops forever.
+    process.removeAllListeners(signal);
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code === null ? 1 : code);
+  }
+});

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "tuhdoo",
+  "version": "0.1.0",
+  "description": "A coordination fabric for agent fleets, steered by humans: a shared backlog, work queue, and activity ledger living in a git orphan branch inside the repo it plans.",
+  "keywords": [
+    "agents",
+    "backlog",
+    "mcp",
+    "git",
+    "coordination"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brandonbews/tuhdoo.git"
+  },
+  "bin": {
+    "tuhdoo": "bin/tuhdoo.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "optionalDependencies": {
+    "@tuhdoo/darwin-arm64": "0.1.0",
+    "@tuhdoo/darwin-x64": "0.1.0",
+    "@tuhdoo/linux-arm64": "0.1.0",
+    "@tuhdoo/linux-x64": "0.1.0"
+  }
+}