@penadidik/meo-agent 1.2.0

package/lib/reporter.js

@@ -0,0 +1,108 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+class Reporter {
+    constructor(opts) {
+        this.json = opts.json || false;
+        this.quiet = opts.quiet || false;
+        this.url = null;
+        this.output = null;
+        this.startedAt = 0;
+        this.lastReport = 0;
+        this.totalBytes = 0;
+        this.receivedBytes = 0;
+        this.barWidth = 30;
+    }
+
+    _emit(event, data) {
+        if (this.json) {
+            process.stdout.write(JSON.stringify({ event, ...data, ts: Date.now() }) + '\n');
+        }
+    }
+
+    start(url, output) {
+        this.url = url;
+        this.output = output;
+        this.startedAt = Date.now();
+        this.lastReport = this.startedAt;
+        this.receivedBytes = 0;
+        this.totalBytes = 0;
+
+        if (!this.quiet && !this.json) {
+            process.stderr.write(`Downloading ${url}\n  → ${output}\n`);
+        }
+        this._emit('start', { url, output });
+    }
+
+    setTotal(bytes) {
+        this.totalBytes = bytes;
+    }
+
+    progress(received) {
+        this.receivedBytes = received;
+        const now = Date.now();
+
+        if (this.json) {
+            this._emit('progress', {
+                received,
+                total: this.totalBytes,
+                percent: this.totalBytes ? Math.round((received / this.totalBytes) * 100) : null
+            });
+            return;
+        }
+
+        if (this.quiet) return;
+
+        if (now - this.lastReport < 100 && this.totalBytes) return;
+        this.lastReport = now;
+
+        const percent = this.totalBytes ? Math.min(100, Math.round((received / this.totalBytes) * 100)) : 0;
+        const filled = Math.round((percent / 100) * this.barWidth);
+        const empty = this.barWidth - filled;
+        const bar = '█'.repeat(filled) + '░'.repeat(empty);
+        const mbReceived = (received / 1024 / 1024).toFixed(2);
+        const mbTotal = this.totalBytes ? (this.totalBytes / 1024 / 1024).toFixed(2) : '?';
+
+        process.stderr.write(`\r  [${bar}] ${percent}%  ${mbReceived} / ${mbTotal} MB`);
+    }
+
+    finish({ statusCode, resumed }) {
+        const elapsed = ((Date.now() - this.startedAt) / 1000).toFixed(2);
+        const mb = (this.receivedBytes / 1024 / 1024).toFixed(2);
+
+        if (!this.json) {
+            if (!this.quiet && this.totalBytes) {
+                process.stderr.write('\n');
+            }
+            if (!this.quiet) {
+                process.stderr.write(`✓ Saved to ${this.output} (${mb} MB in ${elapsed}s${resumed ? ', resumed' : ''})\n`);
+            }
+        }
+
+        this._emit('finish', {
+            output: this.output,
+            url: this.url,
+            bytes: this.receivedBytes,
+            elapsed_sec: parseFloat(elapsed),
+            status: statusCode,
+            resumed: resumed || false
+        });
+    }
+
+    error(message, code) {
+        if (this.json) {
+            this._emit('error', { message, code: code || 'UNKNOWN' });
+        } else {
+            process.stderr.write(`✗ Error: ${message}\n`);
+        }
+    }
+
+    info(message) {
+        if (this.quiet || this.json) return;
+        process.stderr.write(`${message}\n`);
+    }
+}
+
+module.exports = Reporter;

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@penadidik/meo-agent",
+  "version": "1.2.0",
+  "description": "The unified AI agent runtime from Meo Code Labs — bundles a wget-like CLI with --json/--output/--continue/--sha256/--mirror/doctor/plugins features, developer-kit (use case scaffolder), and generate-pr (PR description generator) into one cross-platform distribution.",
+  "main": "index.js",
+  "bin": {
+    "meo-agent": "./bin/meo-agent.js"
+  },
+  "scripts": {
+    "build": "pkg .",
+    "test": "node test/test.js"
+  },
+  "devDependencies": {
+    "@yao-pkg/pkg": "^5.16.1"
+  },
+  "pkg": {
+    "targets": [
+      "node18-win-x64",
+      "node18-macos-x64",
+      "node18-linux-x64"
+    ],
+    "outputPath": "dist",
+    "scripts": [
+      "index.js",
+      "bin/**/*.js",
+      "lib/**/*.js"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/meocode-labs/meo-agent.git"
+  },
+  "bugs": {
+    "url": "https://github.com/meocode-labs/meo-agent/issues"
+  },
+  "homepage": "https://github.com/meocode-labs/meo-agent#readme",
+  "author": {
+    "name": "penadidik",
+    "email": "researcher@meocode.com",
+    "url": "https://github.com/penadidik"
+  },
+  "contributors": [
+    {
+      "name": "Meo Code Labs",
+      "url": "https://meocode.com"
+    }
+  ],
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/meocode-labs"
+  },
+  "license": "MIT",
+  "keywords": [
+    "meo-agent",
+    "meo-code-labs",
+    "meocode",
+    "wget",
+    "cli",
+    "downloader",
+    "http",
+    "https",
+    "developer-tools",
+    "ai-agents",
+    "ai-tooling",
+    "developer-kit",
+    "generate-pr",
+    "terminal",
+    "progress-bar",
+    "json",
+    "resume",
+    "doctor"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "index.js",
+    "bin/",
+    "lib/",
+    "examples/",
+    "developer-kit/",
+    "pull_request/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ]
+}

package/pull_request/README.md

@@ -0,0 +1,104 @@
+# Auto-Generate Pull Request
+
+Sistem untuk auto-generate Pull Request description/review dari git changes.
+
+## Cara Kerja (2 Fase)
+
+1. **Fase Metadata (script)** — `generate-pr.sh` otomatis mengisi: repo, branch,
+   daftar file, jumlah baris (+/-), diff stat, dan commits.
+2. **Fase Analisis (AI/manual)** — untuk type `lead`/`hod`, file hasil berisi
+   placeholder `<!-- REVIEW:* -->` dan tabel `TBD` yang diisi oleh reviewer
+   (via opencode command `/generate-pr` atau manual).
+
+## Struktur
+
+```
+~/Developer/agent_opencode/
+└── pull_request/
+    ├── generate-pr.sh                     # Main script
+    ├── templates/
+    │   ├── basic.md
+    │   ├── lead-review.md
+    │   └── hod-review.md
+    ├── output/                            # OUTPUT (per app)
+    │   └── <app_name>/
+    │       └── pull_request_<datetime>.md
+    └── README.md
+
+~/.config/opencode/command/generate-pr.md  # opencode command
+```
+
+## Penggunaan
+
+### Via Script
+
+```bash
+S=~/Developer/agent_opencode/pull_request/generate-pr.sh
+
+# Basic (default), current branch
+"$S"
+
+# Tipe + branch + PR number
+"$S" lead improvements/pickup-report/08062026
+"$S" hod  request/SCA-Ticketing/17062026 515
+```
+
+Argumen:
+1. `type`   : `basic` | `lead` | `hod`  (default `basic`)
+2. `branch` : target branch             (default: current branch)
+3. `pr_number` : nomor PR untuk URL     (default: `TBD`)
+
+### Via opencode
+
+Gunakan keyword:
+- "generate pr" / "make pr description" → **basic**
+- "as lead review ..." → **lead**
+- "as hod review ..." → **hod**
+
+## Logika Pemilihan Diff (otomatis)
+
+Script memilih sumber perubahan dengan prioritas:
+1. `origin/<branch>` vs base branch  (jika ada perbedaan)
+2. `<branch>` lokal vs base branch
+3. Working tree (uncommitted changes) vs `HEAD`
+
+Base branch dideteksi otomatis: `origin/master` → `origin/main` → `master` → `main`.
+
+## Output Naming
+
+`pull_request_<datetime>.md` — jika sudah ada (detik sama), otomatis menambah
+suffix `_1`, `_2`, dst untuk menghindari overwrite.
+
+Output tersimpan di:
+```
+~/Developer/agent_opencode/pull_request/output/<app_name>/pull_request_<datetime>.md
+```
+
+## Variabel Template
+
+| Variable | Keterangan |
+|----------|------------|
+| `{{REPO}}` | Nama repository |
+| `{{BRANCH}}` | Branch |
+| `{{PR_NUMBER}}` | Nomor PR (default TBD) |
+| `{{AUTHOR}}` | git user.name |
+| `{{DATE}}` / `{{DATETIME}}` | Tanggal / timestamp |
+| `{{SUMMARY}}` | Ringkasan otomatis |
+| `{{FILES_COUNT}}` | Jumlah file |
+| `{{BACKEND_COUNT}}` | File `.php` |
+| `{{FRONTEND_COUNT}}` | File `.js`/`.ts` |
+| `{{BLADE_COUNT}}` | File `.blade.php` |
+| `{{NEW_FILES}}` | File baru |
+| `{{LINES_ADDED}}` / `{{LINES_REMOVED}}` | Total +/- baris |
+| `{{COMMITS_COUNT}}` | Jumlah commit |
+| `{{COMMITS}}` | Daftar commit |
+| `{{DIFF_STAT}}` | Statistik diff |
+| `{{FILES_MODIFIED}}` | Tabel markdown file (template basic) |
+
+## Setup
+
+```bash
+chmod +x ~/Developer/agent_opencode/pull_request/generate-pr.sh
+```
+
+opencode command sudah tersedia di `~/.config/opencode/command/generate-pr.md`.

package/pull_request/generate-pr.sh

@@ -0,0 +1,190 @@
+#!/usr/bin/env bash
+# generate-pr.sh
+# Auto-generate Pull Request description/review from git changes.
+#
+# Usage:
+#   ./generate-pr.sh [type] [branch] [pr_number]
+#     type      : basic | lead | hod          (default: basic)
+#     branch    : target branch               (default: current branch)
+#     pr_number : PR number for the URL        (default: TBD)
+#
+# Output:
+#   ~/Developer/office/ivosights/pull_request/<app_name>/pull_request_<datetime>.md
+
+set -euo pipefail
+
+# ---------------------------------------------------------------------------
+# Helpers
+# ---------------------------------------------------------------------------
+die() { echo "❌ Error: $*" >&2; exit 1; }
+
+# Ensure we are inside a git repository
+git rev-parse --is-inside-work-tree >/dev/null 2>&1 || die "Not inside a git repository."
+
+# ---------------------------------------------------------------------------
+# Parameters
+# ---------------------------------------------------------------------------
+TYPE="${1:-basic}"
+BRANCH="${2:-$(git rev-parse --abbrev-ref HEAD 2>/dev/null || echo "HEAD")}"
+PR_NUMBER="${3:-TBD}"
+
+case "$TYPE" in
+    basic) TEMPLATE_NAME="basic" ;;
+    lead)  TEMPLATE_NAME="lead-review" ;;
+    hod)   TEMPLATE_NAME="hod-review" ;;
+    *)     die "Invalid type '$TYPE'. Use: basic | lead | hod" ;;
+esac
+
+# ---------------------------------------------------------------------------
+# Repo & meta info
+# ---------------------------------------------------------------------------
+REPO="$(basename "$(git rev-parse --show-toplevel)")"
+APP_NAME="${REPO//-/_}"
+DATETIME="$(date +"%Y%m%d_%H%M%S")"
+DATE="$(date +"%Y-%m-%d")"
+AUTHOR="$(git config user.name 2>/dev/null || echo "Unknown")"
+
+# ---------------------------------------------------------------------------
+# Determine base branch (master or main)
+# ---------------------------------------------------------------------------
+BASE_BRANCH=""
+for candidate in origin/master origin/main master main; do
+    if git rev-parse --verify "$candidate" >/dev/null 2>&1; then
+        BASE_BRANCH="$candidate"
+        break
+    fi
+done
+[[ -n "$BASE_BRANCH" ]] || die "Could not resolve base branch (master/main)."
+
+# ---------------------------------------------------------------------------
+# Resolve the comparison target (the "head" side of the diff)
+#   Priority: origin/<branch>  ->  <branch>  ->  working tree (uncommitted)
+# ---------------------------------------------------------------------------
+COMPARE_MODE=""
+HEAD_REF=""
+
+if git rev-parse --verify "origin/$BRANCH" >/dev/null 2>&1 \
+   && [[ -n "$(git diff "$BASE_BRANCH".."origin/$BRANCH" --name-only 2>/dev/null)" ]]; then
+    HEAD_REF="origin/$BRANCH"
+    COMPARE_MODE="branch"
+elif git rev-parse --verify "$BRANCH" >/dev/null 2>&1 \
+   && [[ -n "$(git diff "$BASE_BRANCH".."$BRANCH" --name-only 2>/dev/null)" ]]; then
+    HEAD_REF="$BRANCH"
+    COMPARE_MODE="branch"
+elif [[ -n "$(git status --porcelain 2>/dev/null)" ]]; then
+    # Fall back to uncommitted working tree changes
+    COMPARE_MODE="working"
+else
+    die "No changes found for branch '$BRANCH' vs '$BASE_BRANCH' and no uncommitted changes."
+fi
+
+# ---------------------------------------------------------------------------
+# Gather diff data based on compare mode
+# ---------------------------------------------------------------------------
+if [[ "$COMPARE_MODE" == "branch" ]]; then
+    DIFF_RANGE="$BASE_BRANCH..$HEAD_REF"
+    DIFF_STAT="$(git diff "$DIFF_RANGE" --stat)"
+    NAME_ONLY="$(git diff "$DIFF_RANGE" --name-only)"
+    NEW_NAMES="$(git diff "$DIFF_RANGE" --name-only --diff-filter=A)"
+    NUMSTAT="$(git diff "$DIFF_RANGE" --numstat)"
+    COMMITS="$(git log "$DIFF_RANGE" --oneline)"
+else
+    # working tree (staged + unstaged) vs HEAD
+    DIFF_STAT="$(git diff HEAD --stat)"
+    NAME_ONLY="$(git diff HEAD --name-only)"
+    NEW_NAMES="$(git ls-files --others --exclude-standard)"
+    NUMSTAT="$(git diff HEAD --numstat)"
+    COMMITS="(uncommitted working-tree changes)"
+fi
+
+# ---------------------------------------------------------------------------
+# Counts
+# ---------------------------------------------------------------------------
+count_lines() { [[ -z "$1" ]] && echo 0 || echo "$1" | grep -c . ; }
+
+FILES_COUNT="$(count_lines "$NAME_ONLY")"
+BACKEND_COUNT="$(echo "$NAME_ONLY" | grep -cE '\.php$' || true)"
+FRONTEND_COUNT="$(echo "$NAME_ONLY" | grep -cE '\.(js|ts)$' || true)"
+BLADE_COUNT="$(echo "$NAME_ONLY" | grep -cE '\.blade\.php$' || true)"
+NEW_FILES="$(count_lines "$NEW_NAMES")"
+COMMITS_COUNT="$(count_lines "$COMMITS")"
+
+LINES_ADDED="$(echo "$NUMSTAT" | awk '{sum+=$1} END {print sum+0}')"
+LINES_REMOVED="$(echo "$NUMSTAT" | awk '{sum+=$2} END {print sum+0}')"
+
+SUMMARY="Pull request from branch \`$BRANCH\` ($COMPARE_MODE mode) with $FILES_COUNT file(s) changed, +$LINES_ADDED/-$LINES_REMOVED lines."
+
+# Build a markdown table of modified files
+if [[ -n "$NAME_ONLY" ]]; then
+    FILES_MODIFIED="$(echo "$NAME_ONLY" | sed 's/.*/| `&` |/')"
+    FILES_MODIFIED="| File |"$'\n'"|------|"$'\n'"$FILES_MODIFIED"
+else
+    FILES_MODIFIED="_No files_"
+fi
+
+# ---------------------------------------------------------------------------
+# Template resolution
+# ---------------------------------------------------------------------------
+TEMPLATE_DIR="$HOME/Developer/agent_opencode/pull_request/templates"
+TEMPLATE_FILE="$TEMPLATE_DIR/$TEMPLATE_NAME.md"
+[[ -f "$TEMPLATE_FILE" ]] || die "Template not found: $TEMPLATE_FILE"
+
+# ---------------------------------------------------------------------------
+# Output path (avoid collisions)
+# ---------------------------------------------------------------------------
+OUTPUT_DIR="$HOME/Developer/agent_opencode/pull_request/output/$APP_NAME"
+mkdir -p "$OUTPUT_DIR"
+OUTPUT_FILE="$OUTPUT_DIR/pull_request_${DATETIME}.md"
+counter=1
+while [[ -e "$OUTPUT_FILE" ]]; do
+    OUTPUT_FILE="$OUTPUT_DIR/pull_request_${DATETIME}_${counter}.md"
+    counter=$((counter + 1))
+done
+
+# ---------------------------------------------------------------------------
+# Render template (multiline-safe via awk placeholder replacement)
+# ---------------------------------------------------------------------------
+render() {
+    local content
+    content="$(cat "$TEMPLATE_FILE")"
+
+    # Single-line replacements use awk gsub with literal strings.
+    # Multiline values are injected via environment + awk to stay safe.
+    REPO="$REPO" BRANCH="$BRANCH" PR_NUMBER="$PR_NUMBER" AUTHOR="$AUTHOR" \
+    DATE="$DATE" DATETIME="$DATETIME" SUMMARY="$SUMMARY" \
+    FILES_COUNT="$FILES_COUNT" BACKEND_COUNT="$BACKEND_COUNT" \
+    FRONTEND_COUNT="$FRONTEND_COUNT" BLADE_COUNT="$BLADE_COUNT" \
+    NEW_FILES="$NEW_FILES" LINES_ADDED="$LINES_ADDED" \
+    LINES_REMOVED="$LINES_REMOVED" COMMITS_COUNT="$COMMITS_COUNT" \
+    DIFF_STAT="$DIFF_STAT" COMMITS="$COMMITS" FILES_MODIFIED="$FILES_MODIFIED" \
+    awk '
+    BEGIN {
+        # Map placeholder -> env var name
+        n = split("REPO BRANCH PR_NUMBER AUTHOR DATE DATETIME SUMMARY FILES_COUNT BACKEND_COUNT FRONTEND_COUNT BLADE_COUNT NEW_FILES LINES_ADDED LINES_REMOVED COMMITS_COUNT DIFF_STAT COMMITS FILES_MODIFIED", keys, " ")
+    }
+    {
+        line = $0
+        for (i = 1; i <= n; i++) {
+            ph = "{{" keys[i] "}}"
+            val = ENVIRON[keys[i]]
+            # replace all occurrences without regex interpretation
+            while ((idx = index(line, ph)) > 0) {
+                line = substr(line, 1, idx-1) val substr(line, idx + length(ph))
+            }
+        }
+        print line
+    }' <<< "$content"
+}
+
+render > "$OUTPUT_FILE"
+
+# ---------------------------------------------------------------------------
+# Report
+# ---------------------------------------------------------------------------
+echo "✅ Pull Request generated successfully!"
+echo "📁 Output : $OUTPUT_FILE"
+echo "📋 Type   : $TYPE ($TEMPLATE_NAME)"
+echo "🌿 Branch : $BRANCH  [base: $BASE_BRANCH, mode: $COMPARE_MODE]"
+echo "📊 Files  : $FILES_COUNT (PHP: $BACKEND_COUNT, JS/TS: $FRONTEND_COUNT, Blade: $BLADE_COUNT, New: $NEW_FILES)"
+echo "➕ Lines  : +$LINES_ADDED / -$LINES_REMOVED"
+echo "🔢 Commits: $COMMITS_COUNT"

package/pull_request/templates/basic.md

@@ -0,0 +1,41 @@
+## Pull Request Description
+
+**Repository:** {{REPO}}
+**PR URL:** https://github.com/ivosights/{{REPO}}/pull/{{PR_NUMBER}}
+**Branch:** `{{BRANCH}}`
+**Author:** {{AUTHOR}}
+**Date:** {{DATE}}
+
+---
+
+### Summary
+
+{{SUMMARY}}
+
+### Scope
+- **Files changed:** {{FILES_COUNT}} (PHP: {{BACKEND_COUNT}}, JS/TS: {{FRONTEND_COUNT}}, Blade: {{BLADE_COUNT}})
+- **New files:** {{NEW_FILES}}
+- **Lines:** +{{LINES_ADDED}} / -{{LINES_REMOVED}}
+
+### Files Modified
+
+{{FILES_MODIFIED}}
+
+### What This PR Does
+
+<!-- Describe the purpose / behaviour change of this PR -->
+_..._
+
+---
+
+### Diff Summary
+
+```
+{{DIFF_STAT}}
+```
+
+### Commits
+
+```
+{{COMMITS}}
+```

package/pull_request/templates/hod-review.md

@@ -0,0 +1,101 @@
+# HOD Code Review
+
+**Repository:** {{REPO}}
+**PR URL:** https://github.com/ivosights/{{REPO}}/pull/{{PR_NUMBER}}
+**Branch:** `{{BRANCH}}`
+**Reviewed By:** Head of Department (HOD)
+**Review Date:** {{DATE}}
+
+---
+
+## Executive Summary
+
+{{SUMMARY}}
+
+> _HOD verdict & qualitative analysis to be completed by reviewer (opencode `/generate-pr hod` or manual)._
+
+---
+
+## Scope of Changes
+
+| Metric | Value |
+|--------|-------|
+| Files Modified | {{FILES_COUNT}} files |
+| Lines Added | +{{LINES_ADDED}} |
+| Lines Removed | -{{LINES_REMOVED}} |
+| New Files | {{NEW_FILES}} |
+| Commits | {{COMMITS_COUNT}} |
+
+### Files Breakdown
+- **Backend (PHP):** {{BACKEND_COUNT}} files
+- **Frontend (JS/TS):** {{FRONTEND_COUNT}} files
+- **Blade Templates:** {{BLADE_COUNT}} files
+
+---
+
+## 🟥 Critical Issues (Must Fix)
+
+<!-- REVIEW:CRITICAL -->
+_List blocking issues here (security, broken logic, debug code, undefined vars)._
+
+---
+
+## 🟧 High Priority Issues
+
+<!-- REVIEW:HIGH -->
+_List high-priority concerns (breaking changes, missing tests, interface changes)._
+
+---
+
+## 🟨 Medium / Minor Issues
+
+<!-- REVIEW:MEDIUM -->
+_List code-quality, duplication, and style concerns._
+
+---
+
+## Required Actions Before Approval
+
+| Priority | Action | Owner |
+|----------|--------|-------|
+| 🔴 CRITICAL | _..._ | _..._ |
+| 🟧 HIGH | _..._ | _..._ |
+| 🟨 MEDIUM | _..._ | _..._ |
+
+---
+
+## Risk Assessment
+
+| Area | Risk Level | Notes |
+|------|-----------|-------|
+| **Security** | _TBD_ | _..._ |
+| **Performance** | _TBD_ | _..._ |
+| **Data Integrity** | _TBD_ | _..._ |
+| **Backward Compat** | _TBD_ | _..._ |
+| **Testing** | _TBD_ | _..._ |
+
+---
+
+## Final Verdict
+
+### ⬜ TBD — APPROVE / REQUEST CHANGES
+
+**Reason:** _..._
+
+**Recommended Next Steps:**
+1. _..._
+2. _..._
+3. _..._
+
+---
+
+## Files Changed Summary
+
+```
+{{DIFF_STAT}}
+```
+
+### Commits
+```
+{{COMMITS}}
+```