@pks-cli/cli 1.0.0-rc.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PKS Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,143 @@
+# PKS CLI
+
+The next agentic CLI for .NET developers - combining beautiful terminal UI with AI-powered development assistance and Kubernetes deployment capabilities.
+
+## Installation
+
+### Quick Install (npm)
+
+```bash
+npm install -g @pks-cli/pks
+```
+
+### Quick Install (.NET Global Tool)
+
+```bash
+dotnet tool install -g pks-cli
+```
+
+## Usage
+
+After installation, use the `pks` command:
+
+```bash
+# See all available commands
+pks --help
+
+# Initialize a new project
+pks init MyProject
+
+# Interactive mode (prompts for details)
+pks init
+
+# Create agentic project with MCP integration
+pks init MyAgent --agentic --mcp --template agent
+
+# API project with specific template
+pks init MyApi --template api --description "REST API for my application"
+
+# Web application with agentic features
+pks init MyWebApp --template web --agentic --description "Intelligent web application"
+
+# Generate ASCII art
+pks ascii "Hello PKS"
+
+# View system status
+pks status
+```
+
+## Available Commands
+
+- **`pks init`** - Project initialization with templates and intelligent features
+  - Supports multiple templates: console, api, web, agent, library
+  - Agentic features with `--agentic` flag for AI automation
+  - MCP integration with `--mcp` flag for AI tool connectivity
+  - Interactive mode when no project name provided
+  - Force overwrite with `--force` flag
+
+- **`pks agent`** - AI agent management (create, list, status, remove)
+
+- **`pks deploy`** - Intelligent deployment orchestration
+
+- **`pks status`** - System monitoring with real-time insights
+
+- **`pks ascii`** - ASCII art generation with animations
+
+## Platform Support
+
+PKS CLI supports the following platforms:
+
+- Linux x64
+- Linux ARM64
+- macOS x64 (Intel)
+- macOS ARM64 (Apple Silicon)
+- Windows x64
+- Windows ARM64
+
+The correct binary for your platform is automatically selected during installation.
+
+## Requirements
+
+- Node.js 18.0.0 or higher (for npm installation)
+- .NET 10.0 or higher (for .NET tool installation)
+
+## Features
+
+- Beautiful terminal UI with Spectre.Console
+- AI-powered development assistance
+- Model Context Protocol (MCP) integration
+- Kubernetes deployment capabilities
+- Project scaffolding with multiple templates
+- Interactive prompts for ease of use
+- Development container support
+- Git hooks integration
+- Comprehensive documentation generation
+
+## Troubleshooting
+
+### Binary Not Found
+
+If you see "PKS CLI binary not found" after installation:
+
+```bash
+# Try forcing reinstall
+npm install -g @pks-cli/pks --force
+
+# Or install the platform-specific package manually
+npm install -g @pks-cli/pks-linux-x64  # for Linux x64
+npm install -g @pks-cli/pks-osx-arm64  # for macOS Apple Silicon
+npm install -g @pks-cli/pks-win-x64    # for Windows x64
+```
+
+### Unsupported Platform
+
+If your platform is not supported, please use the .NET global tool installation method:
+
+```bash
+dotnet tool install -g pks-cli
+```
+
+## Documentation
+
+- [GitHub Repository](https://github.com/pksorensen/pks-cli)
+- [Issue Tracker](https://github.com/pksorensen/pks-cli/issues)
+- [Architecture Guide](https://github.com/pksorensen/pks-cli/blob/main/docs/ARCHITECTURE.md)
+- [MCP Integration](https://github.com/pksorensen/pks-cli/blob/main/docs/MCP.md)
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) for details.
+
+## Contributing
+
+Contributions are welcome! Please see the [GitHub repository](https://github.com/pksorensen/pks-cli) for more information.
+
+## Support
+
+For issues and questions:
+- File an issue on [GitHub Issues](https://github.com/pksorensen/pks-cli/issues)
+- Check the [documentation](https://github.com/pksorensen/pks-cli/tree/main/docs)
+
+---
+
+Built with love by the PKS Team

package/bin/pks.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+
+const { spawn } = require('child_process');
+const { existsSync } = require('fs');
+const { join } = require('path');
+const { platform, arch } = process;
+
+/**
+ * Maps Node.js platform/arch to PKS CLI platform package names
+ */
+function getPlatformPackage() {
+  const platformMap = {
+    'linux-x64': '@pks-cli/pks-linux-x64',
+    'linux-arm64': '@pks-cli/pks-linux-arm64',
+    'darwin-x64': '@pks-cli/pks-osx-x64',
+    'darwin-arm64': '@pks-cli/pks-osx-arm64',
+    'win32-x64': '@pks-cli/pks-win-x64',
+    'win32-arm64': '@pks-cli/pks-win-arm64'
+  };
+
+  const key = `${platform}-${arch}`;
+  return platformMap[key] || null;
+}
+
+/**
+ * Finds the platform-specific binary path
+ */
+function getBinaryPath() {
+  const packageName = getPlatformPackage();
+
+  if (!packageName) {
+    console.error(`Unsupported platform: ${platform}-${arch}`);
+    console.error('Supported platforms: linux-x64, linux-arm64, darwin-x64, darwin-arm64, win32-x64, win32-arm64');
+    process.exit(1);
+  }
+
+  // Try to find the platform package in node_modules
+  const paths = [
+    // Installed as dependency
+    join(__dirname, '..', '..', packageName.replace('@pks-cli/', 'pks-cli-'), 'pks'),
+    join(__dirname, '..', '..', packageName.replace('@pks-cli/', 'pks-cli-'), 'pks.exe'),
+    // Installed in parent node_modules
+    join(__dirname, '..', '..', '..', packageName.replace('@pks-cli/', 'pks-cli-'), 'pks'),
+    join(__dirname, '..', '..', '..', packageName.replace('@pks-cli/', 'pks-cli-'), 'pks.exe'),
+  ];
+
+  for (const path of paths) {
+    if (existsSync(path)) {
+      return path;
+    }
+  }
+
+  console.error(`PKS CLI binary not found for ${platform}-${arch}`);
+  console.error('Please ensure the platform-specific package is installed.');
+  console.error(`Expected package: ${packageName}`);
+  console.error('Try running: npm install --force');
+  process.exit(1);
+}
+
+/**
+ * Executes the platform-specific PKS CLI binary
+ */
+function runPks() {
+  const binaryPath = getBinaryPath();
+
+  // Spawn the binary with all arguments passed through
+  const child = spawn(binaryPath, process.argv.slice(2), {
+    stdio: 'inherit',
+    shell: false
+  });
+
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+    } else {
+      process.exit(code || 0);
+    }
+  });
+
+  child.on('error', (err) => {
+    console.error('Failed to execute PKS CLI:', err.message);
+    process.exit(1);
+  });
+
+  // Handle process termination
+  process.on('SIGINT', () => {
+    child.kill('SIGINT');
+  });
+
+  process.on('SIGTERM', () => {
+    child.kill('SIGTERM');
+  });
+}
+
+// Run PKS CLI
+runPks();

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@pks-cli/cli",
+  "version": "1.0.0-rc.5",
+  "description": "The next agentic CLI for .NET developers",
+  "bin": {
+    "pks": "./bin/pks.js"
+  },
+  "scripts": {
+    "postinstall": "node postinstall.js"
+  },
+  "optionalDependencies": {
+    "@pks-cli/cli-linux-x64": "1.0.0",
+    "@pks-cli/cli-linux-arm64": "1.0.0",
+    "@pks-cli/cli-osx-x64": "1.0.0",
+    "@pks-cli/cli-osx-arm64": "1.0.0",
+    "@pks-cli/cli-win-x64": "1.0.0",
+    "@pks-cli/cli-win-arm64": "1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pksorensen/pks-cli.git"
+  },
+  "keywords": [
+    "cli",
+    "dotnet",
+    "agentic",
+    "developer-tools",
+    "ai",
+    "automation",
+    "kubernetes",
+    "devcontainer"
+  ],
+  "author": "PKS Team",
+  "license": "MIT",
+  "homepage": "https://github.com/pksorensen/pks-cli#readme",
+  "bugs": {
+    "url": "https://github.com/pksorensen/pks-cli/issues"
+  }
+}

package/postinstall.js

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+
+const { platform, arch } = process;
+const { existsSync } = require('fs');
+const { join } = require('path');
+
+/**
+ * Gets the expected platform package name
+ */
+function getPlatformPackage() {
+  const platformMap = {
+    'linux-x64': '@pks-cli/pks-linux-x64',
+    'linux-arm64': '@pks-cli/pks-linux-arm64',
+    'darwin-x64': '@pks-cli/pks-osx-x64',
+    'darwin-arm64': '@pks-cli/pks-osx-arm64',
+    'win32-x64': '@pks-cli/pks-win-x64',
+    'win32-arm64': '@pks-cli/pks-win-arm64'
+  };
+
+  const key = `${platform}-${arch}`;
+  return platformMap[key] || null;
+}
+
+/**
+ * Checks if the platform-specific package is installed
+ */
+function checkPlatformPackage() {
+  const packageName = getPlatformPackage();
+
+  if (!packageName) {
+    console.warn(`⚠️  Unsupported platform: ${platform}-${arch}`);
+    console.warn('Supported platforms: linux-x64, linux-arm64, darwin-x64, darwin-arm64, win32-x64, win32-arm64');
+    return false;
+  }
+
+  const packageDirName = packageName.replace('@pks-cli/', 'pks-cli-');
+  const paths = [
+    join(__dirname, '..', packageDirName),
+    join(__dirname, '..', '..', packageDirName),
+  ];
+
+  for (const path of paths) {
+    if (existsSync(path)) {
+      console.log(`✅ PKS CLI installed successfully for ${platform}-${arch}`);
+      return true;
+    }
+  }
+
+  return false;
+}
+
+/**
+ * Provides installation instructions if platform package is missing
+ */
+function showInstallationHelp() {
+  const packageName = getPlatformPackage();
+
+  console.warn('⚠️  Platform-specific package not found');
+  console.warn('');
+  console.warn('This can happen if:');
+  console.warn('1. Optional dependencies were skipped during installation');
+  console.warn('2. The platform package failed to download');
+  console.warn('3. Corporate proxy or firewall is blocking the download');
+  console.warn('');
+  console.warn('To fix this, try:');
+  console.warn('');
+  console.warn(`  npm install ${packageName}`);
+  console.warn('');
+  console.warn('Or reinstall with:');
+  console.warn('');
+  console.warn('  npm install @pks-cli/pks --force');
+  console.warn('');
+
+  // Non-zero exit in CI environments only
+  if (process.env.CI === 'true') {
+    console.error('❌ Installation failed in CI environment');
+    process.exit(1);
+  }
+}
+
+/**
+ * Main postinstall logic
+ */
+function postinstall() {
+  console.log('🚀 Setting up PKS CLI...');
+
+  const isInstalled = checkPlatformPackage();
+
+  if (!isInstalled) {
+    showInstallationHelp();
+  }
+}
+
+// Run postinstall
+try {
+  postinstall();
+} catch (error) {
+  console.error('Postinstall script failed:', error.message);
+  // Don't fail the installation, just warn
+  if (process.env.CI === 'true') {
+    process.exit(1);
+  }
+}