the_local 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46515a04fbebe5b7f0b5bbd09fb5ac194b013e7cb08a10445849b0a3954b593a
-  data.tar.gz: 1840cb121e1d6c8cd0e458d945396d29c620db62f391c15836e1130a686fa682
+  metadata.gz: 16bc7ddfcc1ddab88976b10b156791a4e9a1985265d472517db9c56816d8022e
+  data.tar.gz: 57c2ec4821bd1165037311dad0720cbcf1a753770052e0f88ae5a879f4e8c2f7
 SHA512:
-  metadata.gz: ff8308ecbcc6adab431e1148f0a87a082de8e0a7441b390f4766886facda382fa0416f01a0b248340d8fb4eff4dd55aa2b794b82e249d49d52ea3b137f91dd98
-  data.tar.gz: a1e570c7f1a4341e61dfbf35805762bf6d7a1bdb1ad0175bce502603e3e35404b901ec3ef320acefa1a0765ba8aa20e917e36ddee93d880cd0f9bcfc1cbd06b7
+  metadata.gz: bf6c8dfab319c69dd82da9654cee64085c0aca38253ad29bdd37794887ff8b35136c5c1f5288e4beab1688d767b4f7f53f02ca115c7d0abcc40b3d34eeac2e2f
+  data.tar.gz: 33a1549f7efedbcf20f3350f0c38224f03acf2865de2b7524037ba4c13889bf65b0ff75c2eff1d47a0ac6a0b4b57bdf57efcff4bd17b91a8c6a5bd1748258b8c

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 ## [Unreleased]
 
+## [0.3.0] - 2026-07-01
+
+- Installing no longer writes a `develop_process_rules.md` into host apps. The
+  `ProcessDocWriter`/`ProcessRules` machinery and its bundled doc are removed, so
+  `Sync`/`refresh` only install locals and the delegation trigger — a gem's
+  process conventions belong in its own guide, not propagated as a shared file.
+- A gem no longer installs its own locals into its own repo: `refresh` excludes
+  the gem being run from the direct-dependency set, so a provider working on
+  itself doesn't copy its locals back into `.claude/agents/`.
+
 ## [0.2.0] - 2026-06-20
 
 - `rake the_local:build` now refuses a guide that still holds line-leading

data/lib/the_local/refresh.rb

@@ -16,7 +16,7 @@ module TheLocal
       Sync.new(
         registry: TheLocal.registry,
         destination: destination,
-        direct_dependencies: definition.dependencies.map(&:name),
+        direct_dependencies: definition.dependencies.map(&:name) - [own_gem_name(definition, destination)],
         bundled_gems: definition.specs.map(&:name)
       ).call
     end
@@ -24,5 +24,10 @@ module TheLocal
     def self.specs_from(definition)
       definition.specs.map { |spec| { name: spec.name, path: spec.full_gem_path } }
     end
+
+    def self.own_gem_name(definition, destination)
+      here = File.expand_path(destination)
+      definition.specs.find { |spec| File.expand_path(spec.full_gem_path) == here }&.name
+    end
   end
 end

data/lib/the_local/sync.rb

@@ -21,7 +21,6 @@ module TheLocal
       )
       Installer.new(registry: @registry, destination: @destination, allowed_gems: allowed).call
       TriggerWriter.new(registry: @registry, destination: @destination, allowed_gems: allowed).call
-      ProcessDocWriter.new(destination: @destination).call
       allowed
     end
   end

data/lib/the_local/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TheLocal
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

data/lib/the_local.rb

@@ -5,7 +5,6 @@ require_relative "the_local/agent"
 require_relative "the_local/registry"
 require_relative "the_local/installer"
 require_relative "the_local/trigger_writer"
-require_relative "the_local/process_doc_writer"
 require_relative "the_local/scope"
 require_relative "the_local/sync"
 require_relative "the_local/refresh"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: the_local
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - tylercschneider
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-22 00:00:00.000000000 Z
+date: 2026-07-02 00:00:00.000000000 Z
 dependencies: []
 description: the_local lets any gem or app declare Claude Code subagents ("locals")
   that know its conventions, and installs the aggregated set from every installed
@@ -38,9 +38,6 @@ files:
 - lib/the_local/cli.rb
 - lib/the_local/disk_providers.rb
 - lib/the_local/installer.rb
-- lib/the_local/process_doc_writer.rb
-- lib/the_local/process_rules.rb
-- lib/the_local/process_rules/develop_process_rules.md
 - lib/the_local/railtie.rb
 - lib/the_local/rake.rb
 - lib/the_local/reference.rb

data/lib/the_local/process_doc_writer.rb

@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "process_rules"
-
-module TheLocal
-  # Writes the canonical develop-process rules into a host's CLAUDE.md as a
-  # managed block, read at the start of every session so the host agent always
-  # follows one source of truth. Re-propagated on every install/refresh. Uses
-  # its own markers so it coexists with the delegation trigger in the same file.
-  class ProcessDocWriter
-    BEGIN_MARKER = "<!-- the_local:process:begin -->"
-    END_MARKER = "<!-- the_local:process:end -->"
-    RULES_FILENAME = "develop_process_rules.md"
-
-    def initialize(destination:, filename: "CLAUDE.md")
-      @destination = destination
-      @filename = filename
-    end
-
-    def call
-      File.write(File.join(@destination, RULES_FILENAME), "#{ProcessRules.content}\n")
-      path = File.join(@destination, @filename)
-      existing = File.exist?(path) ? File.read(path) : ""
-      File.write(path, "#{merge(existing)}\n")
-    end
-
-    def block
-      <<~MARKDOWN.chomp
-        #{BEGIN_MARKER}
-        Read and follow this develop process for all work in this project. It is
-        also written verbatim to `#{RULES_FILENAME}` — reference that file directly.
-
-        #{ProcessRules.content}
-        #{END_MARKER}
-      MARKDOWN
-    end
-
-    private
-
-    def merge(existing)
-      section = /#{Regexp.escape(BEGIN_MARKER)}.*?#{Regexp.escape(END_MARKER)}/m
-      return existing.sub(section, block) if existing.match?(section)
-      return block if existing.strip.empty?
-
-      "#{existing.chomp}\n\n#{block}"
-    end
-  end
-end

data/lib/the_local/process_rules/develop_process_rules.md

@@ -1,97 +0,0 @@
-# Develop Process
-
-The standard process for writing code across all projects. Default to these rules
-unless a project explicitly overrides them.
-
----
-
-## Diverging from this process
-
-Read this process before starting work and follow it — it is the default for
-every session. If a task genuinely calls for breaking one of these rules, do not
-silently deviate: **PAUSE and ask for a one-time exception**, naming the rule and
-why it should be set aside here. An exception is granted for that instance only —
-it needs no doc or notes update — and then you continue. Do not treat a granted
-exception as a standing change to the process.
-
----
-
-## Test-Driven Development
-
-TDD is the default for everything. Work one tiny cycle at a time:
-
-1. **Write one test that asserts one thing.**
-2. **Run it and watch it fail** — for the right reason. A test you never saw fail
-   proves nothing.
-3. **Write the minimum code to make it pass.**
-4. **Run the test and watch it pass.**
-5. **Commit.**
-6. Repeat with the next test.
-
-One assertion per test. One test per commit cycle. No batching multiple behaviors
-into a single test or a single commit.
-
----
-
-## Commits
-
-- A commit is normally **two files: the test file and the code file.**
-- When implementing or updating an interface (e.g. a new controller endpoint) a
-  commit may touch more files (route + controller + view) — that is the minimal
-  coherent unit for that interface, and it is allowed.
-- Keep each commit focused on the one behavior the test describes.
-
----
-
-## What to Test
-
-- **Test our own code only.**
-- **Never test third-party code** — not a gem, not an API, not a framework. The
-  only test that may reference a dependency is one that asserts *our system is
-  correctly wired to it* (the integration seam), never the dependency's own
-  behavior.
-- **Never test another interface inside a unit test.** A test covers one interface.
-  The single exception is the smoke integration test described below.
-
----
-
-## Smoke Integration Test
-
-When implementing an interface, write **one smoke integration test** that exercises
-the interface end to end and proves the pieces are connected. This is the one place
-where touching more than the unit under test is expected and correct.
-
----
-
-## Pull Requests
-
-- **Always work on a feature branch and open a PR.** Confirm the target branch
-  before any git operation (`git branch --show-current`).
-- **Keep PRs small and manageable** — typically **no more than 8–10 files.**
-- Keep the focus of a PR narrow. One concern per PR.
-- **All tests pass before opening the PR.**
-- **The linter and every other CI check pass before opening the PR.**
-- Never start a new PR until the previous one is merged.
-
----
-
-## Code Quality
-
-- Follow Clean Code principles: small functions, clear names, no surprises.
-- Follow SOLID principles. Readable by a human first.
-- Keep it simple — no abstraction until a real need calls for it.
-- Explicitly require libraries rather than assuming autoload.
-
-## Comments
-
-- **Write self-documenting code, not comments.** Code should be clean and readable
-  on its own. Names — of classes, methods, variables, and partials — carry the intent.
-- **A comment is a smell.** If you feel a comment is needed, the code is either built
-  wrong or needs refactoring (a clearer name, a smaller method, an extracted object or
-  partial) so the intent is obvious without prose. Follow SOLID and this resolves itself.
-- Do not leave explanatory headers on classes/methods, inline "what this does" notes,
-  or section banners. Delete them and let the structure speak.
-- Narrow exceptions, kept rare: a genuinely non-obvious *why* (a workaround for an
-  external bug, a legal/security constraint) and machine-readable annotations the
-  tooling requires (e.g. `rubocop:disable`). Prefer refactoring over a "why" comment
-  whenever you can.

data/lib/the_local/process_rules.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-module TheLocal
-  # Loads the canonical develop-process rules the_local propagates into every
-  # host, so a host agent reads and follows one source of truth.
-  module ProcessRules
-    DIR = File.expand_path("process_rules", __dir__)
-
-    def self.content
-      read("develop_process_rules.md")
-    end
-
-    def self.read(name)
-      File.read(File.join(DIR, name)).chomp
-    end
-  end
-end