@compilr-dev/sdk 0.10.8 → 0.10.9

package/dist/compressors/bash.js

@@ -40,6 +40,27 @@ export function compressBashOutput(command, stdout) {
     // curl / wget (HTTP responses)
     if (cmd.match(/^(curl|wget)\b/))
         return compressCurlOutput(stdout);
+    // GitHub CLI (verbose detail commands — pr/issue view, run view)
+    // List commands (pr list, issue list, run list) are already tabular and compact;
+    // pass them through unchanged.
+    if (cmd.match(/^gh\s+(pr|issue|run)\s+view\b/))
+        return compressGhView(stdout);
+    // Docker
+    // `docker logs` — cap to last N lines (logs blow up the context fast)
+    if (cmd.match(/^docker\s+logs\b/))
+        return compressLogsOutput(stdout);
+    // `docker pull/push/build` — strip noisy progress lines, keep summary
+    if (cmd.match(/^docker\s+(pull|push|build)\b/))
+        return compressDockerProgress(stdout);
+    // `docker ps`, `docker images`, `docker stats` — already tabular and compact, pass through
+    // kubectl
+    // `kubectl logs` — same as docker logs
+    if (cmd.match(/^kubectl\s+logs\b/))
+        return compressLogsOutput(stdout);
+    // `kubectl describe` — verbose, often deeply indented; strip noise + cap repeated events
+    if (cmd.match(/^kubectl\s+describe\b/))
+        return compressKubectlDescribe(stdout);
+    // `kubectl get` — already tabular and compact, pass through
     return null; // No compressor matched
 }
 // ─── Git Status ─────────────────────────────────────────────────────────────
@@ -296,6 +317,208 @@ function compressLsOutput(output) {
     }
     return result.join('\n');
 }
+// ─── GitHub CLI: pr/issue/run view ──────────────────────────────────────────
+/**
+ * Compress `gh pr view`, `gh issue view`, `gh run view` output.
+ *
+ * Strips noise that has zero signal for the agent:
+ *   - HTML comments (often left over from PR/issue templates)
+ *   - Markdown badge images and image-only lines
+ *   - Empty metadata lines (`labels:`, `projects:`, `milestone:` with no value)
+ *   - "🤖 Generated with [Claude Code]" / "Co-Authored-By: ..." footers
+ *     (only the duplicated trailing block — preserves any in-body co-authors
+ *     that appear before the body's last paragraph)
+ *   - The trailing "View this pull request on GitHub: <url>" footer
+ *   - Runs of 3+ blank lines collapsed to a single blank
+ *
+ * Pass-through: keeps title, status, body, labels with values, code blocks.
+ */
+function compressGhView(output) {
+    // Drop HTML comments first (multiline regex)
+    const cleaned = output.replace(/<!--[\s\S]*?-->/g, '');
+    const lines = cleaned.split('\n');
+    const kept = [];
+    let consecutiveBlanks = 0;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Trailing "View this pull request on GitHub: ..." / "View this issue on GitHub: ..."
+        if (/^View this (pull request|issue|workflow run) on GitHub:/i.test(trimmed))
+            continue;
+        // Empty metadata lines: `labels:`, `projects:`, `milestone:`, `assignees:`,
+        // `reviewers:` with no value after the colon.
+        if (/^(labels|projects|milestone|assignees|reviewers|tags):\s*$/i.test(trimmed)) {
+            continue;
+        }
+        // Badge image / image-only markdown lines
+        if (/^\[!\[[^\]]*\]\([^)]*\)\]\([^)]*\)$/.test(trimmed))
+            continue; // [![badge](img)](link)
+        if (/^!\[[^\]]*\]\([^)]*\)$/.test(trimmed))
+            continue; // ![alt](img)
+        // Collapse runs of blank lines (max 1 consecutive)
+        if (trimmed === '') {
+            consecutiveBlanks++;
+            if (consecutiveBlanks > 1)
+                continue;
+        }
+        else {
+            consecutiveBlanks = 0;
+        }
+        kept.push(line);
+    }
+    // Strip a trailing "🤖 Generated with [Claude Code]" / "Co-Authored-By:" footer
+    // if it's the last non-blank block. We only strip if it's clearly the tail —
+    // we don't want to lose co-authors that appear inside the body.
+    while (kept.length > 0) {
+        const last = kept[kept.length - 1].trim();
+        if (last === '') {
+            kept.pop();
+            continue;
+        }
+        if (last.startsWith('🤖 Generated with [Claude Code]') || /^Co-Authored-By:/i.test(last)) {
+            kept.pop();
+            continue;
+        }
+        break;
+    }
+    return kept.join('\n');
+}
+// ─── Container logs (docker logs / kubectl logs) ────────────────────────────
+const LOGS_MAX_LINES = 100;
+/**
+ * Cap container logs to the last N lines. Logs typically blow up token
+ * usage fast (a single container can produce thousands of lines), and the
+ * agent almost always wants the tail (most-recent failure / state).
+ *
+ * Drops a single banner line at the top noting how many lines were truncated
+ * so the agent knows the output was clipped.
+ */
+function compressLogsOutput(output) {
+    const lines = output.split('\n');
+    // Don't compress small outputs — the cap is the only thing this compressor does.
+    if (lines.length <= LOGS_MAX_LINES)
+        return output;
+    const truncated = lines.length - LOGS_MAX_LINES;
+    const tail = lines.slice(-LOGS_MAX_LINES);
+    return `... (${String(truncated)} earlier log lines truncated — showing last ${String(LOGS_MAX_LINES)})\n${tail.join('\n')}`;
+}
+// ─── docker pull / push / build (strip progress noise) ──────────────────────
+/**
+ * Strip per-layer progress lines from `docker pull/push/build`. Keeps the
+ * digest / "Status: Image is up to date" / "Successfully built" summary lines.
+ *
+ * Patterns dropped (all common Docker progress chatter):
+ *   - "<hash>: Pulling fs layer"
+ *   - "<hash>: Waiting"
+ *   - "<hash>: Verifying Checksum"
+ *   - "<hash>: Downloading [====>     ] 12.3MB/45.6MB"
+ *   - "<hash>: Pull complete" / "Extracting" / "Download complete"
+ *   - BuildKit progress lines: "#5 [internal] load build context"
+ *   - Build context transfer lines
+ */
+function compressDockerProgress(output) {
+    const lines = output.split('\n');
+    const kept = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Per-layer progress patterns (hash prefix + colon + status)
+        if (/^[a-f0-9]{12}:\s+(Pulling fs layer|Waiting|Verifying Checksum|Download complete|Pull complete|Extracting|Downloading|Pushing|Pushed|Mounted from|Layer already exists|Preparing|Already exists)/i.test(trimmed)) {
+            continue;
+        }
+        // BuildKit transfer lines: "#N transferring context: 1.23MB"
+        if (/^#\d+\s+(transferring|sha256:|extracting|naming to|exporting layers|writing image)/.test(trimmed))
+            continue;
+        // Plain "Downloading [====> ] 12MB/45MB" without hash prefix
+        if (/^\s*Downloading\s+\[/.test(line))
+            continue;
+        kept.push(line);
+    }
+    return kept.join('\n');
+}
+// ─── kubectl describe (collapse indentation noise, dedupe events) ───────────
+/**
+ * Compress `kubectl describe` output. The verbose describe format is highly
+ * indented and includes long Events tables that often duplicate the same
+ * message N times ("Back-off restarting failed container").
+ *
+ * Strategy:
+ *   - Trim trailing whitespace on every line (huge amount of padding)
+ *   - Collapse 3+ consecutive blank lines to a single blank
+ *   - In the Events: section, dedupe identical messages — keep first occurrence
+ *     plus a count of repeats ("(x42)")
+ */
+function compressKubectlDescribe(output) {
+    const lines = output.split('\n');
+    const kept = [];
+    let inEvents = false;
+    let consecutiveBlanks = 0;
+    // Track event message → count (only used inside Events: section)
+    const eventCounts = new Map();
+    const eventOrder = [];
+    for (const line of lines) {
+        const rstripped = line.replace(/\s+$/, '');
+        const trimmed = rstripped.trim();
+        // Section header transitions
+        if (/^Events:\s*$/.test(trimmed)) {
+            inEvents = true;
+            kept.push(rstripped);
+            continue;
+        }
+        if (inEvents && /^\S/.test(rstripped) && !/^Events:/.test(trimmed)) {
+            // A non-indented, non-Events: line means we've left the Events section.
+            // Flush deduped events first.
+            flushEvents(kept, eventCounts, eventOrder);
+            inEvents = false;
+        }
+        if (inEvents) {
+            // Inside Events table — collect by "type + reason + message" (drop timestamp/age columns)
+            // Lines look like:
+            //   "  Type     Reason     Age   From     Message"
+            //   "  ----     ------     ---   ----     -------"
+            //   "  Warning  BackOff    1m    kubelet  Back-off restarting failed container"
+            if (trimmed === '' || /^(Type|----)/.test(trimmed)) {
+                kept.push(rstripped);
+                continue;
+            }
+            // Extract the message (everything after the first 4 whitespace-separated columns)
+            const parts = trimmed.split(/\s{2,}/); // 2+ spaces between columns
+            const key = parts.length > 4 ? parts.slice(-1)[0] : trimmed;
+            const count = eventCounts.get(key) ?? 0;
+            if (count === 0)
+                eventOrder.push(rstripped);
+            eventCounts.set(key, count + 1);
+            continue;
+        }
+        // Collapse runs of blank lines
+        if (trimmed === '') {
+            consecutiveBlanks++;
+            if (consecutiveBlanks > 1)
+                continue;
+        }
+        else {
+            consecutiveBlanks = 0;
+        }
+        kept.push(rstripped);
+    }
+    // Flush any pending events at the end
+    if (inEvents)
+        flushEvents(kept, eventCounts, eventOrder);
+    return kept.join('\n');
+}
+function flushEvents(kept, counts, order) {
+    for (const line of order) {
+        const parts = line.trim().split(/\s{2,}/);
+        const key = parts.length > 4 ? parts.slice(-1)[0] : line.trim();
+        const count = counts.get(key) ?? 1;
+        if (count > 1) {
+            kept.push(`${line}  (x${String(count)})`);
+        }
+        else {
+            kept.push(line);
+        }
+    }
+    counts.clear();
+    order.length = 0;
+}
 // ─── curl / wget ────────────────────────────────────────────────────────────
 function compressCurlOutput(output) {
     const lines = output.split('\n');

package/dist/detection/common.js

@@ -79,6 +79,11 @@ function readGitRemote(projectPath) {
 }
 /**
  * Read description from README.md or COMPILR.md (first non-heading paragraph).
+ *
+ * Skips noise commonly found above the first prose paragraph in auto-generated
+ * READMEs: headings, badge images, HTML comments, block-quote callouts, URL-only
+ * lines, and `**Key**: value` bold-metadata lines (e.g. Lovable's `**URL**: ...`,
+ * v0/Vercel templates with `**Demo**: ...`).
  */
 function readDescription(projectPath) {
     const candidates = ['README.md', 'readme.md', 'COMPILR.md'];
@@ -89,7 +94,7 @@ function readDescription(projectPath) {
         try {
             const content = readFileSync(filePath, 'utf-8');
             const lines = content.split('\n');
-            // Find first non-empty, non-heading line
+            // Find first non-empty, non-heading, non-metadata line
             for (const line of lines) {
                 const trimmed = line.trim();
                 if (!trimmed)
@@ -99,7 +104,13 @@ function readDescription(projectPath) {
                 if (trimmed.startsWith('!['))
                     continue; // badge images
                 if (trimmed.startsWith('<!--'))
-                    continue;
+                    continue; // HTML comments
+                if (trimmed.startsWith('>'))
+                    continue; // block-quote callouts / "Note:" disclaimers
+                if (/^\*\*[\w\s/-]+\*\*\s*:/.test(trimmed))
+                    continue; // bold-key metadata: **URL**: ..., **Live Demo**: ...
+                if (/^https?:\/\/\S+\s*$/.test(trimmed))
+                    continue; // URL-only lines
                 // Found a content line — take up to 200 chars
                 return trimmed.length > 200 ? trimmed.slice(0, 200) + '...' : trimmed;
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/sdk",
-  "version": "0.10.8",
+  "version": "0.10.9",
   "description": "Universal agent runtime for building AI-powered applications",
   "type": "module",
   "main": "dist/index.js",