scientific-writer 2.2.3__py3-none-any.whl → 2.3.0__py3-none-any.whl

scientific_writer/.claude/WRITER.md

@@ -186,6 +186,43 @@ paper_outputs/
         └── supplementary.pdf
 ```
 
+### CRITICAL: Manuscript Editing Workflow
+
+**When manuscript files (.tex, .md, .docx, .pdf) are found in the data/ folder:**
+
+1. **ALWAYS copy manuscript files to the drafts/ folder** (not the data/ folder)
+   - File types to treat as manuscripts: `.tex`, `.md`, `.docx`, `.pdf`
+   - These files should go to `drafts/` folder in the new paper directory
+   - This signals the task is an EDITING task, not creating from scratch
+
+2. **Recognize this as an EDITING task:**
+   - When manuscript files are present in drafts/, your task is to EDIT the existing manuscript
+   - Print: `[HH:MM:SS] EDITING MODE: Found existing manuscript - [filename]`
+   - Print: `[HH:MM:SS] TASK: Editing and improving existing manuscript`
+   - Update progress.md to note this is an editing task
+
+3. **Editing Workflow:**
+   - Read the existing manuscript file(s) from drafts/
+   - Identify the format (.tex, .md, .docx, .pdf)
+   - Follow the user's editing instructions
+   - Create new version with incremented number (v2, v3, etc.)
+   - Document all changes in revision_notes.md
+   - Print: `[HH:MM:SS] EDITING: Reading existing manuscript from drafts/[filename]`
+   - Print: `[HH:MM:SS] EDITING: Creating [version] with requested changes`
+
+4. **What gets copied where:**
+   - **Manuscript files** (.tex, .md, .docx, .pdf) → `drafts/` folder
+   - **Image files** (.png, .jpg, .pdf figures, etc.) → `figures/` folder
+   - **Data files** (CSV, Excel, JSON, etc.) → `data/` folder
+
+5. **Example Scenario:**
+   - User places `my_paper.tex` in `data/` folder
+   - System creates: `paper_outputs/20241104_143000_edit_paper/`
+   - System copies: `my_paper.tex` → `drafts/my_paper.tex`
+   - System recognizes: "This is an editing task"
+   - System prints: `[HH:MM:SS] EDITING MODE: Found manuscript my_paper.tex in drafts/`
+   - System applies edits and creates: `drafts/v2_my_paper.tex` or `drafts/v1_draft.tex` (based on instructions)
+
 ### Naming Conventions
 
 - **Folders:** `lowercase_with_underscores`

scientific_writer/__init__.py

@@ -29,7 +29,7 @@ Example:
 from .api import generate_paper
 from .models import ProgressUpdate, PaperResult, PaperMetadata, PaperFiles
 
-__version__ = "2.2.3"
+__version__ = "2.3.0"
 __author__ = "K-Dense"
 __license__ = "MIT"
 

scientific_writer/api.py

@@ -77,8 +77,8 @@ async def generate_paper(
     if cwd:
         work_dir = Path(cwd).resolve()
     else:
-        # Default to user's current working directory
-        work_dir = Path.cwd()
+        # Default to user's current working directory (absolute path)
+        work_dir = Path.cwd().resolve()
     
     # Get package directory for copying skills to working directory
     package_dir = Path(__file__).parent.absolute()  # scientific_writer/ directory
@@ -100,7 +100,13 @@ async def generate_paper(
     system_instructions = load_system_instructions(work_dir)
     
     # Add conversation continuity instruction
-    system_instructions += "\n\n" + """
+    system_instructions += "\n\n" + f"""
+IMPORTANT - WORKING DIRECTORY:
+- Your working directory is: {work_dir}
+- ALWAYS create paper_outputs folder in this directory: {work_dir}/paper_outputs/
+- NEVER write to /tmp/ or any other temporary directory
+- All paper outputs MUST go to: {work_dir}/paper_outputs/<timestamp>_<description>/
+
 IMPORTANT - CONVERSATION CONTINUITY:
 - This is a NEW paper request - create a new paper directory
 - Create a unique timestamped directory in the paper_outputs folder
@@ -190,8 +196,12 @@ IMPORTANT - CONVERSATION CONTINUITY:
                     delete_originals=False  # Don't delete when using programmatic API
                 )
                 if processed_info:
+                    manuscript_count = len(processed_info.get('manuscript_files', []))
+                    message = f"Processed {len(processed_info['all_files'])} file(s)"
+                    if manuscript_count > 0:
+                        message += f" ({manuscript_count} manuscript(s) copied to drafts/)"
                     yield ProgressUpdate(
-                        message=f"Processed {len(processed_info['all_files'])} data file(s)",
+                        message=message,
                         stage="complete",
                         percentage=97,
                     ).to_dict()

scientific_writer/cli.py

@@ -35,7 +35,8 @@ async def main():
         sys.exit(1)
     
     # Get the current working directory (user's directory) and package directory
-    cwd = Path.cwd()  # User's current working directory
+    # Capture and resolve the current working directory at CLI invocation time
+    cwd = Path.cwd().resolve()  # User's current working directory (absolute path)
     package_dir = Path(__file__).parent.absolute()  # Package installation directory (scientific_writer/)
     
     # Set up Claude skills in the working directory (includes WRITER.md)
@@ -50,7 +51,13 @@ async def main():
     # Add conversation continuity instruction  
     # Note: The Python CLI handles session tracking via current_paper_path
     # These instructions only apply WITHIN a single CLI session, not across different chat sessions
-    system_instructions += "\n\n" + """
+    system_instructions += "\n\n" + f"""
+IMPORTANT - WORKING DIRECTORY:
+- Your working directory is: {cwd}
+- ALWAYS create paper_outputs folder in this directory: {cwd}/paper_outputs/
+- NEVER write to /tmp/ or any other temporary directory
+- All paper outputs MUST go to: {cwd}/paper_outputs/<timestamp>_<description>/
+
 IMPORTANT - CONVERSATION CONTINUITY:
 - The user will provide context in their prompt if they want to continue working on an existing paper
 - If the prompt includes [CONTEXT: You are currently working on a paper in: ...], continue editing that paper
@@ -89,11 +96,13 @@ IMPORTANT - CONVERSATION CONTINUITY:
     print("  2. I'll provide continuous updates during the process")
     print("  3. All outputs saved to: paper_outputs/<timestamp_description>/")
     print("  4. Progress tracked in real-time in progress.md")
-    print(f"\n📁 Output folder: {output_folder}")
+    print(f"\n📁 Working directory: {cwd}")
+    print(f"📁 Output folder: {output_folder}")
     print(f"\n📦 Data Files:")
     print("  • Place files in the 'data/' folder to include them in your paper")
-    print("  • Data files → copied to paper's data/ folder")
-    print("  • Images → copied to paper's figures/ folder")
+    print("  • Manuscript files (.tex, .md, .docx, .pdf) → copied to drafts/ for EDITING")
+    print("  • Data files (csv, txt, json, etc.) → copied to paper's data/ folder")
+    print("  • Images (png, jpg, svg, etc.) → copied to paper's figures/ folder")
     print("  • Original files are automatically deleted after copying")
     print("\n🤖 Intelligent Paper Detection:")
     print("  • I automatically detect when you're referring to a previous paper")
@@ -154,8 +163,11 @@ IMPORTANT - CONVERSATION CONTINUITY:
                 processed_info = process_data_files(cwd, data_files, current_paper_path)
                 if processed_info:
                     data_context = create_data_context_message(processed_info)
-                    data_count = len(processed_info['data_files'])
-                    image_count = len(processed_info['image_files'])
+                    manuscript_count = len(processed_info.get('manuscript_files', []))
+                    data_count = len(processed_info.get('data_files', []))
+                    image_count = len(processed_info.get('image_files', []))
+                    if manuscript_count > 0:
+                        print(f"   ✓ Copied {manuscript_count} manuscript file(s) to drafts/ [EDITING MODE]")
                     if data_count > 0:
                         print(f"   ✓ Copied {data_count} data file(s) to data/")
                     if image_count > 0:
@@ -212,8 +224,11 @@ User request: {user_input}"""
                                 print(f"\n📦 Processing {len(remaining_data_files)} data file(s)...")
                                 processed_info = process_data_files(cwd, remaining_data_files, current_paper_path)
                                 if processed_info:
-                                    data_count = len(processed_info['data_files'])
-                                    image_count = len(processed_info['image_files'])
+                                    manuscript_count = len(processed_info.get('manuscript_files', []))
+                                    data_count = len(processed_info.get('data_files', []))
+                                    image_count = len(processed_info.get('image_files', []))
+                                    if manuscript_count > 0:
+                                        print(f"   ✓ Copied {manuscript_count} manuscript file(s) to drafts/ [EDITING MODE]")
                                     if data_count > 0:
                                         print(f"   ✓ Copied {data_count} data file(s) to data/")
                                     if image_count > 0:
@@ -265,6 +280,7 @@ def _print_help():
     print("  - SUMMARY.md - Project summary and instructions")
     print("\n📦 Data Files:")
     print("  Place files in the 'data/' folder at project root:")
+    print("  • Manuscript files (.tex, .md, .docx, .pdf) → copied to drafts/ for EDITING")
     print("  • Data files (csv, txt, json, etc.) → copied to paper's data/")
     print("  • Images (png, jpg, svg, etc.) → copied to paper's figures/")
     print("  • Files are used as context for the paper")

scientific_writer/core.py

@@ -106,6 +106,11 @@ def get_image_extensions() -> set:
     return {'.png', '.jpg', '.jpeg', '.gif', '.bmp', '.tiff', '.tif', '.svg', '.webp', '.ico'}
 
 
+def get_manuscript_extensions() -> set:
+    """Return a set of manuscript file extensions that should go to drafts/ folder."""
+    return {'.tex', '.md', '.docx', '.pdf'}
+
+
 def get_data_files(cwd: Path, data_files: Optional[List[str]] = None) -> List[Path]:
     """
     Get data files either from provided list or from data folder.
@@ -140,7 +145,8 @@ def process_data_files(
 ) -> Optional[Dict[str, Any]]:
     """
     Process data files by copying them to the paper output folder.
-    Images go to figures/, other files go to data/.
+    Manuscript files (.tex, .md, .docx, .pdf) go to drafts/, 
+    images go to figures/, other files go to data/.
     
     Args:
         cwd: Current working directory (project root).
@@ -157,15 +163,20 @@ def process_data_files(
     paper_output = Path(paper_output_path)
     data_output = paper_output / "data"
     figures_output = paper_output / "figures"
+    drafts_output = paper_output / "drafts"
     
     # Ensure output directories exist
     data_output.mkdir(parents=True, exist_ok=True)
     figures_output.mkdir(parents=True, exist_ok=True)
+    drafts_output.mkdir(parents=True, exist_ok=True)
     
     image_extensions = get_image_extensions()
+    manuscript_extensions = get_manuscript_extensions()
+    
     processed_info = {
         'data_files': [],
         'image_files': [],
+        'manuscript_files': [],
         'all_files': []
     }
     
@@ -174,7 +185,17 @@ def process_data_files(
         file_name = file_path.name
         
         # Determine destination based on file type
-        if file_ext in image_extensions:
+        # CRITICAL: Manuscript files go to drafts/ folder for editing workflow
+        if file_ext in manuscript_extensions:
+            destination = drafts_output / file_name
+            file_type = 'manuscript'
+            processed_info['manuscript_files'].append({
+                'name': file_name,
+                'path': str(destination),
+                'original': str(file_path),
+                'extension': file_ext
+            })
+        elif file_ext in image_extensions:
             destination = figures_output / file_name
             file_type = 'image'
             processed_info['image_files'].append({
@@ -225,12 +246,24 @@ def create_data_context_message(processed_info: Optional[Dict[str, Any]]) -> str
     
     context_parts = ["\n[DATA FILES AVAILABLE]"]
     
-    if processed_info['data_files']:
+    # CRITICAL: If manuscript files are present, this is an EDITING task
+    if processed_info.get('manuscript_files'):
+        context_parts.append("\n⚠️  EDITING MODE - Manuscript files detected!")
+        context_parts.append("\nManuscript files (in drafts/ folder for editing):")
+        for file_info in processed_info['manuscript_files']:
+            context_parts.append(f"  - {file_info['name']} ({file_info['extension']}): {file_info['path']}")
+        context_parts.append("\n🔧 TASK: This is an EDITING task, not creating from scratch.")
+        context_parts.append("   → Read the existing manuscript from drafts/")
+        context_parts.append("   → Apply the requested changes/improvements")
+        context_parts.append("   → Create new version following version numbering protocol")
+        context_parts.append("   → Document changes in revision_notes.md")
+    
+    if processed_info.get('data_files'):
         context_parts.append("\nData files (in data/ folder):")
         for file_info in processed_info['data_files']:
             context_parts.append(f"  - {file_info['name']}: {file_info['path']}")
     
-    if processed_info['image_files']:
+    if processed_info.get('image_files'):
         context_parts.append("\nImage files (in figures/ folder):")
         for file_info in processed_info['image_files']:
             context_parts.append(f"  - {file_info['name']}: {file_info['path']}")

{scientific_writer-2.2.3.dist-info → scientific_writer-2.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scientific-writer
-Version: 2.2.3
+Version: 2.3.0
 Summary: AI-powered scientific writing with programmatic API and CLI - powered by Claude Sonnet 4.5 and the Claude Agents SDK
 License: MIT
 License-File: LICENSE

{scientific_writer-2.2.3.dist-info → scientific_writer-2.3.0.dist-info}/RECORD

@@ -1,10 +1,10 @@
-scientific_writer/__init__.py,sha256=9BVGd3cosRJSt25lC0pEHoZBxHlbvmepGPx1AXsnagc,1159
-scientific_writer/api.py,sha256=E2PKi3gszuw_PZU8edswkvk8enBOfhIM8S_KxNWRcUc,12872
-scientific_writer/cli.py,sha256=PzwcNwPY_af4VcLFtIBSTk3xJQ7D79dSfOXUZxIcBM0,14940
-scientific_writer/core.py,sha256=EXhh9p_y0gkuXFD0a47F9vlVaRipQ6W5Ng5Lyzieg4A,7656
+scientific_writer/__init__.py,sha256=HgoE10KEe_et14scVDkKWFJSK1pBLPERLVswyP1nXrU,1159
+scientific_writer/api.py,sha256=16nrMWEMpSeIqZPYY0QZzw9QoV1N7D1RJouKtBC_nPA,13450
+scientific_writer/cli.py,sha256=_xIXJ_ptpUlmzG-Ocq2OXRFZUsHuMkXHzCEz-9iN13Y,16172
+scientific_writer/core.py,sha256=rpvoMalqS5zPq1xYLQ0heNUofx-ffGmt3OXf3dyOSc0,9428
 scientific_writer/models.py,sha256=KjRjMjn4GtbHLIUrx2EZB4omGcZeLbflaTJmfNV1M6Y,2629
 scientific_writer/utils.py,sha256=z2nX3PDEcfW4pN_w47TDDC6Kmdcw5uFUGrT8T6lZYSg,9032
-scientific_writer/.claude/WRITER.md,sha256=O-ThWtw-XJmeZF8MqGoF_bwGq3XNRKsF_Xog81k_3FM,32256
+scientific_writer/.claude/WRITER.md,sha256=mFpAWIwGrSaHGwyQLE0GO9gllOflSbecNZ72HR9ovPo,34172
 scientific_writer/.claude/settings.local.json,sha256=PVPFjrrlwJo6J3KgeGwxqfh2w0N4xW9r5cefTC36fX8,780
 scientific_writer/.claude/skills/citation-management/SKILL.md,sha256=guNDqOIuvqK1YHbVc5JGiM4MwSmyiytoUqzahNZHrrw,29916
 scientific_writer/.claude/skills/citation-management/assets/bibtex_template.bib,sha256=vwPMZG5rxqq6hdYyuOJbJsKDBBmJLzwXp9hEgF06ch4,9201
@@ -305,8 +305,8 @@ scientific_writer/.claude/skills/venue-templates/references/posters_guidelines.m
 scientific_writer/.claude/skills/venue-templates/scripts/customize_template.py,sha256=ikTF2rMjexS4y3udwtZR8XauleXwU1drG9RDf1M2-Co,6875
 scientific_writer/.claude/skills/venue-templates/scripts/query_template.py,sha256=RI0dzZB-igJZl8dJjbA7teiJy3T-j3reGf62sQpN8g4,8959
 scientific_writer/.claude/skills/venue-templates/scripts/validate_format.py,sha256=acRsRY4hqDsHrkzKIHeRZT7vle9q5SEjkFG3S4Vc5PQ,8766
-scientific_writer-2.2.3.dist-info/METADATA,sha256=2vKPGJa5r18o5uw_Mgyaav94gBA74cLldMEjUV4iX20,9992
-scientific_writer-2.2.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-scientific_writer-2.2.3.dist-info/entry_points.txt,sha256=pI1zUsWVV6eMkNEKfEmkKozOlLRZnhAZfXBsEyqXtqg,69
-scientific_writer-2.2.3.dist-info/licenses/LICENSE,sha256=H6FOLY6X6QMEnqcbDoq5BM0sBf-K-e1SIBAv0zSwxa4,1070
-scientific_writer-2.2.3.dist-info/RECORD,,
+scientific_writer-2.3.0.dist-info/METADATA,sha256=AtjSeFWL1V-iMucgaZvdeJB4x6BABuM7Qq86mHj9pzI,9992
+scientific_writer-2.3.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+scientific_writer-2.3.0.dist-info/entry_points.txt,sha256=pI1zUsWVV6eMkNEKfEmkKozOlLRZnhAZfXBsEyqXtqg,69
+scientific_writer-2.3.0.dist-info/licenses/LICENSE,sha256=H6FOLY6X6QMEnqcbDoq5BM0sBf-K-e1SIBAv0zSwxa4,1070
+scientific_writer-2.3.0.dist-info/RECORD,,