docrev 0.9.16 → 0.9.18

package/lib/schema.ts

@@ -91,6 +91,23 @@ export const revYamlSchema: Schema = {
       type: 'string',
       description: 'Journal profile name for formatting defaults and validation',
     },
+    'pandoc-args': {
+      type: 'array',
+      description: 'Extra pandoc args applied to every format build (e.g. --lua-filter=...). Format-specific lists are appended after these; --pandoc-arg CLI values are appended last.',
+      items: { type: 'string' },
+    },
+    output: {
+      type: 'object',
+      description: 'Per-format output filenames. Keys are format names (pdf, docx, tex, beamer, pptx); values are paths. Relative paths resolve under outputDir; absolute paths are honored as-is. Extension auto-added if missing. CLI `-o` overrides this map.',
+      properties: {
+        pdf: { type: 'string' },
+        docx: { type: 'string' },
+        tex: { type: 'string' },
+        beamer: { type: 'string' },
+        pptx: { type: 'string' },
+      },
+      additionalProperties: false,
+    },
     sections: {
       type: 'array',
       description: 'Ordered list of section files to include',
@@ -160,6 +177,11 @@ export const revYamlSchema: Schema = {
         toc: { type: 'boolean', default: false },
         header: { type: 'string' },
         footer: { type: 'string' },
+        'pandoc-args': {
+          type: 'array',
+          description: 'Extra pandoc args for PDF builds. Appended after the top-level pandoc-args list.',
+          items: { type: 'string' },
+        },
       },
       additionalProperties: true,
     },
@@ -170,6 +192,16 @@ export const revYamlSchema: Schema = {
         reference: { type: 'string', description: 'Reference document for styling' },
         keepComments: { type: 'boolean', default: true },
         toc: { type: 'boolean', default: false },
+        translateRawFigures: {
+          type: 'boolean',
+          default: true,
+          description: 'Auto-translate the common \\begin{figure}...\\end{figure} shape to portable ![](){#fig: ...} markdown so figures render in docx. Pandoc strips raw LaTeX in docx output silently otherwise.',
+        },
+        'pandoc-args': {
+          type: 'array',
+          description: 'Extra pandoc args for DOCX builds. Appended after the top-level pandoc-args list.',
+          items: { type: 'string' },
+        },
       },
       additionalProperties: true,
     },
@@ -178,6 +210,11 @@ export const revYamlSchema: Schema = {
       description: 'LaTeX output settings',
       properties: {
         standalone: { type: 'boolean', default: true },
+        'pandoc-args': {
+          type: 'array',
+          description: 'Extra pandoc args for TeX builds. Appended after the top-level pandoc-args list.',
+          items: { type: 'string' },
+        },
       },
       additionalProperties: true,
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docrev",
-  "version": "0.9.16",
+  "version": "0.9.18",
   "description": "Academic paper revision workflow: Word ↔ Markdown round-trips, DOI validation, reviewer comments",
   "type": "module",
   "types": "dist/lib/types.d.ts",

package/skill/REFERENCE.md

@@ -62,11 +62,77 @@ rev build docx               # DOCX only
 rev build --toc              # Include table of contents
 rev build docx --dual        # Clean + annotated versions
 rev build docx --show-changes  # DOCX with visible track changes (audit)
+rev build docx --pandoc-arg=--lua-filter=tofill.lua   # Pass extra args to pandoc
+rev build -o Final_Report     # Override output filename (extension auto-added)
+rev build pdf --verbose      # Echo the pandoc invocation (useful for filter debugging)
 ```
 
 By default, outputs land in `output/` next to `rev.yaml`. Override or
 disable via the `outputDir` field in rev.yaml (see below).
 
+#### Choosing output filenames
+
+By default, the output basename is derived from `title:` (slugified — e.g.
+"My Paper" → `my-paper.docx`). Long titles are truncated at word boundaries
+(at the last `-` at-or-before 80 chars), so `communities` stays whole instead
+of becoming `communitie`.
+
+To pick your own filename, set per-format names in `rev.yaml`:
+
+```yaml
+output:
+  docx: ADAPT_proposal_draft.docx
+  pdf: ADAPT_proposal_draft.pdf
+```
+
+Extensions are optional — `ADAPT_proposal_draft` is fine, the right extension
+is added per format. Relative paths resolve under `outputDir`; absolute paths
+bypass `outputDir`.
+
+Or override on the command line with `-o, --output <path>`:
+
+```bash
+rev build docx -o Final_Report           # → output/Final_Report.docx
+rev build pdf docx -o Final_Report       # Applies to both formats
+rev build -o /tmp/draft.docx docx        # Absolute path bypasses outputDir
+```
+
+CLI `-o` wins over `output:` in `rev.yaml`. When `--dual` is on, the
+`_comments` variant piggybacks on the chosen name (e.g.
+`Final_Report_comments.docx`). When `--show-changes` is on, the audit DOCX
+uses the chosen name with a `-changes` suffix
+(e.g. `Final_Report-changes.docx`).
+
+#### Passing custom pandoc args
+
+For pandoc flags rev doesn't surface directly (Lua/JSON filters, custom
+templates, variables, etc.), use the repeatable `--pandoc-arg` flag or the
+`pandoc-args` field in `rev.yaml`:
+
+```yaml
+# rev.yaml — applies to every format
+pandoc-args:
+  - --lua-filter=tofill.lua
+  - --shift-heading-level-by=1
+
+# Format-specific (concatenated after the top-level list)
+docx:
+  pandoc-args:
+    - --lua-filter=docx_only.lua
+pdf:
+  pandoc-args:
+    - --variable=papersize:a4
+```
+
+```bash
+# CLI overrides — appended last, so pandoc's last-wins rule lets CLI flags
+# beat repeated config flags
+rev build docx --pandoc-arg=--lua-filter=cli.lua --pandoc-arg=--metadata=draft:true
+```
+
+Run with `--verbose` to print the full pandoc command line (one per format).
+Copy-paste it into a terminal to reproduce a build manually.
+
 The `--dual` flag produces:
 - `output/<title>.docx` — clean, for submission
 - `output/<title>_comments.docx` — includes comment threads as Word comments

package/skill/SKILL.md

@@ -17,9 +17,8 @@ Layout is controlled in `rev.yaml`:
 
 ```yaml
 title: "My Document"
-output:
-  docx:
-    reference-doc: template.docx
+docx:
+  reference: template.docx
 ```
 
 Change the template, rebuild, and every document gets the new formatting.
@@ -98,7 +97,15 @@ revision is rendered as a visible Word track change. Useful when a co-author
 wants to see what changed since the last shared version.
 
 Outputs land in `output/` by default; set `outputDir: null` in `rev.yaml`
-to keep them alongside `paper.md` (legacy layout).
+to keep them alongside `paper.md` (legacy layout). The basename is derived
+from `title:` unless overridden — set `output: { docx: foo.docx, pdf: foo.pdf }`
+in `rev.yaml` or pass `-o, --output <path>` on the CLI. See REFERENCE.md →
+"Choosing output filenames".
+
+For pandoc flags rev doesn't surface directly (Lua filters, custom variables,
+templates), use `--pandoc-arg` (repeatable) or `pandoc-args:` in `rev.yaml`
+(both top-level and per-format). Run with `--verbose` to see the exact pandoc
+invocation. See REFERENCE.md → "Passing custom pandoc args" for details.
 
 ### 8. Archive reviewer files
 
@@ -183,6 +190,20 @@ Use in markdown files:
 - `@eq:label` - Equation reference
 - `{#fig:label}` - Anchor for figures
 
+Insert a figure with the format-portable syntax (renders in both PDF and Word):
+
+```markdown
+![Caption text.](figures/foo.pdf){#fig:foo width=80%}
+```
+
+Raw `\begin{figure}...\end{figure}` LaTeX blocks are PDF-only. For docx
+builds, `rev` auto-translates the common shape (single `\includegraphics`
+with optional `\caption{...}` and `\label{...}`) to the markdown form above
+so figures still render. Exotic blocks (`\subfloat`, `\rotatebox`, multiple
+`\includegraphics`) are left alone and warned about — convert them by hand
+or supply a custom Lua filter via `--pandoc-arg`. Opt out of auto-translate
+with `docx.translateRawFigures: false` in `rev.yaml`.
+
 ## Template Variables
 
 Available in section files (processed during build):

package/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Skill(code-quality)"
-    ],
-    "deny": [],
-    "ask": []
-  }
-}