gitea-cli-skill 0.2.0 → 0.3.1

package/assets/SKILL.md

@@ -83,8 +83,10 @@ Destructive ops: always `list`/`get` first, then `--force`. Deleted resources ca
 
 ## On-Demand Reference
 
-For full command flags and detailed workflow steps, read the reference file:
+For full command flags and detailed workflow steps, read:
 
 ```
-~/.claude/skills/gitea-cli/REFERENCE.md
+references/command-reference.md
 ```
+
+Located in the same skill directory as this file.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitea-cli-skill",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Install gitea-cli as a Claude Code skill",
   "bin": {
     "gitea-cli-skill": "src/index.js"

package/src/index.js

@@ -12,6 +12,7 @@ const GITEA_HOST = 'https://x.xgit.pro';
 const GITEA_OWNER = 'chenqi';
 const GITEA_REPO = 'git-cli';
 const SKILL_NAME = 'gitea-cli';
+const PKG_VERSION = require(path.resolve(__dirname, '..', 'package.json')).version;
 
 // ── Platform definitions ────────────────────────────────────────────────────
 
@@ -158,6 +159,23 @@ function configureContext({ giteaCliBin, host, token, contextName, defaultOwner,
   execSync(cmdArgs.join(' '), { stdio: 'inherit', timeout: 10000 });
 }
 
+// ── Version consistency check ────────────────────────────────────────────────
+
+function checkVersionConsistency(binaryPath) {
+  if (!fs.existsSync(binaryPath)) return;
+  try {
+    const raw = execSync(`"${binaryPath}" --version`, { encoding: 'utf-8', timeout: 5000 }).trim();
+    // Parse version from output like "gitea-cli version 0.3.0" or just "0.3.0"
+    const match = raw.match(/(\d+\.\d+\.\d+)/);
+    if (!match) return;
+    const binVersion = match[1];
+    if (binVersion !== PKG_VERSION) {
+      console.warn(`  ⚠ Version mismatch: npm=${PKG_VERSION}, binary=${binVersion}`);
+      console.warn('    Run `npx gitea-cli-skill@latest update` to sync.');
+    }
+  } catch { /* non-blocking */ }
+}
+
 // ── Install command ─────────────────────────────────────────────────────────
 
 async function install(args) {
@@ -170,18 +188,26 @@ async function install(args) {
 
   console.log(`Installing gitea-cli skill (${osArch.os}-${osArch.arch}) to ${skillDir}...`);
 
-  // 1. Copy SKILL.md and REFERENCE.md
+  // 1. Copy SKILL.md and references/
   fs.mkdirSync(skillDir, { recursive: true });
   const srcSkill = path.resolve(__dirname, '..', 'assets', 'SKILL.md');
   const destSkill = path.join(skillDir, 'SKILL.md');
   fs.copyFileSync(srcSkill, destSkill);
   console.log(`  SKILL.md -> ${destSkill}`);
 
-  const srcRef = path.resolve(__dirname, '..', 'assets', 'REFERENCE.md');
-  const destRef = path.join(skillDir, 'REFERENCE.md');
+  const srcRef = path.resolve(__dirname, '..', 'assets', 'references', 'command-reference.md');
+  const destRef = path.join(skillDir, 'references', 'command-reference.md');
   if (fs.existsSync(srcRef)) {
+    fs.mkdirSync(path.dirname(destRef), { recursive: true });
     fs.copyFileSync(srcRef, destRef);
-    console.log(`  REFERENCE.md -> ${destRef}`);
+    console.log(`  references/command-reference.md -> ${destRef}`);
+  }
+
+  // Cleanup: remove legacy REFERENCE.md from old location
+  const legacyRef = path.join(skillDir, 'REFERENCE.md');
+  if (fs.existsSync(legacyRef)) {
+    fs.unlinkSync(legacyRef);
+    console.log('  Removed legacy REFERENCE.md');
   }
 
   // 2. Check existing binary
@@ -214,6 +240,9 @@ async function install(args) {
     }
   }
 
+  // 4. Version consistency check
+  checkVersionConsistency(destBinary);
+
   console.log(`\nDone!`);
 }
 
@@ -331,6 +360,58 @@ async function addContext(args) {
   configureContext({ giteaCliBin, host, token, contextName, defaultOwner, defaultRepo });
 }
 
+// ── Update command ────────────────────────────────────────────────────────────
+
+async function update(args) {
+  const { host: explicitHost, platform: platformName, target: targetPath, local: localDir } = args;
+  const giteaHost = explicitHost || GITEA_HOST;
+  const osArch = detectOSArch();
+  const skillDir = resolveSkillDir(platformName, targetPath);
+  const scriptsDir = path.join(skillDir, 'scripts', `${osArch.os}-${osArch.arch}`);
+
+  console.log(`Updating gitea-cli skill (${osArch.os}-${osArch.arch}) at ${skillDir}...`);
+
+  // 1. Refresh SKILL.md and references/
+  const srcSkill = path.resolve(__dirname, '..', 'assets', 'SKILL.md');
+  const destSkill = path.join(skillDir, 'SKILL.md');
+  if (fs.existsSync(srcSkill)) {
+    fs.mkdirSync(skillDir, { recursive: true });
+    fs.copyFileSync(srcSkill, destSkill);
+    console.log(`  SKILL.md -> ${destSkill}`);
+  }
+
+  const srcRef = path.resolve(__dirname, '..', 'assets', 'references', 'command-reference.md');
+  const destRef = path.join(skillDir, 'references', 'command-reference.md');
+  if (fs.existsSync(srcRef)) {
+    fs.mkdirSync(path.dirname(destRef), { recursive: true });
+    fs.copyFileSync(srcRef, destRef);
+    console.log(`  references/command-reference.md -> ${destRef}`);
+  }
+
+  // Cleanup: remove legacy REFERENCE.md from old location
+  const legacyRef = path.join(skillDir, 'REFERENCE.md');
+  if (fs.existsSync(legacyRef)) {
+    fs.unlinkSync(legacyRef);
+    console.log('  Removed legacy REFERENCE.md');
+  }
+
+  // 2. Re-download / re-copy binary (always overwrite)
+  const binaryName = osArch.os === 'windows' ? 'gitea-cli.exe' : 'gitea-cli';
+  const destBinary = path.join(scriptsDir, binaryName);
+
+  if (localDir) {
+    installFromLocal(localDir, scriptsDir, destBinary, osArch);
+  } else {
+    const token = process.env.GITEA_TOKEN || null;
+    await installFromRelease(giteaHost, token, scriptsDir, destBinary, osArch);
+  }
+
+  // 3. Version consistency check
+  checkVersionConsistency(destBinary);
+
+  console.log('\nDone! Configuration preserved.');
+}
+
 // ── CLI ──────────────────────────────────────────────────────────────────────
 
 function parseArgs(argv) {
@@ -363,10 +444,12 @@ function printHelp() {
 
 Usage:
   npx gitea-cli-skill init [flags]                          # Install + configure
+  npx gitea-cli-skill update [flags]                        # Refresh binary + docs
   gitea-cli-skill add context [flags]                       # Update context only
 
 Commands:
   init                    Install skill (binary + SKILL.md) and optionally configure context
+  update                  Refresh binary and SKILL.md/references/ (keeps config)
   add context             Add or update a Gitea API context (requires --token)
 
 Flags (init):
@@ -380,6 +463,12 @@ Flags (init):
   --default-repo <repo>    Default repo for auto-config (optional)
   --force                  Overwrite existing binary
 
+Flags (update):
+  --host <url>             Gitea host URL (default: ${GITEA_HOST})
+  --local <dir>            Update from local goreleaser dist directory (skip download)
+  --platform <name>        Target AI platform (default: claude)
+  --target <path>          Custom install directory (overrides --platform)
+
 Flags (add context):
   --name <name>            Context name (default: "default")
   --host <url>             Gitea host URL (required)
@@ -404,6 +493,12 @@ Examples:
   # Install only (public repo, no token needed)
   npx gitea-cli-skill init
 
+  # Update binary and docs after new release
+  npx gitea-cli-skill update
+
+  # Update from local build
+  npx gitea-cli-skill update --local ../dist
+
   # Update context later
   gitea-cli-skill add context --host https://gitea.example.com --token new-token
 
@@ -428,6 +523,13 @@ async function main() {
       process.exit(1);
     }
     await install(args);
+  } else if (args.command === 'update') {
+    if (args.platform && !PLATFORMS[args.platform] && !args.target) {
+      console.error(`Unknown platform: ${args.platform}`);
+      console.error(`Available: ${Object.keys(PLATFORMS).join(', ')}, or use --target for custom path.`);
+      process.exit(1);
+    }
+    await update(args);
   } else if (args.command === 'add' && args.subcommand === 'context') {
     await addContext(args);
   } else {