code-context-control 2.55.0__tar.gz → 2.56.0__tar.gz

{code_context_control-2.55.0/code_context_control.egg-info → code_context_control-2.56.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-context-control
-Version: 2.55.0
+Version: 2.56.0
 Summary: Local code-intelligence layer for AI coding tools (Claude Code, Codex, Copilot, Cursor, Antigravity). Retrieve less, read less, edit safer — and version the configs that shape your agent (CLAUDE.md, skills, hooks, MCP).
 Author-email: Dimitri Tselenchuk <dtselenc@gmail.com>
 License-Expression: Apache-2.0
@@ -274,6 +274,7 @@ C3 exposes 18 tools as a native MCP server. Your IDE calls them directly:
 | `c3_agent` | Multi-step agentic workflows (review, investigate, refactor) |
 | `c3_edits` | Edit-ledger queries + version diffs + restore points + per-branch filter |
 | `c3_bitbucket` | Bitbucket Data Center integration — PRs, branches, builds, repo admin (v2.30.0) |
+| `c3_jira` | Jira integration — Cloud + Data Center: JQL search, issues, transitions, My Work board (v2.56.0) |
 | `c3_project` | Cross-project — discover & operate on other c3-installed projects; guarded writes (v2.31.0) |
 | `c3_task` | Durable per-project PM — tasks with dependencies & subtasks, milestones, decision notes, event history, health reports, and auto+manual time tracking (v2.53.0) |
 | `c3_artifacts` | Agent-config tracking — version history, diff & restore for CLAUDE.md, settings/hooks, MCP configs, skills (v2.46.0) |
@@ -282,7 +283,7 @@ On Windows, `c3_shell` uses Git Bash when available. Git Bash does not bundle
 optional utilities such as `jq`; use `python -m json.tool` for portable JSON
 formatting, or install `jq` separately when filter expressions are required.
 
-Every tool is **read-only safe in plan mode** (except `c3_edit`, `c3_shell`, `c3_artifacts(action='restore')`, and write actions on `c3_bitbucket` / `c3_project` / `c3_task`).
+Every tool is **read-only safe in plan mode** (except `c3_edit`, `c3_shell`, `c3_artifacts(action='restore')`, and write actions on `c3_bitbucket` / `c3_jira` / `c3_project` / `c3_task`).
 
 ### Bitbucket Data Center / Server (v2.30.0)
 
@@ -310,6 +311,40 @@ it has no active account C3 falls back to the global `~/.c3/config.json`. So a
 single `login --global` (or any login done from your home directory) is reusable
 across every C3 project — the PAT always lives in the OS keyring, never on disk.
 
+### Jira — Cloud + Data Center (v2.56.0)
+
+`c3_jira` connects to Jira Cloud (REST v3, email + API token) or self-hosted
+Jira Data Center / Server (REST v2, PAT) behind one tool. Tokens live in the
+**OS keyring** — never in `.c3/config.json`.
+
+```bash
+# One-time login — Cloud is inferred for *.atlassian.net
+c3 jira login --url https://yoursite.atlassian.net
+#  -> prompts for email + API token (masked)
+
+# Self-hosted Data Center / Server
+c3 jira login --url https://jira.example.com --deployment data_center
+
+# ...or store it globally so every C3 project can use it
+c3 jira login --global --url https://yoursite.atlassian.net
+
+# Pin a default project; check connectivity
+c3 jira set-default --project PROJ
+c3 jira status
+```
+
+The agent gets `c3_jira`: raw-JQL `search`, `my_issues`, issue reads, and
+ledger-logged mutations (`create_issue` is pre-validated against create
+metadata and returns machine-readable missing required fields; `transition`
+accepts an id or a name). The web UI gains a **Jira tab** — a My Work board
+grouped by status category, JQL search, an issue drawer with transitions and
+comments, and an Activity view that links edit-ledger work to issue keys
+(`PROJ-123` detected in branch names and edit summaries; works even before
+login). Named accounts support multiple sites (`--name work`, `--name
+internal`); the registry resolves project → home **wholesale from one file**,
+so a repository's config can never override the credential-bound server URL
+or TLS settings of a globally registered account.
+
 > **Upgrading:** stop the running `c3-mcp` server / CLI before `c3 upgrade`. A live
 > process can hold package files open, leaving pip's `~`-prefixed backup dirs
 > (`~ervices`, `~ools`, …) in `site-packages`; those are inert and safe to delete

{code_context_control-2.55.0 → code_context_control-2.56.0}/README.md

@@ -211,6 +211,7 @@ C3 exposes 18 tools as a native MCP server. Your IDE calls them directly:
 | `c3_agent` | Multi-step agentic workflows (review, investigate, refactor) |
 | `c3_edits` | Edit-ledger queries + version diffs + restore points + per-branch filter |
 | `c3_bitbucket` | Bitbucket Data Center integration — PRs, branches, builds, repo admin (v2.30.0) |
+| `c3_jira` | Jira integration — Cloud + Data Center: JQL search, issues, transitions, My Work board (v2.56.0) |
 | `c3_project` | Cross-project — discover & operate on other c3-installed projects; guarded writes (v2.31.0) |
 | `c3_task` | Durable per-project PM — tasks with dependencies & subtasks, milestones, decision notes, event history, health reports, and auto+manual time tracking (v2.53.0) |
 | `c3_artifacts` | Agent-config tracking — version history, diff & restore for CLAUDE.md, settings/hooks, MCP configs, skills (v2.46.0) |
@@ -219,7 +220,7 @@ On Windows, `c3_shell` uses Git Bash when available. Git Bash does not bundle
 optional utilities such as `jq`; use `python -m json.tool` for portable JSON
 formatting, or install `jq` separately when filter expressions are required.
 
-Every tool is **read-only safe in plan mode** (except `c3_edit`, `c3_shell`, `c3_artifacts(action='restore')`, and write actions on `c3_bitbucket` / `c3_project` / `c3_task`).
+Every tool is **read-only safe in plan mode** (except `c3_edit`, `c3_shell`, `c3_artifacts(action='restore')`, and write actions on `c3_bitbucket` / `c3_jira` / `c3_project` / `c3_task`).
 
 ### Bitbucket Data Center / Server (v2.30.0)
 
@@ -247,6 +248,40 @@ it has no active account C3 falls back to the global `~/.c3/config.json`. So a
 single `login --global` (or any login done from your home directory) is reusable
 across every C3 project — the PAT always lives in the OS keyring, never on disk.
 
+### Jira — Cloud + Data Center (v2.56.0)
+
+`c3_jira` connects to Jira Cloud (REST v3, email + API token) or self-hosted
+Jira Data Center / Server (REST v2, PAT) behind one tool. Tokens live in the
+**OS keyring** — never in `.c3/config.json`.
+
+```bash
+# One-time login — Cloud is inferred for *.atlassian.net
+c3 jira login --url https://yoursite.atlassian.net
+#  -> prompts for email + API token (masked)
+
+# Self-hosted Data Center / Server
+c3 jira login --url https://jira.example.com --deployment data_center
+
+# ...or store it globally so every C3 project can use it
+c3 jira login --global --url https://yoursite.atlassian.net
+
+# Pin a default project; check connectivity
+c3 jira set-default --project PROJ
+c3 jira status
+```
+
+The agent gets `c3_jira`: raw-JQL `search`, `my_issues`, issue reads, and
+ledger-logged mutations (`create_issue` is pre-validated against create
+metadata and returns machine-readable missing required fields; `transition`
+accepts an id or a name). The web UI gains a **Jira tab** — a My Work board
+grouped by status category, JQL search, an issue drawer with transitions and
+comments, and an Activity view that links edit-ledger work to issue keys
+(`PROJ-123` detected in branch names and edit summaries; works even before
+login). Named accounts support multiple sites (`--name work`, `--name
+internal`); the registry resolves project → home **wholesale from one file**,
+so a repository's config can never override the credential-bound server URL
+or TLS settings of a globally registered account.
+
 > **Upgrading:** stop the running `c3-mcp` server / CLI before `c3 upgrade`. A live
 > process can hold package files open, leaving pip's `~`-prefixed backup dirs
 > (`~ervices`, `~ools`, …) in `site-packages`; those are inert and safe to delete

{code_context_control-2.55.0 → code_context_control-2.56.0}/cli/c3.py

@@ -248,6 +248,7 @@ _C3_MCP_ALLOW = [
     "mcp__c3__c3_memory", "mcp__c3__c3_validate", "mcp__c3__c3_edit",
     "mcp__c3__c3_agent", "mcp__c3__c3_delegate", "mcp__c3__c3_edits",
     "mcp__c3__c3_impact", "mcp__c3__c3_shell", "mcp__c3__c3_bitbucket",
+    "mcp__c3__c3_jira",
     "mcp__c3__c3_project", "mcp__c3__c3_task", "mcp__c3__c3_artifacts",
 ]
 
@@ -5737,6 +5738,204 @@ def _bb_cmd_set_default(args, project_path: str) -> None:
     print(f"[OK] Default repo: {args.project}/{args.repo}")
 
 
+def cmd_jira(args):
+    """Jira Cloud / Data Center credential + workspace management."""
+    sub = getattr(args, "jira_cmd", None)
+    if not sub:
+        print("Usage: c3 jira {login,logout,status,use,set-default} [args]")
+        return
+
+    project_path = getattr(args, "project_path", ".") or "."
+
+    if sub == "login":
+        _jira_cmd_login(args, project_path)
+    elif sub == "logout":
+        _jira_cmd_logout(args, project_path)
+    elif sub == "status":
+        _jira_cmd_status(args, project_path)
+    elif sub == "use":
+        _jira_cmd_use(args, project_path)
+    elif sub == "set-default":
+        _jira_cmd_set_default(args, project_path)
+    else:
+        print(f"Unknown jira subcommand: {sub}")
+
+
+def _jira_deployment_for(args, base_url: str) -> str:
+    """Explicit --deployment wins; *.atlassian.net infers cloud; else unknown."""
+    dep = getattr(args, "deployment", "") or ""
+    if dep:
+        return dep
+    host = base_url.split("//", 1)[-1].split("/", 1)[0].lower()
+    if host.endswith(".atlassian.net") or host.endswith(".jira.com"):
+        return "cloud"
+    return ""
+
+
+def _jira_cmd_login(args, project_path: str) -> None:
+    import getpass
+
+    from services import jira_credentials as jr_creds
+    from services.jira_client import JiraClient, JiraError
+
+    # --global stores the account in ~/.c3/config.json so it is reusable in
+    # every C3 project (load_jira_config falls back to it automatically).
+    if getattr(args, "use_global", False):
+        project_path = str(Path.home())
+
+    base_url = (args.url or "").rstrip("/")
+    deployment = _jira_deployment_for(args, base_url)
+    if not deployment:
+        print("[error] --deployment cloud|data_center is required for self-hosted URLs.")
+        return
+    name = getattr(args, "name", "") or ""
+    if not name:
+        host = base_url.split("//", 1)[-1].split("/", 1)[0]
+        name = host.split(".")[0] or "default"
+
+    prompt_label = "Email" if deployment == "cloud" else "Username"
+    username = args.username or input(f"{prompt_label} for {base_url}: ").strip()
+    if not username:
+        print("Login cancelled -- username required.")
+        return
+    token_label = "API token" if deployment == "cloud" else "Personal Access Token"
+    token = args.token or getpass.getpass(f"{token_label} for {username}: ").strip()
+    if not token:
+        print("Login cancelled -- token required.")
+        return
+
+    try:
+        jr_creds.save_credentials(
+            name, base_url, username, token,
+            deployment=deployment,
+            project_path=project_path,
+            set_default=not getattr(args, "no_set_default", False),
+            verify_tls=not getattr(args, "insecure", False),
+            ca_bundle=getattr(args, "ca_bundle", "") or "",
+            allow_insecure=getattr(args, "insecure", False),
+        )
+    except jr_creds.JiraCredentialError as exc:
+        print(f"[error] {exc}")
+        return
+
+    scope = "global (~/.c3)" if getattr(args, "use_global", False) else "project"
+    print(f"[OK] Stored credentials for {username}@{base_url} as '{name}' [{deployment}, {scope}]")
+
+    # Connection probe -- skippable for offline setup (--no-verify-login) and
+    # non-fatal on failure (token might be valid but the network blocked).
+    if getattr(args, "no_verify_login", False):
+        print("     Connection probe skipped (--no-verify-login) -- verify later with `c3 jira status`.")
+        return
+    try:
+        client = JiraClient(
+            base_url, username, token,
+            deployment=deployment,
+            verify_tls=not getattr(args, "insecure", False),
+            ca_bundle=getattr(args, "ca_bundle", "") or "",
+        )
+        info = client.server_info()
+        print(f"     Server: Jira {info.get('version', '?')} ({base_url})")
+    except (JiraError, ValueError) as exc:
+        print(f"[warn] Connection probe failed: {exc}")
+        print("       Token saved anyway -- re-test with `c3 jira status`.")
+        return
+    try:
+        me = client.myself()
+        if me:
+            print(
+                f"     Auth as: {me.get('displayName', username)} "
+                f"<{me.get('emailAddress', '?')}>"
+            )
+    except JiraError:
+        pass
+
+
+def _jira_cmd_logout(args, project_path: str) -> None:
+    from core.config import load_jira_config
+    from services import jira_credentials as jr_creds
+
+    name = getattr(args, "name", "") or ""
+    if not name:
+        name = load_jira_config(project_path).get("default_account", "")
+    if not name:
+        print("[error] No account specified and no default account configured.")
+        return
+    removed = jr_creds.delete_credentials(name, project_path=project_path)
+    if removed:
+        print(f"[OK] Removed Jira account '{name}'")
+    else:
+        print(f"[warn] Nothing to remove for '{name}'")
+
+
+def _jira_cmd_status(args, project_path: str) -> None:
+    from core.config import load_jira_config
+    from services import jira_credentials as jr_creds
+    from services.jira_client import JiraClient, JiraError
+
+    cfg = load_jira_config(project_path)
+    accounts = cfg.get("accounts") or {}
+    default = cfg.get("default_account", "")
+
+    print("[jira:status]")
+    print(f"  Default : {default or '-'}")
+    print(f"  Accounts ({len(accounts)}):")
+    for acct_name, a in accounts.items():
+        if not isinstance(a, dict):
+            continue
+        marker = "*" if acct_name == default else " "
+        print(
+            f"    {marker} {acct_name}: {a.get('username', '?')}@{a.get('base_url', '?')} "
+            f"[{a.get('deployment', '?')}] project={a.get('default_project') or '-'}"
+        )
+
+    entry = accounts.get(default) if isinstance(accounts.get(default), dict) else None
+    if not entry:
+        print("  Connection: (no default account)")
+        return
+    token = jr_creds.load_token(entry.get("base_url", ""), entry.get("username", ""))
+    if not token:
+        print("  Connection: FAIL -- no token in keyring")
+        return
+    try:
+        client = JiraClient(
+            entry["base_url"], entry.get("username", ""), token,
+            deployment=entry.get("deployment", "cloud"),
+            verify_tls=bool(entry.get("verify_tls", True)),
+            ca_bundle=entry.get("ca_bundle", ""),
+        )
+        info = client.server_info()
+        me = client.myself()
+        print(
+            f"  Connection: OK (Jira {info.get('version', '?')} "
+            f"as {me.get('displayName', '?')})"
+        )
+    except (JiraError, ValueError) as exc:
+        print(f"  Connection: FAIL -- {exc}")
+
+
+def _jira_cmd_use(args, project_path: str) -> None:
+    from services import jira_credentials as jr_creds
+    try:
+        jr_creds.set_default_account(args.name, project_path=project_path)
+    except jr_creds.JiraCredentialError as exc:
+        print(f"[error] {exc}")
+        return
+    print(f"[OK] Default Jira account: {args.name}")
+
+
+def _jira_cmd_set_default(args, project_path: str) -> None:
+    from services import jira_credentials as jr_creds
+    try:
+        jr_creds.set_default_project(
+            args.project, name=getattr(args, "name", "") or "",
+            project_path=project_path,
+        )
+    except jr_creds.JiraCredentialError as exc:
+        print(f"[error] {exc}")
+        return
+    print(f"[OK] Default Jira project: {args.project}")
+
+
 def cmd_oracle(args):
     """Oracle dashboard server + Discovery API key management."""
     sub = getattr(args, "oracle_cmd", None)
@@ -6836,6 +7035,7 @@ def main():
         "sub": cmd_sub,
         "hub": cmd_hub,
         "bitbucket": cmd_bitbucket,
+        "jira": cmd_jira,
         "oracle": cmd_oracle,
         "upgrade": cmd_upgrade,
     }

{code_context_control-2.55.0 → code_context_control-2.56.0}/cli/commands/parser.py

@@ -359,6 +359,48 @@ def build_parser(version: str, parse_cli_ide_arg):
     bb_default.add_argument("--repo", required=True, help="Repository slug")
     bb_default.add_argument("project_path", nargs="?", default=".")
 
+    # ── Jira Cloud / Data Center (v2.56.0) ──────────────────────────────
+    p_jira = subparsers.add_parser(
+        "jira",
+        help="Jira Cloud / Data Center credential + workspace management",
+    )
+    jira_subs = p_jira.add_subparsers(dest="jira_cmd")
+
+    jr_login = jira_subs.add_parser(
+        "login",
+        help="Authenticate with a Jira site (interactive token prompt)",
+    )
+    jr_login.add_argument("--url", required=True, help="Jira base URL (e.g. https://yoursite.atlassian.net)")
+    jr_login.add_argument("--deployment", choices=["cloud", "data_center"], default="", help="Deployment type (inferred as 'cloud' for *.atlassian.net URLs; required otherwise)")
+    jr_login.add_argument("--name", default="", help="Account name in the registry (default: derived from URL host)")
+    jr_login.add_argument("--username", help="Email (Cloud) or username (Data Center); prompted if omitted")
+    jr_login.add_argument("--token", help="API token (Cloud) / PAT (Data Center); prompted via getpass if omitted — preferred")
+    jr_login.add_argument("--no-set-default", action="store_true", help="Do not make this the default account")
+    jr_login.add_argument("--no-verify-login", action="store_true", help="Skip the connection probe (store credentials offline)")
+    jr_login.add_argument("--insecure", action="store_true", help="Disable TLS verification / allow http:// (local dev only)")
+    jr_login.add_argument("--ca-bundle", default="", help="Path to a custom CA bundle for self-signed enterprise certs")
+    jr_login.add_argument("--global", dest="use_global", action="store_true", help="Store the account in the global ~/.c3/config.json so it is reusable in every C3 project")
+    jr_login.add_argument("project_path", nargs="?", default=".")
+
+    jr_logout = jira_subs.add_parser("logout", help="Remove a Jira account from keyring + config")
+    jr_logout.add_argument("--name", default="", help="Account name (defaults to the default account)")
+    jr_logout.add_argument("project_path", nargs="?", default=".")
+
+    jr_status = jira_subs.add_parser("status", help="Show configured Jira accounts and connectivity")
+    jr_status.add_argument("project_path", nargs="?", default=".")
+
+    jr_use = jira_subs.add_parser("use", help="Switch the default Jira account")
+    jr_use.add_argument("--name", required=True, help="Registered account name")
+    jr_use.add_argument("project_path", nargs="?", default=".")
+
+    jr_default = jira_subs.add_parser(
+        "set-default",
+        help="Set the default Jira project key on an account",
+    )
+    jr_default.add_argument("--project", required=True, help="Jira project key (e.g. PROJ)")
+    jr_default.add_argument("--name", default="", help="Account name (defaults to the default account)")
+    jr_default.add_argument("project_path", nargs="?", default=".")
+
     # ── Oracle Discovery API (v2.32.0) ──────────────────────────────────
     p_oracle = subparsers.add_parser(
         "oracle",

{code_context_control-2.55.0 → code_context_control-2.56.0}/cli/mcp_server.py

@@ -778,6 +778,50 @@ async def c3_bitbucket(
     )
 
 
+@mcp.tool()
+async def c3_jira(
+    action: str,
+    issue: str = "",
+    jql: str = "",
+    project: str = "",
+    issue_type: str = "",
+    summary: str = "",
+    description: str = "",
+    body: str = "",
+    body_format: str = "text",
+    transition: str = "",
+    user: str = "",
+    query: str = "",
+    fields: str = "",
+    status_category: str = "",
+    account: str = "",
+    cursor: str = "",
+    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).
+    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)
+
+    def finalize(fname, fargs, fresp, fsumm, **kw):
+        return _finalize_response(ctx, fname, fargs, fresp, fsumm, **kw)
+
+    from cli.tools.jira import handle_jira
+    return await asyncio.to_thread(
+        handle_jira, action, svc, finalize,
+        issue=issue, jql=jql, project=project, issue_type=issue_type,
+        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,
+    )
+
+
 @mcp.tool()
 async def c3_project(
     action: str,