k0ntext 3.0.0

package/templates/handlebars/continue-config.hbs

@@ -0,0 +1,116 @@
+{{!-- Continue Configuration Template --}}
+{
+  "$schema": "https://continue.dev/schema.json",
+  "projectTitle": "{{project.name}}",
+  "description": "{{project.description}}",
+  "techstack": "{{join project.tech_stack ", "}}",
+
+  "context": {
+    "providers": [
+      {
+        "name": "codebase",
+        "description": "Project codebase context"
+      }
+    ],
+    "rules": [
+      {
+        "description": "Project Communication Style",
+        "type": "markdown",
+        "content": "<communication>\n- Speak to me in a professional, technical manner\n- Provide clear explanations for code changes\n- Reference specific files and line numbers when discussing changes\n- Ask clarifying questions when requirements are ambiguous\n</communication>"
+      },
+      {
+        "description": "Filesystem Rules",
+        "type": "markdown",
+        "content": "<filesystem>\n{{#if key_files.entry_points}}- Key project files: {{join key_files.entry_points ", "}}\n{{/if}}- Models directory: {{#each architecture.layers}}{{#if (ifEquals name 'models')}}{{path}}{{/if}}{{/each}}\n- Migrations directory: {{#each architecture.layers}}{{#if (ifEquals name 'migrations')}}{{path}}{{/if}}{{/each}}\n- Treat node_modules, build, dist as read-only\n</filesystem>"
+      },
+      {
+        "description": "Coding Guidelines",
+        "type": "markdown",
+        "content": "<coding>\n- Primary language: {{project.primary_language}}\n- Framework: {{#each architecture.layers}}{{#if (ifEquals name 'framework')}}{{name}}{{/if}}{{/each}}\n- Testing framework: jest\n- Follow existing code style and patterns\n- Add type hints/annotations for all functions\n- Write tests for new functionality (target: 80% coverage)\n- Use early returns when possible\n- Avoid deep nesting (>4 levels)\n- Keep functions focused and small (<50 lines)\n</coding>"
+      },
+      {
+        "description": "Commands",
+        "type": "table",
+        "content": "| Command | Purpose |\n|---------|---------|\n| {{commands.install}} | Install dependencies |\n| {{commands.dev}} | Start development server |\n| {{commands.test}} | Run tests |\n| {{commands.build}} | Build for production |"
+      },
+      {
+        "description": "Architecture",
+        "type": "markdown",
+        "content": "<architecture>\n{{project.description}}\n\nKey patterns:\n- {{architecture.pattern}}\n{{#each architecture.layers}}\n- {{name}}: {{purpose}}\n{{/each}}\n</architecture>"
+      }
+    ]
+  },
+
+  "slashCommands": [
+    {
+      "name": "test",
+      "description": "Run tests",
+      "run": "{{commands.test}}"
+    },
+    {
+      "name": "build",
+      "description": "Build project",
+      "run": "{{commands.build}}"
+    },
+    {
+      "name": "dev",
+      "description": "Start development server",
+      "run": "{{commands.dev}}"
+    }
+  ],
+
+  "models": [
+    {
+      "title": "GPT-4",
+      "provider": "openai",
+      "model": "gpt-4"
+    },
+    {
+      "title": "Claude 3 Opus",
+      "provider": "anthropic",
+      "model": "claude-3-opus-20240229"
+    }
+  ],
+
+  "tabAutocompleteModel": {
+    "title": "DeepSeek V2",
+    "provider": "deepseek",
+    "model": "deepseek-coder"
+  },
+
+  "customCommands": [
+    {
+      "name": "explain",
+      "prompt": "Explain the selected code in detail, including its purpose and how it works."
+    },
+    {
+      "name": "refactor",
+      "prompt": "Refactor the selected code to improve readability and maintainability."
+    },
+    {
+      "name": "docs",
+      "prompt": "Generate JSDoc/TypeDoc documentation for the selected code."
+    }
+  ],
+
+  "allowYaml": true,
+
+  "maxContextTokens": 8000,
+
+  "temperature": 0.2,
+
+  "regexDenylist": [
+    ".*\\.min\\.js",
+    ".*\\.min\\.css",
+    "node_modules/.*",
+    "build/.*",
+    "dist/.*"
+  ],
+
+  "_comment": "Generated by create-universal-ai-context v{{metadata.generator_version}}",
+  "_generatedAt": "{{metadata.timestamp}}",
+  "_toolCoordination": {
+    "universalContext": ".ai-context/",
+    "regenerateCommand": "npx create-ai-context generate --ai continue"
+  }
+}

package/templates/handlebars/copilot.hbs

@@ -0,0 +1,130 @@
+{{!-- GitHub Copilot Instructions Template --}}
+{{> header}}
+
+# {{project.name}} - Copilot Instructions
+
+## Project Identity
+
+- **Name:** {{project.name}}
+- **Description:** {{project.description}}
+- **Tech Stack:** {{join project.tech_stack ", "}}
+- **Primary Language:** {{project.primary_language}}
+
+---
+
+## Architecture
+
+**Pattern:** {{architecture.pattern}}
+
+{{#if architecture.layers}}
+**Layers:**
+{{#each architecture.layers}}
+- `{{path}}` - {{purpose}}
+{{/each}}
+{{/if}}
+
+---
+
+## Key Files
+
+{{#if key_files.entry_points}}
+### Entry Points
+{{#each key_files.entry_points}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if key_files.api_routes}}
+### API Routes
+{{#each key_files.api_routes}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+{{#if key_files.config}}
+### Configuration
+{{#each key_files.config}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+
+---
+
+## Commands
+
+| Command | Script |
+|---------|--------|
+{{#each commands}}
+| {{@key}} | `{{this}}` |
+{{/each}}
+
+---
+
+{{#if workflows}}
+## Relevant Workflows
+
+{{#each workflows}}
+### {{name}}
+
+**Category:** {{category}} | **Complexity:** {{complexity}}
+
+{{description}}
+
+{{#if entry_points}}
+**Entry Points:**
+{{#each entry_points}}
+- `{{endpoint}}` - {{file}}:{{line}}
+{{/each}}
+{{/if}}
+
+{{/each}}
+{{/if}}
+
+---
+
+{{#if gotchas}}
+## Critical Gotchas
+
+{{#each gotchas}}
+### {{id}}: {{title}}
+
+**Severity:** {{severity}}
+
+{{symptom}}
+
+**Fix:** {{fix}}
+
+{{/each}}
+{{/if}}
+
+---
+
+{{#if critical_constraints}}
+## Critical Constraints
+
+{{#each critical_constraints}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+---
+
+{{#if environment.required}}
+## Environment Variables
+
+**Required:**
+{{#each environment.required}}
+- `{{this}}`
+{{/each}}
+
+{{#if environment.optional}}
+**Optional:**
+{{#each environment.optional}}
+- `{{this}}`
+{{/each}}
+{{/if}}
+{{/if}}
+
+---
+
+{{{coordination.footer}}}

package/templates/handlebars/partials/gotcha-list.hbs

@@ -0,0 +1,11 @@
+{{!-- Reusable gotcha list partial --}}
+{{#each gotchas}}
+### {{id}}: {{title}}
+
+**Severity:** {{severity}}
+
+{{symptom}}
+
+**Fix:** {{truncate fix 100}}
+
+{{/each}}

package/templates/handlebars/partials/header.hbs

@@ -0,0 +1,3 @@
+{{!-- Reusable header partial with tool coordination --}}
+{{{metadata.header}}}
+<!-- Generated: {{metadata.timestamp}} | Version: {{metadata.generator_version}} -->

package/templates/handlebars/partials/workflow-summary.hbs

@@ -0,0 +1,16 @@
+{{!-- Reusable workflow summary partial --}}
+{{#each workflows}}
+### {{name}}
+
+**Category:** {{category}} | **Complexity:** {{complexity}}
+
+{{description}}
+
+{{#if entry_points}}
+**Key Entry Points:**
+{{#each (first entry_points 5)}}
+- `{{endpoint}}` - {{file}}:{{line}}
+{{/each}}
+{{/if}}
+
+{{/each}}

package/templates/handlebars/windsurf-rules.hbs

@@ -0,0 +1,69 @@
+{{!-- Windsurf Cascade Rules Template --}}
+# {{project.name}} - Windsurf Cascade Rules
+
+**Tech Stack:** {{join project.tech_stack ", "}}
+**Status:** Active
+
+<communication>
+- Speak to me in a professional, technical manner
+- Provide clear explanations for code changes
+- Reference specific files and line numbers when discussing changes
+- Ask clarifying questions when requirements are ambiguous
+</communication>
+
+<filesystem>
+{{#if key_files.entry_points}}
+- Key project files: {{join key_files.entry_points ", "}}
+{{/if}}
+- Models directory: {{#each architecture.layers}}{{#if (ifEquals name 'models')}}{{path}}{{/if}}{{/each}}
+- Migrations directory: {{#each architecture.layers}}{{#if (ifEquals name 'migrations')}}{{path}}{{/if}}{{/each}}
+- Treat node_modules, build, dist as read-only
+</filesystem>
+
+<coding>
+- Primary language: {{project.primary_language}}
+- Framework: {{#each architecture.layers}}{{#if (ifEquals name 'framework')}}{{name}}{{/if}}{{/each}}
+- Testing framework: jest
+- Follow existing code style and patterns
+- Add type hints/annotations for all functions
+- Write tests for new functionality (target: 80% coverage)
+- Use early returns when possible
+- Avoid deep nesting (>4 levels)
+- Keep functions focused and small (<50 lines)
+</coding>
+
+<commands>
+| Command | Purpose |
+|---------|---------|
+| {{commands.install}} | Install dependencies |
+| {{commands.dev}} | Start development server |
+| {{commands.test}} | Run tests |
+| {{commands.build}} | Build for production |
+</commands>
+
+<architecture>
+{{project.description}}
+
+Key patterns:
+- {{architecture.pattern}}
+{{#each architecture.layers}}
+- {{name}}: {{purpose}}
+{{/each}}
+</architecture>
+
+<testing>
+- Write tests before implementing features
+- Use jest for mocking
+- Test edge cases and error conditions
+- Keep tests independent and fast
+</testing>
+
+<security>
+- Never commit secrets or API keys
+- Validate all user inputs
+- Use parameterized queries to prevent injection
+- Follow OWASP security guidelines
+</security>
+
+---
+{{{coordination.footer}}}

package/templates/hooks/post-commit.hbs

@@ -0,0 +1,28 @@
+#!/bin/bash
+# Post-commit hook for AI context sync
+# This hook updates sync state after successful commits
+# Does NOT regenerate files to avoid creating uncommitted changes
+
+# Don't block commit if this fails
+set +e
+
+# Check if k0ntext binary is available
+if ! command -v create-k0ntext &> /dev/null; then
+    # Try npx
+    if command -v npx &> /dev/null; then
+        K0NTEXT_CMD="npx create-universal-k0ntext"
+    else
+        exit 0
+    fi
+else
+    K0NTEXT_CMD="create-k0ntext"
+fi
+
+# Update sync state only (no file regeneration to avoid creating uncommitted changes)
+# Use sync:state instead of sync:all to prevent the revision loop bug
+(
+    sleep 1  # Wait a bit to not interfere with commit
+    $AI_CONTEXT_CMD sync:state --quiet > /dev/null 2>&1
+) &
+
+exit 0

package/templates/hooks/pre-commit.hbs

@@ -0,0 +1,46 @@
+#!/bin/bash
+# Pre-commit hook for AI context sync
+# This hook checks if AI tool contexts are out of sync
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+GREEN='\033[0;32m'
+NC='\033[0m' # No Color
+
+# Check if k0ntext binary is available
+if ! command -v create-k0ntext &> /dev/null; then
+    # Try npx
+    if command -v npx &> /dev/null; then
+        K0NTEXT_CMD="npx create-universal-k0ntext"
+    else
+        echo -e "${YELLOW}Warning: create-k0ntext not found. Skipping sync check.${NC}"
+        exit 0
+    fi
+else
+    K0NTEXT_CMD="create-k0ntext"
+fi
+
+# Run sync check
+echo -e "${GREEN}Checking AI context sync status...${NC}"
+
+# Check for out-of-sync contexts
+CHECK_OUTPUT=$($K0NTEXT_CMD sync:check 2>&1)
+CHECK_EXIT_CODE=$?
+
+if [ $CHECK_EXIT_CODE -ne 0 ]; then
+    echo -e "${RED}AI contexts are out of sync!${NC}"
+    echo ""
+    echo "$CHECK_OUTPUT"
+    echo ""
+    echo -e "${YELLOW}To sync all contexts, run:${NC}"
+    echo "  $K0NTEXT_CMD sync:all"
+    echo ""
+    echo -e "${YELLOW}To skip this check, use: git commit --no-verify${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}AI contexts are in sync${NC}"
+exit 0