atlassian-cli 0.8.0__tar.gz → 0.10.0__tar.gz

{atlassian_cli-0.8.0/src/atlassian_cli.egg-info → atlassian_cli-0.10.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlassian-cli
-Version: 0.8.0
+Version: 0.10.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.8.0 → atlassian_cli-0.10.0}/pyproject.toml

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

{atlassian_cli-0.8.0 → atlassian_cli-0.10.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()
@@ -213,12 +218,18 @@ def cmd_create(args):
 
 
 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.
+                          new_title=None, new_parent_id=None, new_space_id=None,
+                          message=None):
+    """Update a page's title, parentId and/or spaceId 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.
+
+    Setting `new_space_id` moves the page to a different space (cross-space
+    move). If you cross spaces you also need a parent in the destination
+    space (Confluence doesn't allow space-root pages via this endpoint), so
+    callers should normally pass new_parent_id alongside new_space_id.
     """
     remote = get_page(session, base, page_id)
     current_title = remote.get('title', '')
@@ -240,18 +251,29 @@ def _modify_page_metadata(session, base, page_id, *,
     }
     if new_parent_id is not None:
         payload['parentId'] = str(new_parent_id)
+    if new_space_id is not None:
+        payload['spaceId'] = str(new_space_id)
     api_put(session, base, f'{V2}/pages/{page_id}', payload)
     return title, new_version
 
 
 def cmd_move(args):
     session, base = setup()
+    space_id = getattr(args, 'space_id', None)
+    msg = getattr(args, 'message', None)
+    if space_id:
+        msg = msg or f'Moved to space {space_id} under parent {args.parent_id}'
+    else:
+        msg = msg or f'Moved under parent {args.parent_id}'
     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}',
+        new_space_id=space_id,
+        message=msg,
     )
-    emit('OK', f'Moved {args.page_id} ({new_title}) -> parent {args.parent_id} (v{new_version})')
+    suffix = f' in space {space_id}' if space_id else ''
+    emit('OK',
+         f'Moved {args.page_id} ({new_title}) -> parent {args.parent_id}{suffix} (v{new_version})')
 
 
 def cmd_rename(args):
@@ -264,6 +286,30 @@ def cmd_rename(args):
     emit('OK', f'Renamed {args.page_id} -> {new_title!r} (v{new_version})')
 
 
+def cmd_archive(args):
+    """Archive a page (and optionally its descendants) via the V2 bulk
+    archive endpoint."""
+    session, base = setup()
+    body = {'pages': [{'id': str(args.page_id)}]}
+    result = api_post(session, base, f'{V2}/pages/archive', body)
+    # The endpoint returns a long-running task descriptor; the page becomes
+    # archived asynchronously. We surface the task link so the caller can
+    # poll if they need confirmation.
+    links = result.get('links', {}) if isinstance(result, dict) else {}
+    status_link = links.get('status', '')
+    emit('OK', f'Archive submitted for {args.page_id}', data={'task': status_link})
+
+
+def cmd_unarchive(args):
+    """Restore a previously archived page via the V2 bulk restore endpoint."""
+    session, base = setup()
+    body = {'pages': [{'id': str(args.page_id)}]}
+    result = api_post(session, base, f'{V2}/pages/restore', body)
+    links = result.get('links', {}) if isinstance(result, dict) else {}
+    status_link = links.get('status', '')
+    emit('OK', f'Restore submitted for {args.page_id}', data={'task': status_link})
+
+
 def cmd_delete(args):
     session, base = setup()
     page = get_page(session, base, args.page_id)
@@ -431,11 +477,12 @@ def cmd_index(args):
     spaces = args.space if args.space else ['POL', 'COMPLY']
     index = {}
 
+    statuses = ('current', 'archived') if getattr(args, 'include_archived', False) 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:
@@ -445,6 +492,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)
 
@@ -956,9 +1004,11 @@ 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 = sub.add_parser('move', help='Move a page to a new parent (preserves body); '
+                                    'optionally to a different space')
     p.add_argument('page_id', help='Confluence page ID to move')
     p.add_argument('parent_id', help='New parent page ID')
+    p.add_argument('--space-id', help='Destination space ID (cross-space move)')
     p.add_argument('--message', '-m', help='Version message')
     p.set_defaults(func=cmd_move)
 
@@ -968,6 +1018,14 @@ def main():
     p.add_argument('--message', '-m', help='Version message')
     p.set_defaults(func=cmd_rename)
 
+    p = sub.add_parser('archive', help='Archive a page (V2 bulk archive endpoint)')
+    p.add_argument('page_id', help='Confluence page ID to archive')
+    p.set_defaults(func=cmd_archive)
+
+    p = sub.add_parser('unarchive', help='Restore an archived page')
+    p.add_argument('page_id', help='Confluence page ID to restore')
+    p.set_defaults(func=cmd_unarchive)
+
     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)')
@@ -995,6 +1053,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.8.0 → atlassian_cli-0.10.0/src/atlassian_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atlassian-cli
-Version: 0.8.0
+Version: 0.10.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