conjira-cli 0.2.1__tar.gz → 0.2.3__tar.gz

{conjira_cli-0.2.1/src/conjira_cli.egg-info → conjira_cli-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: conjira-cli
-Version: 0.2.1
+Version: 0.2.3
 Summary: Unofficial agent-friendly CLI for self-hosted Confluence and Jira
 Author: quanttraderkim
 License-Expression: MIT
@@ -47,6 +47,8 @@ If your team uses self-hosted Confluence and Jira, official cloud-native connect
 
 `conjira-cli` is built for that gap. It helps when you want to read Confluence pages, export them to Markdown, refresh stale exports from the live wiki, summarize inline comment threads, search Jira with JQL, or create and update content without hardcoding PATs into source files or chat transcripts.
 
+For report-style pages, it can also preserve a small set of Confluence-native presentation macros while still keeping Markdown as the source of truth. The current bridge covers Mermaid, Markdown callouts such as `> [!INFO]`, `> [!NOTE]`, `> [!TIP]`, and `> [!WARNING]`, expandable blocks with `> [!EXPAND]`, and inline status badges with `:status[In Progress]{color=yellow}`.
+
 ## What you can do with it
 
 - read Confluence pages and search with CQL
@@ -112,6 +114,7 @@ The script stores PATs in macOS Keychain, writes only non-secret settings to `lo
 It uses the default Keychain target names automatically, so most users only need to enter the base URL and PAT.
 PAT prompts are hidden on screen by design. Paste the token and press Enter even if nothing appears while typing.
 It does not write PAT values to `~/.zshrc` or other shell profile files.
+If you keep working in the same folder, `conjira` will auto-load `./local/agent.env` so you do not need to pass `--env-file` each time.
 If you are running directly from a source checkout before installing entrypoints, you can still use:
 
 ```bash
@@ -130,9 +133,55 @@ If you are using Codex, Claude Code, or another shell-capable local coding agent
 If you want to run the CLI directly, start with these short commands:
 
 ```bash
-conjira --env-file ./local/agent.env auth-check
-conjira --env-file ./local/agent.env jira-auth-check
-conjira --env-file ./local/agent.env export-page-md --page-id 123456 --output-dir "/path/to/notes"
+conjira auth-check
+conjira jira-auth-check
+conjira export-page-md --page-id 123456 --output-dir "/path/to/notes"
+```
+
+If you run the CLI from a different folder, pass the config file explicitly with `--env-file /path/to/local/agent.env`.
+
+## Prompt templates by document type
+
+When you ask an agent to upload or update a document, results are better if you tell it what kind of document it is, whether Markdown should remain the source of truth, and whether the Confluence page should stay plain or become more presentation-friendly.
+
+For skill specs or evaluation docs, a good request is:
+
+```text
+Use conjira to upload this Markdown file as a Confluence page. Treat it as a skill spec, keep the Markdown structure as the source of truth, preserve headings and tables, and only use Confluence-native rendering where it helps readability without changing the document's meaning.
+```
+
+For service planning docs or PRDs, a good request is:
+
+```text
+Use conjira to turn this Markdown file into a Confluence PRD. Keep the content faithful to the source, but make it easier to read in Confluence. Add status, callouts, and expand blocks where they improve readability, and organize the page around summary, background, problem, scope, flow, risks, and open questions.
+```
+
+For strategy reports or review decks, a good request is:
+
+```text
+Use conjira to publish this Markdown file as a report-style Confluence page. Keep the source content intact, but optimize the page for presentation. Put the executive summary first, surface key decisions and risks early, and use status, info blocks, expand sections, and Mermaid where appropriate.
+```
+
+If you want to stay closer to raw Markdown, say `keep this Markdown-first and avoid extra presentation macros`. If you want a more polished Confluence page, say `optimize this for Confluence readability while keeping the source content intact`.
+
+## Document writing style guide
+
+For Confluence uploads, structure matters as much as accuracy. Strategy memos, PRDs, planning docs, and report-style pages read much better when the writer uses a compact working-document style instead of long essay-like prose.
+
+Prefer report-style memo wording over verbose formal phrasing. In Korean this usually means reducing repetitive `~입니다` and `~합니다`, and favoring shorter noun-phrase or judgment-oriented endings such as `~필요`, `~전제`, `~검토`, `~제안`, or `~우선`. Do not force every sentence into rigid `~함` wording; the target is a concise internal memo tone, not mechanical shorthand. Keep paragraphs short, lead with the conclusion, and make `###` headings carry the message or judgment instead of acting as generic labels.
+
+Use bullet points only for true parallel items. Do not split a single thought into fake bullets just to reduce line length. Use tables for comparisons, summaries, options, risks, target groups, ownership, or decision support. Do not force short explanatory text into a table when a compact paragraph is clearer.
+
+A good default order is `purpose -> summary -> key judgments / evidence -> risks / assumptions -> implications / next actions`. Strategy memos usually need `why this matters`, `key judgment`, `evidence`, and `implications`. PRDs usually need `problem`, `goal`, `scope`, `flow`, `policy`, and `open issues`. Skill specs are better when they stay literal and dry, with sections like `one-line definition`, `when to use`, `inputs`, `outputs`, `exceptions`, and `evaluation criteria`.
+
+For longer strategy or report documents, explicit numbering helps. Top-level sections such as `A.`, `B.`, `C.` and second-level sections such as `A-1.`, `A-2.` usually make the table of contents and the body much easier to scan. As a default, stay within two levels unless the user explicitly wants a deeper document tree.
+
+Cut abstract filler. Avoid phrases like “strategically meaningful”, “fundamentally important value”, or “meaningful impact across multiple dimensions” unless they add something precise. Prefer concrete statements such as “follow-up gaps turn into revenue loss”, “A is the right first rollout option”, or “free-user monetization is necessary but total revenue impact is limited”.
+
+If you want an agent to follow this style explicitly, a good request is:
+
+```text
+Use conjira to publish this document to Confluence. Keep the source content intact, but rewrite it in a concise internal memo style. Reduce formal `~입니다/~합니다` phrasing, prefer short noun-phrase or judgment-oriented wording, put the key summary first, use stronger h3/h4 headings and tables where they help scanability, add `A.` / `A-1.` numbering when the document is long enough to benefit from it, keep bullets for true parallel items only, and remove abstract filler.
 ```
 
 Short sample output blocks, using synthetic values:
@@ -237,10 +286,12 @@ JIRA_PAT_FILE=/path/to/jira.token
 Then verify the connection:
 
 ```bash
-conjira --env-file ./local/agent.env auth-check
-conjira --env-file ./local/agent.env jira-auth-check
+conjira auth-check
+conjira jira-auth-check
 ```
 
+If you run the CLI outside the configured folder, use `--env-file /path/to/local/agent.env` explicitly.
+
 ## Common commands
 
 Read a Confluence page:
@@ -308,6 +359,14 @@ conjira --env-file ./local/agent.env jira-search --jql 'project = DEMO ORDER BY
 conjira --env-file ./local/agent.env jira-get-issue --issue-key DEMO-123
 ```
 
+Inspect updated timestamps or recent comments when needed:
+
+```bash
+conjira jira-get-issue --issue-key DEMO-123 --include-comments --comments-limit 2
+conjira jira-get-issue --issue-key DEMO-123 --raw --fields summary,updated,comment
+conjira jira-search --jql 'project = DEMO ORDER BY updated DESC' --raw --fields summary,updated
+```
+
 Create a Jira issue or add a comment:
 
 ```bash
@@ -374,7 +433,7 @@ The recommended pattern is to set `CONFLUENCE_EXPORT_DEFAULT_DIR` to an inbox or
 
 ## Markdown import notes
 
-Markdown upload is a best-effort conversion to Confluence storage HTML. It works well for common headings, paragraphs, lists, blockquotes, fenced code blocks, tables, links, images, and simple wiki-style links. It is not a perfect round-trip for complex Confluence macros, merged tables, or deeply nested layouts, so treat Markdown import as a practical authoring path rather than a lossless document converter.
+Markdown upload is a best-effort conversion to Confluence storage HTML. It works well for common headings, paragraphs, lists, blockquotes, fenced code blocks, tables, links, images, simple wiki-style links, and the currently supported report macros (`mermaid`, callouts, `expand`, and `:status[Title]{color=blue}`). It is not a perfect round-trip for complex Confluence macros, merged tables, or deeply nested layouts, so treat Markdown import as a practical authoring path rather than a lossless document converter.
 
 Use `--body-file` and `--append-file` only for storage HTML files. If your source file is Markdown, use `--body-markdown-file` or `--append-markdown-file` so the CLI converts it before upload.
 

{conjira_cli-0.2.1 → conjira_cli-0.2.3}/README.md

@@ -18,6 +18,8 @@ If your team uses self-hosted Confluence and Jira, official cloud-native connect
 
 `conjira-cli` is built for that gap. It helps when you want to read Confluence pages, export them to Markdown, refresh stale exports from the live wiki, summarize inline comment threads, search Jira with JQL, or create and update content without hardcoding PATs into source files or chat transcripts.
 
+For report-style pages, it can also preserve a small set of Confluence-native presentation macros while still keeping Markdown as the source of truth. The current bridge covers Mermaid, Markdown callouts such as `> [!INFO]`, `> [!NOTE]`, `> [!TIP]`, and `> [!WARNING]`, expandable blocks with `> [!EXPAND]`, and inline status badges with `:status[In Progress]{color=yellow}`.
+
 ## What you can do with it
 
 - read Confluence pages and search with CQL
@@ -83,6 +85,7 @@ The script stores PATs in macOS Keychain, writes only non-secret settings to `lo
 It uses the default Keychain target names automatically, so most users only need to enter the base URL and PAT.
 PAT prompts are hidden on screen by design. Paste the token and press Enter even if nothing appears while typing.
 It does not write PAT values to `~/.zshrc` or other shell profile files.
+If you keep working in the same folder, `conjira` will auto-load `./local/agent.env` so you do not need to pass `--env-file` each time.
 If you are running directly from a source checkout before installing entrypoints, you can still use:
 
 ```bash
@@ -101,9 +104,55 @@ If you are using Codex, Claude Code, or another shell-capable local coding agent
 If you want to run the CLI directly, start with these short commands:
 
 ```bash
-conjira --env-file ./local/agent.env auth-check
-conjira --env-file ./local/agent.env jira-auth-check
-conjira --env-file ./local/agent.env export-page-md --page-id 123456 --output-dir "/path/to/notes"
+conjira auth-check
+conjira jira-auth-check
+conjira export-page-md --page-id 123456 --output-dir "/path/to/notes"
+```
+
+If you run the CLI from a different folder, pass the config file explicitly with `--env-file /path/to/local/agent.env`.
+
+## Prompt templates by document type
+
+When you ask an agent to upload or update a document, results are better if you tell it what kind of document it is, whether Markdown should remain the source of truth, and whether the Confluence page should stay plain or become more presentation-friendly.
+
+For skill specs or evaluation docs, a good request is:
+
+```text
+Use conjira to upload this Markdown file as a Confluence page. Treat it as a skill spec, keep the Markdown structure as the source of truth, preserve headings and tables, and only use Confluence-native rendering where it helps readability without changing the document's meaning.
+```
+
+For service planning docs or PRDs, a good request is:
+
+```text
+Use conjira to turn this Markdown file into a Confluence PRD. Keep the content faithful to the source, but make it easier to read in Confluence. Add status, callouts, and expand blocks where they improve readability, and organize the page around summary, background, problem, scope, flow, risks, and open questions.
+```
+
+For strategy reports or review decks, a good request is:
+
+```text
+Use conjira to publish this Markdown file as a report-style Confluence page. Keep the source content intact, but optimize the page for presentation. Put the executive summary first, surface key decisions and risks early, and use status, info blocks, expand sections, and Mermaid where appropriate.
+```
+
+If you want to stay closer to raw Markdown, say `keep this Markdown-first and avoid extra presentation macros`. If you want a more polished Confluence page, say `optimize this for Confluence readability while keeping the source content intact`.
+
+## Document writing style guide
+
+For Confluence uploads, structure matters as much as accuracy. Strategy memos, PRDs, planning docs, and report-style pages read much better when the writer uses a compact working-document style instead of long essay-like prose.
+
+Prefer report-style memo wording over verbose formal phrasing. In Korean this usually means reducing repetitive `~입니다` and `~합니다`, and favoring shorter noun-phrase or judgment-oriented endings such as `~필요`, `~전제`, `~검토`, `~제안`, or `~우선`. Do not force every sentence into rigid `~함` wording; the target is a concise internal memo tone, not mechanical shorthand. Keep paragraphs short, lead with the conclusion, and make `###` headings carry the message or judgment instead of acting as generic labels.
+
+Use bullet points only for true parallel items. Do not split a single thought into fake bullets just to reduce line length. Use tables for comparisons, summaries, options, risks, target groups, ownership, or decision support. Do not force short explanatory text into a table when a compact paragraph is clearer.
+
+A good default order is `purpose -> summary -> key judgments / evidence -> risks / assumptions -> implications / next actions`. Strategy memos usually need `why this matters`, `key judgment`, `evidence`, and `implications`. PRDs usually need `problem`, `goal`, `scope`, `flow`, `policy`, and `open issues`. Skill specs are better when they stay literal and dry, with sections like `one-line definition`, `when to use`, `inputs`, `outputs`, `exceptions`, and `evaluation criteria`.
+
+For longer strategy or report documents, explicit numbering helps. Top-level sections such as `A.`, `B.`, `C.` and second-level sections such as `A-1.`, `A-2.` usually make the table of contents and the body much easier to scan. As a default, stay within two levels unless the user explicitly wants a deeper document tree.
+
+Cut abstract filler. Avoid phrases like “strategically meaningful”, “fundamentally important value”, or “meaningful impact across multiple dimensions” unless they add something precise. Prefer concrete statements such as “follow-up gaps turn into revenue loss”, “A is the right first rollout option”, or “free-user monetization is necessary but total revenue impact is limited”.
+
+If you want an agent to follow this style explicitly, a good request is:
+
+```text
+Use conjira to publish this document to Confluence. Keep the source content intact, but rewrite it in a concise internal memo style. Reduce formal `~입니다/~합니다` phrasing, prefer short noun-phrase or judgment-oriented wording, put the key summary first, use stronger h3/h4 headings and tables where they help scanability, add `A.` / `A-1.` numbering when the document is long enough to benefit from it, keep bullets for true parallel items only, and remove abstract filler.
 ```
 
 Short sample output blocks, using synthetic values:
@@ -208,10 +257,12 @@ JIRA_PAT_FILE=/path/to/jira.token
 Then verify the connection:
 
 ```bash
-conjira --env-file ./local/agent.env auth-check
-conjira --env-file ./local/agent.env jira-auth-check
+conjira auth-check
+conjira jira-auth-check
 ```
 
+If you run the CLI outside the configured folder, use `--env-file /path/to/local/agent.env` explicitly.
+
 ## Common commands
 
 Read a Confluence page:
@@ -279,6 +330,14 @@ conjira --env-file ./local/agent.env jira-search --jql 'project = DEMO ORDER BY
 conjira --env-file ./local/agent.env jira-get-issue --issue-key DEMO-123
 ```
 
+Inspect updated timestamps or recent comments when needed:
+
+```bash
+conjira jira-get-issue --issue-key DEMO-123 --include-comments --comments-limit 2
+conjira jira-get-issue --issue-key DEMO-123 --raw --fields summary,updated,comment
+conjira jira-search --jql 'project = DEMO ORDER BY updated DESC' --raw --fields summary,updated
+```
+
 Create a Jira issue or add a comment:
 
 ```bash
@@ -345,7 +404,7 @@ The recommended pattern is to set `CONFLUENCE_EXPORT_DEFAULT_DIR` to an inbox or
 
 ## Markdown import notes
 
-Markdown upload is a best-effort conversion to Confluence storage HTML. It works well for common headings, paragraphs, lists, blockquotes, fenced code blocks, tables, links, images, and simple wiki-style links. It is not a perfect round-trip for complex Confluence macros, merged tables, or deeply nested layouts, so treat Markdown import as a practical authoring path rather than a lossless document converter.
+Markdown upload is a best-effort conversion to Confluence storage HTML. It works well for common headings, paragraphs, lists, blockquotes, fenced code blocks, tables, links, images, simple wiki-style links, and the currently supported report macros (`mermaid`, callouts, `expand`, and `:status[Title]{color=blue}`). It is not a perfect round-trip for complex Confluence macros, merged tables, or deeply nested layouts, so treat Markdown import as a practical authoring path rather than a lossless document converter.
 
 Use `--body-file` and `--append-file` only for storage HTML files. If your source file is Markdown, use `--body-markdown-file` or `--append-markdown-file` so the CLI converts it before upload.
 

{conjira_cli-0.2.1 → conjira_cli-0.2.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "conjira-cli"
-version = "0.2.1"
+version = "0.2.3"
 description = "Unofficial agent-friendly CLI for self-hosted Confluence and Jira"
 readme = "README.md"
 requires-python = ">=3.9"

{conjira_cli-0.2.1 → conjira_cli-0.2.3}/src/conjira_cli/__init__.py

@@ -1,3 +1,3 @@
 __all__ = ["__version__"]
 
-__version__ = "0.2.1"
+__version__ = "0.2.3"

{conjira_cli-0.2.1 → conjira_cli-0.2.3}/src/conjira_cli/cli.py

@@ -26,6 +26,16 @@ from conjira_cli.markdown_import import markdown_to_storage_html
 from conjira_cli.section_edit import SectionEditError, replace_section_html
 from conjira_cli.tree_export import export_page_tree, sanitize_path_component
 
+_JIRA_SUMMARY_FIELDS = [
+    "summary",
+    "status",
+    "issuetype",
+    "project",
+    "assignee",
+    "reporter",
+    "updated",
+]
+
 
 def _read_text_arg(raw_text: Optional[str], file_path: Optional[str]) -> str:
     if raw_text is not None:
@@ -43,6 +53,21 @@ def _read_json_arg(raw_json: Optional[str], file_path: Optional[str]) -> Dict[st
     return {}
 
 
+def _merge_csv_fields(raw_fields: Optional[str], required_fields: list[str]) -> Optional[str]:
+    tokens: list[str] = []
+    seen: set[str] = set()
+    for value in [raw_fields, ",".join(required_fields)]:
+        if not value:
+            continue
+        for token in value.split(","):
+            item = token.strip()
+            if not item or item in seen:
+                continue
+            seen.add(item)
+            tokens.append(item)
+    return ",".join(tokens) if tokens else None
+
+
 def _read_confluence_body_arg(
     raw_html: Optional[str],
     html_file: Optional[str],
@@ -104,6 +129,62 @@ def _preview_html(value: Optional[str], limit: int = 240) -> Optional[str]:
     return _preview_text(preview, limit=limit)
 
 
+def _page_body_html(page: Dict[str, Any]) -> str:
+    return (((page.get("body") or {}).get("storage") or {}).get("value")) or ""
+
+
+def _is_effectively_empty_body(body_html: Optional[str]) -> bool:
+    if not body_html:
+        return True
+    normalized = body_html.replace("\xa0", " ").replace(" ", " ")
+    normalized = re.sub(r"<!--.*?-->", "", normalized, flags=re.DOTALL)
+    normalized = re.sub(r"<p>\s*(<br\s*/?>)?\s*</p>", "", normalized, flags=re.IGNORECASE)
+    normalized = re.sub(r"<br\s*/?>", "", normalized, flags=re.IGNORECASE)
+    normalized = re.sub(r"\s+", "", normalized)
+    return normalized == ""
+
+
+def _summarize_child_pages(child_pages: list[Dict[str, Any]]) -> list[Dict[str, Any]]:
+    return [ConfluenceClient.summarize_page(page) for page in child_pages]
+
+
+def _fallback_confluence_page_url(page: Dict[str, Any], page_id: Optional[str]) -> Optional[str]:
+    if not page_id:
+        return None
+    base_url = ((page.get("_links") or {}).get("base")) or ""
+    if not base_url:
+        return None
+    return "{0}/pages/viewpage.action?pageId={1}".format(base_url.rstrip("/"), page_id)
+
+
+def _page_navigation_payload(
+    *,
+    page: Dict[str, Any],
+    child_pages: list[Dict[str, Any]],
+) -> Dict[str, Any]:
+    body_html = _page_body_html(page)
+    body_is_effectively_empty = _is_effectively_empty_body(body_html)
+    child_summaries = _summarize_child_pages(child_pages)
+    for summary in child_summaries:
+        if not summary.get("webui_url"):
+            summary["webui_url"] = _fallback_confluence_page_url(page, summary.get("id"))
+    page_kind = "hub" if body_is_effectively_empty and child_summaries else "content"
+
+    payload: Dict[str, Any] = {
+        "page_kind": page_kind,
+        "body_is_effectively_empty": body_is_effectively_empty,
+        "child_count": len(child_summaries),
+    }
+    if child_summaries:
+        payload["children"] = child_summaries
+    if page_kind == "hub":
+        payload["read_hint"] = (
+            "This page behaves like a hub/index page. Read the listed child pages or use "
+            "`export-tree-md` for the full hierarchy."
+        )
+    return payload
+
+
 def _sanitize_markdown_filename(title: str) -> str:
     sanitized = "".join(
         "_" if char in '<>:"/\\|?*' else char
@@ -156,7 +237,7 @@ def _read_export_metadata(path: Path) -> Dict[str, Any]:
 
 def _page_export_payload(page: Dict[str, Any]) -> Dict[str, Any]:
     payload = ConfluenceClient.summarize_page(page)
-    payload["body_html"] = (((page.get("body") or {}).get("storage") or {}).get("value")) or ""
+    payload["body_html"] = _page_body_html(page)
     payload["ancestors"] = page.get("ancestors") or []
     return payload
 
@@ -353,6 +434,9 @@ def _build_parser() -> argparse.ArgumentParser:
     jira_get_issue.add_argument("--issue-key", required=True)
     jira_get_issue.add_argument("--fields")
     jira_get_issue.add_argument("--expand")
+    jira_get_issue.add_argument("--include-comments", action="store_true")
+    jira_get_issue.add_argument("--comments-limit", type=int, default=3)
+    jira_get_issue.add_argument("--raw", action="store_true")
 
     jira_search = subparsers.add_parser("jira-search", help="Search Jira with JQL")
     jira_search.add_argument("--jql", required=True)
@@ -360,6 +444,7 @@ def _build_parser() -> argparse.ArgumentParser:
     jira_search.add_argument("--start", type=int, default=0)
     jira_search.add_argument("--fields")
     jira_search.add_argument("--expand")
+    jira_search.add_argument("--raw", action="store_true")
 
     jira_get_createmeta = subparsers.add_parser(
         "jira-get-createmeta",
@@ -793,14 +878,19 @@ def _handle_confluence(args: argparse.Namespace) -> Dict[str, Any]:
     if args.command == "auth-check":
         return client.auth_check()
     if args.command == "get-page":
-        page = client.get_page(args.page_id, expand=args.expand)
+        expand = _merge_csv_fields(args.expand, ["body.storage", "version", "space"])
+        page = client.get_page(args.page_id, expand=expand)
+        child_pages = client.list_child_pages(args.page_id)
         payload = client.summarize_page(page)
+        payload.update(_page_navigation_payload(page=page, child_pages=child_pages))
         if args.expand and "body.storage" in args.expand:
-            payload["body_html"] = (((page.get("body") or {}).get("storage") or {}).get("value"))
+            payload["body_html"] = _page_body_html(page)
         return payload
     if args.command == "export-page-md":
         page = client.get_page(args.page_id, expand="body.storage,version,space")
+        child_pages = client.list_child_pages(args.page_id)
         payload = _page_export_payload(page)
+        payload.update(_page_navigation_payload(page=page, child_pages=child_pages))
         exporter = MarkdownExporter(
             base_url=settings.base_url,
             page_id=args.page_id,
@@ -823,6 +913,9 @@ def _handle_confluence(args: argparse.Namespace) -> Dict[str, Any]:
             "title": payload["title"],
             "output_file": str(output_path),
             "source_url": payload["webui_url"],
+            "page_kind": payload["page_kind"],
+            "child_count": payload["child_count"],
+            "hub_generated": payload["page_kind"] == "hub",
             "used_staging_local": str(output_path).startswith(
                 str((Path(settings.export_staging_dir) if settings.export_staging_dir else _default_export_staging_dir()))
             ),
@@ -1193,8 +1286,20 @@ def _handle_jira(args: argparse.Namespace) -> Dict[str, Any]:
     if args.command == "jira-auth-check":
         return client.auth_check()
     if args.command == "jira-get-issue":
-        issue = client.get_issue(args.issue_key, fields=args.fields, expand=args.expand)
-        return client.summarize_issue(issue)
+        fields = args.fields
+        if args.include_comments:
+            required_fields = ["comment", "updated"]
+            if args.fields is None:
+                required_fields = _JIRA_SUMMARY_FIELDS + ["comment"]
+            fields = _merge_csv_fields(args.fields, required_fields)
+        issue = client.get_issue(args.issue_key, fields=fields, expand=args.expand)
+        if args.raw:
+            return issue
+        return client.summarize_issue(
+            issue,
+            include_comments=args.include_comments,
+            comments_limit=args.comments_limit,
+        )
     if args.command == "jira-search":
         result = client.search(
             jql=args.jql,
@@ -1203,6 +1308,8 @@ def _handle_jira(args: argparse.Namespace) -> Dict[str, Any]:
             fields=args.fields,
             expand=args.expand,
         )
+        if args.raw:
+            return result
         return client.summarize_search_results(result.get("issues", []))
     if args.command == "jira-get-createmeta":
         result = client.get_createmeta(

{conjira_cli-0.2.1 → conjira_cli-0.2.3}/src/conjira_cli/client.py

@@ -540,14 +540,32 @@ class JiraClient(BaseAtlassianClient):
             return None
         return "{0}/browse/{1}".format(base_url.rstrip("/"), issue_key)
 
-    def summarize_issue(self, issue: Dict[str, Any]) -> Dict[str, Any]:
+    @staticmethod
+    def _comment_body_preview(value: Any, limit: int = 280) -> Optional[str]:
+        if value is None:
+            return None
+        if isinstance(value, str):
+            collapsed = " ".join(value.split())
+        else:
+            collapsed = " ".join(json.dumps(value, ensure_ascii=False).split())
+        if len(collapsed) <= limit:
+            return collapsed
+        return collapsed[: limit - 1].rstrip() + "…"
+
+    def summarize_issue(
+        self,
+        issue: Dict[str, Any],
+        *,
+        include_comments: bool = False,
+        comments_limit: int = 3,
+    ) -> Dict[str, Any]:
         fields = issue.get("fields") or {}
         status = fields.get("status") or {}
         issue_type = fields.get("issuetype") or {}
         project = fields.get("project") or {}
         assignee = fields.get("assignee") or {}
         reporter = fields.get("reporter") or {}
-        return {
+        summary = {
             "id": issue.get("id"),
             "key": issue.get("key"),
             "summary": fields.get("summary"),
@@ -556,8 +574,25 @@ class JiraClient(BaseAtlassianClient):
             "project_key": project.get("key"),
             "assignee": assignee.get("displayName"),
             "reporter": reporter.get("displayName"),
+            "updated": fields.get("updated"),
             "browse_url": self.browse_url(self.base_url, issue.get("key")),
         }
+        if include_comments:
+            comment_block = fields.get("comment") or {}
+            comments = comment_block.get("comments") or []
+            limited = comments[-comments_limit:] if comments_limit > 0 else comments
+            summary["comment_count"] = comment_block.get("total", len(comments))
+            summary["recent_comments"] = [
+                {
+                    "id": comment.get("id"),
+                    "author": ((comment.get("author") or {}).get("displayName")),
+                    "created": comment.get("created"),
+                    "updated": comment.get("updated"),
+                    "body_preview": self._comment_body_preview(comment.get("body")),
+                }
+                for comment in limited
+            ]
+        return summary
 
     def summarize_search_results(self, items: Iterable[Dict[str, Any]]) -> Dict[str, Any]:
         results = [self.summarize_issue(item) for item in items]

{conjira_cli-0.2.1 → conjira_cli-0.2.3}/src/conjira_cli/config.py

@@ -56,6 +56,16 @@ def load_env_file(path: Path) -> Dict[str, str]:
     return values
 
 
+def resolve_env_file_path(env_file: Optional[str]) -> Optional[str]:
+    if env_file:
+        return str(Path(env_file).expanduser())
+
+    default_local_env = Path.cwd() / "local" / "agent.env"
+    if default_local_env.exists():
+        return str(default_local_env)
+    return None
+
+
 def _parse_csv_set(value: Optional[str]) -> Optional[Set[str]]:
     if not value:
         return None
@@ -103,8 +113,9 @@ def _resolve_common_settings(
     env_file: Optional[str] = None,
 ) -> Tuple[Dict[str, str], str, str, int]:
     env: Dict[str, str] = {}
-    if env_file:
-        env = load_env_file(Path(env_file))
+    resolved_env_file = resolve_env_file_path(env_file)
+    if resolved_env_file:
+        env = load_env_file(Path(resolved_env_file))
 
     base_url_key = "{0}_BASE_URL".format(prefix)
     token_key = "{0}_PAT".format(prefix)