@kolatts/pncli 1.16.0 → 1.18.0

package/dist/cli.js

@@ -8,7 +8,7 @@ import {
   setRepoConfigValue,
   writeGlobalConfig,
   writeRepoConfig
-} from "./chunk-P5NWDQ2B.js";
+} from "./chunk-IVUDXPDP.js";
 import {
   ExitCode,
   PncliError,
@@ -20,7 +20,7 @@ import {
   success,
   warn,
   writeRawOutput
-} from "./chunk-XPPEXJBP.js";
+} from "./chunk-WX4ZRHIC.js";
 import {
   AdoCoreClient
 } from "./chunk-VDL32PSG.js";
@@ -734,6 +734,19 @@ var BitbucketClient = class {
     );
     return result.values ?? [];
   }
+  async createRepo(opts) {
+    return this.http.bitbucket(
+      `${API}/projects/${opts.project}/repos`,
+      {
+        method: "POST",
+        body: {
+          name: opts.name,
+          scmId: "git",
+          ...opts.description !== void 0 ? { description: opts.description } : {}
+        }
+      }
+    );
+  }
 };
 
 // src/services/git/commands.ts
@@ -837,7 +850,7 @@ function registerGitCommands(program2) {
 }
 
 // src/services/jira/commands.ts
-import { readFileSync as readFileSync2, existsSync, writeFileSync, mkdirSync } from "fs";
+import { readFileSync as readFileSync3, existsSync, writeFileSync, mkdirSync } from "fs";
 import path from "path";
 
 // src/services/jira/client.ts
@@ -876,6 +889,7 @@ function guessMimeType(filePath) {
 
 // src/services/jira/client.ts
 var API2 = "/rest/api/2";
+var AGILE_API = "/rest/agile/1.0";
 var JiraClient = class {
   constructor(http) {
     this.http = http;
@@ -910,7 +924,7 @@ var JiraClient = class {
     if (opts.description) fields.description = opts.description;
     if (opts.priority) fields.priority = { name: opts.priority };
     if (opts.assignee) fields.assignee = { name: opts.assignee };
-    if (opts.labels) fields.labels = opts.labels;
+    if (opts.labels?.length) fields.labels = opts.labels;
     Object.assign(fields, opts.customFieldValues ?? {});
     await this.http.jira(`${API2}/issue/${key}`, {
       method: "PUT",
@@ -1071,6 +1085,42 @@ var JiraClient = class {
       }
     });
   }
+  async listBoards(project) {
+    return this.http.jiraPaginate(async (startAt, maxResults) => {
+      return this.http.jira(
+        `${AGILE_API}/board`,
+        { params: { projectKeyOrId: project, startAt, maxResults } }
+      );
+    });
+  }
+  async listSprintsForBoard(boardId, states) {
+    return this.http.jiraPaginate(async (startAt, maxResults) => {
+      return this.http.jira(
+        `${AGILE_API}/board/${boardId}/sprint`,
+        { params: { startAt, maxResults, ...states?.length ? { state: states.join(",") } : {} } }
+      );
+    });
+  }
+  async listSprintsForProject(project, states) {
+    const boards = await this.listBoards(project);
+    const sprints = [];
+    const seen = /* @__PURE__ */ new Set();
+    for (const board of boards) {
+      if (board.type !== "scrum") continue;
+      for (const sprint of await this.listSprintsForBoard(board.id, states)) {
+        if (seen.has(sprint.id)) continue;
+        seen.add(sprint.id);
+        sprints.push(sprint);
+      }
+    }
+    return sprints;
+  }
+  async setSprint(sprintId, issueKeys) {
+    await this.http.jira(`${AGILE_API}/sprint/${sprintId}/issue`, {
+      method: "POST",
+      body: { issues: issueKeys }
+    });
+  }
 };
 function schemaToPncliType(schema) {
   if (!schema) return void 0;
@@ -1170,7 +1220,119 @@ function formatFieldValue(value, type) {
   }
 }
 
+// src/services/jira/input-schema.ts
+var JIRA_INPUT_FILE_SCHEMA = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "pncli Jira issue input file",
+  description: "Shape accepted by --input-file on `pncli jira create-issue` / `update-issue`. CLI flags (--summary, --description, --priority, --field, ...) override matching keys here; overridden keys are reported in meta.overrides.",
+  type: "object",
+  properties: {
+    project: { type: "string", description: "Project key (create-issue only)" },
+    issueType: { type: "string", description: "Issue type name, e.g. Bug, Story, Task (create-issue only)" },
+    fields: {
+      type: "object",
+      description: 'Field dictionary. Built-in keys: summary, description, priority, assignee, labels, parent. Any other key resolves as a custom field: a friendly name registered via `pncli jira fields`, or a raw field id (e.g. customfield_10032) passed through untouched \u2014 custom fields never need to be pre-registered in config. Any string value may be "@path/to/file" to read that field\'s content from a file instead of inlining it (useful for large rich-text fields).',
+      additionalProperties: true
+    }
+  },
+  additionalProperties: false
+};
+var JIRA_INPUT_FILE_EXAMPLE = {
+  project: "PROJ",
+  issueType: "Bug",
+  fields: {
+    summary: "Login broken on Safari",
+    description: "@desc.html",
+    priority: "High",
+    labels: ["frontend", "urgent"],
+    // Raw field id — passed through untouched, no pre-registration needed. A friendly
+    // custom-field name (e.g. "Story Points") also works, but only once it's registered
+    // via `pncli config set jira.customFields` / discovered with `pncli jira fields`.
+    customfield_10032: "@ac.md"
+  }
+};
+
+// src/lib/input.ts
+import { readFileSync as readFileSync2 } from "fs";
+function resolveTextInput(inline, file, optionName) {
+  if (inline !== void 0 && file !== void 0) {
+    throw new PncliError(`Cannot specify both --${optionName} and --${optionName}-file`, 1);
+  }
+  if (file !== void 0) {
+    try {
+      return readFileSync2(file === "-" ? 0 : file, "utf8");
+    } catch (e) {
+      const source = file === "-" ? "stdin" : `file "${file}"`;
+      throw new PncliError(`Cannot read ${optionName} ${source}: ${e.message}`, 1);
+    }
+  }
+  return inline;
+}
+function readJsonInputFile(filePath, optionName = "input-file") {
+  let raw;
+  try {
+    raw = readFileSync2(filePath === "-" ? 0 : filePath, "utf8");
+  } catch (e) {
+    const source = filePath === "-" ? "stdin" : `file "${filePath}"`;
+    throw new PncliError(`Cannot read --${optionName} ${source}: ${e.message}`, 1);
+  }
+  try {
+    return JSON.parse(raw);
+  } catch (e) {
+    throw new PncliError(`--${optionName} must contain valid JSON: ${e.message}`, 1);
+  }
+}
+function resolveAtFileRef(value) {
+  if (typeof value !== "string" || !value.startsWith("@")) return value;
+  const filePath = value.slice(1);
+  try {
+    return readFileSync2(filePath, "utf8");
+  } catch (e) {
+    throw new PncliError(`Cannot read referenced file "${filePath}": ${e.message}`, 1);
+  }
+}
+function mergeWithOverrides(fromJson, fromFlags) {
+  const merged = { ...fromJson };
+  const overrides = [];
+  for (const [key, value] of Object.entries(fromFlags)) {
+    if (value === void 0) continue;
+    if (Object.prototype.hasOwnProperty.call(fromJson, key)) overrides.push(key);
+    merged[key] = value;
+  }
+  return { merged, overrides };
+}
+
 // src/services/jira/commands.ts
+var BUILTIN_ISSUE_FIELDS = /* @__PURE__ */ new Set(["summary", "description", "priority", "assignee", "labels", "parent"]);
+function splitFieldsDictionary(fields, fieldMap) {
+  const builtin = {};
+  const custom = {};
+  for (const [rawKey, rawValue] of Object.entries(fields)) {
+    const value = resolveAtFileRef(rawValue);
+    const key = rawKey.toLowerCase();
+    if (BUILTIN_ISSUE_FIELDS.has(key)) {
+      builtin[key] = value;
+      continue;
+    }
+    const def = fieldMap.byName.get(key) ?? fieldMap.byId.get(rawKey);
+    if (def) {
+      custom[def.id] = value;
+    } else if (!/\s/.test(rawKey)) {
+      custom[rawKey] = value;
+    } else {
+      throw new PncliError(
+        `Unknown custom field: "${rawKey}". Fields must be registered in config by friendly name or ID. Run: pncli jira fields`,
+        1
+      );
+    }
+  }
+  return { builtin, custom };
+}
+function normalizeLabels(value) {
+  if (value === void 0) return void 0;
+  if (Array.isArray(value)) return value.map((v) => String(v).trim());
+  return String(value).split(",").map((s) => s.trim()).filter(Boolean);
+}
 function getClient(program2) {
   const opts = program2.optsWithGlobals();
   const config = loadConfig({ configPath: opts.config });
@@ -1210,7 +1372,7 @@ function registerJiraCommands(program2) {
       fail(err, "jira", "get-issue", start);
     }
   });
-  jira.command("create-issue").description("Create a Jira issue").option("--project <key>", "Project key").option("--type <type>", "Issue type (Bug, Story, Task, ...)").requiredOption("--summary <text>", "Issue summary").option("--description <text>", "Issue description").option("--priority <name>", "Priority name").option("--assignee <accountId>", "Assignee account ID").option("--labels <labels>", "Comma-separated labels").option("--parent <key>", "Parent issue key \u2014 sets fields.parent in the create payload").option("--field <Name=value>", "Custom field value; use Name=@file.json to read value from file (repeatable)", (val, acc) => [...acc, val], []).option("--fields-file <path>", "Path to a JSON file mapping field names/IDs to their Jira API values").action(async (opts) => {
+  jira.command("create-issue").description("Create a Jira issue").option("--project <key>", "Project key").option("--type <type>", "Issue type (Bug, Story, Task, ...)").option("--summary <text>", "Issue summary (required, unless supplied via --input-file)").option("--description <text>", "Issue description").option("--priority <name>", "Priority name").option("--assignee <accountId>", "Assignee account ID").option("--labels <labels>", "Comma-separated labels").option("--parent <key>", "Parent issue key \u2014 sets fields.parent in the create payload").option("--field <Name=value>", "Custom field value; use Name=@file.json to read value from file (repeatable)", (val, acc) => [...acc, val], []).option("--fields-file <path>", "Path to a JSON file mapping field names/IDs to their Jira API values").option("--input-file <path>", "JSON file describing the whole issue ({ project, issueType, fields: {...} }); '-' = stdin. CLI flags override matching keys. See: pncli jira schema").action(async (opts) => {
     const start = Date.now();
     let fieldMap = buildFieldMap([]);
     try {
@@ -1218,35 +1380,87 @@ function registerJiraCommands(program2) {
       const client = resolved.client;
       fieldMap = resolved.fieldMap;
       const defaults = getDefaults(program2);
-      const project = opts.project ?? defaults.project;
-      const issueType = opts.type ?? defaults.issueType ?? "Task";
-      const priority = opts.priority ?? defaults.priority;
-      if (!project) throw new PncliError("--project required (or set defaults.jira.project in config)", 1);
-      const labels = opts.labels ? opts.labels.split(",").map((s) => s.trim()) : void 0;
+      const jsonInput = opts.inputFile ? readJsonInputFile(opts.inputFile) : void 0;
+      const { builtin: jsonBuiltin, custom: jsonCustom } = jsonInput?.fields ? splitFieldsDictionary(jsonInput.fields, fieldMap) : { builtin: {}, custom: {} };
+      const project = opts.project ?? jsonInput?.project ?? defaults.project;
+      const issueType = opts.type ?? jsonInput?.issueType ?? defaults.issueType ?? "Task";
+      if (!project) throw new PncliError('--project required (or set defaults.jira.project in config, or "project" in --input-file)', 1);
+      const flagBuiltin = {
+        ...opts.summary !== void 0 ? { summary: opts.summary } : {},
+        ...opts.description !== void 0 ? { description: opts.description } : {},
+        ...opts.priority !== void 0 ? { priority: opts.priority } : {},
+        ...opts.assignee !== void 0 ? { assignee: opts.assignee } : {},
+        ...opts.labels !== void 0 ? { labels: opts.labels } : {},
+        ...opts.parent !== void 0 ? { parent: opts.parent } : {}
+      };
+      const { merged: builtinFields, overrides: builtinOverrides } = mergeWithOverrides(jsonBuiltin, flagBuiltin);
+      const summary = builtinFields.summary;
+      if (!summary) throw new PncliError('Must specify --summary or "fields.summary" in --input-file', 1);
+      const priority = builtinFields.priority ?? defaults.priority;
       const fileFields = opts.fieldsFile ? parseFieldsFile(opts.fieldsFile, fieldMap) : {};
-      const customFieldValues = { ...fileFields, ...parseFieldArgs(opts.field, fieldMap) };
-      const data = await client.createIssue({ project, issueType, summary: opts.summary, description: opts.description, priority, assignee: opts.assignee, labels, parent: opts.parent, customFieldValues });
-      success(data, "jira", "create-issue", start);
+      const flagCustom = { ...fileFields, ...parseFieldArgs(opts.field, fieldMap) };
+      const { merged: customFieldValues, overrides: customOverrides } = mergeWithOverrides(jsonCustom, flagCustom);
+      const overrides = [...builtinOverrides, ...customOverrides];
+      if (overrides.length) warn(`--input-file value(s) overridden by CLI flags: ${overrides.join(", ")}`);
+      const data = await client.createIssue({
+        project,
+        issueType,
+        summary,
+        description: builtinFields.description,
+        priority,
+        assignee: builtinFields.assignee,
+        labels: normalizeLabels(builtinFields.labels),
+        parent: builtinFields.parent,
+        customFieldValues
+      });
+      success(data, "jira", "create-issue", start, overrides);
     } catch (err) {
       fail(translateFieldErrors(err, fieldMap), "jira", "create-issue", start);
     }
   });
-  jira.command("update-issue").description("Update a Jira issue").requiredOption("--key <issue-key>", "Issue key").option("--summary <text>", "New summary").option("--description <text>", "New description").option("--priority <name>", "New priority").option("--assignee <accountId>", "New assignee account ID").option("--labels <labels>", "Comma-separated labels").option("--field <Name=value>", "Custom field value; use Name=@file.json to read value from file (repeatable)", (val, acc) => [...acc, val], []).option("--fields-file <path>", "Path to a JSON file mapping field names/IDs to their Jira API values").action(async (opts) => {
+  jira.command("update-issue").description("Update a Jira issue").requiredOption("--key <issue-key>", "Issue key").option("--summary <text>", "New summary").option("--description <text>", "New description").option("--priority <name>", "New priority").option("--assignee <accountId>", "New assignee account ID").option("--labels <labels>", "Comma-separated labels").option("--field <Name=value>", "Custom field value; use Name=@file.json to read value from file (repeatable)", (val, acc) => [...acc, val], []).option("--fields-file <path>", "Path to a JSON file mapping field names/IDs to their Jira API values").option("--input-file <path>", "JSON file describing fields to update ({ fields: {...} }); '-' = stdin. CLI flags override matching keys. See: pncli jira schema").action(async (opts) => {
     const start = Date.now();
     let fieldMap = buildFieldMap([]);
     try {
       const resolved = getClientAndFields(program2);
       const client = resolved.client;
       fieldMap = resolved.fieldMap;
-      const labels = opts.labels ? opts.labels.split(",").map((s) => s.trim()) : void 0;
+      const jsonInput = opts.inputFile ? readJsonInputFile(opts.inputFile) : void 0;
+      const { builtin: jsonBuiltin, custom: jsonCustom } = jsonInput?.fields ? splitFieldsDictionary(jsonInput.fields, fieldMap) : { builtin: {}, custom: {} };
+      const flagBuiltin = {
+        ...opts.summary !== void 0 ? { summary: opts.summary } : {},
+        ...opts.description !== void 0 ? { description: opts.description } : {},
+        ...opts.priority !== void 0 ? { priority: opts.priority } : {},
+        ...opts.assignee !== void 0 ? { assignee: opts.assignee } : {},
+        ...opts.labels !== void 0 ? { labels: opts.labels } : {}
+      };
+      const { merged: builtinFields, overrides: builtinOverrides } = mergeWithOverrides(jsonBuiltin, flagBuiltin);
       const fileFields = opts.fieldsFile ? parseFieldsFile(opts.fieldsFile, fieldMap) : {};
-      const customFieldValues = { ...fileFields, ...parseFieldArgs(opts.field, fieldMap) };
-      await client.updateIssue(opts.key, { summary: opts.summary, description: opts.description, priority: opts.priority, assignee: opts.assignee, labels, customFieldValues });
-      success({ updated: opts.key }, "jira", "update-issue", start);
+      const flagCustom = { ...fileFields, ...parseFieldArgs(opts.field, fieldMap) };
+      const { merged: customFieldValues, overrides: customOverrides } = mergeWithOverrides(jsonCustom, flagCustom);
+      const overrides = [...builtinOverrides, ...customOverrides];
+      if (overrides.length) warn(`--input-file value(s) overridden by CLI flags: ${overrides.join(", ")}`);
+      await client.updateIssue(opts.key, {
+        summary: builtinFields.summary,
+        description: builtinFields.description,
+        priority: builtinFields.priority,
+        assignee: builtinFields.assignee,
+        labels: normalizeLabels(builtinFields.labels),
+        customFieldValues
+      });
+      success({ updated: opts.key }, "jira", "update-issue", start, overrides);
     } catch (err) {
       fail(translateFieldErrors(err, fieldMap), "jira", "update-issue", start);
     }
   });
+  jira.command("schema").description("Print the --input-file JSON schema and an example for create-issue/update-issue").option("--example-only", "Print only the runnable example JSON (no envelope) \u2014 pipeable straight into --input-file").action((opts) => {
+    const start = Date.now();
+    if (opts.exampleOnly) {
+      writeRawOutput(JSON.stringify(JIRA_INPUT_FILE_EXAMPLE, null, 2) + "\n");
+      return;
+    }
+    success({ schema: JIRA_INPUT_FILE_SCHEMA, example: JIRA_INPUT_FILE_EXAMPLE }, "jira", "schema", start);
+  });
   jira.command("transition-issue").description("Transition a Jira issue to a new status").requiredOption("--key <issue-key>", "Issue key").requiredOption("--transition <name-or-id>", "Transition name or ID").action(async (opts) => {
     const start = Date.now();
     try {
@@ -1406,6 +1620,38 @@ function registerJiraCommands(program2) {
       fail(err, "jira", "fields", start);
     }
   });
+  jira.command("list-boards").description("List Agile boards for a project").requiredOption("--project <key>", "Project key").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const client = getClient(program2);
+      const data = await client.listBoards(opts.project);
+      success(data, "jira", "list-boards", start);
+    } catch (err) {
+      fail(err, "jira", "list-boards", start);
+    }
+  });
+  jira.command("list-sprints").description("List sprints for a board or project, including start/end dates").option("--board <id>", "Board ID").option("--project <key>", "Project key \u2014 resolves to that project's board(s)").option("--state <states>", "Comma-separated states to filter (active,future,closed)").action(async (opts) => {
+    const start = Date.now();
+    try {
+      if (!opts.board && !opts.project) throw new PncliError("Either --board or --project is required", 1);
+      const client = getClient(program2);
+      const states = opts.state ? opts.state.split(",").map((s) => s.trim()) : void 0;
+      const data = opts.board ? await client.listSprintsForBoard(parseInt(opts.board, 10), states) : await client.listSprintsForProject(opts.project, states);
+      success(data, "jira", "list-sprints", start);
+    } catch (err) {
+      fail(err, "jira", "list-sprints", start);
+    }
+  });
+  jira.command("set-sprint").description("Move a Jira issue into a sprint").requiredOption("--key <issue-key>", "Issue key").requiredOption("--sprint <id>", "Sprint ID (from list-sprints)").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const client = getClient(program2);
+      await client.setSprint(parseInt(opts.sprint, 10), [opts.key]);
+      success({ updated: opts.key, sprint: opts.sprint }, "jira", "set-sprint", start);
+    } catch (err) {
+      fail(err, "jira", "set-sprint", start);
+    }
+  });
 }
 function parseFieldArgs(fieldArgs, fieldMap) {
   const result = {};
@@ -1423,7 +1669,7 @@ function parseFieldArgs(fieldArgs, fieldMap) {
       const filePath = value.slice(1);
       let raw;
       try {
-        raw = readFileSync2(filePath, "utf8").trim();
+        raw = readFileSync3(filePath, "utf8").trim();
       } catch (e) {
         throw new PncliError(`Cannot read file "${filePath}": ${e.message}`, 1);
       }
@@ -1441,7 +1687,7 @@ function parseFieldArgs(fieldArgs, fieldMap) {
 function parseFieldsFile(filePath, fieldMap) {
   let raw;
   try {
-    raw = readFileSync2(filePath, "utf8");
+    raw = readFileSync3(filePath, "utf8");
   } catch (e) {
     throw new PncliError(`Cannot read fields file "${filePath}": ${e.message}`, 1);
   }
@@ -1494,6 +1740,24 @@ function getClient2(program2, overrides) {
 }
 function registerBitbucketCommands(program2) {
   const bb = program2.command("bitbucket").description("Bitbucket Server operations").option("--project <key>", "Bitbucket project key").option("--repo <slug>", "Bitbucket repository slug");
+  bb.command("create-repo").description("Create a new repository in a project").requiredOption("--name <name>", "Repository name (slug)").option("--description <desc>", "Repository description").option("--project <key>", "Bitbucket project key (overrides parent --project)").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const globalOpts = bb.optsWithGlobals();
+      const config = loadConfig({ configPath: globalOpts.config });
+      const http = createHttpClient(config, Boolean(globalOpts.dryRun));
+      const client = new BitbucketClient(http);
+      const ctx = getGitContext(config);
+      const project = opts.project ?? globalOpts.project ?? ctx?.project ?? config.defaults.bitbucket?.project ?? "";
+      if (!project) {
+        throw new PncliError("Could not determine Bitbucket project. Pass --project, or run pncli config init.", 1);
+      }
+      const data = await client.createRepo({ project, name: opts.name, description: opts.description });
+      success(data, "bitbucket", "create-repo", start);
+    } catch (err) {
+      fail(err, "bitbucket", "create-repo", start);
+    }
+  });
   bb.command("list-prs").description("List pull requests").option("--state <state>", "PR state: OPEN|MERGED|DECLINED|ALL", "OPEN").option("--author <username>", "Filter by author username").option("--reviewer <username>", "Filter by reviewer username").action(async (opts) => {
     const start = Date.now();
     try {
@@ -1896,6 +2160,32 @@ var GitHubClient = class {
     }
     return results;
   }
+  async createIssue(opts) {
+    return this.http.github(
+      `/repos/${opts.owner}/${opts.repo}/issues`,
+      {
+        method: "POST",
+        body: {
+          title: opts.title,
+          ...opts.body !== void 0 ? { body: opts.body } : {},
+          ...opts.labels?.length ? { labels: opts.labels } : {},
+          ...opts.assignees?.length ? { assignees: opts.assignees } : {}
+        }
+      }
+    );
+  }
+  async createRepo(opts) {
+    const path8 = opts.org ? `/orgs/${opts.org}/repos` : "/user/repos";
+    return this.http.github(path8, {
+      method: "POST",
+      body: {
+        name: opts.name,
+        ...opts.description !== void 0 ? { description: opts.description } : {},
+        ...opts.private !== void 0 ? { private: opts.private } : {},
+        ...opts.autoInit !== void 0 ? { auto_init: opts.autoInit } : {}
+      }
+    });
+  }
 };
 
 // src/services/github/commands.ts
@@ -1917,6 +2207,50 @@ function getClient3(program2, overrides) {
 }
 function registerGitHubCommands(program2) {
   const gh = program2.command("github").description("GitHub repository operations").option("--owner <owner>", "GitHub owner (user or org)").option("--repo <repo>", "GitHub repository name");
+  gh.command("create-repo").description("Create a new repository (personal or org)").requiredOption("--name <name>", "Repository name").option("--description <desc>", "Repository description").option("--private", "Create as a private repository").option("--auto-init", "Initialize with a README").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const globalOpts = gh.optsWithGlobals();
+      const config = loadConfig({ configPath: globalOpts.config });
+      const http = createHttpClient(config, Boolean(globalOpts.dryRun));
+      const client = new GitHubClient(http);
+      const owner = globalOpts.owner ?? "";
+      const data = await client.createRepo({
+        org: owner || void 0,
+        name: opts.name,
+        description: opts.description,
+        private: opts.private,
+        autoInit: opts.autoInit
+      });
+      success(data, "github", "create-repo", start);
+    } catch (err) {
+      fail(err, "github", "create-repo", start);
+    }
+  });
+  gh.command("create-issue").description("Create a GitHub issue").requiredOption("--title <title>", "Issue title").option("--body <body>", "Issue body (markdown)").option("--body-file <path>", "Read issue body from a file (use - for stdin); overridden by --body").option("--label <label>", "Label to apply (repeatable)", (v, acc) => {
+    acc.push(v);
+    return acc;
+  }, []).option("--assignee <login>", "Assignee login (repeatable)", (v, acc) => {
+    acc.push(v);
+    return acc;
+  }, []).action(async (opts) => {
+    const start = Date.now();
+    try {
+      const { client, owner, repo } = getClient3(gh);
+      const body = opts.body ?? resolveTextInput(void 0, opts.bodyFile, "body");
+      const data = await client.createIssue({
+        owner,
+        repo,
+        title: opts.title,
+        body,
+        labels: opts.label.length ? opts.label : void 0,
+        assignees: opts.assignee.length ? opts.assignee : void 0
+      });
+      success(data, "github", "create-issue", start);
+    } catch (err) {
+      fail(err, "github", "create-issue", start);
+    }
+  });
   gh.command("list-prs").description("List pull requests").addOption(new Option("--state <state>", "PR state").choices(["open", "closed", "all"]).default("open")).option("--head <branch>", "Filter by head branch (user:branch)").option("--base <branch>", "Filter by base branch").action(async (opts) => {
     const start = Date.now();
     try {
@@ -1943,18 +2277,19 @@ function registerGitHubCommands(program2) {
       fail(err, "github", "get-pr", start);
     }
   });
-  gh.command("create-pr").description("Create a pull request").requiredOption("--title <title>", "PR title").requiredOption("--head <branch>", "Source branch (or user:branch for forks)").option("--base <branch>", "Target branch (defaults to config or main)").option("--body <body>", "PR description").option("--draft", "Create as draft PR").option("--owner <owner>", "GitHub owner (overrides parent --owner)").option("--repo <repo>", "GitHub repository name (overrides parent --repo)").action(async (opts) => {
+  gh.command("create-pr").description("Create a pull request").requiredOption("--title <title>", "PR title").requiredOption("--head <branch>", "Source branch (or user:branch for forks)").option("--base <branch>", "Target branch (defaults to config or main)").option("--body <body>", "PR description").option("--body-file <path>", "Read PR description from a file (use - for stdin); overridden by --body").option("--draft", "Create as draft PR").option("--owner <owner>", "GitHub owner (overrides parent --owner)").option("--repo <repo>", "GitHub repository name (overrides parent --repo)").action(async (opts) => {
     const start = Date.now();
     try {
       const { client, owner, repo, config } = getClient3(gh, { owner: opts.owner, repo: opts.repo });
       const base = opts.base ?? config.defaults.github?.targetBranch ?? "main";
+      const body = opts.body ?? resolveTextInput(void 0, opts.bodyFile, "body");
       const data = await client.createPR({
         owner,
         repo,
         title: opts.title,
         head: opts.head,
         base,
-        body: opts.body,
+        body,
         draft: opts.draft
       });
       success(data, "github", "create-pr", start);
@@ -2179,7 +2514,12 @@ function registerGitHubCommands(program2) {
   });
 }
 
+// src/services/confluence/commands.ts
+import { existsSync as existsSync2 } from "fs";
+
 // src/services/confluence/client.ts
+import { readFileSync as readFileSync4 } from "fs";
+import { basename as basename2 } from "path";
 var API3 = "/rest/api";
 var ConfluenceClient = class {
   constructor(http) {
@@ -2324,9 +2664,52 @@ var ConfluenceClient = class {
       });
     });
   }
+  async uploadAttachment(pageId, filePath, comment) {
+    const fileContent = readFileSync4(filePath);
+    const fileName = basename2(filePath);
+    const mimeType = guessMimeType(filePath);
+    const formData = new FormData();
+    formData.append("file", new Blob([fileContent], { type: mimeType }), fileName);
+    if (comment) formData.append("comment", comment);
+    const result = await this.http.confluenceUpload(
+      `${API3}/content/${pageId}/child/attachment`,
+      formData
+    );
+    return result.results;
+  }
+  async deleteAttachment(attachmentId) {
+    return this.http.confluence(`${API3}/content/${attachmentId}`, { method: "DELETE" });
+  }
+  async getPageHistory(id) {
+    return this.http.confluence(`${API3}/content/${id}/history`);
+  }
+  async convertToStorage(value, fromRepresentation = "markdown") {
+    const result = await this.http.confluence(
+      `${API3}/contentbody/convert/storage`,
+      {
+        method: "POST",
+        body: { value, representation: fromRepresentation }
+      }
+    );
+    return result.value;
+  }
 };
 
 // src/services/confluence/commands.ts
+function xmlParseHint(err, bodyContent, convertedFromMarkdown = false) {
+  if (!(err instanceof Error)) return null;
+  const m = err.message.match(/at \[row,col\]=\{(\d+),(\d+)\}/);
+  if (!m) return null;
+  const row = parseInt(m[1], 10);
+  const col = parseInt(m[2], 10);
+  const lines = bodyContent.split("\n");
+  const line = lines[row - 1];
+  if (!line) return null;
+  const pointer = " ".repeat(Math.max(0, col - 1)) + "^";
+  const suffix = convertedFromMarkdown ? " (converted from Markdown)" : "";
+  return `Offending line ${row}${suffix}: ${line}
+${pointer}`;
+}
 function getClient4(program2) {
   const opts = program2.optsWithGlobals();
   const config = loadConfig({ configPath: opts.config });
@@ -2404,38 +2787,67 @@ function registerConfluenceCommands(program2) {
       fail(err, "confluence", "search", start);
     }
   });
-  confluence.command("create-page").description("Create a new Confluence page").requiredOption("--space <key>", "Space key").requiredOption("--title <title>", "Page title").requiredOption("--body <html>", "Page body (storage format HTML)").option("--parent-id <id>", "Parent page ID (to nest under a page)").option("--representation <format>", "Body format: storage (default) or wiki", "storage").action(async (opts) => {
+  confluence.command("create-page").description("Create a new Confluence page").requiredOption("--space <key>", "Space key").requiredOption("--title <title>", "Page title").option("--body <html>", "Page body (storage format HTML or Markdown when --markdown is set)").option("--body-file <path>", "Path to a file containing the page body ('-' = stdin)").option("--markdown", "Convert body from Markdown to storage format via Confluence API").option("--parent-id <id>", "Parent page ID (to nest under a page)").option("--representation <format>", "Body format: storage (default) or wiki", "storage").action(async (opts) => {
     const start = Date.now();
+    let bodyContent;
     try {
       const client = getClient4(program2);
+      const rawBody = resolveTextInput(opts.body, opts.bodyFile, "body");
+      if (rawBody === void 0) throw new PncliError("Must specify --body or --body-file", 1);
+      bodyContent = opts.markdown ? await client.convertToStorage(rawBody) : rawBody;
+      const representation = opts.markdown ? "storage" : opts.representation;
       const data = await client.createPage({
         spaceKey: opts.space,
         title: opts.title,
-        body: opts.body,
+        body: bodyContent,
         parentId: opts.parentId,
-        representation: opts.representation
+        representation
       });
       success(data, "confluence", "create-page", start);
     } catch (err) {
-      fail(err, "confluence", "create-page", start);
+      const hint = bodyContent ? xmlParseHint(err, bodyContent, Boolean(opts.markdown)) : null;
+      if (hint) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const status = err instanceof PncliError ? err.status : 1;
+        const url = err instanceof PncliError ? err.url : void 0;
+        fail(new PncliError(`${msg}
+
+${hint}`, status, url), "confluence", "create-page", start);
+      } else {
+        fail(err, "confluence", "create-page", start);
+      }
     }
   });
-  confluence.command("update-page").description("Update a Confluence page (fetches current version automatically)").requiredOption("--id <page-id>", "Page ID").option("--title <title>", "New page title").option("--body <html>", "New page body (storage format HTML)").option("--status <status>", "Page status: current (default) or draft", "current").option("--representation <format>", "Body format: storage (default) or wiki", "storage").action(async (opts) => {
+  confluence.command("update-page").description("Update a Confluence page (fetches current version automatically)").requiredOption("--id <page-id>", "Page ID").option("--title <title>", "New page title").option("--body <html>", "New page body (storage format HTML or Markdown when --markdown is set)").option("--body-file <path>", "Path to a file containing the new page body ('-' = stdin)").option("--markdown", "Convert body from Markdown to storage format via Confluence API").option("--status <status>", "Page status: current (default) or draft", "current").option("--representation <format>", "Body format: storage (default) or wiki", "storage").action(async (opts) => {
     const start = Date.now();
+    let bodyContent;
     try {
       const client = getClient4(program2);
+      const rawBody = resolveTextInput(opts.body, opts.bodyFile, "body");
+      bodyContent = rawBody !== void 0 && opts.markdown ? await client.convertToStorage(rawBody) : rawBody;
+      const representation = bodyContent !== void 0 && opts.markdown ? "storage" : opts.representation;
       const current = await client.getPage(opts.id, "version");
       const nextVersion = current.version.number + 1;
       const data = await client.updatePage(opts.id, {
         version: nextVersion,
         title: opts.title ?? current.title,
-        body: opts.body,
+        body: bodyContent,
         status: opts.status,
-        representation: opts.representation
+        representation
       });
       success(data, "confluence", "update-page", start);
     } catch (err) {
-      fail(err, "confluence", "update-page", start);
+      const hint = bodyContent ? xmlParseHint(err, bodyContent, Boolean(opts.markdown)) : null;
+      if (hint) {
+        const msg = err instanceof Error ? err.message : String(err);
+        const status = err instanceof PncliError ? err.status : 1;
+        const url = err instanceof PncliError ? err.url : void 0;
+        fail(new PncliError(`${msg}
+
+${hint}`, status, url), "confluence", "update-page", start);
+      } else {
+        fail(err, "confluence", "update-page", start);
+      }
     }
   });
   confluence.command("delete-page").description("Delete a Confluence page").requiredOption("--id <page-id>", "Page ID").action(async (opts) => {
@@ -2522,6 +2934,37 @@ function registerConfluenceCommands(program2) {
       fail(err, "confluence", "list-attachments", start);
     }
   });
+  confluence.command("upload-attachment").description("Upload a file as an attachment to a Confluence page").requiredOption("--id <page-id>", "Page ID").requiredOption("--file <path>", "Path to the file to upload").option("--comment <text>", "Optional comment to attach to the file version").action(async (opts) => {
+    const start = Date.now();
+    try {
+      if (!existsSync2(opts.file)) throw new PncliError(`File not found: ${opts.file}`, 1);
+      const client = getClient4(program2);
+      const data = await client.uploadAttachment(opts.id, opts.file, opts.comment);
+      success(data, "confluence", "upload-attachment", start);
+    } catch (err) {
+      fail(err, "confluence", "upload-attachment", start);
+    }
+  });
+  confluence.command("delete-attachment").description("Delete an attachment from Confluence by its content ID (moves it to the trash; does not permanently purge it)").requiredOption("--id <attachment-id>", "Attachment content ID").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const client = getClient4(program2);
+      await client.deleteAttachment(opts.id);
+      success({ deleted: opts.id }, "confluence", "delete-attachment", start);
+    } catch (err) {
+      fail(err, "confluence", "delete-attachment", start);
+    }
+  });
+  confluence.command("get-page-history").description("Get the version history metadata for a Confluence page").requiredOption("--id <page-id>", "Page ID").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const client = getClient4(program2);
+      const data = await client.getPageHistory(opts.id);
+      success(data, "confluence", "get-page-history", start);
+    } catch (err) {
+      fail(err, "confluence", "get-page-history", start);
+    }
+  });
 }
 
 // src/services/sonar/client.ts
@@ -4840,8 +5283,8 @@ import password from "@inquirer/password";
 import confirm from "@inquirer/confirm";
 
 // src/services/ado/client/work.ts
-import { readFileSync as readFileSync3 } from "fs";
-import { basename as basename2 } from "path";
+import { readFileSync as readFileSync5 } from "fs";
+import { basename as basename3 } from "path";
 var API6 = "7.1";
 var API_PREVIEW = "7.1-preview.4";
 var AdoWorkClient = class {
@@ -4945,9 +5388,19 @@ var AdoWorkClient = class {
   async downloadAttachment(absoluteUrl) {
     return this.http.adoBuffer(absoluteUrl);
   }
+  async listAreas(collection, project, depth = 10) {
+    return this.http.ado(
+      `/${encodeURIComponent(collection)}/${encodeURIComponent(project)}/_apis/wit/classificationnodes/areas?$depth=${depth}&api-version=${API6}`
+    );
+  }
+  async listIterations(collection, project, depth = 10) {
+    return this.http.ado(
+      `/${encodeURIComponent(collection)}/${encodeURIComponent(project)}/_apis/wit/classificationnodes/iterations?$depth=${depth}&api-version=${API6}`
+    );
+  }
   async uploadAttachment(collection, workItemId, filePath, comment) {
-    const fileContent = readFileSync3(filePath);
-    const fileName = basename2(filePath);
+    const fileContent = readFileSync5(filePath);
+    const fileName = basename3(filePath);
     const attachment = await this.http.adoUpload(
       `/${encodeURIComponent(collection)}/_apis/wit/attachments?fileName=${encodeURIComponent(fileName)}&api-version=${API6}`,
       fileContent,
@@ -4998,32 +5451,32 @@ async function discoverTypes(client, collection, project) {
   }
   return result;
 }
+var ADO_FIELD_ALIAS_CANDIDATES = [
+  ["title", "System.Title"],
+  ["state", "System.State"],
+  ["assignedto", "System.AssignedTo"],
+  ["assigned-to", "System.AssignedTo"],
+  ["description", "System.Description"],
+  ["areapath", "System.AreaPath"],
+  ["area-path", "System.AreaPath"],
+  ["iterationpath", "System.IterationPath"],
+  ["iteration", "System.IterationPath"],
+  ["tags", "System.Tags"],
+  ["priority", "Microsoft.VSTS.Common.Priority"],
+  ["severity", "Microsoft.VSTS.Common.Severity"],
+  ["effort", "Microsoft.VSTS.Scheduling.Effort"],
+  ["storypoints", "Microsoft.VSTS.Scheduling.StoryPoints"],
+  ["story-points", "Microsoft.VSTS.Scheduling.StoryPoints"],
+  ["remainingwork", "Microsoft.VSTS.Scheduling.RemainingWork"],
+  ["remaining", "Microsoft.VSTS.Scheduling.RemainingWork"],
+  ["acceptancecriteria", "Microsoft.VSTS.Common.AcceptanceCriteria"],
+  ["reprosteps", "Microsoft.VSTS.TCM.ReproSteps"],
+  ["foundinsource", "Microsoft.VSTS.Build.FoundIn"]
+];
 function buildDefaultAliases(fields) {
   const refNames = new Set(fields.map((f) => f.referenceName));
-  const candidates = [
-    ["title", "System.Title"],
-    ["state", "System.State"],
-    ["assignedto", "System.AssignedTo"],
-    ["assigned-to", "System.AssignedTo"],
-    ["description", "System.Description"],
-    ["areapath", "System.AreaPath"],
-    ["area-path", "System.AreaPath"],
-    ["iterationpath", "System.IterationPath"],
-    ["iteration", "System.IterationPath"],
-    ["tags", "System.Tags"],
-    ["priority", "Microsoft.VSTS.Common.Priority"],
-    ["severity", "Microsoft.VSTS.Common.Severity"],
-    ["effort", "Microsoft.VSTS.Scheduling.Effort"],
-    ["storypoints", "Microsoft.VSTS.Scheduling.StoryPoints"],
-    ["story-points", "Microsoft.VSTS.Scheduling.StoryPoints"],
-    ["remainingwork", "Microsoft.VSTS.Scheduling.RemainingWork"],
-    ["remaining", "Microsoft.VSTS.Scheduling.RemainingWork"],
-    ["acceptancecriteria", "Microsoft.VSTS.Common.AcceptanceCriteria"],
-    ["reprosteps", "Microsoft.VSTS.TCM.ReproSteps"],
-    ["foundinsource", "Microsoft.VSTS.Build.FoundIn"]
-  ];
   const aliases = {};
-  for (const [alias, ref] of candidates) {
+  for (const [alias, ref] of ADO_FIELD_ALIAS_CANDIDATES) {
     if (refNames.has(ref)) {
       aliases[alias] = ref;
     }
@@ -6271,6 +6724,12 @@ var AdoGitClient = class {
       `/${encodeURIComponent(collection)}/${encodeURIComponent(project)}/_apis/git/repositories/${encodeURIComponent(repoId)}?api-version=${API7}`
     );
   }
+  async createRepo(collection, project, name) {
+    return this.http.ado(
+      `/${encodeURIComponent(collection)}/${encodeURIComponent(project)}/_apis/git/repositories?api-version=${API7}`,
+      { method: "POST", body: { name } }
+    );
+  }
   // ── Pull Requests ─────────────────────────────────────────────────
   async listPRs(collection, project, repo, opts = {}) {
     return this.http.adoPaginate(async (token) => {
@@ -6525,14 +6984,34 @@ function parseFieldArgs2(fields) {
   }
   return result;
 }
+var stripSeparators = (s) => s.toLowerCase().replace(/[\s-]+/g, "");
+var DEFAULT_ADO_FIELD_ALIASES = Object.fromEntries(ADO_FIELD_ALIAS_CANDIDATES);
 function buildFieldPatch(fields, fieldAliases) {
+  const aliases = { ...DEFAULT_ADO_FIELD_ALIASES, ...fieldAliases };
   return Object.entries(fields).map(([key, value]) => {
-    const refName = fieldAliases[key.toLowerCase()] ?? fieldAliases[key] ?? key;
-    return { op: "add", path: `/fields/${refName}`, value };
-  });
-}
-function fieldArgsToPatch(fieldArgs, fieldAliases) {
-  return buildFieldPatch(parseFieldArgs2(fieldArgs), fieldAliases);
+    let refName = aliases[key.toLowerCase()] ?? aliases[key];
+    if (!refName) {
+      const target = stripSeparators(key);
+      const match = Object.entries(aliases).find(([aliasKey]) => stripSeparators(aliasKey) === target);
+      refName = match?.[1];
+    }
+    return { op: "add", path: `/fields/${refName ?? key}`, value };
+  });
+}
+var BUILTIN_WORK_FIELD_KEYS = /* @__PURE__ */ new Set(["title", "description", "assignee", "assignedto", "priority"]);
+function splitWorkFieldsDictionary(fields) {
+  const builtin = {};
+  const custom = {};
+  for (const [rawKey, rawValue] of Object.entries(fields)) {
+    const value = resolveAtFileRef(rawValue);
+    const key = rawKey.toLowerCase().replace(/\s+/g, "");
+    if (BUILTIN_WORK_FIELD_KEYS.has(key)) {
+      builtin[key === "assignedto" ? "assignee" : key] = value;
+    } else {
+      custom[rawKey] = value;
+    }
+  }
+  return { builtin, custom };
 }
 var PR_VOTE = {
   APPROVE: 10,
@@ -6600,6 +7079,35 @@ function registerAdoProjectCommands(ado) {
 // src/services/ado/commands/work.ts
 import fs3 from "fs";
 import path6 from "path";
+
+// src/services/ado/input-schema.ts
+var ADO_WORK_INPUT_FILE_SCHEMA = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  title: "pncli Azure DevOps work item input file",
+  description: "Shape accepted by --input-file on `pncli ado work create` / `work update`. CLI flags (--title, --description, --priority, --field, ...) override matching keys here; overridden keys are reported in meta.overrides.",
+  type: "object",
+  properties: {
+    type: { type: "string", description: "Work item type, e.g. Bug, Task, User Story (create only)" },
+    fields: {
+      type: "object",
+      description: 'Field dictionary. Built-in keys (case-insensitive): title, description, assignee, priority. Any other key (e.g. "Acceptance Criteria", or a raw reference name like "Microsoft.VSTS.Common.AcceptanceCriteria" or a custom "MyOrg.SomeField") resolves through the fieldAliases saved by `pncli ado work fields --save`, falling back to the key itself \u2014 custom fields never need to be pre-registered to be usable here. Any string value may be "@path/to/file" to read that field\'s content from a file instead of inlining it (useful for large rich-text fields like Description or Acceptance Criteria).',
+      additionalProperties: true
+    }
+  },
+  additionalProperties: false
+};
+var ADO_WORK_INPUT_FILE_EXAMPLE = {
+  type: "Bug",
+  fields: {
+    Title: "Login broken on Safari",
+    Description: "@desc.html",
+    "Acceptance Criteria": "@ac.md",
+    Priority: 2,
+    "MyOrg.SomeCustomField": "x"
+  }
+};
+
+// src/services/ado/commands/work.ts
 function registerAdoWorkCommands(ado) {
   const work = ado.command("work").description("Azure DevOps work item operations");
   work.command("get").description("Get a work item by ID").requiredOption("--id <n>", "Work item ID").action(async (opts) => {
@@ -6612,28 +7120,45 @@ function registerAdoWorkCommands(ado) {
       fail(err, "ado", "work-get", start);
     }
   });
-  work.command("create").description("Create a work item").requiredOption("--type <type>", "Work item type (e.g. Bug, Task, User Story)").requiredOption("--title <title>", "Work item title").option("--description <text>", "Description").option("--assignee <user>", "Assigned to (display name or email)").option("--priority <n>", "Priority (1-4)").option("--parent <id>", "Parent work item ID \u2014 creates a parent link after creation").option("--field <name=value>", "Additional field (repeatable)", (v, acc) => {
+  work.command("create").description("Create a work item").option("--type <type>", "Work item type (e.g. Bug, Task, User Story) (required, unless supplied via --input-file)").option("--title <title>", "Work item title (required, unless supplied via --input-file)").option("--description <text>", "Description").option("--assignee <user>", "Assigned to (display name or email)").option("--priority <n>", "Priority (1-4)").option("--parent <id>", "Parent work item ID \u2014 creates a parent link after creation").option("--field <name=value>", "Additional field (repeatable)", (v, acc) => {
     acc.push(v);
     return acc;
-  }, []).action(async (opts) => {
+  }, []).option("--input-file <path>", "JSON file describing the work item ({ type, fields: {...} }); '-' = stdin. CLI flags override matching keys. See: pncli ado work schema").action(async (opts) => {
     const start = Date.now();
     try {
       const globalOpts = ado.optsWithGlobals();
       const config = loadConfig({ configPath: globalOpts.config });
       const { collection, project, workClient } = getAdoContext(ado);
+      const jsonInput = opts.inputFile ? readJsonInputFile(opts.inputFile) : void 0;
+      const { builtin: jsonBuiltin, custom: jsonCustom } = jsonInput?.fields ? splitWorkFieldsDictionary(jsonInput.fields) : { builtin: {}, custom: {} };
+      const type = opts.type ?? jsonInput?.type;
+      if (!type) throw new PncliError('--type required (or "type" in --input-file)', 1);
+      const flagBuiltin = {
+        ...opts.title !== void 0 ? { title: opts.title } : {},
+        ...opts.description !== void 0 ? { description: opts.description } : {},
+        ...opts.assignee !== void 0 ? { assignee: opts.assignee } : {},
+        ...opts.priority !== void 0 ? { priority: opts.priority } : {}
+      };
+      const { merged: builtinFields, overrides: builtinOverrides } = mergeWithOverrides(jsonBuiltin, flagBuiltin);
+      if (!builtinFields.title) throw new PncliError('--title required (or "fields.Title" in --input-file)', 1);
+      const flagCustom = parseFieldArgs2(opts.field);
+      const { merged: customFields, overrides: customOverrides } = mergeWithOverrides(jsonCustom, flagCustom);
+      const overrides = [...builtinOverrides, ...customOverrides];
+      if (overrides.length) warn(`--input-file value(s) overridden by CLI flags: ${overrides.join(", ")}`);
+      const hasContent = (v) => v !== void 0 && v !== "";
       const builtIn = {
-        "System.Title": opts.title,
-        ...opts.description ? { "System.Description": opts.description } : {},
-        ...opts.assignee ? { "System.AssignedTo": opts.assignee } : {},
-        ...opts.priority ? { "Microsoft.VSTS.Common.Priority": opts.priority } : {}
+        "System.Title": builtinFields.title,
+        ...hasContent(builtinFields.description) ? { "System.Description": builtinFields.description } : {},
+        ...hasContent(builtinFields.assignee) ? { "System.AssignedTo": builtinFields.assignee } : {},
+        ...hasContent(builtinFields.priority) ? { "Microsoft.VSTS.Common.Priority": builtinFields.priority } : {}
       };
-      const extra = fieldArgsToPatch(opts.field, config.ado.fieldAliases);
+      const extra = buildFieldPatch(customFields, config.ado.fieldAliases);
       const patch = [
         ...Object.entries(builtIn).map(([k, v]) => ({ op: "add", path: `/fields/${k}`, value: v })),
         ...extra
       ];
-      const data = await workClient.createWorkItem(collection, project, opts.type, patch);
-      success(data, "ado", "work-create", start);
+      const data = await workClient.createWorkItem(collection, project, type, patch);
+      success(data, "ado", "work-create", start, overrides);
       if (opts.parent) {
         try {
           const baseUrl = config.ado.baseUrl?.replace(/\/$/, "");
@@ -6652,15 +7177,20 @@ function registerAdoWorkCommands(ado) {
   work.command("update").description("Update a work item field").requiredOption("--id <n>", "Work item ID").option("--field <name=value>", "Field to update (repeatable)", (v, acc) => {
     acc.push(v);
     return acc;
-  }, []).action(async (opts) => {
+  }, []).option("--input-file <path>", "JSON file describing fields to update ({ fields: {...} }); '-' = stdin. CLI flags override matching keys. See: pncli ado work schema").action(async (opts) => {
     const start = Date.now();
     try {
       const globalOpts = ado.optsWithGlobals();
       const config = loadConfig({ configPath: globalOpts.config });
       const { collection, workClient } = getAdoContext(ado);
-      const patch = fieldArgsToPatch(opts.field, config.ado.fieldAliases);
+      const jsonInput = opts.inputFile ? readJsonInputFile(opts.inputFile) : void 0;
+      const jsonFields = jsonInput?.fields ? Object.fromEntries(Object.entries(jsonInput.fields).map(([k, v]) => [k, resolveAtFileRef(v)])) : {};
+      const flagFields = parseFieldArgs2(opts.field);
+      const { merged, overrides } = mergeWithOverrides(jsonFields, flagFields);
+      if (overrides.length) warn(`--input-file value(s) overridden by CLI flags: ${overrides.join(", ")}`);
+      const patch = buildFieldPatch(merged, config.ado.fieldAliases);
       const data = await workClient.updateWorkItem(collection, parseInt(opts.id, 10), patch);
-      success(data, "ado", "work-update", start);
+      success(data, "ado", "work-update", start, overrides);
     } catch (err) {
       fail(err, "ado", "work-update", start);
     }
@@ -6799,6 +7329,26 @@ function registerAdoWorkCommands(ado) {
       fail(err, "ado", "work-download-attachment", start);
     }
   });
+  work.command("list-areas").description("List classification areas for the team project (tree)").option("--depth <n>", "Depth of the area tree to retrieve", "10").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const { collection, project, workClient } = getAdoContext(ado);
+      const data = await workClient.listAreas(collection, project, parseInt(opts.depth, 10));
+      success(data, "ado", "work-list-areas", start);
+    } catch (err) {
+      fail(err, "ado", "work-list-areas", start);
+    }
+  });
+  work.command("list-iterations").description("List classification iterations for the team project (tree), including start/finish dates").option("--depth <n>", "Depth of the iteration tree to retrieve", "10").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const { collection, project, workClient } = getAdoContext(ado);
+      const data = await workClient.listIterations(collection, project, parseInt(opts.depth, 10));
+      success(data, "ado", "work-list-iterations", start);
+    } catch (err) {
+      fail(err, "ado", "work-list-iterations", start);
+    }
+  });
   work.command("types").description("List work item types in the project").option("--discover", "Fetch from server (always true for this command)").option("--save", "Save discovered types to ~/.pncli/config.json").action(async (opts) => {
     const start = Date.now();
     try {
@@ -6851,6 +7401,14 @@ function registerAdoWorkCommands(ado) {
       fail(err, "ado", "work-fields", start);
     }
   });
+  work.command("schema").description("Print the --input-file JSON schema and an example for work create/update").option("--example-only", "Print only the runnable example JSON (no envelope) \u2014 pipeable straight into --input-file").action((opts) => {
+    const start = Date.now();
+    if (opts.exampleOnly) {
+      writeRawOutput(JSON.stringify(ADO_WORK_INPUT_FILE_EXAMPLE, null, 2) + "\n");
+      return;
+    }
+    success({ schema: ADO_WORK_INPUT_FILE_SCHEMA, example: ADO_WORK_INPUT_FILE_EXAMPLE }, "ado", "work-schema", start);
+  });
 }
 
 // src/services/ado/commands/repo.ts
@@ -6879,6 +7437,16 @@ function registerAdoRepoCommands(ado) {
       fail(err, "ado", "repo-list", start);
     }
   });
+  repo.command("create").description("Create a new git repository in the project").requiredOption("--name <name>", "Repository name").action(async (opts) => {
+    const start = Date.now();
+    try {
+      const { collection, project, gitClient } = getAdoContext(ado);
+      const data = await gitClient.createRepo(collection, project, opts.name);
+      success(data, "ado", "repo-create", start);
+    } catch (err) {
+      fail(err, "ado", "repo-create", start);
+    }
+  });
   repo.command("get").description("Get a specific repository").action(async () => {
     const start = Date.now();
     try {
@@ -7120,11 +7688,11 @@ function registerAdoRepoCommands(ado) {
       const start = Date.now();
       try {
         const globalOpts = ado.optsWithGlobals();
-        const { loadConfig: lc } = await import("./config-3QD5Y2O5.js");
+        const { loadConfig: lc } = await import("./config-QN7KDHE4.js");
         const config = lc({ configPath: globalOpts.config });
         const { collection, project, repo: repo2, gitClient } = getAdoContext(ado, true);
         const { AdoCoreClient: AdoCoreClient2 } = await import("./core-SWYVXOQ4.js");
-        const { createHttpClient: createHttpClient2 } = await import("./http-5WRBWEM6.js");
+        const { createHttpClient: createHttpClient2 } = await import("./http-DDY5DLF6.js");
         const http = createHttpClient2(config, Boolean(globalOpts.dryRun));
         const coreClient = new AdoCoreClient2(http);
         const me = await coreClient.getConnectionData(collection);
@@ -8270,6 +8838,8 @@ import os from "os";
 import { fileURLToPath } from "url";
 import { execFileSync as execFileSync3 } from "child_process";
 import select from "@inquirer/select";
+var BACK = "__back__";
+var ALL_MARKETPLACES = "__all_marketplaces__";
 function injectTokenIntoUrl(url, token) {
   let parsed;
   try {
@@ -8293,10 +8863,31 @@ function repoNameFromUrl(url) {
 function defaultMarketplacePath(url) {
   return path7.join(os.homedir(), ".agents", "marketplaces", repoNameFromUrl(url));
 }
+function marketplaceLabel(m) {
+  return m.name ?? repoNameFromUrl(m.repoUrl ?? "");
+}
+function scrubToken(msg) {
+  return msg.replace(/x-(?:token-auth|access-token):[^@]+@/g, "x-token-auth:***@");
+}
+function assertInteractive(hint) {
+  if (!process.stdin.isTTY) {
+    throw new Error(`This selection requires an interactive terminal. ${hint}`);
+  }
+}
 var AGENT_PATHS = {
   "github-copilot": { project: ".agents/skills", user: path7.join(os.homedir(), ".copilot/skills") },
   "claude-code": { project: ".claude/skills", user: path7.join(os.homedir(), ".claude/skills") }
 };
+function resolveAgentName(opts) {
+  return opts.claude ? "claude-code" : opts.agent ?? "github-copilot";
+}
+function resolveAgentPaths(agentName) {
+  const agentConfig = AGENT_PATHS[agentName];
+  if (!agentConfig) {
+    throw new Error(`Unknown agent: "${agentName}". Use: ${Object.keys(AGENT_PATHS).join(" | ")}`);
+  }
+  return agentConfig;
+}
 function getBundledSkillsDir() {
   try {
     const thisFile = fileURLToPath(import.meta.url);
@@ -8305,6 +8896,233 @@ function getBundledSkillsDir() {
     return "";
   }
 }
+function getInstalledMetaPath(targetDir) {
+  return path7.join(targetDir, ".pncli-installed.json");
+}
+function readInstalledMeta(targetDir) {
+  const metaPath = getInstalledMetaPath(targetDir);
+  const raw = loadJsonFile(metaPath);
+  if (raw && raw.version === 1 && raw.skills) return raw;
+  return { version: 1, skills: {} };
+}
+function recordInstalledSkills(targetDir, skillNames, record) {
+  if (skillNames.length === 0) return;
+  const meta = readInstalledMeta(targetDir);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  for (const skillName of skillNames) {
+    meta.skills[skillName] = { ...record, installedAt: now };
+  }
+  fs4.writeFileSync(getInstalledMetaPath(targetDir), JSON.stringify(meta, null, 2), "utf8");
+}
+function getAllMarketplaces(globalConfig) {
+  const result = [];
+  if (Array.isArray(globalConfig.marketplaces)) {
+    result.push(...globalConfig.marketplaces);
+  }
+  if (globalConfig.marketplace?.repoUrl) {
+    const legacyUrl = globalConfig.marketplace.repoUrl;
+    const alreadyPresent = result.some((m) => m.repoUrl === legacyUrl);
+    if (!alreadyPresent) {
+      const existingNames = new Set(result.map((m) => m.name).filter((n) => !!n));
+      let legacyName = globalConfig.marketplace.name ?? repoNameFromUrl(legacyUrl);
+      if (existingNames.has(legacyName)) {
+        let suffix = 2;
+        while (existingNames.has(`${legacyName}-${suffix}`)) suffix++;
+        legacyName = `${legacyName}-${suffix}`;
+      }
+      result.push({
+        name: legacyName,
+        repoUrl: globalConfig.marketplace.repoUrl,
+        localPath: globalConfig.marketplace.localPath,
+        token: globalConfig.marketplace.token
+      });
+    }
+  }
+  return result;
+}
+function saveMarketplaces(configPath, existing, marketplaces) {
+  const updated = { ...existing, marketplaces };
+  delete updated.marketplace;
+  writeGlobalConfig(updated, configPath);
+}
+function loadMarketplacesConfig(configPath) {
+  const existing = loadJsonFile(configPath) ?? {};
+  const all = getAllMarketplaces(existing);
+  if (existing.marketplace?.repoUrl) {
+    saveMarketplaces(configPath, existing, all);
+    warn("Migrated legacy single-marketplace config to the multi-marketplace format.");
+    delete existing.marketplace;
+  }
+  return { existing, all };
+}
+function loadMarketplaces(configPath) {
+  return loadMarketplacesConfig(configPath).all;
+}
+function upsertMarketplace(all, entry) {
+  const idxByUrl = all.findIndex((m) => m.repoUrl === entry.repoUrl);
+  const idxByName = all.findIndex((m) => m.name === entry.name);
+  if (idxByUrl !== -1) {
+    if (idxByName !== -1 && idxByName !== idxByUrl) {
+      throw new Error(`Marketplace name "${entry.name}" is already used by a different marketplace (${all[idxByName].repoUrl}). Choose a different --name.`);
+    }
+    all[idxByUrl] = { ...entry, token: entry.token ?? all[idxByUrl].token };
+  } else if (idxByName !== -1) {
+    throw new Error(`Marketplace name "${entry.name}" is already registered for a different repo (${all[idxByName].repoUrl}). Choose a different --name, or remove the existing marketplace first.`);
+  } else {
+    all.push(entry);
+  }
+}
+function cloneOrReuseMarketplace(url, resolvedPath, opts) {
+  const hasGit = fs4.existsSync(path7.join(resolvedPath, ".git"));
+  if (fs4.existsSync(resolvedPath) && !hasGit && fs4.readdirSync(resolvedPath).length > 0) {
+    throw new Error(`Directory already exists and is not a git repo: ${resolvedPath}`);
+  }
+  if (hasGit) {
+    warn(`Directory already contains a git repo at ${resolvedPath} \u2014 skipping clone, updating config and re-installing plugins.`);
+    return;
+  }
+  const branchLabel = opts.branch ?? "remote default";
+  warn(`Cloning ${url} (branch: ${branchLabel}) \u2192 ${resolvedPath}...`);
+  const cloneUrl = opts.token ? injectTokenIntoUrl(url, opts.token) : url;
+  const cloneArgs = ["clone"];
+  if (opts.branch) cloneArgs.push("--branch", opts.branch);
+  cloneArgs.push(cloneUrl, resolvedPath);
+  try {
+    execFileSync3("git", cloneArgs, { stdio: ["inherit", "inherit", "pipe"] });
+  } catch (e) {
+    let cloneActuallySucceeded = false;
+    try {
+      execFileSync3("git", ["-C", resolvedPath, "rev-parse", "HEAD"], { stdio: "pipe" });
+      cloneActuallySucceeded = true;
+    } catch {
+    }
+    if (!cloneActuallySucceeded) {
+      const msg = e instanceof Error ? e.message : String(e);
+      throw new Error(scrubToken(msg));
+    }
+  }
+}
+function pullMarketplace(marketplacePath, repoUrl, token, marketplaceName) {
+  warn(`Pulling latest content for "${marketplaceName}"...`);
+  const gitArgs = ["-C", marketplacePath];
+  if (repoUrl && token) {
+    gitArgs.push("-c", `remote.origin.url=${injectTokenIntoUrl(repoUrl, token)}`);
+  }
+  gitArgs.push("pull");
+  let pullOutput;
+  try {
+    pullOutput = execFileSync3("git", gitArgs, { encoding: "utf8", stdio: ["inherit", "pipe", "pipe"], env: { ...process.env, LANG: "C", LC_ALL: "C" } });
+  } catch (e) {
+    const msg = e instanceof Error ? e.message : String(e);
+    throw new Error(scrubToken(msg));
+  }
+  const updated = !pullOutput.includes("Already up to date");
+  if (pullOutput.trim() && updated) warn(pullOutput.trim());
+  warn(updated ? `"${marketplaceName}" updated.` : `"${marketplaceName}" already up to date \u2014 no changes to sync.`);
+  return { updated };
+}
+function installPluginsForMarketplace(marketplacePath, marketplaceName, repoUrl, pluginNames, targetDir) {
+  const results = {};
+  let totalInstalled = 0;
+  for (const pluginName of pluginNames) {
+    const skillsSrc = resolveSkillsSrc(marketplacePath, pluginName);
+    if (!fs4.existsSync(skillsSrc)) {
+      results[pluginName] = { installed: [], failed: [] };
+      warn(`No skills directory found for plugin "${pluginName}" in "${marketplaceName}" \u2014 skipping.`);
+      continue;
+    }
+    const { installed, failed } = copyPluginSkills(skillsSrc, targetDir, {
+      marketplace: marketplaceName,
+      plugin: pluginName,
+      installedFrom: repoUrl ?? ""
+    });
+    results[pluginName] = { installed, failed };
+    totalInstalled += installed.length;
+    for (const skill of installed) {
+      warn(`  ${skill}: ${path7.join(skillsSrc, skill)} \u2192 ${path7.join(targetDir, skill)}`);
+    }
+    if (failed.length > 0) {
+      warn(`Skipped ${failed.length} skill(s) with invalid names in "${pluginName}": ${failed.join(", ")}`);
+    }
+  }
+  return { results, totalInstalled };
+}
+function installAllPlugins(resolvedPath, marketplaceName, url, targetDir) {
+  const pluginChoices = resolvePluginChoices(resolvedPath);
+  if (pluginChoices.length === 0) {
+    warn("No plugins found in marketplace. Check the marketplace repository structure.");
+    return { pluginResults: {}, totalInstalled: 0 };
+  }
+  warn(`Installing ${pluginChoices.length} plugin(s) to ${targetDir}...`);
+  const { results, totalInstalled } = installPluginsForMarketplace(resolvedPath, marketplaceName, url, pluginChoices.map((p) => p.name), targetDir);
+  return { pluginResults: results, totalInstalled };
+}
+function syncMarketplacePlugins(m, targetDir, force, pluginFilter) {
+  const marketplaceName = marketplaceLabel(m);
+  try {
+    const marketplacePath = m.localPath;
+    if (!marketplacePath || !fs4.existsSync(marketplacePath)) {
+      warn(`Marketplace "${marketplaceName}" local path not found \u2014 skipping.`);
+      return { marketplace: marketplaceName, skipped: true, message: "Local path not found." };
+    }
+    const { updated } = pullMarketplace(marketplacePath, m.repoUrl, m.token, marketplaceName);
+    if (!updated && !force) {
+      return { marketplace: marketplaceName, marketplaceUpdated: false, skipped: true, message: "No changes detected \u2014 skipping install. Use --force to reinstall anyway." };
+    }
+    const pluginChoices = resolvePluginChoices(marketplacePath);
+    if (pluginChoices.length === 0) {
+      warn(`No plugins found in marketplace "${marketplaceName}" \u2014 skipping.`);
+      return { marketplace: marketplaceName, skipped: true, message: "No plugins found." };
+    }
+    let pluginNames;
+    if (pluginFilter === "all") {
+      pluginNames = pluginChoices.map((p) => p.name);
+    } else if (pluginChoices.some((p) => p.name === pluginFilter)) {
+      pluginNames = [pluginFilter];
+    } else {
+      warn(`Plugin "${pluginFilter}" not found in "${marketplaceName}" \u2014 skipping.`);
+      return { marketplace: marketplaceName, skipped: true, message: `Plugin "${pluginFilter}" not found.` };
+    }
+    const { results, totalInstalled } = installPluginsForMarketplace(marketplacePath, marketplaceName, m.repoUrl, pluginNames, targetDir);
+    return { marketplace: marketplaceName, plugins: results, total: totalInstalled, marketplaceUpdated: updated };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    warn(`Marketplace "${marketplaceName}" failed \u2014 skipping. ${message}`);
+    return { marketplace: marketplaceName, skipped: true, error: message };
+  }
+}
+async function marketplaceAddAction(url, localPath, opts, commandName) {
+  const start = Date.now();
+  try {
+    const resolvedPath = path7.resolve(localPath ?? defaultMarketplacePath(url));
+    const marketplaceName = opts.name ?? repoNameFromUrl(url);
+    cloneOrReuseMarketplace(url, resolvedPath, opts);
+    const configPath = getGlobalConfigPath();
+    const { existing, all } = loadMarketplacesConfig(configPath);
+    const entry = {
+      name: marketplaceName,
+      repoUrl: url,
+      localPath: resolvedPath,
+      ...opts.token ? { token: opts.token } : {}
+    };
+    upsertMarketplace(all, entry);
+    saveMarketplaces(configPath, existing, all);
+    const targetDir = resolveAgentPaths(resolveAgentName(opts)).user;
+    const { pluginResults, totalInstalled } = installAllPlugins(resolvedPath, marketplaceName, url, targetDir);
+    success({
+      name: marketplaceName,
+      repoUrl: url,
+      localPath: resolvedPath,
+      branch: opts.branch ?? null,
+      tokenConfigured: !!opts.token,
+      plugins: pluginResults,
+      total: totalInstalled,
+      target: targetDir
+    }, "skills", commandName, start);
+  } catch (err) {
+    fail(err, "skills", commandName, start);
+  }
+}
 function registerSkillsCommands(program2) {
   const skills = program2.command("skills").description("Manage pncli Claude Code skills");
   skills.command("install").description("Install pncli skills into the current repo").option("--agent <agent>", "Target agent host: github-copilot | claude-code", "github-copilot").option("--scope <scope>", "Installation scope: project | user", "project").option("--target <dir>", "Override install directory (ignores --agent and --scope)").action((opts) => {
@@ -8314,10 +9132,7 @@ function registerSkillsCommands(program2) {
       if (opts.target) {
         targetDir = path7.resolve(opts.target);
       } else {
-        const agentConfig = AGENT_PATHS[opts.agent];
-        if (!agentConfig) {
-          throw new Error(`Unknown agent: "${opts.agent}". Use: ${Object.keys(AGENT_PATHS).join(" | ")}`);
-        }
+        const agentConfig = resolveAgentPaths(opts.agent);
         const scopePath = opts.scope === "user" ? agentConfig.user : agentConfig.project;
         targetDir = path7.resolve(scopePath);
       }
@@ -8367,6 +9182,7 @@ function registerSkillsCommands(program2) {
       if (failed.length > 0) {
         warn(`Failed to install: ${failed.join(", ")}`);
       }
+      recordInstalledSkills(targetDir, installed, { source: "bundled" });
       success({
         installed,
         failed,
@@ -8387,10 +9203,7 @@ function registerSkillsCommands(program2) {
       if (opts.target) {
         targetDir = path7.resolve(opts.target);
       } else {
-        const agentConfig = AGENT_PATHS[opts.agent];
-        if (!agentConfig) {
-          throw new Error(`Unknown agent: "${opts.agent}". Use: ${Object.keys(AGENT_PATHS).join(" | ")}`);
-        }
+        const agentConfig = resolveAgentPaths(opts.agent);
         const scopePath = opts.scope === "user" ? agentConfig.user : agentConfig.project;
         targetDir = path7.resolve(scopePath);
       }
@@ -8398,7 +9211,9 @@ function registerSkillsCommands(program2) {
         success({ skills: [], message: `No skills directory found at ${targetDir}. Run: pncli skills install` }, "skills", "list", start);
         return;
       }
+      const meta = readInstalledMeta(targetDir);
       const skillDirs = fs4.readdirSync(targetDir).filter((name) => {
+        if (name.startsWith(".")) return false;
         const skillPath = path7.join(targetDir, name, "SKILL.md");
         return fs4.existsSync(skillPath);
       });
@@ -8433,7 +9248,8 @@ function registerSkillsCommands(program2) {
           category: metadata.category || data.category || "other",
           services: metadata.services || data.services || "",
           providers: metadata.providers || data.providers || "none",
-          userInvocable: data["user-invocable"] === "true"
+          userInvocable: data["user-invocable"] === "true",
+          installed: meta.skills[name] ?? null
         };
       });
       success({ skills: skillsList, total: skillsList.length }, "skills", "list", start);
@@ -8441,193 +9257,217 @@ function registerSkillsCommands(program2) {
       fail(err, "skills", "list", start);
     }
   });
-  const marketplace = skills.command("marketplace").description("Manage a git-hosted skills marketplace");
-  marketplace.command("setup").description("Clone a skills marketplace repo, register it in global config, and install all plugins").argument("<url>", "Git clone URL of the marketplace repository").argument("[localPath]", "Local directory to clone into (default: ~/.agents/marketplaces/<repo-name>)").option("--branch <branch>", "Branch to clone (default: remote HEAD)").option("--token <token>", "HTTP access token for authenticated clone and pull (GitHub PAT or Bitbucket token)").option("--agent <agent>", "Target agent host for plugin install: github-copilot | claude-code (default: github-copilot)").option("--claude", "Shorthand for --agent claude-code").action(async (url, localPath, opts) => {
+  skills.command("uninstall").description("Uninstall a skill (defaults to user scope, matching the marketplace install target; pass --scope project for skills installed via `skills install`)").argument("<name>", "Skill name to uninstall (the directory name under your skills folder)").option("--agent <agent>", "Target agent host: github-copilot | claude-code", "github-copilot").option("--scope <scope>", "Installation scope to uninstall from: project | user", "user").option("--claude", "Shorthand for --agent claude-code").option("--target <dir>", "Override skills directory").action((name, opts) => {
     const start = Date.now();
     try {
-      const resolvedPath = path7.resolve(localPath ?? defaultMarketplacePath(url));
-      const hasGit = fs4.existsSync(path7.join(resolvedPath, ".git"));
-      if (fs4.existsSync(resolvedPath) && !hasGit && fs4.readdirSync(resolvedPath).length > 0) {
-        throw new Error(`Directory already exists and is not a git repo: ${resolvedPath}`);
-      }
-      if (hasGit) {
-        warn(`Directory already contains a git repo at ${resolvedPath} \u2014 skipping clone, updating config and re-installing plugins.`);
+      let targetDir;
+      if (opts.target) {
+        targetDir = path7.resolve(opts.target);
       } else {
-        const branchLabel = opts.branch ?? "remote default";
-        warn(`Cloning ${url} (branch: ${branchLabel}) \u2192 ${resolvedPath}...`);
-        const cloneUrl = opts.token ? injectTokenIntoUrl(url, opts.token) : url;
-        const cloneArgs = ["clone"];
-        if (opts.branch) cloneArgs.push("--branch", opts.branch);
-        cloneArgs.push(cloneUrl, resolvedPath);
-        try {
-          execFileSync3("git", cloneArgs, { stdio: ["inherit", "inherit", "pipe"] });
-        } catch (e) {
-          const msg = e instanceof Error ? e.message : String(e);
-          throw new Error(msg.replace(/x-(?:token-auth|access-token):[^@]+@/g, "x-token-auth:***@"));
-        }
+        const agentConfig = resolveAgentPaths(resolveAgentName(opts));
+        const scopePath = opts.scope === "project" ? agentConfig.project : agentConfig.user;
+        targetDir = path7.resolve(scopePath);
       }
+      const resolvedTarget = path7.resolve(targetDir);
+      const skillDir = path7.resolve(targetDir, name);
+      if (!skillDir.startsWith(resolvedTarget + path7.sep)) {
+        throw new Error(`Invalid skill name: "${name}"`);
+      }
+      if (!fs4.existsSync(skillDir)) {
+        throw new Error(`Skill "${name}" not found at ${skillDir}`);
+      }
+      const meta = readInstalledMeta(targetDir);
+      const record = meta.skills[name];
+      fs4.rmSync(skillDir, { recursive: true, force: true });
+      delete meta.skills[name];
+      fs4.writeFileSync(getInstalledMetaPath(targetDir), JSON.stringify(meta, null, 2), "utf8");
+      success({
+        uninstalled: name,
+        target: targetDir,
+        wasTracked: !!record,
+        ...record ? { installedFrom: record } : {}
+      }, "skills", "uninstall", start);
+    } catch (err) {
+      fail(err, "skills", "uninstall", start);
+    }
+  });
+  const marketplace = skills.command("marketplace").description("Manage git-hosted skills marketplaces");
+  function withMarketplaceAddOptions(cmd) {
+    return cmd.argument("<url>", "Git clone URL of the marketplace repository").argument("[localPath]", "Local directory to clone into (default: ~/.agents/marketplaces/<repo-name>)").option("--name <name>", "Human-readable name for this marketplace (default: derived from URL)").option("--branch <branch>", "Branch to clone (default: remote HEAD)").option("--token <token>", "HTTP access token for authenticated clone and pull (GitHub PAT or Bitbucket token)").option("--agent <agent>", "Target agent host for plugin install: github-copilot | claude-code (default: github-copilot)").option("--claude", "Shorthand for --agent claude-code");
+  }
+  withMarketplaceAddOptions(
+    marketplace.command("add").description("Register a new marketplace, clone it, and install all its plugins")
+  ).action((url, localPath, opts) => marketplaceAddAction(url, localPath, opts, "marketplace-add"));
+  withMarketplaceAddOptions(
+    marketplace.command("setup").description("Alias for `marketplace add` \u2014 clone a marketplace and install all its plugins")
+  ).action((url, localPath, opts) => marketplaceAddAction(url, localPath, opts, "marketplace-setup"));
+  marketplace.command("list").description("List all registered marketplaces").action(() => {
+    const start = Date.now();
+    try {
       const configPath = getGlobalConfigPath();
-      const existing = loadJsonFile(configPath) ?? {};
-      existing.marketplace = { repoUrl: url, localPath: resolvedPath, ...opts.token ? { token: opts.token } : {} };
-      writeGlobalConfig(existing, configPath);
-      const agentName = opts.claude ? "claude-code" : opts.agent ?? "github-copilot";
-      const agentConfig = AGENT_PATHS[agentName];
-      if (!agentConfig) {
-        throw new Error(`Unknown agent: "${agentName}". Use: ${Object.keys(AGENT_PATHS).join(" | ")}`);
-      }
-      const targetDir = agentConfig.user;
-      const pluginChoices = resolvePluginChoices(resolvedPath);
-      const pluginResults = {};
-      let totalInstalled = 0;
-      if (pluginChoices.length === 0) {
-        warn("No plugins found in marketplace. Check the marketplace repository structure.");
-      } else {
-        warn(`Installing ${pluginChoices.length} plugin(s) to ${targetDir}...`);
-        for (const pluginChoice of pluginChoices) {
-          const skillsSrc = resolveSkillsSrc(resolvedPath, pluginChoice.name);
-          if (!fs4.existsSync(skillsSrc)) {
-            pluginResults[pluginChoice.name] = { installed: [], failed: [] };
-            warn(`No skills directory found for plugin "${pluginChoice.name}" \u2014 skipping.`);
-            continue;
-          }
-          const { installed, failed } = copyPluginSkills(skillsSrc, targetDir);
-          pluginResults[pluginChoice.name] = { installed, failed };
-          totalInstalled += installed.length;
-          for (const skill of installed) {
-            warn(`  ${skill}: ${path7.join(skillsSrc, skill)} \u2192 ${path7.join(targetDir, skill)}`);
-          }
-          if (failed.length > 0) {
-            warn(`Skipped ${failed.length} skill(s) with invalid names in "${pluginChoice.name}": ${failed.join(", ")}`);
-          }
-        }
+      const all = loadMarketplaces(configPath);
+      success({
+        marketplaces: all.map((m) => ({
+          name: marketplaceLabel(m),
+          repoUrl: m.repoUrl,
+          localPath: m.localPath,
+          tokenConfigured: !!m.token
+        })),
+        total: all.length
+      }, "skills", "marketplace-list", start);
+    } catch (err) {
+      fail(err, "skills", "marketplace-list", start);
+    }
+  });
+  marketplace.command("plugins").description("List the plugins available in a registered marketplace").argument("<name>", "Marketplace name (or repo URL) to inspect").action((name) => {
+    const start = Date.now();
+    try {
+      const configPath = getGlobalConfigPath();
+      const all = loadMarketplaces(configPath);
+      const found = all.find((m) => m.name === name || m.repoUrl === name);
+      if (!found) {
+        throw new Error(`Marketplace "${name}" not found. Run: pncli skills marketplace list`);
       }
+      if (!found.localPath || !fs4.existsSync(found.localPath)) {
+        throw new Error(`Marketplace "${marketplaceLabel(found)}" local path not found at ${found.localPath ?? "(not set)"}. Run: pncli skills marketplace add <url>`);
+      }
+      const plugins = resolvePluginChoices(found.localPath);
       success({
-        repoUrl: url,
-        localPath: resolvedPath,
-        branch: opts.branch ?? null,
-        tokenConfigured: !!opts.token,
-        plugins: pluginResults,
-        total: totalInstalled,
-        target: targetDir
-      }, "skills", "marketplace-setup", start);
+        marketplace: marketplaceLabel(found),
+        plugins,
+        total: plugins.length
+      }, "skills", "marketplace-plugins", start);
     } catch (err) {
-      fail(err, "skills", "marketplace-setup", start);
+      fail(err, "skills", "marketplace-plugins", start);
     }
   });
-  marketplace.command("sync").description("Pull latest marketplace content and install a plugin's skills").argument("[plugin]", 'Plugin name to install, or "all" to install every plugin (skips interactive selection)').option("--agent <agent>", "Target agent host: github-copilot | claude-code (default: github-copilot)").option("--claude", "Shorthand for --agent claude-code").option("--force", "Force reinstall even if the marketplace repo has no new changes").action(async (plugin, opts) => {
+  marketplace.command("remove").description("Remove a registered marketplace from the config (does not delete the local clone)").argument("<name>", "Name of the marketplace to remove").action((name) => {
     const start = Date.now();
     try {
       const configPath = getGlobalConfigPath();
-      const globalConfig = loadJsonFile(configPath) ?? {};
-      const marketplacePath = globalConfig.marketplace?.localPath;
-      if (!marketplacePath || !fs4.existsSync(marketplacePath)) {
-        throw new Error("Marketplace not configured. Run: pncli skills marketplace setup <url> <localPath>");
-      }
-      warn("Pulling latest marketplace content...");
-      const repoUrl = globalConfig.marketplace?.repoUrl;
-      const token = globalConfig.marketplace?.token;
-      const gitArgs = ["-C", marketplacePath];
-      if (repoUrl && token) {
-        gitArgs.push("-c", `remote.origin.url=${injectTokenIntoUrl(repoUrl, token)}`);
-      }
-      gitArgs.push("pull");
-      let pullOutput;
-      try {
-        pullOutput = execFileSync3("git", gitArgs, { encoding: "utf8", stdio: ["inherit", "pipe", "pipe"], env: { ...process.env, LANG: "C", LC_ALL: "C" } });
-      } catch (e) {
-        const msg = e instanceof Error ? e.message : String(e);
-        throw new Error(msg.replace(/x-(?:token-auth|access-token):[^@]+@/g, "x-token-auth:***@"));
-      }
-      const marketplaceUpdated = !pullOutput.includes("Already up to date");
-      if (pullOutput.trim() && marketplaceUpdated) {
-        warn(pullOutput.trim());
-      }
-      warn(marketplaceUpdated ? "Marketplace updated." : "Marketplace already up to date \u2014 no changes to sync.");
-      const pluginChoices = resolvePluginChoices(marketplacePath);
-      if (pluginChoices.length === 0) {
-        throw new Error("No plugins found in marketplace. Check the marketplace repository structure.");
-      }
-      const agentName = opts.claude ? "claude-code" : opts.agent ?? "github-copilot";
-      const agentConfig = AGENT_PATHS[agentName];
-      if (!agentConfig) {
-        throw new Error(`Unknown agent: "${agentName}". Use: ${Object.keys(AGENT_PATHS).join(" | ")}`);
-      }
-      const targetDir = agentConfig.user;
-      let selectedPlugin;
-      if (plugin) {
-        if (plugin !== "all" && !pluginChoices.some((p) => p.name === plugin)) {
-          throw new Error(`Plugin "${plugin}" not found. Available: ${pluginChoices.map((p) => p.name).join(", ")}`);
+      const { existing, all } = loadMarketplacesConfig(configPath);
+      const idx = all.findIndex((m) => m.name === name || m.repoUrl === name);
+      if (idx === -1) {
+        throw new Error(`Marketplace "${name}" not found. Run: pncli skills marketplace list`);
+      }
+      const removed = all.splice(idx, 1)[0];
+      saveMarketplaces(configPath, existing, all);
+      success({
+        removed: {
+          name: marketplaceLabel(removed),
+          repoUrl: removed.repoUrl,
+          localPath: removed.localPath
+        },
+        remaining: all.length
+      }, "skills", "marketplace-remove", start);
+    } catch (err) {
+      fail(err, "skills", "marketplace-remove", start);
+    }
+  });
+  marketplace.command("sync").description("Pull latest marketplace content and install plugin skills").argument("[plugin]", 'Plugin name to install, or "all" to install every plugin (skips interactive selection)').option("--marketplace <name>", 'Marketplace name to sync, or "all" to sync every registered marketplace (skips interactive selection)').option("--agent <agent>", "Target agent host: github-copilot | claude-code (default: github-copilot)").option("--claude", "Shorthand for --agent claude-code").option("--force", 'Reinstall even if a marketplace has no new changes (applies to single-plugin and "all" installs alike)').action(async (plugin, opts) => {
+    const start = Date.now();
+    try {
+      const configPath = getGlobalConfigPath();
+      const allMarketplaces = loadMarketplaces(configPath);
+      if (allMarketplaces.length === 0) {
+        throw new Error("No marketplaces configured. Run: pncli skills marketplace add <url>");
+      }
+      const targetDir = resolveAgentPaths(resolveAgentName(opts)).user;
+      const force = opts.force ?? false;
+      if (opts.marketplace === "all") {
+        const results = allMarketplaces.map((m) => syncMarketplacePlugins(m, targetDir, force, plugin ?? "all"));
+        success({ allMarketplaces: true, marketplaces: results, target: targetDir }, "skills", "marketplace-sync", start);
+        return;
+      }
+      let selectedMarketplace;
+      let selectedPlugin = plugin;
+      const canGoBack = !opts.marketplace && allMarketplaces.length > 1;
+      if (opts.marketplace) {
+        const found = allMarketplaces.find((m) => m.name === opts.marketplace || m.repoUrl === opts.marketplace);
+        if (!found) {
+          throw new Error(`Marketplace "${opts.marketplace}" not found. Run: pncli skills marketplace list`);
         }
-        selectedPlugin = plugin;
-      } else {
-        selectedPlugin = await select({
-          message: "Select a plugin to install:",
-          choices: [
+        selectedMarketplace = found;
+      } else if (allMarketplaces.length === 1) {
+        selectedMarketplace = allMarketplaces[0];
+      }
+      for (; ; ) {
+        if (!selectedMarketplace) {
+          assertInteractive(`Multiple marketplaces are registered (${allMarketplaces.map(marketplaceLabel).join(", ")}). Pass --marketplace <name> (or --marketplace all) to run this non-interactively.`);
+          const chosen = await select({
+            message: "Select a marketplace to sync:",
+            choices: [
+              { value: ALL_MARKETPLACES, name: "All marketplaces \u2014 sync every plugin from every marketplace" },
+              // Index-based values: labels alone aren't guaranteed unique (two marketplaces can share a derived name).
+              ...allMarketplaces.map((m, i) => ({ value: String(i), name: `${marketplaceLabel(m)} \u2014 ${m.repoUrl ?? ""}` }))
+            ]
+          });
+          if (chosen === ALL_MARKETPLACES) {
+            const results2 = allMarketplaces.map((m) => syncMarketplacePlugins(m, targetDir, force, selectedPlugin ?? "all"));
+            success({ allMarketplaces: true, marketplaces: results2, target: targetDir }, "skills", "marketplace-sync", start);
+            return;
+          }
+          selectedMarketplace = allMarketplaces[Number(chosen)];
+          if (!selectedMarketplace) {
+            throw new Error(`Marketplace "${chosen}" not found.`);
+          }
+        }
+        const marketplaceName = marketplaceLabel(selectedMarketplace);
+        const marketplacePath = selectedMarketplace.localPath;
+        if (!marketplacePath || !fs4.existsSync(marketplacePath)) {
+          throw new Error(`Marketplace "${marketplaceName}" local path not found at ${marketplacePath ?? "(not set)"}. Run: pncli skills marketplace add <url>`);
+        }
+        const { updated } = pullMarketplace(marketplacePath, selectedMarketplace.repoUrl, selectedMarketplace.token, marketplaceName);
+        const pluginChoices = resolvePluginChoices(marketplacePath);
+        if (pluginChoices.length === 0) {
+          throw new Error(`No plugins found in marketplace "${marketplaceName}". Check the marketplace repository structure.`);
+        }
+        if (!selectedPlugin) {
+          assertInteractive(`Pass a plugin name (or "all") to run this non-interactively.`);
+          const choices = [
             { value: "all", name: "All \u2014 install every plugin" },
-            ...pluginChoices.map((p) => ({
-              value: p.name,
-              name: p.description ? `${p.name} \u2014 ${p.description}` : p.name
-            }))
-          ]
-        });
-      }
-      if (selectedPlugin === "all") {
-        if (!marketplaceUpdated && !opts.force) {
+            ...pluginChoices.map((p) => ({ value: p.name, name: p.description ? `${p.name} \u2014 ${p.description}` : p.name }))
+          ];
+          if (canGoBack) {
+            choices.push({ value: BACK, name: "\u2190 Back to marketplace selection" });
+          }
+          const chosen = await select({ message: `Select a plugin from "${marketplaceName}" to install:`, choices });
+          if (chosen === BACK) {
+            selectedMarketplace = void 0;
+            continue;
+          }
+          selectedPlugin = chosen;
+        } else if (selectedPlugin !== "all" && !pluginChoices.some((p) => p.name === selectedPlugin)) {
+          throw new Error(`Plugin "${selectedPlugin}" not found in "${marketplaceName}". Available: ${pluginChoices.map((p) => p.name).join(", ")}`);
+        }
+        if (!updated && !force) {
           success({
-            marketplace: marketplacePath,
+            marketplace: marketplaceName,
             marketplaceUpdated: false,
             updated: false,
             skipped: true,
-            message: "No marketplace changes detected \u2014 skipping install."
+            message: `No changes detected in "${marketplaceName}" \u2014 skipping install. Use --force to reinstall anyway.`
           }, "skills", "marketplace-sync", start);
           return;
         }
-        const results = {};
-        let totalInstalled = 0;
-        for (const pluginChoice of pluginChoices) {
-          const skillsSrc2 = resolveSkillsSrc(marketplacePath, pluginChoice.name);
-          if (!fs4.existsSync(skillsSrc2)) {
-            results[pluginChoice.name] = { installed: [], failed: [] };
-            warn(`No skills directory found for plugin "${pluginChoice.name}" \u2014 skipping.`);
-            continue;
-          }
-          const { installed: installed2, failed: failed2 } = copyPluginSkills(skillsSrc2, targetDir);
-          results[pluginChoice.name] = { installed: installed2, failed: failed2 };
-          totalInstalled += installed2.length;
-          for (const skill of installed2) {
-            warn(`  ${skill}: ${path7.join(skillsSrc2, skill)} \u2192 ${path7.join(targetDir, skill)}`);
-          }
-          if (failed2.length > 0) {
-            warn(`Skipped ${failed2.length} skill(s) with invalid names in "${pluginChoice.name}": ${failed2.join(", ")}`);
-          }
+        const pluginNames = selectedPlugin === "all" ? pluginChoices.map((p) => p.name) : [selectedPlugin];
+        const { results, totalInstalled } = installPluginsForMarketplace(marketplacePath, marketplaceName, selectedMarketplace.repoUrl, pluginNames, targetDir);
+        if (selectedPlugin === "all") {
+          success({ marketplace: marketplaceName, plugins: results, total: totalInstalled, target: targetDir, marketplaceUpdated: updated }, "skills", "marketplace-sync", start);
+        } else {
+          const single = results[selectedPlugin] ?? { installed: [], failed: [] };
+          success({
+            marketplace: marketplaceName,
+            plugin: selectedPlugin,
+            installed: single.installed,
+            failed: single.failed,
+            total: single.installed.length,
+            target: targetDir,
+            marketplaceUpdated: updated
+          }, "skills", "marketplace-sync", start);
         }
-        success({
-          plugins: results,
-          total: totalInstalled,
-          target: targetDir,
-          marketplaceUpdated
-        }, "skills", "marketplace-sync", start);
         return;
       }
-      const skillsSrc = resolveSkillsSrc(marketplacePath, selectedPlugin);
-      if (!fs4.existsSync(skillsSrc)) {
-        throw new Error(`No skills directory found at ${skillsSrc}`);
-      }
-      const { installed, failed } = copyPluginSkills(skillsSrc, targetDir);
-      for (const skill of installed) {
-        warn(`  ${skill}: ${path7.join(skillsSrc, skill)} \u2192 ${path7.join(targetDir, skill)}`);
-      }
-      if (failed.length > 0) {
-        warn(`Skipped ${failed.length} skill(s) with invalid names: ${failed.join(", ")}`);
-      }
-      success({
-        plugin: selectedPlugin,
-        installed,
-        failed,
-        total: installed.length,
-        target: targetDir,
-        marketplaceUpdated
-      }, "skills", "marketplace-sync", start);
     } catch (err) {
       fail(err, "skills", "marketplace-sync", start);
     }
@@ -8658,7 +9498,7 @@ function resolveSkillsSrc(marketplacePath, selectedPlugin) {
   }
   return skillsSrc;
 }
-function copyPluginSkills(skillsSrc, targetDir) {
+function copyPluginSkills(skillsSrc, targetDir, meta) {
   fs4.mkdirSync(targetDir, { recursive: true });
   const resolvedTarget = path7.resolve(targetDir);
   const skillNames = fs4.readdirSync(skillsSrc).filter(
@@ -8676,6 +9516,14 @@ function copyPluginSkills(skillsSrc, targetDir) {
     fs4.cpSync(path7.join(skillsSrc, skillName), dest, { recursive: true });
     installed.push(skillName);
   }
+  if (meta) {
+    recordInstalledSkills(targetDir, installed, {
+      source: "marketplace",
+      marketplace: meta.marketplace,
+      plugin: meta.plugin,
+      installedFrom: meta.installedFrom
+    });
+  }
   return { installed, failed };
 }