@allternit/gizzi-code 1.0.0 → 1.0.1

package/src/context/pack-builder.js

@@ -1,281 +0,0 @@
-/**
- * Gizzi Context Pack Builder
- *
- * Builds structured context packs from workspace files
- * Production-quality implementation matching Allternit platform
- */
-// ============================================================================
-// File Classification
-// ============================================================================
-export function classifyFile(filePath) {
-    const lower = filePath.toLowerCase();
-    if (lower.endsWith('manifest.json'))
-        return 'manifest';
-    if (lower.includes('/brain/'))
-        return 'brain';
-    if (lower.includes('/memory/'))
-        return 'memory';
-    if (lower.endsWith('soul.md'))
-        return 'soul';
-    if (lower.includes('/identity/identity.md'))
-        return 'identity';
-    if (lower.includes('/identity/user.md'))
-        return 'user';
-    if (lower.includes('/identity/voice.md'))
-        return 'voice';
-    if (lower.includes('/identity/policy.md'))
-        return 'policy';
-    if (lower.includes('/governance/playbook.md'))
-        return 'playbook';
-    if (lower.includes('/governance/tools.md'))
-        return 'tools';
-    if (lower.includes('/governance/heartbeat.md'))
-        return 'heartbeat';
-    if (lower.includes('/governance/system.md'))
-        return 'system';
-    if (lower.includes('/governance/channels.md'))
-        return 'channels';
-    if (lower.includes('/skills/'))
-        return 'skill';
-    if (lower.includes('/business/'))
-        return 'business';
-    if (lower.endsWith('.json') || lower.endsWith('.yaml') || lower.endsWith('.yml'))
-        return 'config';
-    return 'knowledge';
-}
-// ============================================================================
-// SOUL.md Parser
-// ============================================================================
-export function parseSoulMd(content) {
-    const lines = content.split('\n');
-    const trustTiers = {
-        tier1: { level: 1, name: 'Foundation', rules: [], enforce: 'always' },
-        tier2: { level: 2, name: 'Contextual', rules: [], enforce: 'contextual' },
-        tier3: { level: 3, name: 'Permission Required', rules: [], enforce: 'permission' },
-    };
-    const identity = {
-        personalityTraits: [],
-    };
-    let currentTier = null;
-    let inSelfAwareness = false;
-    for (const line of lines) {
-        const trimmed = line.trim();
-        if (trimmed.match(/^#+\s*Tier\s*1/i)) {
-            currentTier = 1;
-        }
-        else if (trimmed.match(/^#+\s*Tier\s*2/i)) {
-            currentTier = 2;
-        }
-        else if (trimmed.match(/^#+\s*Tier\s*3/i)) {
-            currentTier = 3;
-        }
-        else if (trimmed.match(/^#+\s*Self-Awareness/i)) {
-            inSelfAwareness = true;
-            currentTier = null;
-        }
-        if (currentTier && trimmed.match(/^[-\*✅]\s+/)) {
-            const rule = trimmed.replace(/^[-\*✅]\s+/, '');
-            trustTiers[`tier${currentTier}`].rules.push(rule);
-        }
-        if (inSelfAwareness && trimmed.startsWith('I am')) {
-            identity.backstory = trimmed;
-        }
-    }
-    return { trustTiers, identity };
-}
-// ============================================================================
-// HEARTBEAT.md Parser
-// ============================================================================
-export function parseHeartbeatMd(content) {
-    const lines = content.split('\n');
-    const tasks = [];
-    let currentFrequency = 'daily';
-    for (const line of lines) {
-        const trimmed = line.trim();
-        if (trimmed.match(/^#+\s*Daily/i)) {
-            currentFrequency = 'daily';
-        }
-        else if (trimmed.match(/^#+\s*Weekly/i)) {
-            currentFrequency = 'weekly';
-        }
-        else if (trimmed.match(/^#+\s*Monthly/i)) {
-            currentFrequency = 'monthly';
-        }
-        else if (trimmed.match(/^#+\s*On\s+Session\s+Start/i)) {
-            currentFrequency = 'on-session-start';
-        }
-        const taskMatch = trimmed.match(/^-\s*\[([ xX])\]\s*(.+)/);
-        if (taskMatch) {
-            tasks.push({
-                id: `task-${Date.now()}-${tasks.length}`,
-                frequency: currentFrequency,
-                action: taskMatch[2].trim(),
-                lastExecuted: taskMatch[1].toLowerCase() === 'x' ? new Date().toISOString() : undefined,
-            });
-        }
-    }
-    return tasks;
-}
-// ============================================================================
-// System Prompt Builder
-// ============================================================================
-export function buildSystemPrompt(pack) {
-    const sections = [];
-    // Identity
-    sections.push(`# Agent Identity
-
-You are ${pack.identity.name}.
-
-## Purpose
-${pack.identity.purpose}
-
-## Backstory
-${pack.identity.backstory}
-
-## Personality Traits
-${pack.identity.personalityTraits.map(t => `- ${t}`).join('\n')}`);
-    // Trust Tiers (CRITICAL)
-    sections.push(`# Trust & Safety (MUST FOLLOW)
-
-## Tier 1 - Foundation (ALWAYS APPLY)
-${pack.trustTiers.tier1.rules.map(r => `- ${r}`).join('\n')}
-
-## Tier 2 - Contextual (APPLY WHEN RELEVANT)
-${pack.trustTiers.tier2.rules.map(r => `- ${r}`).join('\n')}
-
-## Tier 3 - Permission Required (ASK USER FIRST)
-${pack.trustTiers.tier3.rules.map(r => `- ${r}`).join('\n')}
-
-### BEFORE ANY ACTION:
-1. Check if action violates Tier 1 → NEVER DO
-2. Check if action matches Tier 2 → APPLY IF CONTEXT FITS  
-3. Check if action requires Tier 3 → ASK USER PERMISSION`);
-    // Governance
-    if (pack.governance.playbook) {
-        sections.push(`# Governance & Procedures
-
-${pack.governance.playbook}`);
-    }
-    // Tools
-    if (pack.governance.availableTools.length > 0) {
-        sections.push(`# Available Tools
-
-${pack.governance.availableTools.map(t => `- **${t.name}**: ${t.description}${t.requiresPermission ? ' (Requires Permission)' : ''}`).join('\n')}`);
-    }
-    // Hard Bans
-    if (pack.governance.hardBans.length > 0) {
-        sections.push(`# Hard Bans (NEVER DO THESE)
-
-${pack.governance.hardBans.map(b => `- ❌ ${b}`).join('\n')}`);
-    }
-    // Voice
-    sections.push(`# Voice & Communication Style
-
-${pack.voice.style}
-
-## Communication Rules
-${pack.voice.rules.map(r => `- ${r}`).join('\n')}`);
-    // Memory
-    if (pack.memory.brain || pack.memory.activeTasks.length > 0) {
-        sections.push(`# Current Context
-
-## Active Tasks
-${pack.memory.activeTasks.map(t => `- ${t}`).join('\n') || 'None'}
-
-## Key Lessons
-${pack.memory.lessons.map(l => `- ${l}`).join('\n') || 'None'}`);
-    }
-    return sections.join('\n\n---\n\n');
-}
-export function buildContextPack(options) {
-    const { sessionId, agentId, agentName, files } = options;
-    // Parse files
-    const soulContent = files.has('.allternit/identity/SOUL.md')
-        ? parseSoulMd(files.get('.allternit/identity/SOUL.md'))
-        : {
-            trustTiers: {
-                tier1: { level: 1, name: 'Foundation', rules: ['Be helpful and accurate'], enforce: 'always' },
-                tier2: { level: 2, name: 'Contextual', rules: ['Adapt to context'], enforce: 'contextual' },
-                tier3: { level: 3, name: 'Permission Required', rules: ['Execute code'], enforce: 'permission' },
-            },
-            identity: { personalityTraits: ['helpful', 'accurate'] }
-        };
-    const heartbeatContent = files.has('.allternit/governance/HEARTBEAT.md')
-        ? parseHeartbeatMd(files.get('.allternit/governance/HEARTBEAT.md'))
-        : [];
-    // Build pack
-    const pack = {
-        version: '1.0.0',
-        agentId,
-        agentName,
-        sessionId,
-        identity: {
-            name: agentName,
-            purpose: files.get('.allternit/identity/IDENTITY.md')?.match(/##?\s*Purpose\s*\n([^#]+)/)?.[1]?.trim() || 'Assist the user',
-            backstory: soulContent.identity.backstory || `I am ${agentName}, an AI assistant.`,
-            personalityTraits: soulContent.identity.personalityTraits || ['helpful', 'accurate'],
-        },
-        trustTiers: soulContent.trustTiers,
-        governance: {
-            playbook: files.get('.allternit/governance/PLAYBOOK.md') || '',
-            availableTools: [], // Would parse from TOOLS.md
-            hardBans: [],
-            escalation: [],
-        },
-        heartbeat: {
-            tasks: heartbeatContent,
-            lastCheck: new Date().toISOString(),
-        },
-        memory: {
-            brain: files.get('.allternit/brain/BRAIN.md') || '',
-            activeTasks: [],
-            lessons: [],
-            userPreferences: {},
-        },
-        voice: {
-            style: files.get('.allternit/identity/VOICE.md') || 'professional and helpful',
-            tone: { formality: 0.5, enthusiasm: 0.5, empathy: 0.5, directness: 0.5 },
-            rules: [],
-        },
-        systemPrompt: '',
-        hash: '',
-        createdAt: new Date().toISOString(),
-        expiresAt: new Date(Date.now() + 5 * 60 * 1000).toISOString(),
-    };
-    // Build system prompt
-    pack.systemPrompt = buildSystemPrompt(pack);
-    // Generate hash
-    pack.hash = generateHash(pack);
-    return pack;
-}
-function generateHash(pack) {
-    const str = JSON.stringify({
-        agentId: pack.agentId,
-        trustTiers: pack.trustTiers,
-        systemPrompt: pack.systemPrompt?.slice(0, 100),
-    });
-    let hash = 0;
-    for (let i = 0; i < str.length; i++) {
-        const char = str.charCodeAt(i);
-        hash = ((hash << 5) - hash) + char;
-        hash = hash & hash;
-    }
-    return Math.abs(hash).toString(16).padStart(16, '0');
-}
-// ============================================================================
-// Utility Functions
-// ============================================================================
-export function getStartupTasks(pack) {
-    return pack.heartbeat.tasks.filter(t => t.frequency === 'on-session-start');
-}
-export function requiresPermission(pack, action) {
-    const actionLower = action.toLowerCase();
-    // Check Tier 3
-    if (pack.trustTiers.tier3.rules.some(r => actionLower.includes(r.toLowerCase()))) {
-        return true;
-    }
-    return false;
-}
-export function shouldRefreshContext(pack) {
-    return new Date() > new Date(pack.expiresAt);
-}

package/src/hooks/useExitOnCtrlCD.d.ts

@@ -1,86 +0,0 @@
-/**
- * @fileoverview Exit handler hook for gizzi-code integration
- * @module hooks/useExitOnCtrlCD
- *
- * Provides a React hook for handling exit key combinations (Ctrl+C and Ctrl+D).
- * Commonly used for CLI applications to handle graceful shutdown or exit actions.
- */
-/**
- * Exit handler callback type
- * @typedef {Function} ExitHandler
- */
-export type ExitHandler = () => void | boolean | Promise<void | boolean>;
-/**
- * Options for the exit handler hook
- * @interface UseExitOnCtrlCDOptions
- */
-export interface UseExitOnCtrlCDOptions {
-    /** Callback function to execute when exit keys are pressed */
-    readonly onExit?: ExitHandler;
-    /** Whether Ctrl+C triggers exit (default: true) */
-    readonly enableCtrlC?: boolean;
-    /** Whether Ctrl+D triggers exit (default: true) */
-    readonly enableCtrlD?: boolean;
-    /** Whether the exit handler is active (default: true) */
-    readonly enabled?: boolean;
-    /** Custom message to display on exit (optional) */
-    readonly exitMessage?: string;
-    /** Whether to confirm before exit (default: false) */
-    readonly confirmBeforeExit?: boolean;
-    /** Custom confirmation message */
-    readonly confirmMessage?: string;
-}
-/**
- * React hook for handling Ctrl+C and Ctrl+D exit combinations
- *
- * Registers keyboard shortcuts for common terminal exit commands and
- * executes the provided callback when triggered. Supports optional
- * confirmation before exit.
- *
- * @param {ExitHandler | UseExitOnCtrlCDOptions} handler - Exit callback or options object
- * @example
- * ```typescript
- * // Simple usage with callback
- * useExitOnCtrlCD(() => {
- *   console.log('Exiting...');
- *   process.exit(0);
- * });
- *
- * // With options
- * useExitOnCtrlCD({
- *   onExit: () => saveAndQuit(),
- *   enableCtrlC: true,
- *   enableCtrlD: false,
- *   exitMessage: '👋 See you later!',
- *   confirmBeforeExit: true,
- * });
- * ```
- */
-export declare function useExitOnCtrlCD(handler: ExitHandler | UseExitOnCtrlCDOptions): void;
-/**
- * Convenience hook for just Ctrl+C handling
- *
- * @param {ExitHandler} handler - Exit callback
- * @param {boolean} [enabled=true] - Whether the handler is active
- * @example
- * ```typescript
- * useExitOnCtrlC(() => {
- *   console.log('Interrupted');
- * });
- * ```
- */
-export declare function useExitOnCtrlC(handler: ExitHandler, enabled?: boolean): void;
-/**
- * Convenience hook for just Ctrl+D handling
- *
- * @param {ExitHandler} handler - Exit callback
- * @param {boolean} [enabled=true] - Whether the handler is active
- * @example
- * ```typescript
- * useExitOnCtrlD(() => {
- *   console.log('EOF received');
- * });
- * ```
- */
-export declare function useExitOnCtrlD(handler: ExitHandler, enabled?: boolean): void;
-export default useExitOnCtrlCD;

package/src/hooks/useExitOnCtrlCD.js

@@ -1,130 +0,0 @@
-/**
- * @fileoverview Exit handler hook for gizzi-code integration
- * @module hooks/useExitOnCtrlCD
- *
- * Provides a React hook for handling exit key combinations (Ctrl+C and Ctrl+D).
- * Commonly used for CLI applications to handle graceful shutdown or exit actions.
- */
-import { useCallback } from 'react';
-import { useKeybinding } from './useKeybinding';
-/**
- * Default confirmation message
- * @constant {string}
- */
-const DEFAULT_CONFIRM_MESSAGE = 'Are you sure you want to exit? (y/N): ';
-/**
- * Default exit message
- * @constant {string}
- */
-const DEFAULT_EXIT_MESSAGE = 'Goodbye!';
-/**
- * React hook for handling Ctrl+C and Ctrl+D exit combinations
- *
- * Registers keyboard shortcuts for common terminal exit commands and
- * executes the provided callback when triggered. Supports optional
- * confirmation before exit.
- *
- * @param {ExitHandler | UseExitOnCtrlCDOptions} handler - Exit callback or options object
- * @example
- * ```typescript
- * // Simple usage with callback
- * useExitOnCtrlCD(() => {
- *   console.log('Exiting...');
- *   process.exit(0);
- * });
- *
- * // With options
- * useExitOnCtrlCD({
- *   onExit: () => saveAndQuit(),
- *   enableCtrlC: true,
- *   enableCtrlD: false,
- *   exitMessage: '👋 See you later!',
- *   confirmBeforeExit: true,
- * });
- * ```
- */
-export function useExitOnCtrlCD(handler) {
-    // Normalize input to options object
-    const options = typeof handler === 'function' ? { onExit: handler } : handler;
-    const { onExit, enableCtrlC = true, enableCtrlD = true, enabled = true, exitMessage = DEFAULT_EXIT_MESSAGE, confirmBeforeExit = false, confirmMessage = DEFAULT_CONFIRM_MESSAGE, } = options;
-    const handleExit = useCallback(async (event) => {
-        // Handle confirmation if enabled
-        if (confirmBeforeExit) {
-            // Note: In a real CLI environment, you might use readline here
-            // For browser/React environments, this is a simplified version
-            const confirmed = typeof window !== 'undefined'
-                ? window.confirm(confirmMessage)
-                : true;
-            if (!confirmed) {
-                return;
-            }
-        }
-        // Show exit message
-        if (exitMessage && typeof console !== 'undefined') {
-            console.log(exitMessage);
-        }
-        // Execute exit handler
-        if (onExit) {
-            try {
-                const result = await onExit();
-                // Return false from handler to prevent default exit behavior
-                if (result === false && event) {
-                    event.preventDefault();
-                }
-            }
-            catch (error) {
-                console.error('Error during exit:', error);
-            }
-        }
-    }, [onExit, confirmBeforeExit, confirmMessage, exitMessage]);
-    // Wrap handler to match KeyHandler signature
-    const keyHandler = useCallback((event) => {
-        handleExit(event);
-    }, [handleExit]);
-    // Register Ctrl+C handler (SIGINT equivalent)
-    useKeybinding({ key: 'c', ctrl: true, preventDefault: true }, keyHandler, enabled && enableCtrlC);
-    // Register Ctrl+D handler (EOF/exit equivalent)
-    useKeybinding({ key: 'd', ctrl: true, preventDefault: true }, keyHandler, enabled && enableCtrlD);
-}
-/**
- * Convenience hook for just Ctrl+C handling
- *
- * @param {ExitHandler} handler - Exit callback
- * @param {boolean} [enabled=true] - Whether the handler is active
- * @example
- * ```typescript
- * useExitOnCtrlC(() => {
- *   console.log('Interrupted');
- * });
- * ```
- */
-export function useExitOnCtrlC(handler, enabled = true) {
-    useExitOnCtrlCD({
-        onExit: handler,
-        enableCtrlC: true,
-        enableCtrlD: false,
-        enabled,
-    });
-}
-/**
- * Convenience hook for just Ctrl+D handling
- *
- * @param {ExitHandler} handler - Exit callback
- * @param {boolean} [enabled=true] - Whether the handler is active
- * @example
- * ```typescript
- * useExitOnCtrlD(() => {
- *   console.log('EOF received');
- * });
- * ```
- */
-export function useExitOnCtrlD(handler, enabled = true) {
-    useExitOnCtrlCD({
-        onExit: handler,
-        enableCtrlC: false,
-        enableCtrlD: true,
-        enabled,
-    });
-}
-// Default export
-export default useExitOnCtrlCD;

package/src/hooks/useKeybinding.d.ts

@@ -1,89 +0,0 @@
-/**
- * @fileoverview Keybinding hook for gizzi-code integration
- * @module hooks/useKeybinding
- *
- * Provides a React hook for registering keyboard shortcuts and key combinations.
- * Supports modifier keys (Ctrl, Alt, Shift, Meta) and automatic cleanup on unmount.
- */
-/**
- * Key combination configuration
- * @interface KeybindingConfig
- */
-export interface KeybindingConfig {
-    /** The main key (e.g., 'c', 'Enter', 'Escape') */
-    readonly key: string;
-    /** Require Ctrl key to be pressed */
-    readonly ctrl?: boolean;
-    /** Require Alt/Option key to be pressed */
-    readonly alt?: boolean;
-    /** Require Shift key to be pressed */
-    readonly shift?: boolean;
-    /** Require Meta/Command key to be pressed */
-    readonly meta?: boolean;
-    /** Prevent default browser behavior */
-    readonly preventDefault?: boolean;
-    /** Stop event propagation */
-    readonly stopPropagation?: boolean;
-}
-/**
- * Parses a keybinding string into a config object
- *
- * @param {string} keybinding - Keybinding string (e.g., "Ctrl+C", "Escape", "Ctrl+Shift+A")
- * @returns {KeybindingConfig} Parsed keybinding configuration
- * @example
- * ```typescript
- * parseKeybinding("Ctrl+C"); // { key: 'c', ctrl: true }
- * parseKeybinding("Escape"); // { key: 'escape' }
- * parseKeybinding("Ctrl+Shift+A"); // { key: 'a', ctrl: true, shift: true }
- * ```
- */
-export declare function parseKeybinding(keybinding: string): KeybindingConfig;
-/**
- * Key event handler type
- * @typedef {Function} KeyHandler
- */
-export type KeyHandler = (event: KeyboardEvent) => void | boolean;
-/**
- * React hook for registering keyboard shortcuts
- *
- * Registers a keyboard shortcut that triggers the provided handler when pressed.
- * Automatically cleans up the event listener when the component unmounts or
- * when the keybinding changes.
- *
- * @param {string | KeybindingConfig} key - Key combination (e.g., "Ctrl+C") or config object
- * @param {KeyHandler} handler - Function to call when keybinding is triggered
- * @param {boolean} [enabled=true] - Whether the keybinding is active
- * @example
- * ```typescript
- * // Using string keybinding
- * useKeybinding('Ctrl+C', () => {
- *   console.log('Copy!');
- * });
- *
- * // Using config object
- * useKeybinding({ key: 'k', ctrl: true }, (e) => {
- *   e.preventDefault();
- *   console.log('Ctrl+K pressed');
- * });
- *
- * // With conditional enabling
- * useKeybinding('Escape', handleClose, isModalOpen);
- * ```
- */
-export declare function useKeybinding(key: string | KeybindingConfig, handler: KeyHandler, enabled?: boolean): void;
-/**
- * Hook for registering multiple keybindings at once
- *
- * @param {Array<[string | KeybindingConfig, KeyHandler]>} bindings - Array of [keybinding, handler] tuples
- * @param {boolean} [enabled=true] - Whether all keybindings are active
- * @example
- * ```typescript
- * useKeybindings([
- *   ['Ctrl+C', handleCopy],
- *   ['Ctrl+V', handlePaste],
- *   ['Escape', handleClose],
- * ]);
- * ```
- */
-export declare function useKeybindings(bindings: Array<[string | KeybindingConfig, KeyHandler]>, enabled?: boolean): void;
-export default useKeybinding;