okf 2.0.0 → 2.1.1

data/lib/okf/skill/reference/spec-map.md

@@ -0,0 +1,32 @@
+# What each SPEC section governs
+
+Kind: index. Answers: which § of the vendored spec settles a question, so you
+consult one section instead of re-reading all of [SPEC.md](SPEC.md).
+
+The spec is vendored **verbatim** from upstream — its header names the commit
+and the licence — so it is never edited here and never split; this file is its
+map, kept beside it. The § numbers are the stable keys: cite `§6.2`, never a
+heading or a line number. Every section is here, including the two an authoring
+question rarely reaches: an index that quietly drops what it judges uninteresting
+misroutes the reader who wanted exactly that. <!-- rule:okf-spec-map -->
+
+| § | Governs | Reach for it when |
+|---|---------|-------------------|
+| §1 | motivation, goals, and the **non-goals** | arguing why OKF at all; checking a proposal against what the format refuses to be |
+| §2 | terminology — bundle, concept, concept ID, frontmatter, body, link, source, provenance, credibility signal, actor, trust tier, attested computation, executor, receipt, attester | a word is load-bearing in a disagreement, or a field name reads two ways |
+| §3 | bundle structure, reserved filenames | laying out directories |
+| §4 | concept documents & frontmatter | writing or validating a concept |
+| §5.1 | provenance — `sources` and its credibility signals | any external or empirical claim |
+| §5.2 / §5.3 | trust — `generated`, `verified`, and the derived tiers | recording who wrote or confirmed content |
+| §5.4 / §5.5 | lifecycle — `status`, `stale_after` | marking drafts, deprecations, expiries |
+| §6 / §6.1 | cross-links; **broken links are tolerated** | linking; judging a "broken" link |
+| §6.2 / §6.3 | path-valued fields; the `references/` convention | pointing at non-concept assets |
+| §7 | the actor convention | filling any `by` |
+| §8 | index files & progressive disclosure | orienting; writing or synthesizing an index |
+| §9 | log files | recording history |
+| §10 | attested computations | a concept that *is* a sanctioned computation |
+| §11 | conformance — the hard gate | what `validate` may and may not reject |
+| §12 | versioning (`okf_version`) | the root index's one allowed field |
+| §13 | changes from v0.1 | migrating a bundle; reading an unmigrated one |
+| Appendix A | one worked bundle exercising every family, as a v0.1 → v0.2 migration | you want the whole shape at once rather than a rule at a time |
+

data/lib/okf/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: okf
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.1
 platform: ruby
 authors:
 - Rodrigo Serradura
@@ -77,6 +77,47 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".okf/capabilities/agent-skill.md"
+- ".okf/capabilities/bundles-manager.md"
+- ".okf/capabilities/graph-server.md"
+- ".okf/capabilities/index.md"
+- ".okf/capabilities/library-api.md"
+- ".okf/capabilities/linter.md"
+- ".okf/capabilities/read-views.md"
+- ".okf/capabilities/render.md"
+- ".okf/capabilities/search.md"
+- ".okf/capabilities/validator.md"
+- ".okf/cli.md"
+- ".okf/design/browser-tests.md"
+- ".okf/design/core-shell-split.md"
+- ".okf/design/index.md"
+- ".okf/design/integration-first.md"
+- ".okf/design/packaging.md"
+- ".okf/design/ruby-floor.md"
+- ".okf/design/runtime-dependencies.md"
+- ".okf/design/search-engines.md"
+- ".okf/design/server-trust-boundary.md"
+- ".okf/index.md"
+- ".okf/log.md"
+- ".okf/model/bundle.md"
+- ".okf/model/concept.md"
+- ".okf/model/graph.md"
+- ".okf/model/index.md"
+- ".okf/model/skeleton.md"
+- ".okf/overview.md"
+- ".okf/registry.md"
+- ".okf/structure/format-layer.md"
+- ".okf/structure/index.md"
+- ".okf/structure/search.md"
+- ".okf/structure/the-analysers.md"
+- ".okf/structure/the-cli.md"
+- ".okf/structure/the-disk-shell.md"
+- ".okf/structure/the-model.md"
+- ".okf/structure/the-server.md"
+- ".okf/structure/the-skill.md"
+- ".okf/testing/adding-a-verb.md"
+- ".okf/testing/index.md"
+- ".okf/testing/the-harness.md"
 - CHANGELOG.md
 - LICENSE.txt
 - NOTICE
@@ -146,20 +187,28 @@ files:
 - lib/okf/skill/reference/SPEC.md
 - lib/okf/skill/reference/authoring.md
 - lib/okf/skill/reference/cli.md
+- lib/okf/skill/reference/cli/checks.md
+- lib/okf/skill/reference/cli/graph.md
+- lib/okf/skill/reference/cli/map.md
+- lib/okf/skill/reference/cli/registry.md
+- lib/okf/skill/reference/cli/search.md
+- lib/okf/skill/reference/cli/serve.md
+- lib/okf/skill/reference/cli/views.md
+- lib/okf/skill/reference/spec-map.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
 - lib/okf/skill/templates/root-index.md
 - lib/okf/version.rb
-homepage: https://github.com/serradura/okf-gem
+homepage: https://github.com/serradura/okf
 licenses:
 - Apache-2.0
 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/okf/CHANGELOG.md
+  homepage_uri: https://github.com/serradura/okf
+  source_code_uri: https://github.com/serradura/okf
+  changelog_uri: https://github.com/serradura/okf/blob/main/gems/okf/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: