npm - @thegetty/quire-cli - Versions diffs - 1.0.0-rc.35 → 1.0.0-rc.36 - Mend

@thegetty/quire-cli 1.0.0-rc.35 → 1.0.0-rc.36

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (158) hide show

package/CHANGELOG.md +36 -0
package/README.md +9 -0
package/bin/cli.js +19 -1
package/package.json +21 -8
package/patches/README.md +19 -0
package/patches/install-npm-version+1.0.9.patch +12119 -0
package/schemas/objects.schema.json +12 -38
package/schemas/publication.schema.json +0 -22
package/schemas/references.schema.json +0 -1
package/src/Command.js +26 -6
package/src/Command.spec.js +99 -0
package/src/commands/README.md +213 -122
package/src/commands/build.js +46 -37
package/src/commands/build.spec.js +113 -0
package/src/commands/build.test.js +402 -0
package/src/commands/clean.js +25 -19
package/src/commands/clean.spec.js +108 -0
package/src/commands/clean.test.js +260 -0
package/src/commands/config.js +251 -0
package/src/commands/config.spec.js +107 -0
package/src/commands/config.test.js +715 -0
package/src/commands/create.js +42 -14
package/src/commands/create.spec.js +112 -0
package/src/commands/create.test.js +415 -0
package/src/commands/epub.js +59 -30
package/src/commands/epub.spec.js +114 -0
package/src/commands/epub.test.js +503 -0
package/src/commands/index.js +9 -2
package/src/commands/info.js +18 -24
package/src/commands/info.spec.js +64 -0
package/src/commands/info.test.js +415 -0
package/src/commands/pdf.js +58 -84
package/src/commands/pdf.spec.js +114 -0
package/src/commands/pdf.test.js +464 -0
package/src/commands/preview.js +26 -31
package/src/commands/preview.spec.js +97 -0
package/src/commands/preview.test.js +250 -0
package/src/commands/use.js +56 -0
package/src/commands/use.spec.js +61 -0
package/src/commands/use.test.js +280 -0
package/src/commands/validate.js +31 -19
package/src/commands/validate.spec.js +82 -0
package/src/commands/validate.test.js +234 -0
package/src/commands/workflows.js +70 -0
package/src/errors/build/build-failed-error.js +19 -0
package/src/errors/build/config-field-missing-error.js +20 -0
package/src/errors/build/config-file-not-found-error.js +20 -0
package/src/errors/build/index.js +11 -0
package/src/errors/index.js +48 -0
package/src/errors/install/dependency-install-error.js +19 -0
package/src/errors/install/directory-not-empty-error.js +25 -0
package/src/errors/install/index.js +12 -0
package/src/errors/install/invalid-path-error.js +31 -0
package/src/errors/install/invalid-starter-error.js +27 -0
package/src/errors/install/version-not-found-error.js +35 -0
package/src/errors/output/epub-generation-error.js +19 -0
package/src/errors/output/index.js +14 -0
package/src/errors/output/invalid-epub-library-error.js +20 -0
package/src/errors/output/invalid-pdf-library-error.js +20 -0
package/src/errors/output/missing-build-output-error.js +21 -0
package/src/errors/output/pdf-generation-error.js +24 -0
package/src/errors/output/tool-not-found-error.js +37 -0
package/src/errors/project/index.js +10 -0
package/src/errors/project/not-in-project-error.js +20 -0
package/src/errors/project/project-create-error.js +21 -0
package/src/errors/quire-error.js +27 -0
package/src/errors/validation/validation-error.js +20 -11
package/src/helpers/clean.js +1 -1
package/src/helpers/docs-url.js +32 -0
package/src/helpers/test-cwd.js +5 -6
package/src/helpers/test-cwd.test.js +192 -0
package/src/helpers/which.js +10 -4
package/src/lib/11ty/README.md +135 -19
package/src/lib/11ty/api.js +176 -93
package/src/lib/11ty/cli.js +77 -35
package/src/lib/11ty/index.js +64 -5
package/src/lib/11ty/index.test.js +655 -0
package/src/lib/README.md +275 -0
package/src/lib/commander/index.js +100 -0
package/src/lib/commander/index.test.js +86 -0
package/src/lib/commander/options.js +195 -0
package/src/lib/commander/options.test.js +109 -0
package/src/lib/conf/README.md +84 -73
package/src/lib/conf/config.js +5 -3
package/src/lib/conf/config.test.js +281 -0
package/src/lib/conf/defaults.js +44 -0
package/src/lib/conf/format.js +60 -0
package/src/lib/conf/format.test.js +106 -0
package/src/lib/conf/helpers.js +91 -0
package/src/lib/conf/helpers.test.js +136 -0
package/src/lib/conf/index.js +22 -0
package/src/lib/conf/schema.js +53 -8
package/src/lib/epub/README.md +133 -2
package/src/lib/epub/engines.js +46 -0
package/src/lib/epub/epub.js +36 -11
package/src/lib/epub/index.js +111 -21
package/src/lib/epub/index.test.js +518 -0
package/src/lib/epub/pandoc.js +33 -4
package/src/lib/epub/pandoc.test.js +122 -0
package/src/lib/epub/schema.js +21 -0
package/src/lib/error/README.md +170 -0
package/src/lib/error/handler.js +107 -0
package/src/lib/git/README.md +151 -2
package/src/lib/git/index.js +217 -13
package/src/lib/git/index.spec.js +80 -0
package/src/lib/git/index.test.js +453 -0
package/src/lib/installer/index.js +309 -0
package/src/lib/installer/index.spec.js +83 -0
package/src/lib/installer/index.test.js +545 -0
package/src/lib/logger/README.md +424 -0
package/src/lib/logger/debug.js +90 -0
package/src/lib/logger/debug.spec.js +130 -0
package/src/lib/logger/index.js +228 -0
package/src/lib/logger/index.spec.js +131 -0
package/src/lib/logger/index.test.js +477 -0
package/src/lib/npm/README.md +127 -0
package/src/lib/npm/index.js +198 -0
package/src/lib/npm/index.spec.js +60 -0
package/src/lib/npm/index.test.js +355 -0
package/src/lib/pdf/README.md +131 -0
package/src/lib/pdf/engines.js +46 -0
package/src/lib/pdf/index.js +124 -21
package/src/lib/pdf/index.test.js +708 -0
package/src/lib/pdf/paged.js +100 -52
package/src/lib/pdf/paged.test.js +366 -0
package/src/lib/pdf/prince.js +115 -37
package/src/lib/pdf/prince.test.js +202 -0
package/src/lib/pdf/schema.js +21 -0
package/src/lib/pdf/split.js +61 -33
package/src/lib/pdf/split.test.js +445 -0
package/src/lib/process/manager.js +110 -0
package/src/lib/process/manager.test.js +55 -0
package/src/lib/project/build.js +143 -0
package/src/lib/project/build.test.js +253 -0
package/src/lib/project/config.js +48 -0
package/src/lib/project/config.test.js +134 -0
package/src/{helpers/is-quire.js → lib/project/detect.js} +5 -3
package/src/lib/project/detect.test.js +157 -0
package/src/lib/project/index.js +40 -0
package/src/lib/project/paths.js +224 -0
package/src/lib/project/version.js +110 -0
package/src/lib/project/version.test.js +350 -0
package/src/lib/reporter/README.md +211 -2
package/src/lib/reporter/index.js +512 -0
package/src/lib/reporter/index.test.js +593 -0
package/src/main.js +134 -47
package/src/main.spec.js +61 -0
package/src/main.test.js +347 -0
package/src/validators/utils.js +2 -1
package/src/commands/conf.js +0 -43
package/src/commands/version.js +0 -43
package/src/lib/11ty/paths.js +0 -103
package/src/lib/i18n/README.md +0 -3
package/src/lib/i18n/config.js +0 -53
package/src/lib/i18n/index.js +0 -43
package/src/lib/i18n/localeService.js +0 -58
package/src/lib/quire/README.md +0 -19
package/src/lib/quire/index.js +0 -350

package/src/commands/clean.test.js ADDED Viewed

@@ -0,0 +1,260 @@
+import test from 'ava'
+import { Volume, createFsFromVolume } from 'memfs'
+import sinon from 'sinon'
+import esmock from 'esmock'
+test.beforeEach((t) => {
+  // Create sinon sandbox for mocking
+  t.context.sandbox = sinon.createSandbox()
+  // Create in-memory file system
+  t.context.vol = new Volume()
+  t.context.fs = createFsFromVolume(t.context.vol)
+  // Setup mock directory structure with build artifacts
+  t.context.vol.fromJSON({
+    '/project/_site/index.html': '<html>Quire Test </html>',
+    '/project/_site/styles.css': 'body { }',
+    '/project/content/index.md': '# Content',
+    '/project/package.json': JSON.stringify({ name: 'test-project' })
+  })
+  t.context.projectRoot = '/project'
+  // Stub console methods to suppress output during tests
+  // Create mock logger (no global console stubbing needed!)
+  t.context.mockLogger = {
+    info: t.context.sandbox.stub(),
+    error: t.context.sandbox.stub(),
+    debug: t.context.sandbox.stub(),
+    log: t.context.sandbox.stub(),
+    warn: t.context.sandbox.stub()
+  }
+})
+test.afterEach.always((t) => {
+  // Restore all mocks
+  t.context.sandbox.restore()
+  // Clear in-memory file system
+  t.context.vol.reset()
+})
+test('clean command should call clean helper with correct parameters', async (t) => {
+  const { sandbox, fs, mockLogger } = t.context
+  // Mock clean helper
+  const mockClean = sandbox.stub().resolves(['/project/_site'])
+  // Mock testcwd helper
+  const mockTestcwd = sandbox.stub()
+  // Use esmock to replace imports
+  const CleanCommand = await esmock('./clean.js', {
+    '#helpers/clean.js': {
+      clean: mockClean
+    },
+    '#lib/project/index.js': {
+      default: {
+        getProjectRoot: () => '/project',
+        toObject: () => ({ output: '_site' })
+      }
+    },
+    '#helpers/test-cwd.js': {
+      default: mockTestcwd
+    },
+    '#lib/logger/index.js': {
+      logger: mockLogger
+    },
+    'fs-extra': fs
+  })
+  const command = new CleanCommand()
+  command.name = sandbox.stub().returns('clean')
+  command.logger = mockLogger
+  command.debug = sandbox.stub()
+  // Run action
+  const options = {}
+  await command.action(options, command)
+  t.true(mockClean.called, 'clean should be called')
+  t.true(mockClean.calledWith('/project', { output: '_site' }, options), 'clean should be called with correct parameters')
+  // Verify user-visible output
+  t.true(mockLogger.info.called, 'logger.info should be called with result')
+  const output = mockLogger.info.firstCall.args[0]
+  t.true(output.includes('Deleted'), 'should report deleted files')
+  t.true(output.includes('/project/_site'), 'should list deleted paths')
+})
+test('clean command should handle dry-run option', async (t) => {
+  const { sandbox, fs, mockLogger } = t.context
+  // Mock clean helper to return paths that would be deleted
+  const mockClean = sandbox.stub().resolves(['/project/_site/index.html', '/project/_site/styles.css'])
+  // Mock testcwd helper
+  const mockTestcwd = sandbox.stub()
+  // Use esmock to replace imports
+  const CleanCommand = await esmock('./clean.js', {
+    '#helpers/clean.js': {
+      clean: mockClean
+    },
+    '#lib/project/index.js': {
+      default: {
+        getProjectRoot: () => '/project',
+        toObject: () => ({ output: '_site' })
+      }
+    },
+    '#helpers/test-cwd.js': {
+      default: mockTestcwd
+    },
+    '#lib/logger/index.js': {
+      logger: mockLogger
+    },
+    'fs-extra': fs
+  })
+  const command = new CleanCommand()
+  command.name = sandbox.stub().returns('clean')
+  command.logger = mockLogger
+  command.debug = sandbox.stub()
+  // Run action with dry-run
+  const options = { dryRun: true }
+  await command.action(options, command)
+  t.true(mockClean.called, 'clean should be called')
+  t.true(mockClean.calledWith('/project', { output: '_site' }, options), 'clean should receive dry-run option')
+  // Verify dry-run output uses "Will delete" instead of "Deleted"
+  const output = mockLogger.info.firstCall.args[0]
+  t.true(output.includes('Will delete'), 'should use future tense for dry-run')
+})
+test('clean command should call testcwd in preAction', async (t) => {
+  const { sandbox, fs, mockLogger } = t.context
+  // Mock clean helper
+  const mockClean = sandbox.stub().resolves([])
+  // Mock testcwd helper
+  const mockTestcwd = sandbox.stub()
+  // Use esmock to replace imports
+  const CleanCommand = await esmock('./clean.js', {
+    '#helpers/clean.js': {
+      clean: mockClean
+    },
+    '#lib/project/index.js': {
+      default: {
+        getProjectRoot: () => '/project',
+        toObject: () => ({ output: '_site' })
+      }
+    },
+    '#helpers/test-cwd.js': {
+      default: mockTestcwd
+    },
+    '#lib/logger/index.js': {
+      logger: mockLogger
+    },
+    'fs-extra': fs
+  })
+  const command = new CleanCommand()
+  command.name = sandbox.stub().returns('clean')
+  // Run preAction
+  command.preAction(command)
+  t.true(mockTestcwd.called, 'testcwd should be called in preAction')
+  t.true(mockTestcwd.calledWith(command), 'testcwd should be called with command object')
+})
+test('clean command should handle empty deletedPaths', async (t) => {
+  const { sandbox, fs, mockLogger } = t.context
+  // Mock clean helper to return empty array (no files to delete)
+  const mockClean = sandbox.stub().resolves([])
+  // Mock testcwd helper
+  const mockTestcwd = sandbox.stub()
+  // Use esmock to replace imports
+  const CleanCommand = await esmock('./clean.js', {
+    '#helpers/clean.js': {
+      clean: mockClean
+    },
+    '#lib/project/index.js': {
+      default: {
+        getProjectRoot: () => '/project',
+        toObject: () => ({ output: '_site' })
+      }
+    },
+    '#helpers/test-cwd.js': {
+      default: mockTestcwd
+    },
+    '#lib/logger/index.js': {
+      logger: mockLogger
+    },
+    'fs-extra': fs
+  })
+  const command = new CleanCommand()
+  command.name = sandbox.stub().returns('clean')
+  command.logger = mockLogger
+  command.debug = sandbox.stub()
+  // Run action
+  const options = {}
+  await command.action(options, command)
+  t.true(mockClean.called, 'clean should be called')
+  // Verify "no files" message
+  const output = mockLogger.info.firstCall.args[0]
+  t.true(output.includes('No files to delete'), 'should report no files to delete')
+})
+test('clean command should pass all options to clean helper', async (t) => {
+  const { sandbox, fs, mockLogger } = t.context
+  // Mock clean helper
+  const mockClean = sandbox.stub().resolves(['/project/_site'])
+  // Mock testcwd helper
+  const mockTestcwd = sandbox.stub()
+  // Use esmock to replace imports
+  const CleanCommand = await esmock('./clean.js', {
+    '#helpers/clean.js': {
+      clean: mockClean
+    },
+    '#lib/project/index.js': {
+      default: {
+        getProjectRoot: () => '/project',
+        toObject: () => ({ output: '_site' })
+      }
+    },
+    '#helpers/test-cwd.js': {
+      default: mockTestcwd
+    },
+    '#lib/logger/index.js': {
+      logger: mockLogger
+    },
+    'fs-extra': fs
+  })
+  const command = new CleanCommand()
+  command.name = sandbox.stub().returns('clean')
+  command.logger = mockLogger
+  command.debug = sandbox.stub()
+  // Run action with multiple options
+  const options = { verbose: true, dryRun: false }
+  await command.action(options, command)
+  t.true(mockClean.calledWith('/project', { output: '_site' }, options), 'clean should receive all options')
+})

package/src/commands/config.js ADDED Viewed

@@ -0,0 +1,251 @@
+import Command from '#src/Command.js'
+import {
+  isValidKey,
+  getValidKeys,
+  coerceValue,
+  formatValidationError,
+  getDefault,
+  formatSettings,
+} from '#lib/conf/index.js'
+/**
+ * Valid operations for the settings command
+ */
+const OPERATIONS = Object.freeze(['get', 'set', 'delete', 'reset', 'path'])
+/**
+ * Quire CLI `settings` Command
+ *
+ * Manages quire-cli configuration with explicit subcommand operations.
+ *
+ * @example
+ * // Show all settings
+ * quire settings
+ *
+ * // Get a single value
+ * quire settings get logLevel
+ *
+ * // Set a value
+ * quire settings set logLevel debug
+ *
+ * // Delete a key (reset to default)
+ * quire settings delete logLevel
+ *
+ * // Reset all settings to defaults
+ * quire settings reset
+ *
+ * // Reset a single key to default
+ * quire settings reset logLevel
+ *
+ * // Show settings file path
+ * quire settings path
+ *
+ * @class      SettingsCommand
+ * @extends    {Command}
+ */
+export default class SettingsCommand extends Command {
+  static definition = {
+    name: 'settings',
+    aliases: ['prefs', 'preferences', 'conf', 'config', 'configure'],
+    description: 'Manage Quire CLI settings.',
+    summary: 'view and modify CLI settings',
+    docsLink: 'quire-commands/',
+    helpText: `
+Examples:
+  quire settings                    Show all settings
+  quire settings get <key>          Get a single value
+  quire settings set <key> <value>  Set a value
+  quire settings delete <key>       Delete (reset to default)
+  quire settings reset [key]        Reset all or single key
+  quire settings path               Show settings file path
+  quire settings --json             Output raw config JSON
+  quire settings get <key> --json   Output single value as JSON
+`,
+    version: '2.0.0',
+    args: [
+      ['[operation]', `operation to perform (${OPERATIONS.join(', ')})`],
+      ['[key]', 'configuration key'],
+      ['[value]', 'value to set (for set operation)'],
+    ],
+    options: [
+      ['--json', 'output raw JSON'],
+      ['--debug', 'enable debug output for troubleshooting'],
+    ],
+  }
+  constructor() {
+    super(SettingsCommand.definition)
+  }
+  /**
+   * Log an unknown key error with valid keys hint
+   *
+   * @param {string} key - The unknown configuration key
+   */
+  #logUnknownKey(key) {
+    this.logger.error(`Unknown configuration key: ${key}`)
+    this.logger.info(`Valid keys: ${getValidKeys().join(', ')}`)
+  }
+  /**
+   * Get a single configuration value
+   *
+   * @param {string} key - Configuration key
+   * @param {Object} options - Command options
+   */
+  #getValue(key, options) {
+    if (!key) {
+      this.logger.error('Usage: quire conf get <key>')
+      return
+    }
+    if (!isValidKey(key) && !key.startsWith('__internal__')) {
+      this.#logUnknownKey(key)
+      return
+    }
+    const value = this.config.get(key)
+    if (options.json) {
+      console.log(JSON.stringify(value))
+      return
+    }
+    if (value === undefined) {
+      this.logger.info(`${key}: (not set)`)
+    } else {
+      this.logger.info(`${key}: ${JSON.stringify(value)}`)
+    }
+  }
+  /**
+   * Set a configuration value
+   *
+   * @param {string} key - Configuration key
+   * @param {string} value - Value to set
+   */
+  #setValue(key, value) {
+    if (!key || value === undefined) {
+      this.logger.error('Usage: quire conf set <key> <value>')
+      return
+    }
+    if (!isValidKey(key)) {
+      this.#logUnknownKey(key)
+      return
+    }
+    const coercedValue = coerceValue(key, value)
+    try {
+      this.config.set(key, coercedValue)
+      this.logger.info(`${key}: ${JSON.stringify(coercedValue)}`)
+    } catch {
+      this.logger.error(formatValidationError(key, coercedValue))
+    }
+  }
+  /**
+   * Delete a configuration key (resets to default)
+   *
+   * @param {string} key - Configuration key
+   */
+  #deleteKey(key) {
+    if (!key) {
+      this.logger.error('Usage: quire conf delete <key>')
+      return
+    }
+    if (!isValidKey(key)) {
+      this.#logUnknownKey(key)
+      return
+    }
+    this.config.delete(key)
+    const defaultValue = getDefault(key)
+    this.logger.info(`${key}: reset to ${JSON.stringify(defaultValue)}`)
+  }
+  /**
+   * Reset configuration to defaults
+   *
+   * @param {string} [key] - Optional key to reset (resets all if omitted)
+   */
+  #reset(key) {
+    if (key) {
+      if (!isValidKey(key)) {
+        this.#logUnknownKey(key)
+        return
+      }
+      this.config.reset(key)
+      const defaultValue = getDefault(key)
+      this.logger.info(`${key}: reset to ${JSON.stringify(defaultValue)}`)
+    } else {
+      this.config.clear()
+      this.logger.info('Configuration reset to defaults')
+    }
+  }
+  /**
+   * Show all configuration values with descriptions
+   */
+  #showAll(options) {
+    if (options.json) {
+      const store = options.debug
+        ? this.config.store
+        : Object.fromEntries(
+          Object.entries(this.config.store).filter(([k]) => !k.startsWith('__internal__'))
+        )
+      console.log(JSON.stringify(store, null, 2))
+      return
+    }
+    const output = formatSettings(this.config.store, {
+      showInternal: options.debug,
+      configPath: this.config.path,
+      useColor: this.config.get('logUseColor'),
+    })
+    this.logger.info(output)
+  }
+  /**
+   * Show config file path
+   */
+  #showPath() {
+    this.logger.info(this.config.path)
+  }
+  /**
+   * @param {string} [operation] - Operation to perform
+   * @param {string} [key] - Configuration key
+   * @param {string} [value] - Value to set
+   * @param {Object} options - Command options
+   * @return {Promise}
+   */
+  async action(operation, key, value, options = {}) {
+    this.debug('called with operation=%s key=%s value=%s options=%O', operation, key, value, options)
+    // Validate operation if provided
+    if (operation && !OPERATIONS.includes(operation)) {
+      this.logger.error(`Unknown operation: ${operation}`)
+      this.logger.info(`Valid operations: ${OPERATIONS.join(', ')}`)
+      return
+    }
+    // Dispatch to operation handler
+    switch (operation) {
+      case 'get':
+        return this.#getValue(key, options)
+      case 'set':
+        return this.#setValue(key, value)
+      case 'delete':
+        return this.#deleteKey(key)
+      case 'reset':
+        return this.#reset(key)
+      case 'path':
+        return this.#showPath()
+      default:
+        return this.#showAll(options)
+    }
+  }
+}

package/src/commands/config.spec.js ADDED Viewed

@@ -0,0 +1,107 @@
+import { Command, Option } from 'commander'
+import program from '#src/main.js'
+import test from 'ava'
+/**
+ * Command Contract/Interface Tests
+ *
+ * Verifies the command's public API and Commander.js integration.
+ * @see docs/testing-commands.md
+ */
+test.before((t) => {
+  // Get the registered command (from program.commands) once and share across all tests
+  // Command is named 'settings' with 'conf' as an alias
+  t.context.command = program.commands.find((cmd) => cmd.name() === 'settings')
+})
+test('command is registered in CLI program', (t) => {
+  const { command } = t.context
+  t.truthy(command, 'command "settings" should be registered in program')
+  t.true(command instanceof Command, 'registered command should be Commander.js Command instance')
+})
+test('registered command has correct metadata', (t) => {
+  const { command } = t.context
+  t.is(command.name(), 'settings')
+  t.truthy(command.description())
+  t.is(typeof command._actionHandler, 'function', 'command should have action handler')
+})
+test('registered command has correct aliases', (t) => {
+  const { command } = t.context
+  t.truthy(command.aliases)
+  t.true(Array.isArray(command.aliases()))
+  t.true(command.aliases().includes('prefs'))
+  t.true(command.aliases().includes('preferences'))
+  t.true(command.aliases().includes('conf'))
+  t.true(command.aliases().includes('config'))
+  t.true(command.aliases().includes('configure'))
+})
+test('registered command has correct arguments', (t) => {
+  const { command } = t.context
+  const registeredArguments = command.registeredArguments
+  t.is(registeredArguments.length, 3, 'conf command should have 3 arguments')
+  // Verify operation argument
+  const operationArg = registeredArguments[0]
+  t.is(operationArg.name(), 'operation')
+  t.false(operationArg.required, 'operation argument should be optional')
+  // Verify key argument
+  const keyArg = registeredArguments[1]
+  t.is(keyArg.name(), 'key')
+  t.false(keyArg.required, 'key argument should be optional')
+  // Verify value argument
+  const valueArg = registeredArguments[2]
+  t.is(valueArg.name(), 'value')
+  t.false(valueArg.required, 'value argument should be optional')
+})
+test('registered command has correct options', (t) => {
+  const { command } = t.context
+  // Get all options
+  const jsonOption = command.options.find((opt) => opt.long === '--json')
+  const debugOption = command.options.find((opt) => opt.long === '--debug')
+  // Verify --json option exists
+  t.truthy(jsonOption, '--json option should exist')
+  t.true(jsonOption instanceof Option, '--json should be Option instance')
+  t.is(jsonOption.long, '--json')
+  t.truthy(jsonOption.description)
+  t.false(jsonOption.required, '--json should not require a value')
+  // Verify --debug option exists
+  t.truthy(debugOption, '--debug option should exist')
+  t.true(debugOption instanceof Option, '--debug should be Option instance')
+  t.is(debugOption.long, '--debug')
+  t.truthy(debugOption.description)
+  t.false(debugOption.required, '--debug should not require a value')
+  // Verify no operation flags exist (operations are via positional argument)
+  const deleteOption = command.options.find((opt) => opt.long === '--delete')
+  const resetOption = command.options.find((opt) => opt.long === '--reset')
+  const pathOption = command.options.find((opt) => opt.long === '--path')
+  t.falsy(deleteOption, '--delete option should not exist (use delete operation)')
+  t.falsy(resetOption, '--reset option should not exist (use reset operation)')
+  t.falsy(pathOption, '--path option should not exist (use path operation)')
+})
+test('command options are accessible via public API', (t) => {
+  const { command } = t.context
+  // Test that options can be accessed the way Commander.js does
+  const optionNames = command.options.map((opt) => opt.long)
+  t.true(optionNames.includes('--json'))
+  t.true(optionNames.includes('--debug'))
+  t.is(optionNames.length, 2, 'should have --json and --debug options')
+})