textus 0.47.0 → 0.47.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c87fe067b0988d187beac617c4540e1563d0f006a08d6090b2b483c699555d46
-  data.tar.gz: 4f0503119ebf3eeff28d7a16aee8dc8c62673e6b41912e85bc3453e596075e65
+  metadata.gz: 027b10e6f16354d3fae852056f5ebe3f63f74fcc0096befb069d58074ccadb10
+  data.tar.gz: a8d46c59ed4d1cf53a0749577ac4284665b9ae65a137cffa968c7f53e9fd386f
 SHA512:
-  metadata.gz: fde04b0339e798e545c98699462afaf2767a772f1e76811c4f8833b561b69d02b172e4879cf17ffaea1dd51f1930846007abf4523a801ccfb5525c53e1365b7f
-  data.tar.gz: 10a4343781cb2251ba8f91121c0a89b1fe211702e7c5057693fce27357eee55c3abe6bfe7a88009ffc89f5fcc49ad6c44fcf258f532f5ac9d69d960857e833c6
+  metadata.gz: 9f9cd646c53fc78e467c0955ad847daeb890d46be8d5d8b2697fa7507eb728a8b541c4e4a9feaaba8be875a5a735b8a1fbfdbf7fbe8bf999e9f54ff39d9918e6
+  data.tar.gz: 7b8ae5bb3a6d8089a195ee5716d79b97397d4b5fa487750acb1b32bb9831d465d82789a8211a343dbc1d98102178adfe5396d3c24a91bf4a4ae2c96253e159d8

data/CHANGELOG.md

@@ -9,6 +9,13 @@ The **gem version** (`0.x.y`) is distinct from the **protocol version**
 bump is a breaking change that requires a store migration; the gem version
 tracks both additive improvements and breaking protocol bumps independently.
 
+## 0.47.1 — 2026-06-04 — External entries are a non-build path
+
+### Fixed
+
+- **`build` no longer materializes `external` derived entries.** External entries are generated by an out-of-band runner — textus only tracks their staleness. Previously they flowed through `Derived#publish_via` → `Pipeline.run` and hit a catch-all branch that emitted an empty payload and re-stamped the volatile `generated_at` (contrary to ADR 0070), which for an entry with publish targets would **clobber the runner's artifact with an empty render**. External is now skipped in `Derived#publish_via`, and `Pipeline.run` raises loudly if a non-projection source reaches it (only projection-derived entries are buildable).
+- **`compute.command` is now parsed for `external` entries.** The parser read `compute["runner"]`, a key the manifest schema forbids (`COMPUTE_KEYS` allows `command`), so `External#command` was always `nil`. The data field is renamed `runner` → `command` and now reads `compute["command"]`.
+
 ## 0.47.0 — 2026-06-04 — Close the agent loop over MCP
 
 The edit→accept→rebuild loop now closes over a single MCP transport: `build` is surfaced to MCP, `init --with-agent` scaffolds a connectable agent setup, and connection-lifecycle hardening (whole-contract drift fingerprint + a connect-time event carrying the resolved role) underpins it.

data/lib/textus/builder/pipeline.rb

@@ -1,5 +1,4 @@
 require "fileutils"
-require "time"
 
 module Textus
   module Builder
@@ -42,19 +41,25 @@ module Textus
       end
 
       def self.run(mentry:, deps:)
-        # 1. Load sources + project + reduce
+        # 1. Load sources + project + reduce. Only projection-derived entries are
+        # buildable in-process; External entries are generated out-of-band and are
+        # filtered out upstream (Derived#publish_via), so reaching here with a
+        # non-projection source is a wiring bug — fail loudly rather than emit an
+        # empty payload (and never re-stamp the volatile generated_at, ADR 0070).
+        unless mentry.is_a?(Textus::Manifest::Entry::Derived) && mentry.projection?
+          raise UsageError.new(
+            "builder: '#{mentry.key}' is not a projection-derived entry; only projections are buildable",
+          )
+        end
+
         data =
-          if mentry.is_a?(Textus::Manifest::Entry::Derived) && mentry.projection?
-            Textus::Projection.new(
-              reader: deps.reader,
-              spec: mentry.source.to_h.transform_keys(&:to_s),
-              lister: deps.lister,
-              rpc: deps.rpc,
-              transform_context: deps.transform_context,
-            ).run
-          else
-            { "entries" => [], "count" => 0, "generated_at" => Time.now.utc.iso8601 }
-          end
+          Textus::Projection.new(
+            reader: deps.reader,
+            spec: mentry.source.to_h.transform_keys(&:to_s),
+            lister: deps.lister,
+            rpc: deps.rpc,
+            transform_context: deps.transform_context,
+          ).run
         data = data.merge("boot" => deps.inject_boot.call) if mentry.inject_boot && deps.inject_boot
 
         # 2. Render

data/lib/textus/manifest/entry/derived.rb

@@ -3,7 +3,7 @@ module Textus
     class Entry
       class Derived < Base
         Projection = ::Data.define(:select, :pluck, :sort_by, :transform)
-        External   = ::Data.define(:sources, :runner)
+        External   = ::Data.define(:sources, :command)
 
         attr_reader :source, :template, :inject_boot, :events
 
@@ -21,6 +21,11 @@ module Textus
 
         def publish_via(pctx, prefix: nil) # rubocop:disable Lint/UnusedMethodArgument
           return nil unless in_generator_zone?(pctx.manifest.policy)
+          # External entries are produced by an out-of-band runner — textus has
+          # no in-process runner. The build path only tracks their staleness
+          # (Domain::Staleness::GeneratorCheck); materializing here would clobber
+          # the runner's artifact with an empty render. Skip the build entirely.
+          return nil if external?
 
           target_path = Textus::Write::Materializer.new(
             container: pctx.container, call: pctx.call,

data/lib/textus/manifest/entry/parser.rb

@@ -47,7 +47,7 @@ module Textus
               transform: compute["transform"],
             )
           else
-            Entry::Derived::External.new(sources: compute["sources"], runner: compute["runner"])
+            Entry::Derived::External.new(sources: compute["sources"], command: compute["command"])
           end
         end
 

data/lib/textus/version.rb

@@ -1,4 +1,4 @@
 module Textus
-  VERSION = "0.47.0"
+  VERSION = "0.47.1"
   PROTOCOL = "textus/3"
 end

data/lib/textus/write/materializer.rb

@@ -2,8 +2,11 @@ require "fileutils"
 
 module Textus
   module Write
-    # Materializes a single Derived manifest entry onto disk by running
-    # the builder pipeline (template + projection + external runner).
+    # Materializes a single projection-derived manifest entry onto disk by
+    # running the builder pipeline (projection + template render). External
+    # entries are NOT materialized here — they are generated by an out-of-band
+    # runner and only staleness-tracked, so Derived#publish_via filters them out
+    # before reaching this point.
     # Extracted from Write::Build so that Publish can reuse
     # it without creating a Build dependency.
     class Materializer

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: textus
 version: !ruby/object:Gem::Version
-  version: 0.47.0
+  version: 0.47.1
 platform: ruby
 authors:
 - Patrick