@jacques-ai/core 0.0.7-alpha.1

package/dist/logging/logger.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Logger
+ *
+ * Lightweight logger interface for core modules.
+ * Silent by default — callers opt into logging by injecting a non-silent logger.
+ */
+/**
+ * Logger interface compatible with server's logger-factory.
+ */
+export interface Logger {
+    log: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}
+/**
+ * Create a logger instance.
+ *
+ * @param options.silent - If true (default), all output is suppressed.
+ * @param options.prefix - Optional prefix prepended to all messages (e.g., "[Cache]").
+ */
+export declare function createLogger(options?: {
+    silent?: boolean;
+    prefix?: string;
+}): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logging/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AASD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAsBT"}

package/dist/logging/logger.js

@@ -0,0 +1,39 @@
+/**
+ * Logger
+ *
+ * Lightweight logger interface for core modules.
+ * Silent by default — callers opt into logging by injecting a non-silent logger.
+ */
+/** A logger that does nothing (default for all core functions). */
+const silentLogger = {
+    log: () => { },
+    warn: () => { },
+    error: () => { },
+};
+/**
+ * Create a logger instance.
+ *
+ * @param options.silent - If true (default), all output is suppressed.
+ * @param options.prefix - Optional prefix prepended to all messages (e.g., "[Cache]").
+ */
+export function createLogger(options) {
+    const { silent = true, prefix } = options || {};
+    if (silent) {
+        return silentLogger;
+    }
+    const formatArgs = (args) => {
+        if (prefix && args.length > 0 && typeof args[0] === "string") {
+            return [`${prefix} ${args[0]}`, ...args.slice(1)];
+        }
+        if (prefix) {
+            return [prefix, ...args];
+        }
+        return args;
+    };
+    return {
+        log: (...args) => console.log(...formatArgs(args)),
+        warn: (...args) => console.warn(...formatArgs(args)),
+        error: (...args) => console.error(...formatArgs(args)),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logging/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logging/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,mEAAmE;AACnE,MAAM,YAAY,GAAW;IAC3B,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;IACb,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CAChB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAG5B;IACC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAEhD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,IAAe,EAAa,EAAE;QAChD,IAAI,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC7D,OAAO,CAAC,GAAG,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACpD,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;KACvD,CAAC;AACJ,CAAC"}

package/dist/notifications/constants.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Notification constants for Jacques.
+ *
+ * Shared between server, GUI, and CLI.
+ */
+import type { NotificationCategory, NotificationSettings } from './types.js';
+export declare const DEFAULT_NOTIFICATION_SETTINGS: NotificationSettings;
+/** Cooldown periods per category in milliseconds */
+export declare const NOTIFICATION_COOLDOWNS: Record<NotificationCategory, number>;
+/** Unicode symbols per notification category */
+export declare const CATEGORY_SYMBOLS: Record<NotificationCategory, string>;
+/** Human-readable labels per notification category */
+export declare const CATEGORY_LABELS: Record<NotificationCategory, string>;
+/** Maximum number of notifications to keep in history */
+export declare const MAX_NOTIFICATION_HISTORY = 50;
+//# sourceMappingURL=constants.d.ts.map

package/dist/notifications/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/notifications/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE7E,eAAO,MAAM,6BAA6B,EAAE,oBAa3C,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAOvE,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAOjE,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAOhE,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,wBAAwB,KAAK,CAAC"}

package/dist/notifications/constants.js

@@ -0,0 +1,49 @@
+/**
+ * Notification constants for Jacques.
+ *
+ * Shared between server, GUI, and CLI.
+ */
+export const DEFAULT_NOTIFICATION_SETTINGS = {
+    enabled: false, // OFF by default — user must opt in
+    categories: {
+        context: true,
+        operation: false,
+        plan: true,
+        'auto-compact': true,
+        handoff: true,
+        'bug-alert': false,
+    },
+    largeOperationThreshold: 50_000,
+    contextThresholds: [50, 70], // Only 50% and 70%
+    bugAlertThreshold: 5,
+};
+/** Cooldown periods per category in milliseconds */
+export const NOTIFICATION_COOLDOWNS = {
+    context: 60_000,
+    operation: 10_000,
+    plan: 30_000,
+    'auto-compact': 60_000,
+    handoff: 10_000,
+    'bug-alert': 120_000,
+};
+/** Unicode symbols per notification category */
+export const CATEGORY_SYMBOLS = {
+    context: '◆',
+    operation: '⚡',
+    plan: '◇',
+    'auto-compact': '▲',
+    handoff: '✓',
+    'bug-alert': '⚠',
+};
+/** Human-readable labels per notification category */
+export const CATEGORY_LABELS = {
+    context: 'Context',
+    operation: 'Operation',
+    plan: 'Plan',
+    'auto-compact': 'Compact',
+    handoff: 'Handoff',
+    'bug-alert': 'Bug Alert',
+};
+/** Maximum number of notifications to keep in history */
+export const MAX_NOTIFICATION_HISTORY = 50;
+//# sourceMappingURL=constants.js.map

package/dist/notifications/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/notifications/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,CAAC,MAAM,6BAA6B,GAAyB;IACjE,OAAO,EAAE,KAAK,EAAE,oCAAoC;IACpD,UAAU,EAAE;QACV,OAAO,EAAE,IAAI;QACb,SAAS,EAAE,KAAK;QAChB,IAAI,EAAE,IAAI;QACV,cAAc,EAAE,IAAI;QACpB,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,KAAK;KACnB;IACD,uBAAuB,EAAE,MAAM;IAC/B,iBAAiB,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,mBAAmB;IAChD,iBAAiB,EAAE,CAAC;CACrB,CAAC;AAEF,oDAAoD;AACpD,MAAM,CAAC,MAAM,sBAAsB,GAAyC;IAC1E,OAAO,EAAE,MAAM;IACf,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,MAAM;IACZ,cAAc,EAAE,MAAM;IACtB,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,OAAO;CACrB,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,gBAAgB,GAAyC;IACpE,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,GAAG;IACd,IAAI,EAAE,GAAG;IACT,cAAc,EAAE,GAAG;IACnB,OAAO,EAAE,GAAG;IACZ,WAAW,EAAE,GAAG;CACjB,CAAC;AAEF,sDAAsD;AACtD,MAAM,CAAC,MAAM,eAAe,GAAyC;IACnE,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,IAAI,EAAE,MAAM;IACZ,cAAc,EAAE,SAAS;IACzB,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,WAAW;CACzB,CAAC;AAEF,yDAAyD;AACzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC"}

package/dist/notifications/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @jacques-ai/core/notifications — barrel export
+ *
+ * Single source of truth for notification types, constants, and utilities.
+ */
+export type { NotificationCategory, NotificationPriority, NotificationItem, NotificationSettings, } from './types.js';
+export { DEFAULT_NOTIFICATION_SETTINGS, NOTIFICATION_COOLDOWNS, CATEGORY_SYMBOLS, CATEGORY_LABELS, MAX_NOTIFICATION_HISTORY, } from './constants.js';
+export { getContextThresholdPriority, generateNotificationId, formatNotificationAge, } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/notifications/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/notifications/index.js

@@ -0,0 +1,8 @@
+/**
+ * @jacques-ai/core/notifications — barrel export
+ *
+ * Single source of truth for notification types, constants, and utilities.
+ */
+export { DEFAULT_NOTIFICATION_SETTINGS, NOTIFICATION_COOLDOWNS, CATEGORY_SYMBOLS, CATEGORY_LABELS, MAX_NOTIFICATION_HISTORY, } from './constants.js';
+export { getContextThresholdPriority, generateNotificationId, formatNotificationAge, } from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/notifications/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EACL,6BAA6B,EAC7B,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/notifications/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared notification types for Jacques.
+ *
+ * Used by server, GUI, and CLI — the single source of truth.
+ */
+export type NotificationCategory = 'context' | 'operation' | 'plan' | 'auto-compact' | 'handoff' | 'bug-alert';
+export type NotificationPriority = 'low' | 'medium' | 'high' | 'critical';
+export interface NotificationItem {
+    id: string;
+    category: NotificationCategory;
+    title: string;
+    body: string;
+    priority: NotificationPriority;
+    timestamp: number;
+    sessionId?: string;
+    /** Project name for contextual display (e.g., "my-project") */
+    projectName?: string;
+    /** Git branch name for contextual display (e.g., "feat/auth") */
+    branchName?: string;
+}
+export interface NotificationSettings {
+    enabled: boolean;
+    categories: Record<NotificationCategory, boolean>;
+    largeOperationThreshold: number;
+    contextThresholds: number[];
+    bugAlertThreshold: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/notifications/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,cAAc,GAAG,SAAS,GAAG,WAAW,CAAC;AAC/G,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE1E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;IAClD,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;CAC3B"}

package/dist/notifications/types.js

@@ -0,0 +1,7 @@
+/**
+ * Shared notification types for Jacques.
+ *
+ * Used by server, GUI, and CLI — the single source of truth.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/notifications/types.js.map

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

package/dist/notifications/utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Notification utility functions for Jacques.
+ *
+ * Shared between server, GUI, and CLI.
+ */
+import type { NotificationPriority } from './types.js';
+/**
+ * Returns priority based on a context threshold level.
+ * >=70 → high, <70 → medium
+ */
+export declare function getContextThresholdPriority(threshold: number): NotificationPriority;
+/**
+ * Generate a unique notification ID.
+ */
+export declare function generateNotificationId(category: string, key: string): string;
+/**
+ * Format a timestamp as a human-readable age string.
+ */
+export declare function formatNotificationAge(timestamp: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/notifications/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/notifications/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAGnF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS/D"}

package/dist/notifications/utils.js

@@ -0,0 +1,37 @@
+/**
+ * Notification utility functions for Jacques.
+ *
+ * Shared between server, GUI, and CLI.
+ */
+/**
+ * Returns priority based on a context threshold level.
+ * >=70 → high, <70 → medium
+ */
+export function getContextThresholdPriority(threshold) {
+    if (threshold >= 70)
+        return 'high';
+    return 'medium';
+}
+/**
+ * Generate a unique notification ID.
+ */
+export function generateNotificationId(category, key) {
+    return `notif-${category}-${key}-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
+}
+/**
+ * Format a timestamp as a human-readable age string.
+ */
+export function formatNotificationAge(timestamp) {
+    const seconds = Math.floor((Date.now() - timestamp) / 1000);
+    if (seconds < 60)
+        return 'just now';
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/notifications/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/notifications/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAAiB;IAC3D,IAAI,SAAS,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,GAAW;IAClE,OAAO,SAAS,QAAQ,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5D,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,UAAU,CAAC;IACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,IAAI,OAAO,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,OAAO,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,EAAE;QAAE,OAAO,GAAG,KAAK,OAAO,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IACpC,OAAO,GAAG,IAAI,OAAO,CAAC;AACxB,CAAC"}

package/dist/plan/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Plan Progress Module
+ *
+ * Track completion status of plan items by extracting task signals
+ * from JSONL transcripts and matching them to plan markdown items.
+ */
+export type { PlanItem, ParsedPlan, TaskSignal, PlanItemMatch, PlanItemStatus, PlanItemProgress, PlanProgressSummary, PlanProgress, PlanProgressListItem, } from "./types.js";
+export { parsePlanMarkdown, normalizeText, extractKeywords } from "./plan-parser.js";
+export { extractTaskSignals, getModifiedFiles } from "./task-extractor.js";
+export { matchSignalsToPlanItems, determineItemStatus, isTrackableForProgress, } from "./progress-matcher.js";
+export { computePlanProgress, computePlanProgressSummary, clearProgressCache, clearAllProgressCache, } from "./progress-computer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/plan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plan/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGrF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG3E,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/plan/index.js

@@ -0,0 +1,15 @@
+/**
+ * Plan Progress Module
+ *
+ * Track completion status of plan items by extracting task signals
+ * from JSONL transcripts and matching them to plan markdown items.
+ */
+// Parser
+export { parsePlanMarkdown, normalizeText, extractKeywords } from "./plan-parser.js";
+// Task extraction
+export { extractTaskSignals, getModifiedFiles } from "./task-extractor.js";
+// Matching
+export { matchSignalsToPlanItems, determineItemStatus, isTrackableForProgress, } from "./progress-matcher.js";
+// Progress computation
+export { computePlanProgress, computePlanProgressSummary, clearProgressCache, clearAllProgressCache, } from "./progress-computer.js";
+//# sourceMappingURL=index.js.map

package/dist/plan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plan/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,SAAS;AACT,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAErF,kBAAkB;AAClB,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE3E,WAAW;AACX,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAE/B,uBAAuB;AACvB,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC1B,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/plan/plan-parser.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Plan Parser
+ *
+ * Parses plan markdown into structured trackable items.
+ * Handles headings, numbered lists, bullets, and checkboxes.
+ */
+import type { ParsedPlan } from "./types.js";
+/**
+ * Parse plan markdown content into structured items.
+ *
+ * Trackable items:
+ * - Numbered items (1., 2., etc.)
+ * - Bullet items (-, *)
+ * - Checkbox items (- [ ], - [x])
+ * - Subsection headings (##, ###)
+ *
+ * Skipped:
+ * - Top-level # title
+ * - Code blocks (``` fences)
+ * - Plain paragraphs
+ * - Tables
+ */
+export declare function parsePlanMarkdown(content: string): ParsedPlan;
+/**
+ * Normalize text for comparison.
+ * Lowercase, remove extra whitespace, remove punctuation.
+ */
+export declare function normalizeText(text: string): string;
+/**
+ * Extract keywords from text (words > 3 chars).
+ */
+export declare function extractKeywords(text: string): Set<string>;
+//# sourceMappingURL=plan-parser.d.ts.map

package/dist/plan/plan-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-parser.d.ts","sourceRoot":"","sources":["../../src/plan/plan-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAY,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA4E7D;AA6GD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAGzD"}

package/dist/plan/plan-parser.js

@@ -0,0 +1,189 @@
+/**
+ * Plan Parser
+ *
+ * Parses plan markdown into structured trackable items.
+ * Handles headings, numbered lists, bullets, and checkboxes.
+ */
+/**
+ * Parse plan markdown content into structured items.
+ *
+ * Trackable items:
+ * - Numbered items (1., 2., etc.)
+ * - Bullet items (-, *)
+ * - Checkbox items (- [ ], - [x])
+ * - Subsection headings (##, ###)
+ *
+ * Skipped:
+ * - Top-level # title
+ * - Code blocks (``` fences)
+ * - Plain paragraphs
+ * - Tables
+ */
+export function parsePlanMarkdown(content) {
+    const lines = content.split("\n");
+    const items = [];
+    const lineToItem = new Map();
+    let inCodeBlock = false;
+    let itemCounter = 0;
+    const depthStack = [];
+    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+        const line = lines[lineIndex];
+        const lineNumber = lineIndex + 1; // 1-indexed
+        // Track code blocks
+        if (line.trim().startsWith("```")) {
+            inCodeBlock = !inCodeBlock;
+            continue;
+        }
+        // Skip content inside code blocks
+        if (inCodeBlock) {
+            continue;
+        }
+        // Skip empty lines
+        if (line.trim() === "") {
+            continue;
+        }
+        // Try to parse the line as a trackable item
+        const parsed = parseLine(line, lineNumber, ++itemCounter);
+        if (!parsed) {
+            continue;
+        }
+        // Skip top-level heading (depth 0) - it's just the title
+        if (parsed.type === "heading" && parsed.depth === 0) {
+            itemCounter--; // Don't count it
+            continue;
+        }
+        // Determine parent based on depth
+        while (depthStack.length > 0 &&
+            depthStack[depthStack.length - 1].depth >= parsed.depth) {
+            depthStack.pop();
+        }
+        const parentId = depthStack.length > 0 ? depthStack[depthStack.length - 1].id : null;
+        parsed.parentId = parentId;
+        // Update parent's childIds
+        if (parentId) {
+            const parent = items.find((item) => item.id === parentId);
+            if (parent) {
+                parent.childIds.push(parsed.id);
+            }
+        }
+        // Push to stack for nesting
+        depthStack.push({ id: parsed.id, depth: parsed.depth });
+        items.push(parsed);
+        lineToItem.set(lineNumber, parsed);
+    }
+    // Count trackable items (items that represent actual work, not just structure)
+    const trackableCount = items.filter((item) => isTrackableItem(item)).length;
+    return {
+        items,
+        trackableCount,
+        lineToItem,
+    };
+}
+/**
+ * Parse a single line into a PlanItem if it's a trackable item.
+ * Returns null if the line is not a trackable item.
+ */
+function parseLine(line, lineNumber, itemNumber) {
+    const trimmed = line.trim();
+    // Skip table lines
+    if (trimmed.startsWith("|") || /^[-:|]+$/.test(trimmed)) {
+        return null;
+    }
+    // Skip blockquotes
+    if (trimmed.startsWith(">")) {
+        return null;
+    }
+    // Check for heading (## or deeper)
+    const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+    if (headingMatch) {
+        const depth = headingMatch[1].length - 1; // # = 0, ## = 1, etc.
+        const text = headingMatch[2].trim();
+        return {
+            id: `item-${itemNumber}`,
+            text,
+            depth,
+            type: "heading",
+            lineNumber,
+            parentId: null,
+            childIds: [],
+            isCheckedInSource: false,
+        };
+    }
+    // Calculate indentation for list items
+    const leadingSpaces = line.match(/^(\s*)/)?.[1].length ?? 0;
+    const indentDepth = Math.floor(leadingSpaces / 2); // 2 spaces per indent level
+    // Check for checkbox (- [ ] or - [x] or * [ ] or * [x])
+    const checkboxMatch = trimmed.match(/^[-*]\s+\[([ xX])\]\s+(.+)$/);
+    if (checkboxMatch) {
+        const isChecked = checkboxMatch[1].toLowerCase() === "x";
+        const text = checkboxMatch[2].trim();
+        return {
+            id: `item-${itemNumber}`,
+            text,
+            depth: 3 + indentDepth, // Base depth 3 for list items
+            type: "checkbox",
+            lineNumber,
+            parentId: null,
+            childIds: [],
+            isCheckedInSource: isChecked,
+        };
+    }
+    // Check for numbered item (1., 2., etc.)
+    const numberedMatch = trimmed.match(/^(\d+)\.\s+(.+)$/);
+    if (numberedMatch) {
+        const text = numberedMatch[2].trim();
+        return {
+            id: `item-${itemNumber}`,
+            text,
+            depth: 3 + indentDepth,
+            type: "numbered",
+            lineNumber,
+            parentId: null,
+            childIds: [],
+            isCheckedInSource: false,
+        };
+    }
+    // Check for bullet item (- or *)
+    const bulletMatch = trimmed.match(/^[-*]\s+(.+)$/);
+    if (bulletMatch) {
+        const text = bulletMatch[1].trim();
+        return {
+            id: `item-${itemNumber}`,
+            text,
+            depth: 3 + indentDepth,
+            type: "bullet",
+            lineNumber,
+            parentId: null,
+            childIds: [],
+            isCheckedInSource: false,
+        };
+    }
+    // Not a trackable item
+    return null;
+}
+/**
+ * Determine if an item represents actual trackable work.
+ * Headings are structural; lists and checkboxes are trackable.
+ */
+function isTrackableItem(item) {
+    return item.type !== "heading";
+}
+/**
+ * Normalize text for comparison.
+ * Lowercase, remove extra whitespace, remove punctuation.
+ */
+export function normalizeText(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s]/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/**
+ * Extract keywords from text (words > 3 chars).
+ */
+export function extractKeywords(text) {
+    const normalized = normalizeText(text);
+    return new Set(normalized.split(" ").filter((w) => w.length > 3));
+}
+//# sourceMappingURL=plan-parser.js.map

package/dist/plan/plan-parser.js.map

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

package/dist/plan/progress-computer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Progress Computer
+ *
+ * Orchestrates plan progress computation:
+ * 1. Parse plan markdown
+ * 2. Load linked sessions
+ * 3. Extract task signals
+ * 4. Match signals to plan items
+ * 5. Compute and cache progress
+ */
+import type { PlanEntry } from "../context/types.js";
+import type { PlanProgress, PlanProgressListItem } from "./types.js";
+/**
+ * Compute full progress for a plan.
+ *
+ * @param plan - The plan entry from the project index
+ * @param planContent - The markdown content of the plan
+ * @param cwd - The project working directory
+ */
+export declare function computePlanProgress(plan: PlanEntry, planContent: string, cwd: string): Promise<PlanProgress>;
+/**
+ * Compute a lightweight progress summary for list views.
+ * Faster than full progress - only computes the percentage.
+ */
+export declare function computePlanProgressSummary(plan: PlanEntry, planContent: string, cwd: string): Promise<PlanProgressListItem>;
+/**
+ * Clear the progress cache for a plan.
+ */
+export declare function clearProgressCache(planId: string): Promise<void>;
+/**
+ * Clear all progress cache.
+ */
+export declare function clearAllProgressCache(): Promise<void>;
+//# sourceMappingURL=progress-computer.d.ts.map

package/dist/plan/progress-computer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-computer.d.ts","sourceRoot":"","sources":["../../src/plan/progress-computer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AASrD,OAAO,KAAK,EACV,YAAY,EAEZ,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AAKpB;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,YAAY,CAAC,CAwEvB;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,SAAS,EACf,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AA+FD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOtE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3D"}