Filter Linear sync by [paper2ppt] title prefix on DSC team.

Use Dschloe team with a title prefix instead of a dedicated Linear team, add .env.example, and gitignore local secrets.

Author: dschloe

.env.example

@@ -0,0 +1,12 @@
+# Copy to .env for local Linear/GitHub sync (never commit .env).
+# GitHub Actions uses repository Secrets instead — see README.
+
+LINEAR_API_KEY=
+# Dschloe (DSC) team UUID
+LINEAR_TEAM_ID=
+# Only Linear issues whose title contains this prefix sync to GitHub.
+LINEAR_TITLE_PREFIX=[paper2ppt]
+
+# Fine-grained PAT: Issues read/write on dschloe/paper2ppt only (e.g. paper2ppt-agent).
+GITHUB_TOKEN=
+GITHUB_REPO=dschloe/paper2ppt

.github/scripts/notify_linear_failure.py

@@ -72,7 +72,9 @@ def graphql(query: str, variables: dict | None = None) -> dict:
 
 
 def build_title(workflow_name: str, repository: str) -> str:
-    return f"[CI] {workflow_name} failed — {repository}"
+    prefix = os.environ.get("LINEAR_TITLE_PREFIX", "[paper2ppt]").strip()
+    base = f"[CI] {workflow_name} failed — {repository}"
+    return f"{prefix} {base}" if prefix else base
 
 
 def build_description() -> str:

.github/scripts/sync_linear_to_github.py

@@ -73,10 +73,12 @@ def github_request(method: str, path: str, body: dict | None = None) -> Any:
         return json.loads(resp.read())
 
 
-def list_linear_open_issues(team_id: str, limit: int = 50) -> list[dict]:
+def list_linear_open_issues(team_id: str, title_prefix: str = "", limit: int = 50) -> list[dict]:
     filt: dict = {"state": {"type": {"nin": ["completed", "canceled"]}}}
     if team_id:
         filt["team"] = {"id": {"eq": team_id}}
+    if title_prefix:
+        filt["title"] = {"contains": title_prefix}
 
     issues: list[dict] = []
     after = None
@@ -87,7 +89,10 @@ def list_linear_open_issues(team_id: str, limit: int = 50) -> list[dict]:
             {"first": page_size, "after": after, "filter": filt},
         )
         conn = data["issues"]
-        issues.extend(conn["nodes"])
+        batch = conn["nodes"]
+        if title_prefix:
+            batch = [i for i in batch if title_prefix in (i.get("title") or "")]
+        issues.extend(batch)
         if not conn["pageInfo"]["hasNextPage"]:
             break
         after = conn["pageInfo"]["endCursor"]
@@ -145,6 +150,7 @@ def main() -> int:
     api_key = os.environ.get("LINEAR_API_KEY", "").strip()
     token = os.environ.get("GITHUB_TOKEN", "").strip()
     team_id = os.environ.get("LINEAR_TEAM_ID", "").strip()
+    title_prefix = os.environ.get("LINEAR_TITLE_PREFIX", "[paper2ppt]").strip()
     prefix = os.environ.get("ISSUE_TITLE_PREFIX", "[linear]").strip()
     dry_run = os.environ.get("DRY_RUN") == "1"
 
@@ -153,9 +159,13 @@ def main() -> int:
         return 0
 
     try:
-        linear_issues = list_linear_open_issues(team_id)
+        linear_issues = list_linear_open_issues(team_id, title_prefix=title_prefix)
         github_issues = list_github_open_issues()
-        print(f"Found {len(linear_issues)} open Linear issue(s), {len(github_issues)} open GitHub issue(s)")
+        prefix_note = f" (title contains {title_prefix!r})" if title_prefix else ""
+        print(
+            f"Found {len(linear_issues)} open Linear issue(s){prefix_note}, "
+            f"{len(github_issues)} open GitHub issue(s)"
+        )
 
         for issue in linear_issues:
             ident = issue["identifier"]

.github/workflows/notify-linear-on-failure.yml

@@ -25,6 +25,7 @@ jobs:
         env:
           LINEAR_API_KEY: ${{ secrets.LINEAR_API_KEY }}
           LINEAR_TEAM_ID: ${{ secrets.LINEAR_TEAM_ID }}
+          LINEAR_TITLE_PREFIX: "[paper2ppt]"
           LINEAR_LABEL_IDS: ${{ vars.LINEAR_LABEL_IDS }}
           WORKFLOW_NAME: ${{ github.event.workflow_run.name }}
           WORKFLOW_RUN_URL: ${{ github.event.workflow_run.html_url }}

.github/workflows/sync-issues.yml

@@ -20,6 +20,7 @@ jobs:
         env:
           LINEAR_API_KEY: ${{ secrets.LINEAR_API_KEY }}
           LINEAR_TEAM_ID: ${{ secrets.LINEAR_TEAM_ID }}
+          LINEAR_TITLE_PREFIX: "[paper2ppt]"
           GITHUB_TOKEN: ${{ secrets.AGENT_GITHUB_TOKEN }}
           GITHUB_REPO: ${{ github.repository }}
           ISSUE_TITLE_PREFIX: "[linear]"

.gitignore

@@ -1,4 +1,5 @@
 node_modules/
+.env
 .DS_Store
 *.log
 

README.md

@@ -472,11 +472,26 @@ This repo follows the same automation pattern as [ollama-advisor](https://github
 
 | Secret | Required for | Notes |
 |--------|----------------|-------|
-| `LINEAR_API_KEY` | Linear notify + sync | Linear → Settings → API → Personal API keys |
-| `LINEAR_TEAM_ID` | Linear notify + sync | Team UUID in Linear |
+| `LINEAR_API_KEY` | Linear notify + sync | Same workspace API key is fine (e.g. reuse from other repos) |
+| `LINEAR_TEAM_ID` | Linear notify + sync | **Dschloe (`DSC`) team UUID** — not `ollama-advisor` (`OA`) |
 | `AGENT_GITHUB_TOKEN` | Sync only | Fine-grained PAT with Issues read/write on this repo |
 
-Optional repository variable: `LINEAR_LABEL_IDS` (comma-separated label UUIDs for CI-created Linear issues).
+**Important:** Use the **Dschloe (`DSC`)** team. Prefix paper2ppt Linear issue titles with **`[paper2ppt]`** (e.g. `[paper2ppt] Fix PPTX footer`). Only those titles sync to this repo’s GitHub Issues — other DSC work stays in Linear only.
+
+Optional repository variable: `LINEAR_LABEL_IDS` (comma-separated label UUIDs for extra Linear labels on CI failures).
+
+| Setting | Default | Purpose |
+|---------|---------|---------|
+| `LINEAR_TITLE_PREFIX` | `[paper2ppt]` | Sync + CI issues use this title prefix |
+
+### Local setup
+
+Copy [`.env.example`](.env.example) → `.env` and fill in the same values as Secrets (for `cursor_prompt.py` and local sync). `.env` is gitignored.
+
+```bash
+cp .env.example .env
+# edit .env — DSC team ID; prefix Linear titles with [paper2ppt]
+```
 
 ### Local commands
 
@@ -485,7 +500,7 @@ Optional repository variable: `LINEAR_LABEL_IDS` (comma-separated label UUIDs fo
 npm test
 
 # Cursor handoff from a Linear issue (set LINEAR_API_KEY first)
-LINEAR_API_KEY=... LINEAR_TEAM_ID=... python .github/scripts/cursor_prompt.py P2S-12
+LINEAR_API_KEY=... LINEAR_TEAM_ID=... python .github/scripts/cursor_prompt.py DSC-12
 
 # Dry-run Linear → GitHub sync
 DRY_RUN=1 LINEAR_API_KEY=... GITHUB_TOKEN=... python .github/scripts/sync_linear_to_github.py