@jacques-ai/core 0.0.7-alpha.1

package/dist/archive/archive-store.d.ts

@@ -0,0 +1,166 @@
+/**
+ * Archive Store
+ *
+ * File I/O for the conversation archive system.
+ * Handles storing manifests, conversations, and plans to ~/.jacques/archive/
+ * and local project .jacques/ directories.
+ */
+import type { ConversationManifest, SearchIndex, ArchiveSettings, SearchInput, SearchOutput } from "./types.js";
+import type { SavedContext } from "../session/transformer.js";
+/**
+ * Generate a readable filename for a session.
+ * Format: [YYYY-MM-DD]_[HH-MM]_[title-slug]_[4-char-id].json
+ * Example: 2026-01-31_14-30_jwt-auth-setup_8d84.json
+ */
+export declare function generateSessionFilename(manifest: ConversationManifest): string;
+/**
+ * Get the global archive base path.
+ */
+export declare function getGlobalArchivePath(): string;
+/**
+ * Get the path to the global search index.
+ */
+export declare function getGlobalIndexPath(): string;
+/**
+ * Get the path to a manifest in the global archive.
+ */
+export declare function getManifestPath(id: string): string;
+/**
+ * Get the path to a conversation in the global archive.
+ * Uses projectId (encoded full path) for storage to avoid collisions.
+ */
+export declare function getConversationPath(projectId: string, id: string): string;
+/**
+ * Get the path to a plan in the global archive.
+ * Plans are organized by project: plans/[projectId]/[name].md
+ * Uses projectId (encoded full path) for storage to avoid collisions.
+ */
+export declare function getPlanPath(projectId: string, planName: string): string;
+/**
+ * Get the local project archive path.
+ */
+export declare function getLocalArchivePath(projectPath: string): string;
+/**
+ * Get the local project archive index path.
+ * Uses sessions/index.json to avoid conflict with context/index.json
+ */
+export declare function getLocalIndexPath(projectPath: string): string;
+/**
+ * Ensure the global archive directory structure exists.
+ */
+export declare function ensureGlobalArchive(): Promise<void>;
+/**
+ * Ensure the local project archive directory structure exists.
+ */
+export declare function ensureLocalArchive(projectPath: string): Promise<void>;
+/**
+ * Read the global search index.
+ */
+export declare function readGlobalIndex(): Promise<SearchIndex>;
+/**
+ * Write the global search index.
+ */
+export declare function writeGlobalIndex(index: SearchIndex): Promise<void>;
+/**
+ * Read a local project index.
+ */
+export declare function readLocalIndex(projectPath: string): Promise<SearchIndex>;
+/**
+ * Write a local project index.
+ */
+export declare function writeLocalIndex(projectPath: string, index: SearchIndex): Promise<void>;
+/**
+ * Save a manifest to the global archive.
+ */
+export declare function saveManifest(manifest: ConversationManifest): Promise<void>;
+/**
+ * Read a manifest from the global archive.
+ */
+export declare function readManifest(id: string): Promise<ConversationManifest | null>;
+/**
+ * List all manifest IDs in the global archive.
+ */
+export declare function listManifests(): Promise<string[]>;
+/**
+ * List all manifests with full data, sorted by date (newest first).
+ */
+export declare function listAllManifests(): Promise<ConversationManifest[]>;
+/**
+ * List all manifests grouped by project.
+ * Returns a Map with projectId as keys (for uniqueness), sorted manifests as values.
+ * Falls back to projectSlug for old manifests without projectId.
+ */
+export declare function listManifestsByProject(): Promise<Map<string, ConversationManifest[]>>;
+/**
+ * Save a conversation to both global and local archives.
+ * Uses readable filename format: YYYY-MM-DD_HH-MM_title-slug_id.json
+ */
+export declare function saveConversation(conversation: SavedContext, manifest: ConversationManifest, options?: {
+    saveToLocal?: boolean;
+}): Promise<{
+    globalPath: string;
+    localPath?: string;
+    filename: string;
+}>;
+/**
+ * Read a conversation from the global archive.
+ * @param projectId The projectId (encoded path) or projectSlug for old data
+ */
+export declare function readConversation(projectId: string, id: string): Promise<SavedContext | null>;
+/**
+ * Archive a plan file (copy to archive if not already there).
+ * Uses project subdirectories and readable naming.
+ * Extracts title from the plan's # heading for the filename.
+ */
+export declare function archivePlan(planPath: string, options?: {
+    saveToLocal?: boolean;
+    projectPath?: string;
+    projectId?: string;
+    projectSlug?: string;
+    sessionId?: string;
+}): Promise<string | null>;
+/**
+ * Check if a plan is already archived.
+ * @param projectId The projectId (encoded path) to check
+ */
+export declare function isPlanArchived(projectId: string, planName: string): Promise<boolean>;
+/**
+ * Read archive settings from global config.
+ */
+export declare function readArchiveSettings(): Promise<ArchiveSettings>;
+/**
+ * Write archive settings to global config.
+ */
+export declare function writeArchiveSettings(settings: ArchiveSettings): Promise<void>;
+/**
+ * Archive a conversation (full flow).
+ * 1. Save manifest to global archive
+ * 2. Save conversation to global (and optionally local) archive
+ * 3. Archive any new plans
+ * 4. Update global search index
+ *
+ * Note: Local project index is updated automatically by saveConversation
+ */
+export declare function archiveConversation(conversation: SavedContext, manifest: ConversationManifest, options?: {
+    saveToLocal?: boolean;
+}): Promise<{
+    manifestPath: string;
+    conversationPath: string;
+    localPath?: string;
+    filename: string;
+    plansArchived: string[];
+}>;
+/**
+ * Search conversations with filters.
+ */
+export declare function searchConversations(input: SearchInput): Promise<SearchOutput>;
+/**
+ * Get archive statistics.
+ */
+export declare function getArchiveStats(): Promise<{
+    totalConversations: number;
+    totalProjects: number;
+    totalSizeBytes: number;
+    sizeFormatted: string;
+}>;
+//# sourceMappingURL=archive-store.d.ts.map

package/dist/archive/archive-store.d.ts.map

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