dsh-plugin-writing-guard

Writing Guard

Scientific Writing & Document Integrity Guard for AI-assisted research

Less explanation. More argument. Preserve the science.

Writing Guard combines prompt-guided scientific prose discipline with deterministic integrity checks for AI-assisted research. It protects your manuscript across five layers:

Prompt-guided writing · Deterministic integrity core · 394 Tests

npm install dsh-plugin-writing-guard

Writing Guard does not write your paper for you.

It makes AI-assisted writing safer to ship.

New in 2.0 — Argument Economy & Control-Plane Separation

Writing Guard 2.0 moves semantic style decisions before generation and keeps deterministic code focused on integrity.

• Critique is not content — reviewer/user/guard wording is control context, not manuscript evidence.
• Prefer CUT over REWRITE — if a sentence only prevents criticism, reassures reviewers, advertises importance, or repeats an obvious implication, delete it.
• Do not close every semantic loop — stop after evidence + necessary interpretation; keep non-obvious statistical interpretation and reproducibility detail.
• Style-only revisions default to same length or shorter — no explanatory inflation without new supported content.
• Auto-audit no longer reinjects snippets or rewrite suggestions — only structured rule/action metadata is sent back to the agent.
• New English/Chinese cues for defensive-purpose framing, semantic-closure markers, and content-free evaluation.

Example:

Avoid:  To prevent data leakage, normalization was carefully performed using only the training data.
Prefer: Normalization parameters were estimated from the training data.

The second sentence states the method fact without importing the defensive reason for mentioning it.

🛡️ Word Document Guard (introduced in 1.8)

Change what was requested. Verify what wasn't.

AI-assisted document editing introduces a subtle risk: the requested text may improve while unrelated parts of the manuscript silently change.

When you ask an AI agent to "rewrite paragraph 3 only," it may inadvertently modify:

• equation structures
• table borders
• numbering
• styles
• section geometry
• relationships
• embedded media
• OOXML package parts

Writing Guard 1.8 introduces a document-integrity layer for Word manuscripts:

Before / After

Without Writing Guard:

"Please improve the wording in paragraph 3."
→ AI agent modifies DOCX.
→ Result: paragraph looks better.
→ Unknown: what else changed?

With Writing Guard:

"Please improve the wording in paragraph 3."
→ Writing Guard:
   ✓ scope validated
   ✓ package valid
   ✓ equations preserved
   ✓ protected structures unchanged
   ✓ document fingerprint checked
→ Result: paragraph changed — and unintended document drift is detected.

Quick Start

# Install
dsh plugin add dsh-plugin-writing-guard

# Restart
dsh web

Natural Language Usage

Once installed, you can use natural language:

Five Guards — Detailed

STYLE — Argument Economy & Prose Discipline

Guides the host model before writing, then uses deterministic cues to audit mechanical, defensive, and over-explained prose:

• Revision residue: revised, as requested, 本轮, 审稿人要求
• Defensive writing: concession stacking, limitation pre-emption
• Mechanical rhetoric: 不是X而是Y, rather than abuse, triple parallelism
• LLM high-frequency words: delve / tapestry / testament (density-based)
• Chinese patterns and average sentence length anomalies

EVIDENCE — Scholarship + Epistemic Lock

Protects scientific facts during AI editing:

• Numbers, percentages, p-values, confidence intervals, units
• Citations, Figure/Table numbers, DOI
• Causal strength: associated with cannot become caused
• Null findings: no significant difference cannot disappear
• Scope boundaries and evidence status

JOURNAL — Target Journal Fit

Calibrates manuscript against target journal conventions:

• Syntax structure (sentence length, paragraph length)
• Voice and person (passive voice, first-person usage)
• Citations (bibliographic, figure/table references)
• Scientific claims (claim density, causal/evidential strength)
• Rhetorical moves (coverage, canonical order)

DELIVERY — Context Leakage Detection

Stops workflow context from leaking into final artifacts:

• Rejected alternatives
• Revision process residue
• Provenance leakage
• Defensive hedge leakage

DOCUMENT — Word Document Integrity 🆕

Safely edit Word manuscripts without breaking structure:

writing_word_scan → writing_word_edit → writing_word_scope_check

13 tools for complete document integrity:

Installation

# From npm (recommended)
dsh plugin add dsh-plugin-writing-guard

# From GitHub
dsh plugin add github:xmutfyh/dsh-plugin-writing-guard

# From local source
dsh plugin add ./path/to/dsh-plugin-writing-guard

Prerequisites:

• Node.js ≥ 18
• Python 3.10+ with python-docx (pip install python-docx)

Architecture

Writing Guard
├── STYLE (writing_audit)
│   ├── Revision residue detection
│   ├── AI style patterns
│   └── Density-based thresholds
├── EVIDENCE (Scholarship/Epistemic Lock)
│   ├── Number/unit preservation
│   ├── Citation integrity
│   └── Claim strength conservation
├── JOURNAL (Journal Profile)
│   ├── Corpus-aware analysis
│   ├── Section-level comparison
│   └── Rhetorical move matching
├── DELIVERY (CAL Detection)
│   ├── Rejected alternative leakage
│   ├── Process residue
│   └── Baseline reality check
└── DOCUMENT (Word Guard) 🆕
    ├── Structural scanning
    ├── Safe editing
    ├── Package validation
    ├── Fingerprinting
    └── Equation audit

Design principle: Baseline manuscript > journal/template > plugin defaults.

The LLM/agent decides *what* should change. Deterministic Word code decides *how* to make that change without silently altering unrelated formatting.

Tests

npm test

394 deterministic tests covering:

• STYLE, Scholarship Lock, Epistemic Lock
• Claim alignment, local citation integrity
• Journal Profile, Journal Fit
• DELIVERY (CAL detection)
• Word Guard (v1.8.2): OOXML validation, fingerprinting, equation audit

Security & Privacy

• Deterministic integrity checks run locally; semantic writing decisions are handled by the host model under the Writing Guard policy.
• The plugin only reads files being edited.
• The plugin itself does not upload or collect manuscript content.
• See SECURITY.md

Why Writing Guard?

Humanizer rewrites after writing. Writing Guard prevents during writing.

Brand

                  WRITING GUARD
                       │
       Scientific Writing & Document Integrity
                       │
 ┌─────────┬──────────┬─────────┬──────────┬──────────┐
 STYLE   EVIDENCE   JOURNAL   DELIVERY   DOCUMENT
                                            │
                               Change what was requested.
                               Verify what wasn't.

Classic slogan: Less AI. More Evidence. Better Journal Fit. Clean Delivery.

Document slogan: Change what was requested. Verify what wasn't.

CHANGELOG

See CHANGELOG.md.

License

MIT