@dungle-scrubs/tallow 0.8.28 → 0.9.0

package/extensions/plan-mode-tool/utils.ts

@@ -1,257 +0,0 @@
-/**
- * Pure utility functions for plan mode.
- * Extracted for testability — no extension API dependencies.
- */
-
-// ── Natural language plan intent detection ──────────────────────────────
-
-/**
- * Curated patterns that unambiguously express "enter planning mode".
- * Each pattern uses word boundaries to avoid matching plan-as-noun usage
- * (e.g. "make a plan for X") or questions about plan mode.
- */
-export const PLAN_INTENT_PATTERNS: readonly RegExp[] = [
-	// Composite patterns first — avoids partial stripping of overlapping phrases
-	/\bthis\s+is\s+plan(ning)?(\s+only)?\b/i,
-	/\bplan[\s-]only\b/i,
-	/\bjust\s+plan\b/i,
-	/\bonly\s+plan\b/i,
-	/\bplan\s+mode\b(?!\s*(\?|do|work|mean))/i,
-	/\bplanning\s+mode\b(?!\s*(\?|do|work|mean))/i,
-	/\bdon['\u2019]?t\s+(implement|code|execute|make\s+changes)\b/i,
-	/\bdo\s+not\s+(implement|code|execute|make\s+changes)\b/i,
-	/\bno\s+(implementation|changes|coding)\s+(yet|first|for\s+now)\b/i,
-	/\bread[\s-]only\s+mode\b/i,
-	/\bplan\s+(first|before)\b/i,
-];
-
-/**
- * Detects whether user input contains a strong planning-intent directive.
- *
- * Only matches unambiguous directives like "plan only" or "don't implement".
- * Does NOT match noun usage ("the plan is…") or questions ("what does plan mode do?").
- *
- * @param text - Raw user input
- * @returns true when any plan-intent pattern matches
- */
-export function detectPlanIntent(text: string): boolean {
-	return PLAN_INTENT_PATTERNS.some((pattern) => pattern.test(text));
-}
-
-/**
- * Strips plan-intent phrases from user input, preserving the actual request.
- *
- * If stripping leaves an empty string (the entire message was just "plan only"),
- * returns the original text so the model has something to work with.
- *
- * @param text - Raw user input
- * @returns Cleaned text with plan-intent phrases removed, or original if nothing remains
- */
-export function stripPlanIntent(text: string): string {
-	let stripped = text;
-	for (const pattern of PLAN_INTENT_PATTERNS) {
-		stripped = stripped.replace(pattern, "");
-	}
-	// Clean up artifacts: leading/trailing punctuation, double spaces, dangling commas
-	stripped = stripped
-		.replace(/^[\s,.\-—;:]+/, "")
-		.replace(/[\s,.\-—;:]+$/, "")
-		.replace(/\s{2,}/g, " ")
-		.trim();
-	return stripped || text;
-}
-
-// ── Bash safety ─────────────────────────────────────────────────────────
-
-/** Patterns for destructive commands that are blocked in plan mode */
-const DESTRUCTIVE_PATTERNS = [
-	/\brm\b/i,
-	/\brmdir\b/i,
-	/\bmv\b/i,
-	/\bcp\b/i,
-	/\bmkdir\b/i,
-	/\btouch\b/i,
-	/\bchmod\b/i,
-	/\bchown\b/i,
-	/\bchgrp\b/i,
-	/\bln\b/i,
-	/\btee\b/i,
-	/\btruncate\b/i,
-	/\bdd\b/i,
-	/\bshred\b/i,
-	/(^|[^<])>(?!>)/,
-	/>>/,
-	/\bnpm\s+(install|uninstall|update|ci|link|publish)/i,
-	/\byarn\s+(add|remove|install|publish)/i,
-	/\bpnpm\s+(add|remove|install|publish)/i,
-	/\bpip\s+(install|uninstall)/i,
-	/\bapt(-get)?\s+(install|remove|purge|update|upgrade)/i,
-	/\bbrew\s+(install|uninstall|upgrade)/i,
-	/\bgit\s+(add|commit|push|pull|merge|rebase|reset|checkout|branch\s+-[dD]|stash|cherry-pick|revert|tag|init|clone)/i,
-	/\bsudo\b/i,
-	/\bsu\b/i,
-	/\bkill\b/i,
-	/\bpkill\b/i,
-	/\bkillall\b/i,
-	/\breboot\b/i,
-	/\bshutdown\b/i,
-	/\bsystemctl\s+(start|stop|restart|enable|disable)/i,
-	/\bservice\s+\S+\s+(start|stop|restart)/i,
-	/\b(vim?|nano|emacs|code|subl)\b/i,
-];
-
-/** Patterns for safe read-only commands allowed in plan mode */
-const SAFE_PATTERNS = [
-	/^\s*cat\b/,
-	/^\s*head\b/,
-	/^\s*tail\b/,
-	/^\s*less\b/,
-	/^\s*more\b/,
-	/^\s*grep\b/,
-	/^\s*find\b/,
-	/^\s*ls\b/,
-	/^\s*pwd\b/,
-	/^\s*echo\b/,
-	/^\s*printf\b/,
-	/^\s*wc\b/,
-	/^\s*sort\b/,
-	/^\s*uniq\b/,
-	/^\s*diff\b/,
-	/^\s*file\b/,
-	/^\s*stat\b/,
-	/^\s*du\b/,
-	/^\s*df\b/,
-	/^\s*tree\b/,
-	/^\s*which\b/,
-	/^\s*whereis\b/,
-	/^\s*type\b/,
-	/^\s*env\b/,
-	/^\s*printenv\b/,
-	/^\s*uname\b/,
-	/^\s*whoami\b/,
-	/^\s*id\b/,
-	/^\s*date\b/,
-	/^\s*cal\b/,
-	/^\s*uptime\b/,
-	/^\s*ps\b/,
-	/^\s*top\b/,
-	/^\s*htop\b/,
-	/^\s*free\b/,
-	/^\s*git\s+(status|log|diff|show|branch|remote|config\s+--get)/i,
-	/^\s*git\s+ls-/i,
-	/^\s*npm\s+(list|ls|view|info|search|outdated|audit)/i,
-	/^\s*yarn\s+(list|info|why|audit)/i,
-	/^\s*node\s+--version/i,
-	/^\s*python\s+--version/i,
-	/^\s*curl\s/i,
-	/^\s*wget\s+-O\s*-/i,
-	/^\s*jq\b/,
-	/^\s*sed\s+-n/i,
-	/^\s*awk\b/,
-	/^\s*rg\b/,
-	/^\s*fd\b/,
-	/^\s*bat\b/,
-	/^\s*exa\b/,
-];
-
-/** Strict allowlist of tool names permitted while plan mode is enabled. */
-export const PLAN_MODE_ALLOWED_TOOLS = [
-	"bash",
-	"find",
-	"grep",
-	"ls",
-	"plan_mode",
-	"questionnaire",
-	"read",
-] as const;
-
-/** Lookup set for plan-mode allowlisted tools. */
-const PLAN_MODE_ALLOWED_TOOL_SET = new Set<string>(PLAN_MODE_ALLOWED_TOOLS);
-
-/**
- * Checks whether a tool is allowlisted for plan mode.
- *
- * Plan mode is fail-closed: unknown tools are blocked by default.
- *
- * @param toolName - Tool name to evaluate
- * @returns True when the tool is explicitly allowlisted
- */
-export function isPlanModeToolAllowed(toolName: string): boolean {
-	return PLAN_MODE_ALLOWED_TOOL_SET.has(toolName);
-}
-
-/**
- * Checks if a bash command is safe to run in plan mode.
- * @param command - The bash command to check
- * @returns true if the command is safe (read-only), false otherwise
- */
-export function isSafeCommand(command: string): boolean {
-	const isDestructive = DESTRUCTIVE_PATTERNS.some((p) => p.test(command));
-	const isSafe = SAFE_PATTERNS.some((p) => p.test(command));
-	return !isDestructive && isSafe;
-}
-
-/** Represents a single todo item in a plan */
-export interface TodoItem {
-	step: number;
-	text: string;
-	completed: boolean;
-}
-
-/**
- * Cleans up step text for display by removing markdown and truncating.
- * @param text - The raw step text from the plan
- * @returns Cleaned and truncated text suitable for display
- */
-export function cleanStepText(text: string): string {
-	let cleaned = text
-		.replace(/\*{1,2}([^*]+)\*{1,2}/g, "$1")
-		.replace(/`([^`]+)`/g, "$1")
-		.replace(
-			/^(Use|Run|Execute|Create|Write|Read|Check|Verify|Update|Modify|Add|Remove|Delete|Install)\s+(the\s+)?/i,
-			""
-		)
-		.replace(/\s+/g, " ")
-		.trim();
-
-	if (cleaned.length > 0) {
-		cleaned = cleaned.charAt(0).toUpperCase() + cleaned.slice(1);
-	}
-	if (cleaned.length > 50) {
-		cleaned = `${cleaned.slice(0, 47)}...`;
-	}
-	return cleaned;
-}
-
-/**
- * Extracts numbered todo items from a plan section in a message.
- * @param message - The message text to parse
- * @returns Array of extracted todo items
- */
-export function extractTodoItems(message: string): TodoItem[] {
-	const items: TodoItem[] = [];
-	const headerMatch = message.match(/\*{0,2}Plan:\*{0,2}\s*\n/i);
-	if (!headerMatch) return items;
-
-	const planSection = message.slice(message.indexOf(headerMatch[0]) + headerMatch[0].length);
-	const numberedPattern = /^\s*(\d+)[.)]\s+\*{0,2}([^*\n]+)/gm;
-
-	for (const match of planSection.matchAll(numberedPattern)) {
-		const text = match[2]
-			.trim()
-			.replace(/\*{1,2}$/, "")
-			.trim();
-		if (
-			text.length > 5 &&
-			!text.startsWith("`") &&
-			!text.startsWith("/") &&
-			!text.startsWith("-")
-		) {
-			const cleaned = cleanStepText(text);
-			if (cleaned.length > 3) {
-				items.push({ step: items.length + 1, text: cleaned, completed: false });
-			}
-		}
-	}
-	return items;
-}