wordspace 0.0.3 → 0.0.4

package/dist/commands/add.d.ts

@@ -0,0 +1 @@
+export declare function add(names: string[], force: boolean): Promise<void>;

package/dist/commands/add.js

@@ -0,0 +1,40 @@
+import { mkdirSync } from "node:fs";
+import { join } from "node:path";
+import * as log from "../lib/log.js";
+import { listWorkflows, downloadWorkflow } from "../lib/workflows.js";
+export async function add(names, force) {
+    if (names.length === 0) {
+        log.error("Specify at least one workflow name. Run `wordspace search` to browse.");
+        process.exit(1);
+    }
+    let available;
+    try {
+        available = await listWorkflows();
+    }
+    catch (err) {
+        log.error(`Could not fetch workflows: ${err.message}`);
+        process.exit(1);
+    }
+    const workflowsDir = join(process.cwd(), "workflows");
+    mkdirSync(workflowsDir, { recursive: true });
+    let downloaded = 0;
+    for (const raw of names) {
+        const name = raw.endsWith(".prose") ? raw : `${raw}.prose`;
+        const entry = available.find((w) => w.name === name);
+        if (!entry) {
+            log.warn(`Workflow not found: ${name}`);
+            continue;
+        }
+        try {
+            const ok = await downloadWorkflow(entry, workflowsDir, force);
+            if (ok)
+                downloaded++;
+        }
+        catch (err) {
+            log.warn(`Failed to download ${name}: ${err.message}`);
+        }
+    }
+    if (downloaded > 0) {
+        log.success(`Downloaded ${downloaded} workflow(s) to workflows/`);
+    }
+}

package/dist/commands/init.js

@@ -37,5 +37,8 @@ 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
+
+Browse more workflows:  wordspace search
+Add a workflow:         wordspace add <name>
 `);
 }

package/dist/commands/search.d.ts

@@ -0,0 +1 @@
+export declare function search(query?: string): Promise<void>;

package/dist/commands/search.js

@@ -0,0 +1,25 @@
+import * as log from "../lib/log.js";
+import { listWorkflows } from "../lib/workflows.js";
+export async function search(query) {
+    let workflows;
+    try {
+        workflows = await listWorkflows();
+    }
+    catch (err) {
+        log.error(`Could not fetch workflows: ${err.message}`);
+        process.exit(1);
+    }
+    if (query) {
+        const lower = query.toLowerCase();
+        workflows = workflows.filter((w) => w.name.toLowerCase().includes(lower));
+    }
+    if (workflows.length === 0) {
+        log.info(query ? `No workflows matching "${query}"` : "No workflows found");
+        return;
+    }
+    log.info(`${workflows.length} workflow(s) available${query ? ` matching "${query}"` : ""}:\n`);
+    for (const w of workflows) {
+        console.log(`  ${w.name.replace(/\.prose$/, "")}`);
+    }
+    console.log(`\nRun ${`wordspace add <name>`} to download a workflow.`);
+}

package/dist/index.js

@@ -1,15 +1,19 @@
 #!/usr/bin/env node
 import { init } from "./commands/init.js";
+import { search } from "./commands/search.js";
+import { add } from "./commands/add.js";
 import * as log from "./lib/log.js";
-const VERSION = "0.0.3";
+const VERSION = "0.0.4";
 const HELP = `
 Usage: wordspace <command> [options]
 
 Commands:
   init          Bootstrap a new wordspace project
+  search [q]    List available workflows (optionally filter by query)
+  add <name>    Download specific workflow(s) by name
 
 Options:
-  --force       Re-run all steps even if already completed
+  --force       Re-run all steps / overwrite existing files
   --help        Show this help message
   --version     Show version number
 `.trim();
@@ -23,11 +27,18 @@ async function main() {
         console.log(VERSION);
         process.exit(0);
     }
-    const command = args.find((a) => !a.startsWith("-"));
+    const positional = args.filter((a) => !a.startsWith("-"));
+    const command = positional[0];
     const force = args.includes("--force");
     if (command === "init") {
         await init(force);
     }
+    else if (command === "search") {
+        await search(positional[1]);
+    }
+    else if (command === "add") {
+        await add(positional.slice(1), force);
+    }
     else if (!command) {
         console.log(HELP);
         process.exit(0);

package/dist/lib/prompt.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Prompt the user to pick items from a numbered list.
+ *
+ * Accepts: "all", "none", comma-separated numbers, ranges ("1-3"),
+ * or a mix ("1,3-5,7").
+ *
+ * In non-TTY environments (CI), auto-selects all items.
+ */
+export declare function pickMany<T>(items: T[], label: (item: T, index: number) => string, prompt: string): Promise<T[]>;

package/dist/lib/prompt.js

@@ -0,0 +1,59 @@
+import { createInterface } from "node:readline";
+/**
+ * Prompt the user to pick items from a numbered list.
+ *
+ * Accepts: "all", "none", comma-separated numbers, ranges ("1-3"),
+ * or a mix ("1,3-5,7").
+ *
+ * In non-TTY environments (CI), auto-selects all items.
+ */
+export async function pickMany(items, label, prompt) {
+    if (items.length === 0)
+        return [];
+    // Non-TTY: auto-select all
+    if (!process.stdin.isTTY) {
+        return items;
+    }
+    // Print numbered list
+    for (let i = 0; i < items.length; i++) {
+        console.log(`  ${String(i + 1).padStart(2)}  ${label(items[i], i)}`);
+    }
+    console.log();
+    const answer = await ask(`${prompt} [all/none/1,2,3/1-3]: `);
+    return parseSelection(answer, items);
+}
+function ask(prompt) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+function parseSelection(input, items) {
+    const lower = input.toLowerCase();
+    if (lower === "all" || lower === "")
+        return items;
+    if (lower === "none" || lower === "0")
+        return [];
+    const indices = new Set();
+    for (const part of input.split(",")) {
+        const trimmed = part.trim();
+        const rangeMatch = trimmed.match(/^(\d+)\s*-\s*(\d+)$/);
+        if (rangeMatch) {
+            const start = parseInt(rangeMatch[1], 10);
+            const end = parseInt(rangeMatch[2], 10);
+            for (let i = start; i <= end; i++) {
+                if (i >= 1 && i <= items.length)
+                    indices.add(i - 1);
+            }
+        }
+        else {
+            const n = parseInt(trimmed, 10);
+            if (!isNaN(n) && n >= 1 && n <= items.length)
+                indices.add(n - 1);
+        }
+    }
+    return [...indices].sort((a, b) => a - b).map((i) => items[i]);
+}

package/dist/lib/workflows.d.ts

@@ -0,0 +1,10 @@
+export interface WorkflowEntry {
+    name: string;
+    download_url: string;
+}
+export declare function httpGet(url: string, headers?: Record<string, string>): Promise<string>;
+export declare function getAuthHeaders(): Record<string, string>;
+/** Fetch the list of .prose workflow files available on GitHub. */
+export declare function listWorkflows(): Promise<WorkflowEntry[]>;
+/** Download a single workflow file into the target directory. */
+export declare function downloadWorkflow(entry: WorkflowEntry, workflowsDir: string, force: boolean): Promise<boolean>;

package/dist/lib/workflows.js

@@ -0,0 +1,55 @@
+import { get as httpsGet } from "node:https";
+import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import * as log from "./log.js";
+const CONTENTS_URL = "https://api.github.com/repos/frames-engineering/wordspace-demos/contents/workflows";
+export function httpGet(url, headers = {}) {
+    return new Promise((resolve, reject) => {
+        const allHeaders = {
+            "User-Agent": "wordspace-cli",
+            ...headers,
+        };
+        httpsGet(url, { headers: allHeaders }, (res) => {
+            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);
+    });
+}
+export function getAuthHeaders() {
+    const token = process.env["GITHUB_TOKEN"] || process.env["GH_TOKEN"];
+    if (token) {
+        return { Authorization: `Bearer ${token}` };
+    }
+    return {};
+}
+/** Fetch the list of .prose workflow files available on GitHub. */
+export async function listWorkflows() {
+    const headers = getAuthHeaders();
+    const body = await httpGet(CONTENTS_URL, headers);
+    const entries = JSON.parse(body);
+    return entries.filter((e) => e.name.endsWith(".prose"));
+}
+/** Download a single workflow file into the target directory. */
+export async function downloadWorkflow(entry, workflowsDir, force) {
+    const dest = join(workflowsDir, entry.name);
+    if (existsSync(dest) && !force) {
+        log.skip(`${entry.name} (exists)`);
+        return false;
+    }
+    const headers = getAuthHeaders();
+    const content = await httpGet(entry.download_url, headers);
+    mkdirSync(workflowsDir, { recursive: true });
+    writeFileSync(dest, content, "utf-8");
+    log.success(entry.name);
+    return true;
+}

package/dist/steps/fetch-workflows.js

@@ -1,78 +1,50 @@
-import { get as httpsGet } from "node:https";
-import { mkdirSync, writeFileSync, existsSync } from "node:fs";
+import { mkdirSync, 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 {};
-}
+import { listWorkflows, downloadWorkflow } from "../lib/workflows.js";
+import { pickMany } from "../lib/prompt.js";
 export async function fetchWorkflows(cwd, force) {
     const workflowsDir = join(cwd, "workflows");
     mkdirSync(workflowsDir, { recursive: true });
-    const headers = getAuthHeaders();
-    let entries;
+    let available;
     try {
-        const body = await httpGet(CONTENTS_URL, headers);
-        entries = JSON.parse(body);
+        available = await listWorkflows();
     }
     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/");
+    if (available.length === 0) {
+        log.warn("No .prose files found in remote repository");
+        return;
+    }
+    // Filter out already-installed unless --force
+    const candidates = force
+        ? available
+        : available.filter((e) => !existsSync(join(workflowsDir, e.name)));
+    if (candidates.length === 0) {
+        log.skip("All workflows already present");
+        return;
+    }
+    log.info(`${available.length} workflow(s) available, ${candidates.length} new:`);
+    const selected = await pickMany(candidates, (w) => w.name.replace(/\.prose$/, ""), "Which workflows do you want?");
+    if (selected.length === 0) {
+        log.skip("No workflows selected");
         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;
-        }
+    for (const entry of selected) {
         try {
-            const content = await httpGet(file.download_url, headers);
-            writeFileSync(dest, content, "utf-8");
-            log.success(file.name);
-            downloaded++;
+            const ok = await downloadWorkflow(entry, workflowsDir, force);
+            if (ok)
+                downloaded++;
         }
         catch (err) {
-            log.warn(`Failed to download ${file.name}: ${err.message}`);
+            log.warn(`Failed to download ${entry.name}: ${err.message}`);
         }
     }
     if (downloaded > 0) {
         log.success(`Downloaded ${downloaded} workflow(s) to workflows/`);
     }
-    else {
-        log.skip("All workflows already present");
-    }
 }

package/package.json

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