confluence-cli 1.18.0 → 1.19.0

package/.github/workflows/ci.yml

@@ -31,8 +31,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
     - uses: actions/checkout@v3
-    - name: Run npm audit
-      run: npm audit --audit-level moderate
+    - run: npm ci
+    - name: Run npm audit (production only)
+      run: npm audit --audit-level moderate --omit=dev
 
   publish:
     needs: [test, security]

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.19.0](https://github.com/pchuri/confluence-cli/compare/v1.18.0...v1.19.0) (2026-02-20)
+
+
+### Features
+
+* add --cql flag to search command for raw CQL queries ([#40](https://github.com/pchuri/confluence-cli/issues/40)) ([311f5a9](https://github.com/pchuri/confluence-cli/commit/311f5a98bfd175c6b7902c55b4dd0687b2a0d8c0)), closes [#39](https://github.com/pchuri/confluence-cli/issues/39)
+
 # [1.18.0](https://github.com/pchuri/confluence-cli/compare/v1.17.0...v1.18.0) (2026-02-15)
 
 

package/bin/confluence.js

@@ -75,11 +75,12 @@ program
   .command('search <query>')
   .description('Search for Confluence pages')
   .option('-l, --limit <limit>', 'Limit number of results', '10')
+  .option('--cql', 'Pass query as raw CQL instead of text search')
   .action(async (query, options) => {
     const analytics = new Analytics();
     try {
       const client = new ConfluenceClient(getConfig());
-      const results = await client.search(query, parseInt(options.limit));
+      const results = await client.search(query, parseInt(options.limit), options.cql);
       
       if (results.length === 0) {
         console.log(chalk.yellow('No results found.'));

package/lib/confluence-client.js

@@ -221,10 +221,11 @@ class ConfluenceClient {
   /**
    * Search for pages
    */
-  async search(query, limit = 10) {
+  async search(query, limit = 10, rawCql = false) {
+    const cql = rawCql ? query : `text ~ "${String(query).replace(/"/g, '\\"')}"`;
     const response = await this.client.get('/search', {
       params: {
-        cql: `text ~ "${query}"`,
+        cql,
         limit: limit
       }
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "confluence-cli",
-  "version": "1.18.0",
+  "version": "1.19.0",
   "description": "A command-line interface for Atlassian Confluence with page creation and editing capabilities",
   "main": "index.js",
   "bin": {

package/tests/confluence-client.test.js

@@ -303,6 +303,68 @@ describe('ConfluenceClient', () => {
     });
   });
 
+  describe('search', () => {
+    test('should wrap query in text search by default', async () => {
+      const mock = new MockAdapter(client.client);
+      mock.onGet('/search').reply((config) => {
+        expect(config.params.cql).toBe('text ~ "architecture decisions"');
+        expect(config.params.limit).toBe(10);
+        return [200, { results: [] }];
+      });
+
+      const results = await client.search('architecture decisions');
+      expect(results).toEqual([]);
+
+      mock.restore();
+    });
+
+    test('should pass raw CQL when rawCql is true', async () => {
+      const mock = new MockAdapter(client.client);
+      const rawQuery = 'contributor = currentUser() order by lastmodified desc';
+      mock.onGet('/search').reply((config) => {
+        expect(config.params.cql).toBe(rawQuery);
+        return [200, {
+          results: [{
+            content: { id: '123', title: 'Test Page', type: 'page' },
+            excerpt: 'test excerpt'
+          }]
+        }];
+      });
+
+      const results = await client.search(rawQuery, 10, true);
+      expect(results).toHaveLength(1);
+      expect(results[0].id).toBe('123');
+      expect(results[0].title).toBe('Test Page');
+
+      mock.restore();
+    });
+
+    test('should escape double quotes in text search query', async () => {
+      const mock = new MockAdapter(client.client);
+      mock.onGet('/search').reply((config) => {
+        expect(config.params.cql).toBe('text ~ "test \\"quoted\\" term"');
+        return [200, { results: [] }];
+      });
+
+      const results = await client.search('test "quoted" term');
+      expect(results).toEqual([]);
+
+      mock.restore();
+    });
+
+    test('should respect limit parameter', async () => {
+      const mock = new MockAdapter(client.client);
+      mock.onGet('/search').reply((config) => {
+        expect(config.params.limit).toBe(5);
+        return [200, { results: [] }];
+      });
+
+      await client.search('test', 5);
+
+      mock.restore();
+    });
+  });
+
   describe('page creation and updates', () => {
     test('should have required methods for page management', () => {
       expect(typeof client.createPage).toBe('function');