ref: rename package age to agenor (#411)

ref: rename module from agenor to jaywalk (#411)

ref: restructure repo layout (#411)

ref: rename package age to agenor (#411)

Author: plastikfan

CLAUDE.md

@@ -8,9 +8,9 @@ filtering, hibernation (deferred activation of callbacks until a condition is me
 resume from a previously interrupted session, concurrent navigation via pants worker pool,
 and hook-able traversal behaviour.
 
-- **Module**: `github.com/snivilised/agenor`
-- **Package alias**: `age` (import as `age "github.com/snivilised/agenor"`)
-- **Docs**: <https://pkg.go.dev/github.com/snivilised/agenor>
+- **Module**: `github.com/snivilised/jaywalk`
+- **Package alias**: `age` (import as `jw "github.com/snivilised/jaywalk"`)
+- **Docs**: <https://pkg.go.dev/github.com/snivilised/jaywalk>
 
 ## Build & Test Commands
 
@@ -70,10 +70,10 @@ The low-level API composes these explicitly:
 
 ```go
 // Walk/Prime
-age.Walk().Configure().Extent(age.Prime(facade, opts...)).Navigate(ctx)
+jw.Walk().Configure().Extent(jw.Prime(facade, opts...)).Navigate(ctx)
 
 // Run/Resume
-age.Run(wg).Configure().Extent(age.Resume(facade, opts...)).Navigate(ctx)
+jw.Run(wg).Configure().Extent(jw.Resume(facade, opts...)).Navigate(ctx)
 ```
 
 ### Scenario composites
@@ -92,10 +92,10 @@ lint warnings from bare literals:
 
 ```go
 const isPrime = true
-age.Tortoise(isPrime)(facade, opts...).Navigate(ctx)
+jw.Tortoise(isPrime)(facade, opts...).Navigate(ctx)
 
 var wg sync.WaitGroup
-age.Hare(isPrime, &wg)(facade, opts...).Navigate(ctx)
+jw.Hare(isPrime, &wg)(facade, opts...).Navigate(ctx)
 wg.Wait()
 ```
 
@@ -113,12 +113,12 @@ relic := &pref.Relic{...}   // resume sessions only
 
 ### Enums
 
-All enum values are in the `enums` package. Do not use `age.` prefixed aliases
+All enum values are in the `enums` package. Do not use `jw.` prefixed aliases
 for enum values - use `enums.` directly:
 
 ```go
-enums.SubscribeFiles            // not age.SubscribeFiles
-enums.MetricNoFilesInvoked      // not age.MetricNoFilesInvoked
+enums.SubscribeFiles            // not jw.SubscribeFiles
+enums.MetricNoFilesInvoked      // not jw.MetricNoFilesInvoked
 enums.ResumeStrategyFastward
 ```
 
@@ -128,27 +128,27 @@ Options are passed as variadic `...pref.Option` to `Prime`/`Resume` or to a comp
 All `With*` option constructors are re-exported from the root `age` package:
 
 ```go
-age.WithFilter(...)
-age.WithDepth(5)
-age.WithOnBegin(handler)
-age.WithCPU              // use all available CPUs for Run
-age.WithNoW(n)           // use n workers for Run
+jw.WithFilter(...)
+jw.WithDepth(5)
+jw.WithOnBegin(handler)
+jw.WithCPU              // use all available CPUs for Run
+jw.WithNoW(n)           // use n workers for Run
 ```
 
-Use `age.IfOption` / `age.IfOptionF` / `age.IfElseOptionF` for conditional options.
+Use `jw.IfOption` / `jw.IfOptionF` / `jw.IfElseOptionF` for conditional options.
 
 ## Key Types
 
 | Type | Package | Purpose |
 | --- | --- | --- |
-| `age.Node` | `core` | A file system node passed to the client callback |
-| `age.Servant` | `core` | Provides the client with traversal properties |
-| `age.Client` | `core` | The callback signature: `func(node *age.Node) error` |
-| `age.Navigator` | `core` | Returned by `Extent()`; call `.Navigate(ctx)` on it |
-| `age.Options` | `pref` | Full options struct available inside `With*` constructors |
-| `age.Using` | `pref` | Alias for `pref.Using` (Prime facade) |
-| `age.Relic` | `pref` | Alias for `pref.Relic` (Resume facade) |
-| `age.TraversalFS` | `tfs` | File system interface required for traversal |
+| `jw.Node` | `core` | A file system node passed to the client callback |
+| `jw.Servant` | `core` | Provides the client with traversal properties |
+| `jw.Client` | `core` | The callback signature: `func(node *jw.Node) error` |
+| `jw.Navigator` | `core` | Returned by `Extent()`; call `.Navigate(ctx)` on it |
+| `jw.Options` | `pref` | Full options struct available inside `With*` constructors |
+| `jw.Using` | `pref` | Alias for `pref.Using` (Prime facade) |
+| `jw.Relic` | `pref` | Alias for `pref.Relic` (Resume facade) |
+| `jw.TraversalFS` | `tfs` | File system interface required for traversal |
 
 ## Internal Packages (do not import directly)
 
@@ -163,15 +163,15 @@ Use `age.IfOption` / `age.IfOptionF` / `age.IfElseOptionF` for conditional optio
 
 ## Test Helpers
 
-- **`test/hanno`** (`github.com/snivilised/agenor/test/hanno`) - utilities for building
+- **`test/hanno`** (`github.com/snivilised/jaywalk/test/hanno`) - utilities for building
   virtual file system trees; see `GO-USER-CONFIG.md` for `Nuxx` usage
 - **`test/data/musico-index.xml`** - standard XML fixture representing a sample music
   directory tree, used by `Nuxx` to populate an in-memory file system
 - **`internal/laboratory`** - internal-only test utilities; do not use from outside the module
 
 ## i18n
 
-- Translation structs are defined in `github.com/snivilised/agenor/locale`
+- Translation structs are defined in `github.com/snivilised/jaywalk/locale`
 - Follow the i18n conventions in `GO-USER-CONFIG.md`
 
 ## File References

README.md

@@ -3,10 +3,10 @@
 [![A B](https://img.shields.io/badge/branching-commonflow-informational?style=flat)](https://commonflow.org)
 [![A B](https://img.shields.io/badge/merge-rebase-informational?style=flat)](https://git-scm.com/book/en/v2/Git-Branching-Rebasing)
 [![A B](https://img.shields.io/badge/branch%20history-linear-blue?style=flat)](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/defining-the-mergeability-of-pull-requests/managing-a-branch-protection-rule)
-[![Go Reference](https://pkg.go.dev/badge/github.com/snivilised/agenor.svg)](https://pkg.go.dev/github.com/snivilised/agenor)
-[![Go report](https://goreportcard.com/badge/github.com/snivilised/agenor)](https://goreportcard.com/report/github.com/snivilised/agenor)
+[![Go Reference](https://pkg.go.dev/badge/github.com/snivilised/jaywalk.svg)](https://pkg.go.dev/github.com/snivilised/jaywalk)
+[![Go report](https://goreportcard.com/badge/github.com/snivilised/jaywalk)](https://goreportcard.com/report/github.com/snivilised/jaywalk)
 [![Coverage Status](https://coveralls.io/repos/github/snivilised/agenor/badge.svg?branch=main)](https://coveralls.io/github/snivilised/agenor?branch=main&kill_cache=1)
-[![Astrolib Continuous Integration](https://github.com/snivilised/agenor/actions/workflows/ci-workflow.yml/badge.svg)](https://github.com/snivilised/agenor/actions/workflows/ci-workflow.yml)
+[![Astrolib Continuous Integration](https://github.com/snivilised/jaywalk/actions/workflows/ci-workflow.yml/badge.svg)](https://github.com/snivilised/jaywalk/actions/workflows/ci-workflow.yml)
 [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
 [![A B](https://img.shields.io/badge/commit-conventional-commits?style=flat)](https://www.conventionalcommits.org/)
 

cmd/jay/CLAUDE.md

@@ -4,8 +4,8 @@
 
 `jay` is a Go CLI application that acts as a companion tool to the `agenor` directory-walking library. It uses `cobra`/`mamba` for the CLI layer and `viper` for configuration management.
 
-- **Repo**: `github.com/snivilised/agenor` (`jay` lives at `cmd/jay` within it)
-- **Module**: `github.com/snivilised/agenor` (jay is the CLI frontend, located at `cmd/jay` within the agenor module)
+- **Repo**: `github.com/snivilised/jaywalk` (`jay` lives at `cmd/jay` within it)
+- **Module**: `github.com/snivilised/jaywalk` (jay is the CLI frontend, located at `cmd/jay` within the agenor module)
 - **Entry point for jay**: `./cmd/jay/main.go`
 
 ## Build & Test Commands
@@ -32,7 +32,7 @@ All flags are defined in `cmd/internal/cfg/flags.go`.
 
 ## agenor Integration
 
-`jay` uses `agenor` (`github.com/snivilised/agenor`) as its directory-walking backend. Follow these conventions:
+`jay` uses `agenor` (`github.com/snivilised/jaywalk`) as its directory-walking backend. Follow these conventions:
 
 - Construct facades as named variables before passing to `Tortoise`/`Hare` - never inline:
 
@@ -53,7 +53,7 @@ All flags are defined in `cmd/internal/cfg/flags.go`.
 
 ## i18n
 
-- Translation structs are defined in `github.com/snivilised/agenor/locale`
+- Translation structs are defined in `github.com/snivilised/jaywalk/locale`
 - Follow the i18n conventions in `GO-USER-CONFIG.md`; locale struct placement is per the package above
 
 ## File References

cmd/jay/main.go

@@ -1,7 +1,7 @@
 package main
 
 import (
-	"github.com/snivilised/agenor/cmd/command"
+	"github.com/snivilised/jaywalk/src/app/command"
 )
 
 func main() {

go.mod

@@ -1,4 +1,4 @@
-module github.com/snivilised/agenor
+module github.com/snivilised/jaywalk
 
 go 1.26.0
 

locale/locale-defs.go

@@ -3,7 +3,7 @@ package locale
 const (
 	// SourceID defines the ID (by convention the repo URL) required
 	// for i18n translation purposes.
-	SourceID = "github.com/snivilised/agenor"
+	SourceID = "github.com/snivilised/jaywalk/src/agenor"
 )
 
 type agenorTemplData struct{}

locale/messages-errors_test.go

@@ -8,8 +8,8 @@ import (
 	. "github.com/onsi/ginkgo/v2"
 	. "github.com/onsi/gomega"
 
-	"github.com/snivilised/agenor/locale"
-	"github.com/snivilised/agenor/test/hanno"
+	"github.com/snivilised/jaywalk/locale"
+	"github.com/snivilised/jaywalk/src/agenor/test/hanno"
 	"github.com/snivilised/li18ngo"
 )
 

scripts/coverage-exclusion-list.txt

@@ -1,7 +1,7 @@
-github.com/snivilised/agenor/enums
-github.com/snivilised/agenor/internal/filtering/constant.go
-github.com/snivilised/agenor/internal/third
-github.com/snivilised/agenor/internal/laboratory
-github.com/snivilised/agenor/test/hanno
-github.com/snivilised/agenor/test/hydra
-github.com/snivilised/agenor/test/cmd
+github.com/snivilised/jaywalk/enums
+github.com/snivilised/jaywalk/internal/filtering/constant.go
+github.com/snivilised/jaywalk/internal/third
+github.com/snivilised/jaywalk/internal/laboratory
+github.com/snivilised/jaywalk/test/hanno
+github.com/snivilised/jaywalk/test/hydra
+github.com/snivilised/jaywalk/test/cmd

builders.go src/agenor/builders.gobuilders.go renamed to src/agenor/builders.go

@@ -1,11 +1,11 @@
-package age
+package agenor
 
 import (
-	"github.com/snivilised/agenor/enums"
-	"github.com/snivilised/agenor/internal/enclave"
-	"github.com/snivilised/agenor/internal/kernel"
-	"github.com/snivilised/agenor/internal/third/lo"
-	"github.com/snivilised/agenor/pref"
+	"github.com/snivilised/jaywalk/src/agenor/enums"
+	"github.com/snivilised/jaywalk/src/agenor/internal/enclave"
+	"github.com/snivilised/jaywalk/src/agenor/internal/kernel"
+	"github.com/snivilised/jaywalk/src/internal/third/lo"
+	"github.com/snivilised/jaywalk/src/agenor/pref"
 )
 
 type buildArtefacts struct {