091dceec1d
An issue was a Gitea row that happened to be cached locally: its identity was the tracker's number (42.md), its dependencies were tracker numbers (depends: [#12]), and a local issue existed only as a draft that push deleted on success. Nothing could be planned or tracked without a tracker. Split into layers, with knowledge flowing one way: skills/issue DOMAIN what an issue is: format, validation, dep graph ^ offline; stdlib imports only, no subprocess | imports skills/sync BRIDGE map.py md <-> Gitea JSON, pure, no I/O _gitea.py login pin, api, pagination, filters skills/use REFERENCE tea CLI docs for non-issue entities skills/issue never imports skills/sync. Delete the sync layer and the domain keeps working. Identity is now a slug derived from the title (wire-sqlc-appclick.md) and is stable across retitles and pushes. Tracker numbers live in a `gitea:` field, never in a file name and never in `depends:`; the pair is indexed in .remote.json, which is a cache over the files, not a second source of truth. Behavior changes: - Pushing is additive. The file is never deleted; it gains gitea:/url:/ synced: and origin: flips from local to gitea. `origin: local` is a durable state, not a pending one. - Pushes go in topological order so dependencies get numbers first. - The dependency graph is computed offline from `depends:` metadata; body prose is passed through unchanged in both directions rather than being rewritten between slugs and #N. - `origin` is domain-owned (whether work exists elsewhere is a fact about the work); the handle and how to reach it stay with sync. Script moves: issue_get.py -> sync/pull.py issue_push.py -> sync/push.py issue_list.py -> sync/remote.py issue_index.py -> issue/issue_index.py _tea.py -> split into issue/issue.py, sync/map.py, sync/_gitea.py New: issue/issue_new.py, issue/issue_check.py, issue/issue_tree.py, and sync/comment.py — comment posting was the last issue operation still hand-rolled through raw `tea api`. references/issue-format.md moves to skills/issue/references/format.md; label hex colors move out of it into map.py, since a color is how a tracker paints a chip, not what an issue is. Verified: offline path end to end (new, check, tree, index, push --dry-run) and read-only against Gitea (remote listing, pull with mapping, comment guard). Write paths of push.py and comment.py are not exercised here. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
69 lines
2.7 KiB
Python
69 lines
2.7 KiB
Python
#!/usr/bin/env python3
|
|
"""
|
|
remote.py — what exists in Gitea, one line each.
|
|
|
|
Discovery only: prints to stdout and writes nothing. The local store is a
|
|
store, not a search-results folder, so a listing never lands in it. Pick the
|
|
numbers here, then pull them.
|
|
|
|
#42 open type/task, tech/sql Wire sqlc into the repo layer
|
|
└─ local: wire-sqlc-appclick
|
|
|
|
The second line appears when the issue is already in the local store, so it is
|
|
obvious what a pull would refresh versus what it would add.
|
|
|
|
Usage:
|
|
remote.py [--state open|closed|all] [--label L]… [-q TEXT]
|
|
[--milestone M] [--limit N] [--repo owner/repo]
|
|
|
|
Login: the operator's pin from .claude/settings.local.json (see /tea:auth).
|
|
"""
|
|
import argparse
|
|
import os
|
|
import sys
|
|
|
|
_HERE = os.path.dirname(os.path.abspath(__file__))
|
|
sys.path[:0] = [_HERE, os.path.normpath(os.path.join(_HERE, "..", "..", "issue", "scripts"))]
|
|
|
|
import _gitea # noqa: E402
|
|
import issue # noqa: E402
|
|
import map as gmap # noqa: E402
|
|
|
|
|
|
def main():
|
|
ap = argparse.ArgumentParser(description="List Gitea issues (stdout only, no files)")
|
|
ap.add_argument("--state", default="open", choices=["open", "closed", "all"])
|
|
ap.add_argument("--label", action="append", default=[],
|
|
help="filter by label; repeat for AND")
|
|
ap.add_argument("-q", "--query", help="search text in title/body")
|
|
ap.add_argument("--milestone", help="milestone id or title")
|
|
ap.add_argument("--limit", type=int, default=30)
|
|
ap.add_argument("--repo", help="owner/repo (default: auto-detect from CWD git remote)")
|
|
ap.add_argument("--out", default=issue.ISSUE_ROOT, help="store root (default: tmp/issues)")
|
|
args = ap.parse_args()
|
|
|
|
login = _gitea.require_login()
|
|
base = _gitea.repo_base(args.repo)
|
|
payloads, ms_title = _gitea.list_issues(
|
|
login, base, state=args.state, labels=args.label, query=args.query,
|
|
milestone=args.milestone, limit=args.limit)
|
|
|
|
remote_map = _gitea.load_map(args.out)
|
|
repo = _gitea.repo_slug(login, args.repo) if remote_map else None
|
|
|
|
for p in payloads:
|
|
labels = ", ".join(l.get("name", "") for l in p.get("labels") or []) or "-"
|
|
print("#%-5d %-7s %-38s %s" % (p["number"], p.get("state", ""),
|
|
labels[:38], p.get("title", "")))
|
|
local = remote_map.get(gmap.remote_key(repo, p["number"])) if repo else None
|
|
if local:
|
|
print("%13s└─ local: %s" % ("", local))
|
|
|
|
scope = " in milestone %s" % ms_title if ms_title else ""
|
|
hint = ("--milestone %s" % args.milestone) if args.milestone else "<n>"
|
|
print("%d issue(s)%s — pull them with: pull.py %s" % (len(payloads), scope, hint))
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|