atabey 0.0.16 → 0.0.17

package/dist/atabey/src/modules/engines/session-engine.d.ts

@@ -0,0 +1,68 @@
+/**
+ * [ENGINE] Session Engine — STEP 0 STARTUP Protocol
+ *
+ * Implements ATABEY_FULL.md STEP 0:
+ * 1. Restore Session Memory & Load Role — read PROJECT_MEMORY.md, DECISIONS.md
+ * 2. Read Platform Shim — detect Claude/Gemini/Cursor platform
+ * 3. Respect Authority — report to @manager
+ *
+ * Integrates Token Economy Protocol and Output Flow Standards.
+ */
+export interface SessionContext {
+    projectMemory: string;
+    decisions: string[];
+    activeTraceId: string;
+    currentPhase: string;
+    platform: string;
+    agentState: string;
+    tokenBudget: {
+        used: number;
+        limit: number;
+    };
+}
+export interface OutputFlow {
+    assumptions: string[];
+    problem: string;
+    fileTree: string[];
+    codeBlocks: number;
+    auditLog: string;
+    tests: string[];
+}
+/**
+ * Session Engine — manages the STEP 0 startup protocol and enforces
+ * token economy and output flow standards on every session.
+ */
+export declare class SessionEngine {
+    /**
+     * STEP 0: STARTUP Protocol — runs at the beginning of every session.
+     * Reads PROJECT_MEMORY.md, checks active decisions, detects platform.
+     */
+    static startup(): Promise<SessionContext>;
+    /**
+     * Token Economy Protocol — enforces:
+     * - Search before read (never read_file entire directories)
+     * - Surgical operations (replace instead of write)
+     * - Output conciseness (minimum required data)
+     * - Context compaction (retrieve only relevant history)
+     */
+    static checkTokenEconomy(operationType: "read" | "write" | "replace" | "search", estimatedTokens: number): Promise<{
+        allowed: boolean;
+        warning?: string;
+    }>;
+    /**
+     * Output Flow Standard — validates that agent output follows the
+     * mandatory format: Assumptions, Problem, File Tree, Code, Tests, Audit Log.
+     */
+    static validateOutputFlow(output: string): {
+        passed: boolean;
+        missing: string[];
+    };
+    /**
+     * Checks session compliance with STEP 0 rules.
+     * Logs a warning if rules are not followed.
+     */
+    static checkSessionCompliance(): Promise<{
+        compliant: boolean;
+        warnings: string[];
+    }>;
+}

package/dist/atabey/src/modules/engines/session-engine.js

@@ -0,0 +1,141 @@
+/**
+ * [ENGINE] Session Engine — STEP 0 STARTUP Protocol
+ *
+ * Implements ATABEY_FULL.md STEP 0:
+ * 1. Restore Session Memory & Load Role — read PROJECT_MEMORY.md, DECISIONS.md
+ * 2. Read Platform Shim — detect Claude/Gemini/Cursor platform
+ * 3. Respect Authority — report to @manager
+ *
+ * Integrates Token Economy Protocol and Output Flow Standards.
+ */
+import fs from "fs";
+import path from "path";
+import { getFrameworkDir } from "../../cli/utils/memory.js";
+import { logger } from "../../shared/logger.js";
+import { AtabeyStorage } from "../../shared/storage.js";
+/**
+ * Session Engine — manages the STEP 0 startup protocol and enforces
+ * token economy and output flow standards on every session.
+ */
+export class SessionEngine {
+    /**
+     * STEP 0: STARTUP Protocol — runs at the beginning of every session.
+     * Reads PROJECT_MEMORY.md, checks active decisions, detects platform.
+     */
+    static async startup() {
+        const frameworkDir = getFrameworkDir();
+        const memoryDir = path.join(frameworkDir, "memory");
+        // 1. Read PROJECT_MEMORY.md
+        let projectMemory = "";
+        const memoryFile = path.join(memoryDir, "PROJECT_MEMORY.md");
+        if (fs.existsSync(memoryFile)) {
+            projectMemory = fs.readFileSync(memoryFile, "utf8");
+        }
+        // 2. Read DECISIONS.md for architectural constraints
+        let decisions = [];
+        const decisionsFile = path.join(memoryDir, "DECISIONS.md");
+        if (fs.existsSync(decisionsFile)) {
+            const content = fs.readFileSync(decisionsFile, "utf8");
+            decisions = content.split("\n").filter(l => l.startsWith("- **") || l.startsWith("- "));
+        }
+        // 3. Detect active session state
+        const activeTraceId = AtabeyStorage.getMetadata("traceId") || "N/A";
+        const currentPhase = AtabeyStorage.getMetadata("phase") || "PHASE_0";
+        const platform = process.env.ATABEY_PLATFORM || "unknown";
+        // 4. Get agent state
+        const agents = AtabeyStorage.getAllAgents();
+        const managerState = agents.find(a => a.name === "@manager" || a.name === "manager");
+        // 5. Check token budget from storage metadata
+        const tokenUsed = parseInt(AtabeyStorage.getMetadata("tokenUsed") || "0", 10);
+        const tokenLimit = parseInt(AtabeyStorage.getMetadata("tokenLimit") || "100000", 10);
+        const tokenBudget = { used: tokenUsed, limit: tokenLimit };
+        logger.info(`[SESSION] STEP 0 STARTUP — Trace: ${activeTraceId}, Phase: ${currentPhase}, Platform: ${platform}`);
+        return {
+            projectMemory,
+            decisions,
+            activeTraceId,
+            currentPhase,
+            platform,
+            agentState: managerState?.state || "READY",
+            tokenBudget,
+        };
+    }
+    /**
+     * Token Economy Protocol — enforces:
+     * - Search before read (never read_file entire directories)
+     * - Surgical operations (replace instead of write)
+     * - Output conciseness (minimum required data)
+     * - Context compaction (retrieve only relevant history)
+     */
+    static async checkTokenEconomy(operationType, estimatedTokens) {
+        const context = await SessionEngine.startup();
+        if (operationType === "read" && estimatedTokens > 5000) {
+            return {
+                allowed: false,
+                warning: `[TOKEN ECONOMY] Read operation too large (${estimatedTokens} tokens). Search before read.`
+            };
+        }
+        if (operationType === "write" && estimatedTokens > 20000) {
+            return {
+                allowed: true,
+                warning: `[TOKEN ECONOMY] Large write (${estimatedTokens} tokens). Consider surgical replace instead.`
+            };
+        }
+        if (context.tokenBudget.used > context.tokenBudget.limit) {
+            return {
+                allowed: false,
+                warning: `[TOKEN ECONOMY] Token budget exceeded (${context.tokenBudget.used}/${context.tokenBudget.limit}). Compact context before proceeding.`
+            };
+        }
+        return { allowed: true };
+    }
+    /**
+     * Output Flow Standard — validates that agent output follows the
+     * mandatory format: Assumptions, Problem, File Tree, Code, Tests, Audit Log.
+     */
+    static validateOutputFlow(output) {
+        const missing = [];
+        const outputUpper = output.toUpperCase();
+        if (!outputUpper.includes("ASSUMPTION")) {
+            missing.push("Assumptions section — state all assumptions made");
+        }
+        if (!outputUpper.includes("PROBLEM")) {
+            missing.push("Problem section — what is being built and why (max 2-3 sentences)");
+        }
+        if (!outputUpper.includes("FILE TREE") && !outputUpper.includes("FILE")) {
+            missing.push("File Tree section — complete folder and file structure");
+        }
+        if (!outputUpper.includes("AUDIT") && !outputUpper.includes("LOG")) {
+            missing.push("Audit Logging section — how changes are logged");
+        }
+        if (!outputUpper.includes("TEST")) {
+            missing.push("Tests section — test file for every service and utility");
+        }
+        return {
+            passed: missing.length === 0,
+            missing,
+        };
+    }
+    /**
+     * Checks session compliance with STEP 0 rules.
+     * Logs a warning if rules are not followed.
+     */
+    static async checkSessionCompliance() {
+        const context = await SessionEngine.startup();
+        const warnings = [];
+        if (!context.projectMemory) {
+            warnings.push("PROJECT_MEMORY.md not found. Run STEP 0: Restore Session Memory.");
+        }
+        if (context.activeTraceId === "N/A") {
+            warnings.push("No active Trace ID. Generate one with `atabey trace:new`.");
+        }
+        if (!context.decisions.length) {
+            warnings.push("DECISIONS.md is empty or missing. Architectural decisions should be documented.");
+        }
+        return {
+            compliant: warnings.length === 0,
+            warnings,
+        };
+    }
+}
+//# sourceMappingURL=session-engine.js.map

package/dist/atabey/src/modules/engines/session-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-engine.js","sourceRoot":"","sources":["../../../../../src/modules/engines/session-engine.ts"],"names":[],"mappings":"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"}

package/dist/atabey/src/modules/engines/types.d.ts

@@ -0,0 +1,51 @@
+import { PlanID, TaskID, TraceID } from "../../shared/types.js";
+/**
+ * Atabey Engine Trio — Shared Types
+ */
+export type RiskSeverity = "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+export interface RiskFactor {
+    factor: string;
+    score: number;
+    description: string;
+}
+export interface RiskAssessment {
+    totalScore: number;
+    severity: RiskSeverity;
+    factors: RiskFactor[];
+    requiresApproval: boolean;
+}
+export interface EvaluationResult {
+    traceId: TraceID;
+    agent: string;
+    score: number;
+    metrics: {
+        compilation: boolean;
+        lint: boolean;
+        tests: boolean;
+        compliance: number;
+    };
+    durationMs: number;
+    timestamp: string;
+}
+export interface ProjectHealth {
+    score: number;
+    codeQuality: number;
+    security: number;
+    architecture: number;
+    agentHealth?: number;
+    totalAgents?: number;
+    activeAgents?: number;
+    blockedAgents?: number;
+    totalLogs?: number;
+    lastUpdated: string;
+}
+export interface PlanTask {
+    id: TaskID;
+    agent: string;
+    task: string;
+    dependencies: TaskID[];
+}
+export interface Plan {
+    planId: PlanID;
+    tasks: PlanTask[];
+}

package/dist/atabey/src/modules/engines/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/atabey/src/modules/engines/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/engines/types.ts"],"names":[],"mappings":""}

package/dist/atabey/src/modules/memory/core.d.ts

@@ -0,0 +1,42 @@
+import { TraceID } from "../../shared/types.js";
+import { MemoryCategory, MemorySearchResult } from "./types.js";
+/**
+ * [MEMORY] Core Memory Service
+ * High-level API for managing project knowledge and embeddings.
+ * Uses OpenAI Embedding API when available, falls back to TF-IDF.
+ */
+export declare class CoreMemory {
+    private static readonly VECTOR_DIM;
+    private static readonly STOP_WORDS;
+    static init(): Promise<void>;
+    /**
+     * Records a new piece of knowledge into the core memory.
+     * Uses OpenAI Embedding API when available, falls back to TF-IDF.
+     */
+    static remember(params: {
+        content: string;
+        category: MemoryCategory;
+        traceId?: TraceID;
+        filePath?: string;
+        tags?: string[];
+        vector?: number[];
+    }): Promise<string>;
+    /**
+     * Searches the memory for relevant knowledge using cosine similarity.
+     * Uses OpenAI Embedding API when available for the query vector.
+     */
+    static recall(query: string, options: {
+        category?: MemoryCategory;
+        limit?: number;
+        queryVector?: number[];
+    }): Promise<MemorySearchResult[]>;
+    /**
+     * Generates a TF-IDF style embedding vector from text.
+     * Kept for backward compatibility and as fallback.
+     */
+    static generateEmbedding(text: string): number[];
+    /**
+     * Deterministically maps a string to a position in the vector.
+     */
+    private static hashToPosition;
+}

package/dist/atabey/src/modules/memory/core.js

@@ -0,0 +1,100 @@
+import crypto from "crypto";
+import { generateEmbedding } from "./embedding.js";
+import { VectorStore } from "./vector-store.js";
+/**
+ * [MEMORY] Core Memory Service
+ * High-level API for managing project knowledge and embeddings.
+ * Uses OpenAI Embedding API when available, falls back to TF-IDF.
+ */
+export class CoreMemory {
+    static VECTOR_DIM = 384;
+    static STOP_WORDS = new Set([
+        "the", "a", "an", "and", "or", "but", "in", "on", "at", "to", "for",
+        "of", "with", "by", "from", "as", "is", "was", "are", "were", "be",
+        "been", "being", "have", "has", "had", "do", "does", "did", "will",
+        "would", "could", "should", "may", "might", "shall", "can", "need",
+    ]);
+    static async init() {
+        VectorStore.initialize();
+    }
+    /**
+     * Records a new piece of knowledge into the core memory.
+     * Uses OpenAI Embedding API when available, falls back to TF-IDF.
+     */
+    static async remember(params) {
+        const id = crypto.createHash("sha256").update(params.content + (params.filePath || "")).digest("hex");
+        // Use provided vector or generate via embedding service
+        const vector = params.vector || await generateEmbedding(params.content);
+        const entry = {
+            id,
+            content: params.content,
+            vector,
+            metadata: {
+                category: params.category,
+                traceId: params.traceId,
+                filePath: params.filePath,
+                tags: params.tags || [],
+                createdAt: new Date().toISOString()
+            }
+        };
+        await VectorStore.addEntry(entry);
+        return id;
+    }
+    /**
+     * Searches the memory for relevant knowledge using cosine similarity.
+     * Uses OpenAI Embedding API when available for the query vector.
+     */
+    static async recall(query, options) {
+        const vector = options.queryVector || await generateEmbedding(query);
+        return VectorStore.search(vector, options.limit || 5, options.category);
+    }
+    /**
+     * Generates a TF-IDF style embedding vector from text.
+     * Kept for backward compatibility and as fallback.
+     */
+    static generateEmbedding(text) {
+        const vector = new Array(this.VECTOR_DIM).fill(0);
+        // Tokenize and clean
+        const tokens = text
+            .toLowerCase()
+            .replace(/[^a-z0-9çşıöğü_ ]/g, " ")
+            .split(/\s+/)
+            .filter(t => t.length > 2 && !this.STOP_WORDS.has(t));
+        if (tokens.length === 0) {
+            return vector;
+        }
+        // Calculate term frequency
+        const tf = new Map();
+        for (const token of tokens) {
+            tf.set(token, (tf.get(token) || 0) + 1);
+        }
+        // Map each unique token to vector positions using hash
+        for (const [token, freq] of tf) {
+            for (let i = 0; i < token.length - 1; i++) {
+                const ngram = token.substring(i, i + 2);
+                const pos = this.hashToPosition(ngram);
+                vector[pos] += freq * (i + 1) / token.length;
+            }
+        }
+        // Normalize to unit vector
+        const magnitude = Math.sqrt(vector.reduce((sum, v) => sum + v * v, 0));
+        if (magnitude > 0) {
+            for (let i = 0; i < this.VECTOR_DIM; i++) {
+                vector[i] /= magnitude;
+            }
+        }
+        return vector;
+    }
+    /**
+     * Deterministically maps a string to a position in the vector.
+     */
+    static hashToPosition(value) {
+        let hash = 0;
+        for (let i = 0; i < value.length; i++) {
+            hash = ((hash << 5) - hash) + value.charCodeAt(i);
+            hash |= 0;
+        }
+        return Math.abs(hash) % this.VECTOR_DIM;
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/atabey/src/modules/memory/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../../../../src/modules/memory/core.ts"],"names":[],"mappings":"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"}

package/dist/atabey/src/modules/memory/embedding.d.ts

@@ -0,0 +1,28 @@
+/**
+ * [MEMORY] Embedding Service
+ *
+ * Real embedding generation with OpenAI API integration.
+ * Falls back to TF-IDF if no API key is available.
+ *
+ * Supported methods:
+ * 1. OpenAI Embedding API (text-embedding-3-small) — 1536 dimensions
+ * 2. TF-IDF fallback (local method) — 384 dimensions
+ */
+/**
+ * Generates an embedding vector for the given text.
+ *
+ * Priority:
+ * 1. OpenAI API (if API key is available)
+ * 2. TF-IDF fallback (local)
+ */
+export declare function generateEmbedding(text: string): Promise<number[]>;
+/**
+ * Batch embedding generation. Single API call for multiple texts.
+ * OpenAI supports batch requests natively.
+ */
+export declare function generateEmbeddings(texts: string[]): Promise<number[][]>;
+/**
+ * Checks if a vector is an OpenAI embedding (1536 dimensions)
+ * as opposed to TF-IDF (384 dimensions).
+ */
+export declare function isOpenAIEmbedding(vector: number[]): boolean;

package/dist/atabey/src/modules/memory/embedding.js

@@ -0,0 +1,131 @@
+/**
+ * [MEMORY] Embedding Service
+ *
+ * Real embedding generation with OpenAI API integration.
+ * Falls back to TF-IDF if no API key is available.
+ *
+ * Supported methods:
+ * 1. OpenAI Embedding API (text-embedding-3-small) — 1536 dimensions
+ * 2. TF-IDF fallback (local method) — 384 dimensions
+ */
+import fs from "fs";
+import path from "path";
+import { logger } from "../../shared/logger.js";
+import { CoreMemory } from "./core.js";
+const EMBEDDING_API = "https://api.openai.com/v1/embeddings";
+const EMBEDDING_MODEL = "text-embedding-3-small";
+const EMBEDDING_DIM = 1536;
+/**
+ * Reads the API key from environment variable or .env file.
+ */
+function getApiKey() {
+    if (process.env.OPENAI_API_KEY)
+        return process.env.OPENAI_API_KEY;
+    try {
+        const envPath = path.join(process.cwd(), ".env");
+        if (fs.existsSync(envPath)) {
+            const content = fs.readFileSync(envPath, "utf8");
+            const match = content.match(/^OPENAI_API_KEY=(.+)$/m);
+            if (match)
+                return match[1].trim();
+        }
+    }
+    catch {
+        // Silently ignore .env read errors
+    }
+    return null;
+}
+/**
+ * Generates an embedding vector for the given text.
+ *
+ * Priority:
+ * 1. OpenAI API (if API key is available)
+ * 2. TF-IDF fallback (local)
+ */
+export async function generateEmbedding(text) {
+    const apiKey = getApiKey();
+    // Use OpenAI API if available
+    if (apiKey) {
+        try {
+            const response = await fetch(EMBEDDING_API, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    input: text,
+                    model: EMBEDDING_MODEL,
+                }),
+            });
+            if (!response.ok) {
+                logger.warn(`OpenAI API error: ${response.status}. Falling back to TF-IDF.`);
+                return fallbackEmbedding(text);
+            }
+            const data = await response.json();
+            if (data?.data?.[0]?.embedding) {
+                return data.data[0].embedding;
+            }
+        }
+        catch (err) {
+            logger.warn(`OpenAI API call failed: ${err.message}. Falling back to TF-IDF.`);
+        }
+    }
+    // Fallback: TF-IDF
+    return fallbackEmbedding(text);
+}
+/**
+ * TF-IDF fallback embedding using CoreMemory.generateEmbedding.
+ * OpenAI embedding is 1536 dimensions, TF-IDF is 384 dimensions.
+ * Pads TF-IDF output to 1536 for compatibility.
+ */
+function fallbackEmbedding(text) {
+    const tfidfVector = CoreMemory.generateEmbedding(text); // 384 dimensions
+    // Pad 384 → 1536
+    const padded = new Array(EMBEDDING_DIM).fill(0);
+    for (let i = 0; i < tfidfVector.length; i++) {
+        padded[i] = tfidfVector[i];
+    }
+    return padded;
+}
+/**
+ * Batch embedding generation. Single API call for multiple texts.
+ * OpenAI supports batch requests natively.
+ */
+export async function generateEmbeddings(texts) {
+    const apiKey = getApiKey();
+    if (apiKey) {
+        try {
+            const response = await fetch(EMBEDDING_API, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${apiKey}`,
+                },
+                body: JSON.stringify({
+                    input: texts,
+                    model: EMBEDDING_MODEL,
+                }),
+            });
+            if (response.ok) {
+                const data = await response.json();
+                if (data?.data) {
+                    return data.data.map(d => d.embedding);
+                }
+            }
+        }
+        catch {
+            // fallback
+        }
+    }
+    // Fallback for each text
+    return Promise.all(texts.map(t => fallbackEmbedding(t)));
+}
+/**
+ * Checks if a vector is an OpenAI embedding (1536 dimensions)
+ * as opposed to TF-IDF (384 dimensions).
+ */
+export function isOpenAIEmbedding(vector) {
+    return vector.length === EMBEDDING_DIM;
+}
+//# sourceMappingURL=embedding.js.map

package/dist/atabey/src/modules/memory/embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding.js","sourceRoot":"","sources":["../../../../../src/modules/memory/embedding.ts"],"names":[],"mappings":"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"}

package/dist/atabey/src/modules/memory/types.d.ts

@@ -0,0 +1,18 @@
+import { TraceID } from "../../shared/types.js";
+export type MemoryCategory = "ARCHITECTURE" | "DECISION" | "CODE_SNIPPET" | "RULE" | "TASK_HISTORY";
+export interface MemoryEntry {
+    id: string;
+    content: string;
+    vector?: number[];
+    metadata: {
+        category: MemoryCategory;
+        traceId?: TraceID;
+        filePath?: string;
+        tags: string[];
+        createdAt: string;
+    };
+}
+export interface MemorySearchResult {
+    entry: MemoryEntry;
+    score: number;
+}

package/dist/atabey/src/modules/memory/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/atabey/src/modules/memory/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/modules/memory/types.ts"],"names":[],"mappings":""}

package/dist/atabey/src/modules/memory/vector-store.d.ts

@@ -0,0 +1,13 @@
+import { MemoryEntry, MemorySearchResult, MemoryCategory } from "./types.js";
+/**
+ * [MEMORY] Vector Store Implementation
+ * Uses SQLite for persistence and JS-based cosine similarity for retrieval.
+ * Zero-Docker, Lightweight, and Local.
+ */
+export declare class VectorStore {
+    private static TABLE_NAME;
+    static initialize(): void;
+    static addEntry(entry: MemoryEntry): Promise<void>;
+    static search(queryVector: number[], limit?: number, category?: MemoryCategory): Promise<MemorySearchResult[]>;
+    private static cosineSimilarity;
+}