@verbatims/cli 0.1.15 → 0.1.17

package/README.md

@@ -19,6 +19,19 @@ verbatims config
 # List quotes
 verbatims quotes list --language fr --limit 10
 
+# Filter quotes by reference and inspect provenance
+verbatims quotes list --reference 42
+verbatims quotes get 123 --format json
+
+# Manage provenance (moderator/admin API key)
+verbatims quotes attributions list 123
+verbatims quotes attributions create 123 --author-id 1 --reference-id 2 --status manually_verified --primary
+verbatims quotes sources list 123
+verbatims quotes sources create 123 --source-type book --source-url https://example.com/edition --status externally_verified
+
+# Create a quote with a source
+verbatims quotes create --source-type book --source-url https://example.com/edition
+
 # Browse interactively
 verbatims quotes browse
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verbatims/cli",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "CLI for the Verbatims quotes API",
   "type": "module",
   "bin": {

package/src/commands/quotes.ts

@@ -19,6 +19,7 @@ export function registerQuotesCommand(program: Command) {
     .option('--language <lang>', 'Filter by language')
     .option('--limit <n>', 'Number of results', '20')
     .option('--author <id>', 'Filter by author ID')
+    .option('--reference <id>', 'Filter by reference ID')
     .option('--tag <name>', 'Filter by tag')
     .option('--search <q>', 'Search in quote text')
     .option('--status <status>', 'Filter by status (draft|pending|approved|rejected)')
@@ -33,6 +34,7 @@ export function registerQuotesCommand(program: Command) {
           language: options.language,
           limit: Number(options.limit),
           author_id: options.author ? Number(options.author) : undefined,
+          reference_id: options.reference ? Number(options.reference) : undefined,
           tag: options.tag,
           search: options.search,
           q: options.search,
@@ -66,6 +68,8 @@ export function registerQuotesCommand(program: Command) {
     .option('--language <lang>', 'Language')
     .option('--author-id <id>', 'Author ID')
     .option('--reference-id <id>', 'Reference ID')
+    .option('--source-type <type>', 'Source type')
+    .option('--source-url <url>', 'Source URL')
     .action(async (options: Record<string, string>) => {
       const client = await getClient()
       const format = getFormat(program)
@@ -80,7 +84,16 @@ export function registerQuotesCommand(program: Command) {
       const referenceId = options.referenceId ? Number(options.referenceId) : undefined
 
       const { data } = await withSpinner('Creating quote', () =>
-        client.quotes.create({ content: name as string, name: name as string, language: language as string, author_id: authorId, reference_id: referenceId }),
+        client.quotes.create({
+          content: name as string,
+          name: name as string,
+          language: language as string,
+          provenance: {
+            author_id: authorId,
+            reference_id: referenceId,
+            source: options.sourceType ? { source_type: options.sourceType, source_url: options.sourceUrl } : undefined,
+          },
+        }),
         format,
       )
       console.log(chalk.green(' Quote created'))
@@ -94,6 +107,8 @@ export function registerQuotesCommand(program: Command) {
     .option('--language <lang>', 'Language')
     .option('--author-id <id>', 'Author ID')
     .option('--reference-id <id>', 'Reference ID')
+    .option('--source-type <type>', 'Source type')
+    .option('--source-url <url>', 'Source URL')
     .action(async (id: string, options: Record<string, string>) => {
       const client = await getClient()
       const format = getFormat(program)
@@ -101,8 +116,14 @@ export function registerQuotesCommand(program: Command) {
       const data_: Record<string, unknown> = {}
       if (options.name) { data_.name = options.name; data_.content = options.name }
       if (options.language) data_.language = options.language
-      if (options.authorId !== undefined) data_.author_id = options.authorId === 'null' ? null : Number(options.authorId)
-      if (options.referenceId !== undefined) data_.reference_id = options.referenceId === 'null' ? null : Number(options.referenceId)
+      if (options.authorId !== undefined) data_.provenance = { ...(data_.provenance as object), author_id: options.authorId === 'null' ? null : Number(options.authorId) }
+      if (options.referenceId !== undefined) data_.provenance = { ...(data_.provenance as object), reference_id: options.referenceId === 'null' ? null : Number(options.referenceId) }
+      if (options.sourceType !== undefined || options.sourceUrl !== undefined) {
+        data_.provenance = {
+          ...(data_.provenance as object),
+          source: { source_type: options.sourceType ?? 'manual', source_url: options.sourceUrl },
+        }
+      }
 
       const { data } = await withSpinner('Updating quote', () => client.quotes.update(Number(id), data_ as any), format)
       console.log(chalk.green(' Quote updated'))
@@ -172,6 +193,7 @@ export function registerQuotesCommand(program: Command) {
     .description('Browse quotes interactively')
     .option('--language <lang>', 'Filter by language')
     .option('--author <id>', 'Filter by author ID')
+    .option('--reference <id>', 'Filter by reference ID')
     .option('--tag <name>', 'Filter by tag')
     .option('--search <q>', 'Search in quote text')
     .option('--status <status>', 'Filter by status (draft|pending|approved|rejected)')
@@ -185,6 +207,7 @@ export function registerQuotesCommand(program: Command) {
           page,
           language: options.language,
           author_id: options.author ? Number(options.author) : undefined,
+          reference_id: options.reference ? Number(options.reference) : undefined,
           tag: options.tag,
           search: options.search,
           q: options.search,
@@ -196,6 +219,123 @@ export function registerQuotesCommand(program: Command) {
       )
     })
 
+  quotes
+    .command('attributions <action> <quoteId> [attributionId]')
+    .description('Manage quote attributions (moderator/admin API key required)')
+    .option('--author-id <id>', 'Author ID')
+    .option('--reference-id <id>', 'Reference ID')
+    .option('--status <status>', 'Verification status')
+    .option('--notes <text>', 'Internal notes')
+    .option('--primary', 'Set as primary attribution')
+    .option('--yes', 'Skip confirmation')
+    .action(async (action: string, quoteId: string, attributionId: string | undefined, options: Record<string, any>) => {
+      const client = await getClient()
+      const format = getFormat(program)
+      const id = Number(quoteId)
+
+      if (action === 'list') {
+        const { data } = await withSpinner('Fetching attributions', () => client.quotes.listAttributions(id), format)
+        output(data, format)
+        return
+      }
+      if (action === 'create') {
+        const { data } = await withSpinner('Creating attribution', () => client.quotes.createAttribution(id, {
+          author_id: options.authorId ? Number(options.authorId) : null,
+          reference_id: options.referenceId ? Number(options.referenceId) : null,
+          status: options.status,
+          notes: options.notes,
+          is_primary: options.primary,
+        }), format)
+        output(data, format)
+        return
+      }
+      if (!attributionId) throw new Error('Attribution ID is required')
+      const attribution = Number(attributionId)
+      if (action === 'update') {
+        const data_: Record<string, unknown> = {}
+        if (options.authorId !== undefined) data_.author_id = Number(options.authorId)
+        if (options.referenceId !== undefined) data_.reference_id = Number(options.referenceId)
+        if (options.status !== undefined) data_.status = options.status
+        if (options.notes !== undefined) data_.notes = options.notes
+        if (options.primary !== undefined) data_.is_primary = options.primary
+        const { data } = await withSpinner('Updating attribution', () => client.quotes.updateAttribution(id, attribution, data_), format)
+        output(data, format)
+        return
+      }
+      if (action === 'delete') {
+        if (!options.yes) {
+          const confirmed = await confirm({ message: `Delete attribution #${attribution} from quote #${id}?` })
+          if (isCancel(confirmed) || !confirmed) cancel('Cancelled')
+        }
+        await withSpinner('Deleting attribution', () => client.quotes.deleteAttribution(id, attribution), format)
+        console.log(chalk.green(' Attribution deleted'))
+        return
+      }
+      throw new Error('Action must be list, create, update, or delete')
+    })
+
+  quotes
+    .command('sources <action> <quoteId> [sourceId]')
+    .description('Manage quote sources (moderator/admin API key required)')
+    .option('--attribution-id <id>', 'Attribution ID')
+    .option('--source-type <type>', 'Source type')
+    .option('--source-url <url>', 'Source URL')
+    .option('--label <label>', 'Source label')
+    .option('--status <status>', 'Verification status')
+    .option('--notes <text>', 'Internal notes')
+    .option('--primary', 'Set as primary source')
+    .option('--yes', 'Skip confirmation')
+    .action(async (action: string, quoteId: string, sourceId: string | undefined, options: Record<string, any>) => {
+      const client = await getClient()
+      const format = getFormat(program)
+      const id = Number(quoteId)
+
+      if (action === 'list') {
+        const { data } = await withSpinner('Fetching sources', () => client.quotes.listSources(id), format)
+        output(data, format)
+        return
+      }
+      if (action === 'create') {
+        if (!options.sourceType) throw new Error('--source-type is required')
+        const { data } = await withSpinner('Creating source', () => client.quotes.createSource(id, {
+          attribution_id: options.attributionId ? Number(options.attributionId) : null,
+          source_type: options.sourceType,
+          source_url: options.sourceUrl,
+          label: options.label,
+          verification_status: options.status,
+          notes: options.notes,
+          is_primary: options.primary,
+        }), format)
+        output(data, format)
+        return
+      }
+      if (!sourceId) throw new Error('Source ID is required')
+      const source = Number(sourceId)
+      if (action === 'update') {
+        const data_: Record<string, unknown> = {}
+        if (options.attributionId !== undefined) data_.attribution_id = Number(options.attributionId)
+        if (options.sourceType !== undefined) data_.source_type = options.sourceType
+        if (options.sourceUrl !== undefined) data_.source_url = options.sourceUrl
+        if (options.label !== undefined) data_.label = options.label
+        if (options.status !== undefined) data_.verification_status = options.status
+        if (options.notes !== undefined) data_.notes = options.notes
+        if (options.primary !== undefined) data_.is_primary = options.primary
+        const { data } = await withSpinner('Updating source', () => client.quotes.updateSource(id, source, data_), format)
+        output(data, format)
+        return
+      }
+      if (action === 'delete') {
+        if (!options.yes) {
+          const confirmed = await confirm({ message: `Delete source #${source} from quote #${id}?` })
+          if (isCancel(confirmed) || !confirmed) cancel('Cancelled')
+        }
+        await withSpinner('Deleting source', () => client.quotes.deleteSource(id, source), format)
+        console.log(chalk.green(' Source deleted'))
+        return
+      }
+      throw new Error('Action must be list, create, update, or delete')
+    })
+
   const tags = quotes.command('tags').description('Manage quote tags')
 
   tags

package/src/utils/browse.ts

@@ -32,7 +32,7 @@ export async function browse(fetchPage: PageFetcher, format: Format): Promise<vo
     }
 
     const allKeys = Object.keys(items[0] as Record<string, unknown>)
-    const keyOrder = ['id', 'content', 'name', 'language', 'type', 'author', 'reference', 'quotes_count']
+    const keyOrder = ['id', 'content', 'name', 'language', 'type', 'author', 'reference', 'source', 'attributions', 'sources', 'quotes_count']
     const columns = keyOrder
       .filter((k) => allKeys.includes(k))
       .map((k) => ({ key: k, label: k }))

package/src/utils/format.ts

@@ -137,7 +137,7 @@ export function output(data: unknown, format: Format): void {
     }
 
     const allKeys = Object.keys(data[0] as Record<string, unknown>)
-    const keyOrder = ['id', 'content', 'name', 'language', 'type', 'author', 'reference', 'quotes_count', 'platform', 'label', 'enabled', 'status', 'position', 'quote_text', 'quote_language', 'author_name', 'reference_name', 'post_text', 'post_url', 'posted_at', 'error_message']
+    const keyOrder = ['id', 'content', 'name', 'language', 'type', 'author', 'reference', 'source', 'attributions', 'sources', 'quotes_count', 'platform', 'label', 'enabled', 'status', 'position', 'quote_text', 'quote_language', 'author_name', 'reference_name', 'post_text', 'post_url', 'posted_at', 'error_message']
     const columns = keyOrder
       .filter((k) => allKeys.includes(k))
       .map((k) => ({ key: k, label: k }))