@stravica-ai/digital-operator-pa 0.1.39 → 0.1.41

package/dist/engineering-pa-core-extensions-atlassian/src/confluence/commands/comment.mjs

@@ -0,0 +1,174 @@
+// comment.mjs - Add or list comments on a Confluence page.
+//
+// Usage:
+//   confluence comment <ID> <TEXT...>    Add a comment
+//   confluence comment <ID> --list       List comments
+//
+// Uses v1 endpoint for writing comments (v2 POST returns 405).
+// Uses v2 endpoint for reading comments.
+
+import { createClient, ConfluenceError } from '../client.mjs';
+import { textToStorage, storageToText } from '../storage.mjs';
+import { formatComment, bold, dim, green } from '../format.mjs';
+
+const HELP = `confluence comment - Add or list comments on a page
+
+Usage:
+  confluence comment <ID> <TEXT>         Add a comment to a page
+  confluence comment <ID> -- <TEXT>      Add a comment (text after --)
+  confluence comment <ID> --list         List recent comments
+
+Options:
+  --list          List comments instead of adding one
+  --help, -h      Show this help
+
+Comments are added via the v1 API (v2 POST returns 405).
+Comment text is converted to Confluence storage format.
+
+Examples:
+  confluence comment 12345 "This page needs updating."
+  confluence comment 12345 --list
+`;
+
+/**
+ * Parse comment command args.
+ * Handles -- separator, --list flag, and positional args.
+ */
+function parseCommentArgs(argv) {
+  let pageId = null;
+  let list = false;
+  const textParts = [];
+  let afterDash = false;
+
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === '--') {
+      afterDash = true;
+      continue;
+    }
+    if (afterDash) {
+      textParts.push(argv[i]);
+      continue;
+    }
+    if (argv[i] === '--list') {
+      list = true;
+      continue;
+    }
+    if (argv[i] === '--help' || argv[i] === '-h') {
+      return { pageId: null, text: null, list: false, help: true };
+    }
+    if (!pageId) {
+      pageId = argv[i];
+    } else {
+      textParts.push(argv[i]);
+    }
+  }
+
+  const text = textParts.length > 0 ? textParts.join(' ') : null;
+  return { pageId, text, list, help: false };
+}
+
+/**
+ * Run the comment command.
+ *
+ * @param {string[]} argv  Remaining args after 'comment'
+ * @param {object} [deps]  Dependency overrides
+ * @returns {Promise<number>}  Exit code
+ */
+export async function run(argv = [], deps = {}) {
+  const log = deps.log || console.log;
+  const logError = deps.logError || console.error;
+
+  const { pageId, text, list, help } = parseCommentArgs(argv);
+
+  if (help) {
+    log(HELP);
+    return 0;
+  }
+
+  if (!pageId) {
+    logError('Usage: confluence comment <ID> <TEXT>\n       confluence comment <ID> --list');
+    return 1;
+  }
+
+  const client = deps.client || createClient();
+
+  if (list) {
+    return listComments(client, pageId, log, logError);
+  }
+
+  if (!text) {
+    logError('Usage: confluence comment <ID> <TEXT>\nProvide comment text as arguments or after --');
+    return 1;
+  }
+
+  return addComment(client, pageId, text, log, logError);
+}
+
+/**
+ * List comments on a page (via v2 endpoint).
+ */
+async function listComments(client, pageId, log, logError) {
+  try {
+    const comments = [];
+    for await (const comment of client.paginateCursor(
+      `/wiki/api/v2/pages/${encodeURIComponent(pageId)}/footer-comments`,
+      { 'body-format': 'storage' }
+    )) {
+      comments.push(comment);
+    }
+
+    if (comments.length === 0) {
+      log(dim(`No comments on page ${pageId}.`));
+      return 0;
+    }
+
+    log(bold(`Comments on page ${pageId}`) + dim(` (${comments.length})\n`));
+
+    for (const comment of comments) {
+      // Render storage body to text
+      const bodyStorage = comment.body?.storage?.value || '';
+      comment._bodyText = storageToText(bodyStorage);
+      log(formatComment(comment));
+      log('');
+    }
+
+    return 0;
+  } catch (err) {
+    if (err instanceof ConfluenceError) {
+      logError(`Failed to list comments: ${err.message}`);
+      return err.exitCode;
+    }
+    throw err;
+  }
+}
+
+/**
+ * Add a comment to a page (via v1 endpoint - v2 POST returns 405).
+ */
+async function addComment(client, pageId, text, log, logError) {
+  try {
+    const storageBody = textToStorage(text);
+    const { data } = await client.post('/wiki/rest/api/content', {
+      type: 'comment',
+      container: {
+        id: pageId,
+        type: 'page',
+      },
+      body: {
+        storage: {
+          value: storageBody,
+          representation: 'storage',
+        },
+      },
+    });
+
+    log(green(`Comment added to page ${pageId}.`) + dim(` (id: ${data.id})`));
+    return 0;
+  } catch (err) {
+    if (err instanceof ConfluenceError) {
+      logError(`Failed to add comment: ${err.message}`);
+      return err.exitCode;
+    }
+    throw err;
+  }
+}

package/dist/engineering-pa-core-extensions-atlassian/src/confluence/commands/create.mjs

@@ -0,0 +1,136 @@
+// create.mjs - Create a Confluence page.
+//
+// Usage:
+//   confluence create -s SPACE_KEY -t TITLE [--from-file FILE.md] [-b BODY] [--parent ID]
+//
+// If --from-file, reads the markdown file and converts to storage format.
+// If -b, converts inline body text to storage format.
+// Returns page ID + URL.
+
+import { createClient, ConfluenceError } from '../client.mjs';
+import { markdownToStorage, textToStorage } from '../storage.mjs';
+import { bold, green } from '../format.mjs';
+import { readFileSync } from 'node:fs';
+
+const HELP = `confluence create - Create a new page
+
+Usage:
+  confluence create -s SPACE_KEY -t TITLE [--from-file FILE.md] [-b BODY] [--parent ID]
+
+Options:
+  -s SPACE_KEY      Space key (required)
+  -t TITLE          Page title (required)
+  --from-file FILE  Read markdown content from file
+  -b BODY           Inline body text (converted to storage format)
+  --parent ID       Parent page ID (for nesting)
+  --help, -h        Show this help
+
+If --from-file is given, the file is read as markdown and converted to
+Confluence storage format. If -b is given, the text is converted to basic
+storage format. If neither is given, an empty page is created.
+
+Examples:
+  confluence create -s DEV -t "API Docs" --from-file ./docs/api.md
+  confluence create -s DEV -t "Quick Note" -b "This is a quick note."
+  confluence create -s DEV -t "Sub Page" --parent 12345
+`;
+
+/**
+ * Resolve a space key to a space ID via the v2 API.
+ */
+async function resolveSpaceId(client, spaceKey) {
+  const { data } = await client.get(
+    `/wiki/api/v2/spaces?keys=${encodeURIComponent(spaceKey)}&limit=1`
+  );
+  const results = data.results || [];
+  if (results.length === 0) {
+    throw new ConfluenceError(`Space not found: ${spaceKey}`, 2);
+  }
+  return results[0].id;
+}
+
+/**
+ * Run the create command.
+ *
+ * @param {string[]} argv  Remaining args after 'create'
+ * @param {object} [deps]  Dependency overrides
+ * @returns {Promise<number>}  Exit code
+ */
+export async function run(argv = [], deps = {}) {
+  const log = deps.log || console.log;
+  const logError = deps.logError || console.error;
+  const { parseArgs } = await import('../cli.mjs');
+  const args = parseArgs(argv);
+
+  if (args.help || args.h) {
+    log(HELP);
+    return 0;
+  }
+
+  const spaceKey = args.s || args.space;
+  const title = args.t || args.title;
+  const fromFile = args['from-file'] || null;
+  const bodyText = args.b || args.body || null;
+  const parentId = args.parent || null;
+
+  // Validate required fields
+  const missing = [];
+  if (!spaceKey) missing.push('-s SPACE_KEY');
+  if (!title) missing.push('-t TITLE');
+
+  if (missing.length > 0) {
+    logError(`Missing required fields: ${missing.join(', ')}`);
+    logError('Usage: confluence create -s SPACE_KEY -t TITLE [--from-file FILE.md] [-b BODY]');
+    return 1;
+  }
+
+  const client = deps.client || createClient();
+
+  try {
+    // Resolve space key to ID
+    const spaceId = await resolveSpaceId(client, spaceKey.toUpperCase());
+
+    // Build storage body
+    let storageBody = '';
+    if (fromFile) {
+      const readFn = deps.readFileSync || readFileSync;
+      const md = readFn(fromFile, 'utf-8');
+      storageBody = markdownToStorage(md);
+    } else if (bodyText) {
+      storageBody = textToStorage(bodyText);
+    }
+
+    // Build page payload (v2 API)
+    const payload = {
+      spaceId,
+      status: 'current',
+      title,
+      body: {
+        representation: 'storage',
+        value: storageBody,
+      },
+    };
+
+    if (parentId) {
+      payload.parentId = parentId;
+    }
+
+    const { data } = await client.post('/wiki/api/v2/pages', payload);
+    const creds = client.getCredentials();
+    const webUrl = data._links?.webui
+      ? `https://${creds.domain}.atlassian.net/wiki${data._links.webui}`
+      : `https://${creds.domain}.atlassian.net/wiki/pages/${data.id}`;
+
+    log(green(`Page created: ${bold(data.title || title)}`));
+    log(`  ID:  ${data.id}`);
+    log(`  URL: ${webUrl}`);
+
+    return 0;
+  } catch (err) {
+    if (err instanceof ConfluenceError) {
+      logError(`Failed to create page: ${err.message}`);
+      return err.exitCode;
+    }
+    throw err;
+  }
+}

package/dist/engineering-pa-core-extensions-atlassian/src/confluence/commands/label.mjs

@@ -0,0 +1,98 @@
+// label.mjs - Add or remove labels on a Confluence page.
+//
+// Usage:
+//   confluence label <ID> <LABEL...>          Add labels
+//   confluence label <ID> <LABEL> --remove    Remove a label
+//
+// Uses v1 endpoint for writing labels (v2 POST returns 405).
+// Multiple labels can be space-separated for adding.
+
+import { createClient, ConfluenceError } from '../client.mjs';
+import { bold, green, red, dim } from '../format.mjs';
+
+const HELP = `confluence label - Add or remove labels on a page
+
+Usage:
+  confluence label <ID> <LABEL...>          Add one or more labels
+  confluence label <ID> <LABEL> --remove    Remove a label
+
+Arguments:
+  ID              Page ID (numeric)
+  LABEL           Label name(s), space-separated
+
+Options:
+  --remove        Remove the specified label instead of adding
+  --help, -h      Show this help
+
+Labels are added via the v1 API (v2 POST returns 405).
+
+Examples:
+  confluence label 12345 important
+  confluence label 12345 api docs reviewed
+  confluence label 12345 outdated --remove
+`;
+
+/**
+ * Run the label command.
+ *
+ * @param {string[]} argv  Remaining args after 'label'
+ * @param {object} [deps]  Dependency overrides
+ * @returns {Promise<number>}  Exit code
+ */
+export async function run(argv = [], deps = {}) {
+  const log = deps.log || console.log;
+  const logError = deps.logError || console.error;
+  const { parseArgs } = await import('../cli.mjs');
+  const args = parseArgs(argv);
+
+  if (args.help || args.h) {
+    log(HELP);
+    return 0;
+  }
+
+  const pageId = args._[0];
+  const labels = args._.slice(1);
+  const remove = args.remove === true;
+
+  if (!pageId) {
+    logError('Usage: confluence label <ID> <LABEL...> [--remove]');
+    return 1;
+  }
+
+  if (labels.length === 0) {
+    logError('Provide at least one label.');
+    return 1;
+  }
+
+  const client = deps.client || createClient();
+
+  try {
+    if (remove) {
+      // Remove label - v1 DELETE endpoint
+      const label = labels[0]; // Only one label can be removed at a time
+      await client.del(
+        `/wiki/rest/api/content/${encodeURIComponent(pageId)}/label/${encodeURIComponent(label)}`
+      );
+      log(green(`Label ${bold(label)} removed from page ${pageId}.`));
+    } else {
+      // Add labels - v1 POST endpoint
+      const payload = labels.map((name) => ({
+        prefix: 'global',
+        name,
+      }));
+      await client.post(
+        `/wiki/rest/api/content/${encodeURIComponent(pageId)}/label`,
+        payload
+      );
+      log(green(`Labels added to page ${pageId}: ${bold(labels.join(', '))}`));
+    }
+
+    return 0;
+  } catch (err) {
+    if (err instanceof ConfluenceError) {
+      logError(`Failed to ${remove ? 'remove' : 'add'} label: ${err.message}`);
+      return err.exitCode;
+    }
+    throw err;
+  }
+}

package/dist/engineering-pa-core-extensions-atlassian/src/confluence/commands/mine.mjs

@@ -0,0 +1,105 @@
+// mine.mjs - Current user's Confluence pages.
+//
+// Usage:
+//   confluence mine [--days N]
+//
+// Uses CQL: creator = currentUser()
+// Default: 7 days.
+
+import { createClient, ConfluenceError } from '../client.mjs';
+import { formatTable, bold, dim } from '../format.mjs';
+
+const HELP = `confluence mine - Your pages
+
+Usage:
+  confluence mine [--days N]
+
+Options:
+  --days N        How many days back to look (default: 7)
+  --help, -h      Show this help
+
+Shows pages created by the current user within the specified time window.
+Uses CQL: creator = currentUser() AND lastModified > now("-Nd")
+
+Examples:
+  confluence mine
+  confluence mine --days 30
+`;
+
+/**
+ * Run the mine command.
+ *
+ * @param {string[]} argv  Remaining args after 'mine'
+ * @param {object} [deps]  Dependency overrides
+ * @returns {Promise<number>}  Exit code
+ */
+export async function run(argv = [], deps = {}) {
+  const log = deps.log || console.log;
+  const logError = deps.logError || console.error;
+  const { parseArgs } = await import('../cli.mjs');
+  const args = parseArgs(argv);
+
+  if (args.help || args.h) {
+    log(HELP);
+    return 0;
+  }
+
+  const days = args.days ? parseInt(args.days, 10) : 7;
+
+  if (isNaN(days) || days < 1) {
+    logError('--days must be a positive integer');
+    return 1;
+  }
+
+  const client = deps.client || createClient();
+
+  try {
+    const cql = `type = page AND creator = currentUser() AND lastModified > now("-${days}d") ORDER BY lastModified DESC`;
+
+    const results = [];
+    for await (const item of client.paginateOffset('/wiki/rest/api/content/search', {
+      cql,
+    }, 25)) {
+      results.push(item);
+      if (results.length >= 25) break;
+    }
+
+    if (results.length === 0) {
+      log(dim(`No pages by you in the last ${days} day(s).`));
+      return 0;
+    }
+
+    log(bold(`Your pages`) + dim(` (last ${days} days)\n`));
+
+    const rows = results.map((item) => ({
+      id: item.id || '',
+      title: item.title || '',
+      space: item.space?.key || '',
+      modified: item.version?.when ? formatDate(item.version.when) : '',
+    }));
+
+    log(formatTable(rows, [
+      { key: 'id', label: 'ID', width: 12 },
+      { key: 'title', label: 'Title', width: 50 },
+      { key: 'space', label: 'Space', width: 10 },
+      { key: 'modified', label: 'Modified', width: 12 },
+    ]));
+
+    return 0;
+  } catch (err) {
+    if (err instanceof ConfluenceError) {
+      logError(`Failed to fetch your pages: ${err.message}`);
+      return err.exitCode;
+    }
+    throw err;
+  }
+}
+
+function formatDate(isoString) {
+  if (!isoString) return '';
+  try {
+    return new Date(isoString).toISOString().slice(0, 10);
+  } catch {
+    return isoString;
+  }
+}