feique 1.1.0

package/dist/service/templates.js.map

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

package/dist/state/audit-log.d.ts

@@ -0,0 +1,33 @@
+export interface AuditEvent {
+    type: string;
+    at: string;
+    [key: string]: unknown;
+}
+export interface AppendAuditEvent {
+    type: string;
+    at?: string;
+    [key: string]: unknown;
+}
+export interface AuditCleanupResult {
+    kept: number;
+    archived: number;
+    removed: number;
+    filePath: string;
+    archivePath?: string;
+}
+export declare class AuditLog {
+    private readonly filePath;
+    private readonly serial;
+    constructor(stateDir: string, fileName?: string);
+    append(event: AppendAuditEvent): Promise<void>;
+    tail(limit: number): Promise<AuditEvent[]>;
+    cleanup(options: {
+        retentionDays: number;
+        archiveAfterDays?: number;
+        archiveDir?: string;
+        archiveFileName?: string;
+        now?: Date;
+    }): Promise<AuditCleanupResult>;
+    get path(): string;
+    private readLines;
+}

package/dist/state/audit-log.js

@@ -0,0 +1,116 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { ensureDir, writeUtf8Atomic } from '../utils/fs.js';
+import { SerialExecutor } from '../utils/serial-executor.js';
+export class AuditLog {
+    filePath;
+    serial = new SerialExecutor();
+    constructor(stateDir, fileName = 'audit.jsonl') {
+        this.filePath = path.join(stateDir, fileName);
+    }
+    async append(event) {
+        await this.serial.run(async () => {
+            await ensureDir(path.dirname(this.filePath));
+            const payload = {
+                ...event,
+                at: event.at ?? new Date().toISOString(),
+            };
+            await fs.appendFile(this.filePath, `${JSON.stringify(payload)}\n`, 'utf8');
+        });
+    }
+    async tail(limit) {
+        await this.serial.wait();
+        try {
+            const content = await fs.readFile(this.filePath, 'utf8');
+            const normalized = content.trim();
+            if (!normalized) {
+                return [];
+            }
+            return normalized
+                .split(/\r?\n/)
+                .filter(Boolean)
+                .slice(-limit)
+                .map((line) => JSON.parse(line));
+        }
+        catch {
+            return [];
+        }
+    }
+    async cleanup(options) {
+        return this.serial.run(async () => {
+            const lines = await this.readLines();
+            if (lines.length === 0) {
+                return {
+                    kept: 0,
+                    archived: 0,
+                    removed: 0,
+                    filePath: this.filePath,
+                };
+            }
+            const now = options.now ?? new Date();
+            const archiveCutoff = options.archiveAfterDays ? now.getTime() - options.archiveAfterDays * 24 * 60 * 60 * 1000 : null;
+            const retentionCutoff = now.getTime() - options.retentionDays * 24 * 60 * 60 * 1000;
+            const kept = [];
+            const archived = [];
+            let removed = 0;
+            for (const line of lines) {
+                const event = parseAuditLine(line);
+                const timestamp = event?.at ? Date.parse(event.at) : Number.NaN;
+                if (Number.isNaN(timestamp)) {
+                    kept.push(line);
+                    continue;
+                }
+                if (timestamp < retentionCutoff) {
+                    removed += 1;
+                    continue;
+                }
+                if (archiveCutoff !== null && timestamp < archiveCutoff) {
+                    archived.push(line);
+                    continue;
+                }
+                kept.push(line);
+            }
+            let archivePath;
+            if (archived.length > 0 && options.archiveDir) {
+                archivePath = path.join(options.archiveDir, options.archiveFileName ?? path.basename(this.filePath));
+                await ensureDir(path.dirname(archivePath));
+                await fs.appendFile(archivePath, `${archived.join('\n')}\n`, 'utf8');
+            }
+            else if (archived.length > 0) {
+                kept.push(...archived);
+            }
+            await writeUtf8Atomic(this.filePath, kept.length > 0 ? `${kept.join('\n')}\n` : '');
+            return {
+                kept: kept.length,
+                archived: archived.length,
+                removed,
+                filePath: this.filePath,
+                ...(archivePath ? { archivePath } : {}),
+            };
+        });
+    }
+    get path() {
+        return this.filePath;
+    }
+    async readLines() {
+        try {
+            const content = await fs.readFile(this.filePath, 'utf8');
+            return content
+                .split(/\r?\n/)
+                .map((line) => line.trim())
+                .filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+function parseAuditLine(line) {
+    try {
+        return JSON.parse(line);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=audit-log.js.map

package/dist/state/audit-log.js.map

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

package/dist/state/config-history-store.d.ts

@@ -0,0 +1,27 @@
+export interface ConfigSnapshot {
+    id: string;
+    at: string;
+    chat_id?: string;
+    actor_id?: string;
+    action: string;
+    summary?: string;
+    config_path: string;
+    content: string;
+}
+export declare class ConfigHistoryStore {
+    private readonly filePath;
+    private readonly serial;
+    constructor(stateDir: string);
+    recordSnapshot(input: {
+        configPath: string;
+        action: string;
+        summary?: string;
+        chatId?: string;
+        actorId?: string;
+        limit?: number;
+    }): Promise<ConfigSnapshot>;
+    listSnapshots(limit?: number): Promise<ConfigSnapshot[]>;
+    getSnapshot(idOrLatest?: string): Promise<ConfigSnapshot | null>;
+    private readState;
+    private writeState;
+}

package/dist/state/config-history-store.js

@@ -0,0 +1,65 @@
+import { randomUUID } from 'node:crypto';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { SerialExecutor } from '../utils/serial-executor.js';
+import { ensureDir, fileExists, readUtf8, writeUtf8Atomic } from '../utils/fs.js';
+const DEFAULT_STATE = {
+    version: 1,
+    snapshots: [],
+};
+export class ConfigHistoryStore {
+    filePath;
+    serial = new SerialExecutor();
+    constructor(stateDir) {
+        this.filePath = path.join(stateDir, 'config-history.json');
+    }
+    async recordSnapshot(input) {
+        return this.serial.run(async () => {
+            const state = await this.readState();
+            const content = await fs.readFile(input.configPath, 'utf8');
+            const snapshot = {
+                id: randomUUID(),
+                at: new Date().toISOString(),
+                chat_id: input.chatId,
+                actor_id: input.actorId,
+                action: input.action,
+                summary: input.summary,
+                config_path: path.resolve(input.configPath),
+                content,
+            };
+            const limit = input.limit ?? 5;
+            state.snapshots = [snapshot, ...state.snapshots].slice(0, limit);
+            await this.writeState(state);
+            return snapshot;
+        });
+    }
+    async listSnapshots(limit = 5) {
+        await this.serial.wait();
+        const state = await this.readState();
+        return state.snapshots.slice(0, limit);
+    }
+    async getSnapshot(idOrLatest) {
+        await this.serial.wait();
+        const state = await this.readState();
+        if (!idOrLatest || idOrLatest === 'latest') {
+            return state.snapshots[0] ?? null;
+        }
+        return state.snapshots.find((snapshot) => snapshot.id === idOrLatest) ?? null;
+    }
+    async readState() {
+        if (!(await fileExists(this.filePath))) {
+            return structuredClone(DEFAULT_STATE);
+        }
+        const content = await readUtf8(this.filePath);
+        const parsed = JSON.parse(content);
+        return {
+            version: 1,
+            snapshots: Array.isArray(parsed.snapshots) ? parsed.snapshots : [],
+        };
+    }
+    async writeState(state) {
+        await ensureDir(path.dirname(this.filePath));
+        await writeUtf8Atomic(this.filePath, `${JSON.stringify(state, null, 2)}\n`);
+    }
+}
+//# sourceMappingURL=config-history-store.js.map

package/dist/state/config-history-store.js.map

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

package/dist/state/handoff-store.d.ts

@@ -0,0 +1,20 @@
+/**
+ * JSON-backed store for handoff records and review records.
+ */
+import type { HandoffRecord, ReviewRecord } from '../collaboration/handoff.js';
+export declare class HandoffStore {
+    private readonly filePath;
+    private readonly executor;
+    constructor(stateDir: string);
+    private load;
+    private save;
+    addHandoff(record: HandoffRecord): Promise<void>;
+    updateHandoff(id: string, patch: Partial<HandoffRecord>): Promise<HandoffRecord | null>;
+    getPendingHandoff(projectAlias?: string): Promise<HandoffRecord | null>;
+    getPendingHandoffForActor(actorId: string, projectAlias?: string): Promise<HandoffRecord | null>;
+    listHandoffs(limit?: number): Promise<HandoffRecord[]>;
+    addReview(record: ReviewRecord): Promise<void>;
+    updateReview(id: string, patch: Partial<ReviewRecord>): Promise<ReviewRecord | null>;
+    getPendingReview(chatId: string): Promise<ReviewRecord | null>;
+    listReviews(limit?: number): Promise<ReviewRecord[]>;
+}

package/dist/state/handoff-store.js

@@ -0,0 +1,97 @@
+/**
+ * JSON-backed store for handoff records and review records.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { SerialExecutor } from '../utils/serial-executor.js';
+const MAX_RECORDS = 100;
+export class HandoffStore {
+    filePath;
+    executor = new SerialExecutor();
+    constructor(stateDir) {
+        this.filePath = path.join(stateDir, 'handoffs.json');
+    }
+    async load() {
+        try {
+            const content = await fs.readFile(this.filePath, 'utf8');
+            return JSON.parse(content);
+        }
+        catch {
+            return { handoffs: [], reviews: [] };
+        }
+    }
+    async save(data) {
+        await fs.mkdir(path.dirname(this.filePath), { recursive: true });
+        await fs.writeFile(this.filePath, JSON.stringify(data, null, 2), 'utf8');
+    }
+    async addHandoff(record) {
+        await this.executor.run(async () => {
+            const data = await this.load();
+            data.handoffs.unshift(record);
+            if (data.handoffs.length > MAX_RECORDS) {
+                data.handoffs = data.handoffs.slice(0, MAX_RECORDS);
+            }
+            await this.save(data);
+        });
+    }
+    async updateHandoff(id, patch) {
+        return this.executor.run(async () => {
+            const data = await this.load();
+            const index = data.handoffs.findIndex((h) => h.id === id || h.id.startsWith(id));
+            if (index < 0)
+                return null;
+            const record = data.handoffs[index];
+            const updated = Object.assign(record, patch);
+            data.handoffs[index] = updated;
+            await this.save(data);
+            return updated;
+        });
+    }
+    async getPendingHandoff(projectAlias) {
+        const data = await this.executor.run(() => this.load());
+        return (data.handoffs.find((h) => h.status === 'pending' &&
+            (!projectAlias || h.project_alias === projectAlias)) ?? null);
+    }
+    async getPendingHandoffForActor(actorId, projectAlias) {
+        const data = await this.executor.run(() => this.load());
+        return (data.handoffs.find((h) => h.status === 'pending' &&
+            (!h.to_actor_id || h.to_actor_id === actorId) &&
+            (!projectAlias || h.project_alias === projectAlias)) ?? null);
+    }
+    async listHandoffs(limit = 10) {
+        const data = await this.executor.run(() => this.load());
+        return data.handoffs.slice(0, limit);
+    }
+    async addReview(record) {
+        await this.executor.run(async () => {
+            const data = await this.load();
+            data.reviews.unshift(record);
+            if (data.reviews.length > MAX_RECORDS) {
+                data.reviews = data.reviews.slice(0, MAX_RECORDS);
+            }
+            await this.save(data);
+        });
+    }
+    async updateReview(id, patch) {
+        return this.executor.run(async () => {
+            const data = await this.load();
+            const index = data.reviews.findIndex((r) => r.id === id || r.id.startsWith(id));
+            if (index < 0)
+                return null;
+            const record = data.reviews[index];
+            const updated = Object.assign(record, patch);
+            data.reviews[index] = updated;
+            await this.save(data);
+            return updated;
+        });
+    }
+    async getPendingReview(chatId) {
+        const data = await this.executor.run(() => this.load());
+        return data.reviews.find((r) => r.status === 'pending' && r.chat_id === chatId) ?? null;
+    }
+    async listReviews(limit = 10) {
+        const data = await this.executor.run(() => this.load());
+        return data.reviews.slice(0, limit);
+    }
+}
+//# sourceMappingURL=handoff-store.js.map

package/dist/state/handoff-store.js.map

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

package/dist/state/idempotency-store.d.ts

@@ -0,0 +1,19 @@
+export interface IdempotencyEntry {
+    key: string;
+    kind: 'message' | 'card';
+    first_seen_at: string;
+    last_seen_at: string;
+    duplicate_count: number;
+}
+export declare class IdempotencyStore {
+    private readonly filePath;
+    private readonly serial;
+    constructor(stateDir: string);
+    register(key: string, kind: 'message' | 'card', ttlSeconds: number): Promise<{
+        duplicate: boolean;
+        entry: IdempotencyEntry;
+    }>;
+    tail(limit: number): Promise<IdempotencyEntry[]>;
+    private readState;
+    private writeState;
+}

package/dist/state/idempotency-store.js

@@ -0,0 +1,84 @@
+import path from 'node:path';
+import { SerialExecutor } from '../utils/serial-executor.js';
+import { ensureDir, fileExists, readUtf8, writeUtf8Atomic } from '../utils/fs.js';
+const DEFAULT_STATE = {
+    version: 1,
+    entries: {},
+};
+export class IdempotencyStore {
+    filePath;
+    serial = new SerialExecutor();
+    constructor(stateDir) {
+        this.filePath = path.join(stateDir, 'idempotency.json');
+    }
+    async register(key, kind, ttlSeconds) {
+        return this.serial.run(async () => {
+            const state = await this.readState();
+            const now = new Date();
+            pruneExpiredEntries(state, now, ttlSeconds);
+            const isoNow = now.toISOString();
+            const existing = state.entries[key];
+            if (existing) {
+                const updated = {
+                    ...existing,
+                    last_seen_at: isoNow,
+                    duplicate_count: existing.duplicate_count + 1,
+                };
+                state.entries[key] = updated;
+                await this.writeState(state);
+                return {
+                    duplicate: true,
+                    entry: updated,
+                };
+            }
+            const created = {
+                key,
+                kind,
+                first_seen_at: isoNow,
+                last_seen_at: isoNow,
+                duplicate_count: 0,
+            };
+            state.entries[key] = created;
+            await this.writeState(state);
+            return {
+                duplicate: false,
+                entry: created,
+            };
+        });
+    }
+    async tail(limit) {
+        await this.serial.wait();
+        const state = await this.readState();
+        return Object.values(state.entries)
+            .sort((left, right) => right.last_seen_at.localeCompare(left.last_seen_at))
+            .slice(0, limit);
+    }
+    async readState() {
+        if (!(await fileExists(this.filePath))) {
+            return structuredClone(DEFAULT_STATE);
+        }
+        const content = await readUtf8(this.filePath);
+        const parsed = JSON.parse(content);
+        return {
+            version: 1,
+            entries: parsed.entries ?? {},
+        };
+    }
+    async writeState(state) {
+        await ensureDir(path.dirname(this.filePath));
+        await writeUtf8Atomic(this.filePath, `${JSON.stringify(state, null, 2)}\n`);
+    }
+}
+function pruneExpiredEntries(state, now, ttlSeconds) {
+    if (!Number.isFinite(ttlSeconds) || ttlSeconds <= 0) {
+        return;
+    }
+    const cutoff = now.getTime() - ttlSeconds * 1000;
+    for (const [key, entry] of Object.entries(state.entries)) {
+        const timestamp = Date.parse(entry.last_seen_at || entry.first_seen_at);
+        if (!Number.isFinite(timestamp) || timestamp < cutoff) {
+            delete state.entries[key];
+        }
+    }
+}
+//# sourceMappingURL=idempotency-store.js.map

package/dist/state/idempotency-store.js.map

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

package/dist/state/memory-store.d.ts

@@ -0,0 +1,137 @@
+import { type EmbeddingProvider } from '../memory/embeddings.js';
+export type MemoryScope = 'project' | 'group';
+export interface ThreadSummaryRecord {
+    conversation_key: string;
+    project_alias: string;
+    thread_id: string;
+    summary: string;
+    recent_prompt?: string;
+    recent_response_excerpt?: string;
+    files_touched: string[];
+    open_tasks: string[];
+    decisions: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface MemoryRecord {
+    id: string;
+    scope: MemoryScope;
+    project_alias: string;
+    chat_id?: string;
+    title: string;
+    content: string;
+    tags: string[];
+    source: string;
+    pinned: boolean;
+    confidence: number;
+    created_by?: string;
+    created_at: string;
+    updated_at: string;
+    last_accessed_at?: string;
+    archived_at?: string;
+    archived_by?: string;
+    archive_reason?: string;
+    expires_at?: string;
+}
+export type ProjectMemoryRecord = MemoryRecord;
+interface MemorySelector {
+    scope: MemoryScope;
+    project_alias: string;
+    chat_id?: string;
+}
+export interface MemoryFilters {
+    tag?: string;
+    source?: string;
+    created_by?: string;
+}
+export type MemoryPinAgeBasis = 'updated_at' | 'last_accessed_at';
+export interface MemoryStats {
+    active_count: number;
+    archived_count: number;
+    expired_count: number;
+    pinned_count: number;
+    latest_updated_at?: string;
+    latest_accessed_at?: string;
+    latest_archived_at?: string;
+}
+interface MemoryQueryOptions {
+    includeExpired?: boolean;
+    includeArchived?: boolean;
+}
+export declare class MemoryStore {
+    private readonly dbPath;
+    private readonly serial;
+    private readonly embedder;
+    private _db;
+    private _schemaReady;
+    private _lastTs;
+    constructor(stateDir: string, embedder?: EmbeddingProvider);
+    /** Return an ISO timestamp that is strictly greater than any previous call. */
+    private monotonicNow;
+    upsertThreadSummary(record: Omit<ThreadSummaryRecord, 'created_at' | 'updated_at'>): Promise<ThreadSummaryRecord>;
+    getThreadSummary(conversationKey: string, projectAlias: string, threadId: string): Promise<ThreadSummaryRecord | null>;
+    saveMemory(input: {
+        scope: MemoryScope;
+        project_alias: string;
+        chat_id?: string;
+        title: string;
+        content: string;
+        tags?: string[];
+        source?: string;
+        pinned?: boolean;
+        confidence?: number;
+        created_by?: string;
+        expires_at?: string;
+    }): Promise<MemoryRecord>;
+    saveProjectMemory(input: {
+        project_alias: string;
+        title: string;
+        content: string;
+        tags?: string[];
+        source?: string;
+        pinned?: boolean;
+        confidence?: number;
+        created_by?: string;
+        expires_at?: string;
+    }): Promise<ProjectMemoryRecord>;
+    saveGroupMemory(input: {
+        project_alias: string;
+        chat_id: string;
+        title: string;
+        content: string;
+        tags?: string[];
+        source?: string;
+        pinned?: boolean;
+        confidence?: number;
+        created_by?: string;
+        expires_at?: string;
+    }): Promise<MemoryRecord>;
+    searchMemories(selector: MemorySelector, query: string, limit: number, filters?: MemoryFilters): Promise<MemoryRecord[]>;
+    searchProjectMemories(projectAlias: string, query: string, limit: number, filters?: MemoryFilters): Promise<ProjectMemoryRecord[]>;
+    searchGroupMemories(projectAlias: string, chatId: string, query: string, limit: number, filters?: MemoryFilters): Promise<MemoryRecord[]>;
+    getMemory(selector: MemorySelector, id: string): Promise<MemoryRecord | null>;
+    getMemoryById(selector: MemorySelector, id: string, options?: MemoryQueryOptions): Promise<MemoryRecord | null>;
+    listRecentMemories(selector: MemorySelector, limit: number, filters?: MemoryFilters): Promise<MemoryRecord[]>;
+    listRecentProjectMemories(projectAlias: string, limit: number, filters?: MemoryFilters): Promise<ProjectMemoryRecord[]>;
+    listRecentGroupMemories(projectAlias: string, chatId: string, limit: number, filters?: MemoryFilters): Promise<MemoryRecord[]>;
+    countMemories(selector: MemorySelector): Promise<number>;
+    countProjectMemories(projectAlias: string): Promise<number>;
+    countGroupMemories(projectAlias: string, chatId: string): Promise<number>;
+    countPinnedMemories(selector: MemorySelector): Promise<number>;
+    countPinnedProjectMemories(projectAlias: string): Promise<number>;
+    countPinnedGroupMemories(projectAlias: string, chatId: string): Promise<number>;
+    getMemoryStats(selector: MemorySelector): Promise<MemoryStats>;
+    cleanupExpiredMemories(selector?: MemorySelector): Promise<number>;
+    getOldestPinnedMemory(selector: MemorySelector, basis?: MemoryPinAgeBasis): Promise<MemoryRecord | null>;
+    setMemoryPinned(selector: MemorySelector, id: string, pinned: boolean): Promise<MemoryRecord | null>;
+    archiveMemory(selector: MemorySelector, id: string, input?: {
+        archived_by?: string;
+        reason?: string;
+    }): Promise<MemoryRecord | null>;
+    restoreMemory(selector: MemorySelector, id: string, restoredBy?: string): Promise<MemoryRecord | null>;
+    ensureReady(): Promise<void>;
+    close(): void;
+    private getDb;
+    private withDb;
+}
+export {};