code-context-control 2.88.2__tar.gz → 2.89.1__tar.gz

{code_context_control-2.88.2/code_context_control.egg-info → code_context_control-2.89.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-context-control
-Version: 2.88.2
+Version: 2.89.1
 Summary: Local MCP code-intelligence for AI coding tools: surgical search/read/edit, agent-config version history, path-level access + masking guards, and a multi-project hub.
 Author-email: Dimitri Tselenchuk <dtselenc@gmail.com>
 License-Expression: Apache-2.0

{code_context_control-2.88.2 → code_context_control-2.89.1}/cli/c3.py

@@ -92,7 +92,7 @@ console = Console() if HAS_RICH else None
 # Config
 CONFIG_DIR = ".c3"
 CONFIG_FILE = ".c3/config.json"
-__version__ = "2.88.2"
+__version__ = "2.89.1"
 
 
 def _compress_file_cli(compressor, path, mode="smart", **kw):
@@ -4555,14 +4555,22 @@ def _ensure_global_session_fallbacks(server_script: str, c3_mcp_exe: str | None
             print(f"Warning: Could not update {antigravity_path} (global fallback skipped)")
 
 
-def _uninstall_mcp_all(project_path: str):
-    """Remove C3 MCP server configurations from all supported IDEs."""
+def _uninstall_mcp_all(project_path: str, include_global: bool = True):
+    """Remove C3 MCP server configurations from all supported IDEs.
+
+    ``include_global=False`` restricts removal to PROJECT-scoped config files
+    (the project's .mcp.json, .codex/config.toml, settings/hooks). Home-level
+    configs (~/.codex, Antigravity's mcp_config.json) are machine-wide and
+    shared by every C3 project, so per-project cleanup — the merge action's
+    ``cleanup='clear'`` — must never touch them; only a real machine
+    uninstall (the default) may."""
     import shutil
     from pathlib import Path
 
     from core.ide import PROFILES
 
-    print("\nRemoving C3 MCP server configurations...")
+    scope = "" if include_global else " (project-scoped only)"
+    print(f"\nRemoving C3 MCP server configurations...{scope}")
     target = Path(project_path).resolve()
 
     # Remove .mcp.json if it exists (standard MCP config file)
@@ -4587,11 +4595,12 @@ def _uninstall_mcp_all(project_path: str):
         # MCP Config paths to check
         config_paths = []
         if profile.config_path_global:
-            config_paths.append(Path.home() / profile.config_path)
+            if include_global:
+                config_paths.append(Path.home() / profile.config_path)
         else:
             config_paths.append(target / profile.config_path)
             # For Codex, also check the global fallback in home dir
-            if ide_name == "codex":
+            if ide_name == "codex" and include_global:
                 config_paths.append(Path.home() / profile.config_path)
 
         for mcp_config_path in config_paths:
@@ -4714,8 +4723,10 @@ def _uninstall_mcp_all(project_path: str):
                     print(f"  Warning: Could not update {vscode_settings_path}: {e}")
 
     # Legacy Gemini CLI configs (profile removed in v2.52) — still strip the c3 entry.
-    for legacy_cfg in (target / ".gemini" / "settings.json",
-                       Path.home() / ".gemini" / "settings.json"):
+    legacy_cfgs = [target / ".gemini" / "settings.json"]
+    if include_global:
+        legacy_cfgs.append(Path.home() / ".gemini" / "settings.json")
+    for legacy_cfg in legacy_cfgs:
         if not legacy_cfg.exists():
             continue
         try:

{code_context_control-2.88.2 → code_context_control-2.89.1}/cli/guide/bitbucket.html

@@ -266,6 +266,8 @@ c3_bitbucket(action=<span class="str">'get_pr'</span>, pr_id=<span class="num">4
           <tr><td class="grp-read"><code>get_pr</code></td>       <td><code>project, repo, pr_id</code></td><td>Full PR detail incl. version, reviewers, description, open-tasks</td></tr>
           <tr><td class="grp-read"><code>get_pr_diff</code></td>  <td><code>project, repo, pr_id, context_lines?</code></td><td>Unified diff (truncated to 6000 chars in the response)</td></tr>
           <tr><td class="grp-read"><code>get_pr_activities</code></td><td><code>project, repo, pr_id</code></td><td>PR event timeline (comments, approvals, reviewer changes)</td></tr>
+          <tr><td class="grp-read"><code>get_pr_commits</code></td><td><code>project, repo, pr_id</code></td><td>Commits on the PR, newest first</td></tr>
+          <tr><td class="grp-read"><code>list_pr_tasks</code></td><td><code>project, repo, pr_id, state?</code></td><td>PR tasks (BLOCKER-severity comments); <code>state=OPEN|RESOLVED</code> filters</td></tr>
           <tr><td class="grp-read"><code>list_branches</code></td><td><code>project, repo, filter?</code></td><td>Branches with ahead/behind counts and default-branch flag</td></tr>
           <tr><td class="grp-read"><code>list_commits</code></td> <td><code>project, repo, branch?, path?, limit?</code></td><td>Commit log on a branch / path</td></tr>
           <tr><td class="grp-read"><code>list_activity</code></td><td><code>project, repo, limit?</code></td><td>Repo activity feed (commit-based)</td></tr>
@@ -278,9 +280,15 @@ c3_bitbucket(action=<span class="str">'get_pr'</span>, pr_id=<span class="num">4
         <thead><tr><th>Action</th><th>Args</th><th>Description</th></tr></thead>
         <tbody>
           <tr><td class="grp-write"><code>create_pr</code></td>   <td><code>title, from_branch, to_branch, description?, reviewers?</code></td><td>Open a new PR. <code>reviewers</code> may be a list or comma-separated string.</td></tr>
+          <tr><td class="grp-write"><code>update_pr</code></td>   <td><code>pr_id, title?, description?, to_branch?, reviewers?</code></td><td>Edit an open PR. Unchanged fields are merged from the live PR; the current version is auto-fetched. <code>reviewers</code> is the full replacement set.</td></tr>
           <tr><td class="grp-write"><code>comment_pr</code></td>  <td><code>pr_id, body</code></td>            <td>Add a top-level comment</td></tr>
+          <tr><td class="grp-write"><code>update_pr_comment</code></td><td><code>pr_id, comment_id, body</code></td><td>Edit a comment's text. The comment's current version is auto-fetched.</td></tr>
+          <tr><td class="grp-write"><code>delete_pr_comment</code></td><td><code>pr_id, comment_id</code></td> <td>Delete a comment (version auto-fetched)</td></tr>
+          <tr><td class="grp-write"><code>create_pr_task</code></td><td><code>pr_id, body</code></td>          <td>Open a task on the PR — a BLOCKER-severity comment that gates merge</td></tr>
+          <tr><td class="grp-write"><code>resolve_pr_task</code></td><td><code>pr_id, comment_id</code></td>   <td>Resolve a task by its id (from <code>list_pr_tasks</code>)</td></tr>
           <tr><td class="grp-write"><code>approve_pr</code></td>  <td><code>pr_id</code></td>                  <td>Mark the PR approved as the current user</td></tr>
           <tr><td class="grp-write"><code>unapprove_pr</code></td><td><code>pr_id</code></td>                  <td>Withdraw approval</td></tr>
+          <tr><td class="grp-write"><code>needs_work_pr</code></td><td><code>pr_id</code></td>                 <td>Mark the PR "needs work" as the current user (the third reviewer verdict)</td></tr>
           <tr><td class="grp-write"><code>decline_pr</code></td>  <td><code>pr_id</code></td>                  <td>Decline the PR. Auto-fetches the current PR version first.</td></tr>
           <tr><td class="grp-write"><code>merge_pr</code></td>    <td><code>pr_id, message?</code></td>        <td>Merge the PR. Auto-fetches the current PR version first; logs to the C3 edit ledger.</td></tr>
         </tbody>
@@ -365,9 +373,10 @@ c3_bitbucket(action=<span class="str">'get_pr'</span>, pr_id=<span class="num">4
       <table class="params-table">
         <thead><tr><th>Action</th><th>Why it's logged</th></tr></thead>
         <tbody>
-          <tr><td><code>create_pr</code></td>            <td>New PR opened — relevant for review timeline</td></tr>
-          <tr><td><code>comment_pr</code></td>           <td>Discussion contribution worth recovering on / clear</td></tr>
-          <tr><td><code>approve_pr</code> / <code>unapprove_pr</code></td><td>Reviewer state changes</td></tr>
+          <tr><td><code>create_pr</code> / <code>update_pr</code></td><td>PR opened or its title/description/reviewers/target edited — relevant for review timeline</td></tr>
+          <tr><td><code>comment_pr</code> / <code>update_pr_comment</code> / <code>delete_pr_comment</code></td><td>Discussion contributions worth recovering on / clear</td></tr>
+          <tr><td><code>create_pr_task</code> / <code>resolve_pr_task</code></td><td>Merge-gating task opened or closed</td></tr>
+          <tr><td><code>approve_pr</code> / <code>unapprove_pr</code> / <code>needs_work_pr</code></td><td>Reviewer state changes</td></tr>
           <tr><td><code>decline_pr</code></td>           <td>PR closed without merge</td></tr>
           <tr><td><code>merge_pr</code></td>             <td>Code now lives in the target branch — high-impact</td></tr>
           <tr><td><code>create_branch</code> / <code>delete_branch</code></td><td>Branch topology changed</td></tr>

{code_context_control-2.88.2 → code_context_control-2.89.1}/cli/guide/tools.html

@@ -1217,8 +1217,10 @@ c3_artifacts(action=<span class="str">'show'</span>, artifact=<span class="str">
               <tr><td class="param-name">status</td><td>Read</td><td class="param-desc">Active account, accounts list, defaults, server-version probe</td></tr>
               <tr><td class="param-name">whoami</td><td>Read</td><td class="param-desc">Current authenticated user (PAT owner)</td></tr>
               <tr><td class="param-name">list_projects, list_repos, get_repo</td><td>Read</td><td class="param-desc">Project / repository discovery</td></tr>
-              <tr><td class="param-name">list_prs, get_pr, get_pr_diff, get_pr_activities</td><td>Read</td><td class="param-desc">PR browsing + diff + activity feed</td></tr>
-              <tr><td class="param-name">create_pr, comment_pr, approve_pr, unapprove_pr, decline_pr, merge_pr</td><td>Write</td><td class="param-desc">PR write actions. <code>merge_pr</code> and <code>decline_pr</code> auto-fetch the PR's current version</td></tr>
+              <tr><td class="param-name">list_prs, get_pr, get_pr_diff, get_pr_activities, get_pr_commits</td><td>Read</td><td class="param-desc">PR browsing + diff + activity feed + commit list</td></tr>
+              <tr><td class="param-name">create_pr, update_pr, comment_pr, approve_pr, unapprove_pr, needs_work_pr, decline_pr, merge_pr</td><td>Write</td><td class="param-desc">PR write actions. <code>update_pr</code> edits title/description/reviewers/to_branch (unchanged fields preserved); <code>merge_pr</code>, <code>decline_pr</code>, and <code>update_pr</code> auto-fetch the PR's current version; <code>needs_work_pr</code> marks "needs work" as the current user</td></tr>
+              <tr><td class="param-name">update_pr_comment, delete_pr_comment</td><td>Write</td><td class="param-desc">Edit or remove a PR comment by <code>comment_id</code> — the comment's current version is fetched automatically</td></tr>
+              <tr><td class="param-name">list_pr_tasks, create_pr_task, resolve_pr_task</td><td>Tasks</td><td class="param-desc">PR tasks (Bitbucket 7.2+ model: a task is a BLOCKER-severity comment). <code>list_pr_tasks</code> filters by <code>state=OPEN|RESOLVED</code>; resolve takes the task's <code>comment_id</code></td></tr>
               <tr><td class="param-name">list_branches, create_branch, delete_branch</td><td>Branch</td><td class="param-desc">Branch listing and admin (uses the <code>branch-utils</code> API)</td></tr>
               <tr><td class="param-name">list_commits, list_activity, build_status</td><td>Read</td><td class="param-desc">Recent commits, activity, build/CI status (defaults to default-branch HEAD)</td></tr>
               <tr><td class="param-name">repo_settings, update_repo_settings, list_webhooks, create_webhook, delete_webhook, list_permissions</td><td>Admin</td><td class="param-desc">Repository administration</td></tr>
@@ -1310,9 +1312,15 @@ c3_shell(cmd=<span class="str">'curl -H "Authorization: Bearer {{cred:API_KEY}}"
               <tr><td class="param-name">status, whoami</td><td>Read</td><td class="param-desc">Active account, deployment, defaults, server probe / authenticated user</td></tr>
               <tr><td class="param-name">search</td><td>Read</td><td class="param-desc">Raw JQL, paginated (helper-built JQL elsewhere is always quoted)</td></tr>
               <tr><td class="param-name">my_issues</td><td>Read</td><td class="param-desc">Open issues assigned to the token's user (statusCategory-aware)</td></tr>
-              <tr><td class="param-name">get_issue, list_projects, list_transitions</td><td>Read</td><td class="param-desc">Issue detail with comments / project discovery / legal transitions for an issue</td></tr>
-              <tr><td class="param-name">get_create_metadata, search_users</td><td>Read</td><td class="param-desc">Required + allowed fields per project/type; user lookup for assignment</td></tr>
-              <tr><td class="param-name">create_issue</td><td>Write</td><td class="param-desc">Pre-validates against create metadata and returns machine-readable missing required fields instead of guessing defaults</td></tr>
+              <tr><td class="param-name">get_issue, list_projects, list_transitions</td><td>Read</td><td class="param-desc">Issue detail with comments, parent, and typed links / project discovery / legal transitions for an issue</td></tr>
+              <tr><td class="param-name">get_create_metadata, search_users, list_link_types</td><td>Read</td><td class="param-desc">Field configuration per project/type (ids + names; the create screen may accept fewer — Jira over-reports, Epic Link is the classic case); user lookup for assignment; the server's issue-link type catalog</td></tr>
+              <tr><td class="param-name">list_boards, list_sprints, list_worklogs</td><td>Read</td><td class="param-desc">Agile boards (project fallback applies) &rarr; sprints per board (<code>sprint_state=active|future|closed</code>); an issue's logged time</td></tr>
+              <tr><td class="param-name">move_to_sprint, move_to_backlog</td><td>Write</td><td class="param-desc">Sprint assignment via the Agile API — <code>issue</code> takes one key or a comma-list; <code>sprint_id</code> comes from <code>list_sprints</code></td></tr>
+              <tr><td class="param-name">add_worklog, attach_file</td><td>Write</td><td class="param-desc">Log time (<code>time_spent='2h 30m'</code>, optional <code>body</code> comment); upload one local file as an attachment (20MB local cap)</td></tr>
+              <tr><td class="param-name">unlink_issues, delete_issue</td><td>Write</td><td class="param-desc">Remove a typed link by <code>link_id</code> (shown on get_issue); permanently delete an issue — refuses one with subtasks unless <code>delete_subtasks=true</code></td></tr>
+              <tr><td class="param-name">create_issue</td><td>Write</td><td class="param-desc">Pre-validates against create metadata and returns machine-readable missing required fields instead of guessing defaults. <code>parent=EPIC-KEY</code> files the new issue under an epic (deployment-mapped)</td></tr>
+              <tr><td class="param-name">update_issue</td><td>Write</td><td class="param-desc">Edit an existing issue: summary, description, <code>parent</code> (epic/parent key; <code>'none'</code> clears), or a fields JSON of field ids &rarr; values — the fallback when the create screen rejects a field ("not on the appropriate screen")</td></tr>
+              <tr><td class="param-name">link_issues</td><td>Write</td><td class="param-desc">Typed link reading <code>&lt;issue&gt; &lt;link_type&gt; &lt;target&gt;</code> — accepts a type name or either directional phrasing (an inward match flips the pair); unknown types answer with the catalog</td></tr>
               <tr><td class="param-name">comment, transition, assign</td><td>Write</td><td class="param-desc">Comment on / move (accepts transition id <em>or</em> name) / assign an issue</td></tr>
             </tbody>
           </table>
@@ -1330,12 +1338,31 @@ c3_jira(action=<span class="str">'get_create_metadata'</span>, project=<span cla
 c3_jira(action=<span class="str">'create_issue'</span>, project=<span class="str">'PROJ'</span>, issue_type=<span class="str">'Task'</span>,
         summary=<span class="str">'Fix login flow'</span>, description=<span class="str">'Steps in thread'</span>)
 
+<span class="com"># Field rejected on create ("not on the appropriate screen")? Set it post-create</span>
+c3_jira(action=<span class="str">'update_issue'</span>, issue=<span class="str">'PROJ-124'</span>, fields=<span class="str">'{"customfield_10014": "PROJ-42"}'</span>)
+
+<span class="com"># Put an issue under an epic — no customfield hunting (Cloud parent field
+# vs Data Center Epic Link customfield is resolved for you)</span>
+c3_jira(action=<span class="str">'update_issue'</span>, issue=<span class="str">'PROJ-124'</span>, parent=<span class="str">'PROJ-42'</span>)
+
+<span class="com"># Typed links: reads "PROJ-1 blocks PROJ-2"</span>
+c3_jira(action=<span class="str">'link_issues'</span>, issue=<span class="str">'PROJ-1'</span>, link_type=<span class="str">'blocks'</span>, target=<span class="str">'PROJ-2'</span>)
+
+<span class="com"># Sprint flow: board -> sprint -> assign</span>
+c3_jira(action=<span class="str">'list_boards'</span>)
+c3_jira(action=<span class="str">'list_sprints'</span>, board_id=<span class="num">7</span>, sprint_state=<span class="str">'active'</span>)
+c3_jira(action=<span class="str">'move_to_sprint'</span>, issue=<span class="str">'PROJ-1, PROJ-2'</span>, sprint_id=<span class="num">42</span>)
+
+<span class="com"># Time + evidence</span>
+c3_jira(action=<span class="str">'add_worklog'</span>, issue=<span class="str">'PROJ-1'</span>, time_spent=<span class="str">'2h 30m'</span>, body=<span class="str">'pairing'</span>)
+c3_jira(action=<span class="str">'attach_file'</span>, issue=<span class="str">'PROJ-1'</span>, file_path=<span class="str">'logs/build.log'</span>)
+
 <span class="com"># Move it along — id or name both work</span>
 c3_jira(action=<span class="str">'list_transitions'</span>, issue=<span class="str">'PROJ-123'</span>)
 c3_jira(action=<span class="str">'transition'</span>, issue=<span class="str">'PROJ-123'</span>, transition=<span class="str">'In Progress'</span>)
 c3_jira(action=<span class="str">'comment'</span>, issue=<span class="str">'PROJ-123'</span>, body=<span class="str">'Deployed to staging'</span>)</code></pre>
 
-          <p class="tool-desc"><strong>Surfaces &amp; audit:</strong> the per-project dashboard gets a <strong>Jira tab</strong> (My Work board grouped by statusCategory, JQL search, an issue drawer with transition buttons + comments, and an Activity view) backed by <code>/api/jira/*</code> routes. Issue keys like <code>PROJ-123</code> are auto-linked from branch names and edit-ledger entries (acronym denylist, so UTF-8 / SHA-256 / CVE-2024 never match), and the issue drawer shows the local ledger activity for the open issue — that Activity view works with no account configured. Mutations (<code>create_issue</code>, <code>comment</code>, <code>transition</code>, <code>assign</code>) are edit-ledger-logged with identifiers only — bodies are never logged. Read actions are safe in plan mode.</p>
+          <p class="tool-desc"><strong>Surfaces &amp; audit:</strong> the per-project dashboard gets a <strong>Jira tab</strong> (My Work board grouped by statusCategory, JQL search, an issue drawer with transition buttons + comments, and an Activity view) backed by <code>/api/jira/*</code> routes. Issue keys like <code>PROJ-123</code> are auto-linked from branch names and edit-ledger entries (acronym denylist, so UTF-8 / SHA-256 / CVE-2024 never match), and the issue drawer shows the local ledger activity for the open issue — that Activity view works with no account configured. Mutations (<code>create_issue</code>, <code>update_issue</code>, <code>comment</code>, <code>transition</code>, <code>assign</code>, <code>link_issues</code>, <code>unlink_issues</code>, <code>move_to_sprint</code>, <code>move_to_backlog</code>, <code>add_worklog</code>, <code>attach_file</code>, <code>delete_issue</code>) are edit-ledger-logged with identifiers only — bodies are never logged. Read actions are safe in plan mode.</p>
         </div>
       </div>
     </div>

{code_context_control-2.88.2 → code_context_control-2.89.1}/cli/mcp_server.py

@@ -902,13 +902,24 @@ async def c3_bitbucket(
     commit: str = "",
     settings: str = "",
     webhook_id: int = 0,
+    comment_id: int = 0,
     limit: int = 50,
     ctx: Context = None,
 ) -> str:
     """BITBUCKET (Data Center / Server) — see and act on PRs, branches, builds, repo admin.
     actions: status, whoami, list_projects, list_repos, get_repo,
-    list_prs, get_pr, get_pr_diff, get_pr_activities,
-    create_pr, comment_pr, approve_pr, unapprove_pr, decline_pr, merge_pr,
+    list_prs, get_pr, get_pr_diff, get_pr_activities, get_pr_commits,
+    create_pr, update_pr (pr_id + any of title/description/reviewers/to_branch —
+    unchanged fields are preserved; reviewers is the FULL comma-separated
+    replacement set), comment_pr,
+    update_pr_comment / delete_pr_comment (pr_id, comment_id [body] — the
+    comment's current version is fetched automatically),
+    approve_pr, unapprove_pr,
+    needs_work_pr (mark 'needs work' as the authenticated reviewer),
+    decline_pr, merge_pr,
+    list_pr_tasks (state filters OPEN/RESOLVED), create_pr_task (pr_id, body —
+    a blocker task on the PR), resolve_pr_task (pr_id, comment_id from
+    list_pr_tasks),
     list_branches, create_branch, delete_branch,
     list_commits, list_activity, build_status,
     repo_settings, update_repo_settings, list_webhooks, create_webhook, delete_webhook,
@@ -927,7 +938,8 @@ async def c3_bitbucket(
         title=title, body=body, from_branch=from_branch, to_branch=to_branch,
         description=description, reviewers=reviewers, name=name, url=url,
         events=events, start_point=start_point, commit=commit,
-        settings=settings, webhook_id=webhook_id, limit=limit,
+        settings=settings, webhook_id=webhook_id, comment_id=comment_id,
+        limit=limit,
     )
 
 
@@ -949,14 +961,43 @@ async def c3_jira(
     status_category: str = "",
     account: str = "",
     cursor: str = "",
+    target: str = "",
+    link_type: str = "",
+    parent: str = "",
+    link_id: str = "",
+    board_id: int = 0,
+    sprint_id: int = 0,
+    sprint_state: str = "",
+    time_spent: str = "",
+    file_path: str = "",
+    delete_subtasks: bool = False,
     limit: int = 25,
     ctx: Context = None,
 ) -> str:
-    """JIRA (Cloud + Data Center) — search, read, create, comment, transition, assign issues.
-    actions: status, whoami, search (jql), get_issue (issue), my_issues,
-    list_projects, list_transitions (issue), get_create_metadata (project, issue_type),
-    search_users (query), create_issue (project, issue_type, summary [description] [fields=JSON]),
-    comment (issue, body), transition (issue, transition=id|name [body]), assign (issue, user).
+    """JIRA (Cloud + Data Center) — search, read, create, update, link, sprint, comment, transition, assign issues.
+    actions: status, whoami, search (jql), get_issue (issue — shows parent, links, attachments),
+    my_issues, list_projects, list_transitions (issue), get_create_metadata (project, issue_type),
+    search_users (query), list_link_types,
+    list_boards ([project]), list_sprints (board_id [sprint_state=active|future|closed]),
+    list_worklogs (issue),
+    create_issue (project, issue_type, summary [description] [parent=epic/parent key] [fields=JSON]),
+    update_issue (issue [summary] [description] [parent=epic/parent key, 'none' clears]
+    [fields=JSON: field ids -> values]),
+    link_issues (issue, link_type, target — reads '<issue> <link_type> <target>', e.g.
+    issue=PROJ-1 link_type=blocks target=PROJ-2; link_type takes a type name or either
+    directional phrasing from list_link_types),
+    unlink_issues (link_id — from get_issue's link lines),
+    move_to_sprint (issue [comma-list], sprint_id), move_to_backlog (issue [comma-list]),
+    add_worklog (issue, time_spent='2h 30m' [body=comment]),
+    attach_file (issue, file_path — uploads one local file, 20MB local cap),
+    comment (issue, body), transition (issue, transition=id|name [body]), assign (issue, user),
+    delete_issue (issue [delete_subtasks] — PERMANENT; Jira refuses an issue with
+    subtasks unless delete_subtasks=true).
+    To put an issue under an epic, pass parent=<EPIC-KEY> to create_issue/update_issue —
+    C3 maps it per deployment (Cloud parent field vs Data Center Epic Link custom field).
+    get_create_metadata reflects Jira's field configuration, not the create screen — if
+    create_issue rejects a listed field ('not on the appropriate screen'), create without
+    it and set it via update_issue (the edit screen is configured separately).
     project falls back to the account's default_project; account to jira.default_account.
     Mutating actions are ledger-logged. Tokens live in the OS keyring — `c3 jira login` first."""
     svc = _svc(ctx)
@@ -971,7 +1012,11 @@ async def c3_jira(
         summary=summary, description=description, body=body,
         body_format=body_format, transition=transition, user=user,
         query=query, fields=fields, status_category=status_category,
-        account=account, cursor=cursor, limit=limit,
+        account=account, cursor=cursor, target=target, link_type=link_type,
+        parent=parent, link_id=link_id, board_id=board_id,
+        sprint_id=sprint_id, sprint_state=sprint_state,
+        time_spent=time_spent, file_path=file_path,
+        delete_subtasks=delete_subtasks, limit=limit,
     )
 
 

{code_context_control-2.88.2 → code_context_control-2.89.1}/cli/tools/bitbucket.py

@@ -23,8 +23,10 @@ _DIFF_PREVIEW_CHARS = 6000  # diffs above this are truncated
 
 # Actions that change repo state — flagged for ledger logging.
 _MUTATING_ACTIONS = {
-    "create_pr", "comment_pr", "approve_pr", "unapprove_pr",
-    "decline_pr", "merge_pr",
+    "create_pr", "update_pr", "comment_pr", "approve_pr", "unapprove_pr",
+    "needs_work_pr", "decline_pr", "merge_pr",
+    "update_pr_comment", "delete_pr_comment",
+    "create_pr_task", "resolve_pr_task",
     "create_branch", "delete_branch",
     "update_repo_settings", "create_webhook", "delete_webhook",
 }
@@ -32,8 +34,10 @@ _MUTATING_ACTIONS = {
 # Actions that can fall back to default_project/default_repo from config.
 _REPO_SCOPED = {
     "list_repos", "get_repo", "list_prs", "get_pr", "get_pr_diff",
-    "get_pr_activities", "create_pr", "comment_pr", "approve_pr",
-    "unapprove_pr", "decline_pr", "merge_pr", "list_branches",
+    "get_pr_activities", "get_pr_commits", "create_pr", "update_pr",
+    "comment_pr", "update_pr_comment", "delete_pr_comment", "approve_pr",
+    "unapprove_pr", "needs_work_pr", "decline_pr", "merge_pr",
+    "list_pr_tasks", "create_pr_task", "resolve_pr_task", "list_branches",
     "create_branch", "delete_branch", "list_commits", "list_activity",
     "repo_settings", "update_repo_settings", "list_webhooks",
     "create_webhook", "delete_webhook", "list_permissions",
@@ -303,6 +307,40 @@ def _act_create_pr(client, project: str, repo: str, kwargs: dict) -> str:
     return f"[bitbucket:created]\n{_format_pr_full(pr)}"
 
 
+def _act_update_pr(client, project: str, repo: str, pr_id: int, kwargs: dict) -> str:
+    title = kwargs.get("title") or ""
+    description = kwargs.get("description", "") or kwargs.get("body", "")
+    to_b = kwargs.get("to_branch") or kwargs.get("target") or ""
+    reviewers_raw = kwargs.get("reviewers")
+    if not title and not description and not to_b and not reviewers_raw:
+        return (
+            "[bitbucket:update_pr:error] nothing to change — pass at least one "
+            "of title, description, to_branch, reviewers"
+        )
+    # PUT replaces the PR record, so merge unchanged fields from the live PR.
+    pr = client.get_pull_request(project, repo, pr_id)
+    reviewers: list[str] | None = None
+    if isinstance(reviewers_raw, str) and reviewers_raw.strip():
+        reviewers = [r.strip() for r in reviewers_raw.split(",") if r.strip()]
+    elif isinstance(reviewers_raw, list) and reviewers_raw:
+        reviewers = [str(r) for r in reviewers_raw]
+    else:
+        reviewers = [
+            ((r.get("user") or {}).get("name") or "")
+            for r in pr.get("reviewers") or []
+        ]
+        reviewers = [r for r in reviewers if r]
+    updated = client.update_pull_request(
+        project, repo, pr_id,
+        version=pr.get("version", 0),
+        title=title or pr.get("title", ""),
+        description=description or pr.get("description", ""),
+        to_branch=to_b,
+        reviewers=reviewers,
+    )
+    return f"[bitbucket:updated]\n{_format_pr_full(updated)}"
+
+
 def _act_comment_pr(client, project: str, repo: str, pr_id: int, kwargs: dict) -> str:
     text = kwargs.get("body") or kwargs.get("text") or ""
     if not text:
@@ -321,6 +359,115 @@ def _act_unapprove_pr(client, project: str, repo: str, pr_id: int) -> str:
     return f"[bitbucket:unapproved] {project}/{repo}#{pr_id}"
 
 
+def _act_get_pr_commits(client, project: str, repo: str, pr_id: int) -> str:
+    commits = client.get_pr_commits(project, repo, pr_id)
+    if not commits:
+        return f"[bitbucket:pr_commits] {project}/{repo}#{pr_id}: 0 commits"
+    lines = [
+        f"[bitbucket:pr_commits] {project}/{repo}#{pr_id}: "
+        f"{len(commits)} commit(s)"
+    ]
+    lines.extend(f"  {_format_commit(c)}" for c in commits)
+    return "\n".join(lines)
+
+
+def _act_update_pr_comment(client, project: str, repo: str, pr_id: int,
+                           kwargs: dict) -> str:
+    comment_id = int(kwargs.get("comment_id") or 0)
+    text = kwargs.get("body") or kwargs.get("text") or ""
+    if not comment_id or not text:
+        return "[bitbucket:update_pr_comment:error] comment_id and body are required"
+    current = client.get_pr_comment(project, repo, pr_id, comment_id)
+    res = client.update_pr_comment(
+        project, repo, pr_id, comment_id,
+        version=current.get("version", 0), text=text,
+    )
+    return (
+        f"[bitbucket:comment-updated] {project}/{repo}#{pr_id} "
+        f"comment-id={res.get('id', comment_id)}"
+    )
+
+
+def _act_delete_pr_comment(client, project: str, repo: str, pr_id: int,
+                           kwargs: dict) -> str:
+    comment_id = int(kwargs.get("comment_id") or 0)
+    if not comment_id:
+        return "[bitbucket:delete_pr_comment:error] comment_id is required"
+    current = client.get_pr_comment(project, repo, pr_id, comment_id)
+    client.delete_pr_comment(
+        project, repo, pr_id, comment_id, version=current.get("version", 0)
+    )
+    return (
+        f"[bitbucket:comment-deleted] {project}/{repo}#{pr_id} "
+        f"comment-id={comment_id}"
+    )
+
+
+def _format_task(c: dict) -> str:
+    author = ((c.get("author") or {}).get("displayName")
+              or (c.get("author") or {}).get("name") or "?")
+    first_line = (c.get("text") or "").splitlines()[0][:120] \
+        if c.get("text") else ""
+    return f"[{c.get('state', 'OPEN')}] id={c.get('id', '?')} ({author}) {first_line}"
+
+
+def _act_list_pr_tasks(client, project: str, repo: str, pr_id: int,
+                       kwargs: dict) -> str:
+    state = (kwargs.get("state") or "").strip()
+    tasks = client.list_pr_tasks(project, repo, pr_id, state=state)
+    label = f" (state={state})" if state else ""
+    if not tasks:
+        return f"[bitbucket:pr_tasks] {project}/{repo}#{pr_id}: 0 task(s){label}"
+    lines = [
+        f"[bitbucket:pr_tasks] {project}/{repo}#{pr_id}: "
+        f"{len(tasks)} task(s){label}"
+    ]
+    lines.extend(f"  {_format_task(t)}" for t in tasks)
+    return "\n".join(lines)
+
+
+def _act_create_pr_task(client, project: str, repo: str, pr_id: int,
+                        kwargs: dict) -> str:
+    text = kwargs.get("body") or kwargs.get("text") or ""
+    if not text:
+        return "[bitbucket:create_pr_task:error] body is required"
+    res = client.create_pr_task(project, repo, pr_id, text=text)
+    return (
+        f"[bitbucket:task-created] {project}/{repo}#{pr_id} "
+        f"task-id={res.get('id', '?')}"
+    )
+
+
+def _act_resolve_pr_task(client, project: str, repo: str, pr_id: int,
+                         kwargs: dict) -> str:
+    comment_id = int(kwargs.get("comment_id") or 0)
+    if not comment_id:
+        return (
+            "[bitbucket:resolve_pr_task:error] comment_id (the task id from "
+            "list_pr_tasks) is required"
+        )
+    current = client.get_pr_comment(project, repo, pr_id, comment_id)
+    client.set_pr_task_state(
+        project, repo, pr_id, comment_id,
+        version=current.get("version", 0), state="RESOLVED",
+    )
+    return f"[bitbucket:task-resolved] {project}/{repo}#{pr_id} task-id={comment_id}"
+
+
+def _act_needs_work_pr(client, project: str, repo: str, pr_id: int) -> str:
+    me = client.whoami()
+    slug = me.get("slug") or me.get("name") or ""
+    if not slug:
+        return (
+            "[bitbucket:needs_work_pr:error] could not resolve the "
+            "authenticated user's slug (whoami returned no identity)"
+        )
+    client.set_pr_reviewer_status(
+        project, repo, pr_id, user_slug=slug, status="NEEDS_WORK"
+    )
+    return f"[bitbucket:needs-work] {project}/{repo}#{pr_id} marked by {slug}"
+
+
 def _act_decline_pr(client, project: str, repo: str, pr_id: int) -> str:
     pr = client.get_pull_request(project, repo, pr_id)
     version = pr.get("version", 0)
@@ -493,6 +640,8 @@ def _log_mutation(svc, action: str, project: str, repo: str, kwargs: dict, respo
     reflects platform-side state changes too. Never raises."""
     if action not in _MUTATING_ACTIONS:
         return
+    if ":error]" in response.split("\n", 1)[0]:
+        return  # validation failed — nothing actually mutated (matches jira)
     if not getattr(svc, "edit_ledger", None):
         return
     detail: dict[str, Any] = {
@@ -580,12 +729,40 @@ def handle_bitbucket(action: str, svc, finalize, **kwargs) -> str:
             if not pr_id:
                 return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
             resp = _act_get_pr_activities(client, project, repo, pr_id)
+        elif action == "get_pr_commits":
+            if not pr_id:
+                return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
+            resp = _act_get_pr_commits(client, project, repo, pr_id)
         elif action == "create_pr":
             resp = _act_create_pr(client, project, repo, kwargs)
+        elif action == "update_pr":
+            if not pr_id:
+                return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
+            resp = _act_update_pr(client, project, repo, pr_id, kwargs)
         elif action == "comment_pr":
             if not pr_id:
                 return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
             resp = _act_comment_pr(client, project, repo, pr_id, kwargs)
+        elif action == "update_pr_comment":
+            if not pr_id:
+                return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
+            resp = _act_update_pr_comment(client, project, repo, pr_id, kwargs)
+        elif action == "delete_pr_comment":
+            if not pr_id:
+                return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
+            resp = _act_delete_pr_comment(client, project, repo, pr_id, kwargs)
+        elif action == "list_pr_tasks":
+            if not pr_id:
+                return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
+            resp = _act_list_pr_tasks(client, project, repo, pr_id, kwargs)
+        elif action == "create_pr_task":
+            if not pr_id:
+                return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
+            resp = _act_create_pr_task(client, project, repo, pr_id, kwargs)
+        elif action == "resolve_pr_task":
+            if not pr_id:
+                return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
+            resp = _act_resolve_pr_task(client, project, repo, pr_id, kwargs)
         elif action == "approve_pr":
             if not pr_id:
                 return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
@@ -594,6 +771,10 @@ def handle_bitbucket(action: str, svc, finalize, **kwargs) -> str:
             if not pr_id:
                 return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
             resp = _act_unapprove_pr(client, project, repo, pr_id)
+        elif action == "needs_work_pr":
+            if not pr_id:
+                return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
+            resp = _act_needs_work_pr(client, project, repo, pr_id)
         elif action == "decline_pr":
             if not pr_id:
                 return finalize(_TOOL, args_for_log, "[bitbucket:error] pr_id required", "missing-arg")
@@ -631,8 +812,11 @@ def handle_bitbucket(action: str, svc, finalize, **kwargs) -> str:
                 "status", "whoami",
                 "list_projects", "list_repos", "get_repo",
                 "list_prs", "get_pr", "get_pr_diff", "get_pr_activities",
-                "create_pr", "comment_pr", "approve_pr", "unapprove_pr",
-                "decline_pr", "merge_pr",
+                "get_pr_commits",
+                "create_pr", "update_pr", "comment_pr", "update_pr_comment",
+                "delete_pr_comment", "approve_pr",
+                "unapprove_pr", "needs_work_pr", "decline_pr", "merge_pr",
+                "list_pr_tasks", "create_pr_task", "resolve_pr_task",
                 "list_branches", "create_branch", "delete_branch",
                 "list_commits", "list_activity", "build_status",
                 "repo_settings", "update_repo_settings",