@ajaykumarnpm/talea 0.5.0 → 0.7.0

package/CHANGELOG.md

@@ -4,6 +4,16 @@ 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
+- `talea pick <repo>` keeps one repo; `talea update` upgrades the CLI
+
 ## [0.5.0] - 2026-09-22
 
 ### Added

package/README.md

@@ -66,6 +66,7 @@ talea sync                   # clone the new, fast-forward the rest
 talea status                 # branch, clean/dirty, ahead/behind, in one table
 talea add some-repo          # keep one more on this machine, and clone it now
 talea select                 # reopen the checklist and change the whole list
+talea pick some-repo          # keep that one — an unknown name opens the checklist
 cd $(talea where eklavya)
 ```
 
@@ -167,7 +168,7 @@ Treat the id like a bookmark you would not paste into a public channel.
 | `talea clone` | clone only — never fetches or merges |
 | `talea adopt` | move checkouts you already have into place |
 | `talea status` | branch, clean/dirty, ahead/behind |
-| `talea select` | reopen the checklist — what this machine keeps |
+| `talea select` | reopen the checklist — `talea pick <repo>` for one |
 | `talea add` / `talea rm` | change that one repo at a time |
 | `talea where <repo>` | print a repo's path, for `cd $( )` |
 | `talea list` | the catalogue |
@@ -176,10 +177,12 @@ Treat the id like a bookmark you would not paste into a public channel.
 | `talea manifest push/pull` | move the catalogue between machines |
 | `talea skill` | install the skill that lets your coding agent drive talea |
 | `talea doctor` | check this machine can do the work |
-| `talea upgrade` | update the CLI itself |
+| `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.5.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
@@ -117,11 +117,17 @@ and nothing in talea will do it for them.
 talea add some-repo     # keep one more here, and clone it now
 talea rm some-repo      # stop keeping it — the checkout stays exactly where it is
 talea select            # reopen the whole checklist, interactively
+talea pick some-repo    # = add when the name is exact; otherwise the checklist
 ```
 
 `talea select` needs a terminal. In a non-interactive session it prints a
 summary instead of hanging, so prefer `add` and `rm` when acting on the
 developer's behalf and leave `select` as something to suggest they run.
+`pick <name>` falls back to that same checklist on a typo, so an agent uses
+`add`, which fails loudly instead.
+
+`talea update` reinstalls the CLI (it is `upgrade`), not `sync`. Never run it
+to refresh repos.
 
 `rm` does **not** delete the checkout. Say that plainly when you run it, or it
 reads like data loss.
@@ -156,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

@@ -52,7 +52,6 @@ const ALIASES = {
   setup: 'init',
   bootstrap: 'init',
   pull: 'sync',
-  update: 'sync',
   refresh: 'discover',
   pick: 'select',
   choose: 'select',
@@ -63,9 +62,28 @@ const ALIASES = {
   run: 'exec',
   skills: 'skill',
   remove: 'rm',
+  update: 'upgrade',
   '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 },
@@ -110,7 +128,7 @@ ${c.bold('Commands')}
   ${c.cyan('clone')}      clone only — never fetches or merges
   ${c.cyan('adopt')}      move repos you already have into the right place
   ${c.cyan('status')}     one table: branch, clean/dirty, ahead/behind
-  ${c.cyan('select')}     reopen the checklist — what this machine keeps
+  ${c.cyan('select')}     reopen the checklist — or ${c.dim('talea pick <repo>')} for one
   ${c.cyan('add')}        keep another repo on this machine (${c.dim('rm')} to drop one)
   ${c.cyan('where')}      print a repo's path — ${c.dim('cd $(talea where eklavya)')}
   ${c.cyan('list')}       show the catalogue
@@ -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/add.js

@@ -34,12 +34,17 @@ Options
   -j, --jobs <n>        parallel clones
 `;
 
-/** Resolve `name` or `owner/name` against the catalogue, or exit saying why. */
-export function resolve(manifest, name) {
+/** Every catalogue entry `name` or `owner/name` could mean, ignoring case. */
+export function lookup(manifest, name) {
   const wanted = String(name).toLowerCase();
-  const matches = manifest.repos.filter(
+  return manifest.repos.filter(
     (r) => r.name.toLowerCase() === wanted || `${r.owner}/${r.name}`.toLowerCase() === wanted,
   );
+}
+
+/** Resolve `name` or `owner/name` against the catalogue, or exit saying why. */
+export function resolve(manifest, name) {
+  const matches = lookup(manifest, name);
 
   if (!matches.length) {
     fail(`No repo called "${name}" in the catalogue.`);

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/select.js

@@ -9,9 +9,10 @@
 // because `clone` and `sync` ask the same question, and the cloning is
 // `clone.run`, re-entered after the new selection is on disk.
 
-import { c, fail, heading, ok, plain, skip } from '../log.js';
+import { c, fail, heading, ok, plain, skip, warn } from '../log.js';
 import { chooseRepos } from '../select.js';
 import { machineRepos, requireCatalogue, requireWorkspace } from '../workspace.js';
+import * as add from './add.js';
 import * as clone from './clone.js';
 
 export const help = `
@@ -19,6 +20,8 @@ ${c.bold('talea select')} — change what this machine keeps
 
   ${c.dim('talea select')}              reopen the checklist, then clone what is newly ticked
   ${c.dim('talea select --no-clone')}   change the list only, fill it in later
+  ${c.dim('talea pick PiDom')}          keep that one repo and clone it — or, if no repo
+                            has that name, open the checklist instead
 
 The checklist opens with the current selection ticked. Space toggles, Enter
 saves, Esc cancels and changes nothing. Everything in the catalogue is listed,
@@ -29,7 +32,10 @@ It writes ${c.dim('.talea.json')}, which never leaves this machine, so no other
 selection changes. Unticking a repo takes it off the list and leaves the
 checkout exactly where it is; deleting it is your call.
 
-For one repo, ${c.dim('talea add <repo>')} and ${c.dim('talea rm <repo>')} skip the checklist.
+A name that matches exactly one repo (case does not matter, ${c.dim('owner/name')} works)
+is ${c.dim('talea add <repo>')}. A name that matches none, or two owners' repos, opens the
+checklist, because a typo should land you in the list rather than nowhere.
+${c.dim('talea rm <repo>')} takes one off.
 
 Options
       --no-clone        save the selection, clone nothing
@@ -37,6 +43,11 @@ Options
   -j, --jobs <n>        parallel clones
 `;
 
+/** The names that do not pin down exactly one repo — empty means every one does. */
+export function unresolved(manifest, names) {
+  return names.filter((n) => add.lookup(manifest, n).length !== 1);
+}
+
 /** What changed, as two lists of names. Pure, so it can be tested. */
 export function changes(before, after) {
   const had = new Set(before);
@@ -47,7 +58,7 @@ export function changes(before, after) {
   };
 }
 
-export async function run(opts) {
+export async function run(opts, positionals = []) {
   const { root, manifest, state } = await requireWorkspace();
   requireCatalogue(manifest);
 
@@ -60,6 +71,12 @@ export async function run(opts) {
     process.exit(1);
   }
 
+  if (positionals.length) {
+    const missing = unresolved(manifest, positionals);
+    if (!missing.length) return add.run({ ...opts, removing: false }, positionals);
+    warn(`No single repo called ${missing.map((n) => `"${n}"`).join(', ')} — opening the checklist.`);
+  }
+
   const before = machineRepos(manifest, state).map((r) => r.name);
   const { repos } = await chooseRepos({ manifest, root, state, opts: { ...opts, pick: true } });
   const after = repos.map((r) => r.name);

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/commands/upgrade.js

@@ -6,6 +6,7 @@ export const help = `
 ${c.bold('talea upgrade')} — update the CLI itself
 
   ${c.dim('talea upgrade')}                    reinstall from npm at the latest version
+  ${c.dim('talea update')}                     the same thing
   ${c.dim('talea upgrade --check')}            only report whether one is available
   ${c.dim('talea upgrade --on')}               turn the daily update notice on
   ${c.dim('talea upgrade --off')}              turn the daily update notice off

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). */