janet-cli 0.3.3__py3-none-any.whl → 0.3.7__py3-none-any.whl

janet/__init__.py

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

janet/markdown/generator.py

@@ -47,11 +47,7 @@ class MarkdownGenerator:
         # 3. Description (pass attachments for inline image handling)
         sections.append(self._generate_description(ticket, attachments))
 
-        # 4. AI Summary (if available)
-        if ticket.get("ai_summary"):
-            sections.append(self._generate_ai_summary(ticket))
-
-        # 5. Comments
+        # 4. Comments
         if ticket.get("comments"):
             sections.append(
                 self._generate_comments(ticket["comments"], organization_members)
@@ -163,19 +159,6 @@ class MarkdownGenerator:
         lines.append("")  # Empty line after description
         return "\n".join(lines)
 
-    def _generate_ai_summary(self, ticket: Dict) -> str:
-        """Generate AI summary section."""
-        lines = ["## AI Summary\n"]
-
-        ai_summary = ticket.get("ai_summary", "").strip()
-        if ai_summary:
-            lines.append(ai_summary)
-        else:
-            lines.append("*No AI summary available*")
-
-        lines.append("")  # Empty line after AI summary
-        return "\n".join(lines)
-
     def _generate_comments(
         self, comments: List[Dict], organization_members: Optional[List[Dict]] = None
     ) -> str:

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.3.dist-info → janet_cli-0.3.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: janet-cli
-Version: 0.3.3
+Version: 0.3.7
 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.3.dist-info → janet_cli-0.3.7.dist-info}/RECORD

@@ -1,4 +1,4 @@
-janet/__init__.py,sha256=8HJ7ugSHr45rJ5jPmxsmBZMSFBCtEFzeLa5GBMTO4Kg,82
+janet/__init__.py,sha256=_QbRJk4Hf3jIynt4CrQztN386NAgz3nhYb4AtkXDrqg,82
 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=IMghHwEDSWdrG05RhZVMBGxlUoYHuLfcSkHsU9FuulA,11769
+janet/markdown/generator.py,sha256=Dj9n72oLvMaJmFsutH_3nFGsMrYheIQ9EIIOOVeMxhQ,11216
 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/readme_generator.py,sha256=ol4CC7yXYYoDrSPYbf0VASl-38uNjwKBg5klPNEnwUI,14032
 janet/sync/sse_watcher.py,sha256=L7iZfa4n77IImvywSPQf7PYxK9VVb8kjrVOS3qQ5xjQ,11157
 janet/sync/sync_engine.py,sha256=l4bV5KDbF86IVDAbMZRbFWwwP65TW--JqVkmJjXDnA4,9369
 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.3.dist-info/licenses/LICENSE,sha256=wNChlibp2El7r-zfLH8QhOg2oLPAvGwP7ETnVWyNRio,1065
-janet_cli-0.3.3.dist-info/METADATA,sha256=AcZ40rihR_ty7U9gbf8sro-ak97O_O5tqZ3wUNQXaTs,10311
-janet_cli-0.3.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-janet_cli-0.3.3.dist-info/entry_points.txt,sha256=MeYUkStK_xcqW3AylPNpQh_H5zmfojB1-d8WMhifkvw,40
-janet_cli-0.3.3.dist-info/top_level.txt,sha256=Ux5zWeRoPO3Tu87toTRoiwMkIQNQylV9aRO2g7KqNW4,6
-janet_cli-0.3.3.dist-info/RECORD,,
+janet_cli-0.3.7.dist-info/licenses/LICENSE,sha256=wNChlibp2El7r-zfLH8QhOg2oLPAvGwP7ETnVWyNRio,1065
+janet_cli-0.3.7.dist-info/METADATA,sha256=3IraPNmUIw9c1HSjoMdfGlOYAz_ntrcuEdvIf2pU7m4,10323
+janet_cli-0.3.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+janet_cli-0.3.7.dist-info/entry_points.txt,sha256=MeYUkStK_xcqW3AylPNpQh_H5zmfojB1-d8WMhifkvw,40
+janet_cli-0.3.7.dist-info/top_level.txt,sha256=Ux5zWeRoPO3Tu87toTRoiwMkIQNQylV9aRO2g7KqNW4,6
+janet_cli-0.3.7.dist-info/RECORD,,