okf 1.12.0 → 2.0.0

data/lib/okf/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module OKF
-  VERSION = "1.12.0"
+  VERSION = "2.0.0"
 end

data/lib/okf.rb

@@ -16,7 +16,7 @@ module OKF
 
   # Blank in the frontmatter sense: nil, false, an empty/whitespace-only string,
   # or an empty collection. Numbers and other scalars are never blank. The one
-  # domain-wide predicate behind "non-empty type" (§9.2) and the recommended-field
+  # domain-wide predicate behind "non-empty type" (§11 cond. 2) and the recommended-field
   # warnings, kept here so the gem needs no ActiveSupport.
   def self.blank?(value)
     return true if value.nil? || value == false
@@ -25,6 +25,18 @@ module OKF
     value.respond_to?(:empty?) ? value.empty? : false
   end
 
+  # A temporal value as ISO 8601 — the one serialization rule for
+  # generated_at/stale_after, shared by the catalog row and /node/meta so the
+  # served and baked pages cannot drift over one concept's dates. YAML hands
+  # over a Date or a Time for an unquoted value (whose default to_s is not
+  # ISO); a String passes through; a degenerate value serializes as its
+  # string, never as raw structure.
+  def self.iso8601(value)
+    return nil if value.nil?
+
+    value.respond_to?(:iso8601) ? value.iso8601 : value.to_s
+  end
+
   # The directory a concept lives in, derived from its §2 id: the id *is* the
   # path minus `.md`, so putting the suffix back and taking the dirname is the
   # definition rather than a parse of it. One home for it because three views
@@ -36,10 +48,17 @@ module OKF
 
   require "okf/version"
 
+  # The OKF spec version this gem targets — one declaration behind the validate
+  # header and its help row, so the version a bundle is judged against cannot
+  # be stated two ways. The gem still *reads* v0.1 (§13.1); this is what it
+  # validates for. Known readable versions: Concept::KNOWN_SPEC_VERSIONS.
+  SPEC_VERSION = "0.2"
+
   # ── kernel: cross-cutting primitives ──
   require "okf/path"
+  require "okf/safe_read"
 
-  # ── Markdown: parse structure out of a markdown document (§4/§5/§8) ──
+  # ── Markdown: parse structure out of a markdown document (§4/§6/§5.1) ──
   require "okf/markdown/frontmatter"
   require "okf/markdown/links"
   require "okf/markdown/citations"
@@ -48,6 +67,8 @@ module OKF
   require "okf/concept"
   require "okf/bundle"
   require "okf/bundle/graph"
+  require "okf/bundle/references"
+  require "okf/bundle/row_filter"
   require "okf/bundle/skeleton"
   require "okf/bundle/search"
   # These two lines ARE the engine preference order. Each engine registers itself

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: okf
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Rodrigo Serradura
@@ -78,7 +78,6 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
-- CODE_OF_CONDUCT.md
 - LICENSE.txt
 - NOTICE
 - README.md
@@ -90,6 +89,8 @@ files:
 - lib/okf/bundle/linter.rb
 - lib/okf/bundle/linter/report.rb
 - lib/okf/bundle/reader.rb
+- lib/okf/bundle/references.rb
+- lib/okf/bundle/row_filter.rb
 - lib/okf/bundle/search.rb
 - lib/okf/bundle/search/index.rb
 - lib/okf/bundle/search/scan.rb
@@ -106,6 +107,7 @@ files:
 - lib/okf/cli/index.rb
 - lib/okf/cli/lint.rb
 - lib/okf/cli/loose.rb
+- lib/okf/cli/references.rb
 - lib/okf/cli/registry.rb
 - lib/okf/cli/render.rb
 - lib/okf/cli/search.rb
@@ -124,6 +126,7 @@ files:
 - lib/okf/registry.rb
 - lib/okf/render/graph.rb
 - lib/okf/render/graph/template.html.erb
+- lib/okf/safe_read.rb
 - lib/okf/server/app.rb
 - lib/okf/server/hub.rb
 - lib/okf/server/hub/not_found.rb
@@ -143,6 +146,7 @@ files:
 - lib/okf/skill/reference/SPEC.md
 - lib/okf/skill/reference/authoring.md
 - lib/okf/skill/reference/cli.md
+- lib/okf/skill/templates/attested-computation.md
 - lib/okf/skill/templates/concept.md
 - lib/okf/skill/templates/index.md
 - lib/okf/skill/templates/log.md
@@ -155,7 +159,7 @@ metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/serradura/okf-gem
   source_code_uri: https://github.com/serradura/okf-gem
-  changelog_uri: https://github.com/serradura/okf-gem/blob/main/CHANGELOG.md
+  changelog_uri: https://github.com/serradura/okf-gem/blob/main/okf/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:

data/CODE_OF_CONDUCT.md

@@ -1,10 +0,0 @@
-# Code of Conduct
-
-"okf" follows [The Ruby Community Conduct Guideline](https://www.ruby-lang.org/en/conduct) in all "collaborative space", which is defined as community communications channels (such as mailing lists, submitted patches, commit comments, etc.):
-
-* Participants will be tolerant of opposing views.
-* Participants must ensure that their language and actions are free of personal attacks and disparaging personal remarks.
-* When interpreting the words and actions of others, participants should always assume good intentions.
-* Behaviour which can be reasonably considered harassment will not be tolerated.
-
-If you have any concerns about behaviour within this project, please contact us at ["rodrigo.serradura@gmail.com"](mailto:"rodrigo.serradura@gmail.com").