@ajaykumarnpm/talea 0.6.0 → 0.7.0

package/CHANGELOG.md

@@ -4,6 +4,11 @@ All notable changes to this project are recorded here. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the versions follow
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.0] - 2026-09-22
+
+### Added
+- a bare repo name narrows sync, clone, status, list and tree
+
 ## [0.6.0] - 2026-09-22
 
 ### Breaking

package/README.md

@@ -180,7 +180,9 @@ Treat the id like a bookmark you would not paste into a public channel.
 | `talea upgrade` | update the CLI itself (also `talea update`) |
 
 Every one of them takes `-g <group>` and `-r <repo>` to narrow the run, and
-`--help` for its own examples.
+`--help` for its own examples. For `sync`, `clone`, `status`, `list` and `tree`
+a bare name means the same as `-r`, so `talea sync eklavya` syncs that one repo.
+A command that takes no names refuses a stray word instead of ignoring it.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ajaykumarnpm/talea",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "One folder structure for every machine. Clone, adopt and sync your GitHub repos from a manifest you own.",
   "type": "module",
   "bin": {

package/skills/talea/SKILL.md

@@ -74,7 +74,7 @@ skipped, and saying so up front is better than reporting it afterwards.
 talea sync                   # clone what is missing, fast-forward what is there
 talea clone                  # clone only — never fetches or merges
 talea sync -g NonStop        # one group
-talea sync -r eklavya        # one repo
+talea sync eklavya           # one repo — same as -r eklavya
 ```
 
 `sync` is safe to run unattended. It fast-forwards **the branch you are on** and
@@ -162,8 +162,11 @@ cloned — `talea init` or `talea select` after it is what fills the tree.
 ## Narrowing any run
 
 Every command takes `-g <group>` and `-r <repo>`, both repeatable, and `--help`
-for its own examples. An unknown group or repo name **exits non-zero** rather
-than quietly doing nothing, so a typo is loud.
+for its own examples. For `sync`, `clone`, `status`, `list` and `tree` a bare
+name is the same as `-r`. `adopt` is the exception: it refuses a bare name,
+because `-r` there lifts the name-only guard and must be typed on purpose. An
+unknown group or repo name **exits non-zero** rather than quietly doing nothing,
+so a typo is loud.
 
 ## Rules
 

package/src/cli.js

@@ -66,6 +66,24 @@ const ALIASES = {
   'self-update': 'upgrade',
 };
 
+// Bare words after these commands are repo names: `talea sync PiDom` is
+// `talea sync -r PiDom`. Dropping them instead ran the command over every repo
+// on the machine, which is a typo guard failing in the worst direction.
+const TAKES_REPOS = new Set(['sync', 'clone', 'status', 'list', 'tree']);
+
+// These read their own positionals. Everything else takes none, and a stray
+// word stops the run. `adopt` is left out on purpose: an explicit -r there lifts
+// the name-only guard, and a bare word must not do that by accident.
+const TAKES_WORDS = new Set(['init', 'select', 'add', 'rm', 'manifest', 'exec', 'skill', 'where']);
+
+/** Fold a command's bare words into -r, pass them through, or refuse them. */
+export function routeWords(key, words, repo) {
+  if (!words.length || TAKES_WORDS.has(key)) return { repo, words };
+  if (TAKES_REPOS.has(key)) return { repo: [...(repo ?? []), ...words], words: [] };
+  const hint = key === 'adopt' ? `\n  To name a repo: talea adopt -r ${words.join(',')}` : '';
+  return { error: `\`${key}\` takes no arguments, got ${words.map((w) => `"${w}"`).join(' ')}.${hint}` };
+}
+
 const OPTIONS = {
   group: { type: 'string', short: 'g', multiple: true },
   repo: { type: 'string', short: 'r', multiple: true },
@@ -203,6 +221,12 @@ export async function main(argv) {
     }
   }
 
+  const routed = routeWords(key, rest, values.repo?.length ? values.repo : undefined);
+  if (routed.error) {
+    fail(routed.error);
+    process.exit(1);
+  }
+
   const opts = {
     ...values,
     jobs,
@@ -216,10 +240,10 @@ export async function main(argv) {
     // selectRepos to flatten, but normalise "not passed" to undefined.
     group: values.group?.length ? values.group : undefined,
     from: values.from?.length ? values.from : undefined,
-    repo: values.repo?.length ? values.repo : undefined,
+    repo: routed.repo,
   };
 
-  await command.run(opts, key === 'exec' ? tail : rest);
+  await command.run(opts, key === 'exec' ? tail : routed.words);
 
   // After the real work, never before it, and never able to fail it.
   if (key !== 'upgrade') {

package/src/commands/clone.js

@@ -20,7 +20,7 @@ ${c.bold('talea clone')} — clone what is missing, and nothing else
 
 Options
   -g, --group <names>   comma-separated groups
-  -r, --repo <names>    comma-separated repo names
+  -r, --repo <names>    comma-separated repo names; a bare name works too
       --pick            choose what this machine keeps before cloning
       --protocol <p>    ssh (default) or https
       --from <path>     also search here for existing checkouts (repeatable)

package/src/commands/list.js

@@ -15,7 +15,7 @@ the catalogue's opinion — what a brand new machine would start with.
 
 Options
   -g, --group <names>   comma-separated groups
-  -r, --repo <names>    comma-separated repo names
+  -r, --repo <names>    comma-separated repo names; a bare name works too
       --all             include archived and quiet repos (default: hidden)
       --groups          show groups only
       --json            emit JSON

package/src/commands/status.js

@@ -22,7 +22,7 @@ Columns
 
 Options
   -g, --group <names>   comma-separated groups
-  -r, --repo <names>    comma-separated repo names
+  -r, --repo <names>    comma-separated repo names; a bare name works too
       --drift           only repos on some other branch
       --missing         only repos not cloned yet
       --all             ignore this machine's selection

package/src/commands/sync.js

@@ -23,6 +23,7 @@ ${c.bold('talea sync')} — make this machine match the list
 
   ${c.dim('talea sync')}                      clone what is missing, fast-forward the rest
   ${c.dim('talea sync --pick')}               change what this machine keeps, then sync
+  ${c.dim('talea sync eklavya')}              only that repo (same as -r eklavya)
   ${c.dim('talea sync -g nonstopio')}         only that owner
   ${c.dim('talea sync --no-clone')}           fast-forward only, clone nothing
 
@@ -36,7 +37,7 @@ the workspace ${c.dim('talea init')} made, or asks which when this machine has s
 
 Options
   -g, --group <names>   comma-separated groups
-  -r, --repo <names>    comma-separated repo names
+  -r, --repo <names>    comma-separated repo names; a bare name works too
       --pick            re-open the checklist before syncing
       --no-clone        do not clone anything new
       --no-adopt        do not look for checkouts to move into place

package/src/commands/tree.js

@@ -24,7 +24,7 @@ their docs come from the CLI — run \`talea sync\` to drop in any that are new.
 
 Options
   -g, --group <names>   comma-separated groups
-  -r, --repo <names>    comma-separated repo names
+  -r, --repo <names>    comma-separated repo names; a bare name works too
       --all             the whole catalogue, not just what this machine keeps
 `;
 

package/src/git.js

@@ -181,7 +181,11 @@ export async function currentBranch(dir) {
   const { code, stdout } = await git(['rev-parse', '--abbrev-ref', 'HEAD'], {
     cwd: dir,
   });
-  return code === 0 ? stdout : null;
+  if (code === 0) return stdout;
+  // A repo with no commits yet has no HEAD to resolve, so rev-parse fails and
+  // the caller printed "null". symbolic-ref still knows the branch's name.
+  const born = await git(['symbolic-ref', '--short', 'HEAD'], { cwd: dir });
+  return born.code === 0 ? born.stdout : null;
 }
 
 /** True when the working tree has uncommitted changes (tracked or untracked). */