@fprad0/skill-master-mcp 0.0.12 → 1.0.0

package/package.json

@@ -1,86 +1,87 @@
-{
-  "name": "@fprad0/skill-master-mcp",
-  "version": "0.0.12",
-  "private": false,
-  "type": "module",
-  "description": "Personal MCP server that catalogs, recommends and reports skills with update-aware metadata.",
-  "main": "dist/index.js",
-  "bin": {
-    "skill-master-activation": "./bin/skill-master-activation.mjs",
-    "skill-master-configure-private-registry": "./bin/skill-master-configure-private-registry.mjs",
-    "skill-master-doctor": "./bin/skill-master-doctor.mjs",
-    "skill-master-eval-activation": "./bin/skill-master-eval-activation.mjs",
-    "skill-master-bootstrap-global": "./bin/skill-master-bootstrap-global.mjs",
-    "skill-master-install-global-skills": "./bin/skill-master-install-global-skills.mjs",
-    "skill-master-install-project-skills": "./bin/skill-master-install-project-skills.mjs",
-    "skill-master-menu": "./bin/skill-master-menu.mjs",
-    "skill-master-mcp": "./bin/skill-master.mjs",
-    "skill-master-register-clients": "./bin/skill-master-register-clients.mjs",
-    "skill-master-success-skills": "./bin/skill-master-success-skills.mjs",
-    "skill-master-update": "./bin/skill-master-update.mjs"
-  },
-  "files": [
-    "bin",
-    "dist",
-    "docs/architecture",
-    "docs/planning",
-    "docs/skill-candidates",
-    "docs/operations/GUIA_NPM_PRIVADO.md",
-    "docs/operations/GUIA_NPM_PUBLICO.md",
-    "docs/operations/GUIA_MULTI_COMPUTADOR.md",
-    "docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md",
-    "docs/operations/assets",
-    "docs/operations/cross-platform-auth-transfer",
-    "docs/operations/reborn-menu-cyberpunk-transfer",
-    "docs/prompt-tasks",
-    "manifests",
-    "network",
-    "README.md",
-    "CHANGELOG.md",
-    "VERSION.md",
-    "examples/client-configs",
-    "scripts/render-menu-evidence.mjs",
-    "scripts/verify-menu-actions.mjs",
-    "scripts/configure-private-registry.mjs",
-    "scripts/lib",
-    "sources.json"
-  ],
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/FPrad0/skill-master-mcp.git"
-  },
-  "engines": {
-    "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
-  },
-  "license": "UNLICENSED",
-  "scripts": {
-    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
-    "build": "npm run clean && tsc -p tsconfig.json",
-    "start": "node dist/index.js",
-    "test": "vitest run",
-    "install:project-skills": "node bin/skill-master-install-project-skills.mjs --project-root . --sync-package-json",
-    "setup:private-registry": "node scripts/configure-private-registry.mjs",
-    "eval:activation": "npm run build && node bin/skill-master-eval-activation.mjs",
-    "verify:menu": "node scripts/verify-menu-actions.mjs",
-    "check:manifest": "node scripts/check-manifest.mjs",
-    "check": "npm run build && npm test && npm run verify:menu && npm run check:manifest",
-    "prepack": "npm run build",
-    "pack:dry-run": "npm pack --dry-run",
-    "publish:github": "npm publish --registry=https://npm.pkg.github.com",
-    "publish:npm-public": "npm publish --access public --registry=https://registry.npmjs.org"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "prompts": "^2.4.2",
-    "zod": "^4.4.3"
-  },
-  "devDependencies": {
-    "@types/node": "^24.10.0",
-    "typescript": "^5.9.3",
-    "vite": "6.4.3",
-    "vitest": "3.2.6"
-  }
-}
+{
+  "name": "@fprad0/skill-master-mcp",
+  "version": "1.0.0",
+  "private": false,
+  "type": "module",
+  "description": "Personal MCP server that catalogs, recommends and reports skills with update-aware metadata.",
+  "main": "dist/index.js",
+  "bin": {
+    "skill-master-activation": "./bin/skill-master-activation.mjs",
+    "skill-master-configure-private-registry": "./bin/skill-master-configure-private-registry.mjs",
+    "skill-master-doctor": "./bin/skill-master-doctor.mjs",
+    "skill-master-eval-activation": "./bin/skill-master-eval-activation.mjs",
+    "skill-master-bootstrap-global": "./bin/skill-master-bootstrap-global.mjs",
+    "skill-master-install-global-skills": "./bin/skill-master-install-global-skills.mjs",
+    "skill-master-install-project-skills": "./bin/skill-master-install-project-skills.mjs",
+    "skill-master-menu": "./bin/skill-master-menu.mjs",
+    "skill-master-mcp": "./bin/skill-master.mjs",
+    "skill-master-register-clients": "./bin/skill-master-register-clients.mjs",
+    "skill-master-success-skills": "./bin/skill-master-success-skills.mjs",
+    "skill-master-update": "./bin/skill-master-update.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "docs/architecture",
+    "docs/planning",
+    "docs/skill-candidates",
+    "docs/operations/GUIA_NPM_PRIVADO.md",
+    "docs/operations/GUIA_NPM_PUBLICO.md",
+    "docs/operations/GUIA_MULTI_COMPUTADOR.md",
+    "docs/operations/MENU_VISUAL_EVIDENCE_2026-06-28.md",
+    "docs/operations/assets",
+    "docs/operations/cross-platform-auth-transfer",
+    "docs/operations/token-economy-transfer",
+    "docs/operations/reborn-menu-cyberpunk-transfer",
+    "docs/prompt-tasks",
+    "manifests",
+    "network",
+    "README.md",
+    "CHANGELOG.md",
+    "VERSION.md",
+    "examples/client-configs",
+    "scripts/render-menu-evidence.mjs",
+    "scripts/verify-menu-actions.mjs",
+    "scripts/configure-private-registry.mjs",
+    "scripts/lib",
+    "sources.json"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FPrad0/skill-master-mcp.git"
+  },
+  "engines": {
+    "node": "^18.0.0 || ^20.0.0 || >=22.0.0"
+  },
+  "license": "UNLICENSED",
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "npm run clean && tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "install:project-skills": "node bin/skill-master-install-project-skills.mjs --project-root . --sync-package-json",
+    "setup:private-registry": "node scripts/configure-private-registry.mjs",
+    "eval:activation": "npm run build && node bin/skill-master-eval-activation.mjs",
+    "verify:menu": "node scripts/verify-menu-actions.mjs",
+    "check:manifest": "node scripts/check-manifest.mjs",
+    "check": "npm run build && npm test && npm run verify:menu && npm run check:manifest",
+    "prepack": "npm run build",
+    "pack:dry-run": "npm pack --dry-run",
+    "publish:github": "npm publish --registry=https://npm.pkg.github.com",
+    "publish:npm-public": "npm publish --access public --registry=https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "prompts": "^2.4.2",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.0",
+    "typescript": "^5.9.3",
+    "vite": "6.4.3",
+    "vitest": "3.2.6"
+  }
+}

package/scripts/configure-private-registry.mjs

@@ -1,208 +1,208 @@
-import { spawnSync } from 'node:child_process';
-import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import {
-  DEFAULT_PACKAGE_NAME,
-  DEFAULT_REGISTRY_URL,
-  DEFAULT_SCOPE,
-  DEFAULT_TOKEN_ENV,
-  redactSensitiveNpmrc,
-  upsertNpmrc,
-} from './lib/private-registry.mjs';
-
-function printHelp() {
-  process.stdout.write(`Skill Master private registry configurator
-
-Usage:
-  skill-master-configure-private-registry [options]
-
-Options:
-  --npmrc <path>              Target .npmrc path. Defaults to the user .npmrc.
-  --scope <scope>             npm scope. Defaults to @fprad0.
-  --registry <url>            Registry URL. Defaults to https://npm.pkg.github.com.
-  --token <token>             Token for validation. Avoid in shared shell history.
-  --token-file <path>         Read token from a local file.
-  --token-stdin               Read token from stdin.
-  --token-env <name>          Environment variable name. Defaults to GITHUB_PACKAGES_TOKEN.
-  --store-token               Persist the token literal in .npmrc. Default stores \${TOKEN_ENV}.
-  --allow-insecure-registry   Allow http only for localhost/private test registries.
-  --no-backup                 Do not create a timestamped backup.
-  --dry-run                   Print a redacted preview without writing.
-  --validate                  Run npm view after writing.
-  --package <name>            Package used for validation.
-  --help                      Show this help.
-`);
-}
-
-function parseArgs(argv) {
-  const parsed = {
-    npmrc: resolve(process.env.USERPROFILE ?? process.env.HOME ?? '.', '.npmrc'),
-    scope: DEFAULT_SCOPE,
-    registry: DEFAULT_REGISTRY_URL,
-    tokenEnv: DEFAULT_TOKEN_ENV,
-    backup: true,
-    dryRun: false,
-    validate: false,
-    packageName: DEFAULT_PACKAGE_NAME,
-    storeToken: false,
-    allowInsecureRegistry: false,
-    help: false,
-  };
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    switch (arg) {
-      case '--npmrc':
-        parsed.npmrc = resolve(argv[++i]);
-        break;
-      case '--scope':
-        parsed.scope = argv[++i];
-        break;
-      case '--registry':
-        parsed.registry = argv[++i];
-        break;
-      case '--token':
-        parsed.token = argv[++i];
-        break;
-      case '--token-file':
-        parsed.tokenFile = resolve(argv[++i]);
-        break;
-      case '--token-stdin':
-        parsed.tokenStdin = true;
-        break;
-      case '--token-env':
-        parsed.tokenEnv = argv[++i];
-        break;
-      case '--store-token':
-        parsed.storeToken = true;
-        break;
-      case '--allow-insecure-registry':
-        parsed.allowInsecureRegistry = true;
-        break;
-      case '--no-backup':
-        parsed.backup = false;
-        break;
-      case '--dry-run':
-        parsed.dryRun = true;
-        break;
-      case '--validate':
-        parsed.validate = true;
-        break;
-      case '--package':
-        parsed.packageName = argv[++i];
-        break;
-      case '--help':
-      case '-h':
-        parsed.help = true;
-        break;
-      default:
-        throw new Error(`Unknown argument: ${arg}`);
-    }
-  }
-
-  return parsed;
-}
-
-function readToken(options) {
-  if (options.token) {
-    return options.token;
-  }
-
-  if (options.tokenFile) {
-    return readFileSync(options.tokenFile, 'utf8').trim();
-  }
-
-  if (options.tokenStdin) {
-    return readFileSync(0, 'utf8').trim();
-  }
-
-  return process.env[options.tokenEnv];
-}
-
-function buildBackupPath(npmrcPath) {
-  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-  return `${npmrcPath}.bak.${timestamp}`;
-}
-
-function main() {
-  const options = parseArgs(process.argv.slice(2));
-
-  if (options.help) {
-    printHelp();
-    return;
-  }
-
-  const token = readToken(options);
-  const needsToken = options.storeToken || options.validate;
-  if (needsToken && !token) {
-    throw new Error(`Token not provided. Use --token-file, --token-stdin, --token, or define ${options.tokenEnv}.`);
-  }
-
-  const currentContent = existsSync(options.npmrc)
-    ? readFileSync(options.npmrc, 'utf8')
-    : '';
-
-  const nextContent = upsertNpmrc(currentContent, {
-    scope: options.scope,
-    registryUrl: options.registry,
-    tokenValue: token,
-    tokenEnv: options.tokenEnv,
-    storeToken: options.storeToken,
-    allowInsecureRegistry: options.allowInsecureRegistry,
-  });
-
-  const changed = nextContent !== currentContent.replace(/\r\n/g, '\n');
-
-  if (options.dryRun) {
-    process.stdout.write(redactSensitiveNpmrc(nextContent));
-  } else {
-    mkdirSync(dirname(options.npmrc), { recursive: true });
-    if (changed && options.backup && existsSync(options.npmrc)) {
-      copyFileSync(options.npmrc, buildBackupPath(options.npmrc));
-    }
-    writeFileSync(options.npmrc, nextContent, 'utf8');
-    if (process.platform !== 'win32') {
-      chmodSync(options.npmrc, 0o600);
-    }
-  }
-
-  if (options.validate) {
-    if (options.dryRun) {
-      throw new Error('Cannot use --validate together with --dry-run.');
-    }
-
-    const result = spawnSync(
-      'npm',
-      ['view', options.packageName, `--registry=${options.registry}`],
-      {
-        env: { ...process.env, [options.tokenEnv]: token },
-        stdio: 'inherit',
-        shell: process.platform === 'win32',
-      },
-    );
-
-    if (result.status !== 0) {
-      throw new Error(`Validation failed for ${options.packageName}.`);
-    }
-  }
-
-  process.stdout.write(
-    [
-      `[skill_master] ${options.dryRun ? 'Preview ready for' : 'Configured'} ${options.npmrc}`,
-      `[skill_master] Scope: ${options.scope}`,
-      `[skill_master] Registry: ${options.registry}`,
-      `[skill_master] Token storage: ${options.storeToken ? 'literal token in .npmrc' : `environment reference \${${options.tokenEnv}}`}`,
-      `[skill_master] Changed: ${changed ? 'yes' : 'no'}`,
-      `[skill_master] Validate with: npm view ${options.packageName} --registry=${options.registry}`,
-      `[skill_master] Run with: npx -y ${options.packageName}@latest`,
-    ].join('\n') + '\n',
-  );
-}
-
-try {
-  main();
-} catch (error) {
-  const message = error instanceof Error ? error.message : String(error);
-  process.stderr.write(`[skill_master] ${message}\n`);
-  process.exitCode = 1;
-}
+import { spawnSync } from 'node:child_process';
+import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import {
+  DEFAULT_PACKAGE_NAME,
+  DEFAULT_REGISTRY_URL,
+  DEFAULT_SCOPE,
+  DEFAULT_TOKEN_ENV,
+  redactSensitiveNpmrc,
+  upsertNpmrc,
+} from './lib/private-registry.mjs';
+
+function printHelp() {
+  process.stdout.write(`Skill Master private registry configurator
+
+Usage:
+  skill-master-configure-private-registry [options]
+
+Options:
+  --npmrc <path>              Target .npmrc path. Defaults to the user .npmrc.
+  --scope <scope>             npm scope. Defaults to @fprad0.
+  --registry <url>            Registry URL. Defaults to https://npm.pkg.github.com.
+  --token <token>             Token for validation. Avoid in shared shell history.
+  --token-file <path>         Read token from a local file.
+  --token-stdin               Read token from stdin.
+  --token-env <name>          Environment variable name. Defaults to GITHUB_PACKAGES_TOKEN.
+  --store-token               Persist the token literal in .npmrc. Default stores \${TOKEN_ENV}.
+  --allow-insecure-registry   Allow http only for localhost/private test registries.
+  --no-backup                 Do not create a timestamped backup.
+  --dry-run                   Print a redacted preview without writing.
+  --validate                  Run npm view after writing.
+  --package <name>            Package used for validation.
+  --help                      Show this help.
+`);
+}
+
+function parseArgs(argv) {
+  const parsed = {
+    npmrc: resolve(process.env.USERPROFILE ?? process.env.HOME ?? '.', '.npmrc'),
+    scope: DEFAULT_SCOPE,
+    registry: DEFAULT_REGISTRY_URL,
+    tokenEnv: DEFAULT_TOKEN_ENV,
+    backup: true,
+    dryRun: false,
+    validate: false,
+    packageName: DEFAULT_PACKAGE_NAME,
+    storeToken: false,
+    allowInsecureRegistry: false,
+    help: false,
+  };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    switch (arg) {
+      case '--npmrc':
+        parsed.npmrc = resolve(argv[++i]);
+        break;
+      case '--scope':
+        parsed.scope = argv[++i];
+        break;
+      case '--registry':
+        parsed.registry = argv[++i];
+        break;
+      case '--token':
+        parsed.token = argv[++i];
+        break;
+      case '--token-file':
+        parsed.tokenFile = resolve(argv[++i]);
+        break;
+      case '--token-stdin':
+        parsed.tokenStdin = true;
+        break;
+      case '--token-env':
+        parsed.tokenEnv = argv[++i];
+        break;
+      case '--store-token':
+        parsed.storeToken = true;
+        break;
+      case '--allow-insecure-registry':
+        parsed.allowInsecureRegistry = true;
+        break;
+      case '--no-backup':
+        parsed.backup = false;
+        break;
+      case '--dry-run':
+        parsed.dryRun = true;
+        break;
+      case '--validate':
+        parsed.validate = true;
+        break;
+      case '--package':
+        parsed.packageName = argv[++i];
+        break;
+      case '--help':
+      case '-h':
+        parsed.help = true;
+        break;
+      default:
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+  }
+
+  return parsed;
+}
+
+function readToken(options) {
+  if (options.token) {
+    return options.token;
+  }
+
+  if (options.tokenFile) {
+    return readFileSync(options.tokenFile, 'utf8').trim();
+  }
+
+  if (options.tokenStdin) {
+    return readFileSync(0, 'utf8').trim();
+  }
+
+  return process.env[options.tokenEnv];
+}
+
+function buildBackupPath(npmrcPath) {
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+  return `${npmrcPath}.bak.${timestamp}`;
+}
+
+function main() {
+  const options = parseArgs(process.argv.slice(2));
+
+  if (options.help) {
+    printHelp();
+    return;
+  }
+
+  const token = readToken(options);
+  const needsToken = options.storeToken || options.validate;
+  if (needsToken && !token) {
+    throw new Error(`Token not provided. Use --token-file, --token-stdin, --token, or define ${options.tokenEnv}.`);
+  }
+
+  const currentContent = existsSync(options.npmrc)
+    ? readFileSync(options.npmrc, 'utf8')
+    : '';
+
+  const nextContent = upsertNpmrc(currentContent, {
+    scope: options.scope,
+    registryUrl: options.registry,
+    tokenValue: token,
+    tokenEnv: options.tokenEnv,
+    storeToken: options.storeToken,
+    allowInsecureRegistry: options.allowInsecureRegistry,
+  });
+
+  const changed = nextContent !== currentContent.replace(/\r\n/g, '\n');
+
+  if (options.dryRun) {
+    process.stdout.write(redactSensitiveNpmrc(nextContent));
+  } else {
+    mkdirSync(dirname(options.npmrc), { recursive: true });
+    if (changed && options.backup && existsSync(options.npmrc)) {
+      copyFileSync(options.npmrc, buildBackupPath(options.npmrc));
+    }
+    writeFileSync(options.npmrc, nextContent, 'utf8');
+    if (process.platform !== 'win32') {
+      chmodSync(options.npmrc, 0o600);
+    }
+  }
+
+  if (options.validate) {
+    if (options.dryRun) {
+      throw new Error('Cannot use --validate together with --dry-run.');
+    }
+
+    const result = spawnSync(
+      'npm',
+      ['view', options.packageName, `--registry=${options.registry}`],
+      {
+        env: { ...process.env, [options.tokenEnv]: token },
+        stdio: 'inherit',
+        shell: process.platform === 'win32',
+      },
+    );
+
+    if (result.status !== 0) {
+      throw new Error(`Validation failed for ${options.packageName}.`);
+    }
+  }
+
+  process.stdout.write(
+    [
+      `[skill_master] ${options.dryRun ? 'Preview ready for' : 'Configured'} ${options.npmrc}`,
+      `[skill_master] Scope: ${options.scope}`,
+      `[skill_master] Registry: ${options.registry}`,
+      `[skill_master] Token storage: ${options.storeToken ? 'literal token in .npmrc' : `environment reference \${${options.tokenEnv}}`}`,
+      `[skill_master] Changed: ${changed ? 'yes' : 'no'}`,
+      `[skill_master] Validate with: npm view ${options.packageName} --registry=${options.registry}`,
+      `[skill_master] Run with: npx -y ${options.packageName}@latest`,
+    ].join('\n') + '\n',
+  );
+}
+
+try {
+  main();
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`[skill_master] ${message}\n`);
+  process.exitCode = 1;
+}