hammerkit 1.5.0 → 1.6.0-alpha.1

package/SUMMARY.md

@@ -1,31 +1,47 @@
 # Table of contents
 
 * [About](README.md)
+* [Why hammerkit](docs/why-hammerkit.md)
 * [Installation](docs/installation.md)
 * [Getting started](docs/getting-started.md)
+* [Tutorial](docs/tutorial.md)
+* [Concepts](docs/concepts.md)
 * [Build file](docs/build-file/README.md)
   * [Environment Variables](docs/build-file/environment-variables.md)
   * [References](docs/build-file/references.md)
   * [Includes](docs/build-file/includes.md)
+  * [Caches](docs/build-file/caches.md)
+  * [Reference](docs/build-file/reference.md)
 * [Task](docs/task/README.md)
   * [Dependencies](docs/task/dependencies.md)
   * [Needs](docs/task/needs.md)
   * [Caching](docs/task/caching.md)
-  * [Container](docs/task/container.md)
+  * [Run task in a container](docs/task/container.md)
+  * [Run task on Kubernetes](docs/task/kubernetes.md)
   * [Watching](docs/task/watching.md)
   * [Extending](docs/task/extending.md)
 * [Service](docs/service/README.md)
-  * [Container](docs/service/container.md)
-  * [Kubernetes](docs/service/kubernetes.md)
-* [Labels](docs/labels/README.md) 
+  * [Container service](docs/service/container.md)
+  * [Kubernetes service](docs/service/kubernetes.md)
+* [Labels](docs/labels/README.md)
+* [Guides](docs/guides/local-vs-container.md)
+  * [Local vs container tasks](docs/guides/local-vs-container.md)
+  * [Caching strategy in CI](docs/guides/ci-caching.md)
+  * [Services & networking](docs/guides/services-networking.md)
+  * [Monorepo layout](docs/guides/monorepo.md)
+  * [Development workflow](docs/guides/development-workflow.md)
 * [CLI](docs/cli/README.md)
   * [Init](docs/cli/init.md)
   * [ls](docs/cli/ls.md)
   * [Execute](docs/cli/execute.md)
+  * [Up](docs/cli/up.md)
+  * [Down](docs/cli/down.md)
   * [Store / Restore](docs/cli/store-restore.md)
+  * [Package](docs/cli/package.md)
   * [Clean](docs/cli/clean.md)
   * [Validate](docs/cli/validate.md)
-  * [Help](docs/cli/help.md)
+* [Recipes](docs/recipes.md)
+* [FAQ & Troubleshooting](docs/faq.md)
 
 ## External Links
 
@@ -36,8 +52,17 @@
 
 * [Release 1.4.0](docs/release-blog/release-1.4.0.md)
 * [Release 1.5.0](docs/release-blog/release-1.5.0.md)
+* [Release 1.6.0](docs/release-blog/release-1.6.0.md)
+
+## Change Log
+
+* [Changelog 1.4.0](docs/change-log/change-log-1.4.0.md)
+* [Changelog 1.5.0](docs/change-log/change-log-1.5.0.md)
+* [Changelog 1.6.0](docs/change-log/change-log-1.6.0.md)
 
 ## Contribution
 
 * [Roadmap](docs/contribution/roadmap.md)
+  * [Secret managers (planned)](docs/contribution/secret-managers.md)
 * [Publishing](docs/contribution/publish.md)
+* [Self-hosted runner](docs/contribution/self-hosted-runner.md)

package/VALUES.md

@@ -0,0 +1,53 @@
+# Values
+
+This file is the canonical statement of what hammerkit optimizes for and the conventions that follow from it. Contributors and AI agents should read it before non-trivial work. Day-to-day agent operating rules live in [AGENTS.md](AGENTS.md); durable corrections live in [.agents/FEEDBACK.md](.agents/FEEDBACK.md).
+
+## Product values
+
+### Local-first
+
+Hammerkit must be usable on a developer's laptop, not only in CI. A build tool that only runs on CI is broken.
+
+### Platform-agnostic
+
+No coupling to GitHub Actions, GitLab CI, or any single provider. The same build runs anywhere a container does.
+
+### One config, many tools
+
+A single hammerkit build file replaces N tool-specific configs. Reducing config sprawl is a feature, not a side effect.
+
+### Caching reduces waste, not just time
+
+Smart, distributed caching saves compute — that matters for cost and footprint, not only build speed.
+
+## Engineering values
+
+### Stable foundation
+
+The CLI and build-file schema are contracts. Breaking them is a deliberate, versioned decision — never a refactor side effect.
+
+### Simplicity & composability
+
+Prefer small, composable pieces over clever abstractions. If two features can be one, make them one.
+
+### Pragmatic typing
+
+TS strict is on; `any` is permitted where it pulls its weight. Type purity is a means, not the goal.
+
+### Tests carry their weight
+
+Quality and coverage are non-negotiable. Slow integration tests are accepted because they buy real confidence.
+
+## Decision heuristics
+
+### Fix root causes, not symptoms
+
+A red check is fixed by repairing what's broken — not by removing, muting, or weakening the check.
+
+### Real integrations over mocks
+
+Where feasible, exercise real Docker / real registries / real Kubernetes. Mocks are a last resort, not a default.
+
+### Add nothing speculative
+
+Features, abstractions, and config knobs land when a concrete need exists — not for hypothetical futures.