specmem-hardwicksoftware 3.5.99

package/scripts/pack-for-testing.sh

@@ -0,0 +1,130 @@
+#!/bin/bash
+# =============================================================================
+# PACK SPECMEM FOR PRIVATE TESTING
+# =============================================================================
+#
+# Creates a tarball for private testing WITHOUT publishing to npm.
+#
+# Installation methods:
+#   1. npm install ./specmem-hardwicksoftware-1.0.0.tgz
+#   2. npm install https://justcalljon.pro/downloads/specmem-hardwicksoftware-1.0.0.tgz
+#   3. npm install git+https://github.com/hardwicksoftware/specmem-private.git
+#
+# @author hardwicksoftwareservices
+# @website https://justcalljon.pro
+# =============================================================================
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SPECMEM_DIR="$(dirname "$SCRIPT_DIR")"
+NPM_STUB_DIR="$SPECMEM_DIR/npm-stub"
+DIST_DIR="$SPECMEM_DIR/dist-packages"
+VERSION=$(node -p "require('$NPM_STUB_DIR/package.json').version")
+
+echo "╔═══════════════════════════════════════════════════════════════╗"
+echo "║         PACKING SPECMEM FOR PRIVATE TESTING                   ║"
+echo "║         https://justcalljon.pro                               ║"
+echo "╚═══════════════════════════════════════════════════════════════╝"
+echo ""
+
+# Create dist directories
+mkdir -p "$DIST_DIR"
+mkdir -p "$DIST_DIR/core"
+
+echo "═══ Packing NPM Stub Package ═══"
+echo ""
+
+cd "$NPM_STUB_DIR"
+
+# Create npm package tarball
+echo "Creating npm package tarball..."
+npm pack --pack-destination "$DIST_DIR"
+
+TARBALL_NAME="specmem-hardwicksoftware-${VERSION}.tgz"
+echo "✓ Created: $DIST_DIR/$TARBALL_NAME"
+
+echo ""
+echo "═══ Packing Core Distribution ═══"
+echo ""
+
+# Pack the core SpecMem files for the download server
+cd "$SPECMEM_DIR"
+
+# Files to include in core package
+CORE_FILES=(
+  "bin/"
+  "dist/"
+  "claude-hooks/"
+  "scripts/first-run-model-setup.cjs"
+  "scripts/optimize-embedding-model.py"
+  "bootstrap.cjs"
+  "specmem-health.cjs"
+  "specmem.env"
+  "package.json"
+)
+
+# Create core tarball
+echo "Creating core package..."
+tar -czf "$DIST_DIR/specmem-core.tar.gz" \
+  --exclude="node_modules" \
+  --exclude=".git" \
+  --exclude="*.log" \
+  --transform="s|^|specmem/|" \
+  ${CORE_FILES[@]} 2>/dev/null || {
+  # Fallback if some files don't exist
+  tar -czf "$DIST_DIR/specmem-core.tar.gz" \
+    --exclude="node_modules" \
+    --exclude=".git" \
+    bin/ dist/ claude-hooks/ bootstrap.cjs package.json 2>/dev/null || true
+}
+
+CORE_SIZE=$(du -h "$DIST_DIR/specmem-core.tar.gz" 2>/dev/null | cut -f1 || echo "unknown")
+echo "✓ Created: specmem-core.tar.gz ($CORE_SIZE)"
+
+# Pack hooks separately
+echo "Creating hooks package..."
+tar -czf "$DIST_DIR/specmem-hooks.tar.gz" \
+  --transform="s|^claude-hooks/||" \
+  claude-hooks/ 2>/dev/null || echo "⚠ Hooks packing skipped"
+
+# Pack models if they exist
+if [ -d "$SPECMEM_DIR/models/optimized" ]; then
+  echo "Creating models package..."
+  tar -czf "$DIST_DIR/specmem-models.tar.gz" \
+    -C "$SPECMEM_DIR/models" \
+    optimized/ 2>/dev/null || echo "⚠ Models packing skipped"
+fi
+
+echo ""
+echo "═══ Packages Created ═══"
+echo ""
+ls -lh "$DIST_DIR"
+
+echo ""
+echo "╔═══════════════════════════════════════════════════════════════╗"
+echo "║                 🎉 READY FOR TESTING! 🎉                      ║"
+echo "╠═══════════════════════════════════════════════════════════════╣"
+echo "║                                                               ║"
+echo "║  OPTION 1: Local tarball install                              ║"
+echo "║    npm install -g $DIST_DIR/$TARBALL_NAME"
+echo "║                                                               ║"
+echo "║  OPTION 2: URL install (after uploading to server)            ║"
+echo "║    npm install -g https://justcalljon.pro/dl/$TARBALL_NAME"
+echo "║                                                               ║"
+echo "║  OPTION 3: Private git repo                                   ║"
+echo "║    npm install -g git+ssh://git@github.com/YOU/specmem.git    ║"
+echo "║                                                               ║"
+echo "║  OPTION 4: npm link (for development)                         ║"
+echo "║    cd $NPM_STUB_DIR && npm link"
+echo "║                                                               ║"
+echo "╚═══════════════════════════════════════════════════════════════╝"
+echo ""
+echo "Files to upload to justcalljon.pro:"
+echo "  - $DIST_DIR/specmem-core.tar.gz"
+echo "  - $DIST_DIR/specmem-hooks.tar.gz"
+echo "  - $DIST_DIR/specmem-models.tar.gz (if exists)"
+echo ""
+echo "Run the download server:"
+echo "  node $SPECMEM_DIR/server/download-server.cjs"
+echo ""

package/scripts/postinstall.cjs

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+/**
+ * SpecMem Post-Install Warning
+ * Shows root requirement notice
+ * Hardwick Software Services
+ */
+
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m',
+  dim: '\x1b[2m'
+};
+
+function rainbow(text) {
+  const rainbowColors = ['\x1b[31m', '\x1b[33m', '\x1b[32m', '\x1b[36m', '\x1b[34m', '\x1b[35m'];
+  let result = '';
+  let colorIdx = 0;
+  for (const char of text) {
+    if (char === ' ') {
+      result += char;
+    } else {
+      result += rainbowColors[colorIdx % rainbowColors.length] + char;
+      colorIdx++;
+    }
+  }
+  return result + '\x1b[0m';
+}
+
+console.log('\n' + rainbow('════════════════════════════════════════════════════════════════'));
+console.log(rainbow('                    SPECMEM INSTALLED!                           '));
+console.log(rainbow('════════════════════════════════════════════════════════════════') + '\n');
+
+console.log(`${colors.yellow}${colors.bright}⚠️  ROOT REQUIREMENT NOTICE${colors.reset}\n`);
+
+console.log(`${colors.cyan}We require root because we do a lot of stuff with dockers and`);
+console.log(`spawn mini LLMs to make sure Claude remembers.${colors.reset}\n`);
+
+console.log(`${colors.green}Sorry not sorry - we promise to never push dirty code,`);
+console.log(`but we do need you to use root!${colors.reset}\n`);
+
+console.log(`${colors.magenta}Can't use root? (We're working on it, hang tight!)${colors.reset}\n`);
+
+console.log(`${colors.dim}────────────────────────────────────────────────────────────────${colors.reset}`);
+console.log(`${colors.cyan}Get started:${colors.reset}`);
+console.log(`  ${colors.green}specmem init${colors.reset}    - Initialize SpecMem in current project`);
+console.log(`  ${colors.green}specmem setup${colors.reset}   - Full setup wizard`);
+console.log(`  ${colors.green}specmem help${colors.reset}    - Show all commands`);
+console.log(`${colors.dim}────────────────────────────────────────────────────────────────${colors.reset}`);
+console.log(`${colors.cyan}Hardwick Software Services${colors.reset} - ${colors.magenta}https://justcalljon.pro${colors.reset}\n`);

package/scripts/project-env.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# ============================================================================
+# SpecMem Project Environment Helper
+# ============================================================================
+# Source this script to set up project-scoped environment variables.
+# This ensures all SpecMem components use the same isolation paths.
+#
+# Usage:
+#   source /path/to/project-env.sh
+#   # or
+#   . /path/to/project-env.sh
+#
+# After sourcing:
+#   - SPECMEM_PROJECT_PATH: Absolute path to the project
+#   - SPECMEM_PROJECT_HASH: 12-char hash for directory naming
+#   - SPECMEM_INSTANCE_DIR: Per-project instance directory
+#   - SPECMEM_SOCKET_DIR: Socket directory for this instance
+#   - SPECMEM_LOG_DIR: Log directory for this instance
+#   - SPECMEM_OVERFLOW_DIR: Overflow queue directory
+# ============================================================================
+
+# Resolve project path (default to current working directory)
+export SPECMEM_PROJECT_PATH="${SPECMEM_PROJECT_PATH:-$(pwd)}"
+SPECMEM_PROJECT_PATH="$(cd "$SPECMEM_PROJECT_PATH" && pwd)"  # Normalize to absolute path
+
+# Generate project directory name (human-readable, for container names)
+# This matches TypeScript instanceManager.ts for readable Docker containers
+SPECMEM_PROJECT_DIR_NAME=$(basename "$SPECMEM_PROJECT_PATH" | tr '[:upper:]' '[:lower:]' | tr '_' '-' | tr -cd 'a-z0-9-')
+# Remove leading/trailing hyphens and collapse multiple hyphens
+SPECMEM_PROJECT_DIR_NAME=$(echo "$SPECMEM_PROJECT_DIR_NAME" | sed 's/--*/-/g; s/^-//; s/-$//')
+# Fallback to hash if name is empty or too short
+if [ -z "$SPECMEM_PROJECT_DIR_NAME" ] || [ ${#SPECMEM_PROJECT_DIR_NAME} -lt 2 ]; then
+    SPECMEM_PROJECT_DIR_NAME=$(echo -n "$SPECMEM_PROJECT_PATH" | sha256sum | cut -c1-12)
+fi
+export SPECMEM_PROJECT_DIR_NAME
+
+# Generate project hash (first 12 chars of SHA256) - DEPRECATED, kept for backwards compatibility
+# This matches the TypeScript constants.ts and bootstrap.cjs hash format (12 chars for consistency)
+export SPECMEM_PROJECT_HASH=$(echo -n "$SPECMEM_PROJECT_PATH" | tr '\\' '/' | sha256sum | cut -c1-12)
+
+# Set instance-scoped directories (use dir name for human-readable paths)
+export SPECMEM_INSTANCE_DIR="${HOME}/.specmem/instances/${SPECMEM_PROJECT_DIR_NAME}"
+export SPECMEM_SOCKET_DIR="${SPECMEM_INSTANCE_DIR}/sockets"
+export SPECMEM_LOG_DIR="${SPECMEM_INSTANCE_DIR}/logs"
+export SPECMEM_OVERFLOW_DIR="${SPECMEM_INSTANCE_DIR}/overflow"
+
+# Create directories if they don't exist
+mkdir -p "$SPECMEM_SOCKET_DIR" "$SPECMEM_LOG_DIR" "$SPECMEM_OVERFLOW_DIR" 2>/dev/null
+
+# Export for child processes
+export SPECMEM_PROJECT_PATH SPECMEM_PROJECT_DIR_NAME SPECMEM_PROJECT_HASH SPECMEM_INSTANCE_DIR SPECMEM_SOCKET_DIR SPECMEM_LOG_DIR SPECMEM_OVERFLOW_DIR

package/scripts/reset-db.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+# Reset database and run migrations fresh
+
+export PGPASSWORD="${PGPASSWORD:-specmem_westayunprofessional}"
+DB_HOST="${SPECMEM_DB_HOST:-localhost}"
+DB_PORT="${SPECMEM_DB_PORT:-5433}"
+DB_NAME="${SPECMEM_DB_NAME:-specmem_westayunprofessional}"
+DB_USER="${SPECMEM_DB_USER:-specmem_westayunprofessional}"
+
+echo "=== Resetting Database ==="
+echo "Host: $DB_HOST:$DB_PORT"
+echo "Database: $DB_NAME"
+echo ""
+
+# Drop all tables
+echo "Dropping existing tables..."
+psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" <<EOF
+DROP SCHEMA public CASCADE;
+CREATE SCHEMA public;
+GRANT ALL ON SCHEMA public TO "$DB_USER";
+GRANT ALL ON SCHEMA public TO public;
+EOF
+
+echo ""
+echo "Database reset. Running migrations..."
+node scripts/run-migrations.js
+
+echo ""
+echo "=== Tables After Migration ==="
+psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "\dt" | head -30

package/scripts/run-indexer.ts

@@ -0,0 +1,69 @@
+#!/usr/bin/env npx ts-node
+/**
+ * Quick codebase indexer script
+ * Runs the indexer to populate code_definitions table
+ */
+
+import { getCodebaseIndexer, resetCodebaseIndexer } from '../src/codebase/codebaseIndexer.js';
+
+async function main() {
+  console.log('=== SpecMem Codebase Indexer ===');
+  console.log(`Codebase: ${process.env.SPECMEM_CODEBASE_PATH || process.cwd()}`);
+  console.log('');
+
+  // Get indexer instance with full config
+  const indexer = getCodebaseIndexer({
+    codebasePath: process.env.SPECMEM_CODEBASE_PATH || process.cwd(),
+    extractDefinitions: true,
+    trackDependencies: true,
+    calculateComplexity: false,  // Skip complexity for speed
+    chunkCode: false,            // Skip chunking for speed
+    generateEmbeddings: false,   // We'll generate embeddings separately with fast embedder
+    watchForChanges: false,
+    batchSize: 100,
+  });
+
+  console.log('Starting full scan...');
+  const startTime = Date.now();
+
+  try {
+    await indexer.initialize();
+    const stats = indexer.getStats();
+
+    console.log('');
+    console.log('=== Scan Complete ===');
+    console.log(`Files indexed: ${stats.totalFiles}`);
+    console.log(`Definitions extracted: ${stats.totalDefinitions}`);
+    console.log(`Dependencies tracked: ${stats.totalDependencies}`);
+    console.log(`Time: ${((Date.now() - startTime) / 1000).toFixed(1)}s`);
+    console.log('');
+    console.log('Language breakdown:');
+    Object.entries(stats.languageBreakdown)
+      .sort((a, b) => b[1] - a[1])
+      .slice(0, 10)
+      .forEach(([lang, count]) => {
+        console.log(`  ${lang}: ${count} files`);
+      });
+
+    if (stats.definitionBreakdown) {
+      console.log('');
+      console.log('Definition types:');
+      Object.entries(stats.definitionBreakdown)
+        .sort((a, b) => b[1] - a[1])
+        .forEach(([type, count]) => {
+          console.log(`  ${type}: ${count}`);
+        });
+    }
+
+    await indexer.shutdown();
+    resetCodebaseIndexer();
+
+    console.log('');
+    console.log('Done! Now run fast-batch-embedder.js to generate embeddings.');
+  } catch (error) {
+    console.error('Error:', error);
+    process.exit(1);
+  }
+}
+
+main();

package/scripts/run-migrations.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * Run database migrations
+ */
+
+process.env.SPECMEM_DB_HOST = process.env.SPECMEM_DB_HOST || 'localhost';
+process.env.SPECMEM_DB_PORT = process.env.SPECMEM_DB_PORT || '5433';
+process.env.SPECMEM_DB_NAME = process.env.SPECMEM_DB_NAME || 'specmem_westayunprofessional';
+process.env.SPECMEM_DB_USER = process.env.SPECMEM_DB_USER || 'specmem_westayunprofessional';
+process.env.SPECMEM_DB_PASSWORD = process.env.SPECMEM_DB_PASSWORD || 'specmem_westayunprofessional';
+
+async function main() {
+  console.log('=== Running Database Migrations ===');
+  console.log(`Database: ${process.env.SPECMEM_DB_NAME}`);
+  console.log(`Host: ${process.env.SPECMEM_DB_HOST}:${process.env.SPECMEM_DB_PORT}`);
+  console.log('');
+
+  const { ConnectionPoolGoBrrr } = await import('../dist/db/connectionPoolGoBrrr.js');
+  const { BigBrainMigrations } = await import('../dist/db/bigBrainMigrations.js');
+
+  const dbConfig = {
+    host: process.env.SPECMEM_DB_HOST || 'localhost',
+    port: parseInt(process.env.SPECMEM_DB_PORT || '5433'),
+    database: process.env.SPECMEM_DB_NAME || 'specmem_westayunprofessional',
+    user: process.env.SPECMEM_DB_USER || 'specmem_westayunprofessional',
+    password: process.env.SPECMEM_DB_PASSWORD || 'specmem_westayunprofessional',
+    max: 10,
+    idleTimeoutMillis: 30000,
+    connectionTimeoutMillis: 10000
+  };
+
+  const pool = new ConnectionPoolGoBrrr(dbConfig);
+  const migrations = new BigBrainMigrations(pool);
+
+  try {
+    await migrations.runAllMigrations();
+    console.log('');
+    console.log('=== Migrations Complete ===');
+  } catch (error) {
+    console.error('Migration error:', error);
+    process.exit(1);
+  } finally {
+    await pool.drainThePool();
+  }
+}
+
+main();

package/scripts/setup-db.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# Setup database schema for SpecMem codebase search
+
+set -e
+
+DB_HOST="${PGHOST:-localhost}"
+DB_PORT="${PGPORT:-5433}"
+DB_NAME="${PGDATABASE:-specmem_westayunprofessional}"
+DB_USER="${PGUSER:-specmem_westayunprofessional}"
+export PGPASSWORD="${PGPASSWORD:-specmem_westayunprofessional}"
+
+echo "=== SpecMem DB Setup ==="
+echo "Host: $DB_HOST:$DB_PORT"
+echo "Database: $DB_NAME"
+echo ""
+
+# Check connection
+echo "Checking connection..."
+psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "SELECT 1;" > /dev/null
+
+# Run schema init
+echo "Running schema initialization..."
+psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -f /specmem/src/db/projectSchemaInit.sql
+
+echo ""
+echo "=== Tables Created ==="
+psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "\dt"
+
+echo ""
+echo "=== code_definitions table ==="
+psql -h "$DB_HOST" -p "$DB_PORT" -U "$DB_USER" -d "$DB_NAME" -c "\d code_definitions"
+
+echo ""
+echo "Done!"

package/scripts/setup-minimal-schema.sql

@@ -0,0 +1,143 @@
+-- Minimal schema for codebase search
+-- Uses 384 dimensions (MiniLM model)
+
+-- Extensions
+CREATE EXTENSION IF NOT EXISTS vector;
+CREATE EXTENSION IF NOT EXISTS pg_trgm;
+CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
+
+-- Codebase files table
+CREATE TABLE IF NOT EXISTS codebase_files (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    file_path TEXT NOT NULL,
+    absolute_path TEXT,
+    file_name VARCHAR(255),
+    extension VARCHAR(50),
+    language_id VARCHAR(50) DEFAULT 'unknown',
+    language_name VARCHAR(100) DEFAULT 'Unknown',
+    content TEXT,
+    content_hash VARCHAR(64),
+    size_bytes INTEGER DEFAULT 0,
+    line_count INTEGER DEFAULT 0,
+    embedding vector(384),
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW(),
+    project_path TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_codebase_files_path ON codebase_files(file_path);
+CREATE INDEX IF NOT EXISTS idx_codebase_files_language ON codebase_files(language_id);
+CREATE INDEX IF NOT EXISTS idx_codebase_files_project ON codebase_files(project_path);
+
+-- Code definitions table (functions, classes, etc.)
+CREATE TABLE IF NOT EXISTS code_definitions (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    file_id UUID REFERENCES codebase_files(id) ON DELETE CASCADE,
+    file_path TEXT NOT NULL,
+    name VARCHAR(500) NOT NULL,
+    qualified_name VARCHAR(1000),
+    definition_type VARCHAR(50) NOT NULL,
+    start_line INTEGER,
+    end_line INTEGER,
+    start_column INTEGER,
+    end_column INTEGER,
+    signature TEXT,
+    docstring TEXT,
+    return_type VARCHAR(255),
+    visibility VARCHAR(50) DEFAULT 'public',
+    is_exported BOOLEAN DEFAULT false,
+    is_async BOOLEAN DEFAULT false,
+    is_static BOOLEAN DEFAULT false,
+    is_abstract BOOLEAN DEFAULT false,
+    parent_definition_id UUID REFERENCES code_definitions(id) ON DELETE CASCADE,
+    parameters JSONB DEFAULT '[]',
+    language VARCHAR(50),
+    decorators TEXT[],
+    metadata JSONB DEFAULT '{}',
+    project_path TEXT,
+    embedding vector(384),
+    created_at TIMESTAMPTZ DEFAULT NOW(),
+    updated_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_code_definitions_file_id ON code_definitions(file_id);
+CREATE INDEX IF NOT EXISTS idx_code_definitions_file_path ON code_definitions(file_path);
+CREATE INDEX IF NOT EXISTS idx_code_definitions_name ON code_definitions(name);
+CREATE INDEX IF NOT EXISTS idx_code_definitions_type ON code_definitions(definition_type);
+CREATE INDEX IF NOT EXISTS idx_code_definitions_language ON code_definitions(language);
+CREATE INDEX IF NOT EXISTS idx_code_definitions_project ON code_definitions(project_path);
+
+-- HNSW index for semantic search (only after dimension is set!)
+CREATE INDEX IF NOT EXISTS idx_code_definitions_embedding_hnsw
+    ON code_definitions USING hnsw (embedding vector_cosine_ops)
+    WITH (m = 16, ef_construction = 64);
+
+-- Code dependencies table
+CREATE TABLE IF NOT EXISTS code_dependencies (
+    id UUID PRIMARY KEY DEFAULT uuid_generate_v4(),
+    source_file_id UUID REFERENCES codebase_files(id) ON DELETE CASCADE,
+    source_file_path TEXT NOT NULL,
+    target_path TEXT,
+    resolved_path TEXT,
+    import_type VARCHAR(50),
+    import_statement TEXT,
+    imported_names TEXT[],
+    imported_as VARCHAR(255),
+    is_default_import BOOLEAN DEFAULT false,
+    is_namespace_import BOOLEAN DEFAULT false,
+    is_type_import BOOLEAN DEFAULT false,
+    is_side_effect_import BOOLEAN DEFAULT false,
+    line_number INTEGER,
+    column_number INTEGER,
+    is_external BOOLEAN DEFAULT false,
+    is_builtin BOOLEAN DEFAULT false,
+    is_relative BOOLEAN DEFAULT false,
+    is_absolute BOOLEAN DEFAULT false,
+    is_dynamic BOOLEAN DEFAULT false,
+    package_name VARCHAR(255),
+    package_version VARCHAR(100),
+    language VARCHAR(50),
+    metadata JSONB DEFAULT '{}',
+    project_path TEXT,
+    created_at TIMESTAMPTZ DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_code_deps_source ON code_dependencies(source_file_id);
+CREATE INDEX IF NOT EXISTS idx_code_deps_target ON code_dependencies(target_path);
+CREATE INDEX IF NOT EXISTS idx_code_deps_project ON code_dependencies(project_path);
+
+-- Updated at trigger
+CREATE OR REPLACE FUNCTION update_updated_at_column()
+RETURNS TRIGGER AS $$
+BEGIN
+    NEW.updated_at = NOW();
+    RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+DO $$ BEGIN
+    CREATE TRIGGER code_definitions_updated_at
+        BEFORE UPDATE ON code_definitions
+        FOR EACH ROW
+        EXECUTE FUNCTION update_updated_at_column();
+EXCEPTION WHEN duplicate_object THEN NULL;
+END $$;
+
+DO $$ BEGIN
+    CREATE TRIGGER codebase_files_updated_at
+        BEFORE UPDATE ON codebase_files
+        FOR EACH ROW
+        EXECUTE FUNCTION update_updated_at_column();
+EXCEPTION WHEN duplicate_object THEN NULL;
+END $$;
+
+-- Verify
+SELECT
+    'code_definitions' as table_name,
+    COUNT(*) as row_count
+FROM code_definitions
+UNION ALL
+SELECT
+    'codebase_files',
+    COUNT(*)
+FROM codebase_files;

package/scripts/skills/code-review.md

@@ -0,0 +1,44 @@
+# Code Review Skill
+
+Tags: code, review, quality, best-practices
+
+## Purpose
+Perform thorough code reviews focusing on quality, maintainability, and best practices.
+
+## Review Checklist
+
+### 1. Code Quality
+- Is the code readable and well-organized?
+- Are variable and function names descriptive?
+- Is there unnecessary code duplication?
+- Are functions focused on a single responsibility?
+
+### 2. Error Handling
+- Are errors properly caught and handled?
+- Are edge cases considered?
+- Is input validation present where needed?
+
+### 3. Security
+- Are there any SQL injection vulnerabilities?
+- Is user input properly sanitized?
+- Are secrets stored securely?
+- Are there any exposed API keys?
+
+### 4. Performance
+- Are there obvious performance bottlenecks?
+- Is database access optimized?
+- Are there unnecessary loops or iterations?
+
+### 5. Testing
+- Are tests comprehensive?
+- Do tests cover edge cases?
+- Is test coverage adequate?
+
+## Response Format
+
+When reviewing code, provide:
+1. **Summary**: Overall assessment (1-2 sentences)
+2. **Strengths**: What's done well
+3. **Issues**: Problems found with severity (Critical/High/Medium/Low)
+4. **Suggestions**: Recommended improvements
+5. **Code Examples**: Corrected code snippets where applicable

package/scripts/skills/debugging.md

@@ -0,0 +1,56 @@
+# Debugging Skill
+
+Tags: debug, troubleshoot, fix, errors
+
+## Purpose
+Systematically debug issues in code, identify root causes, and provide solutions.
+
+## Debugging Process
+
+### Step 1: Understand the Problem
+- What is the expected behavior?
+- What is the actual behavior?
+- When did it start happening?
+- What changed recently?
+
+### Step 2: Reproduce the Issue
+- Can you reliably reproduce it?
+- What are the exact steps?
+- What environment/conditions trigger it?
+
+### Step 3: Gather Information
+- Check error messages and stack traces
+- Review relevant logs
+- Identify the affected code paths
+- Check input data
+
+### Step 4: Form Hypotheses
+- What could cause this behavior?
+- List potential root causes
+- Prioritize by likelihood
+
+### Step 5: Test Hypotheses
+- Add logging/breakpoints
+- Test each hypothesis
+- Eliminate unlikely causes
+
+### Step 6: Fix and Verify
+- Implement the fix
+- Test the fix thoroughly
+- Ensure no regressions
+
+## Common Debugging Techniques
+
+1. **Binary Search**: Comment out half the code, narrow down
+2. **Rubber Duck**: Explain the problem out loud
+3. **Print Debugging**: Add strategic console.log statements
+4. **Diff Analysis**: What changed between working and broken?
+5. **Minimal Reproduction**: Create smallest failing example
+
+## Response Format
+
+When debugging, provide:
+1. **Problem Summary**: What's broken
+2. **Root Cause**: Why it's broken
+3. **Solution**: How to fix it
+4. **Prevention**: How to avoid similar issues