@neural-tools/create 0.1.3

package/LICENSE.md

@@ -0,0 +1,80 @@
+# Neural Tools License
+
+Copyright (c) 2025 Luke Amy. All rights reserved.
+
+## License Agreement
+
+This software is provided under a dual-license model:
+
+### 1. Free Tier License (MIT)
+
+The following components are licensed under the MIT License:
+
+- Basic MCP generation functionality
+- Claude command generation
+- Core utilities and types
+- Basic templates
+- Documentation and examples
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of the free tier components to use, copy, modify, merge, publish, and distribute, 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.
+
+### 2. Pro/Enterprise License (Proprietary)
+
+The following features require a valid Pro or Enterprise license:
+
+**Pro Features:**
+- Vector database integration
+- Semantic caching
+- Fine-tuning workflows
+- Cloud deployment templates (AWS/GCP)
+- Premium templates and examples
+- GitHub automation features
+
+**Enterprise Features:**
+- White-label support
+- Custom integrations
+- Priority support
+- SLA guarantees
+- Team collaboration features
+
+These features are proprietary and may not be used without a valid license key purchased from neural-tools.dev.
+
+### License Terms
+
+1. **Free Tier**: You may use the free tier features for any purpose, including commercial use, under the MIT License terms.
+
+2. **Pro/Enterprise**: You must purchase a license to access Pro or Enterprise features. Each license is:
+   - Per-user for individual licenses
+   - Per-organization for team/enterprise licenses
+   - Non-transferable without written consent
+   - Subject to the terms at neural-tools.dev/terms
+
+3. **Source Code**: This repository is private. You may not:
+   - Redistribute the source code
+   - Create derivative works for redistribution
+   - Reverse engineer Pro/Enterprise features
+   - Remove or circumvent license checks
+
+4. **Support**: Support is provided based on your license tier:
+   - Free: Community support only
+   - Pro: Email support (48-hour response)
+   - Enterprise: Priority support with SLA
+
+### Warranty Disclaimer
+
+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.
+
+### Contact
+
+For licensing inquiries:
+- Email: licensing@neural-tools.dev
+- Website: https://neural-tools.dev/pricing
+- Support: support@neural-tools.dev
+
+---
+
+**Last Updated:** January 2025

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,274 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const commander_1 = require("commander");
+const inquirer_1 = __importDefault(require("inquirer"));
+const execa_1 = require("execa");
+const picocolors_1 = __importDefault(require("picocolors"));
+const program = new commander_1.Command();
+program
+    .name('create-neural-tools')
+    .description('Create a new Neural Tools workspace')
+    .argument('[project-name]', 'Name of your project')
+    .option('-t, --template <template>', 'Template to use (full, minimal)', 'full')
+    .option('-p, --package-manager <pm>', 'Package manager (npm, pnpm, yarn)', 'pnpm')
+    .option('--skip-install', 'Skip dependency installation', false)
+    .action(async (projectName, options) => {
+    await createProject(projectName, options);
+});
+async function createProject(projectName, options) {
+    console.log(picocolors_1.default.cyan(picocolors_1.default.bold('\n✨ Neural Tools Project Generator\n')));
+    // Prompt for project name if not provided
+    let name = projectName;
+    if (!name) {
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'input',
+                name: 'projectName',
+                message: 'Project name:',
+                default: 'my-ai-toolkit',
+                validate: (input) => {
+                    if (!input || input.trim().length === 0) {
+                        return 'Project name is required';
+                    }
+                    if (!/^[a-z0-9-]+$/.test(input)) {
+                        return 'Project name must be lowercase, alphanumeric with hyphens';
+                    }
+                    return true;
+                }
+            }
+        ]);
+        name = answers.projectName;
+    }
+    if (!name) {
+        console.log(picocolors_1.default.red('\n✗ Project name is required\n'));
+        process.exit(1);
+    }
+    const projectDir = path_1.default.resolve(process.cwd(), name);
+    // Check if directory exists
+    if (await fs_extra_1.default.pathExists(projectDir)) {
+        const { overwrite } = await inquirer_1.default.prompt([
+            {
+                type: 'confirm',
+                name: 'overwrite',
+                message: `Directory ${name} already exists. Overwrite?`,
+                default: false
+            }
+        ]);
+        if (!overwrite) {
+            console.log(picocolors_1.default.yellow('\n⚠ Cancelled\n'));
+            process.exit(0);
+        }
+        await fs_extra_1.default.remove(projectDir);
+    }
+    // Prompt for template and package manager if not provided
+    const config = await inquirer_1.default.prompt([
+        {
+            type: 'list',
+            name: 'template',
+            message: 'Choose a template:',
+            default: options.template,
+            when: !options.template,
+            choices: [
+                {
+                    name: 'Full - Complete toolkit with examples',
+                    value: 'full'
+                },
+                {
+                    name: 'Minimal - Basic structure only',
+                    value: 'minimal'
+                }
+            ]
+        },
+        {
+            type: 'list',
+            name: 'packageManager',
+            message: 'Package manager:',
+            default: options.packageManager,
+            when: !options.packageManager,
+            choices: ['pnpm', 'npm', 'yarn']
+        }
+    ]);
+    const template = config.template || options.template || 'full';
+    const packageManager = config.packageManager || options.packageManager || 'pnpm';
+    console.log(picocolors_1.default.blue('\n→ Creating project structure...\n'));
+    // Create project directory
+    await fs_extra_1.default.ensureDir(projectDir);
+    // Create workspace structure
+    await createWorkspaceStructure(projectDir, template, name);
+    console.log(picocolors_1.default.green('✓ Project structure created\n'));
+    // Install dependencies
+    if (!options.skipInstall) {
+        console.log(picocolors_1.default.blue('→ Installing dependencies...\n'));
+        try {
+            await (0, execa_1.execa)(packageManager, ['install'], {
+                cwd: projectDir,
+                stdio: 'inherit'
+            });
+            console.log(picocolors_1.default.green('\n✓ Dependencies installed\n'));
+        }
+        catch (error) {
+            console.log(picocolors_1.default.yellow('\n⚠ Failed to install dependencies\n'));
+            console.log(picocolors_1.default.dim(`Run "cd ${name} && ${packageManager} install" manually\n`));
+        }
+    }
+    // Print next steps
+    printNextSteps(name, packageManager);
+}
+async function createWorkspaceStructure(projectDir, template, projectName) {
+    // Create directories
+    await fs_extra_1.default.ensureDir(path_1.default.join(projectDir, 'apps'));
+    await fs_extra_1.default.ensureDir(path_1.default.join(projectDir, 'packages'));
+    await fs_extra_1.default.ensureDir(path_1.default.join(projectDir, 'claude', 'commands'));
+    await fs_extra_1.default.ensureDir(path_1.default.join(projectDir, 'claude', 'rules'));
+    await fs_extra_1.default.ensureDir(path_1.default.join(projectDir, 'claude', 'hooks'));
+    await fs_extra_1.default.ensureDir(path_1.default.join(projectDir, 'claude', 'agents'));
+    await fs_extra_1.default.ensureDir(path_1.default.join(projectDir, 'scripts'));
+    await fs_extra_1.default.ensureDir(path_1.default.join(projectDir, '.github', 'workflows'));
+    // Create package.json
+    const packageJson = {
+        name: projectName,
+        version: '0.1.0',
+        private: true,
+        description: 'Neural Tools workspace',
+        scripts: {
+            build: 'pnpm -r build',
+            dev: 'pnpm -r --parallel dev',
+            test: 'pnpm -r test',
+            'generate:mcp': 'neural-tools generate mcp',
+            'generate:command': 'neural-tools generate command',
+            'generate:agent': 'neural-tools generate agent'
+        },
+        devDependencies: {
+            '@neural-tools/cli': '^0.1.0',
+            typescript: '^5.3.3'
+        },
+        packageManager: 'pnpm@8.15.1'
+    };
+    await fs_extra_1.default.writeJSON(path_1.default.join(projectDir, 'package.json'), packageJson, { spaces: 2 });
+    // Create pnpm-workspace.yaml
+    const workspaceConfig = `packages:
+  - 'apps/*'
+  - 'packages/*'
+`;
+    await fs_extra_1.default.writeFile(path_1.default.join(projectDir, 'pnpm-workspace.yaml'), workspaceConfig, 'utf-8');
+    // Create CLAUDE.md
+    const claudeMd = `# ${projectName}
+
+AI Toolkit workspace for building MCPs, Claude commands, and AI workflows.
+
+## Project Structure
+
+- \`apps/\` - MCP servers and deployable applications
+- \`packages/\` - Reusable libraries and shared code
+- \`claude/\` - Claude Code customizations (commands, rules, agents, hooks)
+- \`scripts/\` - Utility scripts
+
+## Coding Standards
+
+- Use TypeScript for all code
+- Follow ESM module format
+- Write tests for all public APIs
+- Document complex logic with comments
+
+## AI Workflow
+
+This project uses AI Toolkit to accelerate development:
+- Generate MCPs: \`npm run generate:mcp <name>\`
+- Generate commands: \`npm run generate:command <name>\`
+- Generate agents: \`npm run generate:agent <name>\`
+
+## Getting Started
+
+1. Install dependencies: \`pnpm install\`
+2. Generate your first MCP: \`pnpm generate:mcp github\`
+3. Build all packages: \`pnpm build\`
+4. Start development: \`pnpm dev\`
+`;
+    await fs_extra_1.default.writeFile(path_1.default.join(projectDir, 'CLAUDE.md'), claudeMd, 'utf-8');
+    // Create README.md
+    const readme = `# ${projectName}
+
+AI Toolkit workspace for building intelligent productivity tools.
+
+## Quick Start
+
+\`\`\`bash
+# Install dependencies
+pnpm install
+
+# Generate a new MCP server
+pnpm generate:mcp my-integration
+
+# Generate a Claude command
+pnpm generate:command my-command
+
+# Build all packages
+pnpm build
+\`\`\`
+
+## What's Included
+
+- **MCP Generation**: Create FastMCP servers with one command
+- **Claude Commands**: Custom slash commands for Claude Code
+- **Claude Agents**: Specialized AI agents for your workflows
+- **Vector DB**: Semantic search and caching (Pro)
+- **Cloud Deployment**: AWS/GCP deployment templates (Pro)
+
+## Documentation
+
+- [AI Toolkit Documentation](https://ai-toolkit.dev/docs)
+- [MCP Documentation](https://modelcontextprotocol.io)
+- [Claude Code Documentation](https://docs.anthropic.com/claude-code)
+
+## License
+
+MIT
+`;
+    await fs_extra_1.default.writeFile(path_1.default.join(projectDir, 'README.md'), readme, 'utf-8');
+    // Create .gitignore
+    const gitignore = `node_modules
+dist
+.DS_Store
+*.log
+.env
+.env.local
+CLAUDE.local.md
+.ai-toolkit
+`;
+    await fs_extra_1.default.writeFile(path_1.default.join(projectDir, '.gitignore'), gitignore, 'utf-8');
+    // Create example command if full template
+    if (template === 'full') {
+        const exampleCommand = `---
+description: Search the knowledge base
+argument-hint: query
+---
+
+# Search Knowledge Base
+
+Search your vector database for relevant information.
+
+Query: $1
+
+Use semantic search to find the most relevant documents and context.
+`;
+        await fs_extra_1.default.writeFile(path_1.default.join(projectDir, 'claude', 'commands', 'search-kb.md'), exampleCommand, 'utf-8');
+    }
+}
+function printNextSteps(projectName, packageManager) {
+    console.log(picocolors_1.default.green(picocolors_1.default.bold('🎉 Project created successfully!\n')));
+    console.log(picocolors_1.default.cyan('Next steps:\n'));
+    console.log(picocolors_1.default.dim(`  cd ${projectName}`));
+    console.log(picocolors_1.default.dim(`  ${packageManager} generate:mcp github`));
+    console.log(picocolors_1.default.dim(`  ${packageManager} generate:command search-kb`));
+    console.log(picocolors_1.default.dim(`  ${packageManager} build\n`));
+    console.log(picocolors_1.default.cyan('Documentation:\n'));
+    console.log(picocolors_1.default.dim('  https://ai-toolkit.dev/docs\n'));
+    console.log(picocolors_1.default.green('Happy building! ✨\n'));
+}
+program.parse();

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@neural-tools/create",
+  "version": "0.1.3",
+  "description": "Scaffold a new Neural Tools workspace",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "create-neural-tools": "./dist/index.js"
+  },
+  "license": "SEE LICENSE IN ../../LICENSE.md",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/ai-toolkit.git",
+    "directory": "packages/create-ai-toolkit"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "inquirer": "^9.2.12",
+    "execa": "^8.0.1",
+    "fs-extra": "^11.2.0",
+    "picocolors": "^1.0.0",
+    "degit": "^2.8.4",
+    "@neural-tools/core": "0.1.3"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.5",
+    "typescript": "^5.3.3"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && chmod +x dist/index.js",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "echo 'Tests coming soon'"
+  }
+}