@refrakt-md/cli 0.1.0

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+const args = process.argv.slice(2);
+const command = args[0];
+if (!command || command === '--help' || command === '-h') {
+    printUsage();
+    process.exit(command ? 0 : 1);
+}
+if (command === 'write') {
+    runWrite(args.slice(1));
+}
+else if (command.startsWith('-')) {
+    console.error(`Error: Unknown flag "${command}"\n`);
+    printUsage();
+    process.exit(1);
+}
+else {
+    console.error(`Error: Unknown command "${command}"\n`);
+    printUsage();
+    process.exit(1);
+}
+function printUsage() {
+    console.log(`
+Usage: refrakt <command> [options]
+
+Commands:
+  write <prompt>  Generate a Markdown content file using AI
+
+Write Options:
+  --output, -o <path>      Write output to file instead of stdout
+  --provider, -p <name>    Provider: anthropic, ollama (default: auto-detect)
+  --model, -m <name>       Model name (default: per-provider)
+  --help, -h               Show this help message
+
+Provider auto-detection:
+  1. ANTHROPIC_API_KEY env var → Anthropic
+  2. OLLAMA_HOST env var → Ollama
+  3. Default → Ollama at localhost:11434
+
+Examples:
+  refrakt write "Create a getting started guide"
+  refrakt write -o content/docs/api.md "Write an API reference page"
+  refrakt write -p ollama -m llama3.2 "Write a FAQ page"
+  ANTHROPIC_API_KEY=sk-... refrakt write "Create a landing page"
+`);
+}
+function runWrite(writeArgs) {
+    let prompt;
+    let output;
+    let providerName;
+    let model;
+    for (let i = 0; i < writeArgs.length; i++) {
+        const arg = writeArgs[i];
+        if (arg === '--output' || arg === '-o') {
+            output = writeArgs[++i];
+            if (!output) {
+                console.error('Error: --output requires a file path');
+                process.exit(1);
+            }
+        }
+        else if (arg === '--provider' || arg === '-p') {
+            providerName = writeArgs[++i];
+            if (!providerName) {
+                console.error('Error: --provider requires a value');
+                process.exit(1);
+            }
+        }
+        else if (arg === '--model' || arg === '-m') {
+            model = writeArgs[++i];
+            if (!model) {
+                console.error('Error: --model requires a value');
+                process.exit(1);
+            }
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printUsage();
+            process.exit(0);
+        }
+        else if (arg.startsWith('-')) {
+            console.error(`Error: Unknown flag "${arg}"\n`);
+            printUsage();
+            process.exit(1);
+        }
+        else if (!prompt) {
+            prompt = arg;
+        }
+        else {
+            console.error(`Error: Unexpected argument "${arg}"\n`);
+            printUsage();
+            process.exit(1);
+        }
+    }
+    if (!prompt) {
+        console.error('Error: Missing prompt\n');
+        printUsage();
+        process.exit(1);
+    }
+    // Dynamic imports to avoid loading @refrakt-md/runes at parse time
+    // (markdoc CJS/ESM interop requires Node.js 22.12+ or a bundler)
+    Promise.all([
+        import('./config.js'),
+        import('./commands/write.js'),
+    ]).then(([{ detectProvider }, { writeCommand }]) => {
+        let resolved;
+        try {
+            resolved = detectProvider(providerName);
+        }
+        catch (err) {
+            console.error(`\nError: ${err.message}`);
+            process.exit(1);
+        }
+        return writeCommand({ prompt: prompt, provider: resolved.provider, model, output });
+    }).catch((err) => {
+        console.error(`\nError: ${err.message}`);
+        process.exit(1);
+    });
+}
+export {};
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"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"}

package/dist/commands/write.d.ts

@@ -0,0 +1,9 @@
+import type { AIProvider } from '@refrakt-md/ai';
+export interface WriteOptions {
+    prompt: string;
+    provider: AIProvider;
+    model?: string;
+    output?: string;
+}
+export declare function writeCommand(options: WriteOptions): Promise<void>;
+//# sourceMappingURL=write.d.ts.map

package/dist/commands/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/commands/write.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAW,MAAM,gBAAgB,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BvE"}

package/dist/commands/write.js

@@ -0,0 +1,28 @@
+import { writeFileSync } from 'node:fs';
+import { generateSystemPrompt } from '@refrakt-md/ai';
+import { runes } from '@refrakt-md/runes';
+export async function writeCommand(options) {
+    const { prompt, provider, model, output } = options;
+    const systemPrompt = generateSystemPrompt(runes);
+    const messages = [
+        { role: 'system', content: systemPrompt },
+        { role: 'user', content: prompt },
+    ];
+    let content = '';
+    for await (const chunk of provider.complete({ messages, model })) {
+        if (output) {
+            content += chunk;
+        }
+        else {
+            process.stdout.write(chunk);
+        }
+    }
+    if (output) {
+        writeFileSync(output, content);
+        process.stderr.write(`Written to ${output}\n`);
+    }
+    else {
+        process.stdout.write('\n');
+    }
+}
+//# sourceMappingURL=write.js.map

package/dist/commands/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/commands/write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAU1C,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAqB;IACvD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEpD,MAAM,YAAY,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAc;QAC3B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;QACzC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;KACjC,CAAC;IAEF,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAClE,IAAI,MAAM,EAAE,CAAC;YACZ,OAAO,IAAI,KAAK,CAAC;QAClB,CAAC;aAAM,CAAC;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACF,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACZ,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,MAAM,IAAI,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;AACF,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+import type { AIProvider } from '@refrakt-md/ai';
+export type ProviderName = 'anthropic' | 'ollama';
+export interface ResolvedProvider {
+    provider: AIProvider;
+    name: ProviderName;
+}
+export declare function detectProvider(explicit?: string): ResolvedProvider;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,UAAU,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAkBlE"}

package/dist/config.js

@@ -0,0 +1,42 @@
+import { createAnthropicProvider, createOllamaProvider } from '@refrakt-md/ai';
+export function detectProvider(explicit) {
+    if (explicit) {
+        return createProviderByName(explicit);
+    }
+    const anthropicKey = process.env.ANTHROPIC_API_KEY;
+    if (anthropicKey) {
+        return {
+            name: 'anthropic',
+            provider: createAnthropicProvider({ apiKey: anthropicKey }),
+        };
+    }
+    const ollamaHost = process.env.OLLAMA_HOST;
+    return {
+        name: 'ollama',
+        provider: createOllamaProvider(ollamaHost ? { host: ollamaHost } : undefined),
+    };
+}
+function createProviderByName(name) {
+    switch (name) {
+        case 'anthropic': {
+            const apiKey = process.env.ANTHROPIC_API_KEY;
+            if (!apiKey) {
+                throw new Error('ANTHROPIC_API_KEY environment variable is required for the Anthropic provider');
+            }
+            return {
+                name: 'anthropic',
+                provider: createAnthropicProvider({ apiKey }),
+            };
+        }
+        case 'ollama': {
+            const host = process.env.OLLAMA_HOST;
+            return {
+                name: 'ollama',
+                provider: createOllamaProvider(host ? { host } : undefined),
+            };
+        }
+        default:
+            throw new Error(`Unknown provider "${name}". Available: anthropic, ollama`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAS/E,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC/C,IAAI,QAAQ,EAAE,CAAC;QACd,OAAO,oBAAoB,CAAC,QAAwB,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IACnD,IAAI,YAAY,EAAE,CAAC;QAClB,OAAO;YACN,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,uBAAuB,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;SAC3D,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC3C,OAAO;QACN,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;KAC7E,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAkB;IAC/C,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,WAAW,CAAC,CAAC,CAAC;YAClB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;YAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACd,+EAA+E,CAC/E,CAAC;YACH,CAAC;YACD,OAAO;gBACN,IAAI,EAAE,WAAW;gBACjB,QAAQ,EAAE,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;aAC7C,CAAC;QACH,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;YACrC,OAAO;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;aAC3D,CAAC;QACH,CAAC;QACD;YACC,MAAM,IAAI,KAAK,CACd,qBAAqB,IAAI,iCAAiC,CAC1D,CAAC;IACJ,CAAC;AACF,CAAC"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@refrakt-md/cli",
+  "description": "CLI tools for refrakt.md",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/refrakt-md/refrakt.git",
+    "directory": "packages/cli"
+  },
+  "bugs": "https://github.com/refrakt-md/refrakt/issues",
+  "homepage": "https://github.com/refrakt-md/refrakt",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "refrakt": "./dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@refrakt-md/ai": "0.1.0",
+    "@refrakt-md/runes": "0.1.0"
+  }
+}