wordspace 0.0.6 → 0.0.8

package/dist/commands/run.d.ts

@@ -0,0 +1 @@
+export declare function run(target: string | undefined, force: boolean): Promise<void>;

package/dist/commands/run.js

@@ -0,0 +1,55 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { parseGitHubUri, toRawUrl, fileName } from "../lib/github-uri.js";
+import { httpGet, getAuthHeaders } from "../lib/workflows.js";
+import { isClaudeInstalled, spawnClaude } from "../lib/spawn.js";
+import { ensureInit } from "../steps/auto-init.js";
+import * as log from "../lib/log.js";
+export async function run(target, force) {
+    if (!target) {
+        log.error("Usage: wordspace run <github:owner/repo/path.prose | local-path>");
+        process.exit(1);
+    }
+    if (!isClaudeInstalled()) {
+        log.error("claude CLI not found. Install Claude Code first: https://claude.ai/code");
+        process.exit(1);
+    }
+    const cwd = process.cwd();
+    // Auto-init if needed
+    ensureInit(cwd);
+    let prosePath;
+    if (target.startsWith("github:")) {
+        // Remote: download from GitHub
+        const ref = parseGitHubUri(target);
+        const name = fileName(ref);
+        const workflowsDir = join(cwd, "workflows");
+        const dest = join(workflowsDir, name);
+        if (existsSync(dest) && !force) {
+            log.skip(`${name} (cached)`);
+        }
+        else {
+            const url = toRawUrl(ref);
+            log.info(`Fetching ${name}...`);
+            const headers = getAuthHeaders();
+            const content = await httpGet(url, headers);
+            mkdirSync(workflowsDir, { recursive: true });
+            writeFileSync(dest, content, "utf-8");
+            log.success(`Downloaded ${name}`);
+        }
+        prosePath = `workflows/${name}`;
+    }
+    else {
+        // Local path
+        if (!existsSync(target)) {
+            log.error(`File not found: ${target}`);
+            process.exit(1);
+        }
+        prosePath = target;
+    }
+    const prompt = `/prose run ${prosePath}`;
+    console.log();
+    log.info(prompt);
+    console.log();
+    const exitCode = spawnClaude(prompt, cwd);
+    process.exit(exitCode);
+}

package/dist/index.js

@@ -2,8 +2,9 @@
 import { init } from "./commands/init.js";
 import { search } from "./commands/search.js";
 import { add } from "./commands/add.js";
+import { run } from "./commands/run.js";
 import * as log from "./lib/log.js";
-const VERSION = "0.0.6";
+const VERSION = "0.0.8";
 const HELP = `
 Usage: wordspace <command> [options]
 
@@ -11,6 +12,7 @@ Commands:
   init          Bootstrap a new wordspace project
   search [q]    List available workflows (optionally filter by query)
   add <name>    Download specific workflow(s) by name
+  run <target>  Run a .prose workflow via Claude Code
 
 Options:
   --force       Re-run all steps / overwrite existing files
@@ -39,6 +41,9 @@ async function main() {
     else if (command === "add") {
         await add(positional.slice(1), force);
     }
+    else if (command === "run") {
+        await run(positional[1], force);
+    }
     else if (!command) {
         console.log(HELP);
         process.exit(0);

package/dist/lib/github-uri.d.ts

@@ -0,0 +1,14 @@
+export interface GitHubRef {
+    owner: string;
+    repo: string;
+    path: string;
+    branch: string;
+}
+/**
+ * Parse a `github:owner/repo/path/file.prose[@branch]` URI.
+ */
+export declare function parseGitHubUri(uri: string): GitHubRef;
+/** Build the raw.githubusercontent.com URL for a ref. */
+export declare function toRawUrl(ref: GitHubRef): string;
+/** Extract the filename from the path (last segment). */
+export declare function fileName(ref: GitHubRef): string;

package/dist/lib/github-uri.js

@@ -0,0 +1,22 @@
+/**
+ * Parse a `github:owner/repo/path/file.prose[@branch]` URI.
+ */
+export function parseGitHubUri(uri) {
+    const body = uri.replace(/^github:/, "");
+    const [pathPart, branch = "main"] = body.split("@");
+    const segments = pathPart.split("/");
+    if (segments.length < 3) {
+        throw new Error(`Invalid GitHub URI: "${uri}". Expected github:owner/repo/path[...@branch]`);
+    }
+    const [owner, repo, ...rest] = segments;
+    return { owner, repo, path: rest.join("/"), branch };
+}
+/** Build the raw.githubusercontent.com URL for a ref. */
+export function toRawUrl(ref) {
+    return `https://raw.githubusercontent.com/${ref.owner}/${ref.repo}/${ref.branch}/${ref.path}`;
+}
+/** Extract the filename from the path (last segment). */
+export function fileName(ref) {
+    const parts = ref.path.split("/");
+    return parts[parts.length - 1];
+}

package/dist/lib/spawn.d.ts

@@ -0,0 +1,4 @@
+/** Check if `claude` CLI is available on PATH. */
+export declare function isClaudeInstalled(): boolean;
+/** Spawn `claude` interactively, handing over the terminal. */
+export declare function spawnClaude(prompt: string, cwd: string): number;

package/dist/lib/spawn.js

@@ -0,0 +1,19 @@
+import { spawnSync, execSync } from "node:child_process";
+/** Check if `claude` CLI is available on PATH. */
+export function isClaudeInstalled() {
+    try {
+        execSync("which claude", { stdio: "pipe" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Spawn `claude` interactively, handing over the terminal. */
+export function spawnClaude(prompt, cwd) {
+    const result = spawnSync("claude", [prompt], {
+        cwd,
+        stdio: "inherit",
+    });
+    return result.status ?? 1;
+}

package/dist/steps/auto-init.d.ts

@@ -0,0 +1,2 @@
+/** Silently initialize the project if not already done. */
+export declare function ensureInit(cwd: string): void;

package/dist/steps/auto-init.js

@@ -0,0 +1,43 @@
+import { existsSync } from "node:fs";
+import { execSync } from "node:child_process";
+import { join } from "node:path";
+import { setupClaude } from "./setup-claude.js";
+import { createDirs } from "./create-dirs.js";
+import * as log from "../lib/log.js";
+const SKILL_PACKAGES = [
+    "frames-engineering/skills",
+    "frames-engineering/wordspace",
+];
+function installSkills(cwd) {
+    for (const pkg of SKILL_PACKAGES) {
+        try {
+            execSync(`npx -y skills add ${pkg} --all`, {
+                cwd,
+                stdio: "inherit",
+            });
+        }
+        catch {
+            log.warn(`Could not install skills from ${pkg}`);
+        }
+    }
+}
+/** Silently initialize the project if not already done. */
+export function ensureInit(cwd) {
+    const hasSettings = existsSync(join(cwd, ".claude", "settings.local.json"));
+    const hasOutput = existsSync(join(cwd, "output"));
+    const skillsDir = join(cwd, ".agents", "skills");
+    const hasSkills = existsSync(join(skillsDir, "open-prose")) &&
+        existsSync(join(skillsDir, "agentwallet")) &&
+        existsSync(join(skillsDir, "registry")) &&
+        existsSync(join(skillsDir, "wordspace"));
+    if (hasSettings && hasOutput && hasSkills)
+        return;
+    log.info("Auto-initializing project...");
+    if (!hasSettings || !hasOutput) {
+        setupClaude(cwd);
+        createDirs(cwd);
+    }
+    if (!hasSkills) {
+        installSkills(cwd);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wordspace",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "type": "module",
   "files": [
     "dist"