pandorga 1.11.0 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d3adc84d250c4ff140df5b9cc9db266896fdfce92fd899789fd943ce8ac4659
-  data.tar.gz: 474d788dea7851796fb189732c9bb75d118666177f4cf81df70d8361f4310872
+  metadata.gz: f0650221add1248fcfa882ccf2557c9d73d1de757239e6e396e8cec1ddefa512
+  data.tar.gz: 2c6502ac5c6fdd2d6153490b88925e465b7c66f315502e61819b6541e530831b
 SHA512:
-  metadata.gz: d9e76b0be8485c3870366cce0bc816fc55f3dee7ea2b17ec40602f2c70dccbf985e2d7be6da7911e54a7f830c6fd3c4030dbb985689d50c84cb9226c04cd0f2e
-  data.tar.gz: 6853fe1a1d0edd4066d45187a4cddd67258a753afd849284615383fb9cae4844a24aabff188681a73066e2808170bfc1e28730832e68d976c34400899d2cea88
+  metadata.gz: 9123d4ada63311688340fa8da4076a898dfb362764d15030da03cd62776def8172e9be28fc9d7fe47005930c004565860f8997ca46050c7149eb76332c94fa6d
+  data.tar.gz: 6dbf48af21a4d6e56a0b21e070a951f8180424de1efbb906830d435200d736b4955781d0f04b3f7677be32cf1ce20a916bdad761faf41c6fd836ac48f06e1aa4

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [1.12.0] — 2026-10-19
+
+### Changed
+
+- `pandorga install-functions` fills the Studio tag pickers from the site's `_config.yml` → `pandorga.taxonomies` (with `min` and `max`), falling back to a page's `taxonomy`, then applies `studio.overrides.yml`. The gem's `studio/schema.yml` no longer ships a site's tag vocabulary; a collection without one gets an empty picker and a build warning (PLT-AC-43).
+
 ## [1.11.0] — 2026-10-19
 
 ### Fixed

data/DESIGN.md

@@ -1201,14 +1201,12 @@ discs.
 An element renders only if a populated field backs it. The classification axes,
 as enforced by [`_plugins/lib/tag_validator.rb`](_plugins/lib/tag_validator.rb):
 
-* **Articles** classify on `tags`, one to three, from a closed English
-  vocabulary: `Aesthetics`, `AI`, `Data`, `DevOps`, `Mathematics`,
-  `Robotics`, `Social`. All 22 carry them.
-* **Rascunhos** classify on `tags` too, by subject and in Portuguese, **zero to
-  three**: `arte`, `brasilidade`, `carme`, `devaneio`, `engraçadinho`,
-  `música`, `pesquisa`, `provocação`, `técnico`, `trabalho`. Unlike articles
-  the field may be empty — a notebook holds pages that file nowhere. 29 of 30
-  carry at least one.
+* **Articles** classify on `tags`, one to three, from the closed vocabulary
+  the site declares in `_config.yml` → `pandorga.taxonomies`.
+* **Rascunhos** classify on `tags` too, **zero to three**, from the closed
+  vocabulary the site declares in `_config.yml` → `pandorga.taxonomies`.
+  Unlike articles the field may be empty — a notebook holds pages that file
+  nowhere.
 * `category` is rejected on both collections — one classification axis, not
   two.
 * **Projects** carry free `tags` (all 8 do), plus `label`, `status`,

data/lib/pandorga/commands/install_functions.rb

@@ -1,12 +1,16 @@
 # frozen_string_literal: true
 
+require "date"
 require "fileutils"
 require "pathname"
+require "yaml"
+require "pandorga/commands/studio_schema"
 
 module Pandorga
   module Commands
     # Option A (PLT-0.2): copy functions/ and studio/ from the gem into the site root
-    # so Cloudflare Pages can compile Functions from the project root.
+    # so Cloudflare Pages can compile Functions from the project root, then apply
+    # site taxonomies and overrides to studio/schema.yml (PLT-AC-43).
     class InstallFunctions
       STAMP = ".pandorga-version"
 
@@ -22,6 +26,7 @@ module Pandorga
 
         copy_tree(gem_functions, dest_root.join("functions"))
         copy_tree(gem_studio, dest_root.join("studio")) if gem_studio.directory?
+        hydrate_studio_schema(dest_root)
 
         stamp = dest_root.join("functions", STAMP)
         stamp.write("#{Pandorga::VERSION}\n")
@@ -36,6 +41,36 @@ module Pandorga
         FileUtils.mkdir_p(dest.dirname)
         FileUtils.cp_r(src, dest)
       end
+
+      def hydrate_studio_schema(dest_root)
+        config_path = dest_root.join("_config.yml")
+        schema_path = dest_root.join("studio", "schema.yml")
+        return unless config_path.file? && schema_path.file?
+
+        config = load_yaml(config_path)
+        schema = load_yaml(schema_path)
+        return unless schema.is_a?(Hash)
+
+        missing = StudioSchema.apply_taxonomies!(schema, config)
+
+        overrides_path = dest_root.join("studio.overrides.yml")
+        if overrides_path.file?
+          extra = load_yaml(overrides_path)
+          StudioSchema.apply_overrides!(schema, extra) if extra.is_a?(Hash)
+        end
+
+        header = "# Installed by pandorga install-functions #{Pandorga::VERSION}; " \
+                 "tag vocabularies come from _config.yml pandorga.taxonomies.\n"
+        schema_path.write("#{header}#{YAML.dump(schema)}")
+
+        missing.each do |name|
+          warn "pandorga install-functions: warning: no taxonomy for #{name}; its Studio tags picker is empty"
+        end
+      end
+
+      def load_yaml(path)
+        YAML.safe_load(path.read, permitted_classes: [Date, Time], aliases: true) || {}
+      end
     end
   end
 end

data/lib/pandorga/commands/new.rb

@@ -24,7 +24,7 @@ module Pandorga
 
         gem "pandorga", "~> 1.3"
         # Local checkout: gem "pandorga", path: "../pandorga"
-        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v1.11.0"
+        # GitHub tag: gem "pandorga", github: "alexandrelheinen/pandorga", tag: "v1.12.0"
         gem "csv"
         gem "base64"
       RUBY

data/lib/pandorga/commands/studio_schema.rb

@@ -8,7 +8,7 @@ require "date"
 module Pandorga
   module Commands
     # Compose studio/schema.yml from template studio.yml files + registry.
-    # Refs: PLT-AC-3, docs/spec.md §5.5
+    # Refs: PLT-AC-3, PLT-AC-43, docs/spec.md §5.5
     class StudioSchema
       DEFAULT_MEDIA = {
         "name" => "media",
@@ -28,6 +28,14 @@ module Pandorga
         "options" => { "format" => "markdown" }
       }.freeze
 
+      def self.apply_taxonomies!(schema, config)
+        new.apply_taxonomies!(schema, config)
+      end
+
+      def self.apply_overrides!(schema, extra)
+        new.apply_overrides!(schema, extra)
+      end
+
       def run(argv)
         root = Pathname.new(argv[0] || Dir.pwd).expand_path
         templates_root = Pathname.new(Pandorga.gem_path("templates"))
@@ -56,7 +64,6 @@ module Pandorga
       # Public for gates: build the schema hash without writing.
       def compose(config, templates_root)
         pages = config.dig("pandorga", "pages") || []
-        taxonomies = config.dig("pandorga", "taxonomies") || {}
         groups = {}
         group_order = []
         needs_media = false
@@ -76,7 +83,7 @@ module Pandorga
           next unless fragment.is_a?(Hash)
 
           needs_media ||= truthy?(fragment["needs_media"])
-          contributions = expand_fragment(fragment, page, taxonomies)
+          contributions = expand_fragment(fragment, page)
           contributions.each do |contrib|
             group_name = contrib[:group]
             unless groups.key?(group_name)
@@ -110,12 +117,88 @@ module Pandorga
         if needs_markdown
           schema["components"] = { "markdown_body" => deep_dup(DEFAULT_MARKDOWN_BODY) }
         end
+        apply_taxonomies!(schema, config)
         schema
       end
 
+      def apply_taxonomies!(schema, config)
+        return [] unless schema.is_a?(Hash)
+
+        vocabularies = resolve_taxonomies(config)
+        missing = []
+
+        Array(schema["content"]).each do |group|
+          next unless group.is_a?(Hash)
+
+          Array(group["items"]).each do |item|
+            next unless item.is_a?(Hash)
+            next unless item["type"].to_s == "collection"
+
+            name = item["name"].to_s
+            next if name.empty?
+
+            had_picker = apply_collection_taxonomy!(item, vocabularies[name])
+            missing << name if had_picker && !vocabularies.key?(name)
+          end
+        end
+
+        index = schema["collections"].is_a?(Hash) ? schema["collections"] : {}
+        index.each do |key, entry|
+          next unless entry.is_a?(Hash)
+
+          name = entry["name"].to_s.empty? ? key.to_s : entry["name"].to_s
+          next if name.empty?
+
+          had_picker = apply_collection_taxonomy!(entry, vocabularies[name])
+          missing << name if had_picker && !vocabularies.key?(name)
+        end
+
+        missing.uniq
+      end
+
+      def apply_overrides!(schema, extra)
+        if extra["media"].is_a?(Hash)
+          schema["media"] = deep_merge(schema["media"] || {}, extra["media"])
+        end
+
+        if extra["components"].is_a?(Hash)
+          schema["components"] = deep_merge(schema["components"] || {}, extra["components"])
+        end
+
+        if extra["collections"].is_a?(Hash)
+          extra["collections"].each do |name, patch|
+            next unless patch.is_a?(Hash)
+
+            item = find_content_item(schema, name.to_s)
+            if item
+              merged = deep_merge(item, patch)
+              item.replace(merged)
+            end
+            if schema["collections"].is_a?(Hash) && schema["collections"][name.to_s]
+              schema["collections"][name.to_s] =
+                deep_merge(schema["collections"][name.to_s], patch)
+            end
+          end
+        end
+
+        return unless extra["content"].is_a?(Array)
+
+        schema["content"] ||= []
+        extra["content"].each do |group|
+          next unless group.is_a?(Hash)
+
+          existing = schema["content"].find { |g| g["name"].to_s == group["name"].to_s }
+          if existing
+            existing.replace(deep_merge(existing, group))
+          else
+            schema["content"] << deep_dup(group)
+          end
+        end
+      end
+
       private
 
-      def expand_fragment(fragment, page, taxonomies)
+      def expand_fragment(fragment, page)
         contributions = []
         default_group = fragment["group"].to_s
         default_group = page["template"].to_s if default_group.empty?
@@ -127,12 +210,7 @@ module Pandorga
         if fragment["collection"].is_a?(Hash)
           name = page["collection"].to_s
           unless name.empty?
-            items << instantiate_collection(
-              fragment["collection"],
-              name,
-              page,
-              taxonomies
-            )
+            items << instantiate_collection(fragment["collection"], name, page)
           end
         end
 
@@ -145,7 +223,7 @@ module Pandorga
             name = slot.to_s if name.empty?
             next if name.empty? || name == "data" || name == "profile"
 
-            items << instantiate_collection(spec, name, page, taxonomies)
+            items << instantiate_collection(spec, name, page)
           end
         end
 
@@ -178,7 +256,7 @@ module Pandorga
         contributions
       end
 
-      def instantiate_collection(spec, name, page, taxonomies)
+      def instantiate_collection(spec, name, page)
         entry = deep_dup(spec)
         entry["name"] = name
         entry["type"] ||= "collection"
@@ -189,66 +267,96 @@ module Pandorga
         end
         entry["path"] ||= "content/collections/#{name}"
         entry["path"] = entry["path"].to_s.gsub("{collection}", name)
-        apply_taxonomy!(entry, name, taxonomies)
         entry
       end
 
-      def apply_taxonomy!(entry, collection_name, taxonomies)
-        tax = taxonomies[collection_name]
-        return unless tax.is_a?(Hash)
+      def resolve_taxonomies(config)
+        return {} unless config.is_a?(Hash)
 
-        Array(entry["fields"]).each do |field|
-          next unless field.is_a?(Hash)
-          next unless field["name"].to_s == "tags"
+        vocab = {}
+        pages = Array(config.dig("pandorga", "pages")).select { |p| p.is_a?(Hash) }
+        taxonomies = config.dig("pandorga", "taxonomies")
 
-          field["options"] ||= {}
-          next unless field["options"].is_a?(Hash)
+        if taxonomies.is_a?(Hash)
+          taxonomies.each do |collection, spec|
+            next unless spec.is_a?(Hash)
 
-          tags = tax["tags"]
-          field["options"]["values"] = tags if tags.is_a?(Array) && !tags.empty?
-          max = tax["max"]
-          field["options"]["max"] = max if max
-        end
-      end
+            tags = spec["tags"]
+            next unless tags.is_a?(Array) && !tags.empty?
 
-      def apply_overrides!(schema, extra)
-        if extra["media"].is_a?(Hash)
-          schema["media"] = deep_merge(schema["media"] || {}, extra["media"])
-        end
+            coll_name = collection.to_s
+            page_tax = pages.find { |p| p["collection"].to_s == coll_name }&.fetch("taxonomy", nil)
+            page_tax = nil unless page_tax.is_a?(Hash)
 
-        if extra["components"].is_a?(Hash)
-          schema["components"] = deep_merge(schema["components"] || {}, extra["components"])
+            max = spec["max"].nil? ? page_tax&.fetch("max", nil) : spec["max"]
+            min = spec["min"].nil? ? page_tax&.fetch("min", nil) : spec["min"]
+
+            vocab[coll_name] = build_taxonomy_entry(tags, max: max, min: min)
+          end
         end
 
-        if extra["collections"].is_a?(Hash)
-          extra["collections"].each do |name, patch|
-            next unless patch.is_a?(Hash)
+        pages.each do |page|
+          coll_name = page["collection"].to_s
+          next if coll_name.empty? || vocab.key?(coll_name)
 
-            item = find_content_item(schema, name.to_s)
-            if item
-              merged = deep_merge(item, patch)
-              item.replace(merged)
-            end
-            if schema["collections"].is_a?(Hash) && schema["collections"][name.to_s]
-              schema["collections"][name.to_s] =
-                deep_merge(schema["collections"][name.to_s], patch)
-            end
-          end
+          spec = page["taxonomy"]
+          next unless spec.is_a?(Hash)
+
+          tags = spec["tags"]
+          next unless tags.is_a?(Array) && !tags.empty?
+
+          vocab[coll_name] = build_taxonomy_entry(tags, max: spec["max"], min: spec["min"])
         end
 
-        return unless extra["content"].is_a?(Array)
+        vocab
+      end
 
-        schema["content"] ||= []
-        extra["content"].each do |group|
-          next unless group.is_a?(Hash)
+      def build_taxonomy_entry(tags, max:, min:)
+        entry = { "tags" => tags.map(&:to_s) }
+        parsed_max = parse_int_or_nil(max)
+        parsed_min = parse_int_or_nil(min)
+        entry["max"] = parsed_max unless parsed_max.nil?
+        entry["min"] = parsed_min unless parsed_min.nil?
+        entry
+      end
 
-          existing = schema["content"].find { |g| g["name"].to_s == group["name"].to_s }
-          if existing
-            existing.replace(deep_merge(existing, group))
+      def parse_int_or_nil(val)
+        return nil if val.nil?
+
+        Integer(val)
+      rescue ArgumentError, TypeError
+        nil
+      end
+
+      def apply_collection_taxonomy!(entry, tax)
+        had_picker = false
+        Array(entry["fields"]).each do |field|
+          next unless tag_picker_field?(field)
+
+          had_picker = true
+          field["options"] = {} unless field["options"].is_a?(Hash)
+          opts = field["options"]
+
+          if tax.is_a?(Hash)
+            opts["values"] = Array(tax["tags"]).map(&:to_s)
+            opts["max"] = tax["max"] unless tax["max"].nil?
+            if tax["min"].nil?
+              opts.delete("min")
+            else
+              opts["min"] = tax["min"]
+            end
           else
-            schema["content"] << deep_dup(group)
+            opts["values"] = []
+            opts.delete("min")
           end
         end
+        had_picker
+      end
+
+      def tag_picker_field?(field)
+        field.is_a?(Hash) &&
+          field["name"].to_s == "tags" &&
+          field["type"].to_s == "select"
       end
 
       def find_content_item(schema, name)

data/lib/pandorga/registry/schema.yml

@@ -79,7 +79,7 @@ taxonomies:
   prose: |
     Closed tag vocabularies per collection (`tags`, `max`, `min`). Page-local
     `pandorga.pages[].taxonomy` is also accepted when a collection has no top-level
-    entry.
+    entry. `pandorga install-functions` copies these vocabularies into the installed Studio schema (`studio/schema.yml`), so the Studio tag pickers always offer this list. A collection with no vocabulary gets an empty picker and a warning.
 
 pages:
   title: "`pandorga.pages[]`"

data/lib/pandorga/version.rb

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

data/scripts/test/fixtures/studio-taxonomy/page-local/_config.yml

@@ -0,0 +1,9 @@
+pandorga:
+  pages:
+    - key: articles
+      template: articles
+      collection: articles
+      path: /pages/articles/
+      taxonomy:
+        tags: [Notes]
+        max: 1

data/scripts/test/fixtures/studio-taxonomy/top-level/_config.yml

@@ -0,0 +1,9 @@
+pandorga:
+  taxonomies:
+    articles:
+      tags: [Design, Organizations]
+      max: 2
+      min: 1
+    posts:
+      tags: [alpha, beta, gamma]
+      max: 3

data/scripts/test/test-studio-taxonomy.rb

@@ -0,0 +1,246 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Refs: PLT-AC-43
+require "pathname"
+require "yaml"
+require "fileutils"
+require "tmpdir"
+require "open3"
+require "date"
+
+ROOT = Pathname.new(__dir__).join("../..").expand_path
+EXE = ROOT.join("exe/pandorga")
+GEM_SCHEMA = ROOT.join("studio/schema.yml")
+FIXTURES = ROOT.join("scripts/test/fixtures/studio-taxonomy")
+TOP_LEVEL_CONFIG = FIXTURES.join("top-level/_config.yml")
+PAGE_LOCAL_CONFIG = FIXTURES.join("page-local/_config.yml")
+
+LEFTOVER_TAGS = %w[
+  Aesthetics
+  Social
+  Mathematics
+  Robotics
+  DevOps
+  brasilidade
+  engraçadinho
+  devaneio
+  provocação
+].freeze
+
+def fail!(message)
+  warn "FAIL test-studio-taxonomy: #{message}"
+  exit 1
+end
+
+def run_install_functions(dest)
+  env = { "RUBYOPT" => "-I#{ROOT.join('lib')}" }
+  Open3.capture3(env, "ruby", EXE.to_s, "install-functions", dest.to_s)
+end
+
+def load_yaml(path)
+  YAML.safe_load(path.read, permitted_classes: [Date, Time], aliases: true) || {}
+end
+
+def find_content_collection(schema, name)
+  Array(schema["content"]).each do |group|
+    next unless group.is_a?(Hash)
+
+    Array(group["items"]).each do |item|
+      next unless item.is_a?(Hash)
+      next unless item["type"].to_s == "collection"
+
+      return item if item["name"].to_s == name.to_s
+    end
+  end
+  nil
+end
+
+def find_tags_field(entry)
+  return nil unless entry.is_a?(Hash)
+
+  Array(entry["fields"]).find { |f| f.is_a?(Hash) && f["name"].to_s == "tags" }
+end
+
+# a, b, e, d. Top-level fixture, no leftovers, overrides, and config change.
+Dir.mktmpdir("pandorga-studio-tax-top-") do |dir|
+  site = Pathname.new(dir)
+  FileUtils.cp(TOP_LEVEL_CONFIG, site.join("_config.yml"))
+
+  stdout, stderr, status = run_install_functions(site)
+  fail!("case a CLI failed: #{stdout}\n#{stderr}") unless status.success?
+
+  installed_path = site.join("studio/schema.yml")
+  fail!("installed schema missing at #{installed_path}") unless installed_path.file?
+
+  schema = load_yaml(installed_path)
+  [
+    ["content.articles", find_content_collection(schema, "articles")],
+    ["collections.articles", schema.dig("collections", "articles")]
+  ].each do |label, entry|
+    # The gem's schema has no collections index; the installer must not add one.
+    next if label.start_with?("collections.") && !schema.key?("collections")
+
+    fail!("missing #{label}") unless entry.is_a?(Hash)
+    opts = find_tags_field(entry)&.fetch("options", nil)
+    fail!("missing tags options on #{label}") unless opts.is_a?(Hash)
+    unless opts["values"] == %w[Design Organizations]
+      fail!("#{label} values expected [Design, Organizations], got #{opts['values'].inspect}")
+    end
+    fail!("#{label} max expected 2, got #{opts['max'].inspect}") unless opts["max"] == 2
+    fail!("#{label} min expected 1, got #{opts['min'].inspect}") unless opts["min"] == 1
+  end
+
+  [
+    ["content.posts", find_content_collection(schema, "posts")],
+    ["collections.posts", schema.dig("collections", "posts")]
+  ].each do |label, entry|
+    # The gem's schema has no collections index; the installer must not add one.
+    next if label.start_with?("collections.") && !schema.key?("collections")
+
+    fail!("missing #{label}") unless entry.is_a?(Hash)
+    opts = find_tags_field(entry)&.fetch("options", nil)
+    fail!("missing tags options on #{label}") unless opts.is_a?(Hash)
+    unless opts["values"] == %w[alpha beta gamma]
+      fail!("#{label} values expected [alpha, beta, gamma], got #{opts['values'].inspect}")
+    end
+    fail!("#{label} max expected 3, got #{opts['max'].inspect}") unless opts["max"] == 3
+    if opts.key?("min")
+      fail!("#{label} should not have min key, got #{opts['min'].inspect}")
+    end
+  end
+
+  fail!("installer must not add a collections index") if schema.key?("collections")
+
+  # Free-text tags (type string, list) are not pickers and stay untouched.
+  projects_tags = find_tags_field(find_content_collection(schema, "projects"))
+  gem_projects_tags = find_tags_field(find_content_collection(load_yaml(GEM_SCHEMA), "projects"))
+  unless projects_tags && projects_tags == gem_projects_tags
+    fail!("free-text projects tags changed: #{projects_tags.inspect}")
+  end
+
+  # b. No leftover site vocabulary in installed schema.
+  raw_text = installed_path.read
+  LEFTOVER_TAGS.each do |word|
+    if raw_text.include?(word)
+      fail!("installed schema still contains leftover tag #{word.inspect}")
+    end
+  end
+
+  # e. Overrides applied after taxonomies.
+  site.join("studio.overrides.yml").write(<<~YAML)
+    collections:
+      articles:
+        label: Essays
+  YAML
+  stdout, stderr, status = run_install_functions(site)
+  fail!("case e CLI failed: #{stdout}\n#{stderr}") unless status.success?
+
+  overridden = load_yaml(installed_path)
+  articles_item = find_content_collection(overridden, "articles")
+  unless articles_item&.fetch("label", nil) == "Essays"
+    fail!("expected overridden articles label 'Essays', got #{articles_item&.fetch('label', nil).inspect}")
+  end
+  articles_vals = find_tags_field(articles_item)&.dig("options", "values")
+  unless articles_vals == %w[Design Organizations]
+    fail!("expected overridden articles tags [Design, Organizations], got #{articles_vals.inspect}")
+  end
+  FileUtils.rm_f(site.join("studio.overrides.yml"))
+
+  # d. Changing _config.yml changes the output.
+  site.join("_config.yml").write(<<~YAML)
+    pandorga:
+      taxonomies:
+        articles:
+          tags: [Zeta]
+          max: 2
+        posts:
+          tags: [alpha, beta, gamma]
+          max: 3
+  YAML
+  stdout, stderr, status = run_install_functions(site)
+  fail!("case d CLI failed: #{stdout}\n#{stderr}") unless status.success?
+
+  updated = load_yaml(installed_path)
+  updated_vals = find_tags_field(find_content_collection(updated, "articles"))&.dig("options", "values")
+  unless updated_vals == %w[Zeta]
+    fail!("expected updated articles tags [Zeta], got #{updated_vals.inspect}")
+  end
+end
+
+# c. Page-local fixture: articles falls back to pages[].taxonomy; posts stays [] with a warning.
+Dir.mktmpdir("pandorga-studio-tax-page-") do |dir|
+  site = Pathname.new(dir)
+  FileUtils.cp(PAGE_LOCAL_CONFIG, site.join("_config.yml"))
+
+  stdout, stderr, status = run_install_functions(site)
+  fail!("case c CLI failed: #{stdout}\n#{stderr}") unless status.success?
+
+  schema = load_yaml(site.join("studio/schema.yml"))
+  articles_opts = find_tags_field(find_content_collection(schema, "articles"))&.fetch("options", nil)
+  fail!("case c missing articles tags options") unless articles_opts.is_a?(Hash)
+  unless articles_opts["values"] == %w[Notes]
+    fail!("case c articles values expected [Notes], got #{articles_opts['values'].inspect}")
+  end
+  unless articles_opts["max"] == 1
+    fail!("case c articles max expected 1, got #{articles_opts['max'].inspect}")
+  end
+
+  posts_opts = find_tags_field(find_content_collection(schema, "posts"))&.fetch("options", nil)
+  fail!("case c missing posts tags options") unless posts_opts.is_a?(Hash)
+  unless posts_opts["values"] == []
+    fail!("case c posts values expected [], got #{posts_opts['values'].inspect}")
+  end
+
+  combined = "#{stdout}\n#{stderr}"
+  unless combined.match?(/warning:.*posts/i)
+    fail!("case c expected warning mentioning posts, got:\n#{combined}")
+  end
+end
+
+# f. Gem source: studio/schema.yml has values: [] on every select tags field.
+gem_schema = load_yaml(GEM_SCHEMA)
+gem_tag_fields = 0
+Array(gem_schema["content"]).each do |group|
+  next unless group.is_a?(Hash)
+
+  Array(group["items"]).each do |item|
+    next unless item.is_a?(Hash) && item["type"].to_s == "collection"
+
+    field = find_tags_field(item)
+    next unless field && (field["type"].to_s == "select" || field["options"].is_a?(Hash))
+
+    gem_tag_fields += 1
+    vals = field.dig("options", "values")
+    unless vals == []
+      fail!("gem studio/schema.yml #{item['name']} tags values expected [], got #{vals.inspect}")
+    end
+  end
+end
+if gem_schema["collections"].is_a?(Hash)
+  gem_schema["collections"].each do |name, item|
+    field = find_tags_field(item)
+    next unless field && (field["type"].to_s == "select" || field["options"].is_a?(Hash))
+
+    vals = field.dig("options", "values")
+    unless vals == []
+      fail!("gem studio/schema.yml collections.#{name} tags values expected [], got #{vals.inspect}")
+    end
+  end
+end
+fail!("expected select tags fields in gem studio/schema.yml") if gem_tag_fields.zero?
+
+# g. No _config.yml in destination: command succeeds and copies schema unchanged.
+Dir.mktmpdir("pandorga-studio-tax-noconfig-") do |dir|
+  site = Pathname.new(dir)
+  stdout, stderr, status = run_install_functions(site)
+  fail!("case g CLI failed: #{stdout}\n#{stderr}") unless status.success?
+
+  installed_path = site.join("studio/schema.yml")
+  fail!("case g missing studio/schema.yml") unless installed_path.file?
+  unless installed_path.read == GEM_SCHEMA.read
+    fail!("case g expected studio/schema.yml to be copied unchanged when _config.yml is absent")
+  end
+end
+
+puts "PASS test-studio-taxonomy"

data/scripts/validate.sh

@@ -44,6 +44,7 @@ TESTS=(
   scripts/test/test-studio-api-contract.rb
   scripts/test/test-studio-rewrite-api-contract.rb
   scripts/test/test-studio-schema-composition.rb
+  scripts/test/test-studio-taxonomy.rb
   scripts/test/test-text-excerpt.rb
   scripts/test/test-git-chronology.rb
   scripts/test/test-math-row-breaks.rb

data/studio/schema.yml

@@ -7,6 +7,7 @@
 # - Thumbnail / image fields accept HTTPS URLs or /media/… paths (hotlink OK).
 # - Calendar days use type date with format yyyy-MM-dd
 # - Form order: identity (key, title, description) → options → body last
+# Tag vocabularies are empty here: install-functions fills them from the site's _config.yml (PLT-AC-43).
 
 media:
   name: media
@@ -72,19 +73,7 @@ content:
             options:
               multiple: true
               max: 3
-              values:
-                [
-                  arte,
-                  brasilidade,
-                  carme,
-                  devaneio,
-                  engraçadinho,
-                  música,
-                  pesquisa,
-                  provocação,
-                  técnico,
-                  trabalho,
-                ]
+              values: []
           - name: language
             label: Language
             type: select
@@ -170,10 +159,8 @@ content:
             description: "One to three."
             options:
               multiple: true
-              min: 1
               max: 3
-              values:
-                [Aesthetics, AI, Data, DevOps, Mathematics, Robotics, Social]
+              values: []
           - name: language
             label: Language
             type: select
@@ -441,7 +428,7 @@ content:
           - name: label
             label: Label
             type: string
-            description: "Small caps line above the project name (e.g. Robotics)."
+            description: "Small caps line above the project name."
           - name: icon
             label: Icon
             type: string

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pandorga
 version: !ruby/object:Gem::Version
-  version: 1.11.0
+  version: 1.12.0
 platform: ruby
 authors:
 - The Pandorga contributors
@@ -353,6 +353,8 @@ files:
 - scripts/tailwind/tailwind.config.js
 - scripts/test/fixtures/dual-template/_config.yml
 - scripts/test/fixtures/dual-template/index.html
+- scripts/test/fixtures/studio-taxonomy/page-local/_config.yml
+- scripts/test/fixtures/studio-taxonomy/top-level/_config.yml
 - scripts/test/render-parity/article-note.json
 - scripts/test/render-parity/blockquote.json
 - scripts/test/render-parity/blocks/ansi-basic.json
@@ -467,6 +469,7 @@ files:
 - scripts/test/test-studio-rewrite-sanitize.mjs
 - scripts/test/test-studio-schema-composition.rb
 - scripts/test/test-studio-slug-config.rb
+- scripts/test/test-studio-taxonomy.rb
 - scripts/test/test-template-packages.rb
 - scripts/test/test-text-excerpt.rb
 - scripts/test/test-theme-contrast.rb