frontmattering 0.4.2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (224) hide show
  1. frontmattering/FRONTMATTER_INDEX_PROVENANCE.json +13 -0
  2. frontmattering/__init__.py +1 -0
  3. frontmattering/__main__.py +1263 -0
  4. frontmattering/ai_instruction_risk.py +51 -0
  5. frontmattering/authoring.py +320 -0
  6. frontmattering/body_tether.py +176 -0
  7. frontmattering/common/__init__.py +3 -0
  8. frontmattering/common/errors.py +1074 -0
  9. frontmattering/core.py +147 -0
  10. frontmattering/corpus_selection.py +436 -0
  11. frontmattering/frontmatter_index.py +340 -0
  12. frontmattering/harness_errors.py +555 -0
  13. frontmattering/inventory.py +83 -0
  14. frontmattering/markdown/MARKDOWN_PARSE_RESULT_schema.json +870 -0
  15. frontmattering/markdown/MARKDOWN_PROVENANCE.json +8 -0
  16. frontmattering/markdown/USER_MANUAL.md +263 -0
  17. frontmattering/markdown/__init__.py +0 -0
  18. frontmattering/markdown/api.py +553 -0
  19. frontmattering/markdown/cli/__init__.py +1 -0
  20. frontmattering/markdown/cli/__main__.py +10 -0
  21. frontmattering/markdown/cli/dump_sections.py +100 -0
  22. frontmattering/markdown/collectors_phase8/__init__.py +15 -0
  23. frontmattering/markdown/collectors_phase8/blockquotes.py +117 -0
  24. frontmattering/markdown/collectors_phase8/codeblocks.py +46 -0
  25. frontmattering/markdown/collectors_phase8/footnotes.py +152 -0
  26. frontmattering/markdown/collectors_phase8/frontmatter.py +80 -0
  27. frontmattering/markdown/collectors_phase8/headings.py +85 -0
  28. frontmattering/markdown/collectors_phase8/html.py +29 -0
  29. frontmattering/markdown/collectors_phase8/html_collector.py +89 -0
  30. frontmattering/markdown/collectors_phase8/images.py +68 -0
  31. frontmattering/markdown/collectors_phase8/inline_code.py +61 -0
  32. frontmattering/markdown/collectors_phase8/links.py +104 -0
  33. frontmattering/markdown/collectors_phase8/lists.py +66 -0
  34. frontmattering/markdown/collectors_phase8/math.py +28 -0
  35. frontmattering/markdown/collectors_phase8/paragraphs.py +41 -0
  36. frontmattering/markdown/collectors_phase8/tables.py +65 -0
  37. frontmattering/markdown/collectors_phase8/tasklists.py +59 -0
  38. frontmattering/markdown/fetchers/__init__.py +8 -0
  39. frontmattering/markdown/fetchers/preview.py +123 -0
  40. frontmattering/markdown/fetchers/url_fetcher.py +123 -0
  41. frontmattering/markdown/security/__init__.py +6 -0
  42. frontmattering/markdown/security/scanner.py +436 -0
  43. frontmattering/markdown/utils/__init__.py +0 -0
  44. frontmattering/markdown/utils/profiling.py +137 -0
  45. frontmattering/markdown/utils/section.py +98 -0
  46. frontmattering/markdown/utils/text_normalization.py +91 -0
  47. frontmattering/markdown/utils/timeout.py +165 -0
  48. frontmattering/markdown/utils/token_warehouse.py +1300 -0
  49. frontmattering/markdown/utils/url_utils.py +179 -0
  50. frontmattering/promotion.py +170 -0
  51. frontmattering/resources/AI_INDEX.json +691 -0
  52. frontmattering/resources/AI_START_HERE.md +378 -0
  53. frontmattering/resources/DAILY_USE_GUIDE.md +87 -0
  54. frontmattering/resources/FRONTMATTERING_FRONTMATTER_SPEC_v0_1_5.md +3203 -0
  55. frontmattering/resources/KERNEL_ACCEPTANCE_REPORT.md +180 -0
  56. frontmattering/resources/__init__.py +0 -0
  57. frontmattering/resources/examples/no_frontmatter_demo/00_AI_START_HERE.md +43 -0
  58. frontmattering/resources/examples/no_frontmatter_demo/10_NORMATIVE_SPEC.md +28 -0
  59. frontmattering/resources/examples/no_frontmatter_demo/20_IMPLEMENTATION_CONTRACT.md +33 -0
  60. frontmattering/resources/examples/no_frontmatter_demo/30_TEST_SUFFICIENCY.md +34 -0
  61. frontmattering/resources/examples/no_frontmatter_demo/40_EVIDENCE_RECORD.md +33 -0
  62. frontmattering/resources/examples/no_frontmatter_demo/50_RELEASE_DECISION.md +29 -0
  63. frontmattering/resources/examples/power_demo/00_AI_START_HERE.md +142 -0
  64. frontmattering/resources/examples/power_demo/10_NORMATIVE_SPEC.md +117 -0
  65. frontmattering/resources/examples/power_demo/20_IMPLEMENTATION_CONTRACT.md +130 -0
  66. frontmattering/resources/examples/power_demo/30_TEST_SUFFICIENCY.md +132 -0
  67. frontmattering/resources/examples/power_demo/40_EVIDENCE_RECORD.md +128 -0
  68. frontmattering/resources/examples/power_demo/50_RELEASE_DECISION.md +124 -0
  69. frontmattering/resources/fixtures/invalid/adoption_digest_mismatch_rejected/doc.md +80 -0
  70. frontmattering/resources/fixtures/invalid/adoption_record_on_wrong_role_rejected/doc.md +59 -0
  71. frontmattering/resources/fixtures/invalid/adoption_record_shape_rejected/doc.md +58 -0
  72. frontmattering/resources/fixtures/invalid/adoption_without_bootstrap_receipt_rejected/doc.md +78 -0
  73. frontmattering/resources/fixtures/invalid/authored_go_used_as_evidence_rejected/doc.md +57 -0
  74. frontmattering/resources/fixtures/invalid/body_tether_body_digest_mismatch_rejected/doc.md +65 -0
  75. frontmattering/resources/fixtures/invalid/body_tether_fields_mismatch_rejected/doc.md +63 -0
  76. frontmattering/resources/fixtures/invalid/body_tether_malformed_rejected/doc.md +58 -0
  77. frontmattering/resources/fixtures/invalid/body_tether_missing_under_trust_rejected/.frontmattering/project.yaml +11 -0
  78. frontmattering/resources/fixtures/invalid/body_tether_missing_under_trust_rejected/doc.md +57 -0
  79. frontmattering/resources/fixtures/invalid/body_tether_scope_selector_rejected/doc.md +68 -0
  80. frontmattering/resources/fixtures/invalid/body_tether_unknown_canonicalization_rejected/doc.md +63 -0
  81. frontmattering/resources/fixtures/invalid/bootstrap_receipt_shape_rejected/doc.md +80 -0
  82. frontmattering/resources/fixtures/invalid/bootstrap_without_validator_blocks_adoption/doc.md +71 -0
  83. frontmattering/resources/fixtures/invalid/claim_boundary_missing_does_not_verify_rejected/doc.md +55 -0
  84. frontmattering/resources/fixtures/invalid/claimed_state_overreach_rejected/doc.md +57 -0
  85. frontmattering/resources/fixtures/invalid/clause_enforcement_drift_rejected/doc.md +59 -0
  86. frontmattering/resources/fixtures/invalid/container_cardinality_rejected/doc.md +57 -0
  87. frontmattering/resources/fixtures/invalid/deepest_intention_missing_rejected/doc.md +56 -0
  88. frontmattering/resources/fixtures/invalid/downstream_phase_without_upstream_evidence_rejected/doc.md +59 -0
  89. frontmattering/resources/fixtures/invalid/duplicate_document_id_rejected/a.md +57 -0
  90. frontmattering/resources/fixtures/invalid/duplicate_document_id_rejected/b.md +57 -0
  91. frontmattering/resources/fixtures/invalid/duplicate_yaml_key_rejected/doc.md +58 -0
  92. frontmattering/resources/fixtures/invalid/evidence_edge_digest_missing_rejected/doc.md +65 -0
  93. frontmattering/resources/fixtures/invalid/evidence_reference_used_as_truth_rejected/doc.md +66 -0
  94. frontmattering/resources/fixtures/invalid/external_edge_locator_missing_rejected/doc.md +64 -0
  95. frontmattering/resources/fixtures/invalid/external_edge_set_id_missing_rejected/doc.md +64 -0
  96. frontmattering/resources/fixtures/invalid/extracted_catalog_drift_rejected/doc.md +60 -0
  97. frontmattering/resources/fixtures/invalid/fixture_reverse_reachability_drift_rejected/doc.md +59 -0
  98. frontmattering/resources/fixtures/invalid/frontmatter_only_view_incomplete_rejected/doc.md +59 -0
  99. frontmattering/resources/fixtures/invalid/frontmatter_registry_conflict_blocks/doc.md +59 -0
  100. frontmattering/resources/fixtures/invalid/frontmatter_view_body_truth_overclaim_rejected/doc.md +59 -0
  101. frontmattering/resources/fixtures/invalid/generated_state_in_frontmatter_rejected/doc.md +58 -0
  102. frontmattering/resources/fixtures/invalid/green_checks_conflation_rejected/doc.md +76 -0
  103. frontmattering/resources/fixtures/invalid/historical_digest_used_as_current_evidence_rejected/doc.md +66 -0
  104. frontmattering/resources/fixtures/invalid/implementation_start_gate_bypass_rejected/doc.md +59 -0
  105. frontmattering/resources/fixtures/invalid/intention_positive_negative_conflation_rejected/doc.md +76 -0
  106. frontmattering/resources/fixtures/invalid/legacy_string_machine_surface_requires_mapping/doc.md +59 -0
  107. frontmattering/resources/fixtures/invalid/load_order_inversion_flagged/a.md +63 -0
  108. frontmattering/resources/fixtures/invalid/load_order_inversion_flagged/b.md +57 -0
  109. frontmattering/resources/fixtures/invalid/machine_surface_identity_incomplete_rejected/doc.md +62 -0
  110. frontmattering/resources/fixtures/invalid/migration_field_drop_rejected/doc.md +60 -0
  111. frontmattering/resources/fixtures/invalid/migration_silent_coercion_rejected/doc.md +59 -0
  112. frontmattering/resources/fixtures/invalid/missing_frontmatter_rejected/doc.md +1 -0
  113. frontmattering/resources/fixtures/invalid/non_root_exception_or_silent_fallback_rejected/doc.md +59 -0
  114. frontmattering/resources/fixtures/invalid/nonowner_redefines_intention_rejected/doc.md +58 -0
  115. frontmattering/resources/fixtures/invalid/output_format_conflation_rejected/doc.md +76 -0
  116. frontmattering/resources/fixtures/invalid/parser_byte_ranges_missing_rejected/doc.md +59 -0
  117. frontmattering/resources/fixtures/invalid/parser_partial_model_on_error_rejected/doc.md +59 -0
  118. frontmattering/resources/fixtures/invalid/parser_source_locator_missing_rejected/doc.md +59 -0
  119. frontmattering/resources/fixtures/invalid/projected_field_without_origin_rejected/doc.md +59 -0
  120. frontmattering/resources/fixtures/invalid/projection_rebuild_nondeterminism_rejected/doc.md +59 -0
  121. frontmattering/resources/fixtures/invalid/projection_row_without_source_locator_rejected/doc.md +59 -0
  122. frontmattering/resources/fixtures/invalid/relationship_resolution_scope_missing_rejected/doc.md +62 -0
  123. frontmattering/resources/fixtures/invalid/relationship_resolution_scope_unknown_rejected/doc.md +63 -0
  124. frontmattering/resources/fixtures/invalid/relationship_semantics_rejected/doc.md +63 -0
  125. frontmattering/resources/fixtures/invalid/relationship_target_unresolved_rejected/doc.md +63 -0
  126. frontmattering/resources/fixtures/invalid/release_surface_digest_missing_rejected/doc.md +63 -0
  127. frontmattering/resources/fixtures/invalid/required_dependency_cycle_rejected/a.md +63 -0
  128. frontmattering/resources/fixtures/invalid/required_dependency_cycle_rejected/b.md +63 -0
  129. frontmattering/resources/fixtures/invalid/routing_tag_not_in_task_catalog_rejected/doc.md +59 -0
  130. frontmattering/resources/fixtures/invalid/routing_tag_router_not_in_scope_rejected/doc.md +55 -0
  131. frontmattering/resources/fixtures/invalid/scope_on_nonsupersedes_rejected/doc.md +65 -0
  132. frontmattering/resources/fixtures/invalid/stale_bootstrap_receipt_rejected/doc.md +80 -0
  133. frontmattering/resources/fixtures/invalid/stale_validation_result_rejected/doc.md +60 -0
  134. frontmattering/resources/fixtures/invalid/supersedes_without_scope_rejected/doc.md +63 -0
  135. frontmattering/resources/fixtures/invalid/target_section_not_found_rejected/a.md +65 -0
  136. frontmattering/resources/fixtures/invalid/target_section_not_found_rejected/b.md +57 -0
  137. frontmattering/resources/fixtures/invalid/target_sections_on_external_edge_rejected/doc.md +67 -0
  138. frontmattering/resources/fixtures/invalid/task_scoped_defects_filtering/router.md +59 -0
  139. frontmattering/resources/fixtures/invalid/task_scoped_defects_filtering/selected.md +56 -0
  140. frontmattering/resources/fixtures/invalid/task_scoped_defects_filtering/skipped.md +56 -0
  141. frontmattering/resources/fixtures/invalid/template_claims_normative_authority_rejected/doc.md +57 -0
  142. frontmattering/resources/fixtures/invalid/two_documents_own_same_intention_rejected/a.md +76 -0
  143. frontmattering/resources/fixtures/invalid/two_documents_own_same_intention_rejected/b.md +76 -0
  144. frontmattering/resources/fixtures/invalid/undefined_conditional_token_rejected/doc.md +59 -0
  145. frontmattering/resources/fixtures/invalid/undefined_type_rejected/doc.md +59 -0
  146. frontmattering/resources/fixtures/invalid/unknown_authority_rejected/doc.md +57 -0
  147. frontmattering/resources/fixtures/invalid/unknown_document_role_rejected/doc.md +57 -0
  148. frontmattering/resources/fixtures/invalid/unknown_field_rejected/doc.md +58 -0
  149. frontmattering/resources/fixtures/invalid/unknown_root_block_rejected/doc.md +59 -0
  150. frontmattering/resources/fixtures/invalid/unresolved_reference_on_required_edge_rejected/doc.md +63 -0
  151. frontmattering/resources/fixtures/invalid/unsupported_schema_version_rejected/doc.md +57 -0
  152. frontmattering/resources/fixtures/invalid/untemplated_frontmatter_bypass_rejected/doc.md +59 -0
  153. frontmattering/resources/fixtures/invalid/validator_passes_conflation_rejected/doc.md +76 -0
  154. frontmattering/resources/fixtures/invalid/yaml_1_1_boolean_words_not_coerced/doc.md +57 -0
  155. frontmattering/resources/fixtures/pilot_security/blockquote.md +3 -0
  156. frontmattering/resources/fixtures/pilot_security/code_fence.md +5 -0
  157. frontmattering/resources/fixtures/pilot_security/dangerous_html.md +3 -0
  158. frontmattering/resources/fixtures/pilot_security/dangerous_uri.md +3 -0
  159. frontmattering/resources/fixtures/pilot_security/direct_instruction.md +3 -0
  160. frontmattering/resources/fixtures/pilot_security/generated_resource_limits.yaml +16 -0
  161. frontmattering/resources/fixtures/pilot_security/indirect_instruction.md +4 -0
  162. frontmattering/resources/fixtures/pilot_security/legitimate_security_discussion.md +3 -0
  163. frontmattering/resources/fixtures/pilot_security/link.md +3 -0
  164. frontmattering/resources/fixtures/pilot_security/table.md +5 -0
  165. frontmattering/resources/fixtures/valid/adoption_locator_trigger_word_is_data_valid/doc.md +80 -0
  166. frontmattering/resources/fixtures/valid/body_tether_fresh_valid/doc.md +63 -0
  167. frontmattering/resources/fixtures/valid/bootstrap_validation_receipt_valid/doc.md +66 -0
  168. frontmattering/resources/fixtures/valid/claim_prose_substrings_are_not_verdicts_valid/doc.md +57 -0
  169. frontmattering/resources/fixtures/valid/companion_and_appendix_edges_valid/a.md +69 -0
  170. frontmattering/resources/fixtures/valid/companion_and_appendix_edges_valid/b.md +57 -0
  171. frontmattering/resources/fixtures/valid/document_binding_to_external_intention_valid/doc.md +57 -0
  172. frontmattering/resources/fixtures/valid/document_realizing_external_intention_valid/doc.md +57 -0
  173. frontmattering/resources/fixtures/valid/document_referencing_external_intention_valid/doc.md +57 -0
  174. frontmattering/resources/fixtures/valid/evidence_record_valid/doc.md +57 -0
  175. frontmattering/resources/fixtures/valid/evidence_support_substrings_are_not_proof_valid/doc.md +66 -0
  176. frontmattering/resources/fixtures/valid/external_document_set_edge_valid/doc.md +65 -0
  177. frontmattering/resources/fixtures/valid/frontmatter_adoption_record_valid/doc.md +80 -0
  178. frontmattering/resources/fixtures/valid/frontmatter_projection_mapping_valid/doc.md +57 -0
  179. frontmattering/resources/fixtures/valid/frontmatter_spec_bootstrap_valid/doc.md +76 -0
  180. frontmattering/resources/fixtures/valid/implementation_contract_valid/doc.md +57 -0
  181. frontmattering/resources/fixtures/valid/normative_spec_valid/doc.md +57 -0
  182. frontmattering/resources/fixtures/valid/orientation_router_valid/doc.md +59 -0
  183. frontmattering/resources/fixtures/valid/release_metadata_valid/doc.md +57 -0
  184. frontmattering/resources/fixtures/valid/target_sections_resolved_valid/a.md +65 -0
  185. frontmattering/resources/fixtures/valid/target_sections_resolved_valid/b.md +57 -0
  186. frontmattering/resources/fixtures/valid/template_valid/doc.md +57 -0
  187. frontmattering/resources/fixtures/valid/unresolved_reference_optional_edge_valid/doc.md +63 -0
  188. frontmattering/resources/fixtures/valid/untemplated_document_valid/doc.md +57 -0
  189. frontmattering/resources/fixtures/valid/yaml_1_2_plain_words_valid/doc.md +60 -0
  190. frontmattering/resources/generated/FRONTMATTERING_FRONTMATTER_SCHEMA.schema.json +2422 -0
  191. frontmattering/resources/tools/__init__.py +0 -0
  192. frontmattering/resources/tools/check_frontmatter_sqlite_index.py +40 -0
  193. frontmattering/resources/tools/check_kernel_cleanliness.py +103 -0
  194. frontmattering/resources/tools/check_kernel_exception_taxonomy.py +145 -0
  195. frontmattering/resources/tools/check_markdown_parser_adoption.py +35 -0
  196. frontmattering/resources/tools/check_pilot_readiness.py +545 -0
  197. frontmattering/resources/tools/check_projection_consistency.py +35 -0
  198. frontmattering/resources/tools/check_python_syntax.py +29 -0
  199. frontmattering/resources/tools/check_report_quality.py +478 -0
  200. frontmattering/resources/tools/distribution_receipt.py +54 -0
  201. frontmattering/resources/tools/finding_registry.py +625 -0
  202. frontmattering/resources/tools/frontmattering_cli.py +18 -0
  203. frontmattering/resources/tools/generate_ai_index.py +123 -0
  204. frontmattering/resources/tools/generate_frontmatter_schema.py +70 -0
  205. frontmattering/resources/tools/kernel_reporting.py +1495 -0
  206. frontmattering/resources/tools/make_fixtures.py +507 -0
  207. frontmattering/resources/tools/pack_kernel_distro.py +430 -0
  208. frontmattering/resources/tools/test_verify_kernel.py +177 -0
  209. frontmattering/resources/tools/validate_frontmatters.py +100 -0
  210. frontmattering/resources/tools/verify_kernel.py +197 -0
  211. frontmattering/resources/workflow-docs-manifest.yaml +199 -0
  212. frontmattering/schema_projection.py +288 -0
  213. frontmattering/speccompile.py +81 -0
  214. frontmattering/validator.py +957 -0
  215. frontmattering-0.4.2.dist-info/METADATA +91 -0
  216. frontmattering-0.4.2.dist-info/RECORD +224 -0
  217. frontmattering-0.4.2.dist-info/WHEEL +5 -0
  218. frontmattering-0.4.2.dist-info/entry_points.txt +2 -0
  219. frontmattering-0.4.2.dist-info/licenses/COMMERCIAL_LICENSE_REQUIRED.md +14 -0
  220. frontmattering-0.4.2.dist-info/licenses/LICENSE.md +39 -0
  221. frontmattering-0.4.2.dist-info/licenses/NOTICE +10 -0
  222. frontmattering-0.4.2.dist-info/licenses/THIRD_PARTY_NOTICES.md +12 -0
  223. frontmattering-0.4.2.dist-info/licenses/TRADEMARKS.md +7 -0
  224. frontmattering-0.4.2.dist-info/top_level.txt +1 -0
frontmattering/resources/fixtures/valid/yaml_1_2_plain_words_valid/doc.md ADDED
@@ -0,0 +1,60 @@
1
+ ---
2
+ ai_document_contract:
3
+ schema_version: frontmattering_frontmatter/v0_1_5
4
+ document_id: FRONTMATTERING-FIX-Y12
5
+ document_set_id: FRONTMATTERING-FIX-SET
6
+ document_version: 1.0.0
7
+ document_set_version: 1.0.0
8
+ document_title: Fixture document FRONTMATTERING-FIX-Y12
9
+ document_kind: implementation_contract
10
+ document_role: implementation_contract
11
+ lifecycle_state: candidate
12
+ audience:
13
+ primary: ai_assistant_only
14
+ human_reader_role: maintainer
15
+ human_readability_priority: low
16
+ authority: binding_when_explicitly_invoked
17
+ primary_action_expected: Exercise one bounded conformance predicate.
18
+ body_binding:
19
+ body_required_sections: []
20
+ clause_index_required: false
21
+ clause_prefixes:
22
+ - FRONTMATTERING-FIXC
23
+ must_not_be_used_for:
24
+ - Claiming anything beyond fixture service.
25
+ routing:
26
+ agent_summary: Fixture exercising one conformance predicate.
27
+ read_when:
28
+ - Running the kernel acceptance suite.
29
+ - on
30
+ - no
31
+ - yes
32
+ read_when_tags:
33
+ - validator_implementation
34
+ skip_when:
35
+ - Any production task.
36
+ skip_when_tags:
37
+ - unrelated_document_set
38
+ load_order: 10
39
+ deepest_intention:
40
+ intention_id: FRONTMATTERING-DI-FIXTURE-EXTERNAL
41
+ ownership: binds_to
42
+ canonical_owner_document_id: FRONTMATTERING-EXTERNAL-OWNER
43
+ claim_boundary_packet:
44
+ claimed_state: AUTHORED_CANDIDATE
45
+ verifies:
46
+ - This fixture declares one predicate subject.
47
+ does_not_verify:
48
+ - Anything beyond the exercised predicate.
49
+ judgment_left_to_agent: []
50
+ relationships: []
51
+ evidence_references: []
52
+ template_contract:
53
+ schema_version: frontmattering_template_use/v0_1_5
54
+ template_id: frontmattering_implementation_contract/v0_1_5
55
+ conformance_required: true
56
+ ---
57
+
58
+ # Fixture document
59
+
60
+ Body text.