ancoder-skill-cli 0.13.28 → 0.13.29

package/README.md

@@ -24,7 +24,7 @@ After install, the wrapper selects the correct bundled binary for the current pl
 
 ## One-line install (Gitee or intranet)
 
-For users who cannot access GitHub, mirror this repository to Gitee or copy these files to an intranet static file server:
+For users who cannot access GitHub, publish the release-only bundle to Gitee or copy these files to an intranet static file server:
 
 - `scripts/install.ps1`
 - `scripts/install.sh`
@@ -34,40 +34,65 @@ For users who cannot access GitHub, mirror this repository to Gitee or copy thes
 - `bin/targets/skill-cli-darwin-arm64`
 - `bin/targets/skill-cli-darwin-x64`
 
-Windows users can install from Gitee with PowerShell. The most stable command pins both the script and binary to the same release tag:
+Windows users can install the latest Gitee release with PowerShell:
 
 ```powershell
-irm https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28/scripts/install.ps1 | iex
+irm https://gitee.com/marvin-dev/skill-cli-release/raw/main/scripts/install.ps1 | iex
 ```
 
-macOS/Linux users can install from Gitee with curl:
+macOS/Linux users can install the latest Gitee release with curl:
 
 ```bash
-curl -fsSL https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28/scripts/install.sh | bash
+curl -fsSL https://gitee.com/marvin-dev/skill-cli-release/raw/main/scripts/install.sh | bash
 ```
 
 The installer downloads the matching prebuilt binary, installs it as `skill-cli`, runs `skill-cli install`, then runs a lite `doctor` check. No Go toolchain is required.
 
-Before sharing the Gitee command externally, make sure the Gitee mirror contains the `v0.13.28` tag. The installer downloads the version-pinned `v0.13.28` binary by default.
+The `raw/main` URL is the moving latest channel. Each GitHub release updates Gitee `main` with the newest install bundle. If you need a reproducible install, pin a specific release tag instead:
+
+```powershell
+irm https://gitee.com/marvin-dev/skill-cli-release/raw/v0.13.29/scripts/install.ps1 | iex
+```
+
+```bash
+curl -fsSL https://gitee.com/marvin-dev/skill-cli-release/raw/v0.13.29/scripts/install.sh | bash
+```
+
+Before sharing the Gitee command externally, make sure both the Gitee `main` branch and the release tag have been updated. The installer in `main` is generated from the latest release bundle.
 
 Gitee release checklist:
 
 1. Run `go test ./...`, `bash scripts/build-all.sh`, `node scripts/check-bin.js`, and `npm pack --dry-run`.
 2. Commit `bin/targets/`, `scripts/install.ps1`, `scripts/install.sh`, `scripts/make-install-bundle.js`, `scripts/check-install-host.js`, `scripts/check-bin.js`, `scripts/build-all.sh`, `package.json`, `package-lock.json`, `.gitattributes`, and `README.md`.
-3. Push `main` and the release tag to Gitee, or mirror them from GitHub.
+3. Push the release tag to GitHub. The GitHub Actions release workflow builds the binaries and syncs a dist-only bundle to `git@gitee.com:marvin-dev/skill-cli-release.git`.
 4. Verify these URLs return `200` before sending the install command:
-   - `https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28/scripts/install.ps1`
-   - `https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28/scripts/install.sh`
-   - `https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28/bin/targets/skill-cli-win32-x64.exe`
+   - `https://gitee.com/marvin-dev/skill-cli-release/raw/main/scripts/install.ps1`
+   - `https://gitee.com/marvin-dev/skill-cli-release/raw/main/scripts/install.sh`
+   - `https://gitee.com/marvin-dev/skill-cli-release/raw/main/bin/targets/skill-cli-win32-x64.exe`
+   - `https://gitee.com/marvin-dev/skill-cli-release/raw/v0.13.29/scripts/install.ps1`
+   - `https://gitee.com/marvin-dev/skill-cli-release/raw/v0.13.29/bin/targets/skill-cli-win32-x64.exe`
    Or run:
 
    ```bash
    node scripts/check-install-host.js \
-     --script-root https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28 \
-     --base-url https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28/bin/targets
+     --script-root https://gitee.com/marvin-dev/skill-cli-release/raw/main \
+     --base-url https://gitee.com/marvin-dev/skill-cli-release/raw/main/bin/targets
+   ```
+
+5. Share the `raw/main` install command only after the check above passes.
+
+GitHub Actions Gitee sync setup:
+
+1. Create a dedicated SSH key for the Gitee release-only repo:
+
+   ```bash
+   ssh-keygen -t ed25519 -C "github-actions skill-cli-release" -f ~/.ssh/skill-cli-release-gitee
    ```
 
-5. Share the tag-pinned install command only after the check above passes.
+2. Add the public key `~/.ssh/skill-cli-release-gitee.pub` to Gitee with write access to `git@gitee.com:marvin-dev/skill-cli-release.git`.
+3. Add the private key content from `~/.ssh/skill-cli-release-gitee` to the GitHub repository secret `GITEE_SSH_PRIVATE_KEY`.
+
+The workflow only pushes the generated `dist/install/` bundle to Gitee, so the source repository remains GitHub-only.
 
 For private intranet hosting, generate a static install bundle and upload the generated `dist/install/` directory as-is:
 
@@ -114,20 +139,20 @@ Useful options:
 ```powershell
 # Install the binary only, without writing ~/.claude components
 $env:SKILL_CLI_NO_INSTALL = "1"
-irm https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28/scripts/install.ps1 | iex
+irm https://gitee.com/marvin-dev/skill-cli-release/raw/main/scripts/install.ps1 | iex
 
 # For a clean smoke test against a temporary Claude directory
 $env:SKILL_CLI_NO_INSTALL = $null
 $env:SKILL_CLI_CLAUDE_DIR = "$PWD\.skill-cli-test-claude"
-irm https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28/scripts/install.ps1 | iex
+irm https://gitee.com/marvin-dev/skill-cli-release/raw/main/scripts/install.ps1 | iex
 ```
 
 ```bash
 # Install the binary only, without writing ~/.claude components
-curl -fsSL https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28/scripts/install.sh | bash -s -- --no-install
+curl -fsSL https://gitee.com/marvin-dev/skill-cli-release/raw/main/scripts/install.sh | bash -s -- --no-install
 
 # For a clean smoke test against a temporary Claude directory
-curl -fsSL https://gitee.com/marvin-dev/skill-cli-creator/raw/v0.13.28/scripts/install.sh | \
+curl -fsSL https://gitee.com/marvin-dev/skill-cli-release/raw/main/scripts/install.sh | \
   bash -s -- --claude-dir "$PWD/.skill-cli-test-claude"
 ```
 
@@ -191,9 +216,19 @@ The evaluator fails the run when critical issues are found or the score is below
 
 Use `--no-adversarial` if you want the older OMC-only generation behavior.
 
+### Generation failure logs
+
+Every `skill-cli generate` run writes a local JSONL session log under:
+
+```text
+<skills-dir>/.skill-cli/logs/generate/<skill-name>-<timestamp>.jsonl
+```
+
+When generation fails, the CLI prints the exact log path. The log records major stages such as Claude binary resolution, scaffold creation, brainstorm probe, loop start/ticks, deterministic gates, repair attempts, and adversarial review failures, including captured command output and error tails for troubleshooting.
+
 ## Publish to npm
 
-Releases are published by GitHub Actions, not by running `npm publish` from a developer machine. The workflow in `.github/workflows/release.yml` runs when a `v*` tag is pushed; it builds the release binaries, creates the GitHub Release, prepares `bin/targets/` for the npm package, and publishes with the repository `NPM_TOKEN` secret.
+Releases are published by GitHub Actions, not by running `npm publish` from a developer machine. The workflow in `.github/workflows/release.yml` runs when a `v*` tag is pushed; it builds the release binaries, creates the GitHub Release, syncs a release-only install bundle to Gitee, prepares `bin/targets/` for the npm package, and publishes with the repository `NPM_TOKEN` secret.
 
 1. Bump `package.json` and `package-lock.json` to the intended version.
 2. Run local verification:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ancoder-skill-cli",
-  "version": "0.13.28",
+  "version": "0.13.29",
   "description": "CLI for managing everything-claude-code (ECC) components — agents, skills, commands, rules, hooks, MCP configs. Single binary, all assets embedded.",
   "bin": {
     "skill-cli": "bin/skill-cli.js"

package/scripts/check-bin.js

@@ -54,7 +54,6 @@ if (missingInstallerFilesEntries.length > 0) {
   process.exit(1);
 }
 
-const expectedVersion = `v${pkg.version}`;
 const installerVersionPatterns = [
   {
     file: 'scripts/install.sh',
@@ -74,8 +73,8 @@ for (const item of installerVersionPatterns) {
     console.error(`skill-cli: could not find default version in ${item.file}`);
     process.exit(1);
   }
-  if (match[1] !== expectedVersion) {
-    console.error(`skill-cli: ${item.file} default version is ${match[1]}, expected ${expectedVersion}`);
+  if (match[1] !== 'main') {
+    console.error(`skill-cli: ${item.file} default version is ${match[1]}, expected main`);
     process.exit(1);
   }
 }

package/scripts/check-install-host.js

@@ -32,8 +32,8 @@ function usage() {
 Examples:
   node scripts/check-install-host.js --root https://intranet.example.com/skill-cli
   node scripts/check-install-host.js \\
-    --script-root https://gitee.com/marvin-dev/skill-cli-creator/raw/${version} \\
-    --base-url https://gitee.com/marvin-dev/skill-cli-creator/raw/${version}/bin/targets
+    --script-root https://gitee.com/marvin-dev/skill-cli-release/raw/main \\
+    --base-url https://gitee.com/marvin-dev/skill-cli-release/raw/main/bin/targets
 
 Checks installer scripts and the Windows binary by default. Pass --all-binaries
 to verify every bundled platform binary.`);

package/scripts/install.ps1

@@ -35,11 +35,11 @@ if (Test-TruthyEnv $env:SKILL_CLI_DRY_RUN) {
 $baseUrlWasProvided = [bool]$BaseUrl
 
 if (-not $Version) {
-  $Version = "v0.13.28"
+  $Version = "main"
 }
 
 if (-not $BaseUrl) {
-  $BaseUrl = "https://gitee.com/marvin-dev/skill-cli-creator/raw/$Version/bin/targets"
+  $BaseUrl = "https://gitee.com/marvin-dev/skill-cli-release/raw/$Version/bin/targets"
 }
 
 if (-not $InstallDir) {

package/scripts/install.sh

@@ -1,9 +1,9 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-DEFAULT_VERSION="v0.13.28"
+DEFAULT_VERSION="main"
 VERSION="${SKILL_CLI_VERSION:-$DEFAULT_VERSION}"
-DEFAULT_BASE_URL="https://gitee.com/marvin-dev/skill-cli-creator/raw/${VERSION}/bin/targets"
+DEFAULT_BASE_URL="https://gitee.com/marvin-dev/skill-cli-release/raw/${VERSION}/bin/targets"
 DEFAULT_BASE_URL_USES_VERSION=1
 BASE_URL="${SKILL_CLI_BASE_URL:-$DEFAULT_BASE_URL}"
 BASE_URL_EXPLICIT=0
@@ -36,7 +36,7 @@ Options:
 
 Environment:
   SKILL_CLI_BASE_URL      Same as --base-url.
-  SKILL_CLI_VERSION       Same as --version. Default: v0.13.28.
+  SKILL_CLI_VERSION       Same as --version. Default: main.
   SKILL_CLI_INSTALL_DIR   Same as --install-dir.
   SKILL_CLI_CLAUDE_DIR    Same as --claude-dir.
   SKILL_CLI_DOCTOR        Same as --doctor.
@@ -53,7 +53,7 @@ while [ "$#" -gt 0 ]; do
     --version)
       VERSION="${2:?missing value for --version}"
       if [ "$BASE_URL_EXPLICIT" = "0" ] && [ "$DEFAULT_BASE_URL_USES_VERSION" = "1" ]; then
-        BASE_URL="https://gitee.com/marvin-dev/skill-cli-creator/raw/${VERSION}/bin/targets"
+        BASE_URL="https://gitee.com/marvin-dev/skill-cli-release/raw/${VERSION}/bin/targets"
       fi
       shift 2
       ;;

package/scripts/make-install-bundle.js

@@ -19,6 +19,7 @@ const targets = [
 const args = process.argv.slice(2);
 let baseURL = '';
 let rootURL = '';
+let scriptRootURL = '';
 for (let i = 0; i < args.length; i += 1) {
   if (args[i] === '--base-url') {
     baseURL = args[i + 1] || '';
@@ -26,15 +27,20 @@ for (let i = 0; i < args.length; i += 1) {
   } else if (args[i] === '--root') {
     rootURL = args[i + 1] || '';
     i += 1;
+  } else if (args[i] === '--script-root') {
+    scriptRootURL = args[i + 1] || '';
+    i += 1;
   } else if (args[i] === '-h' || args[i] === '--help') {
     console.log(`Usage:
   node scripts/make-install-bundle.js [--root URL]
   node scripts/make-install-bundle.js [--base-url URL]
+  node scripts/make-install-bundle.js [--base-url URL] [--script-root URL]
 
 Creates dist/install/ with one-line installer scripts and prebuilt binaries.
 When --root is provided, generated installer copies default to ROOT/bin/targets.
 When --base-url is provided, generated installer copies default to that URL
-for binary downloads, which is useful for intranet static hosting.`);
+for binary downloads, which is useful for intranet static hosting.
+When --script-root is provided, README examples point to SCRIPT_ROOT/scripts.`);
     process.exit(0);
   } else {
     console.error(`unknown option: ${args[i]}`);
@@ -56,6 +62,10 @@ if (rootURL) {
   baseURL = `${rootURL}/bin/targets`;
 }
 
+if (scriptRootURL) {
+  scriptRootURL = trimSlash(scriptRootURL);
+}
+
 function copyFile(src, dest) {
   fs.mkdirSync(path.dirname(dest), { recursive: true });
   fs.copyFileSync(src, dest);
@@ -80,17 +90,24 @@ for (const target of targets) {
 let installSH = fs.readFileSync(path.join(rootDir, 'scripts', 'install.sh'), 'utf8');
 let installPS1 = fs.readFileSync(path.join(rootDir, 'scripts', 'install.ps1'), 'utf8');
 
+installSH = installSH.replace(/DEFAULT_VERSION="[^"]+"/, `DEFAULT_VERSION="${version}"`);
+installSH = installSH.replace(
+  /SKILL_CLI_VERSION       Same as --version\. Default: [^\n]+/,
+  `SKILL_CLI_VERSION       Same as --version. Default: ${version}.`
+);
+installPS1 = installPS1.replace(/\$Version = "[^"]+"/, `$Version = "${version}"`);
+
 if (baseURL) {
   const normalizedBaseURL = trimSlash(baseURL);
   installSH = installSH.replace(
-    /DEFAULT_BASE_URL="https:\/\/gitee\.com\/marvin-dev\/skill-cli-creator\/raw\/\$\{VERSION\}\/bin\/targets"/,
+    /DEFAULT_BASE_URL="https:\/\/gitee\.com\/marvin-dev\/skill-cli-release\/raw\/\$\{VERSION\}\/bin\/targets"/,
     `DEFAULT_BASE_URL="${normalizedBaseURL}"`
   ).replace(
     /DEFAULT_BASE_URL_USES_VERSION=1/,
     'DEFAULT_BASE_URL_USES_VERSION=0'
   );
   installPS1 = installPS1.replace(
-    /\$BaseUrl = "https:\/\/gitee\.com\/marvin-dev\/skill-cli-creator\/raw\/\$Version\/bin\/targets"/,
+    /\$BaseUrl = "https:\/\/gitee\.com\/marvin-dev\/skill-cli-release\/raw\/\$Version\/bin\/targets"/,
     `$BaseUrl = "${normalizedBaseURL}"`
   );
 }
@@ -104,6 +121,7 @@ const manifest = {
   tag: version,
   generatedAt: new Date().toISOString(),
   rootURL: rootURL || null,
+  scriptRootURL: scriptRootURL || null,
   baseURL: baseURL || null,
   files: [
     'scripts/install.ps1',
@@ -121,7 +139,7 @@ function inferInstallRootFromBaseURL(value) {
   return '<your-hosted-root>';
 }
 
-const installRoot = rootURL || (baseURL ? inferInstallRootFromBaseURL(baseURL) : `https://gitee.com/marvin-dev/skill-cli-creator/raw/${version}`);
+const installRoot = scriptRootURL || rootURL || (baseURL ? inferInstallRootFromBaseURL(baseURL) : `https://gitee.com/marvin-dev/skill-cli-release/raw/${version}`);
 const psURL = baseURL ? `${installRoot}/scripts/install.ps1` : `${installRoot}/scripts/install.ps1`;
 const shURL = baseURL ? `${installRoot}/scripts/install.sh` : `${installRoot}/scripts/install.sh`;