wakespace 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to `wakespace` are documented here. This project adheres to
+[Semantic Versioning](https://semver.org/).
+
+## 0.1.0 — 2026-06-01
+
+Initial dogfood release. Published as a CLI-only package: a tiny cross-platform
+launcher (`wakespace`) plus per-platform binary packages (`wakespace-<platform>`)
+installed automatically as optional dependencies, with the `agent-loop` execution
+layer compiled into each binary. Supported platforms: `darwin-arm64`,
+`darwin-x64`, `linux-x64`, `linux-arm64`, `linux-x64-musl`, `linux-arm64-musl`,
+`windows-x64`.
+
+### Added
+
+- Workflow definitions with staged state machines and schema-validated fields.
+- Append-only JSONL event storage with projections and chronicle inspection.
+- Project/worktree isolation and worker permission modes.
+- Wake execution over `agent-loop` workers, including AI SDK project tools
+  (`rg`, `readFile`, `writeFile`).
+- Bun CLI for creating tasks, waking workers, and inspecting state
+  (`help`, `overview`, `status`, `task`, `project`, `worker`, …).
+- `WAKESPACE_DIR` / `--dir` override for the workspace directory (default
+  `.wakespace`).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lidessen
+
+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,80 @@
+# wakespace
+
+Durable workspace layer over [`agent-loop`](../agent-loop) for agent-driven
+project development.
+
+`wakespace` is published as a CLI-only package. The `agent-loop` execution layer
+is compiled into a single self-contained binary per platform. The published
+`wakespace` package is a tiny cross-platform launcher; the actual binary ships in
+a per-platform package (`wakespace-<platform>`) installed automatically as an
+optional dependency gated by `os`/`cpu`/`libc`, so `npm install` pulls only the
+one that matches your machine.
+
+Supported platforms: `darwin-arm64`, `darwin-x64`, `linux-x64`, `linux-arm64`,
+`linux-x64-musl`, `linux-arm64-musl`, `windows-x64`.
+
+The CLI provides a headless workflow engine with:
+
+- workflow definitions with staged state machines and schema-validated fields
+- append-only JSONL event storage plus projections and chronicle inspection
+- project/worktree isolation and worker permission modes
+- wake execution over `agent-loop` workers, including AI SDK project tools
+- a Bun CLI for creating tasks, waking workers, and inspecting state
+
+## CLI
+
+```sh
+bun run --filter wakespace build:cli
+packages/wakespace/dist/wakespace help
+```
+
+After install:
+
+```sh
+wakespace help
+```
+
+The default workspace directory is `.wakespace`. Override it with
+`WAKESPACE_DIR` or the CLI `--dir` flag.
+
+Agent-facing commands default to JSON. Use `--text` for ad-hoc human text on
+commands such as `status`, `task`, `project list`, and `worker list`.
+
+For a human-readable snapshot of projects, workers, tasks, and recent activity:
+
+```sh
+wakespace overview
+```
+
+## Live Smoke
+
+```sh
+cd packages/wakespace
+DEEPSEEK_API_KEY=... bun run smoke:deepseek-tools
+```
+
+The smoke asks a real DeepSeek-backed AI SDK worker to use project tools
+(`rg`, `readFile`, and `writeFile`) and then asserts both normalized tool events
+and the filesystem side effect.
+
+## Release
+
+Releasing builds every platform binary, publishes each `wakespace-<platform>`
+package, then publishes the `wakespace` launcher last (so its optional
+dependencies already resolve). From `packages/wakespace`:
+
+```sh
+bun run release:dry   # build all platforms + npm publish --dry-run everywhere
+bun run release       # build all platforms + publish for real (needs npm auth)
+```
+
+The platform matrix lives in `scripts/build-platforms.ts`; it stamps each
+platform package with the launcher's version and fails if
+`optionalDependencies` drift out of sync. Bump the version in both
+`package.json` (version + each `optionalDependencies` entry) when cutting a
+release. The root `bun run release:check` still runs the typecheck/test/build
+gate plus a launcher dry-run.
+
+## License
+
+MIT

package/bin/wakespace

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+// Cross-platform launcher. npm installs exactly one matching `wakespace-<platform>`
+// package (gated by os/cpu/libc); this shim resolves its prebuilt binary and execs
+// it. Falls back to a locally built `dist/wakespace` for the dev workflow.
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+function detectLibc() {
+  if (process.platform !== "linux") return null;
+  // glibc exposes glibcVersionRuntime in the process report header; musl does not.
+  try {
+    return process.report?.getReport?.()?.header?.glibcVersionRuntime ? "glibc" : "musl";
+  } catch {
+    return "glibc";
+  }
+}
+
+function platformKey() {
+  const { platform, arch } = process;
+  if (platform === "win32" && arch === "x64") return "windows-x64";
+  if (platform === "darwin" && arch === "arm64") return "darwin-arm64";
+  if (platform === "darwin" && arch === "x64") return "darwin-x64";
+  if (platform === "linux" && (arch === "x64" || arch === "arm64")) {
+    const suffix = detectLibc() === "musl" ? "-musl" : "";
+    return `linux-${arch}${suffix}`;
+  }
+  return null;
+}
+
+const here = dirname(fileURLToPath(import.meta.url)); // node_modules/wakespace/bin
+const key = platformKey();
+const binName = process.platform === "win32" ? "wakespace.exe" : "wakespace";
+
+function resolveBinary() {
+  if (key) {
+    const spec = `wakespace-${key}/bin/${binName}`;
+    // Preferred: ESM resolution honours hoisting and pnpm layouts (Node >= 20.6).
+    if (typeof import.meta.resolve === "function") {
+      try {
+        const path = fileURLToPath(import.meta.resolve(spec));
+        if (existsSync(path)) return path;
+      } catch {
+        // platform package not installed — try filesystem siblings, then dev build
+      }
+    }
+    // Fallback for older Node: look beside / under this package in node_modules.
+    const candidates = [
+      join(here, "..", "..", `wakespace-${key}`, "bin", binName),
+      join(here, "..", "node_modules", `wakespace-${key}`, "bin", binName),
+    ];
+    for (const path of candidates) if (existsSync(path)) return path;
+  }
+  const local = join(here, "..", "dist", "wakespace");
+  return existsSync(local) ? local : null;
+}
+
+const binary = resolveBinary();
+if (!binary) {
+  const supported =
+    "darwin-arm64, darwin-x64, linux-x64[-musl], linux-arm64[-musl], windows-x64";
+  console.error(
+    `wakespace: no prebuilt binary for ${process.platform}/${process.arch}` +
+      (key ? ` (expected package wakespace-${key})` : " (unsupported platform)") +
+      `.\nSupported platforms: ${supported}.`,
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+process.exit(result.status ?? 0);

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "wakespace",
+  "version": "0.1.0",
+  "description": "Durable wake-loop workspace for agent-driven project development.",
+  "type": "module",
+  "bin": {
+    "wakespace": "bin/wakespace"
+  },
+  "files": [
+    "bin/wakespace",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "bun run build:cli",
+    "build:cli": "bun build src/cli.ts --compile --outfile dist/wakespace",
+    "build:platforms": "bun scripts/build-platforms.ts",
+    "release": "bun scripts/release.ts",
+    "release:dry": "bun scripts/release.ts --dry-run",
+    "prepublishOnly": "bun run typecheck && bun run test",
+    "smoke:deepseek-tools": "bun smokes/smoke-deepseek-project-tools.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "bunx --bun vitest run",
+    "test:watch": "bunx --bun vitest"
+  },
+  "keywords": [
+    "agent",
+    "ai-agent",
+    "cli",
+    "workflow",
+    "workspace",
+    "automation"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lidessen/wakespace.git",
+    "directory": "packages/wakespace"
+  },
+  "bugs": {
+    "url": "https://github.com/lidessen/wakespace/issues"
+  },
+  "homepage": "https://github.com/lidessen/wakespace/tree/main/packages/wakespace#readme",
+  "optionalDependencies": {
+    "wakespace-darwin-arm64": "0.1.0",
+    "wakespace-darwin-x64": "0.1.0",
+    "wakespace-linux-x64": "0.1.0",
+    "wakespace-linux-arm64": "0.1.0",
+    "wakespace-linux-x64-musl": "0.1.0",
+    "wakespace-linux-arm64-musl": "0.1.0",
+    "wakespace-windows-x64": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^25.9.1",
+    "agent-loop": "workspace:*",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}