janet-cli 0.2.2__py3-none-any.whl

janet/utils/errors.py

@@ -0,0 +1,49 @@
+"""Custom exception classes for Janet CLI."""
+
+
+class JanetCLIError(Exception):
+    """Base exception for all CLI errors."""
+
+    pass
+
+
+class AuthenticationError(JanetCLIError):
+    """Authentication failed or token expired."""
+
+    pass
+
+
+class OrganizationAccessError(JanetCLIError):
+    """User doesn't have access to organization."""
+
+    pass
+
+
+class NetworkError(JanetCLIError):
+    """Network request failed."""
+
+    pass
+
+
+class ConfigurationError(JanetCLIError):
+    """Invalid configuration."""
+
+    pass
+
+
+class SyncError(JanetCLIError):
+    """Sync operation failed."""
+
+    pass
+
+
+class TokenExpiredError(AuthenticationError):
+    """Access token has expired."""
+
+    pass
+
+
+class InvalidTokenError(AuthenticationError):
+    """Invalid or malformed token."""
+
+    pass

janet/utils/paths.py

@@ -0,0 +1,66 @@
+"""Path utilities for Janet CLI."""
+
+import re
+from pathlib import Path
+from platformdirs import user_config_dir, user_data_dir
+
+
+def get_config_dir() -> Path:
+    """Get configuration directory path."""
+    config_dir = Path(user_config_dir("janet-cli", appauthor=False))
+    config_dir.mkdir(parents=True, exist_ok=True)
+    return config_dir
+
+
+def get_data_dir() -> Path:
+    """Get data directory path."""
+    data_dir = Path(user_data_dir("janet-cli", appauthor=False))
+    data_dir.mkdir(parents=True, exist_ok=True)
+    return data_dir
+
+
+def get_config_file() -> Path:
+    """Get configuration file path."""
+    return get_config_dir() / "config.json"
+
+
+def sanitize_filename(name: str) -> str:
+    """
+    Sanitize a string to be safe for use as a filename.
+
+    Replaces invalid characters with hyphens and limits length.
+
+    Args:
+        name: String to sanitize
+
+    Returns:
+        Sanitized filename-safe string
+    """
+    # Replace invalid filesystem characters with hyphens
+    invalid_chars = r'[<>:"/\\|?*]'
+    sanitized = re.sub(invalid_chars, "-", name)
+
+    # Remove leading/trailing whitespace and dots
+    sanitized = sanitized.strip(". ")
+
+    # Replace multiple consecutive hyphens with single hyphen
+    sanitized = re.sub(r"-+", "-", sanitized)
+
+    # Limit length to 255 characters (filesystem limit)
+    if len(sanitized) > 255:
+        sanitized = sanitized[:255].rstrip("-")
+
+    return sanitized if sanitized else "unnamed"
+
+
+def expand_path(path: str) -> Path:
+    """
+    Expand user home directory and resolve path.
+
+    Args:
+        path: Path string (may contain ~)
+
+    Returns:
+        Resolved absolute Path
+    """
+    return Path(path).expanduser().resolve()

janet_cli-0.2.2.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,33 @@
+janet/__init__.py,sha256=Bk05WAYOzsZs3TKPbv1UYe-sbc5J60ppx0B3iwuG5v4,82
+janet/__main__.py,sha256=nxsNRykF1aXRRSYNcMvohre4QDfpUzyr5JMyHRHWrwI,130
+janet/cli.py,sha256=AxjY76l5d7NnsaYEEvUP4dJ1LxXsY1Ya-uNaTGSfXd8,20391
+janet/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+janet/api/client.py,sha256=fiIpCaQlvXBn_T2VGf0sT9jyQE83Xx7o_WJkCDnwykY,4399
+janet/api/models.py,sha256=41or0kCcEJ3KJ2QCdV1xbrAoAcma_DteqqVlO0Ng18g,2002
+janet/api/organizations.py,sha256=abaita6e2drm6RikTOfU-E1ohPeRPhiTYmWRFG0kqaQ,1539
+janet/api/projects.py,sha256=Oxao4vvXMuXWMfUwZUuBrhkSUtC8t57FNc2d6Qzd5ms,1488
+janet/api/tickets.py,sha256=k8EKrShdRVmevNbZahchJI_0iiHosP1QLCWfyFsXGxo,3346
+janet/auth/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+janet/auth/callback_server.py,sha256=mLkkQMMN6PnNUFf4mlQyY3eKOgK1W6_9O9u90xsLMhY,12499
+janet/auth/oauth_flow.py,sha256=YaLQVRXyhAvZ3IWkd3AvjQlCkQgRRjhPEU9fXfZBgko,9133
+janet/auth/token_manager.py,sha256=YxqSmIRiueGYmDxvPeRt--dLpXSfeFd61qCW91FTujU,2721
+janet/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+janet/config/manager.py,sha256=Bs5YjHIzWPR-KuAFJyQL47ntU_JN87bGhROaYP0B3r4,3216
+janet/config/models.py,sha256=2ZLAgM5CwuwQF0C0mZGjxrJO_ECgDGCQ6rnOg68sBp0,1741
+janet/markdown/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+janet/markdown/generator.py,sha256=CgjvCjkna7XsigsrurdSnAXVPYajLQjlP8puuKkSTVM,9168
+janet/markdown/yjs_converter.py,sha256=omoT6dZ0K3UIoSun2fczTw56vbTrHomz64no3U0YUwo,8482
+janet/sync/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+janet/sync/file_manager.py,sha256=fwV0VYP-0ZpwTAyDVqlVUPn3MB2wK6TvFQq450Lhr0I,5839
+janet/sync/readme_generator.py,sha256=RHfqlr-3oyGIy5zRbMcloAo1rrwy5aSqAvleC49QZME,6847
+janet/sync/sync_engine.py,sha256=4WEQ6wmcwTWg1cZurQCZTcSBZhKkUtw4eBKUsAcL6WY,9779
+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.2.2.dist-info/licenses/LICENSE,sha256=wNChlibp2El7r-zfLH8QhOg2oLPAvGwP7ETnVWyNRio,1065
+janet_cli-0.2.2.dist-info/METADATA,sha256=8121OXbTb0ZXUbkZ5h0jrNYbCxK8i3I_EvKy3onIgq0,5941
+janet_cli-0.2.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+janet_cli-0.2.2.dist-info/entry_points.txt,sha256=MeYUkStK_xcqW3AylPNpQh_H5zmfojB1-d8WMhifkvw,40
+janet_cli-0.2.2.dist-info/top_level.txt,sha256=Ux5zWeRoPO3Tu87toTRoiwMkIQNQylV9aRO2g7KqNW4,6
+janet_cli-0.2.2.dist-info/RECORD,,

janet_cli-0.2.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

janet_cli-0.2.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+janet = janet.cli:app

janet_cli-0.2.2.dist-info/licenses/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.dist-info/top_level.txt

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