citeclaw 2.0.5 → 2.0.7

package/README.md

@@ -23,7 +23,6 @@ Run from npm:
 
 ```bash
 npx citeclaw --help
-npx citeclaw translators sync
 npx citeclaw citoid formats
 npx citeclaw cite bibtex 10.48550/arXiv.1706.03762
 npx citeclaw crossref "10.1021/acsomega.2c05310"
@@ -38,11 +37,7 @@ npx citeclaw citoid bibtex "https://aclanthology.org/2023.emnlp-main.398/"
 npx citeclaw cite mediawiki "https://arxiv.org/abs/1706.03762"
 ```
 
-Fresh npm installs need translator runtime sync before citation commands that depend on Zotero translators:
-
-```bash
-npx citeclaw translators sync
-```
+Fresh npm installs can run normal citation commands directly. `CiteClaw` will bootstrap Zotero and build a local translator runtime automatically from the bundled Zotero translator set.
 
 ## Local Service
 
@@ -125,7 +120,7 @@ Safety defaults:
 
 ## Runtime Sync
 
-For npm installs, runtime assets are synced explicitly instead of silently bundled:
+For npm installs, extra runtime assets can be synced explicitly when you want broader coverage or local style rendering:
 
 ```bash
 npx citeclaw translators sync
@@ -135,7 +130,7 @@ npx citeclaw styles sync
 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 bundled styles are unavailable
+- `styles sync` will clone or update style repositories with `git` when local CSL styles are unavailable
 - if `git` is not installed, the commands fail with an explicit message
 
 ## Bibliography Curation

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "citeclaw",
-	"version": "2.0.5",
+	"version": "2.0.7",
 	"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

@@ -612,6 +612,7 @@ function ensureDefaultZoteroSource() {
 				throw new Error( 'git is required to update bundled zotero source' );
 			}
 			runCommandOrThrow( 'git', [ '-C', zoteroDir, 'pull', '--ff-only' ] );
+			runCommandOrThrow( 'git', [ '-C', zoteroDir, 'submodule', 'update', '--init', '--recursive' ] );
 		}
 		return;
 	}
@@ -621,7 +622,7 @@ function ensureDefaultZoteroSource() {
 		);
 	}
 	fs.mkdirSync( path.dirname( zoteroDir ), { recursive: true } );
-	runCommandOrThrow( 'git', [ 'clone', '--depth', '1', defaultZoteroGitSource, zoteroDir ] );
+	runCommandOrThrow( 'git', [ 'clone', '--depth', '1', '--recurse-submodules', defaultZoteroGitSource, zoteroDir ] );
 }
 
 function bootstrapLocalEnvironment() {
@@ -643,9 +644,8 @@ function bootstrapLocalEnvironment() {
 	if ( !fileExists( path.join( zoteroDir, 'node_modules' ) ) ) {
 		runCommandOrThrow( installer.command, installer.args, zoteroDir );
 	}
-	if ( !fileExists( mergedTranslatorsDir ) ||
-		!fs.readdirSync( mergedTranslatorsDir, { withFileTypes: true } ).some( ( entry ) => entry.isFile() && entry.name.endsWith( '.js' ) ) ) {
-		throw new Error( 'translators are not synced. Run: citeclaw translators sync' );
+	if ( translatorsNeedSync() ) {
+		syncMergedTranslators();
 	}
 }
 
@@ -669,7 +669,7 @@ function ensureStyleRuntime() {
 	if ( fileExists( cslDir ) && fileExists( localeDir ) ) {
 		return;
 	}
-	throw new Error( 'Styles are not synced. Run: citeclaw styles sync' );
+	syncStyles( {} );
 }
 
 function ensureDefaultStyleSources() {
@@ -1504,7 +1504,7 @@ async function runCitationFromPdf( pdfPath, options ) {
 	} );
 }
 
-async function syncStyles( options ) {
+function syncStyles( options ) {
 	ensureDirs();
 	fs.mkdirSync( cslDir, { recursive: true } );
 	fs.mkdirSync( localeDir, { recursive: true } );