wordspace 0.0.1 → 0.0.3

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function init(force: boolean): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,41 @@
+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) {
+    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/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

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.0.3";
+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/dist/lib/exec.d.ts

@@ -0,0 +1,6 @@
+export interface ExecOptions {
+    cwd?: string;
+    timeout?: number;
+    silent?: boolean;
+}
+export declare function exec(cmd: string, opts?: ExecOptions): string;

package/dist/lib/exec.js

@@ -0,0 +1,21 @@
+import { execSync } from "node:child_process";
+import * as log from "./log.js";
+export function exec(cmd, opts = {}) {
+    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) {
+        const e = err;
+        const msg = e.stderr?.trim() || e.message || "Command failed";
+        log.error(`Command failed: ${cmd}`);
+        log.error(msg);
+        throw new Error(`exec failed: ${cmd}`);
+    }
+}

package/dist/lib/log.d.ts

@@ -0,0 +1,7 @@
+export declare function info(msg: string): void;
+export declare function success(msg: string): void;
+export declare function warn(msg: string): void;
+export declare function error(msg: string): void;
+export declare function step(msg: string): void;
+export declare function skip(msg: string): void;
+export declare function banner(): void;

package/dist/lib/log.js

@@ -0,0 +1,30 @@
+const noColor = !!process.env["NO_COLOR"];
+const code = (n) => (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) {
+    console.log(`${cyan}i${reset} ${msg}`);
+}
+export function success(msg) {
+    console.log(`${green}✓${reset} ${msg}`);
+}
+export function warn(msg) {
+    console.log(`${yellow}!${reset} ${msg}`);
+}
+export function error(msg) {
+    console.error(`${red}✗${reset} ${msg}`);
+}
+export function step(msg) {
+    console.log(`\n${bold}${msg}${reset}`);
+}
+export function skip(msg) {
+    console.log(`${dim}–${reset} ${dim}${msg}${reset}`);
+}
+export function banner() {
+    console.log(`\n${bold}wordspace init${reset}\n`);
+}

package/dist/steps/check-skills.d.ts

@@ -0,0 +1,3 @@
+declare const SKILLS: readonly ["open-prose", "agentwallet", "registry", "websh"];
+export declare function checkSkills(cwd: string): boolean;
+export { SKILLS };

package/dist/steps/check-skills.js

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

package/dist/steps/create-dirs.d.ts

@@ -0,0 +1 @@
+export declare function createDirs(cwd: string): void;

package/dist/steps/create-dirs.js

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

package/dist/steps/create-symlinks.d.ts

@@ -0,0 +1 @@
+export declare function createSymlinks(cwd: string, force: boolean): void;

package/dist/steps/create-symlinks.js

@@ -0,0 +1,30 @@
+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, force) {
+    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/dist/steps/fetch-workflows.d.ts

@@ -0,0 +1 @@
+export declare function fetchWorkflows(cwd: string, force: boolean): Promise<void>;

package/dist/steps/fetch-workflows.js

@@ -0,0 +1,78 @@
+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";
+function httpGet(url, headers = {}) {
+    return new Promise((resolve, reject) => {
+        const allHeaders = {
+            "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) => (data += chunk.toString()));
+            res.on("end", () => resolve(data));
+            res.on("error", reject);
+        }).on("error", reject);
+    });
+}
+function getAuthHeaders() {
+    const token = process.env["GITHUB_TOKEN"] || process.env["GH_TOKEN"];
+    if (token) {
+        return { Authorization: `Bearer ${token}` };
+    }
+    return {};
+}
+export async function fetchWorkflows(cwd, force) {
+    const workflowsDir = join(cwd, "workflows");
+    mkdirSync(workflowsDir, { recursive: true });
+    const headers = getAuthHeaders();
+    let entries;
+    try {
+        const body = await httpGet(CONTENTS_URL, headers);
+        entries = JSON.parse(body);
+    }
+    catch (err) {
+        log.warn(`Could not fetch workflow list from GitHub: ${err.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.message}`);
+        }
+    }
+    if (downloaded > 0) {
+        log.success(`Downloaded ${downloaded} workflow(s) to workflows/`);
+    }
+    else {
+        log.skip("All workflows already present");
+    }
+}

package/dist/steps/install-skills.d.ts

@@ -0,0 +1 @@
+export declare function installSkills(cwd: string): void;

package/dist/steps/install-skills.js

@@ -0,0 +1,10 @@
+import { exec } from "../lib/exec.js";
+import * as log from "../lib/log.js";
+export function installSkills(cwd) {
+    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/dist/steps/setup-claude.d.ts

@@ -0,0 +1 @@
+export declare function setupClaude(cwd: string): void;

package/dist/steps/setup-claude.js

@@ -0,0 +1,47 @@
+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",
+];
+export function setupClaude(cwd) {
+    const claudeDir = join(cwd, ".claude");
+    mkdirSync(claudeDir, { recursive: true });
+    const settingsPath = join(claudeDir, "settings.local.json");
+    let settings = {};
+    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/package.json

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

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!");

package/tsconfig.json

@@ -1,29 +0,0 @@
-{
-  "compilerOptions": {
-    // Environment setup & latest features
-    "lib": ["ESNext"],
-    "target": "ESNext",
-    "module": "Preserve",
-    "moduleDetection": "force",
-    "jsx": "react-jsx",
-    "allowJs": true,
-
-    // Bundler mode
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "verbatimModuleSyntax": true,
-    "noEmit": true,
-
-    // Best practices
-    "strict": true,
-    "skipLibCheck": true,
-    "noFallthroughCasesInSwitch": true,
-    "noUncheckedIndexedAccess": true,
-    "noImplicitOverride": true,
-
-    // Some stricter flags (disabled by default)
-    "noUnusedLocals": false,
-    "noUnusedParameters": false,
-    "noPropertyAccessFromIndexSignature": false
-  }
-}