lastlight 0.1.15 → 0.2.1

package/skills/github/DESCRIPTION.md

@@ -1,3 +0,0 @@
----
-description: GitHub workflow skills for managing repositories, pull requests, code reviews, issues, and CI/CD pipelines using the gh CLI and git via terminal.
----

package/skills/github/codebase-inspection/SKILL.md

@@ -1,115 +0,0 @@
----
-name: codebase-inspection
-description: Inspect and analyze codebases using pygount for LOC counting, language breakdown, and code-vs-comment ratios. Use when asked to check lines of code, repo size, language composition, or codebase stats.
-version: 1.0.0
-author: Hermes Agent
-license: MIT
-metadata:
-  hermes:
-    tags: [LOC, Code Analysis, pygount, Codebase, Metrics, Repository]
-    related_skills: [github-repo-management]
-prerequisites:
-  commands: [pygount]
----
-
-# Codebase Inspection with pygount
-
-Analyze repositories for lines of code, language breakdown, file counts, and code-vs-comment ratios using `pygount`.
-
-## When to Use
-
-- User asks for LOC (lines of code) count
-- User wants a language breakdown of a repo
-- User asks about codebase size or composition
-- User wants code-vs-comment ratios
-- General "how big is this repo" questions
-
-## Prerequisites
-
-```bash
-pip install --break-system-packages pygount 2>/dev/null || pip install pygount
-```
-
-## 1. Basic Summary (Most Common)
-
-Get a full language breakdown with file counts, code lines, and comment lines:
-
-```bash
-cd /path/to/repo
-pygount --format=summary \
-  --folders-to-skip=".git,node_modules,venv,.venv,__pycache__,.cache,dist,build,.next,.tox,.eggs,*.egg-info" \
-  .
-```
-
-**IMPORTANT:** Always use `--folders-to-skip` to exclude dependency/build directories, otherwise pygount will crawl them and take a very long time or hang.
-
-## 2. Common Folder Exclusions
-
-Adjust based on the project type:
-
-```bash
-# Python projects
---folders-to-skip=".git,venv,.venv,__pycache__,.cache,dist,build,.tox,.eggs,.mypy_cache"
-
-# JavaScript/TypeScript projects
---folders-to-skip=".git,node_modules,dist,build,.next,.cache,.turbo,coverage"
-
-# General catch-all
---folders-to-skip=".git,node_modules,venv,.venv,__pycache__,.cache,dist,build,.next,.tox,vendor,third_party"
-```
-
-## 3. Filter by Specific Language
-
-```bash
-# Only count Python files
-pygount --suffix=py --format=summary .
-
-# Only count Python and YAML
-pygount --suffix=py,yaml,yml --format=summary .
-```
-
-## 4. Detailed File-by-File Output
-
-```bash
-# Default format shows per-file breakdown
-pygount --folders-to-skip=".git,node_modules,venv" .
-
-# Sort by code lines (pipe through sort)
-pygount --folders-to-skip=".git,node_modules,venv" . | sort -t$'\t' -k1 -nr | head -20
-```
-
-## 5. Output Formats
-
-```bash
-# Summary table (default recommendation)
-pygount --format=summary .
-
-# JSON output for programmatic use
-pygount --format=json .
-
-# Pipe-friendly: Language, file count, code, docs, empty, string
-pygount --format=summary . 2>/dev/null
-```
-
-## 6. Interpreting Results
-
-The summary table columns:
-- **Language** — detected programming language
-- **Files** — number of files of that language
-- **Code** — lines of actual code (executable/declarative)
-- **Comment** — lines that are comments or documentation
-- **%** — percentage of total
-
-Special pseudo-languages:
-- `__empty__` — empty files
-- `__binary__` — binary files (images, compiled, etc.)
-- `__generated__` — auto-generated files (detected heuristically)
-- `__duplicate__` — files with identical content
-- `__unknown__` — unrecognized file types
-
-## Pitfalls
-
-1. **Always exclude .git, node_modules, venv** — without `--folders-to-skip`, pygount will crawl everything and may take minutes or hang on large dependency trees.
-2. **Markdown shows 0 code lines** — pygount classifies all Markdown content as comments, not code. This is expected behavior.
-3. **JSON files show low code counts** — pygount may count JSON lines conservatively. For accurate JSON line counts, use `wc -l` directly.
-4. **Large monorepos** — for very large repos, consider using `--suffix` to target specific languages rather than scanning everything.

package/skills/github/github-auth/SKILL.md

@@ -1,54 +0,0 @@
----
-name: github-auth
-description: >
-  Git is pre-configured by the harness with GitHub App credentials.
-  Clone, push, pull, and fetch work natively. No manual setup needed.
-version: 3.0.0
-tags: [github, auth, git]
----
-
-# Git Authentication
-
-**Git is already configured.** The harness sets up a global credential helper
-and bot identity before any agent runs. Use git commands directly:
-
-```bash
-git clone https://github.com/owner/repo.git
-cd repo
-# ... make changes ...
-git add -A && git commit -m "your message"
-git push origin HEAD
-```
-
-## Token Refresh
-
-The token expires after ~1 hour. If git operations fail with auth errors,
-call the `refresh_git_auth` MCP tool:
-
-```
-refresh_git_auth(path: "./repo")
-```
-
-The credential helper is updated in place — no reconfiguration needed.
-
-## Bot Identity
-
-Commits are automatically attributed to:
-- Name: `last-light[bot]`
-- Email: `last-light[bot]@users.noreply.github.com`
-
-## Verification
-
-```bash
-git ls-remote https://github.com/owner/repo.git   # test access
-git config user.name                                # check identity
-git config user.email
-```
-
-## Troubleshooting
-
-| Problem | Solution |
-|---------|----------|
-| `fatal: Authentication failed` | Token expired — call `refresh_git_auth` MCP tool |
-| `remote: Permission denied` | GitHub App may not be installed on this repo |
-| Token visible in logs | Never put tokens in git URLs — the credential helper handles auth |

package/skills/github/github-auth/scripts/gh-env.sh

@@ -1,66 +0,0 @@
-#!/usr/bin/env bash
-# GitHub environment detection helper for Hermes Agent skills.
-#
-# Usage (via terminal tool):
-#   source skills/github/github-auth/scripts/gh-env.sh
-#
-# After sourcing, these variables are set:
-#   GH_AUTH_METHOD  - "gh", "curl", or "none"
-#   GITHUB_TOKEN    - personal access token (set if method is "curl")
-#   GH_USER         - GitHub username
-#   GH_OWNER        - repo owner  (only if inside a git repo with a github remote)
-#   GH_REPO         - repo name   (only if inside a git repo with a github remote)
-#   GH_OWNER_REPO   - owner/repo  (only if inside a git repo with a github remote)
-
-# --- Auth detection ---
-
-GH_AUTH_METHOD="none"
-GITHUB_TOKEN="${GITHUB_TOKEN:-}"
-GH_USER=""
-
-if command -v gh &>/dev/null && gh auth status &>/dev/null 2>&1; then
-    GH_AUTH_METHOD="gh"
-    GH_USER=$(gh api user --jq '.login' 2>/dev/null)
-elif [ -n "$GITHUB_TOKEN" ]; then
-    GH_AUTH_METHOD="curl"
-elif [ -f "$HOME/.hermes/.env" ] && grep -q "^GITHUB_TOKEN=" "$HOME/.hermes/.env" 2>/dev/null; then
-    GITHUB_TOKEN=$(grep "^GITHUB_TOKEN=" "$HOME/.hermes/.env" | head -1 | cut -d= -f2 | tr -d '\n\r')
-    if [ -n "$GITHUB_TOKEN" ]; then
-        GH_AUTH_METHOD="curl"
-    fi
-elif [ -f "$HOME/.git-credentials" ] && grep -q "github.com" "$HOME/.git-credentials" 2>/dev/null; then
-    GITHUB_TOKEN=$(grep "github.com" "$HOME/.git-credentials" | head -1 | sed 's|https://[^:]*:\([^@]*\)@.*|\1|')
-    if [ -n "$GITHUB_TOKEN" ]; then
-        GH_AUTH_METHOD="curl"
-    fi
-fi
-
-# Resolve username for curl method
-if [ "$GH_AUTH_METHOD" = "curl" ] && [ -z "$GH_USER" ]; then
-    GH_USER=$(curl -s -H "Authorization: token $GITHUB_TOKEN" \
-        https://api.github.com/user 2>/dev/null \
-        | python3 -c "import sys,json; print(json.load(sys.stdin).get('login',''))" 2>/dev/null)
-fi
-
-# --- Repo detection (if inside a git repo with a GitHub remote) ---
-
-GH_OWNER=""
-GH_REPO=""
-GH_OWNER_REPO=""
-
-_remote_url=$(git remote get-url origin 2>/dev/null)
-if [ -n "$_remote_url" ] && echo "$_remote_url" | grep -q "github.com"; then
-    GH_OWNER_REPO=$(echo "$_remote_url" | sed -E 's|.*github\.com[:/]||; s|\.git$||')
-    GH_OWNER=$(echo "$GH_OWNER_REPO" | cut -d/ -f1)
-    GH_REPO=$(echo "$GH_OWNER_REPO" | cut -d/ -f2)
-fi
-unset _remote_url
-
-# --- Summary ---
-
-echo "GitHub Auth: $GH_AUTH_METHOD"
-[ -n "$GH_USER" ]       && echo "User: $GH_USER"
-[ -n "$GH_OWNER_REPO" ] && echo "Repo: $GH_OWNER_REPO"
-[ "$GH_AUTH_METHOD" = "none" ] && echo "⚠ Not authenticated — see github-auth skill"
-
-export GH_AUTH_METHOD GITHUB_TOKEN GH_USER GH_OWNER GH_REPO GH_OWNER_REPO