@agentskillkit/agent-skills 1.0.1 → 3.2.2

package/.agent/skills/git-conventions/scripts/format-commit.js

@@ -1,393 +0,0 @@
-#!/usr/bin/env node
-/**
- * CoinPika Commit Message Formatter
- * 
- * Interactive CLI to format commit messages following Conventional Commits
- * with CoinPika doctrine tags.
- * 
- * Usage: node format-commit.js [--quick "message"]
- * 
- * @version 1.2.0
- * @author DataGuruIn
- */
-
-const readline = require('readline');
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-const yaml = require('js-yaml');
-
-// ============================================================================
-// CONFIGURATION
-// ============================================================================
-
-const SKILL_ROOT = path.resolve(__dirname, '..');
-const CONFIG_PATH = path.join(SKILL_ROOT, 'metadata', 'commit-config.yaml');
-
-function loadConfiguration() {
-    try {
-        if (!fs.existsSync(CONFIG_PATH)) {
-            console.warn('⚠️  Configuration file not found, using internal defaults.');
-            return null;
-        }
-        const fileContents = fs.readFileSync(CONFIG_PATH, 'utf8');
-        return yaml.load(fileContents);
-    } catch (e) {
-        console.error('❌ Failed to load configuration:', e);
-        return null;
-    }
-}
-
-// Fallback defaults in case config is missing
-const DEFAULT_CONFIG = {
-    commitTypes: [
-        { value: 'feat', description: 'New feature or capability' },
-        { value: 'fix', description: 'Bug fix' },
-        { value: 'refactor', description: 'Code refactor without behavior change' },
-        { value: 'perf', description: 'Performance improvement' },
-        { value: 'style', description: 'Code style/formatting (no logic change)' },
-        { value: 'docs', description: 'Documentation only' },
-        { value: 'test', description: 'Adding or updating tests' },
-        { value: 'chore', description: 'Build process, dependencies, tooling' },
-        { value: 'doctrine', description: 'Constitutional/doctrinal enforcement' },
-    ],
-    scopes: [
-        { value: 'api', description: 'Backend API' },
-        { value: 'data', description: 'Data pipeline or persistence' },
-        { value: 'chart', description: 'Chart components' },
-        { value: 'mobile', description: 'Mobile UI/gestures' },
-        { value: 'worker', description: 'Background jobs/workers' },
-        { value: 'cache', description: 'Caching layer' },
-        { value: 'auth', description: 'Authentication' },
-        { value: 'ui', description: 'General UI components' },
-    ],
-    doctrines: [
-        { value: 'Law-1', description: 'Truth Ownership - Backend owns truth' },
-        { value: 'Law-2', description: 'Historical Integrity - Data is immutable' },
-        { value: 'Law-3', description: 'Realtime Ephemerality - Separate realtime/historical' },
-        { value: 'Law-4', description: 'Chart Truthfulness - Charts from backend only' },
-        { value: 'Architecture', description: 'System boundaries' },
-        { value: 'Performance', description: 'Caching & optimization' },
-        { value: 'Frontend-Mobile', description: 'Mobile UX standards' },
-        { value: 'Commercial', description: 'Commercial guardrails' },
-    ],
-    scopeMapping: {
-        'api': ['Law-1', 'Architecture', 'Performance'],
-        'data': ['Law-1', 'Law-2', 'Architecture'],
-        'chart': ['Law-3', 'Law-4'],
-        'mobile': ['Frontend-Mobile'],
-        'worker': ['Performance', 'Architecture'],
-        'cache': ['Performance'],
-    }
-};
-
-const config = loadConfiguration() || DEFAULT_CONFIG;
-
-const COMMIT_TYPES = config.commitTypes || DEFAULT_CONFIG.commitTypes;
-const SCOPES = config.scopes || DEFAULT_CONFIG.scopes;
-const DOCTRINES = config.doctrines || DEFAULT_CONFIG.doctrines;
-const SCOPE_DOCTRINE_MAP = config.scopeMapping || DEFAULT_CONFIG.scopeMapping;
-
-
-// ============================================================================
-// UTILITIES
-// ============================================================================
-
-function getChangedFiles() {
-    try {
-        const output = execSync('git diff --cached --name-only', { encoding: 'utf8' });
-        return output.trim().split('\n').filter(Boolean);
-    } catch {
-        return [];
-    }
-}
-
-function suggestScope(files) {
-    // Naive suggestion logic - could also be moved to config (regex mapping) but keeping simple for now
-    for (const file of files) {
-        const lower = file.toLowerCase();
-        // Check against known scopes if they match file path parts
-        for (const scope of SCOPES) {
-            if (lower.includes(scope.value)) return scope.value;
-        }
-
-        // Manual fallbacks from original script if not covered by scope names
-        if (lower.includes('server')) return 'api';
-        if (lower.includes('graph')) return 'chart';
-        if (lower.includes('gesture')) return 'mobile';
-        if (lower.includes('db')) return 'data';
-    }
-    return null;
-}
-
-function suggestDoctrines(scope) {
-    return SCOPE_DOCTRINE_MAP[scope] || [];
-}
-
-// ============================================================================
-// INTERACTIVE MODE
-// ============================================================================
-
-async function prompt(question) {
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout
-    });
-
-    return new Promise(resolve => {
-        rl.question(question, answer => {
-            rl.close();
-            resolve(answer.trim());
-        });
-    });
-}
-
-async function selectFromList(title, items, defaultValue = null) {
-    console.log(`\n${title}`);
-    items.forEach((item, i) => {
-        const marker = defaultValue === item.value ? ' (suggested)' : '';
-        console.log(`  ${i + 1}. ${item.value} - ${item.description}${marker}`);
-    });
-    console.log(`  0. Skip/None`);
-
-    const answer = await prompt('\nSelect (number): ');
-    const idx = parseInt(answer, 10);
-
-    if (idx === 0 || isNaN(idx)) return null;
-    return items[idx - 1]?.value || null;
-}
-
-async function multiSelectFromList(title, items, suggested = []) {
-    console.log(`\n${title}`);
-    items.forEach((item, i) => {
-        const marker = suggested.includes(item.value) ? ' ★' : '';
-        console.log(`  ${i + 1}. ${item.value} - ${item.description}${marker}`);
-    });
-    console.log(`  (Enter comma-separated numbers, e.g., 1,3,4)`);
-    console.log(`  (Press Enter to skip)`);
-
-    const answer = await prompt('\nSelect: ');
-    if (!answer) return [];
-
-    const indices = answer.split(',').map(s => parseInt(s.trim(), 10));
-    return indices
-        .filter(i => !isNaN(i) && i > 0 && i <= items.length)
-        .map(i => items[i - 1].value);
-}
-
-async function interactiveMode() {
-    console.log('\n🔧 CoinPika Commit Message Formatter\n');
-    console.log('─'.repeat(50));
-
-    // Detect context
-    const changedFiles = getChangedFiles();
-    if (changedFiles.length > 0) {
-        console.log(`\n📁 Staged files:`);
-        changedFiles.slice(0, 5).forEach(f => console.log(`   - ${f}`));
-        if (changedFiles.length > 5) {
-            console.log(`   ... and ${changedFiles.length - 5} more`);
-        }
-    }
-
-    const suggestedScope = suggestScope(changedFiles);
-
-    // Step 1: Type
-    const type = await selectFromList('Select commit type:', COMMIT_TYPES);
-    if (!type) {
-        console.log('❌ Type is required');
-        process.exit(1);
-    }
-
-    // Step 2: Scope
-    const scope = await selectFromList('Select scope (optional):', SCOPES, suggestedScope);
-
-    // Step 3: Description
-    const description = await prompt('\nEnter description (imperative mood, lowercase, no period):\n> ');
-    if (!description) {
-        console.log('❌ Description is required');
-        process.exit(1);
-    }
-
-    // Step 4: Breaking change
-    const breaking = await prompt('\nIs this a breaking change? (y/N): ');
-    const isBreaking = breaking.toLowerCase() === 'y';
-
-    // Step 5: Doctrine tags
-    const suggestedDoctrines = scope ? suggestDoctrines(scope) : [];
-    const doctrines = await multiSelectFromList(
-        'Select applicable doctrines:',
-        DOCTRINES,
-        suggestedDoctrines
-    );
-
-    // Step 6: Body (optional)
-    console.log('\nEnter body (optional, press Enter twice to finish):');
-    let body = '';
-    const bodyRl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout
-    });
-
-    let emptyLines = 0;
-    for await (const line of bodyRl) {
-        if (line === '') {
-            emptyLines++;
-            if (emptyLines >= 2) break;
-        } else {
-            emptyLines = 0;
-            body += line + '\n';
-        }
-    }
-    bodyRl.close();
-    body = body.trim();
-
-    // Build message
-    let message = type;
-    if (scope) message += `(${scope})`;
-    if (isBreaking) message += '!';
-    message += `: ${description}`;
-
-    if (doctrines.length > 0) {
-        message += ` [doctrine: ${doctrines.join(', ')}]`;
-    }
-
-    if (body) {
-        message += `\n\n${body}`;
-    }
-
-    if (isBreaking) {
-        message += `\n\nBREAKING CHANGE: ${description}`;
-    }
-
-    // Output
-    console.log('\n' + '═'.repeat(50));
-    console.log('📝 Generated Commit Message:');
-    console.log('═'.repeat(50));
-    console.log(`\n${message}\n`);
-    console.log('═'.repeat(50));
-
-    // Copy option
-    const copy = await prompt('\nCopy to clipboard? (Y/n): ');
-    if (copy.toLowerCase() !== 'n') {
-        try {
-            if (process.platform === 'win32') {
-                execSync(`echo ${message.replace(/\n/g, '& echo.')} | clip`);
-            } else if (process.platform === 'darwin') {
-                execSync(`echo "${message}" | pbcopy`);
-            } else {
-                execSync(`echo "${message}" | xclip -selection clipboard`);
-            }
-            console.log('✅ Copied to clipboard!');
-        } catch {
-            console.log('⚠️  Could not copy to clipboard');
-        }
-    }
-
-    // Commit option
-    const commit = await prompt('Run git commit with this message? (y/N): ');
-    if (commit.toLowerCase() === 'y') {
-        try {
-            execSync(`git commit -m "${message.replace(/"/g, '\\"')}"`, { stdio: 'inherit' });
-        } catch {
-            console.log('⚠️  Git commit failed');
-        }
-    }
-
-    console.log('\n' + '─'.repeat(50));
-    console.log('P.S. ⚡ Formatted by CoinPika Commit Engine');
-}
-
-// ============================================================================
-// QUICK MODE
-// ============================================================================
-
-function quickFormat(input) {
-    // Parse input: "type(scope): message"
-    const match = input.match(/^(\w+)(?:\((\w+)\))?(!)?:\s*(.+)$/);
-
-    if (!match) {
-        console.log('❌ Invalid format. Expected: type(scope): description');
-        console.log('   Example: feat(api): add caching layer');
-        process.exit(1);
-    }
-
-    const [, type, scope, breaking, description] = match;
-
-    // Validate type
-    if (!COMMIT_TYPES.find(t => t.value === type)) {
-        console.log(`❌ Invalid type: ${type}`);
-        console.log(`   Valid types: ${COMMIT_TYPES.map(t => t.value).join(', ')}`);
-        process.exit(1);
-    }
-
-    // Suggest doctrines
-    const suggestedDoctrines = scope ? suggestDoctrines(scope) : [];
-
-    let message = input;
-    if (suggestedDoctrines.length > 0) {
-        message += ` [doctrine: ${suggestedDoctrines.join(', ')}]`;
-    }
-
-    console.log('\n📝 Formatted Message:');
-    console.log(`\n${message}\n`);
-
-    if (suggestedDoctrines.length > 0) {
-        console.log(`💡 Suggested doctrines based on scope "${scope}":`);
-        suggestedDoctrines.forEach(d => {
-            const doc = DOCTRINES.find(x => x.value === d);
-            console.log(`   - ${d}: ${doc?.description || ''}`);
-        });
-    }
-}
-
-// ============================================================================
-// CLI
-// ============================================================================
-
-function printHelp() {
-    console.log(`
-CoinPika Commit Message Formatter v1.2.0
-
-USAGE:
-  node format-commit.js              Interactive mode
-  node format-commit.js --quick "..."  Quick format
-  node format-commit.js --help       Show help
-
-OPTIONS:
-  --quick   Format a quick message with doctrine suggestions
-  --help    Show this help
-
-EXAMPLES:
-  node format-commit.js
-  node format-commit.js --quick "feat(api): add caching layer"
-
-COMMIT TYPES:
-  ${COMMIT_TYPES.map(t => t.value).join(', ')}
-
-SCOPES:
-  ${SCOPES.map(s => s.value).join(', ')}
-`);
-}
-
-async function main() {
-    const args = process.argv.slice(2);
-
-    if (args.includes('--help')) {
-        printHelp();
-        process.exit(0);
-    }
-
-    if (args.includes('--quick')) {
-        const idx = args.indexOf('--quick');
-        const message = args[idx + 1];
-        if (!message) {
-            console.log('❌ --quick requires a message');
-            process.exit(1);
-        }
-        quickFormat(message);
-    } else {
-        await interactiveMode();
-    }
-}
-
-main().catch(console.error);

package/.agent/skills/git-conventions/scripts/validate-commit-msg.sh

@@ -1,27 +0,0 @@
-#!/bin/sh
-
-MESSAGE=$(cat "$1")
-
-# Check for doctrine tag when needed
-if echo "$MESSAGE" | grep -qiE '(api|chart|data|mobile|backend)'; then
-  if ! echo "$MESSAGE" | grep -q '\[doctrine:'; then
-    echo "ERROR: Changes to api/chart/data/mobile/backend require [doctrine: ...] tag"
-    echo ""
-    echo "Examples:"
-    echo "  [doctrine: Law-2]"
-    echo "  [doctrine: Architecture]"
-    echo "  [doctrine: Performance]"
-    exit 1
-  fi
-fi
-
-# Check conventional commit format
-if ! echo "$MESSAGE" | grep -qE '^(feat|fix|docs|style|refactor|perf|test|chore|doctrine)(\(.+\))?!?:'; then
-  echo "ERROR: Commit message must follow Conventional Commits format"
-  echo ""
-  echo "Format: <type>[scope]: <description>"
-  echo "Example: feat(api): add caching layer"
-  exit 1
-fi
-
-exit 0

package/.agent/skills/governance/.skill-source.json

@@ -1,8 +0,0 @@
-{
-  "repo": "dataguruin/agent-skills",
-  "skill": "coinpika-doctrine-pack",
-  "ref": null,
-  "checksum": "545e1b627f6efb912cc9095a12bc745d999029ad112d7bcd266dd71e79f9bc3b",
-  "installedAt": "2026-01-24T11:02:40.686Z",
-  "method": "symlink"
-}

package/.agent/skills/governance/CHANGELOG.md

@@ -1,222 +0,0 @@
-# 📜 CoinPika Doctrine Pack — CHANGELOG
-
-All notable changes to the **CoinPika Doctrine Pack** are documented in this file.
-
-This project follows **strict versioning and constitutional governance**.  
-Changes are **rare by design**.
-
-Any modification without an entry here  
-is considered a **governance violation**.
-
----
-
-## [v1.1.0] — 2026-01-24  
-### 🚀 PROGRESSIVE DISCLOSURE COMPLETE
-
-This release completes the **100/100 Antigravity Compatibility Score**.
-
----
-
-### 🔧 Scripts Enhancement
-- Added **audit_pr.v2.js** — Functional PR audit with pattern matching
-  - Doctrine violation detection
-  - JSON output support
-  - CI/CD integration ready
-- Added **validate_doctrine.js** — Single file/directory validator
-  - Multi-doctrine support
-  - Configurable severity levels
-- Added **format-commit.js** — Interactive commit formatter
-  - Auto-suggests doctrine tags
-  - Scope-to-doctrine mapping
-
----
-
-### 📂 Progressive Disclosure Expansion
-- Added `coinpika-pr-reviewer/metadata/` directory
-  - `intent-triggers.yaml` — Skill activation patterns
-  - `doctrine-mapping.yaml` — File pattern to doctrine mapping
-- Added `coinpika-commit-formatter/metadata/` directory
-  - `intent-triggers.yaml`
-  - `scope-mapping.yaml`
-- Added `coinpika-commit-formatter/enforcement/` directory
-  - `commit-validation-rules.md`
-
----
-
-### 📚 Resources Enrichment
-- Expanded `coinpika-pr-reviewer/resources/links.md`
-  - GitHub Actions, GitLab CI, Conventional Comments
-  - Security scanning tools
-- Expanded `coinpika-commit-formatter/resources/references.md`
-  - Conventional Commits, Semantic Versioning
-  - Git tools and changelog generation
-- Added `coinpika-commit-formatter/resources/BEST_PRACTICES.md`
-  - CoinPika-specific commit guidelines
-  - Anti-patterns to avoid
-
----
-
-### 📝 Examples Enhancement
-- Added `coinpika-pr-reviewer/examples/approved-pr/`
-- Added `coinpika-pr-reviewer/examples/rejected-pr/`
-- Added `coinpika-commit-formatter/examples/good-commits.md`
-- Added `coinpika-commit-formatter/examples/bad-commits.md`
-
----
-
-### 📊 Compatibility Score
-| Metric | v1.0.0 | v1.1.0 |
-|--------|--------|--------|
-| Overall Score | 85/100 | **100/100** |
-| Scripts Functional | 60% | 100% |
-| Progressive Disclosure | 80% | 100% |
-| Resources Depth | 70% | 100% |
-
----
-
-## [v1.0.0] — 2026-01-23  
-### 🎉 OFFICIAL INITIAL RELEASE
-
-This release establishes the **foundational constitutional system** governing CoinPika.
-
-It defines how CoinPika is:
-- Designed
-- Implemented
-- Reviewed
-- Scaled
-- Governed (human + AI)
-
-This version is declared **LOCKED**.
-
----
-
-### 👑 Supreme Constitution
-- Added **CoinPika Master Constitution**
-  - Prime Directives
-  - System Laws
-  - Decision precedence
-  - Controlled self-improvement rules
-
----
-
-### 🏛️ Architecture & Data Truth
-- Added **Architecture Doctrine**
-  - System boundaries
-  - Ownership rules
-  - Scalability invariants
-- Added **Backend Data Engine Doctrine**
-  - Ingestion taxonomy
-  - Caching and cost control
-  - External dependency isolation
-- Added **Chart Data Doctrine**
-  - Historical immutability
-  - Realtime separation
-  - Financial truth enforcement
-
----
-
-### 📱 Frontend & UX Systems
-- Added **Frontend Mobile Doctrine**
-  - Mobile-first invariants
-  - Scroll ownership
-  - Structural hierarchy
-- Added **Swipe Tabs Doctrine**
-  - Universal swipe implementation
-  - Gesture arbitration rules
-  - iOS-safe interaction guarantees
-
----
-
-### ⚡ Performance & Stability
-- Added **Performance Doctrine**
-  - Cache-first rendering
-  - Background freshness
-  - Stability over freshness
-  - Perceived performance prioritization
-
----
-
-### 💼 Commercial & Enterprise Safety
-- Added **Commercial Guardrails Doctrine**
-  - Breaking change policy
-  - Blast radius awareness
-  - Reversibility requirements
-
----
-
-### 🛡️ Review & Enforcement
-- Added **Code Review Doctrine**
-  - Reviewer authority
-  - Mandatory rejection conditions
-- Added **Frontend Gesture Review Checklist**
-  - Hard gate for swipe & scroll changes
-
----
-
-### 🤖 AI & Agent Governance
-- Added **Learning Engine Doctrine**
-  - Controlled reasoning improvement
-  - Explicit learning boundaries
-- Added **Agent Enforcement Protocol**
-  - Proposal-only AI operation
-  - Zero-trust agent model
-- Added **Agent System Prompt**
-  - Constitutional binding for all agents
-
----
-
-### 🏷️ Controlled Evolution & Incident Handling
-- Added **v1.1 Change Proposal Template**
-  - Formal process for future doctrine changes
-- Added **Doctrine Violation Playbook**
-  - Severity levels (SEV-1 / SEV-2 / SEV-3)
-  - Incident response and remediation rules
-
----
-
-### 🧠 Antigravity / Google Skills Integration
-- Added **SKILL.md** as single entry point
-- Implemented **Progressive Disclosure architecture**
-- Added **metadata/**
-  - `precedence.yaml` for authority resolution
-  - `scope-map.yaml` for automatic doctrine routing
-- Packaged as **directory-based Antigravity Skill**
-
----
-
-### 📦 Distribution
-- Published **single bundled ZIP**
-  - `coinpika-doctrine-pack-antigravity.zip`
-- Supports:
-  - Workspace scope
-  - Global scope
-  - Antigravity / Gemini / Claude / GPT agents
-
----
-
-### 🔒 Governance Status
-- All doctrine files marked **LOCKED**
-- All changes require:
-  - Explicit Change Proposal
-  - Constitutional review
-  - Version bump
-
----
-
-## Versioning Policy
-
-- **MAJOR** (v2.0): Constitutional or Prime Directive changes
-- **MINOR** (v1.1): Doctrine evolution via approved proposal
-- **PATCH** (v1.0.x): Clarifications only (no behavior change)
-
----
-
-## Enforcement Notice
-
-If a behavior exists in the system  
-that is not documented in this changelog,  
-it is considered **undefined and unsafe**.
-
----
-
-**End of Changelog**