janet-cli 0.2.2__tar.gz

janet_cli-0.2.2/.env.example

@@ -0,0 +1,11 @@
+# Development Configuration
+# These are only needed for local development and testing
+# Production users don't need these - defaults are built-in
+
+# WorkOS Configuration (optional - defaults to production)
+# WORKOS_CLIENT_ID=client_01K3HX06N4GEBHXP0SG87B183V
+# WORKOS_API_URL=https://api.workos.com
+
+# Janet API Configuration (optional - defaults to https://api.tryjanet.ai)
+# Uncomment to use local backend:
+# JANET_API_BASE_URL=http://localhost:8000

janet_cli-0.2.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Janet AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

janet_cli-0.2.2/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include requirements.txt
+include .env.example
+recursive-include janet *.py

janet_cli-0.2.2/PKG-INFO

@@ -0,0 +1,220 @@
+Metadata-Version: 2.4
+Name: janet-cli
+Version: 0.2.2
+Summary: CLI tool to sync Janet AI tickets to local markdown files
+Author-email: Janet AI <support@janet-ai.com>
+License: MIT
+Project-URL: Homepage, https://github.com/janet-ai/janet-cli
+Project-URL: Repository, https://github.com/janet-ai/janet-cli
+Project-URL: Issues, https://github.com/janet-ai/janet-cli/issues
+Keywords: cli,janet,tickets,markdown,sync
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.12.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: keyring>=25.0.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: pycrdt>=0.9.0
+Requires-Dist: InquirerPy>=0.3.4
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: httpx-mock>=0.15.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: mypy>=1.8.0; extra == "dev"
+Requires-Dist: ruff>=0.2.0; extra == "dev"
+Dynamic: license-file
+
+# Janet AI CLI
+
+> Sync your Janet AI tickets to local markdown files for seamless integration with AI coding agents.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+## What is Janet AI?
+
+[Janet AI](https://tryjanet.ai) is an AI-native project management platform for modern software teams. The Janet CLI allows developers to sync their tickets locally as markdown files, enabling AI coding assistants like Claude Code, Cursor, and GitHub Copilot to have full project context.
+
+## Why Use the CLI?
+
+AI coding assistants work better when they understand your project's tickets, requirements, and priorities. By syncing Janet AI tickets to your workspace, AI agents can:
+
+- Reference specific tickets while writing code
+- Understand requirements and acceptance criteria
+- Answer questions about project priorities
+- Suggest implementations based on ticket descriptions
+
+## Installation
+
+```bash
+pip install janet-cli
+```
+
+## Quick Start
+
+### 1. Authenticate
+
+```bash
+janet login
+```
+
+### 2. Sync Tickets
+
+```bash
+janet sync
+```
+
+### 3. Use with AI Agents
+
+Your tickets are now available as markdown files! Point your AI coding agent to the sync directory.
+
+```bash
+# Example prompts for Claude Code, Cursor, etc:
+"Look at ticket CS-42 and implement the authentication flow"
+"What are the high priority tickets in the Backend project?"
+"Implement the feature described in PROJ-15"
+```
+
+## Usage
+
+### Basic Commands
+
+```bash
+# Authentication
+janet login                     # Authenticate with Janet AI
+janet logout                    # Clear credentials
+janet auth status               # Show authentication status
+
+# Organization Management
+janet org list                  # List your organizations
+janet org select <org-id>       # Switch organization
+
+# Project Management
+janet project list              # List projects in current org
+
+# Syncing
+janet sync                      # Interactive mode
+janet sync --all                # Sync all projects (skip selection)
+janet sync --dir ./tickets      # Specify custom directory
+
+# Status & Configuration
+janet status                    # Show overall status
+janet config show               # Display configuration
+janet --help                    # Show help
+```
+
+### Example Workflow
+
+```bash
+# First time setup
+janet login
+janet sync
+
+# Re-sync to get updates
+janet sync
+
+# Sync to specific directory
+cd /path/to/my/project
+janet sync --dir ./janet-tickets
+```
+
+## File Organization
+
+Tickets are organized in a clear hierarchy:
+
+```
+janet-tickets/
+├── README.md                    # Context for AI agents
+└── My Organization/
+    ├── Backend/
+    │   ├── BACK-1.md
+    │   ├── BACK-2.md
+    │   └── BACK-42.md
+    └── Frontend/
+        ├── FRONT-1.md
+        └── FRONT-15.md
+```
+
+## Markdown Format
+
+Each ticket is exported with complete information:
+
+```markdown
+# PROJ-42: Add user authentication
+
+## Metadata
+- **Status:** In Progress
+- **Priority:** High
+- **Type:** Feature
+- **Assignees:** John Doe, Jane Smith
+- **Created:** Jan 07, 2026 10:30 AM
+- **Updated:** Jan 07, 2026 02:45 PM
+- **Labels:** backend, security
+
+## Description
+
+We need to implement OAuth authentication...
+
+### Requirements
+- Support multiple auth providers
+- Handle token refresh
+- Secure token storage
+
+## Comments (2)
+
+### John Doe - Jan 07, 2026 11:00 AM
+
+Started working on the OAuth flow.
+
+### Jane Smith - Jan 07, 2026 01:30 PM
+
+Looks good! Add tests when done.
+
+## Attachments (1)
+
+### design-mockup.png
+- **Type:** image/png
+- **Uploaded by:** Jane Smith
+```
+
+## Configuration
+
+The CLI stores configuration at:
+- **macOS/Linux:** `~/.config/janet-cli/config.json`
+- **Windows:** `%APPDATA%\janet-cli\config.json`
+
+Configuration includes authentication tokens and your selected organization.
+
+## Requirements
+
+- Python 3.8 or higher
+- Janet AI account ([sign up](https://tryjanet.ai))
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+Built for [Janet AI](https://tryjanet.ai) - The AI-native project management platform backed by Y Combinator.
+
+---
+
+**Current Version:** 0.2.0
+**Status:** Production Ready ✅

janet_cli-0.2.2/README.md

@@ -0,0 +1,178 @@
+# Janet AI CLI
+
+> Sync your Janet AI tickets to local markdown files for seamless integration with AI coding agents.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+
+## What is Janet AI?
+
+[Janet AI](https://tryjanet.ai) is an AI-native project management platform for modern software teams. The Janet CLI allows developers to sync their tickets locally as markdown files, enabling AI coding assistants like Claude Code, Cursor, and GitHub Copilot to have full project context.
+
+## Why Use the CLI?
+
+AI coding assistants work better when they understand your project's tickets, requirements, and priorities. By syncing Janet AI tickets to your workspace, AI agents can:
+
+- Reference specific tickets while writing code
+- Understand requirements and acceptance criteria
+- Answer questions about project priorities
+- Suggest implementations based on ticket descriptions
+
+## Installation
+
+```bash
+pip install janet-cli
+```
+
+## Quick Start
+
+### 1. Authenticate
+
+```bash
+janet login
+```
+
+### 2. Sync Tickets
+
+```bash
+janet sync
+```
+
+### 3. Use with AI Agents
+
+Your tickets are now available as markdown files! Point your AI coding agent to the sync directory.
+
+```bash
+# Example prompts for Claude Code, Cursor, etc:
+"Look at ticket CS-42 and implement the authentication flow"
+"What are the high priority tickets in the Backend project?"
+"Implement the feature described in PROJ-15"
+```
+
+## Usage
+
+### Basic Commands
+
+```bash
+# Authentication
+janet login                     # Authenticate with Janet AI
+janet logout                    # Clear credentials
+janet auth status               # Show authentication status
+
+# Organization Management
+janet org list                  # List your organizations
+janet org select <org-id>       # Switch organization
+
+# Project Management
+janet project list              # List projects in current org
+
+# Syncing
+janet sync                      # Interactive mode
+janet sync --all                # Sync all projects (skip selection)
+janet sync --dir ./tickets      # Specify custom directory
+
+# Status & Configuration
+janet status                    # Show overall status
+janet config show               # Display configuration
+janet --help                    # Show help
+```
+
+### Example Workflow
+
+```bash
+# First time setup
+janet login
+janet sync
+
+# Re-sync to get updates
+janet sync
+
+# Sync to specific directory
+cd /path/to/my/project
+janet sync --dir ./janet-tickets
+```
+
+## File Organization
+
+Tickets are organized in a clear hierarchy:
+
+```
+janet-tickets/
+├── README.md                    # Context for AI agents
+└── My Organization/
+    ├── Backend/
+    │   ├── BACK-1.md
+    │   ├── BACK-2.md
+    │   └── BACK-42.md
+    └── Frontend/
+        ├── FRONT-1.md
+        └── FRONT-15.md
+```
+
+## Markdown Format
+
+Each ticket is exported with complete information:
+
+```markdown
+# PROJ-42: Add user authentication
+
+## Metadata
+- **Status:** In Progress
+- **Priority:** High
+- **Type:** Feature
+- **Assignees:** John Doe, Jane Smith
+- **Created:** Jan 07, 2026 10:30 AM
+- **Updated:** Jan 07, 2026 02:45 PM
+- **Labels:** backend, security
+
+## Description
+
+We need to implement OAuth authentication...
+
+### Requirements
+- Support multiple auth providers
+- Handle token refresh
+- Secure token storage
+
+## Comments (2)
+
+### John Doe - Jan 07, 2026 11:00 AM
+
+Started working on the OAuth flow.
+
+### Jane Smith - Jan 07, 2026 01:30 PM
+
+Looks good! Add tests when done.
+
+## Attachments (1)
+
+### design-mockup.png
+- **Type:** image/png
+- **Uploaded by:** Jane Smith
+```
+
+## Configuration
+
+The CLI stores configuration at:
+- **macOS/Linux:** `~/.config/janet-cli/config.json`
+- **Windows:** `%APPDATA%\janet-cli\config.json`
+
+Configuration includes authentication tokens and your selected organization.
+
+## Requirements
+
+- Python 3.8 or higher
+- Janet AI account ([sign up](https://tryjanet.ai))
+
+## License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+Built for [Janet AI](https://tryjanet.ai) - The AI-native project management platform backed by Y Combinator.
+
+---
+
+**Current Version:** 0.2.0
+**Status:** Production Ready ✅

janet_cli-0.2.2/janet/__init__.py

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

janet_cli-0.2.2/janet/__main__.py

@@ -0,0 +1,6 @@
+"""Entry point for running janet as a module: python -m janet"""
+
+from janet.cli import app
+
+if __name__ == "__main__":
+    app()

janet_cli-0.2.2/janet/api/client.py

@@ -0,0 +1,128 @@
+"""Base API client with authentication headers."""
+
+from typing import Dict, Optional
+
+import httpx
+
+from janet.auth.token_manager import TokenManager
+from janet.config.manager import ConfigManager
+from janet.utils.errors import NetworkError, AuthenticationError, TokenExpiredError
+
+
+class APIClient:
+    """Base API client for Janet AI."""
+
+    def __init__(self, config_manager: ConfigManager):
+        """
+        Initialize API client.
+
+        Args:
+            config_manager: Configuration manager instance
+        """
+        self.config_manager = config_manager
+        self.token_manager = TokenManager(config_manager)
+        self.config = config_manager.get()
+        self.base_url = self.config.api.base_url
+        self.timeout = self.config.api.timeout
+
+    def _get_headers(self, include_org: bool = False) -> Dict[str, str]:
+        """
+        Get request headers with authentication.
+
+        Args:
+            include_org: Whether to include organization ID header
+
+        Returns:
+            Dictionary of headers
+        """
+        try:
+            access_token = self.token_manager.get_access_token()
+        except TokenExpiredError:
+            # Try to refresh token
+            from janet.auth.oauth_flow import OAuthFlow
+
+            oauth_flow = OAuthFlow(self.config_manager)
+            try:
+                oauth_flow.refresh_token()
+                access_token = self.token_manager.get_access_token()
+            except Exception:
+                raise AuthenticationError(
+                    "Token expired and refresh failed. Please log in again."
+                )
+
+        headers = {
+            "Authorization": f"Bearer {access_token}",
+            "Content-Type": "application/json",
+        }
+
+        if include_org and self.config.selected_organization:
+            headers["X-Organization-ID"] = self.config.selected_organization.id
+
+        return headers
+
+    def get(self, endpoint: str, include_org: bool = False, **kwargs) -> Dict:
+        """
+        Make GET request.
+
+        Args:
+            endpoint: API endpoint (relative to base_url)
+            include_org: Whether to include organization ID header
+            **kwargs: Additional arguments for httpx.get
+
+        Returns:
+            Response JSON
+
+        Raises:
+            NetworkError: If request fails
+        """
+        url = f"{self.base_url}{endpoint}"
+        headers = self._get_headers(include_org=include_org)
+
+        try:
+            response = httpx.get(url, headers=headers, timeout=self.timeout, **kwargs)
+            response.raise_for_status()
+            return response.json()
+        except httpx.HTTPStatusError as e:
+            if e.response.status_code == 401:
+                raise AuthenticationError("Authentication failed. Please log in again.")
+            raise NetworkError(f"API request failed: {e.response.status_code} {e.response.text}")
+        except httpx.TimeoutException:
+            raise NetworkError(f"Request timeout after {self.timeout}s")
+        except Exception as e:
+            raise NetworkError(f"Network error: {e}")
+
+    def post(
+        self, endpoint: str, data: Optional[Dict] = None, include_org: bool = False, **kwargs
+    ) -> Dict:
+        """
+        Make POST request.
+
+        Args:
+            endpoint: API endpoint (relative to base_url)
+            data: Request body data
+            include_org: Whether to include organization ID header
+            **kwargs: Additional arguments for httpx.post
+
+        Returns:
+            Response JSON
+
+        Raises:
+            NetworkError: If request fails
+        """
+        url = f"{self.base_url}{endpoint}"
+        headers = self._get_headers(include_org=include_org)
+
+        try:
+            response = httpx.post(
+                url, headers=headers, json=data, timeout=self.timeout, **kwargs
+            )
+            response.raise_for_status()
+            return response.json()
+        except httpx.HTTPStatusError as e:
+            if e.response.status_code == 401:
+                raise AuthenticationError("Authentication failed. Please log in again.")
+            raise NetworkError(f"API request failed: {e.response.status_code} {e.response.text}")
+        except httpx.TimeoutException:
+            raise NetworkError(f"Request timeout after {self.timeout}s")
+        except Exception as e:
+            raise NetworkError(f"Network error: {e}")

janet_cli-0.2.2/janet/api/models.py

@@ -0,0 +1,92 @@
+"""Pydantic models for API responses."""
+
+from typing import List, Optional
+from datetime import datetime
+from pydantic import BaseModel
+
+
+class Comment(BaseModel):
+    """Ticket comment model."""
+
+    id: str
+    content: str
+    created_by: str
+    created_at: str
+    updated_at: str
+
+
+class Attachment(BaseModel):
+    """Ticket attachment model."""
+
+    id: str
+    mapping_id: str
+    original_filename: str
+    mime_type: str
+    file_size_bytes: int
+    gcs_uri: str
+    signed_url: Optional[str] = None
+    ai_description: Optional[str] = None
+    ai_processing_status: str
+    uploaded_by: str
+    created_at: str
+    is_direct: bool
+
+
+class ChildTask(BaseModel):
+    """Child task model."""
+
+    id: str
+    childIdentifier: str
+    fullIdentifier: str
+    title: str
+    description: Optional[str] = None
+    status: Optional[str] = None
+    priority: Optional[str] = None
+    assignee: Optional[str] = None
+    displayOrder: str
+    createdBy: str
+    updatedBy: Optional[str] = None
+    createdAt: str
+    updatedAt: str
+
+
+class Ticket(BaseModel):
+    """Ticket model."""
+
+    id: str
+    ticket_identifier: str
+    ticket_key: str
+    title: str
+    description: Optional[str] = None
+    description_yjs_binary: Optional[str] = None
+    ai_summary: Optional[str] = None
+    ticket_evaluation: Optional[str] = None
+    status: str
+    priority: str
+    issue_type: str
+    assignees: List[str] = []
+    labels: List[str] = []
+    story_points: Optional[str] = None
+    due_date: Optional[str] = None
+    sprint: Optional[str] = None
+    creator: str
+    project_id: str
+    organization_id: str
+    created_at: str
+    updated_at: str
+    comments: List[Comment] = []
+    child_tasks: List[ChildTask] = []
+
+
+class OrganizationMember(BaseModel):
+    """Organization member model."""
+
+    id: str
+    userId: str
+    email: str
+    firstName: Optional[str] = None
+    lastName: Optional[str] = None
+    profilePictureUrl: Optional[str] = None
+    role: str
+    status: str
+    joinedAt: str