pi-harness-runtime 1.1.398 → 1.1.402

package/packages/todo-bd-sync/dist/task-analyzer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Smart Auto-Todo Task Analyzer
+ *
+ * Decides when to automatically create bd issues based on:
+ * 1. Task complexity signals
+ * 2. Session state (pending task count)
+ *
+ * Philosophy:
+ * - Simple tasks (grep, quick edit) -> NO todo (avoid noise)
+ * - Complex tasks OR multiple pending tasks -> AUTO-CREATE todo
+ */
+interface TaskSignals {
+    /** Estimated number of steps required */
+    stepCount: number;
+    /** Number of files likely involved */
+    fileCount: number;
+    /** Requires research (web search, docs lookup) */
+    needsResearch: boolean;
+    /** Creates new files */
+    createsFiles: boolean;
+    /** User explicitly says task is complex */
+    explicitlyComplex: boolean;
+    /** Likely to have subtasks discovered during work */
+    likelySubtasks: boolean;
+}
+/**
+ * Analyze user request text for complexity signals
+ */
+export declare function analyzeTaskSignals(userMessage: string): TaskSignals;
+export interface AutoTodoDecision {
+    shouldCreate: boolean;
+    reason: string;
+    confidence: "high" | "medium" | "low";
+    skipReason?: string;
+}
+/**
+ * Decide whether to auto-create a todo for the given task
+ */
+export declare function decideAutoTodo(userMessage: string, options?: {
+    forceMode?: boolean;
+    skipMode?: boolean;
+}): AutoTodoDecision;
+/**
+ * Quick numeric score (0-100) for task complexity
+ * Higher = more likely to need a todo
+ */
+export declare function getTaskComplexityScore(userMessage: string): number;
+export {};
+//# sourceMappingURL=task-analyzer.d.ts.map

package/packages/todo-bd-sync/dist/task-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-analyzer.d.ts","sourceRoot":"","sources":["../src/task-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,UAAU,WAAW;IACpB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,aAAa,EAAE,OAAO,CAAC;IACvB,wBAAwB;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,2CAA2C;IAC3C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,qDAAqD;IACrD,cAAc,EAAE,OAAO,CAAC;CACxB;AA4CD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CA4DnE;AAID,MAAM,WAAW,gBAAgB;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC7B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACR,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACd,GACJ,gBAAgB,CAsHlB;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA+BlE"}

package/packages/todo-bd-sync/dist/task-analyzer.js

@@ -0,0 +1,240 @@
+/**
+ * Smart Auto-Todo Task Analyzer
+ *
+ * Decides when to automatically create bd issues based on:
+ * 1. Task complexity signals
+ * 2. Session state (pending task count)
+ *
+ * Philosophy:
+ * - Simple tasks (grep, quick edit) -> NO todo (avoid noise)
+ * - Complex tasks OR multiple pending tasks -> AUTO-CREATE todo
+ */
+import { getOpenBdIssues } from "./sync.js";
+const COMPLEX_KEYWORDS = [
+    "complicated",
+    "complex",
+    "tricky",
+    "difficult",
+    "refactor",
+    "architecture",
+    "design",
+    "implement from scratch",
+    "rewrite",
+    "investigate",
+    "debug",
+    "fix the bug",
+    "performance",
+];
+const RESEARCH_KEYWORDS = [
+    "search",
+    "look up",
+    "find",
+    "research",
+    "check",
+    "verify",
+    "how to",
+    "best practice",
+    "compare",
+    "evaluate",
+    "review",
+];
+const SUBTASK_KEYWORDS = [
+    "also",
+    "plus",
+    "and also",
+    "while you're at it",
+    "on top of that",
+    "additionally",
+    "another thing",
+    "don't forget",
+    "should also",
+];
+/**
+ * Analyze user request text for complexity signals
+ */
+export function analyzeTaskSignals(userMessage) {
+    const lower = userMessage.toLowerCase();
+    // Count implied steps from action verbs
+    const actionVerbs = [
+        "create",
+        "build",
+        "implement",
+        "design",
+        "setup",
+        "configure",
+        "migrate",
+        "convert",
+        "refactor",
+        "optimize",
+        "fix",
+        "update",
+        "add",
+        "remove",
+        "delete",
+        "modify",
+        "change",
+        "replace",
+    ];
+    const stepCount = Math.max(1, actionVerbs.filter((v) => lower.includes(v)).length);
+    // Estimate file count from file paths and extensions
+    const filePatterns = /[\w-]+\.(ts|js|py|json|md|yaml|yml|tsx|jsx|html|css|sql)/g;
+    const fileMatches = userMessage.match(filePatterns) || [];
+    const explicitFiles = fileMatches.length;
+    // Check for directory patterns
+    const dirPatterns = /(?:src|lib|packages|apps|components|hooks|utils|api)\/[\w/-]+/g;
+    const dirMatches = userMessage.match(dirPatterns) || [];
+    // Count "and", "also", "+" for multi-task indicators
+    const multiTaskIndicator = (lower.match(/and also|also|\+/g) || []).length;
+    const estimatedFiles = Math.max(1, explicitFiles + dirMatches.length + multiTaskIndicator);
+    return {
+        stepCount,
+        fileCount: estimatedFiles,
+        needsResearch: RESEARCH_KEYWORDS.some((k) => lower.includes(k)),
+        createsFiles: lower.includes("create") ||
+            lower.includes("add") ||
+            lower.includes("new"),
+        explicitlyComplex: COMPLEX_KEYWORDS.some((k) => lower.includes(k)),
+        likelySubtasks: SUBTASK_KEYWORDS.some((k) => lower.includes(k)) ||
+            multiTaskIndicator >= 2,
+    };
+}
+/**
+ * Decide whether to auto-create a todo for the given task
+ */
+export function decideAutoTodo(userMessage, options = {}) {
+    const signals = analyzeTaskSignals(userMessage);
+    const pendingTasks = getOpenBdIssues().filter((i) => i.status !== "closed");
+    const pendingCount = pendingTasks.length;
+    // ── Skip Conditions ────────────────────────────────────────────────────
+    // Never create todos for these
+    const simplePatterns = [
+        /^simply\s/i,
+        /^just\s/i,
+        /^quick\s/i,
+        /^can you\s+(grep|find|cat|ls|echo)/i,
+        /^(grep|find|cat|ls)\s+[\w.-]+/i,
+        /^what('s| is) the\s+\w+\s+\?$/i,
+        /^how do i\s+\w+\s*\?$/i,
+    ];
+    if (simplePatterns.some((p) => p.test(userMessage.trim()))) {
+        return {
+            shouldCreate: false,
+            reason: "Simple request (lookup/one-liner)",
+            confidence: "high",
+            skipReason: "Task is too simple to warrant tracking",
+        };
+    }
+    // Check for trivial single actions with no complexity (lower threshold)
+    // Allow more tasks to be tracked - being conservative about NOT tracking
+    const isTrivial = signals.stepCount === 1 &&
+        signals.fileCount <= 1 &&
+        !signals.needsResearch &&
+        !signals.createsFiles &&
+        !signals.explicitlyComplex &&
+        pendingCount === 0 &&
+        !signals.likelySubtasks;
+    if (isTrivial) {
+        return {
+            shouldCreate: false,
+            reason: "Trivial request (single action)",
+            confidence: "high",
+            skipReason: "Task is trivial",
+        };
+    }
+    // ── Force Modes ──────────────────────────────────────────────────────
+    if (options.forceMode) {
+        return {
+            shouldCreate: true,
+            reason: "Force mode enabled",
+            confidence: "high",
+        };
+    }
+    if (options.skipMode) {
+        return {
+            shouldCreate: false,
+            reason: "Skip mode enabled",
+            confidence: "high",
+            skipReason: "User requested skip",
+        };
+    }
+    // ── Auto-Create Conditions ──────────────────────────────────────────
+    // Be MORE aggressive about tracking tasks - default to tracking
+    const reasons = [];
+    // HIGH CONFIDENCE: Task explicitly complex
+    if (signals.explicitlyComplex) {
+        reasons.push("explicitly complex");
+    }
+    // HIGH CONFIDENCE: Multiple steps (lower from 3 to 2)
+    if (signals.stepCount >= 2) {
+        reasons.push(`${signals.stepCount} steps implied`);
+    }
+    // HIGH CONFIDENCE: Multiple files (lower from 3 to 2)
+    if (signals.fileCount >= 2) {
+        reasons.push(`${signals.fileCount} files involved`);
+    }
+    // MEDIUM CONFIDENCE: Research needed
+    if (signals.needsResearch) {
+        reasons.push("needs research");
+    }
+    // MEDIUM CONFIDENCE: Creates files
+    if (signals.createsFiles) {
+        reasons.push("creates files");
+    }
+    // MEDIUM CONFIDENCE: Likely subtasks
+    if (signals.likelySubtasks) {
+        reasons.push("likely has subtasks");
+    }
+    // MEDIUM CONFIDENCE: Has pending tasks already (session busy)
+    if (pendingCount >= 1) {
+        reasons.push(`${pendingCount} pending tasks`);
+    }
+    // Default to creating todo if any signal present
+    // Be conservative only for truly trivial requests (already filtered above)
+    if (reasons.length === 0) {
+        // No strong signals but not trivial either - track it anyway
+        reasons.push("multi-step task detected");
+    }
+    // Create todo if ANY reason OR any pending tasks
+    const shouldCreate = reasons.length >= 1 || pendingCount >= 1;
+    return {
+        shouldCreate,
+        reason: reasons.join(", "),
+        confidence: reasons.length >= 2 ? "high" : "medium",
+    };
+}
+// ─── Quick Score ─────────────────────────────────────────────────────────────
+/**
+ * Quick numeric score (0-100) for task complexity
+ * Higher = more likely to need a todo
+ */
+export function getTaskComplexityScore(userMessage) {
+    const signals = analyzeTaskSignals(userMessage);
+    const pendingTasks = getOpenBdIssues().filter((i) => i.status !== "closed");
+    let score = 0;
+    // Step count (0-25)
+    score += Math.min(25, signals.stepCount * 8);
+    // File count (0-20)
+    score += Math.min(20, signals.fileCount * 5);
+    // Research needed (0-15)
+    if (signals.needsResearch)
+        score += 15;
+    // Creates files (0-10)
+    if (signals.createsFiles)
+        score += 10;
+    // Explicitly complex (0-20)
+    if (signals.explicitlyComplex)
+        score += 20;
+    // Likely subtasks (0-10)
+    if (signals.likelySubtasks)
+        score += 10;
+    // Pending task overload (0-25)
+    const pendingCount = pendingTasks.length;
+    if (pendingCount >= 3)
+        score += 25;
+    else if (pendingCount >= 2)
+        score += 15;
+    else if (pendingCount >= 1)
+        score += 5;
+    return Math.min(100, score);
+}
+//# sourceMappingURL=task-analyzer.js.map

package/packages/todo-bd-sync/dist/task-analyzer.js.map

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

package/packages/todo-bd-sync/dist/todo-reminder.d.ts

@@ -0,0 +1,126 @@
+/**
+ * todo-reminder.ts - Inject reminders to continue remaining todos
+ *
+ * ARCHITECTURE NOTES:
+ * - Reminders are DISABLED by default (Phase 1 emergency containment)
+ *   until proper scoping is implemented.
+ * - Triggers are narrowed: only after agent_end, not every bash command.
+ * - Deduplication is persistent via file-based hash (survives process restart).
+ * - Source is scoped to sync-layer-mapped tasks only.
+ *
+ * This module does NOT modify the overlay (it works fine).
+ * It ONLY injects reminders into the LLM context when todos remain.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/**
+ * A task that is tracked by the sync layer
+ */
+interface TrackedTask {
+    id: string;
+    title: string;
+    status: string;
+}
+/**
+ * Configuration for todo reminder
+ */
+export interface TodoReminderConfig {
+    /** Auto-inject reminder on agent_end (default: FALSE — containment) */
+    autoRemind?: boolean;
+    /** Custom reminder template (default: built-in) */
+    template?: string;
+    /** Minimum pending tasks to trigger reminder (default: 1) */
+    minPendingTasks?: number;
+    /** Deliver reminder as: "steer" | "followUp" (default: "steer") */
+    deliverAs?: "steer" | "followUp";
+    /** Enable verbose debug logging */
+    verbose?: boolean;
+}
+/**
+ * Create a todo reminder instance
+ */
+export declare function createTodoReminder(pi: ExtensionAPI, config?: TodoReminderConfig): TodoReminder;
+/**
+ * TodoReminder class — injects reminders when todos remain.
+ *
+ * Key design decisions:
+ * 1. DISABLED by default (autoRemind: false) — Phase 1 containment
+ * 2. Deduplication is persistent via file-based hash (survives process restart)
+ * 3. Narrow trigger: only agent_end, never generic bash
+ * 4. deliverAs: "steer" avoids transcript growth
+ */
+export declare class TodoReminder {
+    private pi;
+    private config;
+    private lastReminderAt;
+    private state;
+    constructor(pi: ExtensionAPI, config: Required<TodoReminderConfig>);
+    /**
+     * Start the reminder system
+     */
+    start(): void;
+    /**
+     * Check if reminders should be sent and send them
+     */
+    private checkAndRemind;
+    /**
+     * Get remaining (pending/in-progress) todos from bd.
+     *
+     * NOTE: This returns ALL open bd issues, not just mapped ones.
+     * When the mapping registry is integrated, this should be scoped.
+     */
+    private getTrackedTodos;
+    /**
+     * Format the reminder message
+     */
+    private formatReminder;
+    /**
+     * Send the reminder to the LLM.
+     *
+     * FIX: Re-check state before send to prevent stale reminders.
+     * If a task was closed after we prepared the reminder, skip delivery.
+     */
+    private sendReminder;
+    /**
+     * Manually trigger a reminder (for slash command)
+     */
+    triggerNow(): Promise<void>;
+    /**
+     * Get current remaining count
+     */
+    getRemainingCount(): number;
+    /**
+     * Clear the persistent dedupe state (for testing or manual reset)
+     */
+    clearState(): void;
+}
+/**
+ * Create a reminder with custom todos source (for tighter scoping)
+ * @param pi - Extension API
+ * @param getRemaining - Function that returns remaining todos
+ * @param config - Reminder config
+ */
+export declare function createCustomReminder(pi: ExtensionAPI, getRemaining: () => TrackedTask[], config?: TodoReminderConfig): CustomTodoReminder;
+/**
+ * Custom reminder with injectable todos source.
+ * Use this to scope reminders to only mapped/created tasks.
+ */
+declare class CustomTodoReminder {
+    private pi;
+    private getRemaining;
+    private config;
+    private lastReminderAt;
+    private state;
+    constructor(pi: ExtensionAPI, getRemaining: () => TrackedTask[], config: TodoReminderConfig);
+    start(): void;
+    private checkAndRemind;
+    private formatReminder;
+    private sendReminder;
+    triggerNow(): Promise<void>;
+    getRemainingCount(): number;
+    /**
+     * Clear the persistent dedupe state
+     */
+    clearState(): void;
+}
+export {};
+//# sourceMappingURL=todo-reminder.d.ts.map

package/packages/todo-bd-sync/dist/todo-reminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo-reminder.d.ts","sourceRoot":"","sources":["../src/todo-reminder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AA+DpE;;GAEG;AACH,UAAU,WAAW;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAYD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mEAAmE;IACnE,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACjC,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAeD;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,EAAE,EAAE,YAAY,EAChB,MAAM,GAAE,kBAAuB,GAC7B,YAAY,CAGd;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,KAAK,CAAgB;IAE7B,YAAY,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAKjE;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAUZ;IAED;;OAEG;YACW,cAAc;IA4B5B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAmBvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;;;;OAKG;YACW,YAAY;IA8B1B;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhC;IAED;;OAEG;IACH,iBAAiB,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,UAAU,IAAI,IAAI,CAGjB;CACD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CACnC,EAAE,EAAE,YAAY,EAChB,YAAY,EAAE,MAAM,WAAW,EAAE,EACjC,MAAM,GAAE,kBAAuB,GAC7B,kBAAkB,CAEpB;AAED;;;GAGG;AACH,cAAM,kBAAkB;IACvB,OAAO,CAAC,EAAE,CAAe;IACzB,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,KAAK,CAAgB;IAE7B,YACC,EAAE,EAAE,YAAY,EAChB,YAAY,EAAE,MAAM,WAAW,EAAE,EACjC,MAAM,EAAE,kBAAkB,EAO1B;IAED,KAAK,IAAI,IAAI,CAOZ;YAEa,cAAc;IAqB5B,OAAO,CAAC,cAAc;YAQR,YAAY;IA4BpB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEhC;IAED,iBAAiB,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,UAAU,IAAI,IAAI,CAGjB;CACD"}