@kolatts/pncli 1.4.0 → 1.6.1

package/README.md

@@ -1,6 +1,7 @@
 # pncli — The Paperwork Nightmare CLI
 
 [![npm](https://img.shields.io/npm/v/%40kolatts%2Fpncli?style=flat-square&color=cb3837&logo=npm)](https://www.npmjs.com/package/@kolatts/pncli)
+[![docs](https://img.shields.io/badge/docs-getting%20started-FF5C39?style=flat-square)](https://kolatts.github.io/pncli/getting-started/)
 
 > One command does what three meetings couldn't.
 
@@ -26,7 +27,7 @@ pncli config init
 pncli config init --repo
 ```
 
-For workflow patterns, command examples, and agent integration, see [`copilot-instructions.md`](./copilot-instructions.md).
+For workflow patterns, command examples, and agent integration, see the [Getting Started page](https://kolatts.github.io/pncli/getting-started/) or the raw [`copilot-instructions.md`](./copilot-instructions.md).
 
 ## Configuration
 

package/copilot-instructions.md

@@ -13,8 +13,37 @@ pncli is a CLI tool that provides structured JSON access to Jira, Bitbucket, Con
 - Run all commands from the repository root.
 - Project and repo are auto-detected from git remotes. You rarely need `--project` or `--repo` flags.
 
+## Provider Detection
+
+Before running provider-specific commands, ask the user which tools this repository uses:
+
+1. **Work item tracking:** "Does this repo use **Jira** or **Azure DevOps** for work items and tickets?" — this determines whether to use `pncli jira ...` or `pncli ado work ...` commands.
+2. **Source control:** "Does this repo use **Bitbucket** or **Azure DevOps** for pull requests and code review?" — this determines whether to use `pncli bitbucket ...` or `pncli ado repo ...` commands.
+
+Cache the answers for the session. If the user doesn't know, run `git remote -v` — if a URL contains `/_git/` it's Azure DevOps; if it contains `/scm/` it's Bitbucket.
+
+## Installing Skills
+
+pncli ships with Claude Code skills — step-by-step workflow guides that agents can follow. To install them into your repo:
+
+```
+pncli skills install
+```
+
+This downloads the latest pncli skills from GitHub into `.claude/skills/` and also fetches `copilot-instructions.md` into the repo root. Only pncli-managed skills are replaced — any custom skills you've created in `.claude/skills/` are left untouched.
+
+Use `--skip-instructions` to skip downloading `copilot-instructions.md`.
+
+To see what's installed locally:
+
+```
+pncli skills list
+```
+
 ## Common Workflows
 
+> These workflows are also available as Claude Code skills — run `pncli skills install` to download them into your repo, or copy `.claude/skills/` into `~/.claude/skills/` for global access.
+
 ### Review a Pull Request
 
 1. Find the PR for the current branch:
@@ -496,8 +525,11 @@ pncli config init
 pncli config show
 
 pncli config set
+  --repo      Write to repo config (.pncli.json) instead of global config
 
 pncli config test
+
+pncli config check
 ```
 
 ### Ado
@@ -516,6 +548,18 @@ pncli ado repo
 pncli ado pipeline
 ```
 
+### Skills
+
+```
+pncli skills install
+  --target <dir>       Target directory for skills (default: ".claude/skills")
+  --skip-instructions  Skip downloading copilot-instructions.md (always written
+  to repo root)
+
+pncli skills list
+  --target <dir>  Skills directory to scan (default: ".claude/skills")
+```
+
 <!-- COMMAND-REFERENCE:END -->
 
 ## Output Format

package/dist/{chunk-JORIICS2.js → chunk-VEHCNGUP.js}

@@ -95,7 +95,8 @@ function loadConfig(opts = {}) {
     },
     confluence: {
       baseUrl: process.env[ENV_KEYS.CONFLUENCE_BASE_URL] ?? globalConfig.confluence?.baseUrl,
-      apiToken: process.env[ENV_KEYS.CONFLUENCE_API_TOKEN] ?? globalConfig.confluence?.apiToken ?? process.env[ENV_KEYS.JIRA_API_TOKEN] ?? globalConfig.jira?.apiToken
+      apiToken: process.env[ENV_KEYS.CONFLUENCE_API_TOKEN] ?? globalConfig.confluence?.apiToken ?? process.env[ENV_KEYS.JIRA_API_TOKEN] ?? globalConfig.jira?.apiToken,
+      apiTokenExplicit: !!(process.env[ENV_KEYS.CONFLUENCE_API_TOKEN] ?? globalConfig.confluence?.apiToken)
     },
     artifactory: {
       baseUrl: process.env[ENV_KEYS.ARTIFACTORY_BASE_URL] ?? globalConfig.artifactory?.baseUrl,
@@ -151,6 +152,23 @@ function setConfigValue(key, value, configPath) {
   current[parts[parts.length - 1]] = value;
   writeGlobalConfig(existing, configPath);
 }
+function setRepoConfigValue(key, value) {
+  const repoRoot = getRepoRoot();
+  const targetDir = repoRoot ?? process.cwd();
+  const filePath = path.join(targetDir, ".pncli.json");
+  const existing = loadJsonFile(filePath) ?? {};
+  const parts = key.split(".");
+  let current = existing;
+  for (let i = 0; i < parts.length - 1; i++) {
+    const part = parts[i];
+    if (typeof current[part] !== "object" || current[part] === null) {
+      current[part] = {};
+    }
+    current = current[part];
+  }
+  current[parts[parts.length - 1]] = value;
+  writeRepoConfig(existing);
+}
 function maskConfig(config) {
   return {
     ...config,
@@ -192,6 +210,7 @@ export {
   writeGlobalConfig,
   writeRepoConfig,
   setConfigValue,
+  setRepoConfigValue,
   maskConfig
 };
-//# sourceMappingURL=chunk-JORIICS2.js.map
+//# sourceMappingURL=chunk-VEHCNGUP.js.map

package/dist/chunk-VEHCNGUP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/config.ts"],"sourcesContent":["import fs from 'fs';\nimport os from 'os';\nimport path from 'path';\nimport { execSync } from 'child_process';\nimport type { GlobalConfig, RepoConfig, ResolvedConfig, JiraDefaults, BitbucketDefaults, SonarDefaults, SdeDefaults, AdoDefaults } from '../types/config.js';\nimport type { CustomFieldDefinition } from '../types/jira.js';\n\nconst ENV_KEYS = {\n  EMAIL: 'PNCLI_EMAIL',\n  USERID: 'PNCLI_USERID',\n  JIRA_BASE_URL: 'PNCLI_JIRA_BASE_URL',\n  JIRA_API_TOKEN: 'PNCLI_JIRA_API_TOKEN',\n  BITBUCKET_BASE_URL: 'PNCLI_BITBUCKET_BASE_URL',\n  BITBUCKET_PAT: 'PNCLI_BITBUCKET_PAT',\n  CONFLUENCE_BASE_URL: 'PNCLI_CONFLUENCE_BASE_URL',\n  CONFLUENCE_API_TOKEN: 'PNCLI_CONFLUENCE_API_TOKEN',\n  ARTIFACTORY_BASE_URL: 'PNCLI_ARTIFACTORY_BASE_URL',\n  ARTIFACTORY_TOKEN: 'PNCLI_ARTIFACTORY_TOKEN',\n  ARTIFACTORY_REPO_NPM: 'PNCLI_ARTIFACTORY_REPO_NPM',\n  ARTIFACTORY_REPO_NUGET: 'PNCLI_ARTIFACTORY_REPO_NUGET',\n  ARTIFACTORY_REPO_MAVEN: 'PNCLI_ARTIFACTORY_REPO_MAVEN',\n  SONAR_BASE_URL: 'PNCLI_SONAR_BASE_URL',\n  SONAR_TOKEN: 'PNCLI_SONAR_TOKEN',\n  SDE_CONNECTION: 'PNCLI_SDE_CONNECTION',\n  ADO_BASE_URL: 'PNCLI_ADO_BASE_URL',\n  ADO_PAT: 'PNCLI_ADO_PAT',\n  CONFIG_PATH: 'PNCLI_CONFIG_PATH'\n} as const;\n\nfunction getGlobalConfigPath(overridePath?: string): string {\n  if (overridePath) return overridePath;\n  const envPath = process.env[ENV_KEYS.CONFIG_PATH];\n  if (envPath) return envPath;\n  return path.join(os.homedir(), '.pncli', 'config.json');\n}\n\nfunction loadJsonFile<T>(filePath: string): T | null {\n  try {\n    const content = fs.readFileSync(filePath, 'utf8');\n    return JSON.parse(content) as T;\n  } catch {\n    return null;\n  }\n}\n\nfunction getRepoRoot(): string | null {\n  try {\n    return execSync('git rev-parse --show-toplevel', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();\n  } catch {\n    return null;\n  }\n}\n\nfunction parseSdeConnection(connection: string): { token: string; baseUrl: string } | null {\n  const idx = connection.indexOf('@');\n  if (idx <= 0) return null;\n  const token = connection.slice(0, idx);\n  const host = connection.slice(idx + 1);\n  const baseUrl = /^https?:\\/\\//i.test(host) ? host : `https://${host}`;\n  return { token, baseUrl };\n}\n\nfunction mergeCustomFields(\n  global: CustomFieldDefinition[] | undefined,\n  repo: CustomFieldDefinition[] | undefined\n): CustomFieldDefinition[] {\n  const map = new Map<string, CustomFieldDefinition>();\n  for (const f of global ?? []) map.set(f.id, f);\n  for (const f of repo ?? []) map.set(f.id, f); // repo wins\n  return Array.from(map.values());\n}\n\nfunction mergeDefaults(\n  global: GlobalConfig['defaults'],\n  repo: RepoConfig['defaults']\n): { jira: JiraDefaults; bitbucket: BitbucketDefaults; sonar: SonarDefaults; sde: SdeDefaults; ado: AdoDefaults } {\n  return {\n    jira: { ...global?.jira, ...repo?.jira },\n    bitbucket: { ...global?.bitbucket, ...repo?.bitbucket },\n    sonar: { ...global?.sonar, ...repo?.sonar },\n    sde: { ...global?.sde, ...repo?.sde },\n    ado: { ...global?.ado, ...repo?.ado }\n  };\n}\n\nexport interface LoadConfigOptions {\n  configPath?: string;\n}\n\nexport function loadConfig(opts: LoadConfigOptions = {}): ResolvedConfig {\n  const globalConfigPath = getGlobalConfigPath(opts.configPath);\n  const globalConfig = loadJsonFile<GlobalConfig>(globalConfigPath) ?? {};\n\n  const repoRoot = getRepoRoot();\n  let repoConfig: RepoConfig = {};\n  if (repoRoot) {\n    repoConfig = loadJsonFile<RepoConfig>(path.join(repoRoot, '.pncli.json')) ?? {};\n  }\n\n  const mergedDefaults = mergeDefaults(globalConfig.defaults, repoConfig.defaults);\n\n  return {\n    user: {\n      email: process.env[ENV_KEYS.EMAIL] ?? globalConfig.user?.email,\n      userId: process.env[ENV_KEYS.USERID] ?? globalConfig.user?.userId\n    },\n    jira: {\n      baseUrl: process.env[ENV_KEYS.JIRA_BASE_URL] ?? globalConfig.jira?.baseUrl,\n      apiToken: process.env[ENV_KEYS.JIRA_API_TOKEN] ?? globalConfig.jira?.apiToken,\n      customFields: mergeCustomFields(globalConfig.jira?.customFields, repoConfig.jira?.customFields)\n    },\n    bitbucket: {\n      baseUrl: process.env[ENV_KEYS.BITBUCKET_BASE_URL] ?? globalConfig.bitbucket?.baseUrl,\n      pat: process.env[ENV_KEYS.BITBUCKET_PAT] ?? globalConfig.bitbucket?.pat\n    },\n    confluence: {\n      baseUrl: process.env[ENV_KEYS.CONFLUENCE_BASE_URL] ?? globalConfig.confluence?.baseUrl,\n      apiToken: process.env[ENV_KEYS.CONFLUENCE_API_TOKEN] ?? globalConfig.confluence?.apiToken\n        ?? process.env[ENV_KEYS.JIRA_API_TOKEN] ?? globalConfig.jira?.apiToken,\n      apiTokenExplicit: !!(\n        process.env[ENV_KEYS.CONFLUENCE_API_TOKEN] ?? globalConfig.confluence?.apiToken\n      )\n    },\n    artifactory: {\n      baseUrl: process.env[ENV_KEYS.ARTIFACTORY_BASE_URL] ?? globalConfig.artifactory?.baseUrl,\n      token: process.env[ENV_KEYS.ARTIFACTORY_TOKEN] ?? globalConfig.artifactory?.token,\n      npmRepo: process.env[ENV_KEYS.ARTIFACTORY_REPO_NPM] ?? globalConfig.artifactory?.npmRepo,\n      nugetRepo: process.env[ENV_KEYS.ARTIFACTORY_REPO_NUGET] ?? globalConfig.artifactory?.nugetRepo,\n      mavenRepo: process.env[ENV_KEYS.ARTIFACTORY_REPO_MAVEN] ?? globalConfig.artifactory?.mavenRepo\n    },\n    sonar: {\n      baseUrl: process.env[ENV_KEYS.SONAR_BASE_URL] ?? globalConfig.sonar?.baseUrl,\n      token: process.env[ENV_KEYS.SONAR_TOKEN] ?? globalConfig.sonar?.token\n    },\n    sde: (() => {\n      const raw = process.env[ENV_KEYS.SDE_CONNECTION] ?? globalConfig.sde?.connection;\n      const parsed = raw ? parseSdeConnection(raw) : null;\n      return { baseUrl: parsed?.baseUrl, token: parsed?.token };\n    })(),\n    ado: {\n      baseUrl: process.env[ENV_KEYS.ADO_BASE_URL] ?? globalConfig.ado?.baseUrl,\n      pat: process.env[ENV_KEYS.ADO_PAT] ?? globalConfig.ado?.pat,\n      fieldAliases: globalConfig.ado?.fieldAliases ?? {},\n      discoveredFields: globalConfig.ado?.discoveredFields ?? [],\n      discoveredTypes: globalConfig.ado?.discoveredTypes ?? []\n    },\n    defaults: mergedDefaults\n  };\n}\n\nexport function writeGlobalConfig(config: GlobalConfig, configPath?: string): void {\n  const filePath = getGlobalConfigPath(configPath);\n  const dir = path.dirname(filePath);\n  if (!fs.existsSync(dir)) {\n    fs.mkdirSync(dir, { recursive: true });\n  }\n  fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + '\\n', 'utf8');\n}\n\nexport function writeRepoConfig(config: RepoConfig): void {\n  const repoRoot = getRepoRoot();\n  const targetDir = repoRoot ?? process.cwd();\n  fs.writeFileSync(path.join(targetDir, '.pncli.json'), JSON.stringify(config, null, 2) + '\\n', 'utf8');\n}\n\nexport function setConfigValue(key: string, value: string, configPath?: string): void {\n  const filePath = getGlobalConfigPath(configPath);\n  const existing = loadJsonFile<GlobalConfig>(filePath) ?? {};\n\n  const parts = key.split('.');\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let current: any = existing;\n  for (let i = 0; i < parts.length - 1; i++) {\n    const part = parts[i]!;\n    if (typeof current[part] !== 'object' || current[part] === null) {\n      current[part] = {};\n    }\n    current = current[part];\n  }\n  current[parts[parts.length - 1]!] = value;\n\n  writeGlobalConfig(existing, configPath);\n}\n\nexport function setRepoConfigValue(key: string, value: string): void {\n  const repoRoot = getRepoRoot();\n  const targetDir = repoRoot ?? process.cwd();\n  const filePath = path.join(targetDir, '.pncli.json');\n  const existing = loadJsonFile<RepoConfig>(filePath) ?? {};\n\n  const parts = key.split('.');\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let current: any = existing;\n  for (let i = 0; i < parts.length - 1; i++) {\n    const part = parts[i]!;\n    if (typeof current[part] !== 'object' || current[part] === null) {\n      current[part] = {};\n    }\n    current = current[part];\n  }\n  current[parts[parts.length - 1]!] = value;\n\n  writeRepoConfig(existing);\n}\n\nexport function maskConfig(config: ResolvedConfig): unknown {\n  return {\n    ...config,\n    jira: {\n      ...config.jira,\n      apiToken: config.jira.apiToken ? '***' : undefined,\n      customFields: config.jira.customFields\n    },\n    bitbucket: {\n      ...config.bitbucket,\n      pat: config.bitbucket.pat ? '***' : undefined\n    },\n    confluence: {\n      ...config.confluence,\n      apiToken: config.confluence.apiToken ? '***' : undefined\n    },\n    artifactory: {\n      ...config.artifactory,\n      token: config.artifactory.token ? '***' : undefined\n    },\n    sonar: {\n      ...config.sonar,\n      token: config.sonar.token ? '***' : undefined\n    },\n    sde: {\n      baseUrl: config.sde.baseUrl,\n      token: config.sde.token ? '***' : undefined\n    },\n    ado: {\n      ...config.ado,\n      pat: config.ado.pat ? '***' : undefined\n    }\n  };\n}\n\nexport { getGlobalConfigPath };\n"],"mappings":"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","names":[]}

package/dist/cli.js

@@ -4,9 +4,10 @@ import {
   loadConfig,
   maskConfig,
   setConfigValue,
+  setRepoConfigValue,
   writeGlobalConfig,
   writeRepoConfig
-} from "./chunk-JORIICS2.js";
+} from "./chunk-VEHCNGUP.js";
 import {
   ExitCode,
   PncliError,
@@ -208,34 +209,34 @@ function parseAdoRemote(remoteUrl, adoBaseUrl) {
   } catch {
     baseHostname = adoBaseUrl.replace(/\/$/, "").replace(/^https?:\/\//, "").split(/[:/]/)[0].toLowerCase();
   }
-  let path5 = remoteUrl;
+  let path6 = remoteUrl;
   let remoteHostname = "";
-  const sshProtoMatch = path5.match(/^ssh:\/\/[^@]*@?([^/:]+)(?::\d+)?(.*)/);
+  const sshProtoMatch = path6.match(/^ssh:\/\/[^@]*@?([^/:]+)(?::\d+)?(.*)/);
   if (sshProtoMatch) {
     remoteHostname = sshProtoMatch[1].toLowerCase();
-    path5 = sshProtoMatch[2];
+    path6 = sshProtoMatch[2];
   } else {
-    const gitAtMatch = path5.match(/^git@([^:]+)(?::\d+)?:(.*)/);
+    const gitAtMatch = path6.match(/^git@([^:]+)(?::\d+)?:(.*)/);
     if (gitAtMatch) {
       remoteHostname = gitAtMatch[1].toLowerCase();
-      path5 = "/" + gitAtMatch[2];
+      path6 = "/" + gitAtMatch[2];
     } else {
-      const httpsMatch = path5.match(/^https?:\/\/([^/:]+)(?::\d+)?(.*)/);
+      const httpsMatch = path6.match(/^https?:\/\/([^/:]+)(?::\d+)?(.*)/);
       if (httpsMatch) {
         remoteHostname = httpsMatch[1].toLowerCase();
-        path5 = httpsMatch[2];
+        path6 = httpsMatch[2];
       }
     }
   }
   if (!remoteHostname || remoteHostname !== baseHostname) return null;
-  path5 = path5.replace(/\.git$/, "");
-  const gitIdx = path5.indexOf("/_git/");
-  const sshIdx = path5.indexOf("/_ssh/");
+  path6 = path6.replace(/\.git$/, "");
+  const gitIdx = path6.indexOf("/_git/");
+  const sshIdx = path6.indexOf("/_ssh/");
   const markerIdx = gitIdx !== -1 ? gitIdx : sshIdx;
   if (markerIdx === -1) return null;
-  const repo = path5.slice(markerIdx + 6);
+  const repo = path6.slice(markerIdx + 6);
   if (!repo) return null;
-  const before = path5.slice(1, markerIdx);
+  const before = path6.slice(1, markerIdx);
   const parts = before.split("/").filter(Boolean);
   if (parts.length < 2) return null;
   const project = parts[parts.length - 1];
@@ -3497,6 +3498,7 @@ function buildDefaultAliases(fields) {
 }
 
 // src/services/config/commands.ts
+import chalk from "chalk";
 import fs2 from "fs";
 function registerConfigCommands(program2) {
   const config = program2.command("config").description("Manage pncli configuration");
@@ -3526,12 +3528,17 @@ function registerConfigCommands(program2) {
       fail(err, "config", "show", start);
     }
   });
-  config.command("set").description("Set a config value by dot-notation key (e.g. jira.baseUrl https://...)").argument("<key>", "Config key in dot notation").argument("<value>", "Value to set").action((key, value) => {
+  config.command("set").description("Set a config value by dot-notation key (e.g. jira.baseUrl https://...)").argument("<key>", "Config key in dot notation").argument("<value>", "Value to set").option("--repo", "Write to repo config (.pncli.json) instead of global config").action((key, value, cmdOpts) => {
     const start = Date.now();
     try {
-      const opts = program2.optsWithGlobals();
-      setConfigValue(key, value, opts.config);
-      success({ key, value }, "config", "set", start);
+      if (cmdOpts.repo) {
+        setRepoConfigValue(key, value);
+        success({ key, value, target: ".pncli.json" }, "config", "set", start);
+      } else {
+        const opts = program2.optsWithGlobals();
+        setConfigValue(key, value, opts.config);
+        success({ key, value }, "config", "set", start);
+      }
     } catch (err) {
       fail(err, "config", "set", start);
     }
@@ -3596,8 +3603,8 @@ function registerConfigCommands(program2) {
       if (cfg.ado.baseUrl) {
         try {
           const collection = cfg.defaults.ado?.collection;
-          const path5 = collection ? `/${encodeURIComponent(collection)}/_apis/connectionData?api-version=7.1` : "/_apis/projectCollections?api-version=7.1";
-          await http.ado(path5);
+          const path6 = collection ? `/${encodeURIComponent(collection)}/_apis/connectionData?api-version=7.1` : "/_apis/projectCollections?api-version=7.1";
+          await http.ado(path6);
           results.ado = { ok: true, message: "connected" };
         } catch (err) {
           results.ado = { ok: false, message: err instanceof Error ? err.message : String(err) };
@@ -3610,6 +3617,148 @@ function registerConfigCommands(program2) {
       fail(err, "config", "test", start);
     }
   });
+  config.command("check").description("Check PAT status for every service: Blank, Valid, or Invalid").option("--output <format>", "Output format: json or table", "json").action(async (cmdOpts) => {
+    const start = Date.now();
+    try {
+      let categorize2 = function(err) {
+        const status = err.status ?? -1;
+        if (status === 401 || status === 403) {
+          return { status: "invalid", message: `auth rejected (${status})` };
+        }
+        if (status === 0) {
+          return { status: "error", message: err instanceof Error ? err.message : String(err) };
+        }
+        return { status: "error", message: err instanceof Error ? err.message : String(err) };
+      };
+      var categorize = categorize2;
+      const opts = program2.optsWithGlobals();
+      const cfg = loadConfig({ configPath: opts.config });
+      const http = createHttpClient(cfg, false);
+      const results = {};
+      if (!cfg.jira.apiToken) {
+        results.jira = { status: "blank", message: "not configured" };
+      } else if (!cfg.jira.baseUrl) {
+        results.jira = { status: "error", message: "baseUrl not configured" };
+      } else {
+        try {
+          await http.jira("/rest/api/2/myself", { timeoutMs: 1e4 });
+          results.jira = { status: "valid", message: "ok" };
+        } catch (err) {
+          results.jira = categorize2(err);
+        }
+      }
+      if (!cfg.bitbucket.pat) {
+        results.bitbucket = { status: "blank", message: "not configured" };
+      } else if (!cfg.bitbucket.baseUrl) {
+        results.bitbucket = { status: "error", message: "baseUrl not configured" };
+      } else {
+        try {
+          await http.bitbucket("/rest/api/1.0/application-properties", { timeoutMs: 1e4 });
+          results.bitbucket = { status: "valid", message: "ok" };
+        } catch (err) {
+          results.bitbucket = categorize2(err);
+        }
+      }
+      if (!cfg.confluence.apiTokenExplicit && !cfg.jira.apiToken) {
+        results.confluence = { status: "blank", message: "not configured" };
+      } else if (!cfg.confluence.apiToken) {
+        results.confluence = { status: "blank", message: "not configured" };
+      } else if (!cfg.confluence.baseUrl) {
+        results.confluence = { status: "error", message: "baseUrl not configured" };
+      } else {
+        try {
+          await http.confluence("/rest/api/space", { params: { limit: 1 }, timeoutMs: 1e4 });
+          const msg = cfg.confluence.apiTokenExplicit ? "ok" : "ok (inherited from Jira token)";
+          results.confluence = { status: "valid", message: msg };
+        } catch (err) {
+          results.confluence = categorize2(err);
+        }
+      }
+      if (!cfg.sonar.token) {
+        results.sonar = { status: "blank", message: "not configured" };
+      } else if (!cfg.sonar.baseUrl) {
+        results.sonar = { status: "error", message: "baseUrl not configured" };
+      } else {
+        try {
+          await http.sonar("/api/system/status", { timeoutMs: 1e4 });
+          results.sonar = { status: "valid", message: "ok" };
+        } catch (err) {
+          results.sonar = categorize2(err);
+        }
+      }
+      if (!cfg.sde.token) {
+        results.sde = { status: "blank", message: "not configured" };
+      } else if (!cfg.sde.baseUrl) {
+        results.sde = { status: "error", message: "baseUrl not configured" };
+      } else {
+        try {
+          await http.sde("/api/v2/users/me/", { timeoutMs: 1e4 });
+          results.sde = { status: "valid", message: "ok" };
+        } catch (err) {
+          results.sde = categorize2(err);
+        }
+      }
+      if (!cfg.ado.pat) {
+        results.ado = { status: "blank", message: "not configured" };
+      } else if (!cfg.ado.baseUrl) {
+        results.ado = { status: "error", message: "baseUrl not configured" };
+      } else {
+        try {
+          const collection = cfg.defaults.ado?.collection;
+          const path6 = collection ? `/${encodeURIComponent(collection)}/_apis/connectionData?api-version=7.1` : "/_apis/projectCollections?api-version=7.1";
+          await http.ado(path6, { timeoutMs: 1e4 });
+          results.ado = { status: "valid", message: "ok" };
+        } catch (err) {
+          results.ado = categorize2(err);
+        }
+      }
+      const artResult = await checkArtifactoryConnectivity(cfg.artifactory);
+      if (!artResult.configured) {
+        results.artifactory = { status: "blank", message: artResult.error ?? "not configured" };
+      } else if (!artResult.authenticated) {
+        results.artifactory = { status: "invalid", message: artResult.error ?? "auth rejected" };
+      } else if (!artResult.reachable) {
+        results.artifactory = { status: "error", message: artResult.error ?? "unreachable" };
+      } else {
+        results.artifactory = { status: "valid", message: "ok" };
+      }
+      const statuses = Object.values(results).map((r) => r.status);
+      if (statuses.includes("invalid")) process.exitCode = ExitCode.AUTH_ERROR;
+      else if (statuses.includes("error")) process.exitCode = ExitCode.NETWORK_ERROR;
+      if (cmdOpts.output === "table") {
+        const services = ["jira", "bitbucket", "confluence", "sonar", "sde", "ado", "artifactory"];
+        const labelWidth = 14;
+        const statusWidth = 9;
+        for (const svc of services) {
+          const r = results[svc];
+          if (!r) continue;
+          const label = svc.padEnd(labelWidth);
+          const coloredStatus = r.status === "valid" ? chalk.green("valid".padEnd(statusWidth)) : r.status === "blank" ? chalk.gray("blank".padEnd(statusWidth)) : r.status === "invalid" ? chalk.red("invalid".padEnd(statusWidth)) : chalk.yellow("error".padEnd(statusWidth));
+          process.stdout.write(`  ${label}${coloredStatus}${r.message}
+`);
+        }
+        process.stdout.write("\n");
+      } else {
+        if (opts.pretty) {
+          const services = ["jira", "bitbucket", "confluence", "sonar", "sde", "ado", "artifactory"];
+          const labelWidth = 14;
+          const statusWidth = 9;
+          for (const svc of services) {
+            const r = results[svc];
+            if (!r) continue;
+            const label = svc.padEnd(labelWidth);
+            const coloredStatus = r.status === "valid" ? chalk.green("valid".padEnd(statusWidth)) : r.status === "blank" ? chalk.gray("blank".padEnd(statusWidth)) : r.status === "invalid" ? chalk.red("invalid".padEnd(statusWidth)) : chalk.yellow("error".padEnd(statusWidth));
+            process.stderr.write(`  ${label}${coloredStatus}${r.message}
+`);
+          }
+          process.stderr.write("\n");
+        }
+        success(results, "config", "check", start);
+      }
+    } catch (err) {
+      fail(err, "config", "check", start);
+    }
+  });
 }
 async function initGlobalConfig(start) {
   process.stderr.write("pncli config init \u2014 Global configuration\n\n");
@@ -4085,6 +4234,21 @@ var AdoGitClient = class {
     );
   }
   // ── Diffs / Files ─────────────────────────────────────────────────
+  async getPRDiff(collection, project, repo, prId) {
+    const pr = await this.getPR(collection, project, repo, prId);
+    const sourceCommit = pr.lastMergeSourceCommit?.commitId;
+    const targetCommit = pr.lastMergeTargetCommit?.commitId;
+    if (!sourceCommit || !targetCommit) return { changes: [], aheadCount: 0, behindCount: 0 };
+    return this.http.ado(
+      `/${encodeURIComponent(collection)}/${encodeURIComponent(project)}/_apis/git/repositories/${encodeURIComponent(repo)}/diffs/commits?baseVersion=${encodeURIComponent(targetCommit)}&baseVersionType=commit&targetVersion=${encodeURIComponent(sourceCommit)}&targetVersionType=commit&api-version=${API7}`
+    );
+  }
+  async getCommitStatuses(collection, project, repo, commitId) {
+    const result = await this.http.ado(
+      `/${encodeURIComponent(collection)}/${encodeURIComponent(project)}/_apis/git/repositories/${encodeURIComponent(repo)}/commits/${encodeURIComponent(commitId)}/statuses?api-version=${API7}`
+    );
+    return result.value ?? [];
+  }
   async listPRChanges(collection, project, repo, prId) {
     const iterations = await this.http.ado(
       `/${encodeURIComponent(collection)}/${encodeURIComponent(project)}/_apis/git/repositories/${encodeURIComponent(repo)}/pullrequests/${prId}/iterations?api-version=${API7}`
@@ -4432,10 +4596,10 @@ function registerAdoWorkCommands(ado) {
       const types = await discoverTypes(workClient, collection, project);
       if (opts.save) {
         const globalConfigPath = getGlobalConfigPath(globalOpts.config);
-        const fs3 = await import("fs");
-        const existing = JSON.parse(fs3.readFileSync(globalConfigPath, "utf8") || "{}");
+        const fs4 = await import("fs");
+        const existing = JSON.parse(fs4.readFileSync(globalConfigPath, "utf8") || "{}");
         existing.ado = { ...existing.ado ?? {}, discoveredTypes: types };
-        fs3.writeFileSync(globalConfigPath, JSON.stringify(existing, null, 2) + "\n", "utf8");
+        fs4.writeFileSync(globalConfigPath, JSON.stringify(existing, null, 2) + "\n", "utf8");
         warn(`Saved ${types.length} types to ${globalConfigPath}`);
       }
       success(types, "ado", "work-types", start);
@@ -4464,11 +4628,11 @@ function registerAdoWorkCommands(ado) {
       ) : allFields;
       if (opts.save) {
         const globalConfigPath = getGlobalConfigPath(globalOpts.config);
-        const fs3 = await import("fs");
-        const existing = JSON.parse(fs3.readFileSync(globalConfigPath, "utf8") || "{}");
+        const fs4 = await import("fs");
+        const existing = JSON.parse(fs4.readFileSync(globalConfigPath, "utf8") || "{}");
         const aliases = buildDefaultAliases(allFields);
         existing.ado = { ...existing.ado ?? {}, discoveredFields: allFields, fieldAliases: aliases };
-        fs3.writeFileSync(globalConfigPath, JSON.stringify(existing, null, 2) + "\n", "utf8");
+        fs4.writeFileSync(globalConfigPath, JSON.stringify(existing, null, 2) + "\n", "utf8");
         warn(`Saved ${allFields.length} fields and ${Object.keys(aliases).length} aliases to ${globalConfigPath}`);
       }
       success(fields, "ado", "work-fields", start);
@@ -4704,6 +4868,26 @@ function registerAdoRepoCommands(ado) {
       fail(err, "ado", "repo-list-files", start);
     }
   });
+  repo.command("diff").description("Show files changed in a pull request with change types and commit metadata").requiredOption("--pr <n>", "Pull request ID").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const { collection, project, repo: repo2, gitClient } = getAdoContext(ado, true);
+      const data = await gitClient.getPRDiff(collection, project, repo2, parseInt(opts.pr, 10));
+      success(data, "ado", "repo-diff", start);
+    } catch (err) {
+      fail(err, "ado", "repo-diff", start);
+    }
+  });
+  repo.command("get-build-status").description("Get CI/build statuses posted to a commit").requiredOption("--commit <sha>", "Commit SHA").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const { collection, project, repo: repo2, gitClient } = getAdoContext(ado, true);
+      const data = await gitClient.getCommitStatuses(collection, project, repo2, opts.commit);
+      success(data, "ado", "repo-get-build-status", start);
+    } catch (err) {
+      fail(err, "ado", "repo-get-build-status", start);
+    }
+  });
   repo.command("list-reviewers").description("List reviewers on a pull request").requiredOption("--pr <n>", "Pull request ID").action(async (opts) => {
     const start = Date.now();
     try {
@@ -4719,7 +4903,7 @@ function registerAdoRepoCommands(ado) {
       const start = Date.now();
       try {
         const globalOpts = ado.optsWithGlobals();
-        const { loadConfig: lc } = await import("./config-KECF7FJ2.js");
+        const { loadConfig: lc } = await import("./config-IJ57IIQA.js");
         const config = lc({ configPath: globalOpts.config });
         const { collection, project, repo: repo2, gitClient } = getAdoContext(ado, true);
         const { AdoCoreClient: AdoCoreClient2 } = await import("./core-AJYPJ2Z7.js");
@@ -4898,6 +5082,136 @@ function registerAdoCommands(program2) {
   registerAdoPipelineCommands(ado);
 }
 
+// src/services/skills/commands.ts
+import fs3 from "fs";
+import path5 from "path";
+var GITHUB_API = "https://api.github.com/repos/kolatts/pncli/contents/.claude/skills";
+var RAW_BASE = "https://raw.githubusercontent.com/kolatts/pncli/main/.claude/skills";
+var RAW_COPILOT_INSTRUCTIONS = "https://raw.githubusercontent.com/kolatts/pncli/main/copilot-instructions.md";
+function registerSkillsCommands(program2) {
+  const skills = program2.command("skills").description("Manage pncli Claude Code skills");
+  skills.command("install").description("Download latest pncli skills and copilot-instructions.md into the current repo").option("--target <dir>", "Target directory for skills", ".claude/skills").option("--skip-instructions", "Skip downloading copilot-instructions.md (always written to repo root)").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const targetDir = path5.resolve(opts.target);
+      warn("Fetching skill list from GitHub...");
+      const listRes = await fetch(GITHUB_API, {
+        headers: { "Accept": "application/vnd.github.v3+json", "User-Agent": "pncli" }
+      });
+      if (!listRes.ok) {
+        throw new Error(`GitHub API returned ${listRes.status}: ${await listRes.text()}`);
+      }
+      const entries = await listRes.json();
+      const skillDirs = entries.filter((e) => e.type === "dir").map((e) => e.name);
+      if (skillDirs.length === 0) {
+        throw new Error("No skills found in the pncli repository");
+      }
+      const resolvedTarget = path5.resolve(targetDir);
+      for (const skillName of skillDirs) {
+        const existingDir = path5.resolve(targetDir, skillName);
+        if (!existingDir.startsWith(resolvedTarget + path5.sep)) continue;
+        if (fs3.existsSync(existingDir)) {
+          fs3.rmSync(existingDir, { recursive: true, force: true });
+        }
+      }
+      warn(`Found ${skillDirs.length} skills. Downloading...`);
+      const installed = [];
+      const failed = [];
+      for (const skillName of skillDirs) {
+        const skillDir = path5.resolve(targetDir, skillName);
+        if (!skillDir.startsWith(resolvedTarget + path5.sep)) {
+          failed.push(skillName);
+          continue;
+        }
+        const skillUrl = `${RAW_BASE}/${skillName}/SKILL.md`;
+        try {
+          const res = await fetch(skillUrl, {
+            headers: { "User-Agent": "pncli" }
+          });
+          if (!res.ok) {
+            failed.push(skillName);
+            continue;
+          }
+          const content = await res.text();
+          fs3.mkdirSync(skillDir, { recursive: true });
+          fs3.writeFileSync(path5.join(skillDir, "SKILL.md"), content, "utf8");
+          installed.push(skillName);
+        } catch {
+          failed.push(skillName);
+        }
+      }
+      warn(`Installed ${installed.length} skill(s) to ${targetDir}`);
+      if (failed.length > 0) {
+        warn(`Failed to download: ${failed.join(", ")}`);
+      }
+      let instructionsWritten = false;
+      if (!opts.skipInstructions) {
+        warn("Downloading copilot-instructions.md...");
+        try {
+          const res = await fetch(RAW_COPILOT_INSTRUCTIONS, {
+            headers: { "User-Agent": "pncli" }
+          });
+          if (res.ok) {
+            const content = await res.text();
+            fs3.writeFileSync("copilot-instructions.md", content, "utf8");
+            instructionsWritten = true;
+            warn("Wrote copilot-instructions.md");
+          } else {
+            warn(`Failed to download copilot-instructions.md (${res.status})`);
+          }
+        } catch {
+          warn("Failed to download copilot-instructions.md");
+        }
+      }
+      success({
+        installed,
+        failed,
+        target: targetDir,
+        total: installed.length,
+        copilotInstructions: instructionsWritten
+      }, "skills", "install", start);
+    } catch (err) {
+      fail(err, "skills", "install", start);
+    }
+  });
+  skills.command("list").description("List locally installed skills").option("--target <dir>", "Skills directory to scan", ".claude/skills").action((opts) => {
+    const start = Date.now();
+    try {
+      const targetDir = path5.resolve(opts.target);
+      if (!fs3.existsSync(targetDir)) {
+        success({ skills: [], message: "No skills directory found. Run: pncli skills install" }, "skills", "list", start);
+        return;
+      }
+      const skillDirs = fs3.readdirSync(targetDir).filter((name) => {
+        const skillPath = path5.join(targetDir, name, "SKILL.md");
+        return fs3.existsSync(skillPath);
+      });
+      const skills2 = skillDirs.map((name) => {
+        const content = fs3.readFileSync(path5.join(targetDir, name, "SKILL.md"), "utf8");
+        const frontmatter = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+        const data = {};
+        if (frontmatter) {
+          for (const line of frontmatter[1].split("\n")) {
+            const colonIdx = line.indexOf(":");
+            if (colonIdx === -1) continue;
+            data[line.slice(0, colonIdx).trim()] = line.slice(colonIdx + 1).trim();
+          }
+        }
+        return {
+          name: data.name || name,
+          slug: name,
+          category: data.category || "other",
+          services: data.services || "",
+          providers: data.providers || "none"
+        };
+      });
+      success({ skills: skills2, total: skills2.length }, "skills", "list", start);
+    } catch (err) {
+      fail(err, "skills", "list", start);
+    }
+  });
+}
+
 // src/cli.ts
 if (!process.env.PNCLI_VERIFY_TLS) {
   process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0";
@@ -4928,6 +5242,7 @@ registerSdeCommands(program);
 registerDepsCommands(program);
 registerConfigCommands(program);
 registerAdoCommands(program);
+registerSkillsCommands(program);
 program.addHelpText("after", `
 Services:
   git          Local git operations (status, diff, log, branch)
@@ -4939,6 +5254,7 @@ Services:
   sde          SDElements (threat modeling, countermeasures, compliance)
   ado          Azure DevOps Server (work items, repos, PRs, pipelines)
   config       Manage pncli configuration
+  skills       Download and manage Claude Code skills
 `);
 program.parseAsync(process.argv).catch((err) => {
   if (process.exitCode !== void 0) return;