claudekit-cli 1.0.1 → 1.2.0

package/.github/workflows/ci.yml

@@ -5,10 +5,12 @@ on:
     branches:
       - main
       - master
+      - dev
   push:
     branches:
       - main
       - master
+      - dev
 
 jobs:
   test:

package/.github/workflows/release.yml

@@ -56,3 +56,47 @@ jobs:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
         run: npx semantic-release
+
+      - name: Notify Discord
+        if: ${{ success() }}
+        uses: actions/github-script@v7
+        env:
+          DISCORD_WEBHOOK_URL: ${{ secrets.DISCORD_WEBHOOK_URL }}
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            if (!process.env.DISCORD_WEBHOOK_URL) {
+              core.warning('DISCORD_WEBHOOK_URL not set, skipping Discord notification.')
+              return
+            }
+
+            const { owner, repo } = context.repo
+            const { data: releases } = await github.rest.repos.listReleases({
+              owner,
+              repo,
+              per_page: 1,
+            })
+
+            if (!releases.length) {
+              core.warning('No releases found, skipping Discord notification.')
+              return
+            }
+
+            const release = releases[0]
+            const description = (release.body || '').slice(0, 4000)
+
+            await fetch(process.env.DISCORD_WEBHOOK_URL, {
+              method: 'POST',
+              headers: { 'Content-Type': 'application/json' },
+              body: JSON.stringify({
+                username: 'ClaudeKit Release Bot',
+                embeds: [
+                  {
+                    title: `Release ${release.name || release.tag_name}`,
+                    url: release.html_url,
+                    description: description || 'No changelog available.',
+                    timestamp: release.created_at,
+                  },
+                ],
+              }),
+            })

package/CHANGELOG.md

@@ -1,3 +1,31 @@
+# [1.2.0](https://github.com/mrgoonie/claudekit-cli/compare/v1.1.0...v1.2.0) (2025-10-17)
+
+
+### Bug Fixes
+
+* **cli:** resolve unicode character rendering in terminal output ([a8d1e53](https://github.com/mrgoonie/claudekit-cli/commit/a8d1e53462be644e8435b17a6679453860a1c06a))
+* **download:** implement hybrid asset download with GitHub tarball fallback ([bfa2262](https://github.com/mrgoonie/claudekit-cli/commit/bfa22624562f5098a017c38d39906315edde98a4))
+* format package.json keywords array to single line ([c4f5858](https://github.com/mrgoonie/claudekit-cli/commit/c4f5858dc1e4d95df5b9e4233884f7ba8b09a09a))
+
+
+### Features
+
+* **cli:** add verbose logging with --verbose flag and log file support ([d0c960d](https://github.com/mrgoonie/claudekit-cli/commit/d0c960d7115f4eb38b328f08ed980eda12dacd4b))
+* **download:** prioritize ClaudeKit package assets in release downloads ([07533fe](https://github.com/mrgoonie/claudekit-cli/commit/07533fead1ed7f8382db81b65c4b82a7578ac86f))
+* **update:** add custom file preservation and fix download authentication ([901f356](https://github.com/mrgoonie/claudekit-cli/commit/901f356de0fed1c68e3ad249d293f3eb3867bacf))
+
+# [1.1.0](https://github.com/mrgoonie/claudekit-cli/compare/v1.0.1...v1.1.0) (2025-10-17)
+
+
+### Bug Fixes
+
+* format package.json keywords array to single line ([c8dd66f](https://github.com/mrgoonie/claudekit-cli/commit/c8dd66faa94a84188790947fe3ee6f562d63cd46))
+
+
+### Features
+
+* **cli:** add versions command to list available releases ([27fbad1](https://github.com/mrgoonie/claudekit-cli/commit/27fbad1be3b5df90cb85ba9a3dd1b0eeb4fa6125))
+
 ## [1.0.1](https://github.com/mrgoonie/claudekit-cli/compare/v1.0.0...v1.0.1) (2025-10-09)
 
 

package/CLAUDE.md

@@ -15,6 +15,8 @@ Your role is to analyze user requirements, delegate tasks to appropriate sub-age
 
 **IMPORTANT:** You must follow strictly the development rules in `./.claude/workflows/development-rules.md` file.
 **IMPORTANT:** Before you plan or proceed any implementation, always read the `./README.md` file first to get context.
+**IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
+**IMPORTANT:** In reports, list any unresolved questions at the end, if any.
 
 ## Documentation Management
 
@@ -29,5 +31,4 @@ We keep all important docs in `./docs` folder and keep updating them, structure
 ├── deployment-guide.md
 ├── system-architecture.md
 └── project-roadmap.md
-```
-
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Duy Nguyen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -94,18 +94,59 @@ ck update --kit engineer
 ck update --kit engineer --version v1.0.0
 ```
 
+### List Available Versions
+
+```bash
+# Show all available versions for all kits
+ck versions
+
+# Filter by specific kit
+ck versions --kit engineer
+ck versions --kit marketing
+
+# Show more versions (default: 30)
+ck versions --limit 50
+
+# Include prereleases and drafts
+ck versions --all
+```
+
 ### Other Commands
 
 ```bash
-# Show version
+# Show CLI version
 ck --version
-ck -v
 
 # Show help
 ck --help
 ck -h
 ```
 
+### Debugging and Verbose Mode
+
+Enable detailed logging for debugging or troubleshooting:
+
+```bash
+# Enable verbose logging with flag
+ck new --verbose
+ck update -v  # Short form
+
+# Using environment variable
+CLAUDEKIT_VERBOSE=1 ck new
+
+# Save logs to file for sharing
+ck new --verbose --log-file debug.log
+```
+
+**Verbose mode shows:**
+- HTTP request/response details (with sanitized tokens)
+- File operations (downloads, extractions, copies)
+- Command execution steps and timing
+- Error stack traces with full context
+- Authentication flow details
+
+**Note:** All sensitive data (tokens, credentials) is automatically sanitized in verbose logs for security.
+
 ## Authentication
 
 The CLI requires a GitHub Personal Access Token (PAT) to download releases from private repositories. The authentication flow follows a multi-tier fallback:
@@ -161,6 +202,34 @@ The following file patterns are protected and will not be overwritten during upd
 - `node_modules/**`, `.git/**`
 - `dist/**`, `build/**`
 
+### Custom .claude Files
+
+When updating a project, the CLI automatically preserves your custom `.claude/` files that don't exist in the new release package. This allows you to maintain:
+
+- Custom slash commands
+- Personal workflows
+- Project-specific configurations
+- Any other custom files in `.claude/` directory
+
+**How it works:**
+1. Before updating, the CLI scans your project's `.claude/` directory
+2. Compares it with the new release's `.claude/` directory
+3. Identifies custom files (files in your project but not in the release)
+4. Automatically protects these custom files during the update
+
+**Example:**
+```
+Your project:
+  .claude/
+    ├── commands/standard.md  (from ClaudeKit)
+    └── commands/my-custom.md (your custom command)
+
+After update:
+  .claude/
+    ├── commands/standard.md  (updated from new release)
+    └── commands/my-custom.md (preserved - your custom file)
+```
+
 ## Development
 
 ```bash
@@ -233,7 +302,8 @@ claudekit-cli/
 ### 1. Commands
 - **`ck new`**: Create new project from release
 - **`ck update`**: Update existing project
-- **`ck --version`**: Show version
+- **`ck versions`**: List available versions of ClaudeKit repositories
+- **`ck --version`**: Show CLI version
 - **`ck --help`**: Show help
 
 ### 2. Authentication (Multi-Tier Fallback)