@alisio/plugin-thesis 0.1.0

package/policy-packs/countries/CO/research-integrity/minciencias-res-0314-2018.yaml

@@ -0,0 +1,64 @@
+# Resolución 0314 de 2018 (Colciencias, now Minciencias) adopts the Política de Ética de la
+# Investigación, Bioética e Integridad Científica. It is a public-policy framework: it creates no
+# article-level duties for students. Rules here are therefore level REGULATION with
+# kind integrity_rule and are used as rationale for integrity checks in every discipline.
+rules:
+  - ruleId: CO.MINCIENCIAS.R0314.2018.SCOPE.01
+    level: REGULATION
+    authority: { organization: Minciencias (formerly Colciencias) }
+    document: { id: RES-0314-2018, version: "2018" }
+    status: active
+    appliesWhen: { country: CO }
+    requirement:
+      kind: integrity_rule
+      values:
+        principle: ethics_and_integrity_apply_to_all_disciplines
+        checks: [plagiarism, citation_quotation, authorship]
+        quote: "Establecer que los procesos de ciencia, tecnología e innovación desarrollados en Colombia se realicen conforme con principios y lineamientos éticos, bioéticos y de integridad científica, en todas las áreas del conocimiento"
+    source:
+      reference: "Resolución 0314 de 2018, art. 1 (adopts the policy); policy text §7.2"
+      url: "https://minciencias.gov.co/sites/default/files/upload/reglamentacion/resolucion_0314-2018.pdf"
+      retrievedAt: "2026-10-04"
+    verification: { lastChecked: "2026-10-04", basis: official_text }
+    supersedes: []
+
+  - ruleId: CO.MINCIENCIAS.R0314.2018.MISCONDUCT.01
+    level: REGULATION
+    authority: { organization: Minciencias (formerly Colciencias) }
+    document: { id: RES-0314-2018, version: "2018" }
+    status: active
+    appliesWhen: { country: CO }
+    requirement:
+      kind: integrity_rule
+      values:
+        principle: avoid_serious_misconduct
+        misconduct: [plagiarism, fraud_fabrication, falsification, data_withholding, undeclared_conflict_of_interest, missing_informed_consent]
+        checks: [plagiarism, conflict_of_interest_declaration, data_retention, consent_evidence]
+        quote: "las faltas consideradas más graves son: (a) el plagio, (b) el fraude, (c) la falsificación, (d) la retención de datos, (e) el conflicto de interés no declarado y (f) la ausencia de consentimiento informado."
+        note: "The policy text presents this list as an international consensus, not as a Colombian prohibition."
+    source:
+      reference: "Política de Ética de la Investigación, Bioética e Integridad Científica, §5.3"
+      url: "https://minciencias.gov.co/sites/default/files/pdf_poltica.pdf"
+      retrievedAt: "2026-10-04"
+    verification: { lastChecked: "2026-10-04", basis: official_text }
+    supersedes: []
+
+  - ruleId: CO.MINCIENCIAS.R0314.2018.MISCONDUCT.02
+    level: REGULATION
+    authority: { organization: Minciencias (formerly Colciencias) }
+    document: { id: RES-0314-2018, version: "2018" }
+    status: active
+    appliesWhen: { country: CO }
+    requirement:
+      kind: integrity_rule
+      values:
+        principle: authorship_and_confidentiality
+        misconduct: [omitted_author, abusive_authorship, confidentiality_breach, experimental_data_not_kept, inadequate_student_supervision]
+        checks: [authorship, data_retention]
+        quote: "(a) la no inclusión de un autor en una publicación, (b) la firma abusiva de un autor, (c) la transgresión de la confidencialidad, (d) la no conservación de datos experimentales, (e) la inadecuada supervisión de estudiantes"
+    source:
+      reference: "Política de Ética de la Investigación, Bioética e Integridad Científica, §5.3"
+      url: "https://minciencias.gov.co/sites/default/files/pdf_poltica.pdf"
+      retrievedAt: "2026-10-04"
+    verification: { lastChecked: "2026-10-04", basis: official_text }
+    supersedes: []

package/policy-packs/global/academic-integrity.yaml

@@ -0,0 +1,45 @@
+# Global academic-integrity rules. Country packs add binding law (e.g. CO copyright and
+# Minciencias integrity policy). ICMJE recommendations target journal manuscripts; they are
+# adopted here as RECOMMENDATION-level defaults for theses.
+rules:
+  - ruleId: GLOBAL.ICMJE.2026.AI.DISCLOSURE.01
+    level: RECOMMENDATION
+    authority: { organization: International Committee of Medical Journal Editors (ICMJE) }
+    document: { id: ICMJE-RECOMMENDATIONS, version: "2026-01" }
+    status: active
+    appliesWhen: { aiUse: assisted }
+    requirement:
+      kind: ai_declaration
+      values:
+        required: true
+        placement:
+          writing_assistance: acknowledgments
+          data_collection_analysis_or_figures: methods
+        content: [tools_used, how_they_were_used]
+        quote: "Authors who use such technology should describe … how they used it. For example, if AI was used for writing assistance, describe this in the acknowledgment section … If AI was used for data collection, analysis, or figure generation, authors should describe this use in the methods"
+    source:
+      reference: "ICMJE Recommendations (updated January 2026), Section II.A.4 Artificial Intelligence (AI)–Assisted Technology"
+      url: "https://www.icmje.org/icmje-recommendations.pdf"
+      retrievedAt: "2026-10-04"
+    verification: { lastChecked: "2026-10-04", basis: official_text }
+    supersedes: []
+
+  - ruleId: GLOBAL.ICMJE.2026.AI.AUTHORSHIP.01
+    level: RECOMMENDATION
+    authority: { organization: International Committee of Medical Journal Editors (ICMJE) }
+    document: { id: ICMJE-RECOMMENDATIONS, version: "2026-01" }
+    status: active
+    appliesWhen: {}
+    requirement:
+      kind: integrity_rule
+      values:
+        principle: ai_is_not_an_author
+        prohibited: [ai_listed_as_author, ai_cited_as_author]
+        humanResponsibility: [review_and_edit_ai_output, no_plagiarism_in_ai_text_or_images, attribute_all_quoted_material]
+        quote: "Authors should not list AI and AI-assisted technologies as an author or co-author, nor cite AI as an author. Authors should be able to assert that there is no plagiarism in their paper, including in text and images produced by the AI."
+    source:
+      reference: "ICMJE Recommendations (updated January 2026), Section II.A.4"
+      url: "https://www.icmje.org/icmje-recommendations.pdf"
+      retrievedAt: "2026-10-04"
+    verification: { lastChecked: "2026-10-04", basis: official_text }
+    supersedes: []

package/policy-packs/global/academic-writing.yaml

@@ -0,0 +1,70 @@
+# Global writing conventions. Writing-guide overrides (level STYLE_GUIDE) come from
+# thesis/policy/writing-*.yaml (spec §11.1).
+rules:
+- ruleId: GLOBAL.WRITING.ABSTRACT.01
+  level: RECOMMENDATION
+  authority:
+    organization: alisio-plugin-thesis (synthesis)
+  document:
+    id: ABSTRACT-CONVENTIONS
+    version: '2026-10-04'
+  status: active
+  appliesWhen: {}
+  requirement:
+    kind: length_limit
+    values:
+      section: abstract
+      maxWords: 250
+      keywords:
+        min: 3
+        max: 5
+      perLanguage: true
+      severity: warning
+      overridable: true
+      observedRange:
+        maxWords:
+        - 240
+        - 500
+        keywordsMax:
+        - 5
+        - 7
+      note: 250 words is the most frequent limit (UdeA, Universidad de Chile doctorate); Udelar allows 300-500 for
+        doctorates; Colef 240; UNAL template 12 lines.
+  source:
+    reference: UdeA trabajos de grado (resumen 'máximo de 250 palabras'); Universidad de Chile Doctorado Ciencias
+      Silvoagropecuarias ('no más de 250 palabras … Palabras clave (3 a 5 palabras)'); Udelar ('entre tres y cinco
+      palabras clave')
+    url: https://uchile.cl/postgrados/doctorados/programas-interfacultades/doctorado-ciencias-silvoagropecuarias-y-veterinarias/formacion-e-investigacion/trabajo-de-tesis
+    retrievedAt: '2026-10-04'
+  verification:
+    lastChecked: '2026-10-04'
+    basis: secondary_source
+  supersedes: []
+- ruleId: GLOBAL.WRITING.PERSONAL_COMMUNICATION.01
+  level: RECOMMENDATION
+  authority:
+    organization: International Committee of Medical Journal Editors (ICMJE)
+  document:
+    id: ICMJE-RECOMMENDATIONS
+    version: 2026-01
+  status: active
+  appliesWhen: {}
+  requirement:
+    kind: source_quality
+    values:
+      rule: personal_communication_only_if_essential
+      inText:
+      - name
+      - date
+      inReferenceList: false
+      quote: Avoid citing a “personal communication” unless it provides essential information not available from
+        a public source, in which case the name of the person and date of communication should be cited in parentheses
+        in the text.
+  source:
+    reference: ICMJE Recommendations (updated January 2026), Section IV.A.3.g.i
+    url: https://www.icmje.org/icmje-recommendations.pdf
+    retrievedAt: '2026-10-04'
+  verification:
+    lastChecked: '2026-10-04'
+    basis: official_text
+  supersedes: []

package/policy-packs/global/evidence-quality.yaml

@@ -0,0 +1,81 @@
+# Global evidence-quality rules (feed research/verify.ts and the CIT/EVD checks, spec §8.4, §9.2).
+rules:
+  - ruleId: GLOBAL.ICMJE.2026.EVIDENCE.RETRACTED.01
+    level: RECOMMENDATION
+    authority: { organization: International Committee of Medical Journal Editors (ICMJE) }
+    document: { id: ICMJE-RECOMMENDATIONS, version: "2026-01" }
+    status: active
+    appliesWhen: {}
+    requirement:
+      kind: source_quality
+      values:
+        rule: no_retracted_references
+        exceptWhen: referring_to_the_retraction
+        quote: "Authors are responsible for checking that none of the references cite retracted articles except in the context of referring to the retraction."
+    source:
+      reference: "ICMJE Recommendations (updated January 2026), Section IV.A.3.g.i References — General Considerations"
+      url: "https://www.icmje.org/icmje-recommendations.pdf"
+      retrievedAt: "2026-10-04"
+    verification: { lastChecked: "2026-10-04", basis: official_text }
+    supersedes: []
+
+  - ruleId: GLOBAL.ICMJE.2026.EVIDENCE.VERIFY.01
+    level: RECOMMENDATION
+    authority: { organization: International Committee of Medical Journal Editors (ICMJE) }
+    document: { id: ICMJE-RECOMMENDATIONS, version: "2026-01" }
+    status: active
+    appliesWhen: {}
+    requirement:
+      kind: source_quality
+      values:
+        rule: verify_references_against_bibliographic_or_original_source
+        claimSupport: reference_must_support_associated_statement
+        quote: "Authors are responsible for citing references accurately and should be able to attest that the references cited support the associated statement. To minimize bibliographic citation errors, references should be verified using either a bibliographic source, such as PubMed, or original sources."
+    source:
+      reference: "ICMJE Recommendations (updated January 2026), Section IV.A.3.g.i"
+      url: "https://www.icmje.org/icmje-recommendations.pdf"
+      retrievedAt: "2026-10-04"
+    verification: { lastChecked: "2026-10-04", basis: official_text }
+    supersedes: []
+
+  - ruleId: GLOBAL.ICMJE.2026.EVIDENCE.PREFERENCES.01
+    level: RECOMMENDATION
+    authority: { organization: International Committee of Medical Journal Editors (ICMJE) }
+    document: { id: ICMJE-RECOMMENDATIONS, version: "2026-01" }
+    status: active
+    appliesWhen: {}
+    requirement:
+      kind: source_quality
+      values:
+        prefer: [original_research_over_reviews_when_possible, published_articles_over_abstracts]
+        avoid: [predatory_or_pseudo_journals, personal_communications_unless_essential]
+        label: { preprint: must_be_identified_as_preprint, accepted_unpublished: "in press" }
+        notAcceptableAsPrimarySource: [ai_generated_material]
+        datasets: cite_persistent_identifier
+        quote: "Authors should provide direct references to original research sources whenever possible. References should be made to published articles rather than to abstracts whenever possible. … Authors should avoid citing articles from predatory or pseudo-journals. When preprints are cited, the citation should clearly indicate that the reference is a preprint … Referencing AI-generated material as the primary source is not acceptable."
+    source:
+      reference: "ICMJE Recommendations (updated January 2026), Section IV.A.3.g.i"
+      url: "https://www.icmje.org/icmje-recommendations.pdf"
+      retrievedAt: "2026-10-04"
+    verification: { lastChecked: "2026-10-04", basis: official_text }
+    supersedes: []
+
+  - ruleId: GLOBAL.EVIDENCE.RECENCY.01
+    level: RECOMMENDATION
+    authority: { organization: "Arias, F. G. (2017), e-Ciencias de la Información 7(1)" }
+    document: { id: ARIAS-2017-OBSOLESCENCIA, version: "2017" }
+    status: active
+    appliesWhen: {}
+    requirement:
+      kind: source_quality
+      values:
+        rule: no_default_recency_quota
+        severity: info
+        note: "No thesis regulation found that requires a share of references from the last N years; quotas exist only in individual journals' author instructions. Institutions may add one as an override."
+        quote: "El Índice de Price no es una regla que establece 5 años de vigencia de la literatura científica … no debe ser asumido como una norma para elaborar proyectos e informes de investigación, tesis o trabajos de grado."
+    source:
+      reference: "Arias, F. G. (2017). Obsolescencia de las referencias citadas: un mito académico persistente en la investigación universitaria venezolana. e-Ciencias de la Información 7(1). DOI 10.15517/eci.v7i1.26075"
+      url: "https://www.scielo.sa.cr/pdf/eci/v7n1/1659-4142-eci-7-01-00078.pdf"
+      retrievedAt: "2026-10-04"
+    verification: { lastChecked: "2026-10-04", basis: official_text }
+    supersedes: []

package/policy-packs/global/manifest.yaml

@@ -0,0 +1,54 @@
+# Global policy pack manifest. Manifest format: spec §11.1.1.
+packId: global
+scope: global
+version: "2026.10.04"
+lastChecked: "2026-10-04"
+files:
+  - academic-integrity.yaml
+  - evidence-quality.yaml
+  - academic-writing.yaml
+  - reporting-guidelines.yaml
+  - work-types.yaml
+  - objective-verbs.yaml
+defaults:
+  citationStyle: apa-7          # spec §11.3 fallback when no rule sets one; user confirms in round 2
+  presentationStandard: generic
+requirementKinds:               # closed vocabulary, documented in P0.6-results.md §5
+  - institutional_authority
+  - paper
+  - page_margins
+  - font
+  - line_spacing
+  - text_alignment
+  - pagination
+  - front_matter_order
+  - required_section
+  - heading_format
+  - caption_position
+  - citation_style
+  - reference_format
+  - length_limit
+  - ethics_trigger
+  - risk_classification
+  - consent_requirement
+  - data_protection
+  - quotation_rule
+  - attribution_rule
+  - integrity_rule
+  - ai_declaration
+  - source_quality
+  - evidence_minimum
+  - reporting_guideline
+  - objective_verbs
+  - official_domain_allowlist
+appliesWhenKeys:                # all keys must match (AND); a list value means any-of
+  - country
+  - language
+  - workType
+  - approach
+  - studyDesign                 # proposed brief field
+  - domain                      # brief.domain.primary (or any secondary)
+  - presentationStandard
+  - citationStyle
+  - ethicsTrigger               # questionnaire answer = yes
+  - aiUse                       # assisted when brief.aiUse.assisted is true

package/policy-packs/global/objective-verbs.yaml

@@ -0,0 +1,245 @@
+# Objective verbs per language (check DSN-002, spec §9.2). Bloom's taxonomy describes learning
+# objectives; its use for research objectives is a methodology-teaching convention, so the check
+# warns and never blocks.
+rules:
+- ruleId: GLOBAL.OBJECTIVES.VERBS.ES
+  level: METHODOLOGY_GUIDELINE
+  authority:
+    organization: Universidad Central de Venezuela (Vitae); Universidad de los Andes (LEO)
+  document:
+    id: OBJECTIVE-VERBS-ES
+    version: '2016'
+  status: active
+  appliesWhen:
+    language: es
+  requirement:
+    kind: objective_verbs
+    values:
+      appliesTo: specific_objectives
+      form: infinitive
+      maxVerbsPerObjective: 1
+      severity: warning
+      avoid:
+      - conocer
+      - saber
+      - estudiar
+      ambiguous:
+      - comprender
+      - entender
+      - explicitar
+      qualitativeDowngrade:
+        verbs:
+        - comprender
+        - entender
+        severity: info
+      recommendedByLevel:
+        recordar:
+        - definir
+        - listar
+        - nombrar
+        - recordar
+        - rotular
+        comprender:
+        - clasificar
+        - comparar
+        - contrastar
+        - explicar
+        - expresar
+        - identificar
+        - interpretar
+        - traducir
+        aplicar:
+        - aplicar
+        - calcular
+        - construir
+        - demostrar
+        - desarrollar
+        - experimentar
+        - resolver
+        - utilizar
+        analizar:
+        - analizar
+        - categorizar
+        - distinguir
+        - examinar
+        - inferir
+        - asociar
+        evaluar:
+        - evaluar
+        - juzgar
+        - criticar
+        - justificar
+        - medir
+        - probar
+        - argumentar
+        crear:
+        - combinar
+        - componer
+        - crear
+        - diseñar
+        - establecer
+        - formular
+        - implementar
+      quote: 'se deben evitar verbos genéricos como: conocer, saber, estudiar; o que resulten de poca claridad como:
+        comprender, explicar, explicitar, los cuales podrían ser usados según el modelo epistemológico adoptado.'
+  source:
+    reference: Cardozo, Romano, Ortunio, Guevara & Romano (2016). Elaboración de los objetivos en la investigación.
+      Vitae (UCV) 65; verb groups also from Uniandes LEO '¿Cómo plantear objetivos?'
+    url: https://vitae.ucv.ve/index_pdf.php?module=articulo_pdf&n=5300&rv=122
+    retrievedAt: '2026-10-04'
+  verification:
+    lastChecked: '2026-10-04'
+    basis: secondary_source
+  supersedes: []
+- ruleId: GLOBAL.OBJECTIVES.VERBS.EN
+  level: METHODOLOGY_GUIDELINE
+  authority:
+    organization: Cornell CTI; UConn CETL; Caltech CTLO; CSUN; USGS
+  document:
+    id: OBJECTIVE-VERBS-EN
+    version: '2026-10-04'
+  status: active
+  appliesWhen:
+    language: en
+  requirement:
+    kind: objective_verbs
+    values:
+      appliesTo: specific_objectives
+      form: base_verb
+      maxVerbsPerObjective: 1
+      severity: warning
+      avoid:
+      - understand
+      - know
+      - learn
+      - appreciate
+      - comprehend
+      - realize
+      - be aware of
+      - become aware of
+      - be familiar with
+      - become familiar with
+      qualitativeDowngrade:
+        verbs:
+        - understand
+        severity: info
+      recommendedByLevel:
+        remember:
+        - recognize
+        - recall
+        - identify
+        - list
+        - define
+        understand:
+        - interpret
+        - exemplify
+        - classify
+        - summarize
+        - infer
+        - compare
+        - explain
+        - describe
+        apply:
+        - execute
+        - implement
+        analyze:
+        - differentiate
+        - organize
+        - attribute
+        - analyze
+        evaluate:
+        - check
+        - critique
+        create:
+        - generate
+        - plan
+        - produce
+      quote: 'Avoid verbs that are unclear and cannot be observed and measured easily, for example: appreciate,
+        become aware of, become familiar with, know, learn, and understand.'
+  source:
+    reference: 'Anderson & Krathwohl (2001) cognitive processes via Iowa State CELT handout; avoid list: Cornell,
+      UConn, Caltech, CSUN, USGS (each verb in at least two)'
+    url: https://teaching.cornell.edu/setting-learning-outcomes
+    retrievedAt: '2026-10-04'
+  verification:
+    lastChecked: '2026-10-04'
+    basis: secondary_source
+  supersedes: []
+- ruleId: GLOBAL.OBJECTIVES.VERBS.PT
+  level: METHODOLOGY_GUIDELINE
+  authority:
+    organization: UNIPAMPA; UECE
+  document:
+    id: OBJECTIVE-VERBS-PT
+    version: '2026-10-04'
+  status: active
+  appliesWhen:
+    language: pt
+  requirement:
+    kind: objective_verbs
+    values:
+      appliesTo: specific_objectives
+      form: infinitive
+      maxVerbsPerObjective: 1
+      severity: warning
+      avoid:
+      - conhecer
+      - compreender
+      - entender
+      - apreciar
+      - aprender
+      qualitativeDowngrade:
+        verbs:
+        - compreender
+        - entender
+        severity: info
+      recommendedByLevel:
+        lembrar:
+        - apontar
+        - definir
+        - nomear
+        - registrar
+        - relatar
+        entender:
+        - descrever
+        - discutir
+        - esclarecer
+        - explicar
+        - expressar
+        - identificar
+        - localizar
+        - traduzir
+        aplicar:
+        - aplicar
+        - demonstrar
+        - empregar
+        - ilustrar
+        - interpretar
+        - usar
+        analisar:
+        - analisar
+        - classificar
+        - comparar
+        - distinguir
+        - investigar
+        avaliar:
+        - avaliar
+        - escolher
+        - julgar
+        - selecionar
+        - validar
+        criar:
+        - articular
+        - compor
+        - constituir
+        - esquematizar
+      quote: Na formulação de objetivos específicos devemos evitar o emprego de verbos que se prestem a muitas interpretações.
+  source:
+    reference: UNIPAMPA 'Verbos de objetivos' (Pelegrini, citing Silva & Menezes 2001); UECE PPCCLIS 'Verbos para
+      a elaboração dos objetivos'; level names per Ferraz & Belhot (2010)
+    url: https://www.uece.br/ppcclis/wp-content/uploads/sites/91/2021/09/verbos_para_trabalhos_academicos.pdf
+    retrievedAt: '2026-10-04'
+  verification:
+    lastChecked: '2026-10-04'
+    basis: secondary_source
+  supersedes: []