Repository management: zfj repo #36

New issue

Closed

opened 2026-10-22 22:13:07 -05:00 by jeff · 1 comment

jeff commented

2026-10-22 22:13:07 -05:00

Owner

A zfj repo porcelain group for managing repositories: view, list, clone, create, fork, edit and delete. Plumbing stays as it is; zfj op repoGet and the rest already reach every repository operation.

Decisions

One group, zfj repo, in src/cli/repo.zig, built on porcelain.dispatch / Runner like issue and pr.
The repository is positional, [<owner>/<repo>], falling back to the clone's upstream/origin remote. A bare name means the authenticated user's repository for create, view and clone only. edit takes no bare name. delete takes the repository only as an argument, never from the remote. See docs/adr/0006-repo-commands-name-the-repository-positionally.md.
git is touched only when asked: --clone, --remote, or zfj repo clone itself.
Clone protocol: --protocol ssh|https per command; a per-instance default set by zfj login ... --protocol; https when neither says.
Vocabulary: Repository, Owner, Clone, Fork, Unit, in GLOSSARY.md.

Deferred

archive/unarchive (they are edit --archive), transfer, migrate and mirrors, mirror-sync, topics, generating from a template, starring, list filters (through repoSearch), showing the README in view. Each is reachable through zfj op meanwhile.

Commands

One commit per command, each with its tests and its lines in a new README "Repositories" section.

#37 view
#38 list
#39 clone, and login --protocol
#40 create
#41 fork
#42 edit
#43 delete, and confirmation

A `zfj repo` porcelain group for managing repositories: `view`, `list`, `clone`, `create`, `fork`, `edit` and `delete`. Plumbing stays as it is; `zfj op repoGet` and the rest already reach every repository operation. ## Decisions - **One group, `zfj repo`**, in `src/cli/repo.zig`, built on `porcelain.dispatch` / `Runner` like `issue` and `pr`. - **The repository is positional**, `[<owner>/<repo>]`, falling back to the clone's `upstream`/`origin` remote. A bare name means the authenticated user's repository for `create`, `view` and `clone` only. `edit` takes no bare name. `delete` takes the repository only as an argument, never from the remote. See `docs/adr/0006-repo-commands-name-the-repository-positionally.md`. - **git is touched only when asked**: `--clone`, `--remote`, or `zfj repo clone` itself. - **Clone protocol**: `--protocol ssh|https` per command; a per-instance default set by `zfj login ... --protocol`; https when neither says. - **Vocabulary**: Repository, Owner, Clone, Fork, Unit, in `GLOSSARY.md`. ## Deferred `archive`/`unarchive` (they are `edit --archive`), `transfer`, `migrate` and mirrors, `mirror-sync`, topics, generating from a template, starring, `list` filters (through `repoSearch`), showing the README in `view`. Each is reachable through `zfj op` meanwhile. ## Commands One commit per command, each with its tests and its lines in a new README "Repositories" section. - [ ] #37 view - [ ] #38 list - [ ] #39 clone, and `login --protocol` - [ ] #40 create - [ ] #41 fork - [ ] #42 edit - [ ] #43 delete, and confirmation

jeff added the

ready-for-human

label

2026-10-22 22:13:07 -05:00

jeff referenced this issue

2026-10-22 22:13:14 -05:00

Show a repository with repo view #37

jeff referenced this issue

2026-10-22 22:13:15 -05:00

List repositories with repo list #38

jeff referenced this issue

2026-10-22 22:13:16 -05:00

Clone a repository with repo clone #39

jeff referenced this issue

2026-10-22 22:13:18 -05:00

Create a repository with repo create #40

jeff referenced this issue

2026-10-22 22:13:19 -05:00

Fork a repository with repo fork #41

jeff referenced this issue

2026-10-22 22:13:20 -05:00

Change a repository with repo edit #42

jeff referenced this issue

2026-10-22 22:13:22 -05:00

Delete a repository with repo delete #43