liteagents 2.8.1 → 2.8.2

package/docs/PASS_QUICK_START.md

@@ -1,150 +0,0 @@
-# Quick Start: Publishing with `pass`
-
-You're using `pass` to securely store your GitHub token. Here's everything you need!
-
----
-
-## ✅ Your Setup
-
-**Token Location in pass:** `amr/github`
-
----
-
-## 🚀 Publishing (3 Simple Ways)
-
-### Method 1: Fully Automatic (Easiest) ⭐
-
-The `publish.sh` script automatically retrieves your token from `pass`:
-
-```bash
-./publish.sh
-```
-
-**That's it!** No need to export anything manually.
-
-### Method 2: One-Line Publish
-
-```bash
-export GITHUB_TOKEN=$(pass show amr/github) && npm run publish:both
-```
-
-### Method 3: Helper Script
-
-```bash
-source ./set-github-token.sh
-npm run publish:both
-```
-
----
-
-## 📋 Common Commands
-
-### View your token
-```bash
-pass show amr/github
-```
-
-### Export token for current session
-```bash
-export GITHUB_TOKEN=$(pass show amr/github)
-```
-
-### Verify token is set
-```bash
-echo $GITHUB_TOKEN | cut -c1-10
-# Should show: ghp_...
-```
-
-### Update token in pass
-```bash
-pass edit amr/github
-# Or insert new one
-pass insert -f amr/github
-```
-
----
-
-## 🔄 Complete Release Workflow
-
-```bash
-# 1. Update version
-./UPDATE_VERSION.sh 1.2.0
-
-# 2. Update CHANGELOG.md
-# (Edit with your changes)
-
-# 3. Commit and tag
-git add .
-git commit -m "Bump version to 1.2.0"
-git tag v1.2.0
-git push origin main --tags
-
-# 4. Publish (automatic pass retrieval!)
-./publish.sh
-
-# 5. Verify
-# - npm.js: https://www.npmjs.com/package/liteagents
-# - GitHub: https://github.com/hamr0/liteagents/packages
-```
-
----
-
-## 🔐 Security Tips
-
-✅ Your token is encrypted with GPG
-✅ Never stored in plain text
-✅ Not in shell history or config files
-✅ Scripts retrieve it automatically when needed
-
----
-
-## 🆘 Troubleshooting
-
-### "pass: command not found"
-```bash
-sudo apt install pass  # Ubuntu/Debian
-brew install pass      # macOS
-```
-
-### "amr/github is not in the password store"
-```bash
-pass insert amr/github
-# Enter your token when prompted
-```
-
-### Token not working
-```bash
-# Verify token in pass
-pass show amr/github
-
-# Should start with ghp_
-pass show amr/github | head -c 4
-```
-
-### Need to regenerate token
-1. Go to: https://github.com/settings/tokens
-2. Generate new token (classic)
-3. Scopes: `write:packages`, `read:packages`
-4. Update in pass:
-   ```bash
-   pass insert -f amr/github
-   ```
-
----
-
-## 📚 Full Documentation
-
-- **Pass Integration Guide:** [docs/PASS_INTEGRATION.md](PASS_INTEGRATION.md)
-- **GitHub Setup:** [docs/GITHUB_SETUP.md](GITHUB_SETUP.md)
-- **Publishing Guide:** [docs/PUBLISHING.md](PUBLISHING.md)
-
----
-
-## ⚡ TL;DR
-
-**Just run:**
-```bash
-./publish.sh
-```
-
-**The script does everything automatically!** 🎉

package/docs/PRIVACY.md

@@ -1,203 +0,0 @@
-# Privacy Policy - Agentic Kit Telemetry
-
-## Overview
-
-Agentic Kit respects your privacy. This document explains our optional telemetry system and what data we collect (and don't collect) to help improve the software.
-
-## Important Principles
-
-1. **Opt-In Only**: Telemetry is completely optional. We will never collect data without your explicit consent.
-2. **Anonymous**: All data collected is anonymous and cannot be linked to you personally.
-3. **Transparent**: We clearly document what we collect and don't collect.
-4. **Respectful**: You can change your mind anytime - opt-in or opt-out at will.
-
-## Telemetry Consent
-
-When you first run the Agentic Kit installer, you'll be asked:
-
-```
-Would you like to share anonymous usage statistics to help improve liteagents? (y/N)
-```
-
-- **Default is NO**: If you just press Enter, telemetry is disabled
-- **Explicit Consent**: You must type 'y' to enable telemetry
-- **One-Time Prompt**: We only ask once; your choice is saved
-- **Easy to Change**: You can modify your consent anytime
-
-## What Data We Collect
-
-When you **opt-in**, we collect the following anonymous data:
-
-### Installation Events
-- **Package variant selected**: Which variant you chose (lite, standard, or pro)
-- **Tool count**: How many tools you installed (not which specific tools)
-- **Installation time**: How long the installation took (in milliseconds)
-- **Success status**: Whether installation succeeded or failed
-- **Error count**: Number of errors encountered (not the error details)
-- **Warning count**: Number of warnings encountered
-
-### System Information
-- **Operating system type**: Platform name (e.g., linux, darwin, win32)
-- **Node.js version**: The version of Node.js you're using
-- **Agentic Kit version**: The version of liteagents you installed
-
-### Upgrade Events
-- **From variant**: The variant you upgraded from
-- **To variant**: The variant you upgraded to
-- **Success status**: Whether upgrade succeeded or failed
-
-### Uninstallation Events
-- **Success status**: Whether uninstallation succeeded or failed
-
-## What Data We DON'T Collect
-
-We explicitly **do not** collect:
-
-- ❌ **File paths**: No installation directories or file locations
-- ❌ **Personal information**: No usernames, emails, or identifying information
-- ❌ **System details**: No detailed hardware specs, memory usage, or system configuration
-- ❌ **Specific tool names**: We don't track which specific tools you selected
-- ❌ **User-created content**: No code, files, or data you create
-- ❌ **Network information**: No IP addresses or network identifiers
-- ❌ **Installation location**: No absolute or relative paths
-- ❌ **Error messages**: No detailed error text or stack traces
-
-## How Data is Stored
-
-Currently, telemetry data is stored locally on your machine at:
-
-```
-~/.liteagents-telemetry.log
-```
-
-In future versions, with your consent, this data may be sent to a secure analytics endpoint to help aggregate usage patterns. Any such change will:
-- Be clearly communicated in release notes
-- Require you to re-confirm your consent
-- Use secure, encrypted transmission (HTTPS)
-- Store data in a privacy-respecting manner
-
-## Managing Your Consent
-
-### Check Current Status
-
-Your telemetry consent is stored in:
-```
-~/.liteagents-config.json
-```
-
-You can view this file to see your current setting:
-```json
-{
-  "telemetry": true,
-  "telemetryConsentDate": "2025-01-15T10:30:00Z"
-}
-```
-
-### Disable Telemetry
-
-You have several options to disable telemetry:
-
-#### Option 1: Edit Config File
-Edit `~/.liteagents-config.json` and set:
-```json
-{
-  "telemetry": false
-}
-```
-
-#### Option 2: Use --no-telemetry Flag
-Run the installer with the flag:
-```bash
-node installer/cli.js --no-telemetry
-```
-
-This flag:
-- Disables telemetry for this installation only
-- Doesn't change your saved consent setting
-- Can be used anytime
-
-#### Option 3: Delete Config File
-Remove the config file completely:
-```bash
-rm ~/.liteagents-config.json
-```
-
-You'll be prompted again on next installation.
-
-### Enable Telemetry
-
-To enable telemetry after previously declining:
-
-1. Edit `~/.liteagents-config.json` and set `"telemetry": true`
-2. Or delete the config file and run installer again to be re-prompted
-
-## View Collected Data
-
-All locally collected telemetry is stored in plaintext at:
-```
-~/.liteagents-telemetry.log
-```
-
-You can view this file anytime to see exactly what data has been collected:
-```bash
-cat ~/.liteagents-telemetry.log
-```
-
-Each entry is a JSON object on a single line, for example:
-```json
-{"timestamp":"2025-01-15T10:30:00Z","event":"installation","variant":"standard","toolCount":2,"installationTimeMs":45000,"success":true,"errorCount":0,"warningCount":0,"osType":"linux","nodeVersion":"v18.0.0","agenticKitVersion":"1.2.0"}
-```
-
-## Delete All Telemetry Data
-
-To completely remove all telemetry data from your system:
-
-```bash
-rm ~/.liteagents-telemetry.log
-rm ~/.liteagents-config.json
-```
-
-This removes:
-- All collected telemetry data
-- Your consent setting
-- The config file
-
-## Why We Collect This Data
-
-Anonymous usage statistics help us:
-
-1. **Understand Usage Patterns**: Know which variants are most popular
-2. **Improve Installation Experience**: Track installation success rates and times
-3. **Prioritize Development**: Focus on the features users actually use
-4. **Fix Issues**: Identify common installation problems
-5. **Platform Support**: Understand which platforms need better support
-
-## Questions or Concerns
-
-If you have questions about our privacy policy or data collection:
-
-- **GitHub Issues**: https://github.com/hamr0/liteagents/issues
-- **Review Code**: Our telemetry code is open source in `installer/telemetry.js`
-- **Request Clarification**: Open an issue if anything is unclear
-
-## Updates to This Policy
-
-We may update this privacy policy as we add features. Any changes will:
-- Be documented in CHANGELOG.md
-- Require re-consent if data collection changes significantly
-- Be clearly communicated in release notes
-
-## Summary
-
-**TL;DR:**
-- ✅ Telemetry is opt-in only (default: disabled)
-- ✅ Data is completely anonymous
-- ✅ You can opt-out anytime with `--no-telemetry`
-- ✅ All collected data is stored locally and viewable
-- ✅ We never collect personal information or file paths
-- ✅ The code is open source - you can audit it
-
----
-
-**Last Updated**: January 2025
-**Version**: 1.0

package/docs/PUBLISHING.md

@@ -1,266 +0,0 @@
-# Publishing Guide - liteagents
-
-This guide documents how to publish liteagents to npm and Claude Code marketplaces.
-
----
-
-## Table of Contents
-
-1. [Quick Publishing](#quick-publishing)
-2. [Publishing to npm](#publishing-to-npm)
-3. [Publishing to Claude Code Marketplace](#publishing-to-claude-code-marketplace)
-4. [Version Management](#version-management)
-5. [Troubleshooting](#troubleshooting)
-
----
-
-## Quick Publishing
-
-### Publish to npm
-
-```bash
-# Using the publish script
-./scripts/publish.sh
-
-# Or directly
-npm publish --access public
-```
-
-**Requirements:**
-- Logged into npm: `npm login`
-- All changes committed to git
-- Package validation passes: `npm run validate`
-
----
-
-## Publishing to npm
-
-### Prerequisites
-
-- npm account (create at https://www.npmjs.com/signup)
-- Access to the `liteagents` package
-- All changes committed to git
-
-### Publishing Process
-
-#### 1. Login to npm
-
-```bash
-npm login
-```
-
-#### 2. Validate Package
-
-```bash
-npm run validate
-```
-
-This checks:
-- ✅ All manifest files exist and are valid JSON
-- ✅ Variant configurations are correct
-- ✅ All required files are present
-- ✅ CLI script has proper shebang
-
-#### 3. Publish
-
-```bash
-./scripts/publish.sh
-```
-
-Or manually:
-```bash
-npm publish --access public
-```
-
-#### 4. Verify Publication
-
-Check your package page:
-- https://www.npmjs.com/package/liteagents
-
-Test installation:
-```bash
-npm install -g liteagents
-liteagents --help
-```
-
----
-
-## Publishing to Claude Code Marketplace
-
-### Current Options (2025)
-
-Claude Code doesn't have a centralized official Anthropic marketplace yet. There are three distribution methods:
-
-### Option 1: Direct GitHub Installation ⭐ (Recommended)
-
-Users can install directly from GitHub without marketplace approval:
-
-```
-/plugin add github:hamr0/liteagents
-```
-
-**No submission required!** Works as soon as you push to GitHub.
-
-**Requirements:**
-- ✅ Repository must be public
-- ✅ `.claude-plugin/` directory with manifests
-- ✅ All plugin files in repository root
-
-### Option 2: Create Your Own Marketplace
-
-Host your own marketplace catalog: `.claude-plugin/marketplace.json`
-
-```json
-{
-  "name": "liteagents Official",
-  "owner": "hamr0",
-  "description": "Lightweight CLI agents for development",
-  "plugins": [
-    {
-      "name": "liteagents",
-      "source": "github:hamr0/liteagents",
-      "description": "Lightweight deterministic CLI agents"
-    }
-  ]
-}
-```
-
-Users install via:
-```
-/plugin marketplace add github:hamr0/liteagents
-```
-
-### Option 3: Submit to Community Marketplaces
-
-**claudecodecommands.directory** (Largest Community Marketplace)
-
-1. Visit: https://claudecodecommands.directory/submit
-2. Fill out submission form
-3. Wait for review (1-3 days)
-4. Users can then search and install
-
----
-
-## Version Management
-
-### Using npm version command
-
-```bash
-# Update version
-npm version patch  # 2.4.0 -> 2.4.1 (bug fixes)
-npm version minor  # 2.4.0 -> 2.5.0 (new features)
-npm version major  # 2.4.0 -> 3.0.0 (breaking changes)
-```
-
-### Complete Release Process
-
-```bash
-# 1. Update version
-npm version patch  # or minor/major
-
-# 2. Update CHANGELOG.md
-# Add release notes for this version
-
-# 3. Commit and tag
-git add .
-git commit -m "Bump version to 2.4.1"
-git tag v2.4.1
-git push origin main --tags
-
-# 4. Publish to npm
-./scripts/publish.sh
-
-# 5. Verify
-# Check npm: https://www.npmjs.com/package/liteagents
-```
-
----
-
-## Troubleshooting
-
-### npm Issues
-
-#### Error: 403 Forbidden - Package name taken
-```
-npm error 403 You do not have permission to publish
-```
-
-**Solution:** Package name is taken. Choose a different name or use scoped: `@username/package-name`
-
-#### Error: 402 Payment Required
-```
-npm error 402 You must sign up for private packages
-```
-
-**Solution:** Add `--access public` flag:
-```bash
-npm publish --access public
-```
-
-#### Error: Not logged in
-```
-npm error need auth
-```
-
-**Solution:**
-```bash
-npm login
-```
-
-### Validation Issues
-
-#### Validation Fails
-
-**Problem:** `npm run validate` reports errors
-
-**Solutions:**
-- Check manifest files have correct agent/skill counts
-- Ensure all agent files exist in `agents/` directory
-- Verify all skill directories exist in `skills/`
-- Check cli.js has shebang and is executable
-
-#### GitHub Install Not Working
-
-**Problem:** Users can't install via `/plugin add github:hamr0/liteagents`
-
-**Checklist:**
-- [ ] Repository is public
-- [ ] `.claude-plugin/` directory exists
-- [ ] Manifests are valid JSON
-- [ ] All files are pushed to GitHub
-
----
-
-## Distribution Checklist
-
-Before publishing a new release:
-
-- [ ] All tests pass
-- [ ] `npm run validate` succeeds
-- [ ] Version bumped with `npm version`
-- [ ] CHANGELOG.md updated
-- [ ] README.md reflects current features
-- [ ] All changes committed to git
-- [ ] Git tag created (`v2.x.x`)
-- [ ] Changes pushed to GitHub with tags
-- [ ] Published to npm: `./scripts/publish.sh`
-- [ ] Verified npm installation: `npm install -g liteagents`
-- [ ] Verified GitHub installation: `/plugin add github:hamr0/liteagents`
-
----
-
-## Package URLs
-
-After publishing, your package will be available at:
-
-- **npm:** https://www.npmjs.com/package/liteagents
-- **GitHub Repository:** https://github.com/hamr0/liteagents
-
-## Support & Resources
-
-- **npm Documentation:** https://docs.npmjs.com/cli/v10/commands/npm-publish
-- **Claude Code Plugin Docs:** https://docs.claude.com/en/docs/claude-code/plugin-marketplaces
-
----
-
-**Last Updated:** January 2025