@sous-io/sous 1.0.14 → 1.0.15

package/docs/markdown/commands.md

@@ -40,8 +40,10 @@ already exists.
 - `--timings` prints how long each step of the run took.
 - `--json`, on the commands that print a listing or a report, prints it as JSON instead.
 
-Sous warns on standard error when a step takes longer than its time budget, so the warning never mixes with
-`--json` output. The `budgets` config key changes a budget, and `false` turns its warning off.
+Sous reports, at the `debug` level, when a step takes longer than its time budget, so the report shows only
+with `--debug` or `--log-level debug`. It goes to standard error, so it never mixes with `--json` output. Time
+spent waiting for you to answer a question does not count. The `budgets` config key changes a budget, and
+`false` turns its report off.
 
 `sous --version` prints the version (`v1.2.3`); add `--verbose` for where it is installed, the platform and
 the Node build.

package/docs/markdown/configuration.md

@@ -163,8 +163,9 @@ Two more keys settle what plugins do:
   the same one stops sous with an error until you choose one:
   `"services": { "replace": { "git.runner": "sous-plugin-fast-git" } }`. Sous then warns on every
   run that the other plugin may not work as expected.
-- `budgets` changes how long a step may take before sous warns that it is slow; a budget set to
-  `false` turns that warning off. `--timings` on any command prints how long every step took.
+- `budgets` changes how long a step may take before sous reports that it is slow (at the `debug`
+  level, so only with `--debug`); a budget set to `false` turns that report off. `--timings` on any
+  command prints how long every step took.
 
 `sous plugins show` lists every plugin and what it adds. Recipes may ship plugins too; see
 [where plugins come from](architecture/specifications/S1-engine.md#where-plugins-come-from).

package/docs/markdown/repositories-authoring.md

@@ -276,6 +276,11 @@ says which one to keep. `--ci` implies `--no-bump` and `--yes`, accepting the pl
 but it deliberately does not imply `--push`, so what a workflow pushes stays visible in the workflow file. Under
 either, a recipe whose files changed without a bump is an error naming its manifest and the colliding tag.
 
+`--push` pushes the branch to `origin`, plus every release tag that `sous.index.json` publishes, that this checkout
+holds and that `origin` lacks. That includes tags an earlier run cut without `--push`, so the pushed index never
+names a tag subscribers cannot fetch. The tags go first, then the branch. A `--push` run with nothing new to
+release still pushes them, which is how to send a release you made without `--push`.
+
 ### The branch rule
 
 The default branch is whatever `origin/HEAD` points at. On any other branch a release bumps and commits but cuts

package/docs/markdown/repositories-providers.md

@@ -183,6 +183,7 @@ Error: could not read gitlab.com/acme/private-recipes.
 Fix one of these:
   export GITLAB_TOKEN=<a token with read_repository>
   set up git access to gitlab.com (an SSH key, or a credential helper)
+A token reads only the index. Recipe files are downloaded with git, so building also needs git access.
 ```
 
 **A recipe's files** come from git itself: a shallow, blobless, sparse clone at the version's

package/docs/markdown/repositories-troubleshooting.md

@@ -341,10 +341,13 @@ Error: could not read gitlab.com/acme/private-recipes.
 Fix one of these:
   export GITLAB_TOKEN=<a token with read_repository>
   set up git access to gitlab.com (an SSH key, or a credential helper)
+A token reads only the index. Recipe files are downloaded with git, so building also needs git access.
 ```
 
-Sous tried every way it has to read the repository, and each line says why that one failed. Any one fix
-is enough: a token in the environment, or git access to the host. `gh` and `glab` are not needed to read.
+Sous tried every way it has to read the repository's index, and each line says why that one failed. Any
+one fix lets sous read the index. Recipe files are a different matter: sous downloads them with git alone,
+so a build needs git access to the host (an SSH key, or a credential helper) even when a token is set. A
+token in the environment only makes reading the index faster. `gh` and `glab` are not needed to read.
 The order sous tries, and where it finds a token, are under
 [Private repositories](repositories-providers.md#private-repositories).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sous-io/sous",
-  "version": "1.0.14",
+  "version": "1.0.15",
   "description": "Compiles AI coding agent configuration (CLAUDE.md, skills, memories) from LiquidJS templates",
   "type": "module",
   "license": "Apache-2.0",
@@ -39,44 +39,44 @@
     "sous.config.schema.json"
   ],
   "dependencies": {
-    "@sous-io/plugin-api": "1.0.14"
+    "@sous-io/plugin-api": "1.0.15"
   },
   "devDependencies": {
     "esbuild": "^0.27.4",
     "jsonc-parser": "^3.3.1",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@sous-io/core": "1.0.14",
-    "@sous-io/documents": "1.0.14",
-    "@sous-io/plugin-build": "1.0.14",
-    "@sous-io/plugin-claude-code": "1.0.14",
-    "@sous-io/plugin-authoring": "1.0.14",
-    "@sous-io/plugin-cli": "1.0.14",
-    "@sous-io/plugin-compiler": "1.0.14",
-    "@sous-io/plugin-config-files": "1.0.14",
-    "@sous-io/plugin-formats": "1.0.14",
-    "@sous-io/plugin-expressions": "1.0.14",
-    "@sous-io/plugin-confd": "1.0.14",
-    "@sous-io/plugin-git": "1.0.14",
-    "@sous-io/plugin-github": "1.0.14",
-    "@sous-io/plugin-harnesses": "1.0.14",
-    "@sous-io/plugin-init": "1.0.14",
-    "@sous-io/plugin-host": "1.0.14",
-    "@sous-io/plugin-inspect": "1.0.14",
-    "@sous-io/plugin-gitlab": "1.0.14",
-    "@sous-io/plugin-local": "1.0.14",
-    "@sous-io/plugin-liquid": "1.0.14",
-    "@sous-io/plugin-mcp": "1.0.14",
-    "@sous-io/plugin-memories": "1.0.14",
-    "@sous-io/plugin-pnpm": "1.0.14",
-    "@sous-io/plugin-recipe-answers": "1.0.14",
-    "@sous-io/plugin-npm": "1.0.14",
-    "@sous-io/plugin-recipes": "1.0.14",
-    "@sous-io/plugin-skills": "1.0.14",
-    "@sous-io/plugin-update": "1.0.14",
-    "@sous-io/plugin-variables": "1.0.14",
-    "@sous-io/plugin-refs": "1.0.14",
-    "@sous-io/plugin-yarn": "1.0.14"
+    "@sous-io/core": "1.0.15",
+    "@sous-io/documents": "1.0.15",
+    "@sous-io/plugin-authoring": "1.0.15",
+    "@sous-io/plugin-claude-code": "1.0.15",
+    "@sous-io/plugin-cli": "1.0.15",
+    "@sous-io/plugin-confd": "1.0.15",
+    "@sous-io/plugin-config-files": "1.0.15",
+    "@sous-io/plugin-expressions": "1.0.15",
+    "@sous-io/plugin-formats": "1.0.15",
+    "@sous-io/plugin-git": "1.0.15",
+    "@sous-io/plugin-github": "1.0.15",
+    "@sous-io/plugin-gitlab": "1.0.15",
+    "@sous-io/plugin-build": "1.0.15",
+    "@sous-io/plugin-harnesses": "1.0.15",
+    "@sous-io/plugin-compiler": "1.0.15",
+    "@sous-io/plugin-host": "1.0.15",
+    "@sous-io/plugin-inspect": "1.0.15",
+    "@sous-io/plugin-liquid": "1.0.15",
+    "@sous-io/plugin-init": "1.0.15",
+    "@sous-io/plugin-mcp": "1.0.15",
+    "@sous-io/plugin-local": "1.0.15",
+    "@sous-io/plugin-memories": "1.0.15",
+    "@sous-io/plugin-npm": "1.0.15",
+    "@sous-io/plugin-pnpm": "1.0.15",
+    "@sous-io/plugin-recipe-answers": "1.0.15",
+    "@sous-io/plugin-refs": "1.0.15",
+    "@sous-io/plugin-yarn": "1.0.15",
+    "@sous-io/plugin-update": "1.0.15",
+    "@sous-io/plugin-skills": "1.0.15",
+    "@sous-io/plugin-variables": "1.0.15",
+    "@sous-io/plugin-recipes": "1.0.15"
   },
   "engines": {
     "node": ">=22"

package/recipes/core/sous-skills/sous.recipe.yaml

@@ -11,7 +11,7 @@ formatVersion: 1
 
 namespace: core
 name: sous-skills
-version: 1.0.14
+version: 1.0.15
 
 description: >-
   The skills that teach an agent what sous is and how it works: which files sous