gitea-cli-skill 0.3.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.3.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!`);
 }
 
@@ -342,7 +371,7 @@ async function update(args) {
 
   console.log(`Updating gitea-cli skill (${osArch.os}-${osArch.arch}) at ${skillDir}...`);
 
-  // 1. Refresh SKILL.md and REFERENCE.md
+  // 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)) {
@@ -351,11 +380,19 @@ async function update(args) {
     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. Re-download / re-copy binary (always overwrite)
@@ -369,6 +406,9 @@ async function update(args) {
     await installFromRelease(giteaHost, token, scriptsDir, destBinary, osArch);
   }
 
+  // 3. Version consistency check
+  checkVersionConsistency(destBinary);
+
   console.log('\nDone! Configuration preserved.');
 }
 
@@ -409,7 +449,7 @@ Usage:
 
 Commands:
   init                    Install skill (binary + SKILL.md) and optionally configure context
-  update                  Refresh binary and SKILL.md/REFERENCE.md (keeps config)
+  update                  Refresh binary and SKILL.md/references/ (keeps config)
   add context             Add or update a Gitea API context (requires --token)
 
 Flags (init):