citeclaw 2.0.7 → 2.0.9

package/README.md

@@ -15,7 +15,7 @@ It is designed for two related jobs:
 - an HTTP service compatible with Citoid-style API flows
 - an MCP server mode for agent/tool integrations
 - Zotero automation for query, cite, add, update, notes, dedup, enrichment, and export
-- vendored translator and CSL style assets for reproducible local runs
+- optional translator/style sync commands for broader coverage and local CSL rendering
 
 ## Fast Start
 
@@ -120,7 +120,7 @@ Safety defaults:
 
 ## Runtime Sync
 
-For npm installs, extra runtime assets can be synced explicitly when you want broader coverage or local style rendering:
+For npm installs, extra runtime assets can be synced explicitly when you want broader translator coverage or local style rendering:
 
 ```bash
 npx citeclaw translators sync
@@ -131,6 +131,8 @@ Notes:
 
 - `translators sync` will clone or update the translator sources with `git` when needed
 - `styles sync` will clone or update style repositories with `git` when local CSL styles are unavailable
+- normal `cite` commands can run without manually syncing translators first
+- `cite-style` will fetch style sources on demand if local styles are missing
 - if `git` is not installed, the commands fail with an explicit message
 
 ## Bibliography Curation
@@ -163,6 +165,23 @@ Current package metadata and entrypoints live in:
 - [package.json](/mnt/e/botcite/package.json)
 - [scripts/citeclaw.js](/mnt/e/botcite/scripts/citeclaw.js)
 
+## npm Publishing
+
+This repo includes a GitHub Actions workflow for npm publishing:
+
+- workflow file: `.github/workflows/npm-publish.yml`
+- trigger: push a tag like `v2.0.8` that matches `package.json`'s `version`
+- required secret: add `NPM_TOKEN` in GitHub repository settings with publish permission for the `citeclaw` package
+
+Typical release flow:
+
+```bash
+npm version patch
+git push origin master --follow-tags
+```
+
+The workflow installs dependencies with `npm ci`, checks that the tag matches `package.json`, validates the tarball with `npm pack --dry-run`, and then runs `npm publish --access public --provenance`.
+
 ## Notes
 
 - The npm package name and primary CLI are `citeclaw`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "citeclaw",
-	"version": "2.0.7",
+	"version": "2.0.9",
 	"description": "Citation and bibliography toolkit for DOI, URL, arXiv, PDF, Zotero, and MCP workflows.",
 	"homepage": "https://github.com/trotsky1997/citeclaw",
 	"license": "Apache-2.0",

package/scripts/botcite.js

@@ -469,6 +469,46 @@ function runCommandOrThrow( command, args, cwd ) {
 	return result;
 }
 
+function styleLocaleUrls( locale ) {
+	const fileName = `locales-${ locale }.xml`;
+	return [
+		`https://raw.githubusercontent.com/citation-style-language/locales/master/${ fileName }`,
+		`https://github.com/citation-style-language/locales/raw/master/${ fileName }`,
+		`https://cdn.jsdelivr.net/gh/citation-style-language/locales@master/${ fileName }`
+	];
+}
+
+function downloadFileWithCurlFallbacks( urls, dest, label, runner ) {
+	const runCommand = runner || runCommandOrThrow;
+	const candidates = Array.isArray( urls ) ? urls : [ urls ];
+	const targetLabel = label || path.basename( dest );
+	const tempDest = `${ dest }.tmp`;
+	const failures = [];
+	fs.mkdirSync( path.dirname( dest ), { recursive: true } );
+
+	for ( const url of candidates ) {
+		try {
+			fs.rmSync( tempDest, { force: true } );
+			runCommand( 'curl', [
+				'-fsSL',
+				'--retry', '3',
+				'--retry-delay', '1',
+				'--retry-all-errors',
+				url,
+				'-o', tempDest
+			] );
+			fs.rmSync( dest, { force: true } );
+			fs.renameSync( tempDest, dest );
+			return;
+		} catch ( error ) {
+			failures.push( `${ url }: ${ error.message }` );
+		}
+	}
+
+	fs.rmSync( tempDest, { force: true } );
+	throw new Error( `failed to download ${ targetLabel }: ${ failures.join( ' | ' ) }` );
+}
+
 function resolveInstallCommand() {
 	if ( commandExists( 'npm' ) ) {
 		return { command: 'npm', args: [ 'install' ] };
@@ -1504,19 +1544,24 @@ async function runCitationFromPdf( pdfPath, options ) {
 	} );
 }
 
-function syncStyles( options ) {
+function syncStyles( options, dependencies ) {
+	const styleOptions = options || {};
+	const hooks = dependencies || {};
+	const downloadFile = hooks.downloadFile || downloadFileWithCurlFallbacks;
+	const downloadUsesCurl = downloadFile === downloadFileWithCurlFallbacks;
+
 	ensureDirs();
 	fs.mkdirSync( cslDir, { recursive: true } );
 	fs.mkdirSync( localeDir, { recursive: true } );
-	const configuredSourceDirs = options.repo ?
+	const configuredSourceDirs = styleOptions.repo ?
 		[
-			path.isAbsolute( options.repo || '' ) ?
-				options.repo :
-				path.join( rootDir, options.repo || 'vendor/styles' )
+			path.isAbsolute( styleOptions.repo || '' ) ?
+				styleOptions.repo :
+				path.join( rootDir, styleOptions.repo || 'vendor/styles' )
 		] :
 		ensureDefaultStyleSources();
 	const sourceDirs = configuredSourceDirs.filter( ( sourceDir ) => fileExists( sourceDir ) );
-	if ( options.repo && !sourceDirs.length ) {
+	if ( styleOptions.repo && !sourceDirs.length ) {
 		throw new Error( `styles source not found: ${ configuredSourceDirs.join( ', ' ) }` );
 	}
 
@@ -1532,13 +1577,12 @@ function syncStyles( options ) {
 	} );
 
 	const localeTargets = [ 'en-US', 'zh-CN' ];
-	if ( !commandExists( 'curl' ) ) {
+	if ( downloadUsesCurl && !commandExists( 'curl' ) ) {
 		throw new Error( 'curl is required for styles sync' );
 	}
 	for ( const locale of localeTargets ) {
-		const localeUrl = `https://raw.githubusercontent.com/citation-style-language/locales/master/locales-${ locale }.xml`;
 		const dest = path.join( localeDir, `locales-${ locale }.xml` );
-		runCommandOrThrow( 'curl', [ '-fsSL', localeUrl, '-o', dest ] );
+		downloadFile( styleLocaleUrls( locale ), dest, `locale ${ locale }` );
 	}
 
 	process.stdout.write( `styles synced to ${ cslDir } from ${ sourceDirs.join( ', ' ) } (copied ${ copiedCount } files)\n` );
@@ -4979,9 +5023,11 @@ function main() {
 			usage();
 			process.exit( 1 );
 		}
-		syncStyles( parsed ).catch( ( error ) => {
+		try {
+			syncStyles( parsed );
+		} catch ( error ) {
 			handleCommandError( error, parsed, 'styles', 'sync' );
-		} );
+		}
 		return;
 	}
 
@@ -5140,12 +5186,14 @@ function main() {
 }
 
 module.exports = {
+	downloadFileWithCurlFallbacks,
 	detectPdfIdentifierCandidates,
 	extractBestDoiCandidate,
 	extractPdfCandidates,
 	main,
 	normalizeArxivId,
 	normalizeDoi,
+	syncStyles,
 	shouldAttemptPdfOcr
 };