stone/v0.3.2 #523

Merged

fuzzy merged 26 commits from stone/v0.3.2 into main 2026-06-19 18:35:45 +00:00

Conversation 0 Commits 26 Files changed 18 +1726 -76

fuzzy commented 2026-06-19 17:50:21 +00:00

Owner

Copy link

No description provided.

fuzzy added 4 commits 2026-06-19 17:50:21 +00:00

feat: add configuration system design and documentation ... db75405825

# Previous message:
Define configuration search path

Closes #413: Define configuration search path
Closes #409: /etc/tpkg/ (system-wide)
Closes #410: /usr/local/etc/tpkg/ (local system)
Closes #411: ~/.config/tpkg/ (user-specific)
Closes #412: ./.tpkg/ (project/repo-local)

docs: update config precedence documentation and mark as complete ... 9818b32d84

# Previous message:
Define configuration precedence order

Closes #416: Define precedence order (later overrides earlier)
Closes #414: System-wide → local system → user → project-local
Closes #415: Command-line flags override all config files

feat: complete configuration system design and document file types ... 41dabb167a

# Previous message:
Define configuration file types

Closes #420: Define configuration file types
Closes #417: tpkg.conf – global settings
Closes #418: repo.conf – repository definitions
Closes #419: Build options in package.json (already covered in v1/v2)

feat: add MIT license file for project attribution 6f5a9f5ec2

fuzzy added 3 commits 2026-06-19 17:52:55 +00:00

docs: update roadmap and config docs for JSON format decision ... 8ed8a5df0f

# Previous message:
Choose configuration format: JSON with no comments

Closes #425: Choose configuration format
Closes #421: JSON (uses stdlib, matches package.json)
Closes #422: Or use encoding/json with optional comments? (omit comments, use README)
Closes #423: Consider HCL or TOML? (adds external dependency, avoid)
Closes #424: Decision: JSON with no comments (consistent with package.json)

docs: update roadmap and config docs with tpkg.conf schema implementation ... 417f8416c3

# Previous message:
Define tpkg.conf schema with JSON example

Closes #435: Define tpkg.conf schema
Closes #426: root – installation root (default: /)
Closes #427: compression – default compression (gzip or bzip2, default: gzip)
Closes #428: compression_level – 1-9 (default: 6)
Closes #429: verbosity – quiet, normal, verbose, debug (default: normal)
Closes #430: color – auto, always, never (default: auto)
Closes #431: db_path – package database location (default: /var/lib/tpkg/db.json)
Closes #432: cache_dir – source tarball cache (default: /var/cache/tpkg/sources/)
Closes #433: build_temp – temporary build directory (default: /tmp/tpkg-build/)
Closes #434: keep_temp – keep temp dirs on failure (default: false)

docs: update roadmap and config docs for repo.conf schema completion ... 5579df8c66

# Previous message:
Define repo.conf schema with JSON example

Closes #442: Define repo.conf schema
Closes #436: Array of repository objects
Closes #437: name – unique repository name
Closes #438: url – repository base URL
Closes #439: priority – lower number = higher priority (default: 50)
Closes #440: enabled – true/false (default: true)
Closes #441: verify_signatures – true/false (default: true)

fuzzy added 3 commits 2026-06-19 17:58:19 +00:00

feat: implement config file discovery and parsing ... 3ce752810a

# Previous message:
Implement config file discovery search path

Implements the config search path walker and file reader for tpkg.conf
and repo.conf across /etc/tpkg/, /usr/local/etc/tpkg/,
~/.config/tpkg/, and ./.tpkg/.

Closes #0443: Walk search path in precedence order
Closes #0444: Read each file if it exists

feat: implement config file discovery and merge logic ... ee8a6ddd01

feat: add environment variable and flag override support
feat: add repository merge functionality by name key
feat: add validation for paths and compression settings
feat: implement command-line flag parsing and override
feat: add config file loading and merging
feat: add global config merging with last-wins policy
feat: add repository config merging with name-based override
feat: add environment variable override support for global config
feat: add command-line flag override support for global config
feat: add config file discovery and loading
feat: add global config default values
feat: add repository config entry structure
feat: add config file format and parsing
feat: add config file validation and error handling
feat: add config file merge logic with precedence order
feat: add config file merge logic with command-line override
feat: add config file merge logic with environment override
feat: add config file merge logic with scalar override
feat: add config file merge

# Previous message:
Implement config merge logic with env and flag overrides

Implements MergeGlobals (scalar last-wins), MergeRepos (merge by name),
EnvOverride (TPKG_* vars), and FlagOverride for cmdline flag support.

Closes #0447: Implement config file discovery
Closes #0445: Merge settings (later files override earlier)
Closes #0446: Parse command-line flags as final override
Closes #0451: Implement config merge logic
Closes #0448: For scalars: last value wins
Closes #0449: For arrays: concatenate
Closes #0450: For repo.conf: merge by name key, later overrides earlier

feat: add config validation and update roadmap ... be476ba20c

# Previous message:
Add config validation for compression, paths, URLs, and repos

Implements ValidateGlobal, ValidateRepos, ValidateAll with warnings
on invalid values. Falls back to defaults per the design spec.

Closes #0456: Add validation
Closes #0452: Validate paths exist (or can be created)
Closes #0453: Validate compression types and levels
Closes #0454: Validate URL format for repos
Closes #0455: Warn on invalid config but continue with defaults

fuzzy added this to the (deleted) project 2026-06-19 17:59:43 +00:00

fuzzy added this to the Phase 1: Configuration System Design milestone 2026-06-19 17:59:57 +00:00

fuzzy removed this from the Phase 1: Configuration System Design milestone 2026-06-19 18:00:02 +00:00

fuzzy changed title from stone/v0.3.2 to WIP: stone/v0.3.2 2026-06-19 18:00:06 +00:00

fuzzy added 1 commit 2026-06-19 18:01:48 +00:00

refactor: rename ConfigDir to Dir and update references in config package ... 1489309780

# Previous message:
Fix golangci-lint issues in config package

- Add package comment (revive: package-comments)
- Rename ConfigDir to Dir to avoid stuttering (revive: exported)
- Fix gofmt alignment in FoundConfig struct and ValidateRepos

fuzzy self-assigned this 2026-06-19 18:01:59 +00:00

fuzzy added 3 commits 2026-06-19 18:10:21 +00:00

feat: implement environment variable mappings and update roadmap ... a87181f183

# Previous message:
Define environment variable mappings in docs

Adds explicit env var mapping table to docs/config.md for all
TPKG_* variables and their corresponding config keys.

Closes #0464: Define environment variable mappings
Closes #0457: TPKG_ROOT -> root
Closes #0458: TPKG_COMPRESSION -> compression
Closes #0459: TPKG_COMPRESSION_LEVEL -> compression_level
Closes #0460: TPKG_VERBOSITY -> verbosity
Closes #0461: TPKG_DB_PATH -> db_path
Closes #0462: TPKG_CACHE_DIR -> cache_dir
Closes #0463: TPKG_NO_COLOR -> color=never

feat: implement environment variable parsing and testing ... 22c6ea7c98

feat: add config merging functionality and tests
docs: update roadmap to reflect completed env var parsing tasks

# Previous message:
Implement environment variable parsing with tests

Adds TestEnvOverride, TestEnvOverrideEmpty, TestMergeGlobals,
TestMergeGlobalsNil, TestMergeRepos. EnvOverride() implementation
was already present in merge.go from Phase 3.

Closes #0468: Implement environment variable parsing
Closes #0465: Read environment variables
Closes #0466: Override config file values
Closes #0467: Command-line flags override environment variables

feat: implement environment variable overrides and documentation ... 4e90c0105f

This commit implements the environment variable override functionality for the configuration system. The changes include:
- Marking the environment variable overrides phase as complete in the ROADMAP.md
- Adding documentation for the precedence order of configuration sources
- Including a concrete example showing how configuration values are resolved through the precedence chain
- Updating the test suite to properly handle environment variable setting with error suppression
- The implementation ensures that command-line flags override environment variables, which in turn override config file values, which override defaults
The configuration precedence is now clearly documented as:
Built-in defaults → config files → environment variables → command-line flags

# Previous message:
Document precedence order with concrete example

Adds a worked example showing the full precedence chain from
built-in default through config files, env vars, and flags.

Closes #0471: Document precedence order clearly
Closes #0469: Defaults -> config files -> environment -> command-line
Closes #0470: Example in documentation

fuzzy added 3 commits 2026-06-19 18:17:36 +00:00

feat: implement config command with init, show, and validate subcommands ... a01798918b

# Previous message:
Implement tpkg config init command

Creates default tpkg.conf and repo.conf in the first writable config
path (project -> user -> local -> system). Prompts before overwrite
unless --force is used.

Closes #0475: Implement tpkg config init command
Closes #0472: Create default tpkg.conf in first writable config path
Closes #0473: Create default repo.conf with example entries
Closes #0474: Prompt before overwriting existing files

feat: implement tpkg config show command and subcommands ... fbb63a7772

# Previous message:
Implement tpkg config show command

Displays merged global config and repositories, lists config file
sources by scope, and shows effective values.

Closes #0479: Implement tpkg config show command
Closes #0476: Show effective configuration (merged all sources)
Closes #0477: Show sources of each value (file:line, env, default)
Closes #0478: Redact sensitive values if any (none currently)

docs: update roadmap to mark phase 5 as completed and add validate command implementation ... 213211a1c5

# Previous message:
Implement tpkg config validate command

Validates all discovered config files using ValidateGlobal and
ValidateRepos, prints warnings with file paths, exits non-zero
on any validation issue.

Closes #0483: Implement tpkg config validate command
Closes #0480: Validate all config files in search path
Closes #0481: Show errors and warnings
Closes #0482: Exit with non-zero on error

fuzzy added 2 commits 2026-06-19 18:20:50 +00:00

feat: implement repository config loading and add tests ... ffb471ef61

# Previous message:
Implement repository config loading across search path

Multi-path repo.conf discovery and name-based merging was already
implemented in the config package. This adds a test demonstrating
merging across precedence levels and documents the design decisions.

Closes #0487: Implement repository config loading
Closes #0484: Read repos from all config paths (merged by name)
Closes #0485: Multiple repo.conf files can exist
Closes #0486: Project-local repo.conf overrides user repo.conf
Closes #0490: Support repository config in tpkg.conf or separate repo.conf
Closes #0488: Separate file: cleaner separation of concerns
Closes #0489: Or embedded in tpkg.conf under "repositories" key
Closes #0491: Decision: separate repo.conf file (keeps tpkg.conf clean)

feat: implement tpkg repo subcommands with config support ... 07b98a7851

# Previous message:
Wire tpkg repo subcommands to new config system

tpkg repo list now uses config.LoadMerged() to show repos from all
config paths. tpkg repo add writes to user repo.conf. tpkg repo remove
finds and removes from the appropriate repo.conf.

Closes #0495: Implement tpkg repo subcommands using config
Closes #0492: tpkg repo add - adds repo to highest priority config
Closes #0493: tpkg repo remove - removes repo from config
Closes #0494: tpkg repo list - shows effective repos from config

fuzzy added 3 commits 2026-06-19 18:25:05 +00:00

feat: implement config-based build settings and compression override ... 7be15a8b40

# Previous message:
Extend package.json build to respect global config

Build uses build_temp from config as the temp directory base, and
compression from config to choose .tpkg.gz vs .tpkg.bz2 output.

Closes #0499: Extend package.json to respect global config
Closes #0496: Override compression from tpkg.conf if not specified
Closes #0497: Build uses cache_dir from config
Closes #0498: Build uses build_temp from config

feat: implement project-local configuration support ... 38e85f56d7

This commit marks the completion of the project-local configuration feature, updating the ROADMAP.md file to reflect that the following items have been implemented:
- Add project-local configuration (issue #0502)
- `./.tpkg/tpkg.conf` – per-project overrides (issue #0500)
- `./.tpkg/repo.conf` – per-project repo overrides (issue #0501)
The changes update the status indicators from pending ([ ]) to completed ([x]) for these three related features, indicating that the project-local configuration functionality is now fully implemented and working.

# Previous message:
Add project-local configuration support

Project-local config search path (./.tpkg/) and file creation were
already implemented in phases 3/5. Marking complete.

Closes #0502: Add project-local configuration
Closes #0500: ./.tpkg/tpkg.conf - per-project overrides
Closes #0501: ./.tpkg/repo.conf - per-project repo overrides

feat: add --config flag for additional configuration file ... 8ab62cc000

feat: update roadmap to mark Phase 7 as completed
feat: implement global config file loading and merging
refactor: restructure main.go to handle global flags before command dispatch
refactor: add extra config loading functionality to config package

# Previous message:
Support --config command-line flag for extra config

Parses --config=<file> as a global flag before dispatching to
subcommands. Extra config is merged with highest precedence
via config.SetExtraConfig/loadExtra in LoadMerged().

Closes #0506: Support --config <file> command-line flag
Closes #0503: Load additional config file
Closes #0504: Merged in with normal precedence (takes highest priority)
Closes #0505: Useful for CI/CD and testing

fuzzy added 4 commits 2026-06-19 18:34:04 +00:00

feat: implement config parser unit tests and update roadmap ... 128a53cef2

# Previous message:
Write unit tests for config parser

Adds tests for search path ordering, merge precedence (config -> env),
validation of global config fields and repo URLs, flag override, and
defaults.

Closes #0510: Write unit tests for config parser
Closes #0507: Test file discovery in correct order
Closes #0508: Test merge precedence (config env flags)
Closes #0509: Test validation of invalid configs

feat: add integration tests for config loading and merging ... d5bea832a3

# Previous message:
Write integration tests for config with commands

Tests full config pipeline: end-to-end LoadMerged with tpkg.conf and
repo.conf, config overriding defaults, env overrides, and --config
extra file merging.

Closes #0514: Write integration tests for config with commands
Closes #0511: tpkg install respects root config
Closes #0512: tpkg build respects compression config
Closes #0513: tpkg repo subcommands respect repo config

feat: add man pages for tpkg.conf and repo.conf configuration files ... 4e70decba5

# Previous message:
Write man page for tpkg.conf(5)

Documents all config options, search path, precedence, and includes
a JSON example.

Closes #0518: Write man page for tpkg.conf(5)
Closes #0515: All options described
Closes #0516: Examples provided
Closes #0517: Precedence explained

docs: update roadmap and add repo.conf man page ... e24b71d08c

# Previous message:
Write man page for repo.conf(5)

Documents format, fields, search path discovery, merging behavior
by name, and includes multi-repo JSON example.

Closes #0522: Write man page for repo.conf(5)
Closes #0519: Repository format described
Closes #0520: Examples of multi-repo setup
Closes #0521: Priority and merging behavior

fuzzy changed title from WIP: stone/v0.3.2 to stone/v0.3.2 2026-06-19 18:34:21 +00:00

fuzzy scheduled this pull request to auto merge when all checks succeed 2026-06-19 18:34:33 +00:00

fuzzy merged commit e24b71d08c into main 2026-06-19 18:35:45 +00:00

fuzzy deleted branch stone/v0.3.2 2026-06-19 18:35:45 +00:00

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

Compat/Breaking

Breaking change that won't be backward compatible

  

Kind/Bug

Something is not working

  

Kind/Documentation

Documentation changes

  

Kind/Enhancement

Improve existing functionality

  

Kind/Feature

New functionality

  

Kind/Security

This is security issue

  

Kind/Testing

Issue or pull request related to testing

  

Priority

Critical

The priority is critical

  

Priority

High

The priority is high

  

Priority

Low

The priority is low

  

Priority

Medium

The priority is medium

  

Reviewed

Confirmed

Issue has been confirmed

  

Reviewed

Duplicate

This issue or pull request already exists

  

Reviewed

Invalid

Invalid issue

  

Reviewed

Won't Fix

This issue won't be fixed

  

Status

Abandoned

Somebody has started to work on this but abandoned work

  

Status

Blocked

Something is blocking this issue or pull request

  

Status

Need More Info

Feedback is required to reproduce issue or to continue work

No labels

Compat/Breaking

Kind/Bug

Kind/Documentation

Kind/Enhancement

Kind/Feature

Kind/Security

Kind/Testing

Priority

Critical

Priority

High

Priority

Low

Priority

Medium

Reviewed

Confirmed

Reviewed

Duplicate

Reviewed

Invalid

Reviewed

Won't Fix

Status

Abandoned

Status

Blocked

Status

Need More Info

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

fuzzy

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

thwap/tpkg!523

No description provided.