attocode 0.2.3 → 0.2.5

package/dist/src/integrations/utilities/environment-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-facts.d.ts","sourceRoot":"","sources":["../../../../src/integrations/utilities/environment-facts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IAEpB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAC;IAErB,wBAAwB;IACxB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IAEjB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IAEb,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IAEpB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAWD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAiB5E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAGhF;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAsBjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAGnE"}

package/dist/src/integrations/utilities/environment-facts.js

@@ -0,0 +1,84 @@
+/**
+ * Environment Facts
+ *
+ * Core grounding module that provides temporal, platform, and project
+ * context to all agents (main, subagent, swarm worker, quality gate).
+ *
+ * Without this, LLMs confidently write "as of 2024" when it's 2026,
+ * cite stale data as current, and produce artifacts that fail temporal
+ * verification.
+ *
+ * Usage:
+ *   const facts = getEnvironmentFacts();           // auto-populated singleton
+ *   const block = formatFactsBlock(facts);          // for system prompts
+ *   const line  = formatFactsCompact(facts);        // for judge prompts
+ */
+import { platform, arch } from 'node:os';
+// ─── Singleton ────────────────────────────────────────────────────────────
+let _cached = null;
+const MONTHS = [
+    'January', 'February', 'March', 'April', 'May', 'June',
+    'July', 'August', 'September', 'October', 'November', 'December',
+];
+/**
+ * Get auto-populated environment facts.
+ * Cached per process — call refreshEnvironmentFacts() to force update.
+ */
+export function getEnvironmentFacts(customFacts) {
+    if (_cached && !customFacts)
+        return _cached;
+    const now = new Date();
+    const facts = {
+        currentDate: now.toISOString().split('T')[0],
+        currentYear: now.getFullYear(),
+        currentMonth: MONTHS[now.getMonth()],
+        workingDirectory: process.cwd(),
+        platform: platform(),
+        arch: arch(),
+        nodeVersion: process.version,
+        custom: customFacts ?? _cached?.custom ?? [],
+    };
+    _cached = facts;
+    return facts;
+}
+/**
+ * Force refresh (e.g. if cwd changes or date rolls over).
+ */
+export function refreshEnvironmentFacts(customFacts) {
+    _cached = null;
+    return getEnvironmentFacts(customFacts);
+}
+// ─── Formatters ───────────────────────────────────────────────────────────
+/**
+ * Format facts as a full system prompt block.
+ * Used by main agent and swarm worker system prompts.
+ */
+export function formatFactsBlock(facts) {
+    const f = facts ?? getEnvironmentFacts();
+    const lines = [
+        '═══ ENVIRONMENT FACTS ═══',
+        '',
+        `Today's date: ${f.currentDate} (${f.currentMonth} ${f.currentYear})`,
+        `Working directory: ${f.workingDirectory}`,
+        `Platform: ${f.platform}/${f.arch}, Node ${f.nodeVersion}`,
+        '',
+        'IMPORTANT: When researching, writing reports, or referencing current events,',
+        `use ${f.currentYear} as the current year. Your training data may be outdated —`,
+        'prefer web search results over internal knowledge for recent facts.',
+    ];
+    if (f.custom.length > 0) {
+        lines.push('', 'Additional context:');
+        for (const fact of f.custom) {
+            lines.push(`- ${fact}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format facts as a compact one-liner for judge/gate prompts.
+ */
+export function formatFactsCompact(facts) {
+    const f = facts ?? getEnvironmentFacts();
+    return `Current date: ${f.currentDate}. Current year: ${f.currentYear}. Working directory: ${f.workingDirectory}.`;
+}
+//# sourceMappingURL=environment-facts.js.map

package/dist/src/integrations/utilities/environment-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-facts.js","sourceRoot":"","sources":["../../../../src/integrations/utilities/environment-facts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AA8BzC,6EAA6E;AAE7E,IAAI,OAAO,GAA4B,IAAI,CAAC;AAE5C,MAAM,MAAM,GAAG;IACb,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM;IACtD,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU;CACjE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,WAAsB;IACxD,IAAI,OAAO,IAAI,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC;IAE5C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,KAAK,GAAqB;QAC9B,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5C,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE;QAC9B,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QACpC,gBAAgB,EAAE,OAAO,CAAC,GAAG,EAAE;QAC/B,QAAQ,EAAE,QAAQ,EAAE;QACpB,IAAI,EAAE,IAAI,EAAE;QACZ,WAAW,EAAE,OAAO,CAAC,OAAO;QAC5B,MAAM,EAAE,WAAW,IAAI,OAAO,EAAE,MAAM,IAAI,EAAE;KAC7C,CAAC;IAEF,OAAO,GAAG,KAAK,CAAC;IAChB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,WAAsB;IAC5D,OAAO,GAAG,IAAI,CAAC;IACf,OAAO,mBAAmB,CAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,6EAA6E;AAE7E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAwB;IACvD,MAAM,CAAC,GAAG,KAAK,IAAI,mBAAmB,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG;QACZ,2BAA2B;QAC3B,EAAE;QACF,iBAAiB,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,WAAW,GAAG;QACrE,sBAAsB,CAAC,CAAC,gBAAgB,EAAE;QAC1C,aAAa,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,WAAW,EAAE;QAC1D,EAAE;QACF,8EAA8E;QAC9E,OAAO,CAAC,CAAC,WAAW,4DAA4D;QAChF,qEAAqE;KACtE,CAAC;IAEF,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,qBAAqB,CAAC,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;YAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IACzD,MAAM,CAAC,GAAG,KAAK,IAAI,mBAAmB,EAAE,CAAC;IACzC,OAAO,iBAAiB,CAAC,CAAC,WAAW,mBAAmB,CAAC,CAAC,WAAW,wBAAwB,CAAC,CAAC,gBAAgB,GAAG,CAAC;AACrH,CAAC"}

package/dist/src/integrations/utilities/file-change-tracker.d.ts

@@ -0,0 +1,162 @@
+/**
+ * File Change Tracker
+ *
+ * Tracks file changes for undo capability in agent sessions.
+ * Provides before/after content capture, diff generation, and undo functionality.
+ *
+ * @example
+ * ```typescript
+ * import Database from 'better-sqlite3';
+ * import { FileChangeTracker } from './file-change-tracker.js';
+ *
+ * const db = new Database('sessions.db');
+ * const tracker = new FileChangeTracker(db, 'session-123');
+ *
+ * // Record a file change
+ * const changeId = await tracker.recordChange({
+ *   filePath: '/path/to/file.ts',
+ *   operation: 'edit',
+ *   contentBefore: 'old content',
+ *   contentAfter: 'new content',
+ *   turnNumber: 1,
+ * });
+ *
+ * // Undo the change
+ * const result = await tracker.undoChange(changeId);
+ * ```
+ */
+import Database from 'better-sqlite3';
+/**
+ * Configuration for FileChangeTracker.
+ */
+export interface FileChangeTrackerConfig {
+    /** Whether tracking is enabled (default: true) */
+    enabled?: boolean;
+    /** Maximum bytes for full content storage (default: 50KB). Above this, store diff only. */
+    maxFullContentBytes?: number;
+}
+/**
+ * Represents a file change record.
+ */
+export interface FileChange {
+    /** Unique change ID */
+    id: number;
+    /** Session this change belongs to */
+    sessionId: string;
+    /** Turn number when change occurred */
+    turnNumber: number;
+    /** Path to the changed file */
+    filePath: string;
+    /** Type of operation */
+    operation: 'create' | 'write' | 'edit' | 'delete';
+    /** Content before the change (null for creates) */
+    contentBefore: string | null;
+    /** Content after the change (null for deletes) */
+    contentAfter: string | null;
+    /** Unified diff (when using diff storage mode) */
+    diffUnified: string | null;
+    /** How content is stored */
+    storageMode: 'full' | 'diff';
+    /** Bytes before change */
+    bytesBefore: number;
+    /** Bytes after change */
+    bytesAfter: number;
+    /** Whether this change has been undone */
+    isUndone: boolean;
+    /** ID of the change that undid this one */
+    undoChangeId: number | null;
+    /** Tool call ID that made this change */
+    toolCallId: string | null;
+    /** ISO timestamp of when change was recorded */
+    createdAt: string;
+}
+/**
+ * Result of an undo operation.
+ */
+export interface UndoResult {
+    /** Whether the undo succeeded */
+    success: boolean;
+    /** Path to the affected file */
+    filePath: string;
+    /** Human-readable message */
+    message: string;
+    /** Change ID that was undone (if successful) */
+    changeId?: number;
+}
+/**
+ * Summary of changes in a session.
+ */
+export interface ChangeSummary {
+    /** Total number of changes */
+    totalChanges: number;
+    /** Number of active (non-undone) changes */
+    activeChanges: number;
+    /** Number of undone changes */
+    undoneChanges: number;
+    /** Files that were modified */
+    filesModified: string[];
+    /** Changes by operation type */
+    byOperation: {
+        create: number;
+        write: number;
+        edit: number;
+        delete: number;
+    };
+}
+/**
+ * Tracks file changes for undo capability.
+ */
+export declare class FileChangeTracker {
+    private db;
+    private sessionId;
+    private config;
+    private stmts;
+    constructor(db: Database.Database, sessionId: string, config?: FileChangeTrackerConfig);
+    /**
+     * Prepare SQL statements for reuse.
+     */
+    private prepareStatements;
+    /**
+     * Record a file change.
+     */
+    recordChange(params: {
+        filePath: string;
+        operation: 'create' | 'write' | 'edit' | 'delete';
+        contentBefore?: string;
+        contentAfter?: string;
+        turnNumber: number;
+        toolCallId?: string;
+    }): Promise<number>;
+    /**
+     * Undo a specific change by ID.
+     * Uses a transaction with optimistic locking to prevent TOCTOU race conditions.
+     */
+    undoChange(changeId: number): Promise<UndoResult>;
+    /**
+     * Undo the last change to a specific file.
+     */
+    undoLastChange(filePath: string): Promise<UndoResult>;
+    /**
+     * Undo all changes in a turn.
+     */
+    undoTurn(turnNumber: number): Promise<UndoResult[]>;
+    /**
+     * Get all changes for a file.
+     */
+    getFileHistory(filePath: string): FileChange[];
+    /**
+     * Get all changes in session.
+     */
+    getChanges(options?: {
+        filePath?: string;
+    }): FileChange[];
+    /**
+     * Get session change summary.
+     */
+    getSessionChangeSummary(): ChangeSummary;
+}
+/**
+ * Create a FileChangeTracker instance.
+ */
+export declare function createFileChangeTracker(db: Database.Database, sessionId: string, config?: FileChangeTrackerConfig): FileChangeTracker;
+//# sourceMappingURL=file-change-tracker.d.ts.map

package/dist/src/integrations/utilities/file-change-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-change-tracker.d.ts","sourceRoot":"","sources":["../../../../src/integrations/utilities/file-change-tracker.ts"],"names":[],"mappings":"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"}