@sous-io/sous 1.0.15 → 1.0.16

package/docs/markdown/repositories-consuming.md

@@ -376,20 +376,27 @@ there is no entry to delete: the one sous provides comes back on the next run, s
 opt-out outlives it. `sous subscription add core` clears it again. If you remove `core`, make sure
 something else tells your agents not to edit generated files.
 
-## Switch a subscription off on one machine
+## Switch a subscription off
 
 A subscription stays in the config with `enabled: false`, so the opt-out is visible. A switched-off
 subscription is not built: the recipes reached only through it are skipped, the outputs they wrote are
 pruned, and their variables are neither asked nor required. Their pins stay in the committed lockfile,
-so switching a recipe off on your machine never removes it for anyone else.
+so a machine that switches a recipe off never removes it from the lockfile for anyone else.
 
 ```bash
 sous subscription disable tool-usage/automated-browser-tasks
 sous subscription enable tool-usage/automated-browser-tasks
 ```
 
-Both edit `.sous/conf.d/510-subscriptions.jsonc` by key. To switch one off only on some machines, write
-`enabled` in a `conf.d` file of your own that sorts after 510; a later file wins over the managed one:
+Both edit `.sous/conf.d/510-subscriptions.jsonc` by key. That file is committed, so once the change is
+committed the subscription is switched off, or back on, for **everyone** using the project. `disable`
+writes `"enabled": false`; `enable` removes it again, so the file goes back to what it held before.
+
+### On one machine only
+
+To switch one off only on some machines, write `enabled` in a `conf.d` file of your own that sorts
+after 510, and keep that file out of git if it is for your machine alone; a later file wins over the
+managed one:
 
 ```jsonc
 // .sous/conf.d/610-mac.jsonc
@@ -442,7 +449,9 @@ rather than stopping the build, and the build prints a warning naming it before
 A build holds the versions the lockfile pins and does not talk to the network on every run. Sous
 asks a repository for a newer index only when it has never asked, when the freshness window has
 lapsed (`store.freshnessSeconds`, five minutes by default), or when a command forces it; a failed
-check never breaks a build, because the cached index is used instead. Always-pull changes what
+check never breaks a build, because the cached index is used instead. When a recipe or a version
+is missing from the cached index, sous asks upstream once more before reporting it, so a recipe
+released moments ago is found straight away. Always-pull changes what
 happens after that check, not how often it happens: a repository or subscription marked
 `alwaysPull` takes a newer in-range version rather than the locked one; set it with
 `--always-pull`, or on either entry in the config. Without it, `sous subscription update` is how a

package/docs/markdown/repositories-file-formats.md

@@ -478,7 +478,7 @@ old `.json` name is read as a fallback and migrates on the next write: the `.jso
 
 No file is special to sous when it reads the config: a `conf.d` file of your own that sorts after 510 can
 override a subscription the managed file lists, such as switching it off on one machine (see
-[Switch a subscription off on one machine](repositories-consuming.md#switch-a-subscription-off-on-one-machine)).
+[On one machine only](repositories-consuming.md#on-one-machine-only)).
 
 ## Where to go next
 

package/docs/markdown/repositories-providers.md

@@ -161,6 +161,13 @@ https://raw.githubusercontent.com/<owner>/<name>/HEAD/sous.index.json
 https://<gitlab host>/api/v4/projects/<owner>%2F<name>/repository/files/sous.index.json/raw?ref=HEAD
 ```
 
+GitHub's raw host can answer with a copy it cached for up to five minutes. When sous must see the
+current index (a `--latest` read, or a recipe missing from its cached copy, which is how a recipe
+released moments ago looks), it reads GitHub's contents API without a token instead
+(`https://api.github.com/repos/<owner>/<name>/contents/sous.index.json`), and tries the raw host only
+if nothing else answers. GitHub allows 60 such requests an hour from one address, so ordinary reads
+never use it. GitLab's API always answers with the current file.
+
 A token is looked for in these places, in this order, and a missing one is skipped:
 
 1. the environment: `GITHUB_TOKEN` for GitHub, `GITLAB_TOKEN` for GitLab;

package/docs/markdown/repositories-troubleshooting.md

@@ -9,11 +9,17 @@ lines under the first sentence of a failure, because that is where the remedy is
 ## A repository this project does not trust
 
 ```text
-Error: No added repository publishes the recipe 'workflow/nope'.
-  Repositories searched: qa-recipes, sous-recipes.
-  Add the repository that publishes it with 'sous repo add <url>', then try again.
+Error: None of this project's repositories publishes the recipe 'workflow/nope'.
+  Checked just now: qa-recipes, sous-recipes.
+  Check the spelling, or run 'sous repo search nope' to look for it. If a repository this project
+    has not added publishes it, add that one with 'sous repo add <url>'.
 ```
 
+Before sous reports this, it reads every added repository's index upstream once, so a recipe
+released moments ago is found rather than reported missing. A repository it could not reach just
+then is listed under `Could not be checked just now`, and only the copy of its index that sous
+already had was searched.
+
 A browsing command given a qualified ref whose qualifier is unknown says `This project trusts no
 repository called 'acme'`; a subscribe says `Sous does not know where the repository 'acme' lives,
 so it cannot add it for you`, and prints the `sous repo add <url> --name acme` line to run. Either

package/docs/markdown/repositories.md

@@ -205,7 +205,8 @@ plugin included, until the repository is trusted.
 A subscription can be switched off on one machine and left on for everyone else, for example from
 a `conf.d` file of your own. A switched-off subscription is not built: its outputs are pruned, its
 variables are not asked, and its pins stay in the committed lockfile. `sous subscription disable <ref>`
-and `sous subscription enable <ref>` switch one off and on.
+and `sous subscription enable <ref>` switch one off and on for everyone, because they edit the
+committed `conf.d/510-subscriptions.jsonc`.
 
 ## The official repository, and the built-in core
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sous-io/sous",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "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.15"
+    "@sous-io/plugin-api": "1.0.16"
   },
   "devDependencies": {
     "esbuild": "^0.27.4",
     "jsonc-parser": "^3.3.1",
     "yaml": "^2.9.0",
     "zod": "^4.4.3",
-    "@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"
+    "@sous-io/core": "1.0.16",
+    "@sous-io/plugin-authoring": "1.0.16",
+    "@sous-io/plugin-build": "1.0.16",
+    "@sous-io/documents": "1.0.16",
+    "@sous-io/plugin-claude-code": "1.0.16",
+    "@sous-io/plugin-cli": "1.0.16",
+    "@sous-io/plugin-compiler": "1.0.16",
+    "@sous-io/plugin-confd": "1.0.16",
+    "@sous-io/plugin-formats": "1.0.16",
+    "@sous-io/plugin-expressions": "1.0.16",
+    "@sous-io/plugin-config-files": "1.0.16",
+    "@sous-io/plugin-git": "1.0.16",
+    "@sous-io/plugin-gitlab": "1.0.16",
+    "@sous-io/plugin-harnesses": "1.0.16",
+    "@sous-io/plugin-github": "1.0.16",
+    "@sous-io/plugin-host": "1.0.16",
+    "@sous-io/plugin-inspect": "1.0.16",
+    "@sous-io/plugin-liquid": "1.0.16",
+    "@sous-io/plugin-init": "1.0.16",
+    "@sous-io/plugin-local": "1.0.16",
+    "@sous-io/plugin-mcp": "1.0.16",
+    "@sous-io/plugin-memories": "1.0.16",
+    "@sous-io/plugin-npm": "1.0.16",
+    "@sous-io/plugin-recipe-answers": "1.0.16",
+    "@sous-io/plugin-pnpm": "1.0.16",
+    "@sous-io/plugin-recipes": "1.0.16",
+    "@sous-io/plugin-refs": "1.0.16",
+    "@sous-io/plugin-skills": "1.0.16",
+    "@sous-io/plugin-update": "1.0.16",
+    "@sous-io/plugin-variables": "1.0.16",
+    "@sous-io/plugin-yarn": "1.0.16"
   },
   "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.15
+version: 1.0.16
 
 description: >-
   The skills that teach an agent what sous is and how it works: which files sous