janet-cli 0.3.5__py3-none-any.whl → 0.3.8__py3-none-any.whl

janet/__init__.py

@@ -1,3 +1,8 @@
 """Janet AI CLI - Sync tickets to local markdown files."""
 
-__version__ = "0.3.5"
+from importlib.metadata import version, PackageNotFoundError
+
+try:
+    __version__ = version("janet-cli")
+except PackageNotFoundError:
+    __version__ = "0.0.0"  # Fallback for local development

janet/markdown/generator.py

@@ -22,6 +22,8 @@ class MarkdownGenerator:
         ticket: Dict,
         organization_members: Optional[List[Dict]] = None,
         attachments: Optional[Dict] = None,
+        org_id: Optional[str] = None,
+        project_id: Optional[str] = None,
     ) -> str:
         """
         Generate complete markdown document from ticket data.
@@ -30,18 +32,26 @@ class MarkdownGenerator:
             ticket: Ticket dictionary
             organization_members: List of organization members (for name resolution)
             attachments: Dictionary with direct_attachments and indirect_attachments
+            org_id: Organization ID for generating frontend link
+            project_id: Project ID for generating frontend link
 
         Returns:
             Complete markdown string
         """
         sections = []
 
-        # 1. Title
+        # 1. Link to Janet frontend (at the very top)
+        ticket_id = ticket.get("id")
+        if org_id and project_id and ticket_id:
+            link = self._generate_frontend_link(org_id, project_id, ticket_id)
+            sections.append(f"**View in Janet:** {link}\n")
+
+        # 2. Title
         ticket_key = ticket.get("ticket_key", "UNKNOWN")
         title = ticket.get("title", "Untitled")
         sections.append(f"# {ticket_key}: {title}\n")
 
-        # 2. Metadata
+        # 3. Metadata
         sections.append(self._generate_metadata(ticket, organization_members))
 
         # 3. Description (pass attachments for inline image handling)
@@ -240,6 +250,21 @@ class MarkdownGenerator:
         lines.append("")  # Empty line after child tasks
         return "\n".join(lines)
 
+    def _generate_frontend_link(self, org_id: str, project_id: str, ticket_id: str) -> str:
+        """
+        Generate link to view ticket in Janet frontend.
+
+        Args:
+            org_id: Organization ID
+            project_id: Project ID
+            ticket_id: Ticket ID
+
+        Returns:
+            Markdown link to Janet frontend
+        """
+        url = f"https://app.tryjanet.ai/dashboard/{org_id}/projects/{project_id}/{ticket_id}"
+        return url
+
     def _generate_footer(self, ticket_key: str) -> str:
         """Generate footer section."""
         export_date = self._format_date(datetime.utcnow().isoformat())

janet/sync/readme_generator.py

@@ -33,7 +33,7 @@ class ReadmeGenerator:
         sections = []
 
         # Header - addressing the AI agent directly
-        sections.append(f"# Project Tickets - {org_name}\n")
+        sections.append(f"# Instructions for AI Coding Agents - {org_name}\n")
         sections.append(
             "This directory contains project management tickets from Janet AI. "
             "Use these tickets to understand requirements, track work, and stay aligned with project goals.\n"
@@ -83,6 +83,28 @@ class ReadmeGenerator:
         sections.append("3. **Follow requirements** - Use ticket descriptions as specifications")
         sections.append("4. **Note priorities** - High/Critical tickets should be addressed first\n")
 
+        # Important notes for AI agents
+        sections.append("## ⚠️ IMPORTANT: Creating Tickets (Required Fields)\n")
+        sections.append("### Required Fields for Ticket Creation\n")
+        sections.append("**Every** ticket creation command **MUST** include:\n")
+        sections.append("1. **Title** - The ticket title (first positional argument)")
+        sections.append("2. **Project** - The project key using `--project` or `-p`")
+        sections.append("3. **Status** - A valid status using `--status` or `-s`\n")
+
+        sections.append("### Status Values Are Custom Per Project\n")
+        sections.append("Each project has custom status values (see \"Valid Statuses\" in Projects section above).\n")
+        sections.append("⚠️ **REQUIRED:** Always use a valid status from the project's \"Valid Statuses\" list.")
+        sections.append("⚠️ **If user doesn't specify a status:** Ask which status to use before running the command.")
+        sections.append("⚠️ **Never assume or guess status values** - they vary by project (e.g., \"To Do\" vs \"Backlog\" vs \"Open\").\n")
+
+        sections.append("### Example Workflow\n")
+        sections.append('**User prompt:** "Create a bug ticket in BACK for the login issue"\n')
+        sections.append("**Your response:** \"Which status should I use for the new ticket? Valid options for BACK are: To Do, In Progress, In Review, Done\"\n")
+        sections.append('**After user responds:** Run the command with the specified status:')
+        sections.append("```bash")
+        sections.append('janet ticket create "Fix login issue" -p BACK --status "To Do" --type Bug')
+        sections.append("```\n")
+
         # CLI commands for the AI - comprehensive reference
         sections.append("## CLI Commands Reference\n")
         sections.append("Use the `janet` CLI to create and update tickets.\n")
@@ -264,7 +286,7 @@ class ReadmeGenerator:
         readme_content = self.generate(org_name, projects, total_tickets, sync_time, project_statuses)
 
         # Write to root of sync directory
-        readme_path = sync_dir / "README.md"
+        readme_path = sync_dir / "AI_AGENT_INSTRUCTIONS.md"
         readme_path.write_text(readme_content, encoding="utf-8")
 
         return readme_path

janet/sync/sse_watcher.py

@@ -109,7 +109,10 @@ class SSEWatcher:
                         "direct_attachments": ticket_data.get("attachments", []),
                         "indirect_attachments": []
                     }
-                markdown = self.markdown_generator.generate(ticket_data, self.org_members, attachments)
+                org_id = self.config.selected_organization.id
+                markdown = self.markdown_generator.generate(
+                    ticket_data, self.org_members, attachments, org_id, project_id
+                )
                 self.file_manager.write_ticket(
                     org_name=self.org_name,
                     project_name=project_name,

janet/sync/sync_engine.py

@@ -168,8 +168,10 @@ class SyncEngine:
                     # Get pre-fetched attachments for this ticket
                     ticket_attachments = attachments_map.get(ticket_id)
 
+                    org_id = self.config.selected_organization.id
                     self._sync_single_ticket_fast(
-                        merged_ticket, org_name, project_name, org_members, ticket_attachments
+                        merged_ticket, org_name, project_name, org_members, ticket_attachments,
+                        org_id, project_id
                     )
                     synced_count += 1
                 except Exception as e:
@@ -188,6 +190,8 @@ class SyncEngine:
         project_name: str,
         org_members: Optional[List[Dict]] = None,
         attachments: Optional[Dict] = None,
+        org_id: Optional[str] = None,
+        project_id: Optional[str] = None,
     ) -> None:
         """
         Sync a single ticket (optimized - no individual API calls).
@@ -198,6 +202,8 @@ class SyncEngine:
             project_name: Project name
             org_members: Organization members for name resolution
             attachments: Pre-fetched attachments dict (from batch fetch)
+            org_id: Organization ID for generating frontend link
+            project_id: Project ID for generating frontend link
         """
         ticket_id = ticket.get("id")
 
@@ -224,7 +230,7 @@ class SyncEngine:
 
         # Generate markdown
         markdown = self.markdown_generator.generate(
-            ticket, org_members, attachments
+            ticket, org_members, attachments, org_id, project_id
         )
 
         # Write to file

{janet_cli-0.3.5.dist-info → janet_cli-0.3.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janet-cli
-Version: 0.3.5
+Version: 0.3.8
 Summary: CLI tool to sync Janet AI tickets to local markdown files
 Author-email: Janet AI <support@janet-ai.com>
 License: MIT
@@ -194,7 +194,7 @@ Tickets are organized in a clear hierarchy:
 
 ```
 janet-tickets/
-├── README.md                    # Context for AI agents
+├── AI_AGENT_INSTRUCTIONS.md     # Instructions for AI coding agents
 └── My Organization/
     ├── Backend/
     │   ├── BACK-1.md

{janet_cli-0.3.5.dist-info → janet_cli-0.3.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-janet/__init__.py,sha256=cODHITT3PX8MXvRmpY-mkcn_z1QP1pdN4jrAhCLFEHw,82
+janet/__init__.py,sha256=3vOjIbWOQBLG674GzJSTZefIoDGGcnApbUSx4tvZ0mA,255
 janet/__main__.py,sha256=nxsNRykF1aXRRSYNcMvohre4QDfpUzyr5JMyHRHWrwI,130
 janet/cli.py,sha256=A4R2-KTlTfBk4VwvMy5N5Zk22bP0abOuGgrCEGXO7cQ,40693
 janet/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -15,20 +15,20 @@ janet/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 janet/config/manager.py,sha256=Bs5YjHIzWPR-KuAFJyQL47ntU_JN87bGhROaYP0B3r4,3216
 janet/config/models.py,sha256=lnOcSlFTGVkEjCjNMOzq9OmPZ3KP0y7cvnoEHp5iQJY,2067
 janet/markdown/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-janet/markdown/generator.py,sha256=Dj9n72oLvMaJmFsutH_3nFGsMrYheIQ9EIIOOVeMxhQ,11216
+janet/markdown/generator.py,sha256=YLxGh1Sv1bLuXE2e6jPYIOViBqXsBoL8QRqDF3v-4Ow,12171
 janet/markdown/yjs_converter.py,sha256=9CCInQzyjbpyDciMSKaUXCNh3xPn0hAwWhl1RES0KVc,12768
 janet/sync/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 janet/sync/file_manager.py,sha256=fwV0VYP-0ZpwTAyDVqlVUPn3MB2wK6TvFQq450Lhr0I,5839
-janet/sync/readme_generator.py,sha256=xsc609Vw9iKEZWgnQ8Fiimg7HG4Ngc9fI4ah_eBISdI,12315
-janet/sync/sse_watcher.py,sha256=L7iZfa4n77IImvywSPQf7PYxK9VVb8kjrVOS3qQ5xjQ,11157
-janet/sync/sync_engine.py,sha256=l4bV5KDbF86IVDAbMZRbFWwwP65TW--JqVkmJjXDnA4,9369
+janet/sync/readme_generator.py,sha256=ol4CC7yXYYoDrSPYbf0VASl-38uNjwKBg5klPNEnwUI,14032
+janet/sync/sse_watcher.py,sha256=m-Qk0jmAiNTAZjhxvD4VBcY3iLLPMd45j4eUS3I3brw,11277
+janet/sync/sync_engine.py,sha256=u_9iv-ZdPpl-wzGID_8WjgsW0GkLIru8VPjw2yg3isU,9708
 janet/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 janet/utils/console.py,sha256=zMhX4HUXSco-or9KpqBJmYCzmfH_GWtvq-n2Sy6Dfgc,927
 janet/utils/errors.py,sha256=yxoVDF7ovMT7ooJA-8cvxJK8_3nWumGv7s1n8povi-4,783
 janet/utils/paths.py,sha256=JYp5gcSEjIbYNJaUcAwdpz6rmta9m0JzoBARC6_AWmM,1706
-janet_cli-0.3.5.dist-info/licenses/LICENSE,sha256=wNChlibp2El7r-zfLH8QhOg2oLPAvGwP7ETnVWyNRio,1065
-janet_cli-0.3.5.dist-info/METADATA,sha256=cxi2vtFo0ao6JhhWBCOGZaUBVWtVDbS0ITQDeO-Hb4E,10311
-janet_cli-0.3.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-janet_cli-0.3.5.dist-info/entry_points.txt,sha256=MeYUkStK_xcqW3AylPNpQh_H5zmfojB1-d8WMhifkvw,40
-janet_cli-0.3.5.dist-info/top_level.txt,sha256=Ux5zWeRoPO3Tu87toTRoiwMkIQNQylV9aRO2g7KqNW4,6
-janet_cli-0.3.5.dist-info/RECORD,,
+janet_cli-0.3.8.dist-info/licenses/LICENSE,sha256=wNChlibp2El7r-zfLH8QhOg2oLPAvGwP7ETnVWyNRio,1065
+janet_cli-0.3.8.dist-info/METADATA,sha256=CnA07FnZpIePe49L-gbTqM0ParDYHsueKHZKCeksiuE,10323
+janet_cli-0.3.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+janet_cli-0.3.8.dist-info/entry_points.txt,sha256=MeYUkStK_xcqW3AylPNpQh_H5zmfojB1-d8WMhifkvw,40
+janet_cli-0.3.8.dist-info/top_level.txt,sha256=Ux5zWeRoPO3Tu87toTRoiwMkIQNQylV9aRO2g7KqNW4,6
+janet_cli-0.3.8.dist-info/RECORD,,