janet-cli 0.3.5__tar.gz → 0.3.8__tar.gz

{janet_cli-0.3.5/janet_cli.egg-info → janet_cli-0.3.8}/PKG-INFO

@@ -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 → janet_cli-0.3.8}/README.md

@@ -152,7 +152,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.8/janet/__init__.py

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

{janet_cli-0.3.5 → janet_cli-0.3.8}/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_cli-0.3.5 → janet_cli-0.3.8}/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_cli-0.3.5 → janet_cli-0.3.8}/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_cli-0.3.5 → janet_cli-0.3.8}/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 → janet_cli-0.3.8/janet_cli.egg-info}/PKG-INFO

@@ -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.8/janet_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+janet

{janet_cli-0.3.5 → janet_cli-0.3.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "janet-cli"
-version = "0.3.5"
+version = "0.3.8"
 description = "CLI tool to sync Janet AI tickets to local markdown files"
 readme = "README.md"
 requires-python = ">=3.8"

janet_cli-0.3.5/janet/__init__.py

@@ -1,3 +0,0 @@
-"""Janet AI CLI - Sync tickets to local markdown files."""
-
-__version__ = "0.3.5"

janet_cli-0.3.5/janet_cli.egg-info/top_level.txt

@@ -1,2 +0,0 @@
-janet
-janet-tickets