@jesdi/skills 0.0.5 → 0.0.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jesdi/skills",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "jesdi's agent skills (content package consumed by @jesdi/skills-cli)",
   "license": "MIT",
   "repository": {

package/skills/backlog/rank.py

@@ -29,14 +29,31 @@ def _as_int(value):
 
 
 def merge_sources(project_items, issue_rows):
-    """Join Project field values (item-list) with issue bodies/state (issue list)."""
+    """Join Project field values (item-list) with issue bodies/state (issue list).
+
+    Join key is the issue number when the token can expand item content; when
+    content is redacted (project-scope token + private repo), fall back to the
+    title — GitHub syncs linked-item titles to issue titles. Ambiguous titles
+    (duplicates) and titles matching no issue are skipped, as are drafts.
+    """
     bodies = {row["number"]: row for row in issue_rows}
+    by_title, dup_titles = {}, set()
+    for row in issue_rows:
+        title = row.get("title")
+        if title in by_title:
+            dup_titles.add(title)
+        elif title is not None:
+            by_title[title] = row
     merged = []
     for item in project_items:
         content = item.get("content") or {}
         number = content.get("number")
         if number is None:
-            continue  # draft item (no linked issue) — not part of the work graph
+            row = by_title.get(item.get("title"))
+            if row is None or item.get("title") in dup_titles:
+                continue  # draft, board-only, or ambiguous — not joinable
+            number = row["number"]
+            content = {"title": row.get("title", ""), "url": row.get("url", "")}
         row = bodies.get(number, {})
         merged.append({
             "number": number,
@@ -183,7 +200,7 @@ def main(owner, project_number, repo, as_json=False):
     project_items = payload.get("items", [])
     issue_rows = _gh_json([
         "gh", "issue", "list", "--repo", repo, "--state", "all",
-        "--limit", "500", "--json", "number,body,state,labels",
+        "--limit", "500", "--json", "number,title,url,body,state,labels",
     ])
     issues = merge_sources(project_items, issue_rows)
     result = rank_issues(issues)

package/skills/backlog/test_rank.py

@@ -37,6 +37,46 @@ def test_merge_sources_joins_fields_and_bodies():
     assert thirtyfour["impact"] is None and thirtyfour["status"] is None
 
 
+def test_merge_sources_falls_back_to_title_join_when_content_redacted():
+    # A project-scope token can list items and field values but cannot expand
+    # the linked issue of a private repo: no "content", empty "repository".
+    # GitHub syncs linked-item titles to issue titles, so title is the join key.
+    project_items = [
+        {"id": "PVTI_a", "title": "Add X", "repository": "",
+         "status": "Ready", "impact": 4, "effort": 2},
+    ]
+    issue_rows = [
+        {"number": 12, "title": "Add X", "url": "u/12",
+         "body": "Blocked by: #34", "state": "open",
+         "labels": [{"name": "auto"}]},
+    ]
+    out = rank.merge_sources(project_items, issue_rows)
+    assert len(out) == 1
+    twelve = out[0]
+    assert twelve["number"] == 12
+    assert twelve["url"] == "u/12"
+    assert twelve["impact"] == 4 and twelve["status"] == "Ready"
+    assert twelve["body"] == "Blocked by: #34"
+    assert twelve["labels"] == ["auto"]
+
+
+def test_merge_sources_redacted_item_without_matching_title_is_skipped():
+    out = rank.merge_sources(
+        [{"id": "PVTI_a", "title": "board-only note", "status": "Ready"}],
+        [{"number": 1, "title": "Other", "url": "u/1", "body": "", "state": "open"}],
+    )
+    assert out == []
+
+
+def test_merge_sources_title_join_skips_ambiguous_duplicate_titles():
+    project_items = [{"id": "PVTI_a", "title": "Dup", "status": "Ready"}]
+    issue_rows = [
+        {"number": 1, "title": "Dup", "url": "u/1", "body": "", "state": "open"},
+        {"number": 2, "title": "Dup", "url": "u/2", "body": "", "state": "open"},
+    ]
+    assert rank.merge_sources(project_items, issue_rows) == []
+
+
 def test_merge_sources_missing_body_row_defaults_open_empty():
     out = rank.merge_sources(
         [{"content": {"number": 7, "title": "T", "url": "u/7"}, "impact": 3, "effort": 1}],
@@ -249,7 +289,9 @@ def test_main_json_emits_machine_readable_rows(monkeypatch, capsys):
                     {"content": {"number": 5, "title": "Task", "url": "u/5"},
                      "status": "Ready", "impact": 4, "effort": 2}]})
             else:
-                assert "labels" in args[args.index("--json") + 1]
+                fields = args[args.index("--json") + 1]
+                assert "labels" in fields
+                assert "title" in fields and "url" in fields  # title-join keys
                 stdout = jsonlib.dumps([
                     {"number": 5, "body": "", "state": "open",
                      "labels": [{"name": "auto"}]}])

package/skills-manifest.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-07-23T11:21:38.913Z",
+  "generatedAt": "2026-07-23T15:49:56.550Z",
   "skills": [
     {
       "name": "backlog",
-      "version": "0.1.2",
-      "hash": "sha256-40e91ee1f155c778ee596fd4f459cacbdcf8221bf95b0f9f2e45652207aaa275",
+      "version": "0.1.3",
+      "hash": "sha256-afe5ef66a86a4bbb1ce654e9ec861be80873e36e1cb45fbe132564a25dc26c1d",
       "description": "Manage a GitHub-Issues-backed backlog and a Projects-v2 work graph via five verbs. Use when the user wants to CAPTURE an idea/research thread (\"add to backlog\", \"capture this\", \"note this idea\", \"log a task\"), TRIAGE the inbox (\"triage the backlog\", \"score the inbox\"), see what to work on NEXT (\"what's next\", \"what should I work on\", \"ranked backlog\", \"next actionable task\"), LAND a finished item (\"mark done\", \"close out #N\"), or SETUP the board the first time. Ranks open issues by impact÷effort, respecting `Blocked by:` edges, so only actionable work surfaces."
     },
     {