wordspace 0.0.1 → 0.0.2

package/dist/index.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+import { init } from "./commands/init.js";
+import * as log from "./lib/log.js";
+const VERSION = "0.1.0";
+const HELP = `
+Usage: wordspace <command> [options]
+
+Commands:
+  init          Bootstrap a new wordspace project
+
+Options:
+  --force       Re-run all steps even if already completed
+  --help        Show this help message
+  --version     Show version number
+`.trim();
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    if (args.includes("--version") || args.includes("-v")) {
+        console.log(VERSION);
+        process.exit(0);
+    }
+    const command = args.find((a) => !a.startsWith("-"));
+    const force = args.includes("--force");
+    if (command === "init") {
+        await init(force);
+    }
+    else if (!command) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    else {
+        log.error(`Unknown command: ${command}`);
+        console.log(HELP);
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    log.error(err.message);
+    process.exit(1);
+});

package/package.json

@@ -1,12 +1,18 @@
 {
   "name": "wordspace",
-  "version": "0.0.1",
-  "module": "index.ts",
+  "version": "0.0.2",
   "type": "module",
-  "devDependencies": {
-    "@types/bun": "latest"
+  "bin": {
+    "wordspace": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc"
   },
-  "peerDependencies": {
-    "typescript": "^5"
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "typescript": "^5",
+    "@types/node": "^22"
   }
 }

package/src/commands/init.ts

@@ -0,0 +1,48 @@
+import { checkSkills } from "../steps/check-skills.js";
+import { installSkills } from "../steps/install-skills.js";
+import { fetchWorkflows } from "../steps/fetch-workflows.js";
+import { createSymlinks } from "../steps/create-symlinks.js";
+import { setupClaude } from "../steps/setup-claude.js";
+import { createDirs } from "../steps/create-dirs.js";
+import * as log from "../lib/log.js";
+
+export async function init(force: boolean) {
+  const cwd = process.cwd();
+
+  log.banner();
+
+  // Step 1: Check skills
+  log.step("1/6 Skills");
+  const hasSkills = checkSkills(cwd);
+  if (hasSkills && !force) {
+    log.skip("All skills already installed");
+  } else {
+    installSkills(cwd);
+  }
+
+  // Step 2: Fetch workflows
+  log.step("2/6 Workflows");
+  await fetchWorkflows(cwd, force);
+
+  // Step 3: Create symlinks
+  log.step("3/6 Symlinks");
+  createSymlinks(cwd, force);
+
+  // Step 4: Setup Claude settings
+  log.step("4/6 Claude settings");
+  setupClaude(cwd);
+
+  // Step 5: Create directories
+  log.step("5/6 Directories");
+  createDirs(cwd);
+
+  // Step 6: Done
+  log.step("6/6 Done");
+  console.log(`
+Your project is ready. Next steps:
+
+  1. Open this directory in your editor
+  2. Start Claude Code:  claude
+  3. Run a workflow:     prose run workflows/<name>.prose
+`);
+}

package/src/index.ts

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+
+import { init } from "./commands/init.js";
+import * as log from "./lib/log.js";
+
+const VERSION = "0.1.0";
+
+const HELP = `
+Usage: wordspace <command> [options]
+
+Commands:
+  init          Bootstrap a new wordspace project
+
+Options:
+  --force       Re-run all steps even if already completed
+  --help        Show this help message
+  --version     Show version number
+`.trim();
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(HELP);
+    process.exit(0);
+  }
+
+  if (args.includes("--version") || args.includes("-v")) {
+    console.log(VERSION);
+    process.exit(0);
+  }
+
+  const command = args.find((a) => !a.startsWith("-"));
+  const force = args.includes("--force");
+
+  if (command === "init") {
+    await init(force);
+  } else if (!command) {
+    console.log(HELP);
+    process.exit(0);
+  } else {
+    log.error(`Unknown command: ${command}`);
+    console.log(HELP);
+    process.exit(1);
+  }
+}
+
+main().catch((err: Error) => {
+  log.error(err.message);
+  process.exit(1);
+});

package/src/lib/exec.ts

@@ -0,0 +1,30 @@
+import { execSync } from "node:child_process";
+import * as log from "./log.js";
+
+export interface ExecOptions {
+  cwd?: string;
+  timeout?: number;
+  silent?: boolean;
+}
+
+export function exec(
+  cmd: string,
+  opts: ExecOptions = {},
+): string {
+  const { cwd = process.cwd(), timeout = 60_000, silent = false } = opts;
+  try {
+    const result = execSync(cmd, {
+      cwd,
+      timeout,
+      stdio: silent ? "pipe" : ["pipe", "pipe", "pipe"],
+      encoding: "utf-8",
+    });
+    return result.trim();
+  } catch (err: unknown) {
+    const e = err as { stderr?: string; message?: string };
+    const msg = e.stderr?.trim() || e.message || "Command failed";
+    log.error(`Command failed: ${cmd}`);
+    log.error(msg);
+    throw new Error(`exec failed: ${cmd}`);
+  }
+}

package/src/lib/log.ts

@@ -0,0 +1,38 @@
+const noColor = !!process.env["NO_COLOR"];
+
+const code = (n: number) => (noColor ? "" : `\x1b[${n}m`);
+const reset = code(0);
+const bold = code(1);
+const dim = code(2);
+const green = code(32);
+const yellow = code(33);
+const red = code(31);
+const cyan = code(36);
+
+export function info(msg: string) {
+  console.log(`${cyan}i${reset} ${msg}`);
+}
+
+export function success(msg: string) {
+  console.log(`${green}✓${reset} ${msg}`);
+}
+
+export function warn(msg: string) {
+  console.log(`${yellow}!${reset} ${msg}`);
+}
+
+export function error(msg: string) {
+  console.error(`${red}✗${reset} ${msg}`);
+}
+
+export function step(msg: string) {
+  console.log(`\n${bold}${msg}${reset}`);
+}
+
+export function skip(msg: string) {
+  console.log(`${dim}–${reset} ${dim}${msg}${reset}`);
+}
+
+export function banner() {
+  console.log(`\n${bold}wordspace init${reset}\n`);
+}

package/src/steps/check-skills.ts

@@ -0,0 +1,11 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+
+const SKILLS = ["open-prose", "agentwallet", "registry", "websh"] as const;
+
+export function checkSkills(cwd: string): boolean {
+  const base = join(cwd, ".agents", "skills");
+  return SKILLS.every((s) => existsSync(join(base, s)));
+}
+
+export { SKILLS };

package/src/steps/create-dirs.ts

@@ -0,0 +1,8 @@
+import { mkdirSync } from "node:fs";
+import { join } from "node:path";
+import * as log from "../lib/log.js";
+
+export function createDirs(cwd: string) {
+  mkdirSync(join(cwd, "output"), { recursive: true });
+  log.success("Created output/ directory");
+}

package/src/steps/create-symlinks.ts

@@ -0,0 +1,39 @@
+import {
+  mkdirSync,
+  symlinkSync,
+  readlinkSync,
+  lstatSync,
+  unlinkSync,
+} from "node:fs";
+import { join } from "node:path";
+import { SKILLS } from "./check-skills.js";
+import * as log from "../lib/log.js";
+
+export function createSymlinks(cwd: string, force: boolean) {
+  const skillsDir = join(cwd, "skills");
+  mkdirSync(skillsDir, { recursive: true });
+
+  for (const skill of SKILLS) {
+    const linkPath = join(skillsDir, skill);
+    const target = join("..", ".agents", "skills", skill);
+
+    // Check if symlink already exists and points to the right target
+    try {
+      const stat = lstatSync(linkPath);
+      if (stat.isSymbolicLink()) {
+        const existing = readlinkSync(linkPath);
+        if (existing === target && !force) {
+          log.skip(`skills/${skill} (exists)`);
+          continue;
+        }
+        // Remove stale or forced symlink
+        unlinkSync(linkPath);
+      }
+    } catch {
+      // Does not exist — will create
+    }
+
+    symlinkSync(target, linkPath);
+    log.success(`skills/${skill} -> ${target}`);
+  }
+}

package/src/steps/fetch-workflows.ts

@@ -0,0 +1,92 @@
+import { get as httpsGet } from "node:https";
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import * as log from "../lib/log.js";
+
+const CONTENTS_URL =
+  "https://api.github.com/repos/frames-engineering/wordspace-demos/contents/workflows";
+
+interface GitHubEntry {
+  name: string;
+  download_url: string;
+}
+
+function httpGet(url: string, headers: Record<string, string> = {}): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const allHeaders: Record<string, string> = {
+      "User-Agent": "wordspace-cli",
+      ...headers,
+    };
+    httpsGet(url, { headers: allHeaders }, (res) => {
+      // Follow redirects
+      if ((res.statusCode === 301 || res.statusCode === 302) && res.headers.location) {
+        httpGet(res.headers.location, headers).then(resolve, reject);
+        return;
+      }
+      if (res.statusCode !== 200) {
+        reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+        return;
+      }
+      let data = "";
+      res.on("data", (chunk: Buffer) => (data += chunk.toString()));
+      res.on("end", () => resolve(data));
+      res.on("error", reject);
+    }).on("error", reject);
+  });
+}
+
+function getAuthHeaders(): Record<string, string> {
+  const token = process.env["GITHUB_TOKEN"] || process.env["GH_TOKEN"];
+  if (token) {
+    return { Authorization: `Bearer ${token}` };
+  }
+  return {};
+}
+
+export async function fetchWorkflows(cwd: string, force: boolean) {
+  const workflowsDir = join(cwd, "workflows");
+  mkdirSync(workflowsDir, { recursive: true });
+
+  const headers = getAuthHeaders();
+
+  let entries: GitHubEntry[];
+  try {
+    const body = await httpGet(CONTENTS_URL, headers);
+    entries = JSON.parse(body) as GitHubEntry[];
+  } catch (err) {
+    log.warn(
+      `Could not fetch workflow list from GitHub: ${(err as Error).message}`,
+    );
+    log.warn("Skipping workflow download (skills are the critical part).");
+    return;
+  }
+
+  const proseFiles = entries.filter((e) => e.name.endsWith(".prose"));
+  if (proseFiles.length === 0) {
+    log.warn("No .prose files found in workflows/");
+    return;
+  }
+
+  let downloaded = 0;
+  for (const file of proseFiles) {
+    const dest = join(workflowsDir, file.name);
+    if (existsSync(dest) && !force) {
+      log.skip(`${file.name} (exists)`);
+      continue;
+    }
+    try {
+      const content = await httpGet(file.download_url, headers);
+      writeFileSync(dest, content, "utf-8");
+      log.success(file.name);
+      downloaded++;
+    } catch (err) {
+      log.warn(`Failed to download ${file.name}: ${(err as Error).message}`);
+    }
+  }
+
+  if (downloaded > 0) {
+    log.success(`Downloaded ${downloaded} workflow(s) to workflows/`);
+  } else {
+    log.skip("All workflows already present");
+  }
+}

package/src/steps/install-skills.ts

@@ -0,0 +1,11 @@
+import { exec } from "../lib/exec.js";
+import * as log from "../lib/log.js";
+
+export function installSkills(cwd: string) {
+  log.info("Installing skills via npx skills add...");
+  exec("npx -y skills add frames-engineering/skills -y", {
+    cwd,
+    timeout: 120_000,
+  });
+  log.success("Skills installed to .agents/skills/");
+}

package/src/steps/setup-claude.ts

@@ -0,0 +1,61 @@
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import * as log from "../lib/log.js";
+
+const BASE_PERMISSIONS = [
+  "Bash(curl:*)",
+  "Bash(python3:*)",
+  "WebFetch(domain:registry.mcpay.tech)",
+  "WebFetch(domain:frames.ag)",
+  "WebSearch",
+];
+
+interface ClaudeSettings {
+  permissions?: {
+    allow?: string[];
+    [key: string]: unknown;
+  };
+  [key: string]: unknown;
+}
+
+export function setupClaude(cwd: string) {
+  const claudeDir = join(cwd, ".claude");
+  mkdirSync(claudeDir, { recursive: true });
+
+  const settingsPath = join(claudeDir, "settings.local.json");
+
+  let settings: ClaudeSettings = {};
+  if (existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(readFileSync(settingsPath, "utf-8"));
+    } catch {
+      log.warn("Could not parse existing settings.local.json, creating fresh");
+      settings = {};
+    }
+  }
+
+  if (!settings.permissions) {
+    settings.permissions = {};
+  }
+  if (!Array.isArray(settings.permissions.allow)) {
+    settings.permissions.allow = [];
+  }
+
+  // Merge base permissions (deduplicate)
+  const existing = new Set(settings.permissions.allow);
+  let added = 0;
+  for (const perm of BASE_PERMISSIONS) {
+    if (!existing.has(perm)) {
+      settings.permissions.allow.push(perm);
+      added++;
+    }
+  }
+
+  writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+
+  if (added > 0) {
+    log.success(`Added ${added} permission(s) to .claude/settings.local.json`);
+  } else {
+    log.skip("All base permissions already present");
+  }
+}

package/tsconfig.json

@@ -1,29 +1,18 @@
 {
   "compilerOptions": {
-    // Environment setup & latest features
-    "lib": ["ESNext"],
-    "target": "ESNext",
-    "module": "Preserve",
-    "moduleDetection": "force",
-    "jsx": "react-jsx",
-    "allowJs": true,
-
-    // Bundler mode
+    "target": "ES2022",
+    "module": "ESNext",
     "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-
-    // Best practices
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
     "strict": true,
+    "esModuleInterop": true,
     "skipLibCheck": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-
-    // Some stricter flags (disabled by default)
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false
-  }
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true
+  },
+  "include": ["src"],
+  "exclude": ["dist", "node_modules"]
 }

package/CLAUDE.md

@@ -1,111 +0,0 @@
----
-description: Use Bun instead of Node.js, npm, pnpm, or vite.
-globs: "*.ts, *.tsx, *.html, *.css, *.js, *.jsx, package.json"
-alwaysApply: false
----
-
-Default to using Bun instead of Node.js.
-
-- Use `bun <file>` instead of `node <file>` or `ts-node <file>`
-- Use `bun test` instead of `jest` or `vitest`
-- Use `bun build <file.html|file.ts|file.css>` instead of `webpack` or `esbuild`
-- Use `bun install` instead of `npm install` or `yarn install` or `pnpm install`
-- Use `bun run <script>` instead of `npm run <script>` or `yarn run <script>` or `pnpm run <script>`
-- Bun automatically loads .env, so don't use dotenv.
-
-## APIs
-
-- `Bun.serve()` supports WebSockets, HTTPS, and routes. Don't use `express`.
-- `bun:sqlite` for SQLite. Don't use `better-sqlite3`.
-- `Bun.redis` for Redis. Don't use `ioredis`.
-- `Bun.sql` for Postgres. Don't use `pg` or `postgres.js`.
-- `WebSocket` is built-in. Don't use `ws`.
-- Prefer `Bun.file` over `node:fs`'s readFile/writeFile
-- Bun.$`ls` instead of execa.
-
-## Testing
-
-Use `bun test` to run tests.
-
-```ts#index.test.ts
-import { test, expect } from "bun:test";
-
-test("hello world", () => {
-  expect(1).toBe(1);
-});
-```
-
-## Frontend
-
-Use HTML imports with `Bun.serve()`. Don't use `vite`. HTML imports fully support React, CSS, Tailwind.
-
-Server:
-
-```ts#index.ts
-import index from "./index.html"
-
-Bun.serve({
-  routes: {
-    "/": index,
-    "/api/users/:id": {
-      GET: (req) => {
-        return new Response(JSON.stringify({ id: req.params.id }));
-      },
-    },
-  },
-  // optional websocket support
-  websocket: {
-    open: (ws) => {
-      ws.send("Hello, world!");
-    },
-    message: (ws, message) => {
-      ws.send(message);
-    },
-    close: (ws) => {
-      // handle close
-    }
-  },
-  development: {
-    hmr: true,
-    console: true,
-  }
-})
-```
-
-HTML files can import .tsx, .jsx or .js files directly and Bun's bundler will transpile & bundle automatically. `<link>` tags can point to stylesheets and Bun's CSS bundler will bundle.
-
-```html#index.html
-<html>
-  <body>
-    <h1>Hello, world!</h1>
-    <script type="module" src="./frontend.tsx"></script>
-  </body>
-</html>
-```
-
-With the following `frontend.tsx`:
-
-```tsx#frontend.tsx
-import React from "react";
-
-// import .css files directly and it works
-import './index.css';
-
-import { createRoot } from "react-dom/client";
-
-const root = createRoot(document.body);
-
-export default function Frontend() {
-  return <h1>Hello, world!</h1>;
-}
-
-root.render(<Frontend />);
-```
-
-Then, run index.ts
-
-```sh
-bun --hot ./index.ts
-```
-
-For more information, read the Bun API docs in `node_modules/bun-types/docs/**.md`.

package/README.md

@@ -1,15 +0,0 @@
-# wordspace
-
-To install dependencies:
-
-```bash
-bun install
-```
-
-To run:
-
-```bash
-bun run index.ts
-```
-
-This project was created using `bun init` in bun v1.2.21. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/bun.lock

@@ -1,25 +0,0 @@
-{
-  "lockfileVersion": 1,
-  "workspaces": {
-    "": {
-      "name": "wordspace",
-      "devDependencies": {
-        "@types/bun": "latest",
-      },
-      "peerDependencies": {
-        "typescript": "^5",
-      },
-    },
-  },
-  "packages": {
-    "@types/bun": ["@types/bun@1.3.9", "", { "dependencies": { "bun-types": "1.3.9" } }, "sha512-KQ571yULOdWJiMH+RIWIOZ7B2RXQGpL1YQrBtLIV3FqDcCu6FsbFUBwhdKUlCKUpS3PJDsHlJ1QKlpxoVR+xtw=="],
-
-    "@types/node": ["@types/node@25.2.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-m0jEgYlYz+mDJZ2+F4v8D1AyQb+QzsNqRuI7xg1VQX/KlKS0qT9r1Mo16yo5F/MtifXFgaofIFsdFMox2SxIbQ=="],
-
-    "bun-types": ["bun-types@1.3.9", "", { "dependencies": { "@types/node": "*" } }, "sha512-+UBWWOakIP4Tswh0Bt0QD0alpTY8cb5hvgiYeWCMet9YukHbzuruIEeXC2D7nMJPB12kbh8C7XJykSexEqGKJg=="],
-
-    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
-
-    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
-  }
-}

package/index.ts

@@ -1 +0,0 @@
-console.log("Hello via Bun!");