liteagents 2.4.0 → 2.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -443,7 +443,7 @@ echo "Exit code: $?"
443
443
 
444
444
  2. **Review installation log:**
445
445
  ```bash
446
- cat ~/.agentic-kit-install.log
446
+ cat ~/.liteagents-install.log
447
447
  ```
448
448
 
449
449
  3. **Test without silent mode first:**
@@ -463,10 +463,10 @@ node -e "console.log(JSON.parse(require('fs').readFileSync('config.json', 'utf8'
463
463
  If you encounter issues:
464
464
 
465
465
  1. Check this guide for common scenarios
466
- 2. Review the installation log at `~/.agentic-kit-install.log`
466
+ 2. Review the installation log at `~/.liteagents-install.log`
467
467
  3. Run with `--help` to see all available options
468
468
  4. Try interactive mode first to diagnose issues
469
- 5. Report issues at: https://github.com/amrhas82/agentflow/issues
469
+ 5. Report issues at: https://github.com/amrhas82/liteagents/issues
470
470
 
471
471
  ## Best Practices
472
472
 
@@ -488,7 +488,7 @@ set -e # Exit on error
488
488
  # Configuration
489
489
  VARIANT="${AGENTIC_KIT_VARIANT:-lite}"
490
490
  TOOLS="${AGENTIC_KIT_TOOLS:-claude}"
491
- INSTALL_PATH="${AGENTIC_KIT_PATH:-/opt/agentic-kit}"
491
+ INSTALL_PATH="${AGENTIC_KIT_PATH:-/opt/liteagents}"
492
492
 
493
493
  # Run installation
494
494
  echo "Installing Agentic Kit ($VARIANT variant, tools: $TOOLS)..."
@@ -8,7 +8,7 @@ This document describes the transformation of 22 Claude skills from `~/.factory/
8
8
 
9
9
  **Original Location**: `~/.factory/commands/`
10
10
  **Total Skills Transformed**: 22
11
- **Output Location**: `/home/hamr/PycharmProjects/agentflow/commands/`
11
+ **Output Location**: `/home/hamr/PycharmProjects/liteagents/commands/`
12
12
 
13
13
  ## Conversion Process
14
14
 
package/docs/TESTING.md CHANGED
@@ -127,7 +127,7 @@ node tests/installer/path-handling-testing.test.js
127
127
  ```
128
128
 
129
129
  **Features Tested**:
130
- - `~/.agentic-kit` → `/home/user/.agentic-kit`
130
+ - `~/.liteagents` → `/home/user/.liteagents`
131
131
  - `./local` → `/current/directory/local`
132
132
  - Path traversal prevention (`../../../etc/passwd` rejected)
133
133
  - Unicode support (émoji, 中文, العربية)
@@ -384,7 +384,7 @@ Recommended quality gates:
384
384
  **Solution**:
385
385
  ```bash
386
386
  # Manual cleanup
387
- rm -rf /tmp/agentic-kit-test-*
387
+ rm -rf /tmp/liteagents-test-*
388
388
  rm -rf /tmp/variant-test-*
389
389
  rm -rf /tmp/multi-tool-test-*
390
390
  rm -rf /tmp/error-test-*
@@ -557,7 +557,7 @@ npm install -g agentic-toolkit
557
557
 
558
558
  1. **Check which files are loaded:**
559
559
  ```bash
560
- du -sh agentflow/
560
+ du -sh liteagents/
561
561
  du -sh skills/
562
562
  ```
563
563
 
@@ -756,7 +756,7 @@ A: Just refresh Claude (F5). Usually no computer restart needed.
756
756
  **Q: Where are files stored?**
757
757
  A: Depends on installation method:
758
758
  - npm: `node_modules/agentic-toolkit/`
759
- - Development: `/path/to/agentflow/`
759
+ - Development: `/path/to/liteagents/`
760
760
 
761
761
  **Q: Can I use multiple variants at once?**
762
762
  A: No, only one variant at a time. Reinstall to switch.
@@ -1,6 +1,6 @@
1
1
  # Variant Configuration Guide
2
2
 
3
- **Purpose:** This document explains the rationale for variant configurations and skill selection across all agentflow tools (Claude, Opencode, Ampcode, Droid).
3
+ **Purpose:** This document explains the rationale for variant configurations and skill selection across all liteagents tools (Claude, Opencode, Ampcode, Droid).
4
4
 
5
5
  **Last Updated:** 2025-11-04
6
6
 
@@ -18,7 +18,7 @@
18
18
 
19
19
  ## Variant Philosophy
20
20
 
21
- The agentflow installer offers **three variant levels** to accommodate different user needs and resource constraints:
21
+ The liteagents installer offers **three variant levels** to accommodate different user needs and resource constraints:
22
22
 
23
23
  ### Design Principles
24
24
 
@@ -153,7 +153,7 @@ These advanced skills are available only in the **Pro variant**:
153
153
  - All hooks
154
154
 
155
155
  **Use Cases:**
156
- - Try agentflow with minimal commitment
156
+ - Try liteagents with minimal commitment
157
157
  - Learn the agent system before full installation
158
158
  - Limited resource environments (cloud VMs, containers)
159
159
  - Quick setup for demonstrations
@@ -269,7 +269,7 @@ While all tools share the same variant structure and core skills, each has optim
269
269
  ### Choosing a Variant
270
270
 
271
271
  **Start with Lite if:**
272
- - You're evaluating agentflow for the first time
272
+ - You're evaluating liteagents for the first time
273
273
  - You have limited disk space (< 50 MB available)
274
274
  - You only need basic workflow management
275
275
  - You want to learn the system before full installation
@@ -358,7 +358,7 @@ Skills are updated independently of agents:
358
358
 
359
359
  ### Variant Evolution
360
360
 
361
- As agentflow evolves, variant definitions may change:
361
+ As liteagents evolves, variant definitions may change:
362
362
 
363
363
  **Standard Variant Philosophy:**
364
364
  - Will always include essential document processing (pdf, docx, xlsx, pptx)
package/installer/cli.js CHANGED
@@ -369,7 +369,7 @@ class InteractiveInstaller {
369
369
  return {
370
370
  type: 'Missing Package Error',
371
371
  advice: [
372
- 'Run: npm install -g agentflow',
372
+ 'Run: npm install -g liteagents',
373
373
  'Check: packages directory exists'
374
374
  ],
375
375
  technicalDetails: `Missing file or package validation failed`
@@ -418,7 +418,7 @@ class InteractiveInstaller {
418
418
  type: 'Unknown Error',
419
419
  advice: [
420
420
  'Try running installer again',
421
- 'Report at: https://github.com/amrhas82/agentflow/issues'
421
+ 'Report at: https://github.com/amrhas82/liteagents/issues'
422
422
  ],
423
423
  technicalDetails: error.stack ? error.stack.split('\n')[1] : 'No additional details'
424
424
  };
@@ -726,7 +726,7 @@ ${colors.bright}v2.4.0 | 11 agents + 20 commands per tool${colors.reset}
726
726
  * @param {string} toolName - Display name of the tool
727
727
  */
728
728
  /**
729
- * Generate and save installation report to ~/.agentflow-install.log
729
+ * Generate and save installation report to ~/.liteagents-install.log
730
730
  * Creates a detailed log of the installation session
731
731
  *
732
732
  * @param {array} successfulInstalls - Array of successful installation objects
@@ -6,11 +6,11 @@ const os = require('os');
6
6
  * Report Template Generator
7
7
  *
8
8
  * Generates detailed installation reports with summary and per-tool details.
9
- * Reports are saved to ~/.agentflow-install.log after each installation.
9
+ * Reports are saved to ~/.liteagents-install.log after each installation.
10
10
  */
11
11
  class ReportTemplate {
12
12
  constructor() {
13
- this.reportPath = path.join(os.homedir(), '.agentflow-install.log');
13
+ this.reportPath = path.join(os.homedir(), '.liteagents-install.log');
14
14
  }
15
15
 
16
16
  /**
@@ -268,7 +268,7 @@ WARNINGS
268
268
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
269
269
 
270
270
  For support and documentation, visit:
271
- https://github.com/amrhas82/agentflow
271
+ https://github.com/amrhas82/liteagents
272
272
 
273
273
  Report saved to: ${this.reportPath}
274
274
 
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "liteagents",
3
- "version": "2.4.0",
3
+ "version": "2.4.1",
4
4
  "description": "AI development toolkit with 11 specialized agents and 20 commands. Simple one-question installer for Claude, Opencode, Ampcode, and Droid.",
5
5
  "main": "index.js",
6
6
  "bin": {
7
- "agentflow": "./installer/cli.js",
8
- "agflow": "./cli.js"
7
+ "liteagents": "./installer/cli.js",
8
+ "liteag": "./cli.js"
9
9
  },
10
10
  "scripts": {
11
11
  "test": "node tests/run-all-tests.js",
@@ -17,9 +17,6 @@
17
17
  "validate": "node ./scripts/validate-package.js",
18
18
  "validate-packages": "node scripts/validate-all-packages.js",
19
19
  "prepublishOnly": "npm run clean && npm run validate",
20
- "publish:npm": "npm publish --registry https://registry.npmjs.org --access public",
21
- "publish:github": "npm publish --registry https://npm.pkg.github.com",
22
- "publish:both": "npm run publish:npm && npm run publish:github",
23
20
  "postinstall": "node postinstall.js"
24
21
  },
25
22
  "keywords": [
@@ -51,12 +48,12 @@
51
48
  "license": "MIT",
52
49
  "repository": {
53
50
  "type": "git",
54
- "url": "https://github.com/amrhas82/agentflow.git"
51
+ "url": "https://github.com/amrhas82/liteagents.git"
55
52
  },
56
53
  "bugs": {
57
- "url": "https://github.com/amrhas82/agentflow/issues"
54
+ "url": "https://github.com/amrhas82/liteagents/issues"
58
55
  },
59
- "homepage": "https://github.com/amrhas82/agentflow#readme",
56
+ "homepage": "https://github.com/amrhas82/liteagents#readme",
60
57
  "publishConfig": {
61
58
  "registry": "https://registry.npmjs.org",
62
59
  "access": "public"
@@ -1,177 +0,0 @@
1
- # Dual Publishing Setup Complete ✅
2
-
3
- Your Agentic Kit package is now configured to publish to **both npm.js and GitHub Packages** with every update!
4
-
5
- ---
6
-
7
- ## ✅ What Was Configured
8
-
9
- ### 1. Package Configuration (`package.json`)
10
- - Default registry set to npm.js (easier for users)
11
- - Added publishing scripts:
12
- - `npm run publish:npm` - Publish to npm.js only
13
- - `npm run publish:github` - Publish to GitHub Packages only
14
- - `npm run publish:both` - **Publish to BOTH** (recommended)
15
-
16
- ### 2. Authentication (`.npmrc`)
17
- - GitHub Packages authentication ready
18
- - Uses `GITHUB_TOKEN` environment variable
19
-
20
- ### 3. Publishing Script (`publish.sh`)
21
- - Automated script that validates and publishes to both registries
22
- - Handles missing GitHub token gracefully
23
-
24
- ### 4. Documentation
25
- - **`docs/PUBLISHING.md`** - Complete merged guide for all publishing
26
- - **`docs/GITHUB_SETUP.md`** - First-time GitHub Packages setup
27
- - **Deleted:** `docs/GITHUB_PACKAGES.md` (merged into PUBLISHING.md)
28
-
29
- ---
30
-
31
- ## 🚀 Quick Start - Publish to Both Registries
32
-
33
- ### First Time Only: Setup GitHub Packages
34
-
35
- 1. **Create GitHub Token:**
36
- - Visit: https://github.com/settings/tokens
37
- - Click "Generate new token (classic)"
38
- - Select scopes: `write:packages`, `read:packages`
39
- - Copy token (starts with `ghp_`)
40
-
41
- 2. **Set Environment Variable:**
42
- ```bash
43
- export GITHUB_TOKEN=ghp_your_token_here
44
-
45
- # Make it permanent (add to ~/.bashrc or ~/.zshrc)
46
- echo 'export GITHUB_TOKEN=ghp_your_token_here' >> ~/.bashrc
47
- source ~/.bashrc
48
- ```
49
-
50
- 3. **Verify:**
51
- ```bash
52
- echo $GITHUB_TOKEN # Should show your token
53
- ```
54
-
55
- **See full setup guide:** [`docs/GITHUB_SETUP.md`](docs/GITHUB_SETUP.md)
56
-
57
- ---
58
-
59
- ## 📦 Publishing Workflow
60
-
61
- ### Option 1: Use the Script (Easiest)
62
-
63
- ```bash
64
- cd /home/hamr/PycharmProjects/agentflow
65
- ./publish.sh
66
- ```
67
-
68
- ### Option 2: Use npm Scripts
69
-
70
- ```bash
71
- # Publish to both registries
72
- npm run publish:both
73
-
74
- # Or publish individually
75
- npm run publish:npm # npm.js only
76
- npm run publish:github # GitHub Packages only
77
- ```
78
-
79
- ### Complete Release Process
80
-
81
- ```bash
82
- # 1. Update version
83
- ./UPDATE_VERSION.sh 1.2.0
84
-
85
- # 2. Update CHANGELOG.md
86
- # (Add your release notes)
87
-
88
- # 3. Commit and tag
89
- git add .
90
- git commit -m "Bump version to 1.2.0"
91
- git tag v1.2.0
92
- git push origin main --tags
93
-
94
- # 4. Publish to both registries
95
- npm run publish:both
96
-
97
- # 5. Verify
98
- # - npm.js: https://www.npmjs.com/package/agentflow
99
- # - GitHub: https://github.com/amrhas82/agentflow/packages
100
- ```
101
-
102
- ---
103
-
104
- ## 📋 Files Modified/Created
105
-
106
- ### Modified:
107
- - ✅ `package.json` - Added publish scripts, set npm.js as default
108
- - ✅ `.npmrc` - GitHub Packages authentication
109
- - ✅ `docs/PUBLISHING.md` - Merged and updated complete guide
110
-
111
- ### Created:
112
- - ✅ `publish.sh` - Automated dual publishing script
113
- - ✅ `docs/GITHUB_SETUP.md` - First-time setup guide
114
- - ✅ `.gitignore` - Prevents committing sensitive/backup files
115
-
116
- ### Deleted:
117
- - ✅ `docs/GITHUB_PACKAGES.md` - Merged into PUBLISHING.md
118
-
119
- ---
120
-
121
- ## 🔍 Verification After Publishing
122
-
123
- ### npm.js
124
- - **Page:** https://www.npmjs.com/package/agentflow
125
- - **Test:** `npx agentflow --help`
126
-
127
- ### GitHub Packages
128
- - **Page:** https://github.com/amrhas82/agentflow (click "Packages" on right)
129
- - **Direct:** https://github.com/amrhas82/agentflow/packages
130
-
131
- ---
132
-
133
- ## ❓ Common Questions
134
-
135
- ### Q: Do I need to publish to both every time?
136
- **A:** Yes, each registry is separate. Use `npm run publish:both` to publish everywhere with one command.
137
-
138
- ### Q: What if I only want to publish to npm.js?
139
- **A:** Just use `npm run publish:npm` or regular `npm publish --access public`
140
-
141
- ### Q: What if my GitHub token expires?
142
- **A:** Generate a new token at https://github.com/settings/tokens and update your `GITHUB_TOKEN` variable.
143
-
144
- ### Q: Can users install from either registry?
145
- **A:** Yes! npm.js is easier (no token required). GitHub Packages requires users to set up `.npmrc` with their own GitHub token.
146
-
147
- ---
148
-
149
- ## 📚 Full Documentation
150
-
151
- - **Publishing Guide:** [`docs/PUBLISHING.md`](PUBLISHING.md)
152
- - **GitHub Setup:** [`docs/GITHUB_SETUP.md`](docs/GITHUB_SETUP.md)
153
- - **Version Management:** Use `./UPDATE_VERSION.sh`
154
-
155
- ---
156
-
157
- ## 🎯 Next Steps
158
-
159
- 1. **Setup GitHub Token** (if not done yet)
160
- - Follow: [`docs/GITHUB_SETUP.md`](docs/GITHUB_SETUP.md)
161
-
162
- 2. **Test Publishing**
163
- ```bash
164
- npm run publish:both
165
- ```
166
-
167
- 3. **Verify Both Registries**
168
- - Check npm.js and GitHub Packages pages
169
-
170
- ---
171
-
172
- **You're all set! 🎉**
173
-
174
- Every time you want to publish an update, just run:
175
- ```bash
176
- npm run publish:both
177
- ```
@@ -1,181 +0,0 @@
1
- # Publishing to GitHub Packages
2
-
3
- This guide shows how to publish `agentflow` to GitHub Packages npm registry.
4
-
5
- ## Prerequisites
6
-
7
- - GitHub account with access to `amrhas82/agentic-kit` repository
8
- - npm installed locally
9
- - Git repository already pushed to GitHub
10
-
11
- ## Setup Steps
12
-
13
- ### 1. Create GitHub Personal Access Token
14
-
15
- 1. Go to GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
16
- - Direct link: https://github.com/settings/tokens
17
- 2. Click **"Generate new token"** → **"Generate new token (classic)"**
18
- 3. Configure token:
19
- - **Note**: `Publish agentic-kit to GitHub Packages`
20
- - **Expiration**: Choose your preference (90 days recommended)
21
- - **Scopes**: Select these permissions:
22
- - ✅ `write:packages` - Upload packages to GitHub Package Registry
23
- - ✅ `read:packages` - Download packages from GitHub Package Registry
24
- - ✅ `delete:packages` - Delete packages from GitHub Package Registry (optional)
25
- 4. Click **"Generate token"**
26
- 5. **IMPORTANT**: Copy the token immediately (you won't see it again)
27
-
28
- ### 2. Configure Authentication
29
-
30
- Set your GitHub token as an environment variable:
31
-
32
- ```bash
33
- # On Linux/macOS (add to ~/.bashrc or ~/.zshrc for persistence)
34
- export GITHUB_TOKEN=ghp_your_token_here
35
-
36
- # On Windows (Command Prompt)
37
- set GITHUB_TOKEN=ghp_your_token_here
38
-
39
- # On Windows (PowerShell)
40
- $env:GITHUB_TOKEN="ghp_your_token_here"
41
- ```
42
-
43
- **Verify it's set:**
44
- ```bash
45
- echo $GITHUB_TOKEN # Linux/macOS
46
- echo %GITHUB_TOKEN% # Windows CMD
47
- echo $env:GITHUB_TOKEN # Windows PowerShell
48
- ```
49
-
50
- ### 3. Publish to GitHub Packages
51
-
52
- ```bash
53
- cd /home/hamr/PycharmProjects/agentflow
54
-
55
- # Ensure you're on the right version
56
- npm version # Should show 1.1.0
57
-
58
- # Publish to GitHub Packages
59
- npm publish
60
- ```
61
-
62
- ### 4. Verify Publication
63
-
64
- 1. Go to your GitHub repository: https://github.com/amrhas82/agentflow
65
- 2. Click on **"Packages"** on the right sidebar
66
- 3. You should see `agentflow` listed
67
-
68
- ## Installing from GitHub Packages
69
-
70
- Users can install your package from GitHub Packages:
71
-
72
- ### For Users
73
-
74
- Create `.npmrc` in their project or home directory:
75
-
76
- ```
77
- @amrhas82:registry=https://npm.pkg.github.com
78
- //npm.pkg.github.com/:_authToken=THEIR_GITHUB_TOKEN
79
- ```
80
-
81
- Then install:
82
- ```bash
83
- npm install agentflow
84
- ```
85
-
86
- ## Publishing to Both Registries
87
-
88
- You can publish to **both** npm registry AND GitHub Packages:
89
-
90
- ### Option 1: Publish to npm.js (public registry)
91
-
92
- ```bash
93
- # Remove or comment out publishConfig in package.json
94
- # Then publish
95
- npm publish --registry https://registry.npmjs.org --access public
96
- ```
97
-
98
- ### Option 2: Publish to GitHub Packages
99
-
100
- ```bash
101
- # Keep publishConfig in package.json pointing to GitHub
102
- npm publish
103
- ```
104
-
105
- ### Option 3: Publish to Both (Recommended)
106
-
107
- ```bash
108
- # 1. Publish to npm.js first
109
- npm publish --registry https://registry.npmjs.org --access public
110
-
111
- # 2. Then publish to GitHub Packages
112
- npm publish --registry https://npm.pkg.github.com
113
- ```
114
-
115
- ## Updating Package.json for Dual Publishing
116
-
117
- If you want to make npm.js the default and GitHub Packages optional:
118
-
119
- **package.json:**
120
- ```json
121
- {
122
- "name": "agentflow",
123
- "version": "1.1.0",
124
- "publishConfig": {
125
- "registry": "https://registry.npmjs.org",
126
- "access": "public"
127
- }
128
- }
129
- ```
130
-
131
- Then to publish to GitHub Packages specifically:
132
- ```bash
133
- npm publish --registry https://npm.pkg.github.com
134
- ```
135
-
136
- ## Current Configuration
137
-
138
- Your package is currently configured to publish to **GitHub Packages by default**.
139
-
140
- **package.json** has:
141
- ```json
142
- "publishConfig": {
143
- "registry": "https://npm.pkg.github.com"
144
- }
145
- ```
146
-
147
- **.npmrc** contains:
148
- ```
149
- @amrhas82:registry=https://npm.pkg.github.com
150
- //npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
151
- ```
152
-
153
- ## Troubleshooting
154
-
155
- ### Error: 401 Unauthorized
156
-
157
- - Verify your `GITHUB_TOKEN` is set correctly
158
- - Ensure token has `write:packages` scope
159
- - Check token hasn't expired
160
-
161
- ### Error: 404 Not Found
162
-
163
- - Verify repository exists: https://github.com/amrhas82/agentflow
164
- - Ensure package name matches repository owner: `agentflow`
165
-
166
- ### Error: 403 Forbidden
167
-
168
- - Verify you have write access to the repository
169
- - Check repository visibility settings (public/private)
170
-
171
- ### Package Not Showing Up
172
-
173
- - Wait a few minutes (can take 5-10 minutes)
174
- - Check GitHub repository → Packages tab
175
- - Verify publish command succeeded without errors
176
-
177
- ## Links
178
-
179
- - **GitHub Packages Documentation**: https://docs.github.com/en/packages
180
- - **npm Registry Documentation**: https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-npm-registry
181
- - **Package URL (after publishing)**: https://github.com/amrhas82/agentflow/packages