atlassian-cli 0.7.0__tar.gz → 0.9.0__tar.gz

{atlassian_cli-0.7.0/src/atlassian_cli.egg-info → atlassian_cli-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlassian-cli
-Version: 0.7.0
+Version: 0.9.0
 Summary: Fast CLI tools for Atlassian Cloud (Confluence + Jira) — optimized for AI agents
 Author-email: Alex Fishlock <alex.fishlock@catapult.cx>
 License-Expression: MIT

{atlassian_cli-0.7.0 → atlassian_cli-0.9.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "atlassian-cli"
-version = "0.7.0"
+version = "0.9.0"
 description = "Fast CLI tools for Atlassian Cloud (Confluence + Jira) — optimized for AI agents"
 readme = "README.md"
 license = "MIT"

{atlassian_cli-0.7.0 → atlassian_cli-0.9.0}/src/atlassian_cli/confluence.py

@@ -72,10 +72,15 @@ def get_space(session, base, *, key=None, space_id=None):
     return space
 
 
-def list_pages(session, base, space_id):
-    """Cursor-paginated listing of all pages in a space."""
+def list_pages(session, base, space_id, statuses=('current',)):
+    """Cursor-paginated listing of pages in a space, filtered by status.
+
+    The V2 default returns *all* statuses (current, archived, draft, deleted)
+    which is rarely what callers want. We default to current-only and let the
+    caller widen the filter if needed."""
     pages = []
-    url = f'{base}{V2}/spaces/{space_id}/pages?limit=250&sort=id'
+    status_q = '&'.join(f'status={s}' for s in statuses)
+    url = f'{base}{V2}/spaces/{space_id}/pages?limit=250&sort=id&{status_q}'
     while url:
         resp = _retry(session.get, url)
         resp.raise_for_status()
@@ -212,6 +217,58 @@ def cmd_create(args):
     emit('OK', f'Created {result.get("title", args.title)} ({page_id})')
 
 
+def _modify_page_metadata(session, base, page_id, *,
+                          new_title=None, new_parent_id=None, message=None):
+    """Update a page's title and/or parentId without touching the body.
+
+    Confluence has no dedicated 'move' or 'rename' endpoint — both go through
+    PUT /pages/{id}, which requires the full body and a bumped version. Here
+    we fetch the current state and round-trip it with the requested changes.
+    """
+    remote = get_page(session, base, page_id)
+    current_title = remote.get('title', '')
+    title = new_title if new_title is not None else current_title
+    body_value = remote.get('body', {}).get('atlas_doc_format', {}).get('value')
+    if body_value is None:
+        body_value = {'type': 'doc', 'version': 1, 'content': []}
+    body_payload = {
+        'representation': 'atlas_doc_format',
+        'value': json.dumps(body_value) if not isinstance(body_value, str) else body_value,
+    }
+    new_version = _ver(remote) + 1
+    payload = {
+        'id': str(page_id),
+        'status': 'current',
+        'title': title,
+        'body': body_payload,
+        'version': {'number': new_version, 'message': message or 'Metadata updated'},
+    }
+    if new_parent_id is not None:
+        payload['parentId'] = str(new_parent_id)
+    api_put(session, base, f'{V2}/pages/{page_id}', payload)
+    return title, new_version
+
+
+def cmd_move(args):
+    session, base = setup()
+    new_title, new_version = _modify_page_metadata(
+        session, base, args.page_id,
+        new_parent_id=args.parent_id,
+        message=getattr(args, 'message', None) or f'Moved under parent {args.parent_id}',
+    )
+    emit('OK', f'Moved {args.page_id} ({new_title}) -> parent {args.parent_id} (v{new_version})')
+
+
+def cmd_rename(args):
+    session, base = setup()
+    new_title, new_version = _modify_page_metadata(
+        session, base, args.page_id,
+        new_title=args.title,
+        message=getattr(args, 'message', None) or f'Renamed to {args.title!r}',
+    )
+    emit('OK', f'Renamed {args.page_id} -> {new_title!r} (v{new_version})')
+
+
 def cmd_delete(args):
     session, base = setup()
     page = get_page(session, base, args.page_id)
@@ -379,11 +436,12 @@ def cmd_index(args):
     spaces = args.space if args.space else ['POL', 'COMPLY']
     index = {}
 
+    statuses = ('current', 'archived') if args.include_archived else ('current',)
     for space_key in spaces:
         space = get_space(session, base, key=space_key)
         space_id = space['id']
         print(f'Indexing {space_key}…', file=sys.stderr)
-        pages = list_pages(session, base, space_id)
+        pages = list_pages(session, base, space_id, statuses=statuses)
 
         index[space_key] = []
         for page in pages:
@@ -393,6 +451,7 @@ def cmd_index(args):
                 'parentId': page.get('parentId', ''),
                 'version': _ver(page),
                 'updatedAt': _ver_ts(page),
+                'status': page.get('status', 'current'),
             })
         print(f'  {space_key}: {len(pages)} pages', file=sys.stderr)
 
@@ -904,6 +963,18 @@ def main():
     p.add_argument('page_id', help='Confluence page ID')
     p.set_defaults(func=cmd_delete)
 
+    p = sub.add_parser('move', help='Move a page to a new parent (preserves body)')
+    p.add_argument('page_id', help='Confluence page ID to move')
+    p.add_argument('parent_id', help='New parent page ID')
+    p.add_argument('--message', '-m', help='Version message')
+    p.set_defaults(func=cmd_move)
+
+    p = sub.add_parser('rename', help='Rename a page (preserves body and parent)')
+    p.add_argument('page_id', help='Confluence page ID')
+    p.add_argument('title', help='New page title')
+    p.add_argument('--message', '-m', help='Version message')
+    p.set_defaults(func=cmd_rename)
+
     p = sub.add_parser('put', help='Upload local ADF to Confluence')
     p.add_argument('page_id', help='Confluence page ID')
     p.add_argument('--dir', default='pages', help='Pages directory (default: pages)')
@@ -931,6 +1002,8 @@ def main():
     p = sub.add_parser('index', help='Rebuild page-index.json from API')
     p.add_argument('--space', action='append', help='Space key(s) to index (default: POL COMPLY)')
     p.add_argument('--output', default='page-index.json', help='Output file (default: page-index.json)')
+    p.add_argument('--include-archived', action='store_true',
+                   help='Also include archived pages (default is current only)')
     p.set_defaults(func=cmd_index)
 
     p = sub.add_parser('comments', help='List comments on a page')

{atlassian_cli-0.7.0 → atlassian_cli-0.9.0/src/atlassian_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlassian-cli
-Version: 0.7.0
+Version: 0.9.0
 Summary: Fast CLI tools for Atlassian Cloud (Confluence + Jira) — optimized for AI agents
 Author-email: Alex Fishlock <alex.fishlock@catapult.cx>
 License-Expression: MIT