liteagents 2.4.0 → 2.4.1

package/docs/PRIVACY.md

@@ -16,7 +16,7 @@ Agentic Kit respects your privacy. This document explains our optional telemetry
 When you first run the Agentic Kit installer, you'll be asked:
 
 ```
-Would you like to share anonymous usage statistics to help improve agentflow? (y/N)
+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
@@ -39,7 +39,7 @@ When you **opt-in**, we collect the following anonymous data:
 ### 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 agentflow you installed
+- **Agentic Kit version**: The version of liteagents you installed
 
 ### Upgrade Events
 - **From variant**: The variant you upgraded from
@@ -67,7 +67,7 @@ We explicitly **do not** collect:
 Currently, telemetry data is stored locally on your machine at:
 
 ```
-~/.agentic-kit-telemetry.log
+~/.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:
@@ -82,7 +82,7 @@ In future versions, with your consent, this data may be sent to a secure analyti
 
 Your telemetry consent is stored in:
 ```
-~/.agentic-kit-config.json
+~/.liteagents-config.json
 ```
 
 You can view this file to see your current setting:
@@ -98,7 +98,7 @@ You can view this file to see your current setting:
 You have several options to disable telemetry:
 
 #### Option 1: Edit Config File
-Edit `~/.agentic-kit-config.json` and set:
+Edit `~/.liteagents-config.json` and set:
 ```json
 {
   "telemetry": false
@@ -119,7 +119,7 @@ This flag:
 #### Option 3: Delete Config File
 Remove the config file completely:
 ```bash
-rm ~/.agentic-kit-config.json
+rm ~/.liteagents-config.json
 ```
 
 You'll be prompted again on next installation.
@@ -128,19 +128,19 @@ You'll be prompted again on next installation.
 
 To enable telemetry after previously declining:
 
-1. Edit `~/.agentic-kit-config.json` and set `"telemetry": true`
+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:
 ```
-~/.agentic-kit-telemetry.log
+~/.liteagents-telemetry.log
 ```
 
 You can view this file anytime to see exactly what data has been collected:
 ```bash
-cat ~/.agentic-kit-telemetry.log
+cat ~/.liteagents-telemetry.log
 ```
 
 Each entry is a JSON object on a single line, for example:
@@ -153,8 +153,8 @@ Each entry is a JSON object on a single line, for example:
 To completely remove all telemetry data from your system:
 
 ```bash
-rm ~/.agentic-kit-telemetry.log
-rm ~/.agentic-kit-config.json
+rm ~/.liteagents-telemetry.log
+rm ~/.liteagents-config.json
 ```
 
 This removes:
@@ -176,7 +176,7 @@ Anonymous usage statistics help us:
 
 If you have questions about our privacy policy or data collection:
 
-- **GitHub Issues**: https://github.com/amrhas82/agentflow/issues
+- **GitHub Issues**: https://github.com/amrhas82/liteagents/issues
 - **Review Code**: Our telemetry code is open source in `installer/telemetry.js`
 - **Request Clarification**: Open an issue if anything is unclear
 

package/docs/PUBLISHING.md

@@ -1,102 +1,44 @@
-# Publishing Guide - Agentic Kit
+# Publishing Guide - liteagents
 
-This guide documents how to publish Agentic Kit to npm.js, GitHub Packages, and Claude Code marketplaces.
+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.js](#publishing-to-npmjs)
-3. [Publishing to GitHub Packages](#publishing-to-github-packages)
-4. [Publishing to Both Registries](#publishing-to-both-registries)
-5. [Publishing to Claude Code Marketplace](#publishing-to-claude-code-marketplace)
-6. [Version Management](#version-management)
-7. [Troubleshooting](#troubleshooting)
+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 Both npm.js and GitHub Packages
+### Publish to npm
 
 ```bash
-# One command to publish everywhere!
-npm run publish:both
+# Using the publish script
+./scripts/publish.sh
+
+# Or directly
+npm publish --access public
 ```
 
 **Requirements:**
 - Logged into npm: `npm login`
-- GitHub token set: `export GITHUB_TOKEN=ghp_your_token_here`
-- See [First-Time Setup](#first-time-setup) below
-
-### Individual Registries
-
-```bash
-# Just npm.js
-npm run publish:npm
-
-# Just GitHub Packages
-npm run publish:github
-```
-
----
-
-## First-Time Setup
-
-### Setup for npm.js
-
-```bash
-npm login
-```
-
-Enter your npm credentials when prompted.
-
-### Setup for GitHub Packages
-
-**One-time setup required.** See detailed guide: [`GITHUB_SETUP.md`](GITHUB_SETUP.md)
-
-**Quick version:**
-
-1. **Create GitHub Token:** https://github.com/settings/tokens
-   - Click "Generate new token (classic)"
-   - Select scopes: `write:packages`, `read:packages`
-   - Copy token (starts with `ghp_`)
-
-2. **Set Environment Variable:**
-
-   **Option A: Using `pass` (Recommended)** 🔐
-   ```bash
-   # Store token in pass
-   pass insert amr/github
-
-   # Export from pass (or the script will do it automatically!)
-   export GITHUB_TOKEN=$(pass show amr/github)
-   ```
-   **See:** [PASS_INTEGRATION.md](PASS_INTEGRATION.md)
-
-   **Option B: Direct export**
-   ```bash
-   # Linux/macOS
-   export GITHUB_TOKEN=ghp_your_token_here
-
-   # Add to ~/.bashrc or ~/.zshrc for persistence
-   echo 'export GITHUB_TOKEN=ghp_your_token_here' >> ~/.bashrc
-   ```
-
-3. **Verify:**
-   ```bash
-   echo $GITHUB_TOKEN  # Should show your token
-   ```
+- All changes committed to git
+- Package validation passes: `npm run validate`
 
 ---
 
-## Publishing to npm.js
+## Publishing to npm
 
 ### Prerequisites
 
 - npm account (create at https://www.npmjs.com/signup)
-- Access to the `agentflow` package
+- Access to the `liteagents` package
 - All changes committed to git
 
 ### Publishing Process
@@ -122,7 +64,7 @@ This checks:
 #### 3. Publish
 
 ```bash
-npm run publish:npm
+./scripts/publish.sh
 ```
 
 Or manually:
@@ -133,113 +75,16 @@ npm publish --access public
 #### 4. Verify Publication
 
 Check your package page:
-- https://www.npmjs.com/package/agentflow
+- https://www.npmjs.com/package/liteagents
 
 Test installation:
 ```bash
-npx agentflow --help
-npx agentic-kit --variant=lite
-```
-
----
-
-## Publishing to GitHub Packages
-
-### Prerequisites
-
-- GitHub account with access to `amrhas82/agentic-kit` repository
-- GitHub Personal Access Token (see [GITHUB_SETUP.md](GITHUB_SETUP.md))
-- `GITHUB_TOKEN` environment variable set
-
-### Publishing Process
-
-#### 1. Verify GitHub Token
-
-```bash
-echo $GITHUB_TOKEN  # Should show ghp_...
-```
-
-If not set, see [First-Time Setup](#first-time-setup).
-
-#### 2. Publish
-
-```bash
-npm run publish:github
-```
-
-Or manually:
-```bash
-npm publish --registry https://npm.pkg.github.com
-```
-
-#### 3. Verify Publication
-
-1. Go to: https://github.com/amrhas82/agentflow
-2. Click **"Packages"** on the right sidebar
-3. You should see `agentflow` listed
-
-### Installing from GitHub Packages
-
-Users need to configure their `.npmrc`:
-
-```
-@amrhas82:registry=https://npm.pkg.github.com
-//npm.pkg.github.com/:_authToken=THEIR_GITHUB_TOKEN
-```
-
-Then install:
-```bash
-npm install agentflow
+npm install -g liteagents
+liteagents --help
 ```
 
 ---
 
-## Publishing to Both Registries
-
-### Automated (Recommended)
-
-Use the publish script:
-
-```bash
-./publish.sh
-```
-
-Or npm script:
-```bash
-npm run publish:both
-```
-
-This will:
-1. Validate package
-2. Publish to npm.js
-3. Publish to GitHub Packages (if `GITHUB_TOKEN` is set)
-
-### Manual
-
-```bash
-# 1. Publish to npm.js
-npm publish --registry https://registry.npmjs.org --access public
-
-# 2. Publish to GitHub Packages
-npm publish --registry https://npm.pkg.github.com
-```
-
-### Why Publish to Both?
-
-**npm.js:**
-- ✅ Easier for users (no GitHub token required)
-- ✅ Works with `npx` out of the box
-- ✅ Better discovery/SEO
-- ✅ Standard npm workflow
-
-**GitHub Packages:**
-- ✅ Integrated with GitHub repository
-- ✅ Shows up on repo page
-- ✅ Easier access control (can be private)
-- ✅ Better for GitHub-based workflows
-
----
-
 ## Publishing to Claude Code Marketplace
 
 ### Current Options (2025)
@@ -251,7 +96,7 @@ Claude Code doesn't have a centralized official Anthropic marketplace yet. There
 Users can install directly from GitHub without marketplace approval:
 
 ```
-/plugin add github:amrhas82/agentflow
+/plugin add github:amrhas82/liteagents
 ```
 
 **No submission required!** Works as soon as you push to GitHub.
@@ -267,24 +112,14 @@ Host your own marketplace catalog: `.claude-plugin/marketplace.json`
 
 ```json
 {
-  "name": "Agentic Kit Official",
+  "name": "liteagents Official",
   "owner": "amrhas82",
-  "description": "Official marketplace for Agentic Kit variants",
+  "description": "Lightweight CLI agents for development",
   "plugins": [
     {
-      "name": "agentflow-standard",
-      "source": "github:amrhas82/agentflow",
-      "description": "Standard variant (13 agents, 8 skills)"
-    },
-    {
-      "name": "agentic-kit-lite",
-      "source": "github:amrhas82/agentflow",
-      "description": "Lite variant (3 agents)"
-    },
-    {
-      "name": "agentic-kit-pro",
-      "source": "github:amrhas82/agentflow",
-      "description": "Pro variant (13 agents, 14 skills)"
+      "name": "liteagents",
+      "source": "github:amrhas82/liteagents",
+      "description": "Lightweight deterministic CLI agents"
     }
   ]
 }
@@ -292,7 +127,7 @@ Host your own marketplace catalog: `.claude-plugin/marketplace.json`
 
 Users install via:
 ```
-/plugin marketplace add github:amrhas82/agentflow
+/plugin marketplace add github:amrhas82/liteagents
 ```
 
 ### Option 3: Submit to Community Marketplaces
@@ -308,68 +143,49 @@ Users install via:
 
 ## Version Management
 
-### Using UPDATE_VERSION.sh (Recommended)
-
-Automatically updates version across all files:
-
-```bash
-./UPDATE_VERSION.sh 1.2.0
-```
-
-This updates:
-- `package.json`
-- All 4 plugin manifest files in `.claude-plugin/`
-
-### Manual Version Update
+### Using npm version command
 
 ```bash
 # Update version
-npm version patch  # 1.1.0 -> 1.1.1 (bug fixes)
-npm version minor  # 1.1.0 -> 1.2.0 (new features)
-npm version major  # 1.1.0 -> 2.0.0 (breaking changes)
+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)
 ```
 
-Then manually update manifest files:
-- `.claude-plugin/plugin.json`
-- `.claude-plugin/plugin-lite.json`
-- `.claude-plugin/plugin-standard.json`
-- `.claude-plugin/plugin-pro.json`
-
 ### Complete Release Process
 
 ```bash
 # 1. Update version
-./UPDATE_VERSION.sh 1.2.0
+npm version patch  # or minor/major
 
 # 2. Update CHANGELOG.md
 # Add release notes for this version
 
-# 3. Commit changes
+# 3. Commit and tag
 git add .
-git commit -m "Bump version to 1.2.0"
-git tag v1.2.0
+git commit -m "Bump version to 2.4.1"
+git tag v2.4.1
 git push origin main --tags
 
-# 4. Publish to both registries
-npm run publish:both
+# 4. Publish to npm
+./scripts/publish.sh
 
 # 5. Verify
-# - Check npm.js: https://www.npmjs.com/package/agentflow
-# - Check GitHub: https://github.com/amrhas82/agentflow/packages
+# Check npm: https://www.npmjs.com/package/liteagents
 ```
 
 ---
 
 ## Troubleshooting
 
-### npm.js Issues
+### npm Issues
 
 #### Error: 403 Forbidden - Package name taken
 ```
 npm error 403 You do not have permission to publish
 ```
 
-**Solution:** Use scoped package name: `@username/package-name`
+**Solution:** Package name is taken. Choose a different name or use scoped: `@username/package-name`
 
 #### Error: 402 Payment Required
 ```
@@ -391,45 +207,7 @@ npm error need auth
 npm login
 ```
 
-### GitHub Packages Issues
-
-#### Error: 401 Unauthorized
-
-**Cause:** `GITHUB_TOKEN` not set or incorrect
-
-**Solution:**
-```bash
-# Check if set
-echo $GITHUB_TOKEN
-
-# Set it
-export GITHUB_TOKEN=ghp_your_token_here
-```
-
-#### Error: 403 Forbidden
-
-**Cause:** Token missing `write:packages` scope
-
-**Solution:**
-1. Go to https://github.com/settings/tokens
-2. Generate new token with `write:packages` scope
-
-#### Error: 404 Not Found
-
-**Cause:** Repository doesn't exist or name mismatch
-
-**Solution:**
-- Verify: https://github.com/amrhas82/agentflow
-- Check package.json has `agentflow`
-
-#### Package Not Showing Up
-
-**Solution:**
-- Wait 5-10 minutes (propagation delay)
-- Check GitHub repo → Packages tab
-- Verify publish succeeded without errors
-
-### General Issues
+### Validation Issues
 
 #### Validation Fails
 
@@ -443,7 +221,7 @@ export GITHUB_TOKEN=ghp_your_token_here
 
 #### GitHub Install Not Working
 
-**Problem:** Users can't install via `/plugin add github:amrhas82/agentflow`
+**Problem:** Users can't install via `/plugin add github:amrhas82/liteagents`
 
 **Checklist:**
 - [ ] Repository is public
@@ -459,17 +237,15 @@ Before publishing a new release:
 
 - [ ] All tests pass
 - [ ] `npm run validate` succeeds
-- [ ] Version bumped (via `UPDATE_VERSION.sh`)
+- [ ] Version bumped with `npm version`
 - [ ] CHANGELOG.md updated
 - [ ] README.md reflects current features
 - [ ] All changes committed to git
-- [ ] Git tag created (`v1.x.x`)
+- [ ] Git tag created (`v2.x.x`)
 - [ ] Changes pushed to GitHub with tags
-- [ ] Published to npm.js: `npm run publish:npm`
-- [ ] Published to GitHub Packages: `npm run publish:github`
-- [ ] Verified npm.js installation: `npx agentflow --help`
-- [ ] Verified GitHub Packages shows package
-- [ ] Verified GitHub installation: `/plugin add github:amrhas82/agentflow`
+- [ ] Published to npm: `./scripts/publish.sh`
+- [ ] Verified npm installation: `npm install -g liteagents`
+- [ ] Verified GitHub installation: `/plugin add github:amrhas82/liteagents`
 
 ---
 
@@ -477,18 +253,14 @@ Before publishing a new release:
 
 After publishing, your package will be available at:
 
-- **npm.js:** https://www.npmjs.com/package/agentflow
-- **GitHub Packages:** https://github.com/amrhas82/agentflow/packages
-- **GitHub Repository:** https://github.com/amrhas82/agentflow
+- **npm:** https://www.npmjs.com/package/liteagents
+- **GitHub Repository:** https://github.com/amrhas82/liteagents
 
 ## Support & Resources
 
 - **npm Documentation:** https://docs.npmjs.com/cli/v10/commands/npm-publish
-- **GitHub Packages Docs:** https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-npm-registry
 - **Claude Code Plugin Docs:** https://docs.claude.com/en/docs/claude-code/plugin-marketplaces
-- **First-Time GitHub Setup:** [GITHUB_SETUP.md](GITHUB_SETUP.md)
-- **Using `pass` Password Manager:** [PASS_INTEGRATION.md](PASS_INTEGRATION.md)
 
 ---
 
-**Last Updated:** November 2025
+**Last Updated:** January 2025

package/docs/RELEASE_NOTES_1.2.0.md

@@ -24,7 +24,7 @@ The headline feature of v1.2.0 is a complete installation system supporting four
 
 #### 📊 Installation Reporting (New in Phase 9)
 
-- **Comprehensive Reports**: Detailed installation reports saved to `~/.agentic-kit-install.log`
+- **Comprehensive Reports**: Detailed installation reports saved to `~/.liteagents-install.log`
   - Success/failure status
   - Per-tool component counts and verification
   - System information and timing data
@@ -93,41 +93,41 @@ The headline feature of v1.2.0 is a complete installation system supporting four
 
 ```bash
 # Install globally
-npm install -g agentflow
+npm install -g liteagents
 
 # Run interactive installer
-agentic-kit install
+liteagents install
 ```
 
 ### Silent Mode (CI/CD)
 
 ```bash
 # Install Claude with Standard variant
-agentic-kit install --silent --variant=standard --tools=claude
+liteagents install --silent --variant=standard --tools=claude
 
 # Install all tools with Pro variant
-agentic-kit install --silent --variant=pro --tools=claude,opencode,ampcode,droid
+liteagents install --silent --variant=pro --tools=claude,opencode,ampcode,droid
 ```
 
 ### Advanced Usage
 
 ```bash
 # Custom path
-agentic-kit install --variant=standard --tools=claude --path claude=~/my-custom-path
+liteagents install --variant=standard --tools=claude --path claude=~/my-custom-path
 
 # Multiple tools with different paths
-agentic-kit install --variant=pro --tools=claude,opencode \
+liteagents install --variant=pro --tools=claude,opencode \
   --path claude=~/.claude-custom \
   --path opencode=~/.opencode-custom
 
 # Disable telemetry
-agentic-kit install --no-telemetry
+liteagents install --no-telemetry
 
 # Uninstall
-agentic-kit install --uninstall claude
+liteagents install --uninstall claude
 
 # Upgrade variant
-agentic-kit install --upgrade claude pro
+liteagents install --upgrade claude pro
 ```
 
 ---
@@ -177,7 +177,7 @@ agentic-kit install --upgrade claude pro
 ### Architecture
 
 ```
-agentic-kit/
+liteagents/
 ├── installer/
 │   ├── cli.js                    # Interactive CLI
 │   ├── package-manager.js        # Variant management
@@ -226,7 +226,7 @@ agentic-kit/
 When you run the installer, it will automatically detect v1.1.x installations and offer to migrate:
 
 ```bash
-$ agentic-kit install
+$ liteagents install
 
 ⚠ Legacy installation detected at ~/.claude
   Found: 13 agents, 5 skills, 1 resource, 2 hooks
@@ -300,8 +300,8 @@ This release represents a significant milestone in making Agentic Kit more acces
 
 ## 📞 Support
 
-- **Documentation**: https://github.com/amrhas82/agentflow/docs
-- **Issues**: https://github.com/amrhas82/agentflow/issues
+- **Documentation**: https://github.com/amrhas82/liteagents/docs
+- **Issues**: https://github.com/amrhas82/liteagents/issues
 - **Security**: See [SECURITY.md](docs/SECURITY.md) for vulnerability reporting
 
 ---

package/docs/SECURITY.md

@@ -116,10 +116,10 @@ This document outlines the security measures implemented in Agentic Kit and prov
 
 **File Permissions**:
 ```
-~/.agentic-kit-install.log        - 0600 (read/write owner only)
-~/.agentic-kit-config.json        - 0600 (read/write owner only)
-~/.agentic-kit-telemetry.log      - 0600 (read/write owner only)
-~/.agentic-kit-install-state.json - 0600 (read/write owner only)
+~/.liteagents-install.log        - 0600 (read/write owner only)
+~/.liteagents-config.json        - 0600 (read/write owner only)
+~/.liteagents-telemetry.log      - 0600 (read/write owner only)
+~/.liteagents-install-state.json - 0600 (read/write owner only)
 ```
 
 **Code Locations**:
@@ -229,7 +229,7 @@ node installer/cli.js --variant standard --tools claude
 3. **Use Default Paths**: Default paths are safer and well-tested
 4. **Keep Node.js Updated**: Ensure you're using a supported Node.js version
 5. **Review Logs**: Check installation logs for unexpected behavior
-6. **Verify Sources**: Only download agentic-kit from official sources
+6. **Verify Sources**: Only download liteagents from official sources
 
 ### For Developers