@jacques-ai/core 0.0.7-alpha.1

package/dist/context/types.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Context Types
+ *
+ * Type definitions for the unified project index (.jacques/index.json)
+ * This is the single entry point for all project knowledge:
+ * - context: External files imported from Obsidian, Google Docs, etc.
+ * - sessions: Saved Claude Code conversations
+ * - plans: Implementation plans created during conversations
+ */
+/**
+ * Unified index of all project knowledge (.jacques/index.json)
+ */
+export interface ProjectIndex {
+    version: string;
+    updatedAt: string;
+    context: ContextFile[];
+    sessions: SessionEntry[];
+    plans: PlanEntry[];
+    subagents: SubagentEntry[];
+    /** Currently active plan IDs (cross-session tracking) */
+    activePlanIds?: string[];
+}
+/**
+ * A single context file entry (imported from external sources)
+ */
+export interface ContextFile {
+    id: string;
+    name: string;
+    path: string;
+    source: ContextSource;
+    sourceFile: string;
+    addedAt: string;
+    description?: string;
+    sizeBytes: number;
+    tags?: string[];
+}
+/**
+ * A single session entry (saved conversation)
+ */
+export interface SessionEntry {
+    id: string;
+    title: string;
+    filename: string;
+    path: string;
+    savedAt: string;
+    startedAt: string;
+    endedAt: string;
+    durationMinutes: number;
+    messageCount: number;
+    toolCallCount: number;
+    technologies: string[];
+    userLabel?: string;
+    /** Files modified via Write/Edit tool calls */
+    filesModified?: string[];
+    /** Unique tool names used */
+    toolsUsed?: string[];
+    /** Token usage stats */
+    tokens?: {
+        input: number;
+        output: number;
+        cacheCreation: number;
+        cacheRead: number;
+    };
+    /** Whether session has user-visible subagents */
+    hasSubagents?: boolean;
+    /** Whether auto-compact occurred */
+    hadAutoCompact?: boolean;
+    /** Session mode: planning or execution */
+    mode?: "planning" | "execution" | null;
+    /** Number of plans in this session */
+    planCount?: number;
+    /** Number of subagent artifacts */
+    subagentCount?: number;
+    /** Linked plan IDs (references PlanEntry.id) */
+    planIds?: string[];
+    /** Linked subagent IDs (references SubagentEntry.id) */
+    subagentIds?: string[];
+}
+/**
+ * A single subagent entry (exploration or search result)
+ */
+export interface SubagentEntry {
+    /** Unique ID: agentId for explorations, generated hash for searches */
+    id: string;
+    /** Parent session ID */
+    sessionId: string;
+    /** Type: exploration (Explore agent) or search (web search) */
+    type: "exploration" | "search";
+    /** Description (exploration) or query (search) */
+    title: string;
+    /** Output filename */
+    filename: string;
+    /** Relative path: "subagents/{filename}" */
+    path: string;
+    /** When the subagent ran or search was performed */
+    timestamp: string;
+    /** Estimated token cost (for explorations) */
+    tokenCost?: number;
+    /** Number of results (for searches) */
+    resultCount?: number;
+    /** When this was extracted */
+    extractedAt: string;
+}
+/**
+ * A single plan entry
+ */
+export interface PlanEntry {
+    id: string;
+    title: string;
+    filename: string;
+    path: string;
+    contentHash?: string;
+    bodyHash?: string;
+    createdAt: string;
+    updatedAt: string;
+    sessions: string[];
+}
+/**
+ * Supported context sources
+ */
+export type ContextSource = "obsidian" | "google_docs" | "notion" | "local";
+/**
+ * Options for adding a new context file
+ */
+export interface AddContextOptions {
+    cwd: string;
+    sourceFile: string;
+    name: string;
+    source: ContextSource;
+    description?: string;
+}
+/**
+ * Default empty index
+ */
+export declare function getDefaultIndex(): ProjectIndex;
+/**
+ * Legacy ContextIndex type for backwards compatibility
+ * @deprecated Use ProjectIndex instead
+ */
+export interface ContextIndex {
+    version: string;
+    updatedAt: string;
+    files: ContextFile[];
+}
+/**
+ * Migrate legacy index to new format
+ */
+export declare function migrateIndex(legacy: ContextIndex): ProjectIndex;
+//# sourceMappingURL=types.d.ts.map

package/dist/context/types.d.ts.map

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

package/dist/context/types.js

@@ -0,0 +1,36 @@
+/**
+ * Context Types
+ *
+ * Type definitions for the unified project index (.jacques/index.json)
+ * This is the single entry point for all project knowledge:
+ * - context: External files imported from Obsidian, Google Docs, etc.
+ * - sessions: Saved Claude Code conversations
+ * - plans: Implementation plans created during conversations
+ */
+/**
+ * Default empty index
+ */
+export function getDefaultIndex() {
+    return {
+        version: "2.0.0",
+        updatedAt: new Date().toISOString(),
+        context: [],
+        sessions: [],
+        plans: [],
+        subagents: [],
+    };
+}
+/**
+ * Migrate legacy index to new format
+ */
+export function migrateIndex(legacy) {
+    return {
+        version: "2.0.0",
+        updatedAt: legacy.updatedAt,
+        context: legacy.files,
+        sessions: [],
+        plans: [],
+        subagents: [],
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmIH;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAYD;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,KAAK;QACrB,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC"}

package/dist/handoff/catalog.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Handoff Catalog
+ *
+ * Lists and reads handoff files from .jacques/handoffs/
+ */
+import type { HandoffEntry, HandoffCatalog } from "./types.js";
+/**
+ * Get the handoffs directory path for a project
+ */
+export declare function getHandoffsDir(projectDir: string): string;
+/**
+ * Ensure the handoffs directory exists
+ */
+export declare function ensureHandoffsDir(projectDir: string): Promise<string>;
+/**
+ * Parse timestamp from handoff filename
+ * Format: 2026-01-31T14-30-00-handoff.md
+ */
+export declare function parseTimestampFromFilename(filename: string): Date;
+/**
+ * Generate a handoff filename with current timestamp
+ */
+export declare function generateHandoffFilename(): string;
+/**
+ * Format a Date object for display
+ */
+export declare function formatHandoffDate(date: Date): string;
+/**
+ * Estimate token count from content length
+ * Uses ~4.5 characters per token average
+ */
+export declare function estimateTokens(content: string): number;
+/**
+ * Format token count for display (e.g., "2.1k")
+ */
+export declare function formatTokenEstimate(tokens: number): string;
+/**
+ * List all handoffs in a project directory
+ * Returns entries sorted by timestamp (newest first)
+ */
+export declare function listHandoffs(projectDir: string): Promise<HandoffCatalog>;
+/**
+ * Get the content of a specific handoff file
+ */
+export declare function getHandoffContent(path: string): Promise<string>;
+/**
+ * Check if any handoffs exist for a project
+ */
+export declare function hasHandoffs(projectDir: string): Promise<boolean>;
+/**
+ * Get the most recent handoff for a project
+ */
+export declare function getLatestHandoff(projectDir: string): Promise<HandoffEntry | null>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/handoff/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/handoff/catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI3E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAOjE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CASpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA6B9E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAGvF"}

package/dist/handoff/catalog.js

@@ -0,0 +1,121 @@
+/**
+ * Handoff Catalog
+ *
+ * Lists and reads handoff files from .jacques/handoffs/
+ */
+import { promises as fs } from "fs";
+import { join } from "path";
+/**
+ * Get the handoffs directory path for a project
+ */
+export function getHandoffsDir(projectDir) {
+    return join(projectDir, ".jacques", "handoffs");
+}
+/**
+ * Ensure the handoffs directory exists
+ */
+export async function ensureHandoffsDir(projectDir) {
+    const dir = getHandoffsDir(projectDir);
+    await fs.mkdir(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Parse timestamp from handoff filename
+ * Format: 2026-01-31T14-30-00-handoff.md
+ */
+export function parseTimestampFromFilename(filename) {
+    const match = filename.match(/^(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})/);
+    if (match) {
+        const [, date, hour, min, sec] = match;
+        return new Date(`${date}T${hour}:${min}:${sec}`);
+    }
+    return new Date();
+}
+/**
+ * Generate a handoff filename with current timestamp
+ */
+export function generateHandoffFilename() {
+    const now = new Date();
+    const timestamp = now.toISOString()
+        .replace(/:/g, "-") // Replace colons with dashes
+        .replace(/\.\d{3}Z$/, ""); // Remove milliseconds and Z
+    return `${timestamp}-handoff.md`;
+}
+/**
+ * Format a Date object for display
+ */
+export function formatHandoffDate(date) {
+    return date.toLocaleString("en-US", {
+        year: "numeric",
+        month: "2-digit",
+        day: "2-digit",
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    });
+}
+/**
+ * Estimate token count from content length
+ * Uses ~4.5 characters per token average
+ */
+export function estimateTokens(content) {
+    return Math.ceil(content.length / 4.5);
+}
+/**
+ * Format token count for display (e.g., "2.1k")
+ */
+export function formatTokenEstimate(tokens) {
+    if (tokens >= 1000) {
+        return `${(tokens / 1000).toFixed(1)}k`;
+    }
+    return tokens.toString();
+}
+/**
+ * List all handoffs in a project directory
+ * Returns entries sorted by timestamp (newest first)
+ */
+export async function listHandoffs(projectDir) {
+    const directory = getHandoffsDir(projectDir);
+    try {
+        const files = await fs.readdir(directory);
+        const mdFiles = files.filter(f => f.endsWith("-handoff.md"));
+        const entries = await Promise.all(mdFiles.map(async (filename) => {
+            const path = join(directory, filename);
+            const content = await fs.readFile(path, "utf-8");
+            const timestamp = parseTimestampFromFilename(filename);
+            const tokenEstimate = estimateTokens(content);
+            return { filename, timestamp, path, tokenEstimate };
+        }));
+        // Sort by timestamp, newest first
+        entries.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+        return { directory, entries };
+    }
+    catch (error) {
+        // Directory doesn't exist or is empty
+        if (error.code === "ENOENT") {
+            return { directory, entries: [] };
+        }
+        throw error;
+    }
+}
+/**
+ * Get the content of a specific handoff file
+ */
+export async function getHandoffContent(path) {
+    return fs.readFile(path, "utf-8");
+}
+/**
+ * Check if any handoffs exist for a project
+ */
+export async function hasHandoffs(projectDir) {
+    const catalog = await listHandoffs(projectDir);
+    return catalog.entries.length > 0;
+}
+/**
+ * Get the most recent handoff for a project
+ */
+export async function getLatestHandoff(projectDir) {
+    const catalog = await listHandoffs(projectDir);
+    return catalog.entries[0] || null;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/handoff/catalog.js.map

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

package/dist/handoff/generator.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Handoff Generator
+ *
+ * Generates handoff documents directly from transcript files.
+ * Uses rule-based extraction (no LLM) for fast, consistent results.
+ */
+import type { ParsedEntry } from "../session/parser.js";
+/**
+ * Data extracted from a transcript for handoff generation
+ */
+export interface HandoffData {
+    /** Session title from summary entry */
+    title: string;
+    /** Project directory */
+    projectDir: string;
+    /** Files modified (Write/Edit tool calls) */
+    filesModified: string[];
+    /** Tools used in the session */
+    toolsUsed: string[];
+    /** Recent user messages (last N) */
+    recentMessages: string[];
+    /** Timestamp of extraction */
+    timestamp: string;
+    /** Total user message count */
+    totalUserMessages: number;
+    /** Total tool call count */
+    totalToolCalls: number;
+    /** Plans detected in the session */
+    plans?: Array<{
+        path: string;
+        title: string;
+    }>;
+    /** Key assistant response snippets (last N, no thinking/tools) */
+    assistantHighlights: string[];
+    /** Detected decision points from user messages */
+    decisions: string[];
+    /** Technologies detected in the session */
+    technologies: string[];
+    /** Detected blockers/errors from messages */
+    blockers: string[];
+}
+/**
+ * Result of handoff generation
+ */
+export interface HandoffResult {
+    /** Path to the generated handoff file */
+    filePath: string;
+    /** Filename of the handoff */
+    filename: string;
+    /** The handoff content */
+    content: string;
+    /** Estimated token count */
+    tokenEstimate: number;
+}
+/**
+ * Extract handoff data from parsed entries
+ */
+export declare function extractHandoffData(entries: ParsedEntry[], projectDir: string): Promise<HandoffData>;
+/**
+ * Format handoff data into markdown document
+ */
+export declare function formatHandoffMarkdown(data: HandoffData): string;
+/**
+ * Generate a handoff document from a transcript file
+ */
+export declare function generateHandoffFromTranscript(transcriptPath: string, projectDir: string): Promise<HandoffResult>;
+/**
+ * Generate handoff from already-parsed entries (avoids re-parsing)
+ */
+export declare function generateHandoffFromEntries(entries: ParsedEntry[], projectDir: string): Promise<HandoffResult>;
+/**
+ * Result of compact context extraction for skill consumption
+ */
+export interface CompactContextResult {
+    /** Formatted context string for LLM skill (~2k tokens) */
+    context: string;
+    /** Estimated token count for the context */
+    tokenEstimate: number;
+    /** Raw extracted data for reference */
+    data: HandoffData;
+}
+/**
+ * Format extracted handoff data as compact context for skill consumption.
+ * This creates a structured prompt that maps to the 8 sections the
+ * skill/orchestrator expects, but at ~2k tokens instead of 60k.
+ */
+export declare function formatAsSkillContext(data: HandoffData): string;
+/**
+ * Get compact context for LLM skill consumption.
+ * This is the main export for external interfaces like Dbook.
+ *
+ * Returns ~2k token context instead of sending 60k raw conversation.
+ *
+ * @param transcriptPath - Path to the JSONL transcript file
+ * @param projectDir - Project directory path
+ * @returns Compact context, token estimate, and raw data
+ */
+export declare function getCompactContextForSkill(transcriptPath: string, projectDir: string): Promise<CompactContextResult>;
+/**
+ * Get compact context from already-parsed entries (avoids re-parsing).
+ *
+ * @param entries - Already parsed JSONL entries
+ * @param projectDir - Project directory path
+ * @returns Compact context, token estimate, and raw data
+ */
+export declare function getCompactContextFromEntries(entries: ParsedEntry[], projectDir: string): Promise<CompactContextResult>;
+//# sourceMappingURL=generator.d.ts.map

package/dist/handoff/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/handoff/generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAoBxD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gCAAgC;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oCAAoC;IACpC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,kEAAkE;IAClE,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,kDAAkD;IAClD,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAgTD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,WAAW,CAAC,CAwDtB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CA0E/D;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CAqCxB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC,CA0BxB;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,IAAI,EAAE,WAAW,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAoG9D;AAwBD;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAC7C,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAkB/B;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAe/B"}