psyclaw 0.27.22 → 0.28.0

package/vendor/ars/academic-paper/references/apa7_chinese_citation_guide.md

@@ -0,0 +1,364 @@
+# APA 7.0 Complete Guide for Chinese Citations
+
+A Chinese APA 7.0 citation format guide based on Taiwan academic conventions. This guide is a Chinese-language extension of `apa7_extended_guide.md`, used by `citation_compliance_agent`, `draft_writer_agent`, and `formatter_agent`.
+
+---
+
+## Chinese Journal Articles
+
+### Basic Format
+
+```
+Author1, Author2 (Year). Article title. Journal Name, Volume(Issue), Pages. https://doi.org/xxxxx
+```
+
+### Examples
+
+**Single author**:
+```
+Wang, Da-Ming (2024). The impact of declining birthrate on private university management strategies. Journal of Higher Education, 15(2), 45-68. https://doi.org/10.6152/jhe.2024.0502.03
+```
+
+**Two authors**:
+```
+Wang, Da-Ming, & Li, Xiao-Hua (2024). The evolution and prospects of Taiwan's higher education quality assurance system. Bulletin of Educational Research, 70(1), 1-32. https://doi.org/10.3966/102887082024037001001
+```
+
+**Three or more authors**:
+```
+Wang, Da-Ming, Li, Xiao-Hua, Zhang, San-Feng, Chen, Si-Hai, & Lin, Wu-Zhou (2023). A meta-analysis of blended learning models on university student learning outcomes. Bulletin of Educational Psychology, 55(2), 201-228. https://doi.org/10.6251/BEP.202312_55(2).0002
+```
+
+**In-text citations**:
+- Single author: Wang (2024) states... / ...(Wang, 2024)
+- Two authors: Wang and Li (2024)... / ...(Wang & Li, 2024)
+- Three or more (first time): Wang et al. (2023)... / ...(Wang et al., 2023)
+- Three or more (subsequent): Wang et al. (2023)...
+
+---
+
+## Chinese Books
+
+### Basic Format
+
+```
+Author (Year). Book title. Publisher.
+```
+
+### Examples
+
+**Single author**:
+```
+Zhang, San (2023). A history of Taiwan's higher education development. Wu-Nan Books.
+```
+
+**Edited book**:
+```
+Wang, Wu (Ed.) (2023). Higher education quality management: Theory and practice. Higher Education Publishing.
+```
+
+**Multiple editions**:
+```
+Lin, Liu (2024). Educational research methods (5th ed.). Psychological Publishing.
+```
+
+**Translated book**:
+```
+Creswell, J. W. (2023). Research design: Qualitative, quantitative, and mixed methods approaches (F.-F. Zhang, Trans.; 5th ed.). Scholarly Cultural Enterprise. (Original work published 2018)
+```
+
+**In-text citations**:
+- Zhang (2023) mentions in his work...
+- ...(Zhang, 2023, p. 45-48)
+- Translated book: Creswell (2018/2023)...
+
+---
+
+## Chinese Book Chapters
+
+### Basic Format
+
+```
+Chapter author (Year). Chapter title. In Editor name (Ed.), Book title (pp. Pages). Publisher.
+```
+
+### Examples
+
+```
+Li, Si (2023). The evolution of quality assurance systems. In W. Wang (Ed.), Higher education quality management: Theory and practice (pp. 45-78). Higher Education Publishing.
+```
+
+```
+Chen, Mei-Ling (2024). The practice of university social responsibility. In Z.-C. Lin & S.-L. Huang (Eds.), New trends in Taiwan's university governance (pp. 112-145). Wu-Nan Books.
+```
+
+---
+
+## Chinese Theses and Dissertations
+
+### Basic Format
+
+```
+Author (Year). Thesis title (Unpublished master's/doctoral dissertation). University name.
+```
+
+### Examples
+
+**Unpublished thesis/dissertation**:
+```
+Chen, Liu (2024). The impact of AI-assisted instruction on student learning outcomes: A case study of National Taiwan University (Unpublished master's thesis). National Taiwan University.
+```
+
+**Published (with DOI or database)**:
+```
+Huang, Qi (2023). A case study of private university transformation strategies (Doctoral dissertation, National Chengchi University). National Digital Library of Theses and Dissertations in Taiwan. https://hdl.handle.net/11296/xxxxx
+```
+
+**In-text citations**:
+- Chen (2024) found in their study...
+- ...(Chen, 2024)
+
+---
+
+## Government Publications
+
+### Basic Format
+
+```
+Organization name (Year). Publication title. https://url
+```
+
+### Examples
+
+**Government report**:
+```
+Ministry of Education (2024). Academic Year 113 higher education institution transparency platform statistics. https://udb.moe.edu.tw/
+```
+
+**Legislation**:
+```
+Ministry of Education (2023). University Act (amended June 28, 2023). Laws and Regulations Database of the Republic of China. https://law.moj.gov.tw/LawClass/LawAll.aspx?pcode=H0030001
+```
+
+**Accreditation report**:
+```
+Higher Education Evaluation and Accreditation Council of Taiwan (2024). Third-cycle institutional accreditation implementation plan (Academic Years 112-114). https://www.heeact.edu.tw/
+```
+
+**In-text citations**:
+- Ministry of Education (2024) statistics show...
+- ...(Higher Education Evaluation and Accreditation Council of Taiwan, 2024)
+
+---
+
+## Conference Papers
+
+### Basic Format
+
+```
+Author (Year, Month). Paper title [Conference paper]. Conference name, Location.
+```
+
+### Examples
+
+```
+Lin, Ba (2024, November). The impact of generative AI on higher education teaching [Conference paper]. 2024 Taiwan Education Academic Conference, Taipei, Taiwan.
+```
+
+---
+
+## Online Resources
+
+### Basic Format
+
+```
+Author or organization (Year). Webpage title. Website name. https://url
+```
+
+### Examples
+
+```
+National Development Council (2024). Population projections (2024 to 2070). https://pop-proj.ndc.gov.tw/
+```
+
+```
+University TW (2024, March 15). Analysis of Academic Year 113 university admission quotas. University TW website. https://www.unews.com.tw/
+```
+
+---
+
+## Mixed Chinese-English Citation Rules
+
+### Reference List Ordering
+
+**Option A (Recommended): Separate Chinese and English**
+- Chinese references listed first, ordered by author surname stroke count
+- English references listed after, ordered alphabetically by author surname
+- Separated by two headings: "Chinese References" and "English References"
+
+**Option B: Mixed Chinese-English Ordering**
+- All Chinese and English references listed together
+- Chinese ordered by stroke count, English by alphabetical order
+- Chinese entries placed at the corresponding phonetic/pinyin letter position (or all Chinese first)
+
+### In-Text Citation Format Differences
+
+| Element | Chinese | English |
+|------|------|------|
+| Parentheses | Full-width () | Half-width () |
+| Multiple author connector | Enumeration comma | & |
+| Three or more authors | et al. (Chinese equivalent) | et al. |
+| Year format | CE year | CE year |
+| Direct quote page | p. (Chinese format) | p. 45 |
+| Multi-page quote | pp. (Chinese format) | pp. 45-48 |
+
+### Mixed Citation Example (In-Text)
+
+```
+In recent years, the impact of declining birthrates on Taiwan's higher education has received widespread attention (Wang, 2024; Chen & Wang, 2023).
+Smith et al. (2024) and Wang et al. (2023) both indicated that private universities face particularly severe enrollment pressure.
+```
+
+### Mixed Reference List Example (Option A)
+
+```
+References
+
+I. Chinese References
+
+Wang, Da-Ming (2024). The impact of declining birthrate on private university management strategies. Journal of Higher Education, 15(2), 45-68.
+    https://doi.org/10.6152/jhe.2024.0502.03
+Li, Xiao-Hua, & Zhang, San-Feng (2023). The evolution of Taiwan's higher education quality assurance system. Educational Policy Forum, 26(3), 1-30.
+Higher Education Evaluation and Accreditation Council of Taiwan (2024). Third-cycle institutional accreditation implementation plan.
+    https://www.heeact.edu.tw/
+Ministry of Education (2024). Academic Year 113 higher education institution transparency platform statistics. https://udb.moe.edu.tw/
+
+II. English References
+
+Chen, L., & Wang, T. (2023). Quality assurance in East Asian higher education: A
+    comparative study. Higher Education, 85(3), 567-589.
+    https://doi.org/10.1007/s10734-023-01012-4
+Smith, J. A., Jones, B. C., & Brown, D. E. (2024). The impact of declining birth
+    rates on private university sustainability. Studies in Higher Education, 49(2),
+    234-251. https://doi.org/10.1080/03075079.2024.2301234
+```
+
+---
+
+## TSSCI Journal-Specific Conventions
+
+Some Taiwan Social Sciences Citation Index (TSSCI) journals have their own citation format requirements.
+
+### Common Education Journal Format Comparison
+
+| Journal | Citation Format | Special Requirements |
+|------|---------|---------|
+| Bulletin of Educational Research | APA 7th Chinese edition | Separate Chinese and English |
+| Bulletin of Educational Psychology | APA 7th Chinese edition | Separate Chinese and English; English translation of Chinese references required |
+| Journal of Research in Education Sciences | APA 7th Chinese edition | Separate Chinese and English |
+| Curriculum & Instruction Quarterly | APA 7th Chinese edition | Mixed Chinese-English ordering |
+| Educational Policy Forum | APA 7th Chinese edition | Separate Chinese and English; page format uses Chinese page notation |
+| Journal of Higher Education | APA 7th Chinese edition | Separate Chinese and English |
+| Taiwan Journal of Sociology of Education | APA 7th Chinese edition | Separate Chinese and English |
+
+### Submission Notes
+
+1. **Always check the target journal's submission guidelines** — the above are general conventions only
+2. Some journals require English translations appended to Chinese references (in square brackets)
+3. Some journals require romanized transliteration for all Chinese references
+4. DOI format varies slightly by journal (some require https://doi.org/, others only doi:)
+
+---
+
+## Common Chinese Citation Errors
+
+### 1. Author Name Format
+
+| Error | Correct | Explanation |
+|------|------|------|
+| Da-Ming Wang (2024) | Wang, Da-Ming (2024) | Chinese names should follow the citation format conventions |
+| Wang, Da-Ming (2024) in English format | Use Chinese name in Chinese references | Use Chinese names for Chinese references |
+| Wang, Li (2024) without separator | Wang & Li (2024) | Use appropriate connector between authors |
+
+### 2. Year Format
+
+| Error | Correct | Explanation |
+|------|------|------|
+| Wang (ROC Year 113) | Wang (2024) | APA always uses CE years |
+| Wang (2024 year) | Wang (2024) | Do not add the word "year" after the number |
+| Wang, 2024 without parentheses | Wang (2024) | Use proper parentheses |
+
+### 3. Punctuation
+
+| Error | Correct | Explanation |
+|------|------|------|
+| Period after journal name | Comma after journal name | Use comma after journal name to connect to volume/issue |
+| "p." before page numbers in journal articles | Page numbers only | Do not add page indicator before page numbers in journal article references |
+| Period after DOI/URL | No punctuation after DOI/URL | No period at the end of DOI/URL |
+
+### 4. Book Publication Information
+
+| Error | Correct | Explanation |
+|------|------|------|
+| Taipei: Publisher. | Publisher. | APA 7 does not require publication location |
+| Abbreviated publisher name | Full publisher name. | Use the publisher's full name |
+
+### 5. Translated Book Citations
+
+| Error | Correct |
+|------|------|
+| Creswell, translated by Zhang (2023) | Creswell, J. W. (2023). Book title (F.-F. Zhang, Trans.; 5th ed.). Publisher. (Original work published 2018) |
+
+---
+
+## Special Situation Handling
+
+### Same Author, Multiple Works in the Same Year
+
+```
+In-text: Wang (2024a)... Wang (2024b)...
+
+References:
+Wang (2024a). First paper title. Journal Name, Volume(Issue), Pages.
+Wang (2024b). Second paper title. Journal Name, Volume(Issue), Pages.
+```
+
+### Institutional Authors
+
+```
+In-text: Ministry of Education (2024)... / ...(Ministry of Education, 2024)
+First mention: Higher Education Evaluation and Accreditation Council of Taiwan [HEEACT] (2024)...
+Subsequent: HEEACT (2024)...
+```
+
+### Secondary Citations (Indirect Citations)
+
+```
+In-text: Wang's research (as cited in Li, 2024) indicates...
+References: Only list Li (2024); do not list Wang's original work
+```
+
+### Citing AI-Generated Content
+
+```
+OpenAI (2024). ChatGPT (Version GPT-4) [Large language model]. https://chat.openai.com
+
+Anthropic (2024). Claude (Version 3.5 Sonnet) [Large language model]. https://claude.ai
+```
+
+---
+
+## Quick Checklist
+
+After completing the reference list, check each item:
+
+- [ ] All in-text citations have corresponding reference list entries
+- [ ] All reference list entries have in-text citations
+- [ ] Chinese uses full-width punctuation; English uses half-width punctuation
+- [ ] Authors are connected with enumeration comma (Chinese) or & symbol (English)
+- [ ] Years consistently use CE years
+- [ ] No period at the end of DOI/URL
+- [ ] Chinese and English reference ordering is correct (stroke count / alphabetical)
+- [ ] Translated books include original publication year
+- [ ] Institutional authors use full names (abbreviation may be appended on first mention)
+- [ ] Book format complies with APA 7 (no publication location)

package/vendor/ars/academic-paper/references/apa7_extended_guide.md

@@ -0,0 +1,198 @@
+# APA 7th Edition — Extended Guide for Academic Paper Writing
+
+Extends `deep-research/references/apa7_style_guide.md` with additional rules specific to full paper writing (vs. research reports).
+
+## Paper-Specific APA Rules
+
+### Title Page (Student vs. Professional)
+
+**Professional Paper**:
+```
+Title of Paper (Bold, Centered, Title Case)
+[blank line]
+Author Name(s)
+Affiliation(s)
+[blank line]
+Author Note (optional)
+```
+
+**Student Paper**:
+```
+Title of Paper (Bold, Centered, Title Case)
+[blank line]
+Author Name
+Department, Institution
+Course Number: Course Name
+Instructor Name
+Due Date
+```
+
+### Running Head
+- Professional papers: shortened title (max 50 chars), ALL CAPS, left-aligned header
+- Student papers: no running head required (APA 7 change from 6th ed.)
+
+### Abstract Page
+- Heading: "Abstract" (centered, bold, not indented)
+- Single paragraph, no indent
+- 150-250 words (journal may specify differently)
+- Keywords line: "Keywords:" in italics, followed by lowercase keywords separated by commas
+
+### Section Headings (Detailed)
+
+| Level | Format | Example |
+|-------|--------|---------|
+| 1 | Centered, Bold, Title Case | **Introduction** |
+| 2 | Left-Aligned, Bold, Title Case | **Theoretical Framework** |
+| 3 | Left-Aligned, Bold Italic, Title Case | ***Constructivist Perspective*** |
+| 4 | Indented, Bold, Title Case, Period. |    **Social Constructivism.** Text continues... |
+| 5 | Indented, Bold Italic, Title Case, Period. |    ***Vygotsky's Zone.*** Text continues... |
+
+**Usage rules**:
+- Don't skip levels (e.g., don't go from Level 1 to Level 3)
+- Introduction doesn't need a Level 1 heading (it's assumed)
+- Subsections need at least 2 sibling sections
+
+## Extended Citation Rules
+
+### Works with 21+ Authors
+List first 19 authors, then "..." (ellipsis), then final author:
+```
+Author, A., Author, B., Author, C., Author, D., Author, E.,
+Author, F., Author, G., Author, H., Author, I., Author, J.,
+Author, K., Author, L., Author, M., Author, N., Author, O.,
+Author, P., Author, Q., Author, R., Author, S., ... Author, Z. (Year).
+```
+
+### Group Authors
+- First citation: Full name (Abbreviation) — e.g., World Health Organization (WHO)
+- Subsequent: Abbreviation only — e.g., WHO
+- In reference list: spell out full name
+
+### Works with No Author
+- Use the title in the author position
+- In-text: use short title in quotes ("Short Title," Year)
+- In reference list: alphabetize by the first significant word of the title
+
+### Personal Communications
+- In-text only: (J. Smith, personal communication, March 15, 2024)
+- NOT in reference list (not recoverable data)
+
+### Classical Works
+- No date needed for well-known classical works
+- Use original publication date / translation date: (Aristotle, trans. 1925)
+
+### Legal References
+- Follow *Bluebook* format for legal materials
+- Court cases italicized: *Brown v. Board of Education* (1954)
+
+## Extended Reference Formats
+
+### Software / App
+```
+Author, A. A. (Year). Title of software (Version X.X) [Computer software]. Publisher. URL
+```
+
+### Social Media
+```
+Author [@handle]. (Year, Month Day). Content of post up to first 20 words [Type of post]. Platform. URL
+```
+
+### Podcast Episode
+```
+Host, A. A. (Host). (Year, Month Day). Episode title (No. X) [Audio podcast episode]. In Podcast name. Publisher. URL
+```
+
+### YouTube Video
+```
+Author, A. A. [Screen name]. (Year, Month Day). Title of video [Video]. YouTube. URL
+```
+
+### Preprint
+```
+Author, A. A. (Year). Title of preprint. Name of Preprint Archive. https://doi.org/xxxxx
+```
+
+### AI-Generated Content (APA Guidance)
+```
+When citing AI-generated text:
+OpenAI. (2024). ChatGPT (Version 4) [Large language model]. https://chat.openai.com
+Note: Describe the prompt in the text. AI output is not recoverable,
+so provide the prompt and relevant output in appendix if needed.
+```
+
+## Tables and Figures (Extended)
+
+### Table Formatting
+```
+Table 1
+
+Descriptive Title in Italic Title Case
+
+Column Head    Column Head    Column Head
+─────────────────────────────────────────
+Row 1 data     Row 1 data     Row 1 data
+Row 2 data     Row 2 data     Row 2 data
+─────────────────────────────────────────
+
+Note. General note. Specific note for a column or cell.
+a Specific note. b Specific note.
+* p < .05. ** p < .01. *** p < .001.
+```
+
+### Figure Formatting
+```
+Figure 1
+
+Descriptive Title in Italic Title Case
+
+[Figure content]
+
+Note. Description and any necessary explanation.
+Adapted from "Title," by A. Author, Year, Journal, Volume, p. X
+(https://doi.org/xxxxx). Copyright Year by Copyright Holder.
+```
+
+## Numbers and Statistics
+
+### Statistical Notation
+- Italicize statistical symbols: *M*, *SD*, *t*, *F*, *p*, *N*, *n*, *r*, *R²*
+- Report exact *p* values: *p* = .032 (not *p* < .05), unless *p* < .001
+- Effect sizes: always report (Cohen's *d*, η², *r*)
+- Confidence intervals: 95% CI [lower, upper]
+
+### Decimal Places
+| Statistic | Decimal Places |
+|-----------|---------------|
+| Proportions, correlations, inferential statistics | 2 |
+| Percentages | 0 or 1 |
+| Means, SDs | 2 (or match measurement precision) |
+| *p* values | 3 (report exact unless < .001) |
+
+## Bias-Free Language
+
+### Person-First vs. Identity-First
+- Generally prefer person-first: "people with disabilities"
+- Respect community preference: "Deaf community" (capital D)
+
+### Gender
+- Use "they/them" as singular gender-neutral pronoun
+- Avoid "he or she" — use "they"
+- Use specific terms: "women and men" not "males and females" (unless biological sex)
+
+### Age
+- Use specific ranges: "older adults (65+)" not "the elderly"
+
+### Racial/Ethnic Identity
+- Capitalize: Black, White, Indigenous, Asian American
+- Be specific when possible: "Korean American" not "Asian"
+
+## Common Errors Specific to Full Papers
+
+1. **Abstract doesn't match paper** — abstract written first, paper evolves, abstract not updated
+2. **Introduction has a heading** — in APA 7, the introduction doesn't get a "Introduction" heading
+3. **References not in hanging indent** — every reference entry: first line flush, subsequent lines indented
+4. **Et al. period missing** — it's "et al." (with period) because "al." is abbreviated
+5. **Ampersand in text** — use "and" in narrative, "&" only in parenthetical citations and reference list
+6. **Block quote formatting** — ≥40 words: indented, no quotation marks, citation after final period
+7. **Serial comma missing** — APA uses the Oxford comma: "A, B, and C"
+8. **Passive voice overuse** — APA 7 encourages active voice; passive only when actor is unknown

package/vendor/ars/academic-paper/references/changelog.md

@@ -0,0 +1,11 @@
+# Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 2.5 | 2026-03-27 | Style Calibration (intake Step 10: learn author's writing voice from 3+ past papers, produce Style Profile with 6 dimensions, consumed by draft_writer as soft guide with discipline-convention priority). Writing Quality Check (`references/writing_quality_check.md`: 25-term AI high-frequency word warnings, em dash limits, throat-clearing detection, structural pattern warnings, burstiness checks — applied in draft_writer self-review). Style Profile carried through academic-pipeline Material Passport (Schema 10 in `shared/handoff_schemas.md`). deep-research report_compiler also consumes both features optionally |
+| 2.4 | 2026-03-08 | LaTeX output formatting hardening: mandatory `apa7` document class for APA 7.0 output; text justification fix (`ragged2e` + `etoolbox` to override apa7 man mode `\raggedright`); table column width formula (`(\linewidth - N\tabcolsep) * \real{proportion}` — prevents overflow); bilingual abstract centering (`\begin{center}\textbf{...}\end{center}`); font stack standardized (Times New Roman + Source Han Serif TC VF + Courier New); `xurl` for URL line breaking; `fancyvrb` Verbatim with `fontsize` for wide content; PDF must compile from LaTeX via tectonic (no HTML-to-PDF) |
+| 2.3 | 2026-03-08 | NEW visualization_agent (11th: publication-quality figures with matplotlib/ggplot2, APA 7.0, colorblind-safe); NEW revision_coach_agent (12th: standalone reviewer comment parser → Revision Roadmap); Socratic convergence criteria (4 signals: thesis clarity, chapter coherence, evidence mapping, limitation honesty) + question taxonomy (clarifying, probing, structuring, challenging); revision tracking template (4 status types); citation format conversion in formatter_agent (APA 7 ↔ Chicago ↔ MLA ↔ IEEE ↔ Vancouver); Quick Mode Selection Guide; 9th mode: revision-coach |
+| 2.2 | 2026-03-05 | 4-level argument strength scoring with quantified thresholds; plagiarism & retraction screening protocol; F11 Desk-Reject Recovery + F12 Conference-to-Journal Conversion failure paths; Plan -> Full mode conversion protocol; cross-skill reference to `shared/handoff_schemas.md` |
+| 2.1 | 2026-03 | Added CRediT authorship guide, funding statement guide, 2 new templates (credit_statement_template, funding_statement_template); enhanced intake_agent with co-author + funding questions (Step 9-10); enhanced formatter_agent with CRediT + funding quality checks |
+| 2.0 | 2026-02 | NEW plan mode (Socratic guided chapter-by-chapter planning), deep-research handoff protocol, Chinese APA 7.0 citation guide, failure path handling, mode selection guide |
+| 1.0 | 2026-01 | Initial release: 9-agent pipeline, 6 paper types, 5 citation formats, bilingual abstracts, multi-format output |