@altairalabs/packc 0.0.1

package/README.md

@@ -0,0 +1,259 @@
+# @altairalabs/packc
+
+> PromptKit Pack Compiler - Compile and validate prompt packs for LLM applications
+
+## Installation
+
+### npx (No Installation Required)
+
+```bash
+npx @altairalabs/packc compile -c arena.yaml
+npx @altairalabs/packc validate -c arena.yaml
+```
+
+### Global Installation
+
+```bash
+npm install -g @altairalabs/packc
+
+# Use directly
+packc version
+packc compile -c arena.yaml
+```
+
+### Project Dev Dependency
+
+```bash
+npm install --save-dev @altairalabs/packc
+
+# Use via npm scripts
+# Add to package.json:
+{
+  "scripts": {
+    "build:prompts": "packc compile -c arena.yaml",
+    "validate:prompts": "packc validate -c arena.yaml"
+  }
+}
+```
+
+## What is PackC?
+
+PackC is the PromptKit Pack Compiler - a tool for compiling and validating prompt configurations. It helps you:
+
+- 📦 **Compile prompts** from YAML configurations into optimized packs
+- ✅ **Validate configurations** before deployment
+- 🔍 **Inspect prompts** to understand structure and metadata
+- 🚀 **Optimize** prompt loading for production use
+
+## Quick Start
+
+1. Create a configuration file:
+
+```yaml
+# arena.yaml
+name: My Application
+version: 1.0.0
+
+prompts:
+  - name: assistant
+    system_prompt: |
+      You are a helpful AI assistant.
+    
+  - name: code-helper
+    system_prompt: |
+      You are an expert programmer.
+    context:
+      - type: file
+        path: ./docs/guidelines.md
+```
+
+2. Compile the prompts:
+
+```bash
+packc compile -c arena.yaml -o prompts.pack
+```
+
+3. Validate the configuration:
+
+```bash
+packc validate -c arena.yaml
+```
+
+4. Inspect a specific prompt:
+
+```bash
+packc inspect -c arena.yaml -p assistant
+```
+
+## Commands
+
+### compile
+
+Compile all prompts from a configuration file into a single pack:
+
+```bash
+packc compile -c arena.yaml -o output.pack
+```
+
+Options:
+- `-c, --config`: Path to arena.yaml configuration file (required)
+- `-o, --output`: Output pack file path (default: prompts.pack)
+
+### compile-prompt
+
+Compile a single prompt:
+
+```bash
+packc compile-prompt -c arena.yaml -p assistant -o assistant.json
+```
+
+Options:
+- `-c, --config`: Path to configuration file (required)
+- `-p, --prompt`: Name of the prompt to compile (required)
+- `-o, --output`: Output file path (default: stdout)
+
+### validate
+
+Validate configuration file without compiling:
+
+```bash
+packc validate -c arena.yaml
+```
+
+Checks for:
+- YAML syntax errors
+- Missing required fields
+- Invalid prompt references
+- Malformed context definitions
+- File path validation
+
+### inspect
+
+Inspect a specific prompt's configuration:
+
+```bash
+packc inspect -c arena.yaml -p assistant
+```
+
+Shows:
+- Prompt name and metadata
+- System prompt content
+- Context sources
+- Variable definitions
+- Formatting details
+
+### version
+
+Display version information:
+
+```bash
+packc version
+```
+
+## Use Cases
+
+### CI/CD Validation
+
+Add prompt validation to your CI pipeline:
+
+```yaml
+# .github/workflows/validate.yml
+- name: Validate prompts
+  run: npx @altairalabs/packc validate -c config/arena.yaml
+```
+
+### Build Scripts
+
+Compile prompts as part of your build process:
+
+```json
+{
+  "scripts": {
+    "prebuild": "packc compile -c arena.yaml",
+    "build": "your-build-command"
+  }
+}
+```
+
+### Local Development
+
+Quickly validate changes during development:
+
+```bash
+# Watch for changes and validate
+watch -n 2 'packc validate -c arena.yaml'
+```
+
+## How It Works
+
+This npm package downloads pre-built Go binaries from [GitHub Releases](https://github.com/AltairaLabs/PromptKit/releases) during installation. The binaries are:
+
+1. Downloaded for your specific OS and architecture
+2. Extracted from the release archive
+3. Made executable (Unix-like systems)
+4. Invoked through a thin Node.js wrapper
+
+No Go toolchain is required on your machine.
+
+## Supported Platforms
+
+- macOS (Intel and Apple Silicon)
+- Linux (x86_64 and arm64)
+- Windows (x86_64 and arm64)
+
+## Documentation
+
+- [Full Documentation](https://github.com/AltairaLabs/PromptKit#readme)
+- [Configuration Reference](https://github.com/AltairaLabs/PromptKit/tree/main/docs)
+- [Examples](https://github.com/AltairaLabs/PromptKit/tree/main/examples)
+
+## Troubleshooting
+
+### Binary Download Fails
+
+If the postinstall script fails:
+
+1. Check your internet connection
+2. Verify the version exists in [GitHub Releases](https://github.com/AltairaLabs/PromptKit/releases)
+3. Check npm proxy/registry settings
+4. Try manual installation:
+
+```bash
+# Download binary directly
+curl -L https://github.com/AltairaLabs/PromptKit/releases/download/v0.0.1/PromptKit_v0.0.1_Darwin_arm64.tar.gz -o packc.tar.gz
+tar -xzf packc.tar.gz packc
+chmod +x packc
+```
+
+### Permission Denied
+
+On Unix-like systems:
+
+```bash
+chmod +x node_modules/@altairalabs/packc/packc
+```
+
+## Alternative Installation Methods
+
+- **Homebrew**: `brew install altairalabs/tap/promptkit`
+- **Go Install**: `go install github.com/AltairaLabs/PromptKit/tools/packc@latest`
+- **Direct Download**: [GitHub Releases](https://github.com/AltairaLabs/PromptKit/releases)
+- **Build from Source**: Clone repo and run `make install-tools`
+
+## Related Tools
+
+- **[@altairalabs/promptarena](https://www.npmjs.com/package/@altairalabs/promptarena)** - Test and evaluate your prompts
+- **PromptKit SDK** - Production deployment library
+
+## License
+
+Apache-2.0 - see [LICENSE](https://github.com/AltairaLabs/PromptKit/blob/main/LICENSE)
+
+## Contributing
+
+Contributions welcome! See [CONTRIBUTING.md](https://github.com/AltairaLabs/PromptKit/blob/main/CONTRIBUTING.md)
+
+## Support
+
+- [GitHub Issues](https://github.com/AltairaLabs/PromptKit/issues)
+- [Discussions](https://github.com/AltairaLabs/PromptKit/discussions)

package/bin/packc.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const binaryName = process.platform === 'win32' ? 'packc.exe' : 'packc';
+const binaryPath = path.join(__dirname, '..', binaryName);
+
+// Check if binary exists
+if (!fs.existsSync(binaryPath)) {
+  console.error('Error: packc binary not found.');
+  console.error('Please try reinstalling: npm install @altairalabs/packc');
+  process.exit(1);
+}
+
+// Spawn the Go binary with all arguments
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  windowsHide: false
+});
+
+child.on('error', (err) => {
+  console.error('Failed to start packc:', err.message);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code || 0);
+  }
+});

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@altairalabs/packc",
+  "version": "0.0.1",
+  "description": "PromptKit Pack Compiler - Compile and validate prompt packs for LLM applications",
+  "bin": {
+    "packc": "./bin/packc.js"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js",
+    "test": "node bin/packc.js version"
+  },
+  "keywords": [
+    "llm",
+    "prompt",
+    "compiler",
+    "validation",
+    "ai",
+    "prompt-engineering",
+    "pack",
+    "openai",
+    "anthropic",
+    "gemini"
+  ],
+  "author": "Altaira Labs",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AltairaLabs/PromptKit.git",
+    "directory": "npm/packc"
+  },
+  "bugs": {
+    "url": "https://github.com/AltairaLabs/PromptKit/issues"
+  },
+  "homepage": "https://github.com/AltairaLabs/PromptKit#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "files": [
+    "bin/",
+    "postinstall.js",
+    "README.md"
+  ]
+}

package/postinstall.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+
+const https = require('node:https');
+const http = require('node:http');
+const fs = require('node:fs');
+const path = require('node:path');
+const { execSync } = require('node:child_process');
+const { pipeline } = require('node:stream');
+const { promisify } = require('node:util');
+
+const streamPipeline = promisify(pipeline);
+
+const BINARY_NAME = 'packc';
+const GITHUB_REPO = 'AltairaLabs/PromptKit';
+const VERSION = require('./package.json').version;
+
+// Platform mapping to match GoReleaser output
+const PLATFORM_MAP = {
+  darwin: 'Darwin',
+  linux: 'Linux',
+  win32: 'Windows'
+};
+
+const ARCH_MAP = {
+  x64: 'x86_64',
+  arm64: 'arm64'
+};
+
+function getPlatformInfo() {
+  const platform = PLATFORM_MAP[process.platform];
+  const arch = ARCH_MAP[process.arch];
+  
+  if (!platform || !arch) {
+    throw new Error(`Unsupported platform: ${process.platform}-${process.arch}`);
+  }
+  
+  return { platform, arch };
+}
+
+function getDownloadUrl(platform, arch) {
+  const archiveExt = platform === 'Windows' ? 'zip' : 'tar.gz';
+  const archiveName = `PromptKit_v${VERSION}_${platform}_${arch}.${archiveExt}`;
+  return `https://github.com/${GITHUB_REPO}/releases/download/v${VERSION}/${archiveName}`;
+}
+
+async function downloadFile(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const client = url.startsWith('https:') ? https : http;
+    
+    client.get(url, (response) => {
+      // Follow redirects
+      if (response.statusCode === 302 || response.statusCode === 301) {
+        downloadFile(response.headers.location, destPath)
+          .then(resolve)
+          .catch(reject);
+        return;
+      }
+      
+      if (response.statusCode !== 200) {
+        reject(new Error(`Failed to download: HTTP ${response.statusCode}`));
+        return;
+      }
+      
+      const fileStream = fs.createWriteStream(destPath);
+      streamPipeline(response, fileStream)
+        .then(resolve)
+        .catch(reject);
+    }).on('error', reject);
+  });
+}
+
+function extractBinary(archivePath, platform, binaryName) {
+  const binaryWithExt = platform === 'Windows' ? `${binaryName}.exe` : binaryName;
+  const destPath = path.join(__dirname, binaryWithExt);
+  
+  try {
+    if (platform === 'Windows') {
+      // Extract from zip - the binary should be in the archive root
+      execSync(`unzip -j "${archivePath}" "${binaryWithExt}" -d "${__dirname}"`, {
+        stdio: 'inherit'
+      });
+    } else {
+      // Extract from tar.gz - the binary should be in the archive root
+      execSync(`tar -xzf "${archivePath}" -C "${__dirname}" "${binaryWithExt}"`, {
+        stdio: 'inherit'
+      });
+    }
+    
+    // Make executable on Unix-like systems
+    if (platform !== 'Windows') {
+      fs.chmodSync(destPath, 0o755);
+    }
+    
+    console.log(`✓ Extracted ${binaryWithExt}`);
+    return destPath;
+  } catch (error) {
+    throw new Error(`Failed to extract binary: ${error.message}`);
+  }
+}
+
+async function install() {
+  console.log(`Installing ${BINARY_NAME} v${VERSION}...`);
+  
+  const { platform, arch } = getPlatformInfo();
+  console.log(`Platform: ${platform} ${arch}`);
+  
+  const url = getDownloadUrl(platform, arch);
+  const archiveExt = platform === 'Windows' ? 'zip' : 'tar.gz';
+  const archivePath = path.join(__dirname, `archive.${archiveExt}`);
+  
+  try {
+    console.log('Downloading binary from GitHub Releases...');
+    await downloadFile(url, archivePath);
+    console.log('✓ Download complete');
+    
+    console.log('Extracting binary...');
+    extractBinary(archivePath, platform, BINARY_NAME);
+    
+    // Clean up archive
+    fs.unlinkSync(archivePath);
+    
+    console.log(`✓ ${BINARY_NAME} installed successfully!`);
+  } catch (error) {
+    console.error(`\n❌ Installation failed: ${error.message}`);
+    console.error('\nTroubleshooting:');
+    console.error('1. Verify version exists: https://github.com/AltairaLabs/PromptKit/releases');
+    console.error('2. Check your internet connection');
+    console.error('3. Try downloading manually from GitHub Releases');
+    console.error(`   URL: ${url}`);
+    process.exit(1);
+  }
+}
+
+await install();